GET /api/v1/protocol/resolve

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
`X-Juicebox-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / optional	Signed retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.
`chainId`	query / required	integer `[1,10,8453,42161,84532,421614,11155111,11155420]`
`contractId`	query / required	string
`address`	query / optional	string
`projectId`	query / optional	Positive project ID when supported by the canonical association adapter.
`blockNumber`	query / optional	uint256 as a lossless decimal string

Response 200

Field Type Details

chainId

integer
required

Values: [1,10,8453,42161,84532,421614,11155111,11155420]

contractId string
required

address string
required

abiHash string
required

provenance

object
required

Inspect the verification level. Published address plus observed runtime hash is weaker than source-to-runtime equality. Clone proofs additionally bind the implementation, factory, and modeled canonical association.

Fields

Field Type Details

kind

string
required

Values: ["published-deployment","verified-factory-clone"]

contractId string
required

abiHash string
required

runtimeVerified boolean
optional

runtime object
optional

block

object
optional

Fields

Field	Type	Details
`chainId`	integer required	Values: `[1,10,8453,42161,84532,421614,11155111,11155420]`
`blockNumber`	string required	uint256 as a lossless decimal string
`blockHash`	string required
`timestamp`	string required	uint256 as a lossless decimal string
`source`	string required	Values: `["onchain"]`

publication one of
optional

projectContext object
optional

evidence

array
required

Fields

Field	Type	Details
`chainId`	integer required	Values: `[1,10,8453,42161,84532,421614,11155111,11155420]`
`blockNumber`	string required	uint256 as a lossless decimal string
`blockHash`	string required
`timestamp`	string required	uint256 as a lossless decimal string
`source`	string required	Values: `["onchain"]`

JSON schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "$ref": "#/components/schemas/ChainId"
    },
    "contractId": {
      "type": "string"
    },
    "address": {
      "$ref": "#/components/schemas/Address"
    },
    "abiHash": {
      "$ref": "#/components/schemas/Sha256"
    },
    "provenance": {
      "$ref": "#/components/schemas/ProtocolProvenance"
    },
    "evidence": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/BlockEvidence"
      },
      "minItems": 1,
      "maxItems": 1
    }
  },
  "required": [
    "chainId",
    "contractId",
    "address",
    "abiHash",
    "provenance",
    "evidence"
  ],
  "additionalProperties": false
}