Jump to

• Request
• Response

List Imported Manifests

get

/v1/contracts/manifests

Lists imported contract manifests available to the authenticated caller. It returns an array of manifest records and supports pagination through optional limit (default 50) and offset (default 0) query parameters.

Request

Query Parameters

• limit: integer
  Default Value: 50
• offset: integer
  Default Value: 0

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Returns the imported manifests available to the authenticated caller.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object ManifestRecord
  Imported contract manifest and its associated contract versions.

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

Nested Schema : ManifestRecord

Type: object

Imported contract manifest and its associated contract versions.

Show Source

• associatedContracts: array associatedContracts
  Contracts associated with this manifest layout.
• associatedContractVersions: integer
  Count of contract versions linked to this manifest record.
• capturedAt: [ "string", "null" ]
  Capture timestamp reported by the source manifest, when available.
• manifest: [ "object", "null" ]
  Manifest content associated with this record.
• manifestLayoutId: integer (int64)
  Unique identifier for the manifest layout.
• schemaVersion: string
  Manifest schema version for this upload.
• sourceToolchain: [ "string", "null" ]
  Toolchain identifier associated with the manifest source.

{
    "type":"object",
    "description":"Imported contract manifest and its associated contract versions.",
    "properties":{
        "manifestLayoutId":{
            "type":"integer",
            "format":"int64",
            "description":"Unique identifier for the manifest layout."
        },
        "schemaVersion":{
            "type":"string",
            "description":"Manifest schema version for this upload."
        },
        "capturedAt":{
            "type":[
                "string",
                "null"
            ],
            "description":"Capture timestamp reported by the source manifest, when available."
        },
        "sourceToolchain":{
            "type":[
                "string",
                "null"
            ],
            "description":"Toolchain identifier associated with the manifest source."
        },
        "associatedContractVersions":{
            "type":"integer",
            "description":"Count of contract versions linked to this manifest record."
        },
        "manifest":{
            "type":[
                "object",
                "null"
            ],
            "description":"Manifest content associated with this record."
        },
        "associatedContracts":{
            "type":"array",
            "description":"Contracts associated with this manifest layout.",
            "items":{
                "$ref":"#/components/schemas/ManifestAssociation"
            }
        }
    }
}

Nested Schema : associatedContracts

Type: array

Contracts associated with this manifest layout.

Show Source

• Array of: object ManifestAssociation
  Association between a manifest layout and a contract version.

{
    "type":"array",
    "description":"Contracts associated with this manifest layout.",
    "items":{
        "$ref":"#/components/schemas/ManifestAssociation"
    }
}

Nested Schema : ManifestAssociation

Type: object

Association between a manifest layout and a contract version.

Show Source

• address: string
  Contract address linked to the manifest layout.
• blockNum: string
  Block number linked to the associated contract version.
• implementationAddress: [ "string", "null" ]
  Implementation address for `proxy` associations, when available.
• txHash: [ "string", "null" ]
  Deployment transaction hash for the associated version, when available.
• updatedAt: [ "string", "null" ]
  Timestamp of the latest update for this association record.
• version: integer
  Contract version number associated with the manifest.

{
    "type":"object",
    "description":"Association between a manifest layout and a contract version.",
    "properties":{
        "address":{
            "type":"string",
            "description":"Contract address linked to the manifest layout."
        },
        "version":{
            "type":"integer",
            "description":"Contract version number associated with the manifest."
        },
        "txHash":{
            "type":[
                "string",
                "null"
            ],
            "description":"Deployment transaction hash for the associated version, when available."
        },
        "blockNum":{
            "type":"string",
            "description":"Block number linked to the associated contract version."
        },
        "updatedAt":{
            "type":[
                "string",
                "null"
            ],
            "description":"Timestamp of the latest update for this association record."
        },
        "implementationAddress":{
            "type":[
                "string",
                "null"
            ],
            "description":"Implementation address for `proxy` associations, when available."
        }
    }
}

500 Response

Unexpected service error.

Body ()

Root Schema : ErrorResponse

Type: object

Error response returned by the service.

Show Source

• decodedError:
  Returned only when `decode.errors=true` and decodable revert bytes are present.
• error: string
  Short error summary suitable for display.
• hint: [ "string", "null" ]
  Optional guidance for resolving the error.
• message: [ "string", "null" ]
  Additional error details, when available.
• policy:
  Present for policy warnings or denials such as preflight failure.
• preflight:
  Present for preflight-gated transaction submission errors.
• requestId: [ "string", "null" ]
  Client-provided correlation ID echoed in the response.
• upstreamCode: [ "integer", "null" ]
  Besu node error code, when provided by the RPC endpoint.
• upstreamData: [ "string", "null" ]
  Error data returned by the Besu node in 0x-prefixed hexadecimal or JSON format, when available.
• upstreamError: [ "object", "null" ] upstreamError
  Additional Properties Allowed: true

  Complete error object returned by the Besu node, including code, message, and data fields, when available.

{
    "type":"object",
    "description":"Error response returned by the service.",
    "properties":{
        "error":{
            "type":"string",
            "description":"Short error summary suitable for display."
        },
        "message":{
            "type":[
                "string",
                "null"
            ],
            "description":"Additional error details, when available."
        },
        "hint":{
            "type":[
                "string",
                "null"
            ],
            "description":"Optional guidance for resolving the error."
        },
        "upstreamCode":{
            "type":[
                "integer",
                "null"
            ],
            "description":"Besu node error code, when provided by the RPC endpoint."
        },
        "upstreamData":{
            "type":[
                "string",
                "null"
            ],
            "description":"Error data returned by the Besu node in 0x-prefixed hexadecimal or JSON format, when available."
        },
        "upstreamError":{
            "type":[
                "object",
                "null"
            ],
            "additionalProperties":true,
            "description":"Complete error object returned by the Besu node, including code, message, and data fields, when available."
        },
        "decodedError":{
            "anyOf":[
                {
                    "$ref":"#/components/schemas/DecodedError"
                },
                {
                    "type":"null"
                }
            ],
            "description":"Returned only when `decode.errors=true` and decodable revert bytes are present."
        },
        "preflight":{
            "anyOf":[
                {
                    "$ref":"#/components/schemas/TransactionPreflightResult"
                },
                {
                    "type":"null"
                }
            ],
            "description":"Present for preflight-gated transaction submission errors."
        },
        "policy":{
            "anyOf":[
                {
                    "$ref":"#/components/schemas/TransactionPolicyDecision"
                },
                {
                    "type":"null"
                }
            ],
            "description":"Present for policy warnings or denials such as preflight failure."
        },
        "requestId":{
            "type":[
                "string",
                "null"
            ],
            "description":"Client-provided correlation ID echoed in the response."
        }
    }
}

Nested Schema : upstreamError

Type: object

Additional Properties Allowed: true

Complete error object returned by the Besu node, including code, message, and data fields, when available.

Back to Top