Pre-General Availability: 2026-02-23

Jump to

• Request
• Response

Import OpenZeppelin/Hardhat Manifest and Contracts

post

/v1/contracts/manifests/import

Imports a manifest file, ABIs, and bytecodes for the associated contracts compiled and deployed via Hardhat.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• contracts(required): array contracts
  Addresses to register with ABI and deployed runtime bytecode. For each item, provide either blockNum or txHash.
• manifest(required): object manifest
  OpenZeppelin/Hardhat manifest JSON

{
    "type":"object",
    "required":[
        "manifest",
        "contracts"
    ],
    "properties":{
        "manifest":{
            "type":"object",
            "description":"OpenZeppelin/Hardhat manifest JSON"
        },
        "contracts":{
            "type":"array",
            "description":"Addresses to register with ABI and deployed runtime bytecode. For each item, provide either blockNum or txHash.",
            "items":{
                "type":"object",
                "required":[
                    "address",
                    "abi",
                    "bytecode"
                ],
                "properties":{
                    "address":{
                        "type":"string",
                        "description":"20-byte 0x-prefixed address"
                    },
                    "abi":{
                        "type":"array",
                        "description":"Standard JSON ABI entries",
                        "items":{
                            "type":"object"
                        }
                    },
                    "bytecode":{
                        "type":"string",
                        "description":"Deployed runtime bytecode (0x-hex)"
                    },
                    "blockNum":{
                        "type":"string",
                        "nullable":true,
                        "description":"0x-prefixed hex or decimal block number"
                    },
                    "txHash":{
                        "type":"string",
                        "nullable":true,
                        "description":"0x-prefixed 32-byte transaction hash"
                    },
                    "role":{
                        "type":"string",
                        "nullable":true,
                        "description":"Optional role hint",
                        "enum":[
                            "proxy",
                            "implementation",
                            "impl",
                            "library"
                        ]
                    }
                },
                "oneOf":[
                    {
                        "required":[
                            "blockNum"
                        ]
                    },
                    {
                        "required":[
                            "txHash"
                        ]
                    }
                ]
            }
        }
    }
}

Nested Schema : contracts

Type: array

Addresses to register with ABI and deployed runtime bytecode. For each item, provide either blockNum or txHash.

Show Source

• Array of: object items

{
    "type":"array",
    "description":"Addresses to register with ABI and deployed runtime bytecode. For each item, provide either blockNum or txHash.",
    "items":{
        "type":"object",
        "required":[
            "address",
            "abi",
            "bytecode"
        ],
        "properties":{
            "address":{
                "type":"string",
                "description":"20-byte 0x-prefixed address"
            },
            "abi":{
                "type":"array",
                "description":"Standard JSON ABI entries",
                "items":{
                    "type":"object"
                }
            },
            "bytecode":{
                "type":"string",
                "description":"Deployed runtime bytecode (0x-hex)"
            },
            "blockNum":{
                "type":"string",
                "nullable":true,
                "description":"0x-prefixed hex or decimal block number"
            },
            "txHash":{
                "type":"string",
                "nullable":true,
                "description":"0x-prefixed 32-byte transaction hash"
            },
            "role":{
                "type":"string",
                "nullable":true,
                "description":"Optional role hint",
                "enum":[
                    "proxy",
                    "implementation",
                    "impl",
                    "library"
                ]
            }
        },
        "oneOf":[
            {
                "required":[
                    "blockNum"
                ]
            },
            {
                "required":[
                    "txHash"
                ]
            }
        ]
    }
}

Nested Schema : manifest

Type: object

OpenZeppelin/Hardhat manifest JSON

Nested Schema : items

Type: object

Show Source

• abi(required): array abi
  Standard JSON ABI entries
• address(required): string
  20-byte 0x-prefixed address
• blockNum: string
  0x-prefixed hex or decimal block number
• bytecode(required): string
  Deployed runtime bytecode (0x-hex)
• role: string
  Allowed Values: [ "proxy", "implementation", "impl", "library" ]

  Optional role hint
• txHash: string
  0x-prefixed 32-byte transaction hash

{
    "type":"object",
    "required":[
        "address",
        "abi",
        "bytecode"
    ],
    "properties":{
        "address":{
            "type":"string",
            "description":"20-byte 0x-prefixed address"
        },
        "abi":{
            "type":"array",
            "description":"Standard JSON ABI entries",
            "items":{
                "type":"object"
            }
        },
        "bytecode":{
            "type":"string",
            "description":"Deployed runtime bytecode (0x-hex)"
        },
        "blockNum":{
            "type":"string",
            "nullable":true,
            "description":"0x-prefixed hex or decimal block number"
        },
        "txHash":{
            "type":"string",
            "nullable":true,
            "description":"0x-prefixed 32-byte transaction hash"
        },
        "role":{
            "type":"string",
            "nullable":true,
            "description":"Optional role hint",
            "enum":[
                "proxy",
                "implementation",
                "impl",
                "library"
            ]
        }
    },
    "oneOf":[
        {
            "required":[
                "blockNum"
            ]
        },
        {
            "required":[
                "txHash"
            ]
        }
    ]
}

Match One Schema

Show Source

{
    "type":"object",
    "required":[
        "address",
        "abi",
        "bytecode"
    ],
    "properties":{
        "address":{
            "type":"string",
            "description":"20-byte 0x-prefixed address"
        },
        "abi":{
            "type":"array",
            "description":"Standard JSON ABI entries",
            "items":{
                "type":"object"
            }
        },
        "bytecode":{
            "type":"string",
            "description":"Deployed runtime bytecode (0x-hex)"
        },
        "blockNum":{
            "type":"string",
            "nullable":true,
            "description":"0x-prefixed hex or decimal block number"
        },
        "txHash":{
            "type":"string",
            "nullable":true,
            "description":"0x-prefixed 32-byte transaction hash"
        },
        "role":{
            "type":"string",
            "nullable":true,
            "description":"Optional role hint",
            "enum":[
                "proxy",
                "implementation",
                "impl",
                "library"
            ]
        }
    },
    "oneOf":[
        {
            "required":[
                "blockNum"
            ]
        },
        {
            "required":[
                "txHash"
            ]
        }
    ]
}

Nested Schema : abi

Type: array

Standard JSON ABI entries

Show Source

• Array of: object items

{
    "type":"array",
    "description":"Standard JSON ABI entries",
    "items":{
        "type":"object"
    }
}

Nested Schema : items

Type: object

Examples

Select an example sample

Back to Top

Response

Supported Media Types

• application/json

202 Response

Accepted

Body ()

Root Schema : schema

Type: object

Additional Properties Allowed: true

400 Response

Validation error

Body ()

Root Schema : ErrorResponse

Type: object

Show Source

• decodedError: object DecodedError
• error: string
  Short error summary suitable for display
• hint: string
  Optional guidance that may help resolve the error
• message: string
  Additional error details, when available
• requestId: string
  Client-provided correlation ID echoed in responses
• upstreamCode: integer
  Upstream node error code (if provided by the RPC endpoint)
• upstreamData: string
  Raw upstream error data payload (0x-hex or JSON), if available

{
    "type":"object",
    "properties":{
        "error":{
            "type":"string",
            "description":"Short error summary suitable for display"
        },
        "message":{
            "type":"string",
            "nullable":true,
            "description":"Additional error details, when available"
        },
        "hint":{
            "type":"string",
            "nullable":true,
            "description":"Optional guidance that may help resolve the error"
        },
        "upstreamCode":{
            "type":"integer",
            "nullable":true,
            "description":"Upstream node error code (if provided by the RPC endpoint)"
        },
        "upstreamData":{
            "type":"string",
            "nullable":true,
            "description":"Raw upstream error data payload (0x-hex or JSON), if available"
        },
        "decodedError":{
            "$ref":"#/components/schemas/DecodedError",
            "nullable":true,
            "description":"Optional decoded revert error when available"
        },
        "requestId":{
            "type":"string",
            "nullable":true,
            "description":"Client-provided correlation ID echoed in responses"
        }
    }
}

Nested Schema : DecodedError

Type: object

Show Source

• customError: object customError
  Decoded custom error as defined in the contract ABI
• standardError: object standardError
  Decoded standard Error(string) revert
• standardPanic: object standardPanic
  Decoded Panic(uint256) revert

{
    "type":"object",
    "properties":{
        "standardError":{
            "nullable":true,
            "type":"object",
            "description":"Decoded standard Error(string) revert",
            "properties":{
                "selector":{
                    "type":"string",
                    "example":"0x08c379a0"
                },
                "message":{
                    "type":"string",
                    "nullable":true,
                    "description":"Revert message string"
                }
            }
        },
        "standardPanic":{
            "nullable":true,
            "type":"object",
            "description":"Decoded Panic(uint256) revert",
            "properties":{
                "selector":{
                    "type":"string",
                    "example":"0x4e487b71"
                },
                "code":{
                    "type":"string",
                    "nullable":true,
                    "description":"Panic code value (hex or decimal string)"
                },
                "meaning":{
                    "type":"string",
                    "nullable":true,
                    "description":"Human-readable interpretation of the panic code, when known"
                }
            }
        },
        "customError":{
            "nullable":true,
            "type":"object",
            "description":"Decoded custom error as defined in the contract ABI",
            "properties":{
                "name":{
                    "type":"string"
                },
                "signature":{
                    "type":"string"
                },
                "selector":{
                    "type":"string"
                },
                "args":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/DecodedArgument"
                    }
                }
            }
        }
    }
}

Nested Schema : customError

Type: object

Decoded custom error as defined in the contract ABI

Show Source

• args: array args
• name: string
• selector: string
• signature: string

{
    "nullable":true,
    "type":"object",
    "description":"Decoded custom error as defined in the contract ABI",
    "properties":{
        "name":{
            "type":"string"
        },
        "signature":{
            "type":"string"
        },
        "selector":{
            "type":"string"
        },
        "args":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/DecodedArgument"
            }
        }
    }
}

Nested Schema : standardError

Type: object

Decoded standard Error(string) revert

Show Source

• message: string
  Revert message string
• selector: string
  Example: 0x08c379a0

{
    "nullable":true,
    "type":"object",
    "description":"Decoded standard Error(string) revert",
    "properties":{
        "selector":{
            "type":"string",
            "example":"0x08c379a0"
        },
        "message":{
            "type":"string",
            "nullable":true,
            "description":"Revert message string"
        }
    }
}

Nested Schema : standardPanic

Type: object

Decoded Panic(uint256) revert

Show Source

• code: string
  Panic code value (hex or decimal string)
• meaning: string
  Human-readable interpretation of the panic code, when known
• selector: string
  Example: 0x4e487b71

{
    "nullable":true,
    "type":"object",
    "description":"Decoded Panic(uint256) revert",
    "properties":{
        "selector":{
            "type":"string",
            "example":"0x4e487b71"
        },
        "code":{
            "type":"string",
            "nullable":true,
            "description":"Panic code value (hex or decimal string)"
        },
        "meaning":{
            "type":"string",
            "nullable":true,
            "description":"Human-readable interpretation of the panic code, when known"
        }
    }
}

Nested Schema : args

Type: array

Show Source

• Array of: object DecodedArgument

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

Nested Schema : DecodedArgument

Type: object

Show Source

• indexed: boolean
  Only for event parameters
• name: string
  May be empty if unknown
• type: string
  Canonical ABI type (for example, uint256, address, (uint256,address), uint256[])
• value:
  Normalized JSON value (address lowercase hex, bigints as decimal strings, bytes as 0x-hex)

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"May be empty if unknown"
        },
        "type":{
            "type":"string",
            "description":"Canonical ABI type (for example, uint256, address, (uint256,address), uint256[])"
        },
        "value":{
            "nullable":true,
            "description":"Normalized JSON value (address lowercase hex, bigints as decimal strings, bytes as 0x-hex)"
        },
        "indexed":{
            "type":"boolean",
            "nullable":true,
            "description":"Only for event parameters"
        }
    }
}

500 Response

Internal error

Body ()

Root Schema : ErrorResponse

Type: object

Show Source

• decodedError: object DecodedError
• error: string
  Short error summary suitable for display
• hint: string
  Optional guidance that may help resolve the error
• message: string
  Additional error details, when available
• requestId: string
  Client-provided correlation ID echoed in responses
• upstreamCode: integer
  Upstream node error code (if provided by the RPC endpoint)
• upstreamData: string
  Raw upstream error data payload (0x-hex or JSON), if available

{
    "type":"object",
    "properties":{
        "error":{
            "type":"string",
            "description":"Short error summary suitable for display"
        },
        "message":{
            "type":"string",
            "nullable":true,
            "description":"Additional error details, when available"
        },
        "hint":{
            "type":"string",
            "nullable":true,
            "description":"Optional guidance that may help resolve the error"
        },
        "upstreamCode":{
            "type":"integer",
            "nullable":true,
            "description":"Upstream node error code (if provided by the RPC endpoint)"
        },
        "upstreamData":{
            "type":"string",
            "nullable":true,
            "description":"Raw upstream error data payload (0x-hex or JSON), if available"
        },
        "decodedError":{
            "$ref":"#/components/schemas/DecodedError",
            "nullable":true,
            "description":"Optional decoded revert error when available"
        },
        "requestId":{
            "type":"string",
            "nullable":true,
            "description":"Client-provided correlation ID echoed in responses"
        }
    }
}

Nested Schema : DecodedError

Type: object

Show Source

• customError: object customError
  Decoded custom error as defined in the contract ABI
• standardError: object standardError
  Decoded standard Error(string) revert
• standardPanic: object standardPanic
  Decoded Panic(uint256) revert

{
    "type":"object",
    "properties":{
        "standardError":{
            "nullable":true,
            "type":"object",
            "description":"Decoded standard Error(string) revert",
            "properties":{
                "selector":{
                    "type":"string",
                    "example":"0x08c379a0"
                },
                "message":{
                    "type":"string",
                    "nullable":true,
                    "description":"Revert message string"
                }
            }
        },
        "standardPanic":{
            "nullable":true,
            "type":"object",
            "description":"Decoded Panic(uint256) revert",
            "properties":{
                "selector":{
                    "type":"string",
                    "example":"0x4e487b71"
                },
                "code":{
                    "type":"string",
                    "nullable":true,
                    "description":"Panic code value (hex or decimal string)"
                },
                "meaning":{
                    "type":"string",
                    "nullable":true,
                    "description":"Human-readable interpretation of the panic code, when known"
                }
            }
        },
        "customError":{
            "nullable":true,
            "type":"object",
            "description":"Decoded custom error as defined in the contract ABI",
            "properties":{
                "name":{
                    "type":"string"
                },
                "signature":{
                    "type":"string"
                },
                "selector":{
                    "type":"string"
                },
                "args":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/DecodedArgument"
                    }
                }
            }
        }
    }
}

Nested Schema : customError

Type: object

Decoded custom error as defined in the contract ABI

Show Source

• args: array args
• name: string
• selector: string
• signature: string

{
    "nullable":true,
    "type":"object",
    "description":"Decoded custom error as defined in the contract ABI",
    "properties":{
        "name":{
            "type":"string"
        },
        "signature":{
            "type":"string"
        },
        "selector":{
            "type":"string"
        },
        "args":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/DecodedArgument"
            }
        }
    }
}

Nested Schema : standardError

Type: object

Decoded standard Error(string) revert

Show Source

• message: string
  Revert message string
• selector: string
  Example: 0x08c379a0

{
    "nullable":true,
    "type":"object",
    "description":"Decoded standard Error(string) revert",
    "properties":{
        "selector":{
            "type":"string",
            "example":"0x08c379a0"
        },
        "message":{
            "type":"string",
            "nullable":true,
            "description":"Revert message string"
        }
    }
}

Nested Schema : standardPanic

Type: object

Decoded Panic(uint256) revert

Show Source

• code: string
  Panic code value (hex or decimal string)
• meaning: string
  Human-readable interpretation of the panic code, when known
• selector: string
  Example: 0x4e487b71

{
    "nullable":true,
    "type":"object",
    "description":"Decoded Panic(uint256) revert",
    "properties":{
        "selector":{
            "type":"string",
            "example":"0x4e487b71"
        },
        "code":{
            "type":"string",
            "nullable":true,
            "description":"Panic code value (hex or decimal string)"
        },
        "meaning":{
            "type":"string",
            "nullable":true,
            "description":"Human-readable interpretation of the panic code, when known"
        }
    }
}

Nested Schema : args

Type: array

Show Source

• Array of: object DecodedArgument

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

Nested Schema : DecodedArgument

Type: object

Show Source

• indexed: boolean
  Only for event parameters
• name: string
  May be empty if unknown
• type: string
  Canonical ABI type (for example, uint256, address, (uint256,address), uint256[])
• value:
  Normalized JSON value (address lowercase hex, bigints as decimal strings, bytes as 0x-hex)

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"May be empty if unknown"
        },
        "type":{
            "type":"string",
            "description":"Canonical ABI type (for example, uint256, address, (uint256,address), uint256[])"
        },
        "value":{
            "nullable":true,
            "description":"Normalized JSON value (address lowercase hex, bigints as decimal strings, bytes as 0x-hex)"
        },
        "indexed":{
            "type":"boolean",
            "nullable":true,
            "description":"Only for event parameters"
        }
    }
}

Back to Top