> For the complete documentation index, see [llms.txt](https://docs.intents.aurora.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intents.aurora.dev/api-reference/intents-connect-api-reference/request-an-execution.md). # Request an execution ## Create a quote-backed execution > Creates or dry-runs a quote-backed execution. In non-dry mode the response includes the MPC intent payload that the frontend must sign. The destination type selects the step shape - EVM destinations send ExecutionStepEVM objects, Solana destinations (type=solana) send ExecutionStepSolana objects under the same steps key. The type field accepts only evm or solana and defaults to evm when omitted - any other value is rejected with 400. Bridge-in requests execute steps on the destination chain after the 1click deposit succeeds. Out-operation requests execute steps on the origin chain and transfer the resulting tokens to the 1click deposit address. Solana supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token. Step objects accept only their documented fields - a key from the other step shape, a differently cased spelling of a field, the same key twice, or any field not listed is rejected with 400. Anything else a client needs to carry belongs in the step metadata object, which the backend passes through untouched. Step payloads nested more than 15 containers deep are also rejected with 400, counting the steps array itself as the first level - the metadata object is exempt. A step functionSignature may nest tuples or arrays at most 6 levels deep and may be at most 1024 bytes. An EVM steps array may hold at most 30 steps and a Solana one at most 50. Request bodies are limited to 256 KB. For Stellar origins the response includes quote.depositMemo and the deposit transfer must include that memo or the bridge will not settle. ```json {"openapi":"3.0.3","info":{"title":"Intents Connect API","version":"1.0"},"servers":[{"url":"https://intents-connect-api.aurora.dev"}],"paths":{"/api/v1/executions/{wallet}":{"post":{"description":"Creates or dry-runs a quote-backed execution. In non-dry mode the response includes the MPC intent payload that the frontend must sign. The destination type selects the step shape - EVM destinations send ExecutionStepEVM objects, Solana destinations (type=solana) send ExecutionStepSolana objects under the same steps key. The type field accepts only evm or solana and defaults to evm when omitted - any other value is rejected with 400. Bridge-in requests execute steps on the destination chain after the 1click deposit succeeds. Out-operation requests execute steps on the origin chain and transfer the resulting tokens to the 1click deposit address. Solana supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token. Step objects accept only their documented fields - a key from the other step shape, a differently cased spelling of a field, the same key twice, or any field not listed is rejected with 400. Anything else a client needs to carry belongs in the step metadata object, which the backend passes through untouched. Step payloads nested more than 15 containers deep are also rejected with 400, counting the steps array itself as the first level - the metadata object is exempt. A step functionSignature may nest tuples or arrays at most 6 levels deep and may be at most 1024 bytes. An EVM steps array may hold at most 30 steps and a Solana one at most 50. Request bodies are limited to 256 KB. For Stellar origins the response includes quote.depositMemo and the deposit transfer must include that memo or the bridge will not settle.","parameters":[{"description":"Origin wallet identifier. Supports EVM addresses, NEAR accounts, NEAR implicit accounts, Solana base58 public keys, Stellar G-addresses, TON user-friendly addresses (TON requires body.publicKey), and Tron base58 (T...) addresses.","in":"path","name":"wallet","required":true,"schema":{"type":"string"}},{"description":"API key generated at https://studio.aurora.dev","in":"header","name":"x-api-key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.createExecutionRequestDoc"}}},"description":"Execution request. For type=solana, each step is an executionStepSolanaDoc under the same steps key.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.executionObjectResponse"}}},"description":"Dry-run execution quote."},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.executionObjectResponse"}}},"description":"Execution created and paired transaction prepared."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Missing or invalid api token"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Conflict"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Request body exceeds the configured size limit."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Bad Gateway"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"No Solana durable nonce account available (bridge-in / out-op). Retry shortly."}},"summary":"Create a quote-backed execution","tags":["Executions"]}}},"components":{"schemas":{"controllers.createExecutionRequestDoc":{"properties":{"addressLookupTables":{"description":"AddressLookupTables are base58 Address Lookup Table account addresses\n(Solana destinations only). When set, the backend compresses matching step\naccounts into lookup indices and emits a v0 transaction so many-account\nactions fit under the packet size limit. Additive and ignored for EVM.","items":{"type":"string"},"type":"array"},"dry":{"type":"boolean"},"metadata":{"additionalProperties":{},"type":"object"},"outOperation":{"type":"boolean"},"publicKey":{"description":"PublicKey is the origin wallet's ed25519 key (ed25519:). Required for\nTON (address can't yield the pubkey) and must be the wallet's owner key. Ignored otherwise.","type":"string"},"quote":{"$ref":"#/components/schemas/controllers.createExecutionQuoteDoc"},"steps":{"description":"Steps are ExecutionStepEVM objects for EVM destinations. For Solana\ndestinations (type=solana) each step is an executionStepSolanaDoc instead,\nsent under this same steps key.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"description":"Type selects the step shape. Must be evm or solana, defaults to evm when omitted, any other value is rejected with 400.","enum":["evm","solana"],"type":"string"},"version":{"type":"string"}},"type":"object"},"controllers.createExecutionQuoteDoc":{"properties":{"amount":{"type":"string"},"deadline":{"type":"string"},"destinationAsset":{"type":"string"},"originAsset":{"type":"string"},"recipient":{"type":"string"},"slippageTolerance":{"type":"integer"},"swapType":{"enum":["EXACT_INPUT","EXACT_OUTPUT"],"type":"string"}},"type":"object"},"controllers.executionStepEVMDoc":{"properties":{"functionSignature":{"type":"string"},"metadata":{"additionalProperties":{},"type":"object"},"parameters":{"items":{"type":"object"},"type":"array"},"to":{"type":"string"},"value":{"type":"string"}},"type":"object"},"controllers.executionObjectResponse":{"properties":{"result":{"$ref":"#/components/schemas/controllers.executionDoc"}},"type":"object"},"controllers.executionDoc":{"properties":{"createdAt":{"type":"string"},"details":{"$ref":"#/components/schemas/controllers.executionDetailsDoc"},"executionMode":{"enum":["quote_with_steps","steps_only"],"type":"string"},"id":{"type":"string"},"metadata":{"additionalProperties":{},"type":"object"},"quote":{"$ref":"#/components/schemas/controllers.executionQuoteDoc"},"status":{"enum":["CREATED","DEPOSIT_PENDING","DEPOSIT_PROCESSING","OPERATION_PENDING","OPERATION_PROCESSING","SUCCESS","DEPOSIT_FAILED","OPERATION_FAILED","EXPIRED"],"type":"string"},"steps":{"description":"Steps are ExecutionStepEVM objects for EVM executions. For Solana executions\n(type=solana) each item is an executionStepSolanaDoc instead, echoed under this\nsame steps key.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"enum":["evm","solana"],"type":"string"},"version":{"type":"string"}},"type":"object"},"controllers.executionDetailsDoc":{"properties":{"estimatedTime":{"type":"string"},"intermediaryAddress":{"type":"string"},"messageSigned":{"type":"boolean"},"messageToSign":{"type":"string"},"networkFee":{"type":"string"},"payload":{"$ref":"#/components/schemas/controllers.signingPayloadDoc"},"signingStandard":{"enum":["raw_ed25519","nep413","erc191","tip191","sep53","ton_connect"],"type":"string"}},"type":"object"},"controllers.signingPayloadDoc":{"properties":{"payload_bytes_base64":{"type":"string"},"payload_json":{"type":"string"},"standard":{"enum":["raw_ed25519","nep413","erc191","tip191","sep53","ton_connect"],"type":"string"}},"type":"object"},"controllers.executionQuoteDoc":{"properties":{"amount":{"type":"string"},"amountIn":{"type":"string"},"amountInUsd":{"type":"string"},"amountOut":{"type":"string"},"amountOutUsd":{"type":"string"},"deadline":{"type":"string"},"depositAddress":{"type":"string"},"depositMemo":{"type":"string"},"destinationAsset":{"type":"string"},"minAmountIn":{"type":"string"},"minAmountOut":{"type":"string"},"originAsset":{"type":"string"},"recipient":{"type":"string"},"swapType":{"enum":["EXACT_INPUT","EXACT_OUTPUT"],"type":"string"}},"type":"object"},"controllers.errorResponse":{"properties":{"error":{"type":"string"}},"type":"object"}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.intents.aurora.dev/api-reference/intents-connect-api-reference/request-an-execution.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.