> ## 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. # Get Intent Route > Retrieves the route token transfers and target executions based on the provided user address and intent. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/orchestrator.json post /intents/route openapi: 3.0.2 info: title: Rhinestone Orchestrator API version: 1.0.0 servers: - url: https://v1.orchestrator.rhinestone.dev security: [] paths: /intents/route: post: tags: [] summary: Get Intent Route description: >- Retrieves the route token transfers and target executions based on the provided user address and intent. parameters: - name: x-api-key in: header required: true schema: type: string description: Rhinestone API key - name: x-api-version in: header schema: type: string pattern: ^\d{4}-\d{2}\.[a-z0-9]+$ description: >- API version (YYYY-MM.name). Will become required in a future release. example: 2026-01.alps - name: x-feature-flags in: header schema: type: string requestBody: description: Body content: application/json: schema: type: object properties: destinationChainId: type: number minimum: 0 description: The ID of the target blockchain example: 8453 tokenRequests: type: array items: oneOf: - type: object properties: tokenAddress: type: string description: The address of the requested token example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' amount: type: integer format: int64 description: >- The amount of the requested token (in the smallest unit) example: '1000000' required: - tokenAddress - amount - type: object properties: tokenAddress: type: string description: The address of the requested token example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' amount: type: integer format: int64 description: >- The amount of the requested token (in the smallest unit) example: '1000000' required: - tokenAddress description: A list of token requested on the target chain account: type: object properties: address: type: string description: Account address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' accountType: type: string enum: - smartAccount - GENERIC - EOA - ERC7579 description: Account type setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data example: 0x... required: - to - data description: >- Setup operations for the smart account. Only used if the account is not deployed emissaryConfig: type: object properties: validatorAddress: type: string description: Address of the validator contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryAddress: type: string description: Address of the emissary contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryEnable: type: object properties: allocatorSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the allocator example: 0x... userSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the user example: 0x... expires: type: integer format: int64 description: Expiration timestamp example: '1733493192' nonce: type: integer format: int64 description: Nonce example: '0' allChainIds: type: array items: type: integer format: int64 description: All chain IDs example: - 1 - 10 - 137 chainIndex: type: integer format: int64 description: Chain index example: '0' required: - allocatorSig - userSig - expires - nonce - allChainIds - chainIndex description: Emissary enable data example: allocatorSig: 0x... userSig: 0x... settings: type: object properties: configId: type: number maximum: 255 description: Unique identifier for the emissary configuration example: '42' allocator: default: '0xc7732071e3a1be6cfce6d13bb05699a31a457679' type: string description: Address of the allocator example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' scope: default: 0 type: number description: Scope of the emissary example: 1 resetPeriod: default: 6 type: number description: Reset period of the emissary example: 1 validator: type: string description: Address of the validator example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' validatorConfig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Validator configuration example: 0x... required: - configId - validator - validatorConfig description: Emissary configuration example: allocator: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' required: - validatorAddress - emissaryAddress - emissaryEnable - settings description: Emissary configuration for using resource locking mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Pre-encoded SSX enable payload with a dummy userSig for gas estimation. When present, the orchestrator etches the simulation emissary and uses this as emissaryData. delegations: type: object additionalProperties: type: object properties: contract: type: string description: >- address of contract to which delegation on behalf of sponsor will be assumed for given chain ID required: - contract description: >- Per-chain specific map to delegated contract address for 7702 delegations. Use `0` to indicate cross-chain delegation required: - address description: Account details destinationExecutions: type: array items: type: object properties: to: type: string description: Target contract address for execution example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: type: integer format: int64 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: Execution calls on the target chain. preClaimExecutions: type: object additionalProperties: type: array items: type: object properties: to: type: string description: Target contract address for execution example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: type: integer format: int64 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 maxItems: 10 description: >- Execution calls to perform before the claim on each origin chain, keyed by chain ID. Max 10 ops per chain, max 5 chains. example: '8453': - to: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: '0' data: 0x destinationGasUnits: type: integer format: int64 description: The gas limit for the target chain executions example: '100000' accountAccessList: oneOf: - type: object properties: chainIds: type: array items: type: number minimum: 0 tokens: type: array items: oneOf: - type: string - type: string enum: - ETH - USDC - WETH - USDT0 - USDT - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - HYPE - WHYPE - XPL - WXPL - MockUSD chainTokens: type: object additionalProperties: type: array items: oneOf: - type: string - type: string enum: - ETH - USDC - WETH - USDT0 - USDT - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - HYPE - WHYPE - XPL - WXPL - MockUSD exclude: type: object properties: chainIds: type: array items: type: number minimum: 0 tokens: type: array items: oneOf: - type: string - type: string enum: - ETH - USDC - WETH - USDT0 - USDT - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - HYPE - WHYPE - XPL - WXPL - MockUSD chainTokens: type: object additionalProperties: type: array items: oneOf: - type: string - type: string enum: - ETH - USDC - WETH - USDT0 - USDT - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - HYPE - WHYPE - XPL - WXPL - MockUSD - type: array items: type: object properties: chainId: type: number minimum: 0 tokenAddress: type: string amount: type: integer format: int64 required: - chainId - tokenAddress description: >- Account access list specifying which chains and tokens an account may access recipient: type: object properties: address: type: string description: Account address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' accountType: type: string enum: - smartAccount - GENERIC - EOA - ERC7579 description: Account type setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data example: 0x... required: - to - data description: >- Setup operations for the smart account. Only used if the account is not deployed emissaryConfig: type: object properties: validatorAddress: type: string description: Address of the validator contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryAddress: type: string description: Address of the emissary contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryEnable: type: object properties: allocatorSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the allocator example: 0x... userSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the user example: 0x... expires: type: integer format: int64 description: Expiration timestamp example: '1733493192' nonce: type: integer format: int64 description: Nonce example: '0' allChainIds: type: array items: type: integer format: int64 description: All chain IDs example: - 1 - 10 - 137 chainIndex: type: integer format: int64 description: Chain index example: '0' required: - allocatorSig - userSig - expires - nonce - allChainIds - chainIndex description: Emissary enable data example: allocatorSig: 0x... userSig: 0x... settings: type: object properties: configId: type: number maximum: 255 description: Unique identifier for the emissary configuration example: '42' allocator: default: '0xc7732071e3a1be6cfce6d13bb05699a31a457679' type: string description: Address of the allocator example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' scope: default: 0 type: number description: Scope of the emissary example: 1 resetPeriod: default: 6 type: number description: Reset period of the emissary example: 1 validator: type: string description: Address of the validator example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' validatorConfig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Validator configuration example: 0x... required: - configId - validator - validatorConfig description: Emissary configuration example: allocator: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' required: - validatorAddress - emissaryAddress - emissaryEnable - settings description: Emissary configuration for using resource locking mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Pre-encoded SSX enable payload with a dummy userSig for gas estimation. When present, the orchestrator etches the simulation emissary and uses this as emissaryData. delegations: type: object additionalProperties: type: object properties: contract: type: string description: >- address of contract to which delegation on behalf of sponsor will be assumed for given chain ID required: - contract description: >- Per-chain specific map to delegated contract address for 7702 delegations. Use `0` to indicate cross-chain delegation required: - address description: Account details options: type: object properties: topupCompact: default: false type: boolean description: >- Whether to top up the compact locked balance using unlocked funds example: true settlementLayers: type: array items: type: string enum: - ACROSS - ECO - RELAY - OFT - NEAR - RHINO description: The settlement layer to be used to settle intents example: - ECO sponsorSettings: type: object properties: gasSponsored: default: false type: boolean description: Whether to sponsor gas for the intent example: true bridgeFeesSponsored: default: false type: boolean description: Whether to sponsor bridge fees for the intent swapFeesSponsored: default: false type: boolean description: Whether to sponsor swap fees for the intent description: Sponsor settings for the intent example: gasSponsored: true bridgeFeesSponsored: true swapFeesSponsored: true signatureMode: type: string enum: - EMISSARY - ERC1271 - EMISSARY_ERC1271 - ERC1271_EMISSARY - EMISSARY_EXECUTION - EMISSARY_EXECUTION_ERC1271 - ERC1271_EMISSARY_EXECUTION - 0 - 1 - 2 - 3 - 4 - 5 - 6 description: The signature mode to be used example: 3 feeToken: type: string enum: - ETH - USDC - WETH - USDT0 - USDT - BNB - WBNB - XDAI - WXDAI - POL - WPOL - MON - WMON - S - WS - HYPE - WHYPE - XPL - WXPL - MockUSD 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' auxiliaryFunds: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 description: >- Additional token balances to consider during route finding example: '42161': '0xaf88d065e77c8cC2239327C5EDb3A432268e5831': '500000000' description: Intent options example: topupCompact: true settlementLayers: - ECO sponsorSettings: gasSponsored: true bridgeFeesSponsored: true swapFeesSponsored: true feeToken: USDC required: - destinationChainId - tokenRequests - account responses: '200': description: '200' content: application/json: schema: type: object properties: intentOp: type: object properties: sponsor: type: string description: Address sponsoring the transaction example: '0x8a310b9085faF5d9464D84C3d9a7BE3b28c94531' nonce: type: integer format: int64 description: Transaction nonce example: '0' targetExecutionNonce: type: integer format: int64 description: Target execution nonce example: '0' expires: type: integer format: int64 description: Expiration timestamp example: '1733493192' elements: type: array items: type: object properties: arbiter: type: string description: Arbiter address for the element example: '0x8a310b9085faF5d9464D84C3d9a7BE3b28c94531' chainId: type: integer format: int64 description: Chain ID where the element is executed example: '1' idsAndAmounts: description: Array of [tokenId, amount] pairs example: - - '1' - '1000000' - - '2' - '2000000' spendTokens: description: >- Array of [tokenId, amount] pairs that were effectively used as resource locks example: - - '1' - '1000000' - - '2' - '2000000' mandate: type: object properties: recipient: type: string description: Recipient address for the mandate example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' tokenOut: description: >- Array of [tokenId, amount] pairs for output tokens example: - - '1' - '1000000' - - '2' - '2000000' destinationChainId: type: integer format: int64 description: Target chain ID for the mandate example: '8453' fillDeadline: type: integer format: int64 description: Deadline timestamp for filling the mandate example: '1733493192' preClaimOps: description: Executions to perform before claiming destinationOps: description: Executions to perform on the target chain qualifier: type: object properties: settlementContext: discriminator: propertyName: settlementLayer oneOf: - type: object properties: settlementLayer: type: string enum: - INTENT_EXECUTOR description: Settlement layer for the qualifier example: INTENT_EXECUTOR using7579: type: boolean description: >- true for ERC7579 smart accounts, false for EOAs (MULTICALL execution) example: true fundingMethod: type: string enum: - NO_FUNDING description: Must be NO_FUNDING for INTENT_EXECUTOR example: NO_FUNDING gasRefund: type: object properties: overhead: type: integer format: int64 description: >- Overhead gas amount add to gas spent when executing destination ops exchangeRate: type: integer format: int64 description: >- Exchange rate between token selected for gas refund and native token consumed for gas token: type: string description: >- token address which will be used for gas refunding required: - overhead - exchangeRate - token description: gas refund information prefundAmount: type: integer format: int64 description: >- Native ETH the relayer sends to user before execution (e.g. OFT lzFee) bridgeFill: discriminator: propertyName: type oneOf: - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - OFT description: Bridge type required: - destinationChainId - type - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - RELAY description: Bridge type requestId: type: string description: Relay API request ID required: - destinationChainId - type - requestId - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - NEAR description: Bridge type depositAddress: type: string description: >- NEAR 1Click deposit address for status tracking required: - destinationChainId - type - depositAddress - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - RHINO description: Bridge type commitmentId: type: string description: >- Rhino.fi commitment ID (hex ObjectId) for fill tracking required: - destinationChainId - type - commitmentId description: >- Bridge-as-fill metadata for cross-chain delivery tracking required: - settlementLayer - using7579 - fundingMethod - gasRefund - type: object properties: settlementLayer: type: string enum: - SAME_CHAIN description: Settlement layer for the qualifier example: SAME_CHAIN using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 bridgeFill: discriminator: propertyName: type oneOf: - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - OFT description: Bridge type required: - destinationChainId - type - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - RELAY description: Bridge type requestId: type: string description: Relay API request ID required: - destinationChainId - type - requestId - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - NEAR description: Bridge type depositAddress: type: string description: >- NEAR 1Click deposit address for status tracking required: - destinationChainId - type - depositAddress - type: object properties: destinationChainId: type: number description: Destination chain ID for the bridge fill type: type: string enum: - RHINO description: Bridge type commitmentId: type: string description: >- Rhino.fi commitment ID (hex ObjectId) for fill tracking required: - destinationChainId - type - commitmentId description: >- Bridge-as-fill metadata for cross-chain delivery tracking required: - settlementLayer - using7579 - fundingMethod - type: object properties: settlementLayer: type: string enum: - ACROSS description: Settlement layer for the qualifier example: ACROSS using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 required: - settlementLayer - using7579 - fundingMethod - type: object properties: settlementLayer: type: string enum: - ECO description: Settlement layer for the qualifier example: ECO using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 provingFee: type: integer format: int64 description: >- Hyperlane relay fee for proof dispatch (in destination chain native token) required: - settlementLayer - using7579 - fundingMethod - provingFee - type: object properties: settlementLayer: type: string enum: - RELAY description: Settlement layer for the qualifier example: RELAY using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 requestId: type: string description: >- Relay settlement layer metadata to be broadcasted orderId: type: string description: >- Relay v2 order ID used in the deposit contract calldata subsidizedAmount: type: string description: >- Relay settlement layer subsidized amount on the intent (denomination in USDC) multicallData: type: string description: >- ABI-encoded params for IRelayRouterV3.multicall, used for origin swaps via Relay contracts preClaimValidationGas: type: integer format: int64 description: >- Estimated pre-claim validation gas used for originGasOverhead and preClaimGasStipend required: - settlementLayer - using7579 - fundingMethod - requestId - orderId - type: object properties: settlementLayer: type: string enum: - NEAR description: Settlement layer for the qualifier example: NEAR using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 depositAddress: type: string description: >- NEAR-provided deposit address on the origin chain correlationId: type: string description: >- NEAR correlation ID for tracking the intent required: - settlementLayer - using7579 - fundingMethod - depositAddress - correlationId - type: object properties: settlementLayer: type: string enum: - RHINO description: Settlement layer for the qualifier example: RHINO using7579: type: boolean description: Whether to use 7579 example: false fundingMethod: type: string enum: - COMPACT - PERMIT2 - NO_FUNDING description: The method of funding the intent example: PERMIT2 quoteId: type: string description: >- Rhino.fi quote identifier — committed quote that becomes the commitmentId for the on-chain deposit required: - settlementLayer - using7579 - fundingMethod - quoteId encodedVal: type: string pattern: ^0x[a-fA-F0-9]*$ description: Encoded qualification value example: 0x... required: - settlementContext - encodedVal description: Qualification data for the mandate minGas: type: integer format: int64 description: Mininimum gas for preclaim ops example: '0' swapDestinations: type: array items: type: object properties: tokenIn: type: string amountIn: type: integer format: int64 amountOut: type: integer format: int64 slippage: type: number quoter: type: string executions: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: integer format: int64 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 senderAddressPlaceholder: type: string recipientAddressPlaceholder: type: string required: - to - value - data outputDecimals: type: number outputSymbol: type: string required: - tokenIn - amountIn - amountOut - slippage - quoter - executions - outputDecimals - outputSymbol nullable: true description: >- Swap execution data for arbitrary output tokens, aligned by index with tokenOut required: - recipient - tokenOut - destinationChainId - fillDeadline - preClaimOps - destinationOps - qualifier - minGas description: Mandate containing execution details swapOrigins: type: object additionalProperties: type: object properties: tokenIn: type: string tokenOut: type: string amountIn: type: integer format: int64 amountOut: type: integer format: int64 slippage: type: number quoter: type: string executions: type: array items: type: object properties: to: type: string description: Target contract address for execution example: >- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 value: type: integer format: int64 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 senderAddressPlaceholder: type: string recipientAddressPlaceholder: type: string required: - to - value - data inputDecimals: type: number inputSymbol: type: string price: type: number gasEstimate: type: number required: - tokenIn - tokenOut - amountIn - amountOut - slippage - quoter - executions - inputDecimals - inputSymbol - price description: >- Swap execution data for arbitrary input tokens, keyed by spendToken address required: - arbiter - chainId - idsAndAmounts - spendTokens - mandate description: Array of execution elements serverSignature: type: string pattern: ^[0-9a-f]{64}$ description: Intent operation HMAC digest example: 0x... signedMetadata: type: object properties: schemeId: type: string description: Serialization scheme identifier example: v1 tokenPrices: type: object additionalProperties: type: number description: Token prices in USD example: USDC: 1 WETH: 2000 gasPrices: type: object additionalProperties: type: integer format: int64 description: Gas prices per chain in wei example: '1': '20000000000' '10': '1000000000' opGasParams: type: object properties: estimatedCalldataSize: type: number additionalProperties: type: object properties: l1BaseFee: type: integer format: int64 l1BlobBaseFee: type: integer format: int64 baseFeeScalar: type: integer format: int64 blobFeeScalar: type: integer format: int64 required: - l1BaseFee - l1BlobBaseFee - baseFeeScalar - blobFeeScalar description: Optimism network gas parameters per chain example: '10': l1BaseFee: '100' l1BlobBaseFee: '100' baseFeeScalar: '100' blobFeeScalar: '100' account: type: object properties: address: type: string description: Account address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' accountType: type: string enum: - smartAccount - GENERIC - EOA - ERC7579 description: Account type setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data example: 0x... required: - to - data description: >- Setup operations for the smart account. Only used if the account is not deployed emissaryConfig: type: object properties: validatorAddress: type: string description: Address of the validator contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryAddress: type: string description: Address of the emissary contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryEnable: type: object properties: allocatorSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the allocator example: 0x... userSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the user example: 0x... expires: type: integer format: int64 description: Expiration timestamp example: '1733493192' nonce: type: integer format: int64 description: Nonce example: '0' allChainIds: type: array items: type: integer format: int64 description: All chain IDs example: - 1 - 10 - 137 chainIndex: type: integer format: int64 description: Chain index example: '0' required: - allocatorSig - userSig - expires - nonce - allChainIds - chainIndex description: Emissary enable data example: allocatorSig: 0x... userSig: 0x... settings: type: object properties: configId: type: number maximum: 255 description: >- Unique identifier for the emissary configuration example: '42' allocator: default: >- 0xc7732071e3a1be6cfce6d13bb05699a31a457679 type: string description: Address of the allocator example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a scope: default: 0 type: number description: Scope of the emissary example: 1 resetPeriod: default: 6 type: number description: Reset period of the emissary example: 1 validator: type: string description: Address of the validator example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a validatorConfig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Validator configuration example: 0x... required: - configId - validator - validatorConfig description: Emissary configuration example: allocator: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - validatorAddress - emissaryAddress - emissaryEnable - settings description: >- Emissary configuration for using resource locking mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Pre-encoded SSX enable payload with a dummy userSig for gas estimation. When present, the orchestrator etches the simulation emissary and uses this as emissaryData. accountContext: type: object additionalProperties: discriminator: propertyName: accountType oneOf: - type: object properties: accountType: type: string enum: - EOA description: Type of the account example: EOA required: - accountType additionalProperties: false - type: object properties: accountType: type: string enum: - smartAccount description: Type of the account example: smartAccount isDeployed: type: boolean description: >- Whether the account is deployed on this chain example: true isERC7579: type: boolean description: >- Whether the account supports ERC7579 standard example: true erc7579AccountType: type: string enum: - Safe - Kernel - Nexus description: Type of ERC7579 account example: Safe erc7579AccountVersion: type: string description: Version of the ERC7579 account example: 1.0.0 required: - accountType - isDeployed - isERC7579 additionalProperties: false description: Account status per chain requiredDelegations: type: object additionalProperties: type: object properties: contract: type: string description: >- address of contract to which delegation on behalf of sponsor will be assumed for given chain ID required: - contract description: >- Map of chain -> EOA and delegated address required for user to sign for 7702 authorizations required: - address - accountContext recipient: type: object properties: address: type: string description: Account address example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' accountType: type: string enum: - smartAccount - GENERIC - EOA - ERC7579 description: Account type setupOps: type: array items: type: object properties: to: type: string description: Account deployment factory address example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a data: type: string pattern: ^0x[a-fA-F0-9]*$ description: Account deployment data example: 0x... required: - to - data description: >- Setup operations for the smart account. Only used if the account is not deployed emissaryConfig: type: object properties: validatorAddress: type: string description: Address of the validator contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryAddress: type: string description: Address of the emissary contract example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' emissaryEnable: type: object properties: allocatorSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the allocator example: 0x... userSig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Signature of the user example: 0x... expires: type: integer format: int64 description: Expiration timestamp example: '1733493192' nonce: type: integer format: int64 description: Nonce example: '0' allChainIds: type: array items: type: integer format: int64 description: All chain IDs example: - 1 - 10 - 137 chainIndex: type: integer format: int64 description: Chain index example: '0' required: - allocatorSig - userSig - expires - nonce - allChainIds - chainIndex description: Emissary enable data example: allocatorSig: 0x... userSig: 0x... settings: type: object properties: configId: type: number maximum: 255 description: >- Unique identifier for the emissary configuration example: '42' allocator: default: >- 0xc7732071e3a1be6cfce6d13bb05699a31a457679 type: string description: Address of the allocator example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a scope: default: 0 type: number description: Scope of the emissary example: 1 resetPeriod: default: 6 type: number description: Reset period of the emissary example: 1 validator: type: string description: Address of the validator example: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a validatorConfig: type: string pattern: ^0x[a-fA-F0-9]*$ description: Validator configuration example: 0x... required: - configId - validator - validatorConfig description: Emissary configuration example: allocator: >- 0x579d5631f76126991c00fb8fe5467fa9d49e5f6a required: - validatorAddress - emissaryAddress - emissaryEnable - settings description: >- Emissary configuration for using resource locking mockSignature: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Pre-encoded SSX enable payload with a dummy userSig for gas estimation. When present, the orchestrator etches the simulation emissary and uses this as emissaryData. accountContext: type: object additionalProperties: discriminator: propertyName: accountType oneOf: - type: object properties: accountType: type: string enum: - EOA description: Type of the account example: EOA required: - accountType additionalProperties: false - type: object properties: accountType: type: string enum: - smartAccount description: Type of the account example: smartAccount isDeployed: type: boolean description: >- Whether the account is deployed on this chain example: true isERC7579: type: boolean description: >- Whether the account supports ERC7579 standard example: true erc7579AccountType: type: string enum: - Safe - Kernel - Nexus description: Type of ERC7579 account example: Safe erc7579AccountVersion: type: string description: Version of the ERC7579 account example: 1.0.0 required: - accountType - isDeployed - isERC7579 additionalProperties: false description: Account status per chain requiredDelegations: type: object additionalProperties: type: object properties: contract: type: string description: >- address of contract to which delegation on behalf of sponsor will be assumed for given chain ID required: - contract description: >- Map of chain -> EOA and delegated address required for user to sign for 7702 authorizations required: - address - accountContext fees: type: object properties: sponsorFee: type: object properties: relayer: type: number description: Fee charged by relayer example: 0.0009 protocol: type: number description: Fee charged by Rhinestone example: 0 required: - relayer - protocol description: Transaction fees protocolFees: type: object additionalProperties: type: integer format: int64 description: >- Protocol fees by token address (in token units) example: '0x0000000000000000000000000000000000000000': '1000000' 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' preClaimExecutions: type: object additionalProperties: type: array items: type: object properties: to: type: string description: Target contract address for execution example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' value: type: integer format: int64 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 maxItems: 10 description: >- User-supplied pre-claim executions included in the bundle, keyed by chain ID. required: - tokenPrices - gasPrices - opGasParams - account description: >- Signed metadata containing prices, fees, and gas parameters signedAuthorizations: type: array items: type: object properties: chainId: type: number description: >- Chain ID for EIP-7702 delegation, 0 means it can be applied to any chain example: 8453 address: type: string description: Address of the delegate for EIP-7702 delegation example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' nonce: type: number description: Nonce for EIP-7702 delegation example: '0' yParity: type: number description: Y parity for EIP-7702 delegation example: 27 r: type: string pattern: ^0x[a-fA-F0-9]*$ description: R value for EIP-7702 delegation example: 0x... s: type: string pattern: ^0x[a-fA-F0-9]*$ description: S value for EIP-7702 delegation example: 0x... required: - chainId - address - nonce - yParity - r - s description: >- List of 7702 authorizations signed by EOA matching sponsor recipientSignedAuthorizations: type: array items: type: object properties: chainId: type: number description: >- Chain ID for EIP-7702 delegation, 0 means it can be applied to any chain example: 8453 address: type: string description: Address of the delegate for EIP-7702 delegation example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' nonce: type: number description: Nonce for EIP-7702 delegation example: '0' yParity: type: number description: Y parity for EIP-7702 delegation example: 27 r: type: string pattern: ^0x[a-fA-F0-9]*$ description: R value for EIP-7702 delegation example: 0x... s: type: string pattern: ^0x[a-fA-F0-9]*$ description: S value for EIP-7702 delegation example: 0x... required: - chainId - address - nonce - yParity - r - s description: >- List of 7702 authorizations signed by EOA matching recipient account (if present) required: - sponsor - nonce - expires - elements - serverSignature - signedMetadata description: >- The order bundle containing multi-chain execution details with pricing metadata intentCost: oneOf: - type: object properties: hasFulfilledAll: type: boolean enum: - true description: Indicates that all tokens have been fulfilled tokensSpent: type: object additionalProperties: type: object additionalProperties: type: object properties: locked: type: integer format: int64 unlocked: type: integer format: int64 required: - locked - unlocked description: Tokens spent in the transaction tokensReceived: type: array items: type: object properties: tokenAddress: type: string amountSpent: type: integer format: int64 targetAmount: type: integer format: int64 fee: type: integer format: int64 feeBreakdown: type: object properties: gasFee: type: integer format: int64 description: >- Combined gas fees: destination fill, destination swap execution, and origin chain gas example: '5000' bridgeFee: type: integer format: int64 description: >- Cross-chain bridge commission charged by the relayer example: '2000' protocolFee: type: integer format: int64 description: Protocol fee charged by Rhinestone example: '0' swapFee: type: integer format: int64 description: >- Solver swap commission for cross-token conversions example: '50000' settlementFee: type: integer format: int64 description: >- Settlement layer fee (e.g. Relay, Across) example: '1000' required: - gasFee - bridgeFee - protocolFee - swapFee - settlementFee description: >- Per-category breakdown of fees in token units (BPS-derived computed values) feesByToken: type: object additionalProperties: type: object properties: amount: type: integer format: int64 description: Fee amount in this token example: '19989' breakdown: type: object properties: gasFee: type: integer format: int64 description: >- Combined gas fees: destination fill, destination swap execution, and origin chain gas example: '5000' bridgeFee: type: integer format: int64 description: >- Cross-chain bridge commission charged by the relayer example: '2000' protocolFee: type: integer format: int64 description: Protocol fee charged by Rhinestone example: '0' swapFee: type: integer format: int64 description: >- Solver swap commission for cross-token conversions example: '50000' settlementFee: type: integer format: int64 description: >- Settlement layer fee (e.g. Relay, Across) example: '1000' required: - gasFee - bridgeFee - protocolFee - swapFee - settlementFee description: >- Per-category breakdown of fees in token units (BPS-derived computed values) required: - amount - breakdown description: >- Fee entry for a specific token with per-category breakdown description: >- Fees paid in tokens other than the output token (e.g., settlement fees, origin gas in input token) example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913': amount: '19989' breakdown: gasFee: '19987' bridgeFee: '0' protocolFee: '0' swapFee: '0' settlementFee: '2' hasFulfilled: type: boolean required: - tokenAddress - amountSpent - targetAmount - fee - feeBreakdown - feesByToken - hasFulfilled description: Tokens received in the transaction sponsorFee: type: object properties: relayer: type: number description: Fee charged by relayer example: 0.0009 protocol: type: number description: Fee charged by Rhinestone example: 0 required: - relayer - protocol description: Transaction fees gasCost: type: object properties: originChains: type: array items: type: object properties: chainId: type: number description: Chain ID where the gas cost was incurred example: 8453 gasUSD: type: number description: Gas cost in USD example: 1.2 required: - chainId - gasUSD description: Gas costs per origin chain destination: type: object properties: chainId: type: number description: Chain ID where the gas cost was incurred example: 8453 gasUSD: type: number description: Gas cost in USD example: 1.2 required: - chainId - gasUSD description: Gas cost on the destination chain totalUSD: type: number description: Total gas cost in USD across all chains example: 4.15 required: - originChains - destination - totalUSD description: >- Breakdown of gas costs across origin and destination chains feeBreakdownUSD: type: object properties: gasFeeUSD: type: number description: >- Total gas fees in USD (destination fill, swap execution, origin gas) example: 0.029 bridgeFeeUSD: type: number description: Total bridge commission in USD example: 0.000015 protocolFeeUSD: type: number description: Total protocol fee in USD example: 0 swapFeeUSD: type: number description: Total solver swap commission in USD example: 0 settlementFeeUSD: type: number description: Total settlement layer fee in USD example: 0.000002 totalFeeUSD: type: number description: Sum of all fees in USD (including sponsored) example: 0.029017 required: - gasFeeUSD - bridgeFeeUSD - protocolFeeUSD - swapFeeUSD - settlementFeeUSD - totalFeeUSD description: >- Aggregate fee breakdown in USD across all tokens and chains required: - hasFulfilledAll - tokensSpent - tokensReceived - sponsorFee - gasCost - feeBreakdownUSD - type: object properties: hasFulfilledAll: type: boolean enum: - false description: Indicates that not all tokens have been fulfilled tokenShortfall: type: array items: type: object properties: tokenAddress: type: string description: >- Address of the token that has not been fulfilled example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' destinationAmount: type: integer format: int64 description: >- Target amount of the token that has not been fulfilled example: '1000000' amountSpent: type: integer format: int64 description: >- Amount spent on the token that has not been fulfilled example: '500000' fee: type: integer format: int64 description: >- Fee associated with the token that has not been fulfilled example: '10000' feesByToken: type: object additionalProperties: type: object properties: amount: type: integer format: int64 description: Fee amount in this token example: '19989' breakdown: type: object properties: gasFee: type: integer format: int64 description: >- Combined gas fees: destination fill, destination swap execution, and origin chain gas example: '5000' bridgeFee: type: integer format: int64 description: >- Cross-chain bridge commission charged by the relayer example: '2000' protocolFee: type: integer format: int64 description: Protocol fee charged by Rhinestone example: '0' swapFee: type: integer format: int64 description: >- Solver swap commission for cross-token conversions example: '50000' settlementFee: type: integer format: int64 description: >- Settlement layer fee (e.g. Relay, Across) example: '1000' required: - gasFee - bridgeFee - protocolFee - swapFee - settlementFee description: >- Per-category breakdown of fees in token units (BPS-derived computed values) required: - amount - breakdown description: >- Fee entry for a specific token with per-category breakdown description: >- Fees paid in tokens other than the output token (e.g., settlement fees, origin gas in input token) example: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913': amount: '19989' breakdown: gasFee: '19987' bridgeFee: '0' protocolFee: '0' swapFee: '0' settlementFee: '2' tokenSymbol: type: string description: >- Symbol of the token that has not been fulfilled example: USDC tokenDecimals: type: number minimum: 0 description: Number of decimal places for the token example: 6 required: - tokenAddress - destinationAmount - amountSpent - fee - feesByToken - tokenSymbol - tokenDecimals description: List of tokens that have not been fulfilled totalTokenShortfallInUSD: type: number minimum: 0 description: Total shortfall of tokens in USD example: 500 required: - hasFulfilledAll - tokenShortfall - totalTokenShortfallInUSD tokenRequirements: type: object additionalProperties: type: object additionalProperties: oneOf: - type: object properties: type: type: string enum: - approval amount: type: integer format: int64 spender: type: string required: - type - amount - spender - type: object properties: type: type: string enum: - wrap amount: type: integer format: int64 required: - type - amount description: Token requirements for the intent to pass. For EOAs only. required: - intentOp - intentCost description: Successfully retrieved the route '400': description: '400' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: message: type: string description: Error message example: Invalid input context: nullable: true description: Additional error context required: - message traceId: type: string description: Trace ID example: eb0ba4657f36364b33ec565c15f98368 required: - errors - traceId description: Invalid request parameters '500': description: '500' content: application/json: schema: type: object properties: error: type: string description: Error message describing the server-side issue example: An unknown error occurred required: - error description: Server error ````