GET /api/v1/plans/{id}/steps/{step}/simulation
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. |
id | path / required | string |
step | path / required | integer |
Response 200
| Field | Type | Details |
|---|---|---|
planId | string (uuid) required | |
commitment | string required | |
stepIndex | integer required | |
simulated | boolean required | Values: |
blockNumber | string required | uint256 as a lossless decimal string |
blockHash | string required | |
result | string required | |
estimatedGas | string required | uint256 as a lossless decimal string |
limitations | array 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
}