> ## Documentation Index > Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create Quote > Computes a quote for an intent: token transfers, target executions, and cost breakdown. Returns a pre-ranked `routes[]` with per-route `intentId` to pass to `POST /intents` for execution. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/orchestrator/caucasus.json post /quotes openapi: 3.0.0 info: title: Rhinestone Orchestrator API version: 2026-09.caucasus servers: - url: https://v1.orchestrator.rhinestone.dev security: [] paths: /quotes: post: tags: - Quotes summary: Create Quote description: >- Computes a quote for an intent: token transfers, target executions, and cost breakdown. Returns a pre-ranked `routes[]` with per-route `intentId` to pass to `POST /intents` for execution. operationId: createQuote parameters: - name: x-api-version in: header required: true schema: type: string enum: - 2026-09.caucasus description: API version. Required; pinned to this document. requestBody: required: true content: application/json: schema: type: object properties: account: type: object properties: evm: description: The EVM side of the account anyOf: - type: object properties: address: type: string required: - address additionalProperties: false description: >- An EVM address that may receive funds, but not spend them - type: object properties: type: type: string enum: - eoa address: type: string signatureMode: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 description: >- How the user's intent signature is verified onchain. The orchestrator picks a default from the account type — set this only to override. `0` emissary, `1` ERC-1271, `2` emissary then ERC-1271, `3` ERC-1271 then emissary, `4` emissary execution, `5` emissary execution then ERC-1271, `6` ERC-1271 then emissary execution. example: 3 delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account required: - type - address additionalProperties: false description: >- An externally owned account. An ECDSA signature is fixed-length, so there is nothing for `simulation` to size. - type: object properties: type: type: string enum: - erc7579 address: type: string initData: type: object properties: setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data required: - to - data additionalProperties: false required: - setupOps additionalProperties: false description: >- Deployment data, used only where the account is not yet deployed signatureMode: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 description: >- How the user's intent signature is verified onchain. The orchestrator picks a default from the account type — set this only to override. `0` emissary, `1` ERC-1271, `2` emissary then ERC-1271, `3` ERC-1271 then emissary, `4` emissary execution, `5` emissary execution then ERC-1271, `6` ERC-1271 then emissary execution. example: 3 delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account simulation: type: object properties: mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Cross-chain fallback stub signature, used where no per-chain entry matches mockSignaturesByChain: type: object additionalProperties: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Per-chain stub signatures, keyed by CAIP-2 chain id additionalProperties: false description: Gas-estimation inputs for this account required: - type - address additionalProperties: false description: An ERC-7579 smart account svm: description: The Solana side of the account anyOf: - type: object properties: address: type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ required: - address additionalProperties: false description: >- A Solana address that may receive funds, but not spend them - type: object properties: type: type: string enum: - swig address: type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ description: >- The asset-holding Swig wallet, not the Swig state account. Must be the wallet the orchestrator derives for the EVM account or, for a Solana-only account, the wallet of `swigAccount`. swigAccount: type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ description: >- The Swig state account holding the roles. Required for a Solana-only account (no `evm` entry); optional for an account paired with an EVM entry, whose Swig the orchestrator derives. authorization: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- EVM address the signing Swig role recovers to required: - kind - address additionalProperties: false - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- Passkey public key on the signing Swig role: SEC1-compressed P-256, 33 bytes as 0x-prefixed hex example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false description: >- The authority that signs this request. On a Solana-only account it selects the one Swig role carrying this key, which must hold `All` or `AllButManageAuthority` for a spend, or `All` or `ManageAuthority` for an authority change; no match, several matches or another permission is refused, so a `ManageAuthority`-only role never spends. On an account paired with an EVM entry, the root role signs. initData: type: object properties: authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: >- ^0x(0[23][0-9a-fA-F]{64}|04[0-9a-fA-F]{128})$ description: >- SEC1 secp256k1 public key as 0x-prefixed hex: compressed (33 bytes, leading 02 or 03) or uncompressed (65 bytes, leading 04) required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 passkey point, 33 bytes as 0x-prefixed hex example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false description: >- The public key installed as the Swig root, with every permission. Taken as supplied and permanent: a wrong key strands the wallet. Must agree with `authorization`. id: type: string pattern: ^0x[0-9a-fA-F]{64}$ description: >- The 32-byte Swig id, 0x-prefixed hex. Required for a Solana-only account, whose `swigAccount` it must derive; refused for an account paired with an EVM entry, whose id the orchestrator derives. required: - authority additionalProperties: false description: >- Creation data, accepted only on a request with no delivery, execution or recipient: such a request creates the Swig. required: - type - address - authorization additionalProperties: false description: A Swig account additionalProperties: false description: >- The account this intent spends from and delivers to, per VM. A quote needs a configured `evm` entry, or for a Solana-only account a `swig` `svm` entry and no `evm` entry: a receiver cannot fund one. example: evm: type: eoa address: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' options: type: object properties: settlementLayers: description: >- Which settlement layers the orchestrator may use. `{ include: [...] }` (allow-list) or `{ exclude: [...] }` (deny-list, inverted against the orchestrator's live layer set); a bare array means `include`. Internal modes (`SAME_CHAIN`, `INTENT_EXECUTOR`) are not selectable. Default unset = all layers eligible. example: exclude: - RELAY anyOf: - type: array items: type: string enum: - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP - LZ - type: object properties: include: type: array items: type: string enum: - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP - LZ required: - include additionalProperties: false - type: object properties: exclude: type: array items: type: string enum: - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP - LZ required: - exclude additionalProperties: false quoters: description: >- Which swap quoters the orchestrator may source swap routes from. `{ include: [...] }` (allow-list) or `{ exclude: [...] }` (deny-list, inverted against the full quoter set); a bare array means `include`. Use this to keep a swap on the venue a smart-session policy is scoped to. Default unset = every quoter the chain supports. example: include: - 0x anyOf: - type: array items: type: string enum: - 1inch - 0x - velora - kyberswap - fynd - fynd-hosted - bebop - relay - type: object properties: include: type: array items: type: string enum: - 1inch - 0x - velora - kyberswap - fynd - fynd-hosted - bebop - relay required: - include additionalProperties: false - type: object properties: exclude: type: array items: type: string enum: - 1inch - 0x - velora - kyberswap - fynd - fynd-hosted - bebop - relay required: - exclude additionalProperties: false appFees: type: object properties: feeBps: type: integer minimum: 0 maximum: 10000 description: >- App fee rate in basis points (0–10000 = 0–100%). The base is the USD value of the intent, and which value depends on the intent shape: for a fixed-output intent it is the requested `destination.amount`; for a max-out intent it is the spendable source balance; for a destination-swap intent it is the swap input. Note the fixed-output base is the full requested amount, not the delta over any balance already held. example: 25 required: - feeBps protocolFees: type: object properties: feeBps: type: integer minimum: 0 maximum: 10000 description: >- Rhinestone protocol fee rate in basis points (0–10000 = 0–100%), on the same base as `appFees.feeBps` — see that field. Collected alongside the app fee in one batched transfer and always accrues to Rhinestone; sponsor it via `options.sponsorship.protocolFees` to charge the integrator balance instead of the user. example: 35 required: - feeBps selectionStrategy: type: string enum: - cheapest - fastest - best description: >- How to rank candidate plans. `cheapest` minimizes direct USD cost. `fastest` minimizes estimated fill time (with cost tiebreaker). `best` minimizes total USD given up: delivered-output forgone versus the best candidate, plus cost, plus the cost of waiting. Waiting is charged both in proportion to notional (0.8 bps per minute, modelling price risk on funds in flight) and as a flat $0.10 per minute independent of size, so small intents are ranked mostly on speed and large ones mostly on price. The two are equal at $1,250 of notional. example: best customDeadline: type: integer minimum: 0 exclusiveMinimum: true description: >- Absolute unix timestamp (seconds) overriding the on-chain fill deadline. **TOKENLESS intents only.** If the intent resolves to any other route (cross-chain or same-chain), the request is **rejected** with `INVALID_CUSTOM_DEADLINE` (422) rather than silently ignoring the override. Must be between `now + 120s` and `now + 86400s`. The bundle claim/nonce expiry and the response `expiresAt` track this value automatically. example: 1893456000 sponsorship: type: object properties: gas: default: false type: boolean description: Whether to sponsor gas for the intent example: true bridgeFees: default: false type: boolean description: Whether to sponsor bridge fees for the intent swapFees: default: false type: boolean description: >- Whether to sponsor swap fees for the intent. For an integrator enabled for it, this also sponsors the VALUE of an eligible same-chain swap, so the user trades at par: the user contributes the 1:1 amount and the sponsor pays whatever the market is short. That applies only to pairs where par is a meaningful rate (both sides USD-pegged) and only up to a configured per-swap ceiling; outside those bounds the swap is priced at market. protocolFees: default: false type: boolean description: >- Whether to sponsor the Rhinestone protocol fee (`options.protocolFees`) for the intent. When `true`, the fee is charged to the integrator's sponsorship balance instead of carved from the user, without the sponsorship surcharge. description: Sponsor settings for the intent example: gas: true bridgeFees: true swapFees: true description: Intent options example: settlementLayers: include: - ECO sponsorship: gas: true bridgeFees: true swapFees: true source: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar description: VM of the source chain; must match `chainId`. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the source chain. example: eip155:42161 token: description: >- Source token: a registry symbol or a token address on the source chain. example: USDC anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL maxAmount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Caps the unlocked balance of this pair the intent may observe, in the token's smallest unit. example: '1000000' auxiliaryFunds: type: string pattern: ^[0-9]+$ format: uint256 description: >- Extra availability added after the `maxAmount` cap, in the token's smallest unit. Strictly positive; EVM source and a token address only. example: '1000000' execution: type: object properties: calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: type: string pattern: ^[0-9]+$ format: uint256 description: >- Amount must be a non-negative decimal integer string in smallest units example: '1000000' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data minItems: 1 maxItems: 10 description: 1–10 calls run in order. required: - calls additionalProperties: false description: >- Calls run on the source chain before the claim. EVM source only. required: - vm - chainId - token additionalProperties: false description: >- The single (chain, token) pair that funds the intent, including refunds and any destination credit. Optional only for a request that delivers no token and sets `options.sponsorship.gas` (destination execution or instructions, a Swig creation or authority change); a delivery requires it. A Solana-only account without a source must target a Solana destination. destination: discriminator: propertyName: vm oneOf: - type: object properties: vm: type: string enum: - evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the destination chain. example: eip155:8453 token: description: >- Token to deliver: a registry symbol or a token address on the destination chain. Omit it for an intent that delivers nothing. example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL amount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Exact delivery, in the token's smallest unit. Requires `token`; omit it with a `token` for a max-out intent. example: '1000000' recipient: description: >- Where the delivery lands. Omit to deliver to the account. anyOf: - type: object properties: address: type: string required: - address additionalProperties: false description: >- An EVM address that may receive funds, but not spend them - type: object properties: type: type: string enum: - eoa address: type: string delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account required: - type - address additionalProperties: false - type: object properties: type: type: string enum: - erc7579 address: type: string initData: type: object properties: setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data required: - to - data additionalProperties: false required: - setupOps additionalProperties: false description: >- Deployment data, used only where the account is not yet deployed delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account simulation: type: object properties: mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Cross-chain fallback stub signature, used where no per-chain entry matches mockSignaturesByChain: type: object additionalProperties: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Per-chain stub signatures, keyed by CAIP-2 chain id additionalProperties: false description: Gas-estimation inputs for this account required: - type - address additionalProperties: false execution: type: object properties: calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: type: string pattern: ^[0-9]+$ format: uint256 description: >- Amount must be a non-negative decimal integer string in smallest units example: '1000000' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data minItems: 1 description: >- Execution calls to run on the destination chain, in order. gasLimit: type: string format: uint256 description: Gas limit for the destination-chain executions example: '100000' executionTokensReceived: type: array items: type: string description: >- Tokens that will be received by EOA executions. These will be swept to the recipient account. example: - '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' required: - calls additionalProperties: false required: - vm - chainId additionalProperties: false - type: object properties: vm: type: string enum: - svm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the destination chain. example: eip155:8453 token: description: >- Token to deliver: a registry symbol or a token address on the destination chain. Omit it for an intent that delivers nothing. example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL amount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Exact delivery, in the token's smallest unit. Requires `token`; omit it with a `token` for a max-out intent. example: '1000000' recipient: type: object properties: address: type: string minLength: 1 description: >- Recipient address. Format depends on destination chain — 0x-hex for EVM destinations, base58 for Solana, T-address for Tron. example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' required: - address additionalProperties: false description: >- Where the delivery lands. Omit to deliver to the account. execution: description: >- What the destination runs out of the account's Swig: caller `instructions`, or an `authority` change. Never both. anyOf: - type: object properties: instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. minItems: 1 maxItems: 32 description: >- Solana instructions to run, in order, out of the account's own wallet. The wallet executes them, so `recipient` must be omitted: a payee is encoded inside the instructions. No route serves them yet, so a request carrying them is refused with `UNSUPPORTED_DESTINATION_INSTRUCTIONS`. addressLookupTables: type: array items: type: string maxItems: 8 description: >- Address lookup tables the instructions resolve accounts through, base58, as Jupiter `/swap-instructions` returns them. required: - instructions additionalProperties: false - type: object properties: authority: discriminator: propertyName: action oneOf: - type: object properties: action: type: string enum: - add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- The SEC1-compressed P-256 passkey public key, as 33 bytes of 0x-prefixed hex example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- The SEC1-compressed secp256k1 public key, as 33 bytes of 0x-prefixed hex. Uncompressed keys are refused: compress them first. Never an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The authority key: a passkey (`secp256r1`) or a secp256k1 public key. Either must be SEC1-compressed and lie on its curve. permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- What the added authority may do, installed as exactly that one Swig action. `all`: every action, including adding and removing the Swig's non-root authorities. `allButManageAuthority`: spend and execute, but never add or remove an authority. `manageAuthority`: add and remove non-root authorities — including granting `all`, so effectively takeover power — but never spend or execute: the Swig program refuses every wallet-signed instruction it signs. Required; there is no default. example: allButManageAuthority required: - action - key - permission additionalProperties: false - type: object properties: action: type: string enum: - remove key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- The SEC1-compressed P-256 passkey public key, as 33 bytes of 0x-prefixed hex example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- The SEC1-compressed secp256k1 public key, as 33 bytes of 0x-prefixed hex. Uncompressed keys are refused: compress them first. Never an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The authority key: a passkey (`secp256r1`) or a secp256k1 public key. Either must be SEC1-compressed and lie on its curve. required: - action - key additionalProperties: false description: >- Add a passkey or secp256k1 authority to the account's existing Swig, or remove a non-root one by its key. The added role holds exactly the requested permission, with no program permission added. Signed by the role `account.svm.authorization` names, which must hold `All` or `ManageAuthority`. The root role (id 0) is never removed. A removal that would leave no signable role holding `All` or `ManageAuthority` is refused, and so is adding a key already on the Swig. Solana-only accounts, sponsored (`options.sponsorship.gas`) only, and one change per intent. required: - authority additionalProperties: false required: - vm - chainId additionalProperties: false - type: object properties: vm: type: string enum: - tvm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the destination chain. example: eip155:8453 token: description: >- Token to deliver: a registry symbol or a token address on the destination chain. Omit it for an intent that delivers nothing. example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL amount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Exact delivery, in the token's smallest unit. Requires `token`; omit it with a `token` for a max-out intent. example: '1000000' recipient: type: object properties: address: type: string minLength: 1 description: >- Recipient address. Format depends on destination chain — 0x-hex for EVM destinations, base58 for Solana, T-address for Tron. example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' required: - address additionalProperties: false description: >- Where the delivery lands. Omit to deliver to the account. required: - vm - chainId - recipient additionalProperties: false - type: object properties: vm: type: string enum: - stellar chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the destination chain. example: eip155:8453 token: description: >- Token to deliver: a registry symbol or a token address on the destination chain. Omit it for an intent that delivers nothing. example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL amount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Exact delivery, in the token's smallest unit. Requires `token`; omit it with a `token` for a max-out intent. example: '1000000' recipient: type: object properties: address: type: string minLength: 1 description: >- Recipient address. Format depends on destination chain — 0x-hex for EVM destinations, base58 for Solana, T-address for Tron. example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' required: - address additionalProperties: false description: >- Where the delivery lands. Omit to deliver to the account. required: - vm - chainId - recipient additionalProperties: false - type: object properties: vm: type: string enum: - hypercore chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id of the destination chain. example: eip155:8453 token: description: >- Token to deliver: a registry symbol or a token address on the destination chain. Omit it for an intent that delivers nothing. example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' anyOf: - type: string - type: string - type: string enum: - ETH - USDC - WETH - USDT - USDT0 - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - OKB - WOKB - HYPE - WHYPE - RON - WRON - USDG - XPL - WXPL - AVAX - WAVAX - MockUSD - USDC_TEST - XLM - ensUSDC - ensUSDC2 - ensUSDC3 - TRX - WTRX - SOL - WSOL amount: type: string pattern: ^[0-9]+$ format: uint256 description: >- Exact delivery, in the token's smallest unit. Requires `token`; omit it with a `token` for a max-out intent. example: '1000000' recipient: description: >- Where the delivery lands. Omit to deliver to the account. anyOf: - type: object properties: address: type: string required: - address additionalProperties: false description: >- An EVM address that may receive funds, but not spend them - type: object properties: type: type: string enum: - eoa address: type: string delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account required: - type - address additionalProperties: false - type: object properties: type: type: string enum: - erc7579 address: type: string initData: type: object properties: setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data required: - to - data additionalProperties: false required: - setupOps additionalProperties: false description: >- Deployment data, used only where the account is not yet deployed delegations: type: object properties: default: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false chains: type: object additionalProperties: type: object properties: contract: type: string description: >- Contract the account delegates to under EIP-7702 required: - contract additionalProperties: false description: >- Per-chain delegate contracts, keyed by CAIP-2 chain id example: eip155:8453: contract: 0x… additionalProperties: false description: EIP-7702 delegations for this account simulation: type: object properties: mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Cross-chain fallback stub signature, used where no per-chain entry matches mockSignaturesByChain: type: object additionalProperties: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Per-chain stub signatures, keyed by CAIP-2 chain id additionalProperties: false description: Gas-estimation inputs for this account required: - type - address additionalProperties: false execution: type: object properties: actions: type: array items: discriminator: propertyName: type oneOf: - type: object properties: type: type: string enum: - order orders: type: array items: type: object properties: a: type: integer minimum: 0 description: >- Asset index. Perps use the index in the `meta` universe; spot uses `10000 + index` from `spotMeta`. This is an INDEX, not a ticker — resolve it from the info endpoint, and note that an index built against the wrong universe places a valid order in the wrong market. example: 0 b: type: boolean description: Buy (`true`) or sell (`false`). example: true p: type: string pattern: ^\d+(\.\d+)?$ description: >- Limit price. Must satisfy Hyperliquid's tick rules — at most 5 significant figures and at most `6 - szDecimals` decimals for a perp — and is refused there, not here. This price is fixed when you sign, and an intent that bridges to HyperCore takes ~30s to deliver. Price it to still cross after that move, or the order is refused with your funds already delivered. example: '64250.5' s: type: string pattern: ^\d+(\.\d+)?$ description: >- Size in units of the asset, to at most the asset's `szDecimals`. Hyperliquid refuses an order worth under ~$10. example: '0.0002' r: type: boolean description: >- Reduce-only. `true` is how a position is CLOSED — pair it with a tokenless intent, since closing needs no delivered collateral. example: false t: description: >- Either `{ limit: { tif } }` or `{ trigger: { isMarket, triggerPx, tpsl } }`. anyOf: - type: object properties: limit: type: object properties: tif: type: string enum: - Alo - Ioc - Gtc description: >- Time in force. `Ioc` fills what it can and cancels the rest, which is how a market order is expressed here — there is no market order type. `Alo` is post-only. `Gtc` rests on the book. Prefer `Ioc` for anything an intent delivers funds for: a resting order leaves the account holding USDC and no position, and the agent that could have cancelled it is already spent. example: Ioc required: - tif additionalProperties: false required: - limit additionalProperties: false - type: object properties: trigger: type: object properties: isMarket: type: boolean triggerPx: type: string pattern: ^\d+(\.\d+)?$ tpsl: type: string enum: - tp - sl description: Take-profit or stop-loss. example: sl required: - isMarket - triggerPx - tpsl additionalProperties: false required: - trigger additionalProperties: false c: type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' required: - a - b - p - s - r - t additionalProperties: false minItems: 1 maxItems: 100 grouping: type: string enum: - na - normalTpsl - positionTpsl description: >- `na` for a plain order. The TP/SL groupings attach the orders as a bracket around a position. example: na builder: type: object properties: b: type: string pattern: ^0x[0-9a-fA-F]{40}$ description: Address receiving the builder fee. f: type: integer minimum: 0 description: >- Builder fee in TENTHS of a basis point — `10` is 1bp of order notional. example: 10 required: - b - f additionalProperties: false required: - type - orders - grouping additionalProperties: false description: >- Place one or more orders. Opening a position needs an intent that delivers USDC; a reduce-only close does not. - type: object properties: type: type: string enum: - cancel cancels: type: array items: type: object properties: a: type: integer minimum: 0 description: Asset index. o: type: integer minimum: 0 description: Order id. required: - a - o additionalProperties: false minItems: 1 maxItems: 100 f: type: boolean description: Fast cancel. required: - type - cancels additionalProperties: false description: >- Cancel resting orders by order id. Needs no delivered funds, so it rides a tokenless intent. - type: object properties: type: type: string enum: - cancelByCloid cancels: type: array items: type: object properties: asset: type: integer minimum: 0 cloid: type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' required: - asset - cloid additionalProperties: false minItems: 1 maxItems: 100 f: type: boolean required: - type - cancels additionalProperties: false description: Cancel resting orders by client order id. - type: object properties: type: type: string enum: - modify oid: anyOf: - type: integer minimum: 0 - type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' order: type: object properties: a: type: integer minimum: 0 description: >- Asset index. Perps use the index in the `meta` universe; spot uses `10000 + index` from `spotMeta`. This is an INDEX, not a ticker — resolve it from the info endpoint, and note that an index built against the wrong universe places a valid order in the wrong market. example: 0 b: type: boolean description: Buy (`true`) or sell (`false`). example: true p: type: string pattern: ^\d+(\.\d+)?$ description: >- Limit price. Must satisfy Hyperliquid's tick rules — at most 5 significant figures and at most `6 - szDecimals` decimals for a perp — and is refused there, not here. This price is fixed when you sign, and an intent that bridges to HyperCore takes ~30s to deliver. Price it to still cross after that move, or the order is refused with your funds already delivered. example: '64250.5' s: type: string pattern: ^\d+(\.\d+)?$ description: >- Size in units of the asset, to at most the asset's `szDecimals`. Hyperliquid refuses an order worth under ~$10. example: '0.0002' r: type: boolean description: >- Reduce-only. `true` is how a position is CLOSED — pair it with a tokenless intent, since closing needs no delivered collateral. example: false t: description: >- Either `{ limit: { tif } }` or `{ trigger: { isMarket, triggerPx, tpsl } }`. anyOf: - type: object properties: limit: type: object properties: tif: type: string enum: - Alo - Ioc - Gtc description: >- Time in force. `Ioc` fills what it can and cancels the rest, which is how a market order is expressed here — there is no market order type. `Alo` is post-only. `Gtc` rests on the book. Prefer `Ioc` for anything an intent delivers funds for: a resting order leaves the account holding USDC and no position, and the agent that could have cancelled it is already spent. example: Ioc required: - tif additionalProperties: false required: - limit additionalProperties: false - type: object properties: trigger: type: object properties: isMarket: type: boolean triggerPx: type: string pattern: ^\d+(\.\d+)?$ tpsl: type: string enum: - tp - sl description: Take-profit or stop-loss. example: sl required: - isMarket - triggerPx - tpsl additionalProperties: false required: - trigger additionalProperties: false c: type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' required: - a - b - p - s - r - t additionalProperties: false a: type: boolean enum: - true description: >- Place the replacement even if the cancel failed. Omit it entirely for the default — Hyperliquid rejects an action hashed with `a: false`, so `false` is not a legal value. required: - type - oid - order additionalProperties: false description: Replace one resting order. - type: object properties: type: type: string enum: - batchModify modifies: type: array items: type: object properties: oid: anyOf: - type: integer minimum: 0 - type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' order: type: object properties: a: type: integer minimum: 0 description: >- Asset index. Perps use the index in the `meta` universe; spot uses `10000 + index` from `spotMeta`. This is an INDEX, not a ticker — resolve it from the info endpoint, and note that an index built against the wrong universe places a valid order in the wrong market. example: 0 b: type: boolean description: Buy (`true`) or sell (`false`). example: true p: type: string pattern: ^\d+(\.\d+)?$ description: >- Limit price. Must satisfy Hyperliquid's tick rules — at most 5 significant figures and at most `6 - szDecimals` decimals for a perp — and is refused there, not here. This price is fixed when you sign, and an intent that bridges to HyperCore takes ~30s to deliver. Price it to still cross after that move, or the order is refused with your funds already delivered. example: '64250.5' s: type: string pattern: ^\d+(\.\d+)?$ description: >- Size in units of the asset, to at most the asset's `szDecimals`. Hyperliquid refuses an order worth under ~$10. example: '0.0002' r: type: boolean description: >- Reduce-only. `true` is how a position is CLOSED — pair it with a tokenless intent, since closing needs no delivered collateral. example: false t: description: >- Either `{ limit: { tif } }` or `{ trigger: { isMarket, triggerPx, tpsl } }`. anyOf: - type: object properties: limit: type: object properties: tif: type: string enum: - Alo - Ioc - Gtc description: >- Time in force. `Ioc` fills what it can and cancels the rest, which is how a market order is expressed here — there is no market order type. `Alo` is post-only. `Gtc` rests on the book. Prefer `Ioc` for anything an intent delivers funds for: a resting order leaves the account holding USDC and no position, and the agent that could have cancelled it is already spent. example: Ioc required: - tif additionalProperties: false required: - limit additionalProperties: false - type: object properties: trigger: type: object properties: isMarket: type: boolean triggerPx: type: string pattern: ^\d+(\.\d+)?$ tpsl: type: string enum: - tp - sl description: Take-profit or stop-loss. example: sl required: - isMarket - triggerPx - tpsl additionalProperties: false required: - trigger additionalProperties: false c: type: string pattern: ^0x[0-9a-fA-F]{32}$ description: >- Optional client order id — 128-bit hex. Your handle on the order afterwards: the exchange echoes it back, so it is the only way to correlate a fill with the intent that placed it without polling by asset. example: '0x1234567890abcdef1234567890abcdef' required: - a - b - p - s - r - t additionalProperties: false required: - oid - order additionalProperties: false minItems: 1 maxItems: 100 a: type: boolean enum: - true description: >- Place the replacement even if the cancel failed. Omit it entirely for the default — Hyperliquid rejects an action hashed with `a: false`, so `false` is not a legal value. required: - type - modifies additionalProperties: false description: Replace several resting orders. - type: object properties: type: type: string enum: - updateLeverage asset: type: integer minimum: 0 isCross: type: boolean description: >- Cross margin (`true`) or isolated (`false`). example: true leverage: type: integer minimum: 0 exclusiveMinimum: true description: >- New leverage, capped by the asset's own maximum. Set it BEFORE the intent that opens the position: leverage applied afterwards does not resize an existing one. example: 5 required: - type - asset - isCross - leverage additionalProperties: false description: >- Change the leverage used for an asset. Needs no delivered funds. - type: object properties: type: type: string enum: - updateIsolatedMargin asset: type: integer minimum: 0 isBuy: type: boolean ntli: type: integer description: >- Margin to add (positive) or remove (negative), in USDC with 6 decimals — `1000000` is 1 USD. example: 1000000 required: - type - asset - isBuy - ntli additionalProperties: false description: >- Add or remove margin on an isolated position. - type: object properties: type: type: string enum: - twapOrder twap: type: object properties: a: type: integer minimum: 0 description: Asset index, as for an order. example: 0 b: type: boolean description: Buy (`true`) or sell (`false`). example: true s: type: string pattern: ^\d+(\.\d+)?$ description: >- Total size to work, in units of the asset. example: '0.01' r: type: boolean description: Reduce-only. example: false m: type: integer minimum: 0 exclusiveMinimum: true description: >- Duration in MINUTES. Hyperliquid enforces its own bounds and refuses a duration outside them ("Invalid TWAP duration"), so none are imposed here. example: 30 t: type: boolean description: >- Randomize the timing of the sub-orders rather than spacing them evenly. example: true required: - a - b - s - r - m - t additionalProperties: false required: - type - twap additionalProperties: false description: >- Work a position in over `m` minutes rather than in one fill. Carries NO limit price, which is what makes it the shape to reach for when the bridge delay is the risk: an `Ioc` order is priced at quote time and refused if the book has moved past it by the time the funds land, whereas a TWAP cannot be refused for not crossing. The intent completes when Hyperliquid ACCEPTS the TWAP, not when it finishes — the sub-orders run for `m` minutes afterwards, with no further intent and nothing on our side watching them. - type: object properties: type: type: string enum: - twapCancel a: type: integer minimum: 0 description: Asset index of the running TWAP. example: 0 t: type: integer minimum: 0 description: >- The TWAP id, which Hyperliquid returns when it accepts the `twapOrder` and is not echoed on the intent. Read it back from the exchange — the agent that placed the TWAP authorised only that one action, so cancelling is a second intent. example: 12345 required: - type - a - t additionalProperties: false description: >- Stop a running TWAP. Needs no delivered funds. description: >- A Hyperliquid L1 action, passed through as they define it. Keys are re-emitted in their canonical order before the action is hashed, so the order you send them in does not matter. minItems: 1 maxItems: 3 description: >- The Hyperliquid actions to authorise, IN ORDER. Each gets its own agent in its own API-wallet slot, registered one at a time, and they are sent to the exchange in the order given once every agent is live — the first refusal stops the rest. Order is the contract: `updateLeverage` has to land before the order it applies to. Capped at three, which is how many named API-wallet slots an account has. settlement: type: object properties: calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string pattern: ^[0-9]+$ format: uint256 description: >- Amount must be a non-negative decimal integer string in smallest units example: '1000000' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data minItems: 1 description: >- Execution calls to run on the destination chain, in order. gasLimit: type: string format: uint256 description: >- Gas limit for the destination-chain executions example: '100000' executionTokensReceived: type: array items: type: string description: >- Tokens that will be received by EOA executions. These will be swept to the recipient account. example: - '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' required: - calls additionalProperties: false description: >- Calls to run on HyperEVM, where the delivery settles before it reaches Core. Its `gasLimit` sizes those calls — Core actions are not EVM transactions and have no gas. additionalProperties: false required: - vm - chainId additionalProperties: false description: >- Where the intent lands, tagged by VM: the token and exact amount to deliver, and any execution there. required: - account - destination additionalProperties: false description: >- Quote request. Chain ids are CAIP-2 strings (e.g. `eip155:8453`, `solana:…`, `tron:…`); amounts are decimal strings in the token's smallest unit. Funds come from one `source` pair and land on one `destination`. example: account: evm: type: eoa address: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' source: vm: evm chainId: eip155:42161 token: USDC destination: vm: evm chainId: eip155:8453 token: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913' amount: '1000000' responses: '200': description: OK content: application/json: schema: discriminator: propertyName: status oneOf: - type: object properties: status: type: string enum: - quoted description: The orchestrator quoted the intent. example: quoted routes: type: array items: discriminator: propertyName: purpose oneOf: - type: object properties: intentId: type: string pattern: ^\d+$ description: >- Server-stored intent identifier. Pass back to `POST /intents` to submit. purpose: type: string enum: - execution description: >- What this route is for: `execution` moves funds or runs calls, `deployment` only initializes an account. example: execution expiresAt: type: integer minimum: 0 description: >- Quote expiry timestamp (Unix seconds). After this point, assume the quote is dead and re-quote. example: 1733493192 estimatedFillTime: type: object properties: seconds: type: number description: >- Typical end-to-end fill time for this route in seconds. Directional, not guaranteed. example: 3 required: - seconds description: Estimated fill time for the route settlementLayer: type: string enum: - INTENT_EXECUTOR - SAME_CHAIN - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP - LZ description: Settlement layer selected for this route example: RELAY plan: type: object properties: source: type: array items: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it execution: description: >- Present only where the route runs the caller's own calls on this block — or, at a HyperCore venue, actions or caller settlement calls. anyOf: - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: >- The caller's own calls, in execution order required: - executedBy - calls description: >- The caller's own EVM calls on this block. Never a claim to be the whole native transaction — solver plumbing, swap calldata and bridge sends are not disclosed here. - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The caller's own instructions, in execution order addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve against required: - executedBy - instructions - addressLookupTables description: >- The caller's own Solana instructions on this block - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: A change to the Swig's own authorities required: - executedBy - authority additionalProperties: false description: >- An authority change on this Swig, run by the Swig state account itself - type: object properties: actions: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, in the key order the agent address commits to nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string minLength: 1 description: The agent that authorises it example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - nonce - agent description: >- One HyperCore action and the agent it runs as description: >- The canonical actions, IN THE ORDER they are sent, each with its nonce and the agent that authorises it. Absent when the route carries none. settlement: type: object properties: vm: type: string enum: - evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id the calls execute on example: eip155:8453 executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: >- Absent where the chain is no longer in force, so the executing contract cannot be named. calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: The calls, in execution order required: - vm - chainId - calls description: >- The caller's own HyperEVM calls, in execution order. Only calls the caller sent: the gas-refund allowance, the core deposit and the agent registrations the orchestrator composes are not disclosed here (the registrations are disclosed in the signing request's `scope.hyperCore`). Absent when the caller sent none, and on a record written before caller calls were attributed. additionalProperties: false description: >- What the route runs at a HyperCore venue, and the caller's own calls that settle before it required: - vm - chainId - account description: One chain the route acts on description: >- One block per chain the route spends on, in the order the route reaches them. destination: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it execution: description: >- Present only where the route runs the caller's own calls on this block — or, at a HyperCore venue, actions or caller settlement calls. anyOf: - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: >- The caller's own calls, in execution order required: - executedBy - calls description: >- The caller's own EVM calls on this block. Never a claim to be the whole native transaction — solver plumbing, swap calldata and bridge sends are not disclosed here. - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The caller's own instructions, in execution order addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve against required: - executedBy - instructions - addressLookupTables description: >- The caller's own Solana instructions on this block - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: A change to the Swig's own authorities required: - executedBy - authority additionalProperties: false description: >- An authority change on this Swig, run by the Swig state account itself - type: object properties: actions: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, in the key order the agent address commits to nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string minLength: 1 description: The agent that authorises it example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - nonce - agent description: >- One HyperCore action and the agent it runs as description: >- The canonical actions, IN THE ORDER they are sent, each with its nonce and the agent that authorises it. Absent when the route carries none. settlement: type: object properties: vm: type: string enum: - evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id the calls execute on example: eip155:8453 executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: >- Absent where the chain is no longer in force, so the executing contract cannot be named. calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: The calls, in execution order required: - vm - chainId - calls description: >- The caller's own HyperEVM calls, in execution order. Only calls the caller sent: the gas-refund allowance, the core deposit and the agent registrations the orchestrator composes are not disclosed here (the registrations are disclosed in the signing request's `scope.hyperCore`). Absent when the caller sent none, and on a record written before caller calls were attributed. additionalProperties: false description: >- What the route runs at a HyperCore venue, and the caller's own calls that settle before it required: - vm - chainId - account description: >- The single block the route delivers to, on the chain the caller named. deployments: type: array items: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it required: - vm - chainId - account description: >- An account initialization the route performs, disclosed separately even when it shares a transaction with a claim or a fill. description: >- Account initializations the route performs. Empty when it performs none. required: - source - destination - deployments description: >- What the route does, resolved inline: where it spends, where it delivers, what it executes and who executes it, and the accounts it initializes. cost: type: object properties: input: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the debited token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata description: >- Tokens debited from the user, coalesced by (chainId, tokenAddress) output: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the delivered token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata description: >- Tokens delivered to the recipient, coalesced by (chainId, tokenAddress) fees: type: object properties: total: type: object properties: usd: type: number description: USD-denominated value example: 0.029 required: - usd description: >- Full route cost in USD, regardless of who pays. Equal to `sum(breakdown.*.usd)` modulo rounding. breakdown: type: object properties: gas: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Aggregate gas cost (destination fill, swap execution, origin gas) bridge: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate settlement-layer bridge cost swap: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate solver swap commission app: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate integrator app fee protocol: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Rhinestone protocol fee (`options.protocolFees`). `sponsored: true` when the integrator sponsorship balance pays it instead of the user. sponsorSurcharge: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Rhinestone's surcharge on the sponsored relayer coverage, charged to the sponsor. 0 when the intent is not sponsored. Pure surcharge — a sponsored protocol fee is shown on `protocol`, never here. required: - gas - bridge - swap - app - protocol - sponsorSurcharge description: Per-category fee breakdown required: - total - breakdown description: >- Aggregate route fees with per-category breakdown executionPayment: discriminator: propertyName: paidBy oneOf: - type: object properties: paidBy: type: string enum: - wallet walletDebit: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the debited token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata required: - paidBy - walletDebit - type: object properties: paidBy: type: string enum: - sponsor required: - paidBy description: >- Solana instruction execution only: the exact fixed wallet debit, or confirmation that the sponsor pays and the wallet has no execution debit. The wallet debit also appears in input. required: - input - output - fees description: >- Route cost: inputs, outputs, and fee breakdown requirements: type: array items: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - erc20Approval vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the requirement applies on example: eip155:8453 account: description: The account the requirement applies to anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it tokenAddress: type: string description: Token the requirement applies to example: >- 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 amount: type: string format: uint256 description: >- Minimum amount, in the token's smallest unit example: '1000000' spender: type: string description: >- Always the canonical Permit2 contract on this chain. The account approves Permit2; the settlement contract pulls funds via Permit2 at claim time. example: >- 0x000000000022d473030f116ddee9f6b43ac78ba3 required: - kind - vm - chainId - account - tokenAddress - amount - spender additionalProperties: false - type: object properties: kind: type: string enum: - wrapNative vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the requirement applies on example: eip155:8453 account: description: The account the requirement applies to anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it tokenAddress: type: string description: Token the requirement applies to example: >- 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 amount: type: string format: uint256 description: >- Minimum amount, in the token's smallest unit example: '1000000' required: - kind - vm - chainId - account - tokenAddress - amount additionalProperties: false description: >- A pre-flight operation the account must perform before this route can be claimed. `quoted` does not mean it is already fulfilled. description: >- Pre-flight operations the account must perform before this route can be claimed. Always present; empty when the route needs none. Emitted for EOA accounts only — smart accounts handle these internally. signingRequests: type: array items: type: object properties: account: discriminator: propertyName: vm oneOf: - type: object properties: vm: type: string enum: - evm address: type: string description: Account the signature authorizes example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - vm - address additionalProperties: false - type: object properties: vm: type: string enum: - svm wallet: type: string minLength: 1 description: >- Asset-holding Swig wallet the spend debits example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string minLength: 1 description: >- Swig state account holding the authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v required: - vm - wallet - swigAccount additionalProperties: false description: >- The account this signature acts for, named inline per VM. Carries no per-chain observation, since one request can span chains. authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Address the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address additionalProperties: false description: >- A raw key: the signature is verified by recovering it to this address. - type: object properties: kind: type: string enum: - account vm: type: string enum: - evm address: type: string description: >- Account that verifies the signature itself example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - vm - address additionalProperties: false description: >- The account verifies the signature natively (ERC-1271 / ERC-7579). Its owners are deliberately not enumerated: which key signs is the account itself to decide, and the proof bytes carry no length rule. - type: object properties: kind: type: string enum: - swigRole roleId: type: integer minimum: 0 description: Swig role the spend was authorized under example: 1 authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Address the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address additionalProperties: false - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false description: >- A passkey (WebAuthn) key, named by its public key: its signature recovers to no address. description: The authority configured on that role required: - kind - roleId - authority additionalProperties: false description: >- A selected Swig role, plus the authority it carries. Reports the role this quote used; it does not claim to be the only role that could authorize the spend. description: What verifies the signature scope: description: >- What the signature authorizes. Always agrees with the payload; never a restatement of the route. anyOf: - type: object properties: vm: type: string enum: - evm action: type: string enum: - claim - fill - targetExecution - delegation description: What the signature authorizes example: claim accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The accounts and chains the action runs against hyperCore: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, exactly as the agent commits to it. Key order is part of the commitment — the agent address is recovered from a signature over its msgpack encoding — so it is served in the order it was signed in, not re-sorted. nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string description: >- The agent this registration installs. It is derived from the action bytes above, so it authorises that action and nothing else. slot: type: string description: >- The named API-wallet slot the agent goes in. Registering evicts whatever the account had in that slot; the account's unnamed wallet is never used. example: rh1 required: - nonce - agent - slot additionalProperties: false description: One HyperCore agent registration minItems: 1 description: >- Present only on a request that authorizes at least one HyperCore agent registration. Lists every registration the payload commits to, in registration (slot) order: one item for a per-leg payload, all of them for an aggregate `MultiChainOps` payload. Names what each registration commits to, which the payload itself carries only as CoreWriter calldata. Changing any action, their order, a nonce or an agent requires a fresh quote. required: - vm - action - accounts additionalProperties: false description: >- An EVM scope names accounts, chains and action only — the calls the route runs are disclosed once, in the route's `plan`, so the two cannot disagree. The one exception is `hyperCore`, which names a commitment that exists nowhere else in a readable form. - discriminator: propertyName: action oneOf: - type: object properties: vm: type: string enum: - svm action: type: string enum: - spend accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The wallet the spend debits, on its chain instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The full instruction set this signature authorizes, in execution order, in the same shape a request carries instructions in. addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve accounts through. The tables themselves are not inlined. feePayer: type: object properties: kind: type: string enum: - role role: type: string enum: - relayer required: - kind - role additionalProperties: false description: >- Who pays the transaction fee, as a role rather than a key: the payload names no payer, and the relayer picks its own. slotWindow: type: object properties: from: type: string description: Slot the payload was pinned to example: '370123456' to: type: string description: Last slot it can be landed in example: '370123516' required: - from - to additionalProperties: false description: Slot range the payload is signable in required: - vm - action - accounts - instructions - addressLookupTables - feePayer - slotWindow additionalProperties: false description: >- A Solana scope additionally discloses the instruction set, because the message itself is an opaque digest. - type: object properties: vm: type: string enum: - svm action: type: string enum: - manageAuthority accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The Swig state account whose authorities change, on its chain authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: >- The change this signature authorizes, exactly as the plan discloses it instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The sealed instructions this signature authorizes, in execution order: a passkey signer's secp256r1 precompile, then the Swig `AddAuthorityV1` or `RemoveAuthorityV1`, whose payer is a one-off key the relayer funds. feePayer: type: object properties: kind: type: string enum: - role role: type: string enum: - relayer required: - kind - role additionalProperties: false description: >- Who pays the transaction fee, as a role rather than a key: the payload names no payer, and the relayer picks its own. slotWindow: type: object properties: from: type: string description: Slot the payload was pinned to example: '370123456' to: type: string description: Last slot it can be landed in example: '370123516' required: - from - to additionalProperties: false description: Slot range the payload is signable in required: - vm - action - accounts - authority - instructions - feePayer - slotWindow additionalProperties: false description: >- A Solana authority-change scope: the change itself, and the instructions the message commits to, since the message is an opaque digest. chainIds: type: array items: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- The chains the payload is cryptographically BOUND to, CAIP-2, each listed once — a `MultiChainOps` payload with several legs on one chain still names it once. This is what was signed rather than what the route is about: a Permit2 payload binds to the chain it claims funds on, so a destination request repeats the chain of the origin payload it duplicates. purpose: type: string enum: - originAuthorization - destinationAuthorization - targetExecutionAuthorization - delegationAuthorization description: What the signature is for example: originAuthorization validity: type: array items: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - timestamp expiresAt: type: integer minimum: 0 description: >- Unix seconds after which the payload is dead example: 1733493192 required: - kind - expiresAt additionalProperties: false - type: object properties: kind: type: string enum: - svmSlot chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id whose slots the deadline counts in example: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp expiresAtSlot: type: string description: Slot after which the payload is dead example: '370123516' required: - kind - chainId - expiresAtSlot additionalProperties: false description: >- A native deadline the payload is bound by. Every constraint returned applies; an empty list means the payload carries none of its own. description: >- Native deadlines that apply to this payload. Empty when it carries none — quote retention is a separate thing and is not a promise that a stale payload is submittable. payload: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - eip712 typedData: type: object properties: domain: type: object properties: name: type: string version: type: string chainId: type: number verifyingContract: type: string salt: type: string description: EIP-712 domain separator fields types: type: object additionalProperties: type: array items: type: object properties: name: type: string type: type: string required: - name - type description: >- EIP-712 type definitions keyed by type name primaryType: type: string description: Name of the top-level type to sign example: PermitBatchWitnessTransferFrom message: type: object additionalProperties: {} description: >- Message values keyed by field name. uint256 fields are encoded as decimal strings on the wire and re-coerced to bigint client-side before signing. required: - domain - types - primaryType - message description: >- EIP-712 typed data definition ready for `signTypedData` signatureFormat: type: string enum: - secp256k1 - account description: >- How the proof is encoded: raw 65-byte ECDSA for an EOA, or the account-native encoding for an ERC-7579 account, on which no length rule is imposed. example: secp256k1 required: - kind - typedData - signatureFormat additionalProperties: false - type: object properties: kind: type: string enum: - personalSign message: type: object properties: encoding: type: string enum: - utf8 value: type: string description: >- Sign these characters as UTF-8 TEXT — viem `signMessage({ message })`, never `{ raw }`. Signing the decoded bytes yields a well-formed signature the chain rejects. example: >- a3f2c1d4e5b6a7980f1e2d3c4b5a69788796a5b4c3d2e1f0a1b2c3d4e5f60718 required: - encoding - value additionalProperties: false required: - kind - message additionalProperties: false - type: object properties: kind: type: string enum: - eip7702 authorization: type: object properties: chainId: type: integer minimum: 0 description: >- Native chain value of the authorization tuple, not CAIP-2 example: 8453 address: type: string description: >- Delegate contract the authorization installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The delegation to authorize. Carries no nonce: the orchestrator observes no EOA nonces, and one read at quote time is stale by signing time — the signer supplies it with the proof. required: - kind - authorization additionalProperties: false - type: object properties: kind: type: string enum: - webauthn challenge: type: string pattern: ^0x[0-9a-fA-F]{64}$ description: >- Challenge the authenticator signs: 32 bytes as 0x-prefixed hex. Pass the decoded bytes as the WebAuthn `challenge`, not the hex text. example: >- 0xa3f2c1d4e5b6a7980f1e2d3c4b5a69788796a5b4c3d2e1f0a1b2c3d4e5f60718 required: - kind - challenge additionalProperties: false description: >- Served for a Solana spend out of a passkey-owned Swig, whose role names a secp256r1 authority. Answered with a `webauthn` proof. description: The native payload to sign required: - account - authority - scope - chainIds - purpose - validity - payload additionalProperties: false description: >- One payload the caller must sign. Answer request `i` with proof `i`. description: >- Everything the caller must sign, in the order to answer it: the origin authorizations, the destination authorization, the target execution where one applies, then any EIP-7702 delegations. Each entry states its own account, authority, scope, chains, purpose and validity, so a new signing path joins the array rather than adding a field. bridgeFill: discriminator: propertyName: type oneOf: - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - OFT description: LayerZero OFT required: - destinationChainId - fillStatusTimeout - type - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - ACROSS description: >- Across spoke-pool deposit. Names a deposit to watch for a refund, not a delivery — an ACROSS intent is filled by our own relayer and tracked as an ordinary fill. depositId: type: string pattern: ^[0-9]{1,78}$ description: >- The Across deposit id our claim opens on the origin chain, as a decimal uint256. Derived as keccak(arbiter | sponsor | nonce). required: - destinationChainId - fillStatusTimeout - type - depositId - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - ECO description: Eco solver-network delivery quoteId: type: string pattern: ^quote:[0-9a-f-]{36}$ description: >- Eco v1 quote ID for detailed delivery and refund tracking. intentHash: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Eco Portal intent hash. Use against Eco's intent status API to resolve the destination delivery transaction. providerDestinationChainId: type: integer minimum: 0 exclusiveMinimum: true description: >- Eco's own id for the delivery chain, present only where it differs from `destinationChainId` (non-EVM destinations). Eco's status API reports fulfilment against this id. providerSourceChainId: type: integer minimum: 0 exclusiveMinimum: true description: >- Eco's own id for the chain the reward was funded on, present only where it differs from the deposit chain (non-EVM origins). required: - destinationChainId - fillStatusTimeout - type - intentHash - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - RELAY description: Relay.link requestId: type: string description: >- Relay.link request ID. Use against Relay.link's status API to track the destination-chain fill. required: - destinationChainId - fillStatusTimeout - type - requestId - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - NEAR description: NEAR Intents depositAddress: description: >- NEAR Intents deposit address on the origin chain, in its native form (EVM 0x or Solana base58). Track fill status via the NEAR Intents status API keyed on this address. anyOf: - type: string - type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ required: - destinationChainId - fillStatusTimeout - type - depositAddress - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - RHINO description: Rhino.fi commitmentId: type: string description: >- Rhino.fi commitment ID. Use against Rhino.fi's status API to track the destination-chain fill. keyVariant: type: string enum: - user_fee description: >- Rhino.fi API key variant the commitment was quoted under. Rhino.fi answers a status lookup only under that key, so the fill-tracker asks for the same variant. required: - destinationChainId - fillStatusTimeout - type - commitmentId - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - CCTP description: Circle CCTP sourceDomainId: type: number description: >- Circle CCTP source domain ID — needed to fetch the attestation for the burn message on the source chain. destinationDomainId: type: number description: Circle CCTP destination domain ID. required: - destinationChainId - fillStatusTimeout - type - sourceDomainId - destinationDomainId - type: object properties: destinationChainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id of the chain the bridge delivers to (e.g. `eip155:8453`, `solana:…`) example: eip155:8453 fillExpirationPeriod: type: integer minimum: 0 description: >- Optional bridge-specific fill deadline duration, in seconds. Preserved on stored quote reload so checksum validation uses the same bridgeFill payload that was signed at quote time. fillStatusTimeout: type: integer minimum: 0 description: >- Fill-tracker watch window, in seconds. The orchestrator owns this timeout; the fill-tracker reads it here to decide when a bridge fill has timed out. type: type: string enum: - LZ description: LayerZero Value Transfer quoteId: type: string description: >- LayerZero quote ID. Use against LayerZero's transfer status API to track the destination-chain fill. dstChainKey: type: string description: >- LayerZero's own chain key for the destination (e.g. `base`). Its status response names chains by key rather than id. routeTypes: type: array items: type: string description: >- Protocols the quote routed through (e.g. STARGATE_V2_TAXI, CCTP_V2). One transfer can span several. required: - destinationChainId - fillStatusTimeout - type - quoteId - dstChainKey - routeTypes description: >- Provider handle for resolving the destination-chain delivery transaction when settlement hands off to a third-party bridge (ECO, RHINO, RELAY, NEAR, CCTP, OFT). Absent when the orchestrator settles end-to-end (e.g. ACROSS). required: - intentId - purpose - expiresAt - estimatedFillTime - settlementLayer - plan - cost - requirements - signingRequests description: >- A single ranked route candidate that executes the intent - type: object properties: intentId: type: string pattern: ^\d+$ description: >- Server-stored intent identifier. Pass back to `POST /intents` to submit. purpose: type: string enum: - deployment description: >- What this route is for: `execution` moves funds or runs calls, `deployment` only initializes an account. example: deployment expiresAt: type: integer minimum: 0 description: >- Quote expiry timestamp (Unix seconds). After this point, assume the quote is dead and re-quote. example: 1733493192 estimatedFillTime: type: object properties: seconds: type: number description: >- Typical end-to-end fill time for this route in seconds. Directional, not guaranteed. example: 3 required: - seconds description: Estimated fill time for the route settlementLayer: type: string enum: - INTENT_EXECUTOR - SAME_CHAIN - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP - LZ description: Settlement layer selected for this route example: RELAY plan: type: object properties: source: type: array items: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it execution: description: >- Present only where the route runs the caller's own calls on this block — or, at a HyperCore venue, actions or caller settlement calls. anyOf: - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: >- The caller's own calls, in execution order required: - executedBy - calls description: >- The caller's own EVM calls on this block. Never a claim to be the whole native transaction — solver plumbing, swap calldata and bridge sends are not disclosed here. - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The caller's own instructions, in execution order addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve against required: - executedBy - instructions - addressLookupTables description: >- The caller's own Solana instructions on this block - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: A change to the Swig's own authorities required: - executedBy - authority additionalProperties: false description: >- An authority change on this Swig, run by the Swig state account itself - type: object properties: actions: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, in the key order the agent address commits to nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string minLength: 1 description: The agent that authorises it example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - nonce - agent description: >- One HyperCore action and the agent it runs as description: >- The canonical actions, IN THE ORDER they are sent, each with its nonce and the agent that authorises it. Absent when the route carries none. settlement: type: object properties: vm: type: string enum: - evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id the calls execute on example: eip155:8453 executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: >- Absent where the chain is no longer in force, so the executing contract cannot be named. calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: The calls, in execution order required: - vm - chainId - calls description: >- The caller's own HyperEVM calls, in execution order. Only calls the caller sent: the gas-refund allowance, the core deposit and the agent registrations the orchestrator composes are not disclosed here (the registrations are disclosed in the signing request's `scope.hyperCore`). Absent when the caller sent none, and on a record written before caller calls were attributed. additionalProperties: false description: >- What the route runs at a HyperCore venue, and the caller's own calls that settle before it required: - vm - chainId - account description: One chain the route acts on description: >- One block per chain the route spends on, in the order the route reaches them. destination: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it execution: description: >- Present only where the route runs the caller's own calls on this block — or, at a HyperCore venue, actions or caller settlement calls. anyOf: - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: >- The caller's own calls, in execution order required: - executedBy - calls description: >- The caller's own EVM calls on this block. Never a claim to be the whole native transaction — solver plumbing, swap calldata and bridge sends are not disclosed here. - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The caller's own instructions, in execution order addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve against required: - executedBy - instructions - addressLookupTables description: >- The caller's own Solana instructions on this block - type: object properties: executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: The executor of the disclosed calls authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: A change to the Swig's own authorities required: - executedBy - authority additionalProperties: false description: >- An authority change on this Swig, run by the Swig state account itself - type: object properties: actions: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, in the key order the agent address commits to nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string minLength: 1 description: The agent that authorises it example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - nonce - agent description: >- One HyperCore action and the agent it runs as description: >- The canonical actions, IN THE ORDER they are sent, each with its nonce and the agent that authorises it. Absent when the route carries none. settlement: type: object properties: vm: type: string enum: - evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: CAIP-2 chain id the calls execute on example: eip155:8453 executedBy: type: object properties: kind: type: string enum: - account - solver description: >- Who runs the calls: the account itself, or a solver-operated contract running them on its behalf. example: account address: type: string minLength: 1 description: >- Address of the executing contract or account example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address description: >- Absent where the chain is no longer in force, so the executing contract cannot be named. calls: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: string format: uint256 description: >- Amount of ETH (in wei) sent in the execution example: '0' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded function call data example: >- 0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240 required: - to - value - data description: The calls, in execution order required: - vm - chainId - calls description: >- The caller's own HyperEVM calls, in execution order. Only calls the caller sent: the gas-refund allowance, the core deposit and the agent registrations the orchestrator composes are not disclosed here (the registrations are disclosed in the signing request's `scope.hyperCore`). Absent when the caller sent none, and on a record written before caller calls were attributed. additionalProperties: false description: >- What the route runs at a HyperCore venue, and the caller's own calls that settle before it required: - vm - chainId - account description: >- The single block the route delivers to, on the chain the caller named. deployments: type: array items: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id this account is resolved on example: eip155:8453 account: description: >- The account this block acts on, resolved for its VM: an EVM account, a Solana Swig, or a bare payee. anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it required: - vm - chainId - account description: >- An account initialization the route performs, disclosed separately even when it shares a transaction with a claim or a fill. description: >- Account initializations the route performs. Empty when it performs none. required: - source - destination - deployments description: >- The account the route initializes, in `deployments`, and the chain it initializes it on. cost: type: object properties: input: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the debited token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata description: >- Tokens debited from the user, coalesced by (chainId, tokenAddress) output: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the delivered token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata description: >- Tokens delivered to the recipient, coalesced by (chainId, tokenAddress) fees: type: object properties: total: type: object properties: usd: type: number description: USD-denominated value example: 0.029 required: - usd description: >- Full route cost in USD, regardless of who pays. Equal to `sum(breakdown.*.usd)` modulo rounding. breakdown: type: object properties: gas: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Aggregate gas cost (destination fill, swap execution, origin gas) bridge: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate settlement-layer bridge cost swap: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate solver swap commission app: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: Aggregate integrator app fee protocol: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Rhinestone protocol fee (`options.protocolFees`). `sponsored: true` when the integrator sponsorship balance pays it instead of the user. sponsorSurcharge: type: object properties: usd: type: number description: >- Total cost of this category in USD, regardless of who pays. example: 0.029 sponsored: type: boolean description: >- True when a sponsor absorbs some or all of this category. The user-vs-sponsor split is not surfaced. example: false required: - usd - sponsored description: >- Rhinestone's surcharge on the sponsored relayer coverage, charged to the sponsor. 0 when the intent is not sponsored. Pure surcharge — a sponsored protocol fee is shown on `protocol`, never here. required: - gas - bridge - swap - app - protocol - sponsorSurcharge description: Per-category fee breakdown required: - total - breakdown description: >- Aggregate route fees with per-category breakdown executionPayment: discriminator: propertyName: paidBy oneOf: - type: object properties: paidBy: type: string enum: - wallet walletDebit: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- Chain where this token leg settles (CAIP-2, any namespace) example: eip155:8453 tokenAddress: type: string minLength: 1 description: >- Contract address of the debited token (EVM 0x or non-EVM base58) example: >- 0xaf88d065e77c8cc2239327c5edb3a432268e5831 symbol: type: string nullable: true description: >- Token symbol, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: USDC decimals: type: integer nullable: true description: >- Token decimals, from the internal token registry or, for a token it has no entry for, read on-chain while planning. `null` when neither resolved one. example: 6 price: type: object properties: usd: type: number description: Unit price in USD example: 1 required: - usd nullable: true description: >- Unit price in USD. `null` when neither the price oracle nor this quote priced the token. amount: type: string format: uint256 description: >- Token amount in the token's smallest unit example: '1050000' required: - chainId - tokenAddress - symbol - decimals - price - amount description: >- A single (chain, token) leg with amount, price, and metadata required: - paidBy - walletDebit - type: object properties: paidBy: type: string enum: - sponsor required: - paidBy description: >- Solana instruction execution only: the exact fixed wallet debit, or confirmation that the sponsor pays and the wallet has no execution debit. The wallet debit also appears in input. required: - input - output - fees description: >- Route cost: inputs, outputs, and fee breakdown deploymentCosts: type: array items: type: object properties: vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is initialized on example: solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1 rent: type: object properties: amount: type: string format: uint256 description: >- Rent locked in the new accounts, in the chain's native base unit (lamports on Solana) example: '1869440' usd: type: number description: The rent in USD sponsored: type: boolean description: >- True when the sponsor pays it rather than the user required: - amount - usd - sponsored description: The rent the initialization locks required: - vm - chainId - rent description: >- What one account initialization costs beyond `cost.fees`: rent is state, not a fee, and is never counted in `cost.fees.gas`. description: >- The rent each initialization locks, one entry each. requirements: type: array items: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - erc20Approval vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the requirement applies on example: eip155:8453 account: description: The account the requirement applies to anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it tokenAddress: type: string description: Token the requirement applies to example: >- 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 amount: type: string format: uint256 description: >- Minimum amount, in the token's smallest unit example: '1000000' spender: type: string description: >- Always the canonical Permit2 contract on this chain. The account approves Permit2; the settlement contract pulls funds via Permit2 at claim time. example: >- 0x000000000022d473030f116ddee9f6b43ac78ba3 required: - kind - vm - chainId - account - tokenAddress - amount - spender additionalProperties: false - type: object properties: kind: type: string enum: - wrapNative vm: type: string enum: - evm - svm - tvm - stellar - hypercore description: >- Public native execution environment of the chain. A HyperCore delivery venue is `hypercore`, never the HyperEVM chain it settles on. example: evm chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the requirement applies on example: eip155:8453 account: description: The account the requirement applies to anyOf: - type: object properties: address: type: string description: Account address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a type: type: string enum: - eoa - erc7579 description: >- Whether the account is an EOA or an ERC-7579 smart account example: erc7579 deployed: type: boolean description: >- Whether the account is deployed on this chain. Absent when planning read no account state for the chain — never defaulted, which would claim an undeployed account is deployed. example: true implementation: type: object properties: name: type: string enum: - Safe - Kernel - Nexus description: ERC-7579 account implementation example: Nexus version: type: string description: >- Raw trailing version token returned by ERC-7579 `accountId()`, when valid; preserved without normalization example: v1.0.0 required: - name description: >- ERC-7579 implementation planning read on this chain. Absent for an EOA, and for a smart account whose implementation was not resolved. delegation: type: object properties: contract: type: string description: Delegate contract this intent installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - contract description: >- The EIP-7702 delegate this intent INSTALLS on this chain. Present only where the delegate is not yet in place — a delegation already in force is not reported here. required: - address - type description: An EVM account resolved on one chain - type: object properties: wallet: type: string description: >- Asset-holding Swig wallet the intent spends from example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string description: >- Swig state account holding the wallet authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Authority the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey description: >- Authority the submitted signature was verified against when the intent was accepted, as recorded. Absent on an intent record written before it was recorded; never inferred from the account or from current chain state. required: - wallet - swigAccount description: >- A Solana Swig account resolved on one chain - type: object properties: address: type: string minLength: 1 description: >- Address funds are delivered to, in the destination chain's own format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - address description: >- A bare payee with no resolved account behind it tokenAddress: type: string description: Token the requirement applies to example: >- 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 amount: type: string format: uint256 description: >- Minimum amount, in the token's smallest unit example: '1000000' required: - kind - vm - chainId - account - tokenAddress - amount additionalProperties: false description: >- A pre-flight operation the account must perform before this route can be claimed. `quoted` does not mean it is already fulfilled. maxItems: 0 description: >- Always empty: an initialization needs no pre-flight. signingRequests: type: array items: type: object properties: account: discriminator: propertyName: vm oneOf: - type: object properties: vm: type: string enum: - evm address: type: string description: Account the signature authorizes example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - vm - address additionalProperties: false - type: object properties: vm: type: string enum: - svm wallet: type: string minLength: 1 description: >- Asset-holding Swig wallet the spend debits example: >- 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM swigAccount: type: string minLength: 1 description: >- Swig state account holding the authority configuration. Distinct from `wallet`, which is where the assets live. example: >- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v required: - vm - wallet - swigAccount additionalProperties: false description: >- The account this signature acts for, named inline per VM. Carries no per-chain observation, since one request can span chains. authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Address the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address additionalProperties: false description: >- A raw key: the signature is verified by recovering it to this address. - type: object properties: kind: type: string enum: - account vm: type: string enum: - evm address: type: string description: >- Account that verifies the signature itself example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - vm - address additionalProperties: false description: >- The account verifies the signature natively (ERC-1271 / ERC-7579). Its owners are deliberately not enumerated: which key signs is the account itself to decide, and the proof bytes carry no length rule. - type: object properties: kind: type: string enum: - swigRole roleId: type: integer minimum: 0 description: Swig role the spend was authorized under example: 1 authority: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256k1 address: type: string description: >- Address the submitted signature must recover to example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - kind - address additionalProperties: false - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false description: >- A passkey (WebAuthn) key, named by its public key: its signature recovers to no address. description: The authority configured on that role required: - kind - roleId - authority additionalProperties: false description: >- A selected Swig role, plus the authority it carries. Reports the role this quote used; it does not claim to be the only role that could authorize the spend. description: What verifies the signature scope: description: >- What the signature authorizes. Always agrees with the payload; never a restatement of the route. anyOf: - type: object properties: vm: type: string enum: - evm action: type: string enum: - claim - fill - targetExecution - delegation description: What the signature authorizes example: claim accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The accounts and chains the action runs against hyperCore: type: array items: type: object properties: action: type: object description: >- The canonical Hyperliquid action, exactly as the agent commits to it. Key order is part of the commitment — the agent address is recovered from a signature over its msgpack encoding — so it is served in the order it was signed in, not re-sorted. nonce: type: number description: The nonce the action commits to example: 1633493192000 agent: type: string description: >- The agent this registration installs. It is derived from the action bytes above, so it authorises that action and nothing else. slot: type: string description: >- The named API-wallet slot the agent goes in. Registering evicts whatever the account had in that slot; the account's unnamed wallet is never used. example: rh1 required: - nonce - agent - slot additionalProperties: false description: One HyperCore agent registration minItems: 1 description: >- Present only on a request that authorizes at least one HyperCore agent registration. Lists every registration the payload commits to, in registration (slot) order: one item for a per-leg payload, all of them for an aggregate `MultiChainOps` payload. Names what each registration commits to, which the payload itself carries only as CoreWriter calldata. Changing any action, their order, a nonce or an agent requires a fresh quote. required: - vm - action - accounts additionalProperties: false description: >- An EVM scope names accounts, chains and action only — the calls the route runs are disclosed once, in the route's `plan`, so the two cannot disagree. The one exception is `hyperCore`, which names a commitment that exists nowhere else in a readable form. - discriminator: propertyName: action oneOf: - type: object properties: vm: type: string enum: - svm action: type: string enum: - spend accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The wallet the spend debits, on its chain instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The full instruction set this signature authorizes, in execution order, in the same shape a request carries instructions in. addressLookupTables: type: array items: type: string description: >- Address lookup tables the instructions resolve accounts through. The tables themselves are not inlined. feePayer: type: object properties: kind: type: string enum: - role role: type: string enum: - relayer required: - kind - role additionalProperties: false description: >- Who pays the transaction fee, as a role rather than a key: the payload names no payer, and the relayer picks its own. slotWindow: type: object properties: from: type: string description: Slot the payload was pinned to example: '370123456' to: type: string description: Last slot it can be landed in example: '370123516' required: - from - to additionalProperties: false description: Slot range the payload is signable in required: - vm - action - accounts - instructions - addressLookupTables - feePayer - slotWindow additionalProperties: false description: >- A Solana scope additionally discloses the instruction set, because the message itself is an opaque digest. - type: object properties: vm: type: string enum: - svm action: type: string enum: - manageAuthority accounts: type: array items: type: object properties: chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id the account is authorized on example: eip155:8453 address: type: string minLength: 1 description: >- Account address, in its own chain's format example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The Swig state account whose authorities change, on its chain authority: type: object properties: action: type: string enum: - add - remove description: >- Whether the authority is added or removed example: add key: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - secp256r1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed P-256 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03 example: >- 0x036b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296 required: - kind - publicKey additionalProperties: false - type: object properties: kind: type: string enum: - secp256k1 publicKey: type: string pattern: ^0x0[23][0-9a-fA-F]{64}$ description: >- SEC1-compressed secp256k1 public key: 33 bytes as 0x-prefixed hex, leading byte 02 or 03. Not an EVM address. example: >- 0x0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798 required: - kind - publicKey additionalProperties: false description: >- The passkey or secp256k1 key added or removed permission: type: string enum: - all - allButManageAuthority - manageAuthority description: >- The added authority's permission, as requested and installed. Absent on a removal. example: allButManageAuthority roleId: type: integer minimum: 0 description: >- The Swig role id the added authority gets, or the id of the role removed example: 3 rent: type: object properties: amount: type: string format: uint256 description: >- Lamports of rent: locked in the Swig state account on an add, which the sponsor funds, or returned to the Swig wallet on a removal example: '325120' usd: type: number description: The rent in USD required: - amount - usd additionalProperties: false required: - action - key - roleId - rent additionalProperties: false description: >- The change this signature authorizes, exactly as the plan discloses it instructions: type: array items: type: object properties: programId: type: string description: Program to invoke, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA accounts: type: array items: type: object properties: pubkey: type: string description: Account address, base58. example: >- TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA isSigner: type: boolean description: >- Whether the instruction requires this account to sign. isWritable: type: boolean description: >- Whether the instruction writes to this account. required: - pubkey - isSigner - isWritable maxItems: 64 description: >- Accounts the instruction reads or writes, in the order the program expects. data: type: string description: Instruction data, base64. example: CQ== required: - programId - accounts - data description: >- A Solana instruction in the JSON shape `@solana/web3.js` and Jupiter `/swap-instructions` produce, so protocol output passes through unchanged. description: >- The sealed instructions this signature authorizes, in execution order: a passkey signer's secp256r1 precompile, then the Swig `AddAuthorityV1` or `RemoveAuthorityV1`, whose payer is a one-off key the relayer funds. feePayer: type: object properties: kind: type: string enum: - role role: type: string enum: - relayer required: - kind - role additionalProperties: false description: >- Who pays the transaction fee, as a role rather than a key: the payload names no payer, and the relayer picks its own. slotWindow: type: object properties: from: type: string description: Slot the payload was pinned to example: '370123456' to: type: string description: Last slot it can be landed in example: '370123516' required: - from - to additionalProperties: false description: Slot range the payload is signable in required: - vm - action - accounts - authority - instructions - feePayer - slotWindow additionalProperties: false description: >- A Solana authority-change scope: the change itself, and the instructions the message commits to, since the message is an opaque digest. chainIds: type: array items: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- The chains the payload is cryptographically BOUND to, CAIP-2, each listed once — a `MultiChainOps` payload with several legs on one chain still names it once. This is what was signed rather than what the route is about: a Permit2 payload binds to the chain it claims funds on, so a destination request repeats the chain of the origin payload it duplicates. purpose: type: string enum: - originAuthorization - destinationAuthorization - targetExecutionAuthorization - delegationAuthorization description: What the signature is for example: originAuthorization validity: type: array items: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - timestamp expiresAt: type: integer minimum: 0 description: >- Unix seconds after which the payload is dead example: 1733493192 required: - kind - expiresAt additionalProperties: false - type: object properties: kind: type: string enum: - svmSlot chainId: type: string pattern: >- ^(eip155|solana|tron|hypercore|stellar):[-_a-zA-Z0-9]{1,32}$ description: >- CAIP-2 chain id whose slots the deadline counts in example: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp expiresAtSlot: type: string description: Slot after which the payload is dead example: '370123516' required: - kind - chainId - expiresAtSlot additionalProperties: false description: >- A native deadline the payload is bound by. Every constraint returned applies; an empty list means the payload carries none of its own. description: >- Native deadlines that apply to this payload. Empty when it carries none — quote retention is a separate thing and is not a promise that a stale payload is submittable. payload: discriminator: propertyName: kind oneOf: - type: object properties: kind: type: string enum: - eip712 typedData: type: object properties: domain: type: object properties: name: type: string version: type: string chainId: type: number verifyingContract: type: string salt: type: string description: EIP-712 domain separator fields types: type: object additionalProperties: type: array items: type: object properties: name: type: string type: type: string required: - name - type description: >- EIP-712 type definitions keyed by type name primaryType: type: string description: Name of the top-level type to sign example: PermitBatchWitnessTransferFrom message: type: object additionalProperties: {} description: >- Message values keyed by field name. uint256 fields are encoded as decimal strings on the wire and re-coerced to bigint client-side before signing. required: - domain - types - primaryType - message description: >- EIP-712 typed data definition ready for `signTypedData` signatureFormat: type: string enum: - secp256k1 - account description: >- How the proof is encoded: raw 65-byte ECDSA for an EOA, or the account-native encoding for an ERC-7579 account, on which no length rule is imposed. example: secp256k1 required: - kind - typedData - signatureFormat additionalProperties: false - type: object properties: kind: type: string enum: - personalSign message: type: object properties: encoding: type: string enum: - utf8 value: type: string description: >- Sign these characters as UTF-8 TEXT — viem `signMessage({ message })`, never `{ raw }`. Signing the decoded bytes yields a well-formed signature the chain rejects. example: >- a3f2c1d4e5b6a7980f1e2d3c4b5a69788796a5b4c3d2e1f0a1b2c3d4e5f60718 required: - encoding - value additionalProperties: false required: - kind - message additionalProperties: false - type: object properties: kind: type: string enum: - eip7702 authorization: type: object properties: chainId: type: integer minimum: 0 description: >- Native chain value of the authorization tuple, not CAIP-2 example: 8453 address: type: string description: >- Delegate contract the authorization installs example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - chainId - address additionalProperties: false description: >- The delegation to authorize. Carries no nonce: the orchestrator observes no EOA nonces, and one read at quote time is stale by signing time — the signer supplies it with the proof. required: - kind - authorization additionalProperties: false - type: object properties: kind: type: string enum: - webauthn challenge: type: string pattern: ^0x[0-9a-fA-F]{64}$ description: >- Challenge the authenticator signs: 32 bytes as 0x-prefixed hex. Pass the decoded bytes as the WebAuthn `challenge`, not the hex text. example: >- 0xa3f2c1d4e5b6a7980f1e2d3c4b5a69788796a5b4c3d2e1f0a1b2c3d4e5f60718 required: - kind - challenge additionalProperties: false description: >- Served for a Solana spend out of a passkey-owned Swig, whose role names a secp256r1 authority. Answered with a `webauthn` proof. description: The native payload to sign required: - account - authority - scope - chainIds - purpose - validity - payload additionalProperties: false description: >- One payload the caller must sign. Answer request `i` with proof `i`. maxItems: 0 description: >- Always empty: the initialization is sponsored and signed by nobody. Submit with `proofs: []`. required: - intentId - purpose - expiresAt - estimatedFillTime - settlementLayer - plan - cost - deploymentCosts - requirements - signingRequests description: >- A single route candidate that initializes an account description: >- A single ranked route candidate, tagged with its purpose description: >- Route candidates ranked by the orchestrator's internal scoring (cheaper + faster wins). The first entry is the recommended route — most clients should submit it without inspecting the rest. required: - status - routes description: Response body for `POST /quotes` on the caucasus API version '400': description: Invalid request parameters content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '401': description: The credential carries no platform token content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '403': description: API key scope denied content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '404': description: The sponsor of the requested sponsorship has no record content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '422': description: >- No route can serve the request. `details[0].context.code` names the reason. content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '500': description: Server error content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '503': description: Quoting is paused content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message '504': description: A routing provider timed out content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "destination.chainId" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: description: Minimum level the endpoint demands anyOf: - type: boolean - type: string enum: - read - write actual: description: Level resolved on the key anyOf: - type: boolean - type: string enum: - none - read - write required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - SPONSORSHIP_BINDING_MISMATCH - SPONSORSHIP_BINDING_UNSUPPORTED - QUOTE_AUTHORIZATION_MISSING - QUOTE_OWNER_MISMATCH - QUOTE_AUTHORIZATION_EXPIRED - SPONSORSHIP_AUTHORIZATION_USED - CONFLICT - WITHDRAWAL_IN_PROGRESS - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - SERVICE_PAUSED - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Error message context: type: object additionalProperties: {} description: >- Structured context. A planning refusal names its reason in `context.code` (e.g. `NO_PLAN_AVAILABLE`). required: - message description: The error and its structured context required: - code - message security: - apiKeyAuth: [] - bearerAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Project API key. bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Integrator-issued access token (JWT authentication mode). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.