> 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, on every destination family. A Sui bridge-in is built and signed once at create like every other flow, so it returns a populated \`details.messageToSign\` and needs no follow-up round trip.\
> \
> \*\*Flows\*\*\
> \- \*\*Bridge-in\*\* executes steps on the destination chain after the 1click deposit succeeds.\
> \- \*\*Out-operation\*\* executes steps on the origin chain and transfers the resulting tokens to the 1click deposit address.\
> \
> \*\*Step shape and \`type\`\*\*\
> \- The action chain selects the step shape, always under the same \`steps\` key: EVM sends \`ExecutionStepEVM\` objects, Solana (\`type=solana\`) sends \`ExecutionStepSolana\` objects and Sui (\`type=sui\`) sends \`ExecutionStepSui\` objects.\
> \- \`type\` accepts only \`evm\`, \`solana\` or \`sui\` and defaults to \`evm\` when omitted. Any other value is rejected with 400.\
> \- An explicitly set \`type\` must agree with the chain the steps run on (the destination chain for a bridge-in, the origin chain for an out-operation), otherwise the request is rejected with 400.\
> \
> \*\*Solana\*\*\
> \- Supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token.\
> \
> \*\*Sui\*\*\
> \- Supports bridge-in and out-operation, sponsored from the backend's own SUI address balance, with the commission taken on chain out of the action coin.\
> \- A step is command-oriented rather than call-oriented. One step is one programmable-transaction command (\`moveCall\`, \`splitCoins\`, \`mergeCoins\`, \`transferObjects\` or \`makeMoveVec\`) whose arguments carry their values inline, so a client never names an input index and the backend owns the input list.\
> \- Steps name the coin an action spends with the \`{ACTION\_COIN}\` sentinel in an argument \`objectId\`, which the backend resolves to the intermediary's coin object or to a withdrawal against its accumulator balance.\
> \
> \*\*Validation\*\* (each violation is rejected with 400 unless noted)\
> \- Step objects accept only their documented fields. A key from another step shape, a differently cased spelling of a field, the same key twice, or any field not listed is rejected. Anything else a client needs to carry belongs in the step \`metadata\` object, which the backend passes through untouched.\
> \- Step payloads may nest at most 15 containers deep, counting the \`steps\` array itself as the first level. The \`metadata\` object is exempt.\
> \- A \`functionSignature\` may nest tuples or arrays at most 6 levels deep and may be at most 1024 bytes.\
> \- A \`steps\` array may hold at most 30 EVM steps, 50 Solana steps or 50 Sui steps.\
> \- Request bodies are limited to 256 KB (413 when exceeded).\
> \
> \*\*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, on every destination family. A Sui bridge-in is built and signed once at create like every other flow, so it returns a populated `details.messageToSign` and needs no follow-up round trip.\n\n**Flows**\n- **Bridge-in** executes steps on the destination chain after the 1click deposit succeeds.\n- **Out-operation** executes steps on the origin chain and transfers the resulting tokens to the 1click deposit address.\n\n**Step shape and `type`**\n- The action chain selects the step shape, always under the same `steps` key: EVM sends `ExecutionStepEVM` objects, Solana (`type=solana`) sends `ExecutionStepSolana` objects and Sui (`type=sui`) sends `ExecutionStepSui` objects.\n- `type` accepts only `evm`, `solana` or `sui` and defaults to `evm` when omitted. Any other value is rejected with 400.\n- An explicitly set `type` must agree with the chain the steps run on (the destination chain for a bridge-in, the origin chain for an out-operation), otherwise the request is rejected with 400.\n\n**Solana**\n- Supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token.\n\n**Sui**\n- Supports bridge-in and out-operation, sponsored from the backend's own SUI address balance, with the commission taken on chain out of the action coin.\n- A step is command-oriented rather than call-oriented. One step is one programmable-transaction command (`moveCall`, `splitCoins`, `mergeCoins`, `transferObjects` or `makeMoveVec`) whose arguments carry their values inline, so a client never names an input index and the backend owns the input list.\n- Steps name the coin an action spends with the `{ACTION_COIN}` sentinel in an argument `objectId`, which the backend resolves to the intermediary's coin object or to a withdrawal against its accumulator balance.\n\n**Validation** (each violation is rejected with 400 unless noted)\n- Step objects accept only their documented fields. A key from another step shape, a differently cased spelling of a field, the same key twice, or any field not listed is rejected. Anything else a client needs to carry belongs in the step `metadata` object, which the backend passes through untouched.\n- Step payloads may nest at most 15 containers deep, counting the `steps` array itself as the first level. The `metadata` object is exempt.\n- A `functionSignature` may nest tuples or arrays at most 6 levels deep and may be at most 1024 bytes.\n- A `steps` array may hold at most 30 EVM steps, 50 Solana steps or 50 Sui steps.\n- Request bodies are limited to 256 KB (413 when exceeded).\n\n**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 and for type=sui an executionStepSuiDoc, 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, or Sui bridge-in is halted. 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,\nrejected with 400 on a Sui action chain.","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:<base58>). 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,\nand for Sui (type=sui) an executionStepSuiDoc, sent under this same steps\nkey.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"description":"Type selects the step shape. Must be evm, solana or sui, defaults to evm when omitted, any other value is rejected with 400.","enum":["evm","solana","sui"],"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":{"description":"FunctionSignature is the Solidity signature the backend ABI-encodes parameters against, with\ntuples written in parentheses, e.g. supply(address,uint256,address,uint16). Empty or \"native\"\nmakes a plain value transfer with no calldata and empty parameters.","type":"string"},"metadata":{"additionalProperties":{},"type":"object"},"parameters":{"description":"Parameters are the call arguments in signature order as JSON values. Integers are decimal\nstrings, 0x-hex strings or JSON integers, addresses and bytes are 0x-hex strings, bools are\nJSON bools, and tuples and arrays are JSON arrays. A string equal to a placeholder is substituted\nat request time - {MIN_AMOUNT_OUT} (bridge-in only) with the post-fee minimum destination\namount, {AMOUNT_IN} (out-operation with EXACT_OUTPUT only) with the origin amount the step must\nproduce, and {DEPOSIT_ADDRESS} (out-operation only) with the 1click deposit address the step\ntransfers to.","items":{},"type":"array"},"to":{"description":"To is the call target, a 0x-prefixed 40-hex-char address, or {DEPOSIT_ADDRESS} for a native\ntransfer to the deposit address on an out-operation. Steps run in order as calls from the intermediary.","type":"string"},"value":{"description":"Value is the native amount in wei sent with the call, as a decimal string. The amount\nplaceholders from parameters apply here too.","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 echoes the request steps, in the shape the execution's type selects - an executionStepEVMDoc for\nEVM, an executionStepSolanaDoc for Solana (type=solana) and an executionStepSuiDoc for Sui (type=sui), all\nunder this same steps key.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"enum":["evm","solana","sui"],"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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.intents.aurora.dev/api-reference/intents-connect-api-reference/request-an-execution.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
