Pre-General Availability: 2026-02-23

Jump to

• Request
• Response

Import solc Storage Layout, ABI, and Deployed Runtime Bytecode for a Contract Address

post

/v1/contracts/solc/import

Import the ABIs, bytecodes, and storage layouts for the associated contracts compiled using solc.

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

• abi(required): array abi
• address(required): string
  Deployed contract address
• asOf(required): object asOf
• bytecode(required): string
  Deployed runtime bytecode (0x-hex)
• layout(required): object layout
  Solidity compiler storage layout JSON (must include storage and types)

{
    "type":"object",
    "required":[
        "address",
        "asOf",
        "layout",
        "abi",
        "bytecode"
    ],
    "properties":{
        "address":{
            "type":"string",
            "description":"Deployed contract address"
        },
        "asOf":{
            "type":"object",
            "required":[
                "blockNum"
            ],
            "properties":{
                "txHash":{
                    "type":"string",
                    "nullable":true
                },
                "blockNum":{
                    "type":"string",
                    "description":"0x-prefixed hex or decimal"
                },
                "timestamp":{
                    "type":"string",
                    "nullable":true
                }
            }
        },
        "layout":{
            "type":"object",
            "description":"Solidity compiler storage layout JSON (must include storage and types)"
        },
        "abi":{
            "type":"array",
            "items":{
                "type":"object"
            }
        },
        "bytecode":{
            "type":"string",
            "description":"Deployed runtime bytecode (0x-hex)"
        }
    }
}

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 : layout

Type: object

Solidity compiler storage layout JSON (must include storage and types)

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