chore: specs for tx by metalabel rpc

specs/results/koiosapi-guild.yaml

@@ -619,6 +619,29 @@ paths:
       summary: Transaction Metadata Labels
       description: Get a list of all transaction metalabels
       operationId: tx_metalabels
+  /tx_by_metalabel: #RPC
+    get:
+      tags:
+        - Transactions
+      parameters:
+        - $ref: "#/components/parameters/_metalabel"
+        - $ref: "#/components/parameters/_after_block_height"
+      responses:
+        "200":
+          description: Success!!
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/tx_by_metalabel"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      summary: Transactions by Metadata Label
+      description: Get a list of all transactions that include a specific metadata label (key)
+      operationId: tx_by_metalabel
   /submittx: #submit-api
     post:
       tags:
@@ -2624,6 +2647,16 @@ components:
       in: query
       required: true
       allowEmptyValue: false
+    _metalabel:
+      deprecated: false
+      name: _metalabel
+      description: Metadata label (key) to filter transactions by
+      schema:
+        type: number
+      example: 721
+      in: query
+      required: true
+      allowEmptyValue: false
   requestBodies:
     block_hashes:
       content:
@@ -5565,6 +5598,24 @@ components:
             type: string
             description: A distinct known metalabel
             example: "721"
+    tx_by_metalabel:
+      description: Array of transactions containing the queried metadata label
+      type: array
+      items:
+        type: object
+        properties:
+          tx_hash:
+            $ref: "#/components/schemas/utxo_infos/items/properties/tx_hash"
+          block_hash:
+            $ref: "#/components/schemas/blocks/items/properties/hash"
+          block_height:
+            $ref: "#/components/schemas/blocks/items/properties/block_height"
+          epoch_no:
+            $ref: "#/components/schemas/blocks/items/properties/epoch_no"
+          absolute_slot:
+            $ref: "#/components/schemas/blocks/items/properties/abs_slot"
+          tx_timestamp:
+            $ref: "#/components/schemas/blocks/items/properties/block_time"
     utxo_infos:
       description: Array of complete UTxO information
       type: array

specs/results/koiosapi-mainnet.yaml

@@ -619,6 +619,29 @@ paths:
       summary: Transaction Metadata Labels
       description: Get a list of all transaction metalabels
       operationId: tx_metalabels
+  /tx_by_metalabel: #RPC
+    get:
+      tags:
+        - Transactions
+      parameters:
+        - $ref: "#/components/parameters/_metalabel"
+        - $ref: "#/components/parameters/_after_block_height"
+      responses:
+        "200":
+          description: Success!!
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/tx_by_metalabel"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      summary: Transactions by Metadata Label
+      description: Get a list of all transactions that include a specific metadata label (key)
+      operationId: tx_by_metalabel
   /submittx: #submit-api
     post:
       tags:
@@ -2624,6 +2647,16 @@ components:
       in: query
       required: true
       allowEmptyValue: false
+    _metalabel:
+      deprecated: false
+      name: _metalabel
+      description: Metadata label (key) to filter transactions by
+      schema:
+        type: number
+      example: 721
+      in: query
+      required: true
+      allowEmptyValue: false
   requestBodies:
     block_hashes:
       content:
@@ -5565,6 +5598,24 @@ components:
             type: string
             description: A distinct known metalabel
             example: "721"
+    tx_by_metalabel:
+      description: Array of transactions containing the queried metadata label
+      type: array
+      items:
+        type: object
+        properties:
+          tx_hash:
+            $ref: "#/components/schemas/utxo_infos/items/properties/tx_hash"
+          block_hash:
+            $ref: "#/components/schemas/blocks/items/properties/hash"
+          block_height:
+            $ref: "#/components/schemas/blocks/items/properties/block_height"
+          epoch_no:
+            $ref: "#/components/schemas/blocks/items/properties/epoch_no"
+          absolute_slot:
+            $ref: "#/components/schemas/blocks/items/properties/abs_slot"
+          tx_timestamp:
+            $ref: "#/components/schemas/blocks/items/properties/block_time"
     utxo_infos:
       description: Array of complete UTxO information
       type: array

specs/results/koiosapi-preprod.yaml

@@ -619,6 +619,29 @@ paths:
       summary: Transaction Metadata Labels
       description: Get a list of all transaction metalabels
       operationId: tx_metalabels
+  /tx_by_metalabel: #RPC
+    get:
+      tags:
+        - Transactions
+      parameters:
+        - $ref: "#/components/parameters/_metalabel"
+        - $ref: "#/components/parameters/_after_block_height"
+      responses:
+        "200":
+          description: Success!!
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/tx_by_metalabel"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      summary: Transactions by Metadata Label
+      description: Get a list of all transactions that include a specific metadata label (key)
+      operationId: tx_by_metalabel
   /submittx: #submit-api
     post:
       tags:
@@ -2624,6 +2647,16 @@ components:
       in: query
       required: true
       allowEmptyValue: false
+    _metalabel:
+      deprecated: false
+      name: _metalabel
+      description: Metadata label (key) to filter transactions by
+      schema:
+        type: number
+      example: 721
+      in: query
+      required: true
+      allowEmptyValue: false
   requestBodies:
     block_hashes:
       content:
@@ -5565,6 +5598,24 @@ components:
             type: string
             description: A distinct known metalabel
             example: "721"
+    tx_by_metalabel:
+      description: Array of transactions containing the queried metadata label
+      type: array
+      items:
+        type: object
+        properties:
+          tx_hash:
+            $ref: "#/components/schemas/utxo_infos/items/properties/tx_hash"
+          block_hash:
+            $ref: "#/components/schemas/blocks/items/properties/hash"
+          block_height:
+            $ref: "#/components/schemas/blocks/items/properties/block_height"
+          epoch_no:
+            $ref: "#/components/schemas/blocks/items/properties/epoch_no"
+          absolute_slot:
+            $ref: "#/components/schemas/blocks/items/properties/abs_slot"
+          tx_timestamp:
+            $ref: "#/components/schemas/blocks/items/properties/block_time"
     utxo_infos:
       description: Array of complete UTxO information
       type: array

specs/results/koiosapi-preview.yaml

@@ -619,6 +619,29 @@ paths:
       summary: Transaction Metadata Labels
       description: Get a list of all transaction metalabels
       operationId: tx_metalabels
+  /tx_by_metalabel: #RPC
+    get:
+      tags:
+        - Transactions
+      parameters:
+        - $ref: "#/components/parameters/_metalabel"
+        - $ref: "#/components/parameters/_after_block_height"
+      responses:
+        "200":
+          description: Success!!
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/tx_by_metalabel"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      summary: Transactions by Metadata Label
+      description: Get a list of all transactions that include a specific metadata label (key)
+      operationId: tx_by_metalabel
   /submittx: #submit-api
     post:
       tags:
@@ -2624,6 +2647,16 @@ components:
       in: query
       required: true
       allowEmptyValue: false
+    _metalabel:
+      deprecated: false
+      name: _metalabel
+      description: Metadata label (key) to filter transactions by
+      schema:
+        type: number
+      example: 721
+      in: query
+      required: true
+      allowEmptyValue: false
   requestBodies:
     block_hashes:
       content:
@@ -5565,6 +5598,24 @@ components:
             type: string
             description: A distinct known metalabel
             example: "721"
+    tx_by_metalabel:
+      description: Array of transactions containing the queried metadata label
+      type: array
+      items:
+        type: object
+        properties:
+          tx_hash:
+            $ref: "#/components/schemas/utxo_infos/items/properties/tx_hash"
+          block_hash:
+            $ref: "#/components/schemas/blocks/items/properties/hash"
+          block_height:
+            $ref: "#/components/schemas/blocks/items/properties/block_height"
+          epoch_no:
+            $ref: "#/components/schemas/blocks/items/properties/epoch_no"
+          absolute_slot:
+            $ref: "#/components/schemas/blocks/items/properties/abs_slot"
+          tx_timestamp:
+            $ref: "#/components/schemas/blocks/items/properties/block_time"
     utxo_infos:
       description: Array of complete UTxO information
       type: array

specs/templates/2-api-params.yaml

@@ -209,3 +209,13 @@ parameters:
     in: query
     required: true
     allowEmptyValue: false
+  _metalabel:
+    deprecated: false
+    name: _metalabel
+    description: Metadata label (key) to filter transactions by
+    schema:
+      type: number
+    example: 721
+    in: query
+    required: true
+    allowEmptyValue: false

specs/templates/4-api-schemas.yaml

@@ -2304,6 +2304,24 @@ schemas:
           type: string
           description: A distinct known metalabel
           example: "721"
+  tx_by_metalabel:
+    description: Array of transactions containing the queried metadata label
+    type: array
+    items:
+      type: object
+      properties:
+        tx_hash:
+          $ref: "#/components/schemas/utxo_infos/items/properties/tx_hash"
+        block_hash:
+          $ref: "#/components/schemas/blocks/items/properties/hash"
+        block_height:
+          $ref: "#/components/schemas/blocks/items/properties/block_height"
+        epoch_no:
+          $ref: "#/components/schemas/blocks/items/properties/epoch_no"
+        absolute_slot:
+          $ref: "#/components/schemas/blocks/items/properties/abs_slot"
+        tx_timestamp:
+          $ref: "#/components/schemas/blocks/items/properties/block_time"
   utxo_infos:
     description: Array of complete UTxO information
     type: array

specs/templates/api-main.yaml

@@ -474,6 +474,29 @@ paths:
       summary: Transaction Metadata Labels
       description: Get a list of all transaction metalabels
       operationId: tx_metalabels
+  /tx_by_metalabel: #RPC
+    get:
+      tags:
+        - Transactions
+      parameters:
+        - $ref: "#/components/parameters/_metalabel"
+        - $ref: "#/components/parameters/_after_block_height"
+      responses:
+        "200":
+          description: Success!!
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/tx_by_metalabel"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      summary: Transactions by Metadata Label
+      description: Get a list of all transactions that include a specific metadata label (key)
+      operationId: tx_by_metalabel
   /submittx: #submit-api
     post:
       tags: