Endpoint reference

GET /api/v1/plans/{id}/steps/{step}/simulation

Parameters

NameLocationDetails
X-Juicebox-Accountheader / requiredEnrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
X-Juicebox-Signerheader / requiredOwner wallet or authorized bot address that signed this request.
X-Juicebox-Issued-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
X-Juicebox-Expires-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
X-Juicebox-Nonceheader / requiredFresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
X-Juicebox-Signatureheader / requiredEIP-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-Grantheader / optionalAuthorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
Idempotency-Keyheader / optionalSigned 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.
idpath / requiredstring
steppath / requiredinteger

Response 200

FieldTypeDetails
planIdstring (uuid)
required
commitmentstring
required
stepIndexinteger
required
simulatedboolean
required

Values: [true]

blockNumberstring
required
uint256 as a lossless decimal string
blockHashstring
required
resultstring
required
estimatedGasstring
required
uint256 as a lossless decimal string
limitationsarray
required
JSON schema
{
  "type": "object",
  "properties": {
    "planId": {
      "type": "string",
      "format": "uuid"
    },
    "commitment": {
      "$ref": "#/components/schemas/Hash"
    },
    "stepIndex": {
      "type": "integer",
      "minimum": 0,
      "maximum": 31
    },
    "simulated": {
      "const": true,
      "type": "boolean"
    },
    "blockNumber": {
      "$ref": "#/components/schemas/Uint256"
    },
    "blockHash": {
      "$ref": "#/components/schemas/Hash"
    },
    "result": {
      "$ref": "#/components/schemas/HexBytes"
    },
    "estimatedGas": {
      "$ref": "#/components/schemas/Uint256"
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "planId",
    "commitment",
    "stepIndex",
    "simulated",
    "blockNumber",
    "blockHash",
    "result",
    "estimatedGas",
    "limitations"
  ],
  "additionalProperties": false
}