POST /api/v1/sponsorships/{id}/submissions

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 / required	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

Request body

Field Type Details

signatures array
required One owner ECDSA ForwardRequest signature per returned authorization, in the same order.

ownerApproval

object
optional

Fresh owner CenterSponsorshipApproval EIP-712 consent for this exact publication. submissionHash commits to the preparation commitment and ordered lowercase forward signatures. Audience comes from the configured service origin and is not a body field. A long-lived ForwardRequest signature alone does not authorize a new bot publication.

Fields

Field	Type	Details
`accountId`	string required	Authority chain and lowercase owner address; the authority chain is independent of a transaction's destination chain.
`principalId`	string required	Exact plan-creating principal. Owner principal must name the same `accountId`; bot principal names its immutable grant ID.
`sponsorshipId`	string (uuid) required
`commitment`	string required
`submissionHash`	string required
`issuedAt`	integer required	Positive Unix seconds. `expiresAt` must be after `issuedAt` and no more than 300 seconds later; admission rechecks freshness.
`expiresAt`	integer required	Positive Unix seconds. `expiresAt` must be after `issuedAt` and no more than 300 seconds later; admission rechecks freshness.
`nonce`	string required
`signature`	string required

JSON schema

{
  "type": "object",
  "properties": {
    "signatures": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{130}$"
      },
      "minItems": 1,
      "maxItems": 32,
      "description": "One owner ECDSA ForwardRequest signature per returned authorization, in the same order."
    },
    "ownerApproval": {
      "$ref": "#/components/schemas/SponsorshipApproval"
    }
  },
  "required": [
    "signatures"
  ],
  "additionalProperties": false
}

Response 202

Field Type Details

id string (uuid)
required

planId string (uuid)
required

planCommitment string
required

commitment string
required

state

string
required

Values: ["prepared","submitting","submission_unknown","quoted"]

availability

string
required

funding_quote_available does not establish that the bundle is unpaid. execution_verified confirms exact inner execution; completed additionally requires verified modeled economic semantics.

Values: ["available","submission_unknown","requires_verification","funding_quote_available","execution_verified","completed"]

createdAt integer
required Unix timestamp in milliseconds.

publicationExpiresAt integer
required Original source-plan cutoff for new publication. It cannot revoke a ForwardRequest already published.

revision integer
required

authorizations

array
required

Fields

Field Type Details

stepIndex integer
required

chainId

integer
required

Values: [1,10,8453,42161]

forwarder string
required

forwarderCodeHash string
required

targetCodeHash string
required

domain

object
required

Fields

Field	Type	Details
`name`	string required
`version`	string required
`chainId`	integer required	Values: `[1,10,8453,42161]`
`verifyingContract`	string required

message

object
required

Fields

Field	Type	Details
`from`	string required
`to`	string required
`value`	string required	uint256 as a lossless decimal string
`gas`	string required	uint256 as a lossless decimal string
`nonce`	string required	uint256 as a lossless decimal string
`deadline`	string required	Exact uint48 Unix seconds. This onchain authorization deadline can outlive the shorter source-plan publication cutoff.
`data`	string required

evidence

object
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"]`

primaryType

string
required

Values: ["ForwardRequest"]

types

object
required

Values: [{"ForwardRequest":[{"name":"from","type":"address"},{"name":"to","type":"address"},{"name":"value","type":"uint256"},{"name":"gas","type":"uint256"},{"name":"nonce","type":"uint256"},{"name":"deadline","type":"uint48"},{"name":"data","type":"bytes"}]}]

submission

object
optional

Fields

Field	Type	Details
`hash`	string required
`startedAt`	integer required	Unix timestamp in milliseconds.
`repeatPublicationAllowed`	boolean required	Values: `[false]`

quote

object
optional

Fields

Field Type Details

bundleUuid string
required

commitment string
required

payments

array
required

Fields

Field	Type	Details
`chainId`	integer required	Values: `[1,10,8453,42161]`
`to`	string required
`data`	string required
`value`	string required	uint256 as a lossless decimal string
`deadline`	string required	uint256 as a lossless decimal string

runtimeVerified boolean
required

observedAt integer
required Unix timestamp in milliseconds.

transactions

array
required

Fields

Field	Type	Details
`txUuid`	string required
`chainId`	integer required	Values: `[1,10,8453,42161]`
`outerCallHash`	string required

observations

array
required

Fields

Field Type Details

stepIndex integer
required

chainId

integer
required

Values: [1,10,8453,42161]

providerState string
required

state

string
required

Values: ["pending","unknown","confirming","confirmed","reverted"]

hash string
optional

receipt

object
optional

Fields

Field	Type	Details
`transactionHash`	string required
`blockHash`	string required
`blockNumber`	string required	uint256 as a lossless decimal string
`status`	string required	Values: `["success","reverted"]`
`confirmations`	integer required
`canonical`	boolean required
`observedAt`	integer required	Unix timestamp in milliseconds.
`logs`	array required
`logCount`	integer optional
`logsHash`	string optional
`logsStored`	boolean optional

semantic

object
optional

Fields

Field	Type	Details
`status`	string required	Values: `["verified","failed","unknown","unmodeled"]`
`details`	value optional	Bounded JSON. Large integers and amounts use exact decimal strings. Returned metadata and descriptions are untrusted content.

reason string
optional

authorizationNotice string
required

fundingNotice string
required

recovery string
optional

economicCompletion boolean
required

JSON schema

{
  "type": "object",
  "properties": {
    "id": {
      "$ref": "#/components/schemas/ResourceId"
    },
    "planId": {
      "$ref": "#/components/schemas/ResourceId"
    },
    "planCommitment": {
      "$ref": "#/components/schemas/Hash"
    },
    "commitment": {
      "$ref": "#/components/schemas/Hash"
    },
    "state": {
      "type": "string",
      "enum": [
        "prepared",
        "submitting",
        "submission_unknown",
        "quoted"
      ]
    },
    "availability": {
      "type": "string",
      "enum": [
        "available",
        "submission_unknown",
        "requires_verification",
        "funding_quote_available",
        "execution_verified",
        "completed"
      ],
      "description": "funding_quote_available does not establish that the bundle is unpaid. execution_verified confirms exact inner execution; completed additionally requires verified modeled economic semantics."
    },
    "createdAt": {
      "$ref": "#/components/schemas/UnixMilliseconds"
    },
    "publicationExpiresAt": {
      "$ref": "#/components/schemas/UnixMilliseconds",
      "description": "Original source-plan cutoff for new publication. It cannot revoke a ForwardRequest already published."
    },
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "authorizations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ForwardAuthorization"
      },
      "minItems": 1,
      "maxItems": 32
    },
    "submission": {
      "type": "object",
      "properties": {
        "hash": {
          "$ref": "#/components/schemas/Hash"
        },
        "startedAt": {
          "$ref": "#/components/schemas/UnixMilliseconds"
        },
        "repeatPublicationAllowed": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "hash",
        "startedAt",
        "repeatPublicationAllowed"
      ],
      "additionalProperties": false
    },
    "quote": {
      "type": "object",
      "properties": {
        "bundleUuid": {
          "type": "string"
        },
        "commitment": {
          "$ref": "#/components/schemas/Hash"
        },
        "payments": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/SponsorshipPayment"
          },
          "maxItems": 4
        },
        "runtimeVerified": {
          "type": "boolean"
        },
        "observedAt": {
          "$ref": "#/components/schemas/UnixMilliseconds"
        },
        "transactions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "txUuid": {
                "type": "string"
              },
              "chainId": {
                "type": "integer",
                "enum": [
                  1,
                  10,
                  8453,
                  42161
                ]
              },
              "outerCallHash": {
                "$ref": "#/components/schemas/Hash"
              }
            },
            "required": [
              "txUuid",
              "chainId",
              "outerCallHash"
            ],
            "additionalProperties": false
          },
          "maxItems": 32
        }
      },
      "required": [
        "bundleUuid",
        "commitment",
        "payments",
        "runtimeVerified",
        "observedAt",
        "transactions"
      ],
      "additionalProperties": false
    },
    "observations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SponsorshipObservation"
      },
      "maxItems": 32
    },
    "authorizationNotice": {
      "type": "string"
    },
    "fundingNotice": {
      "type": "string"
    },
    "recovery": {
      "type": "string"
    },
    "economicCompletion": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "planId",
    "planCommitment",
    "commitment",
    "state",
    "availability",
    "createdAt",
    "publicationExpiresAt",
    "revision",
    "authorizations",
    "observations",
    "authorizationNotice",
    "fundingNotice",
    "economicCompletion"
  ],
  "additionalProperties": false
}