Pre-General Availability: 2026-02-23

Jump to

• Request
• Response

Get Version at a Specific Block

get

/v1/contracts/{address}/at/{blockNum}

Returns the full metadata for a registered contract at a particular address applicable at the given block number, if it is available in the contract registry.

Request

Path Parameters

• address(required): string
• blockNum(required): string

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Contract version snapshot

Body ()

Root Schema : VersionRecord

Type: object

Show Source

• abi: array abi
• asOf: object AsOf
• bytecode: string
• implementationAddress: string
• metadata: object metadata
• runtimeCodeHash: string
• storageLayouts: array storageLayouts
• version: integer

{
    "type":"object",
    "properties":{
        "version":{
            "type":"integer"
        },
        "asOf":{
            "$ref":"#/components/schemas/AsOf"
        },
        "abi":{
            "type":"array",
            "items":{
                "type":"object"
            }
        },
        "bytecode":{
            "type":"string",
            "nullable":true
        },
        "runtimeCodeHash":{
            "type":"string",
            "nullable":true
        },
        "storageLayouts":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/StorageLayoutVariantRef"
            }
        },
        "implementationAddress":{
            "type":"string",
            "nullable":true
        },
        "metadata":{
            "type":"object",
            "nullable":true
        }
    }
}

Nested Schema : abi

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    }
}

Nested Schema : AsOf

Type: object

Show Source

• blockNum(required): string
  0x-prefixed hex or decimal
• timestamp: string
• txHash: string

{
    "type":"object",
    "required":[
        "blockNum"
    ],
    "properties":{
        "txHash":{
            "type":"string",
            "nullable":true
        },
        "blockNum":{
            "type":"string",
            "description":"0x-prefixed hex or decimal"
        },
        "timestamp":{
            "type":"string",
            "nullable":true
        }
    }
}

Nested Schema : metadata

Type: object

Nested Schema : storageLayouts

Type: array

Show Source

• Array of: object StorageLayoutVariantRef

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/StorageLayoutVariantRef"
    }
}

Nested Schema : items

Type: object

Nested Schema : StorageLayoutVariantRef

Type: object

Show Source

• capturedAt: string
• content: object content
• schemaVersion: string
• sourceKind: string
• sourceToolchain: string
• type: string

{
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "schemaVersion":{
            "type":"string"
        },
        "capturedAt":{
            "type":"string",
            "nullable":true
        },
        "sourceKind":{
            "type":"string"
        },
        "sourceToolchain":{
            "type":"string",
            "nullable":true
        },
        "content":{
            "type":"object",
            "nullable":true
        }
    }
}

Nested Schema : content

Type: object

Examples

Select an example sample

404 Response

Not found

Back to Top