> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metalntwx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get retained blob sidecars

> Returns the complete verified EIP-7594 sidecar bundle for a canonical finalized execution block hash. A null result also covers unknown, noncanonical, unfinalized, blob-free, or pruned blocks. Clients must verify the blobs and commitments against the ordered versioned hashes in the block transactions. This is a JSON-RPC retrieval method; Metal does not currently expose the standard Beacon blobs HTTP route.



## OpenAPI

````yaml /reference/json-rpc/json-rpc.json post /metal_getBlobSidecars
openapi: 3.1.0
info:
  title: Metal JSON-RPC
  version: 1.0.0
  description: Interactive playground for Metal's public JSON-RPC endpoints.
servers:
  - url: https://rpc-testnet.metalntwx.com/v1/{endpointId}
    variables:
      endpointId:
        default: YOUR_ENDPOINT_ID
        description: >-
          Your endpoint ID from the Metal console. It is a credential, so keep
          it private. Paste it once, and the playground remembers it in this
          browser.
    description: Testnet
  - url: https://rpc-devnet.metalntwx.com
    description: Devnet
security: []
tags:
  - name: Chain
    description: Identify the chain and its head.
  - name: Consensus
    description: Simplex finality, node build, and gas-token metadata.
  - name: Blocks
    description: Read blocks with Metal's millisecond timestamps and proposer.
  - name: State
    description: Read accounts, contracts, and storage.
  - name: Gas
    description: Quote gas in MIP20 gas-token base units.
  - name: Transactions
    description: Submit and inspect transactions.
  - name: Logs
    description: Query event logs.
  - name: MIP20
    description: Gas-token pricing detail standard Ethereum responses cannot represent.
paths:
  /metal_getBlobSidecars:
    post:
      tags:
        - Blocks
      summary: Get retained blob sidecars
      description: >-
        Returns the complete verified EIP-7594 sidecar bundle for a canonical
        finalized execution block hash. A null result also covers unknown,
        noncanonical, unfinalized, blob-free, or pruned blocks. Clients must
        verify the blobs and commitments against the ordered versioned hashes in
        the block transactions. This is a JSON-RPC retrieval method; Metal does
        not currently expose the standard Beacon blobs HTTP route.
      operationId: metal_getBlobSidecars
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  default: '2.0'
                  description: JSON-RPC protocol version. Always `2.0`.
                id:
                  type: integer
                  default: 1
                  description: Request identifier echoed back in the response.
                method:
                  type: string
                  enum:
                    - metal_getBlobSidecars
                  default: metal_getBlobSidecars
                  description: JSON-RPC method name.
                params:
                  type: array
                  prefixItems:
                    - type: string
                      default: >-
                        0x0000000000000000000000000000000000000000000000000000000000000000
                      pattern: ^0x[0-9a-fA-F]{64}$
                      description: >-
                        Execution block hash. Replace the placeholder with a
                        finalized blob block hash.
                  items: false
                  minItems: 1
                  maxItems: 1
                  default:
                    - >-
                      0x0000000000000000000000000000000000000000000000000000000000000000
                  description: '[blockHash].'
                  x-default:
                    - >-
                      0x0000000000000000000000000000000000000000000000000000000000000000
            example:
              jsonrpc: '2.0'
              id: 1
              method: metal_getBlobSidecars
              params:
                - >-
                  0x0000000000000000000000000000000000000000000000000000000000000000
      responses:
        '200':
          description: >-
            JSON-RPC 2.0 response. Errors are reported in-band via an `error`
            object with `code` and `message` in place of `result`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: integer
                  result:
                    type:
                      - array
                      - 'null'
                    description: >-
                      One EIP-7594 sidecar per blob transaction in block order.
                      Null unless the block is canonical and finalized and its
                      complete verified sidecar is retained. Sidecars are
                      retained for at least 18 days.
                    items:
                      type: object
                      required:
                        - blobs
                        - commitments
                        - cellProofs
                      properties:
                        blobs:
                          type: array
                          items:
                            type: string
                            pattern: ^0x[0-9a-fA-F]*$
                            description: 131,072-byte blob as 0x-prefixed hex.
                          description: Blobs in transaction order.
                        commitments:
                          type: array
                          items:
                            type: string
                            pattern: ^0x[0-9a-fA-F]*$
                            description: 48-byte KZG commitment as 0x-prefixed hex.
                          description: KZG commitments in the same order as blobs.
                        cellProofs:
                          type: array
                          items:
                            type: string
                            pattern: ^0x[0-9a-fA-F]*$
                            description: 48-byte KZG cell proof as 0x-prefixed hex.
                          description: >-
                            Flattened EIP-7594 cell proofs, including extension
                            cells, in blob order.
              example:
                jsonrpc: '2.0'
                id: 1
                result: null

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.