Quotes and execution

An intent runs in three steps: quote the route, deposit the origin funds to the intent address, then execute. For authentication and client setup, see the API overview.

import { TrailsApi, TradeType } from "@0xtrails/api";
import { encodeFunctionData, erc20Abi } from "viem";

const intents = new TrailsApi(process.env.OMS_PUBLISHABLE_KEY!);

// 1. Quote: 100 USDC on Arbitrum to USDC on Polygon
const { intent } = await intents.quoteIntent({
  ownerAddress: senderAddress,
  originChainId: 42161,
  originTokenAddress: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  originTokenAmount: 100_000_000n,
  destinationChainId: 137,
  destinationTokenAddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
  destinationToAddress: recipientAddress,
  tradeType: TradeType.EXACT_INPUT,
  options: { slippageTolerance: 0.005 },
});

// 2. Deposit to the intent address on the origin chain
const { tokenAddress, toAddress, amount } = intent.depositTransaction;
const depositTransactionHash = await walletClient.sendTransaction({
  to: tokenAddress,
  data: encodeFunctionData({ abi: erc20Abi, functionName: "transfer", args: [toAddress, amount] }),
});
await publicClient.waitForTransactionReceipt({ hash: depositTransactionHash });

// 3. Execute
await intents.executeIntent({ intentId: intent.intentId, depositTransactionHash });

const { intentReceipt } = await intents.waitIntentReceipt({ intentId: intent.intentId });

QuoteIntent

Returns a route, fees, and the deposit the owner must make. Endpoint: POST /QuoteIntent

Request

Field	Type	Required	Description
`ownerAddress`	string	Yes	Address that deposits on the origin chain and receives a refund when one is produced.
`originChainId`	number	Yes	Origin chain ID.
`originTokenAddress`	string	Yes	Origin token address.
`destinationChainId`	number	Yes	Destination chain ID.
`destinationTokenAddress`	string	Yes	Destination token address.
`destinationToAddress`	string	No	Recipient or contract on the destination chain. Defaults to `ownerAddress`.
`tradeType`	string	No	`EXACT_INPUT` or `EXACT_OUTPUT`. Defaults to `EXACT_OUTPUT`.
`originTokenAmount`	bigint	With `EXACT_INPUT`	Amount the owner sends, in the smallest unit.
`destinationTokenAmount`	bigint	With `EXACT_OUTPUT`	Amount the recipient receives, in the smallest unit.
`destinationCallData`	string	No	ABI-encoded call to run on `destinationToAddress` when funds arrive. See contract calls on arrival.
`destinationApproveAddress`	string	No	Contract to approve for the destination token before `destinationCallData` runs.
`destinationCallValue`	bigint	No	Native value sent with the destination call, in wei.
`options.slippageTolerance`	number	No	Maximum slippage as a fraction, for example `0.005` for 0.5%.
`options.preference`	string	No	`RECOMMENDED` (default), `FASTEST`, `CHEAPEST`, or `TRUSTLESS`.

Response

Field	Description
`intent`	The quoted intent. Pass it back unchanged where an operation asks for it.
`intent.intentId`	ID used by every later operation.
`intent.depositTransaction`	`tokenAddress`, `toAddress` (the intent address), and `amount` the owner must deposit.
`intent.fees`	Origin gas, destination gas, liquidity, and protocol fees.
`intent.expiresAt`	When the quote expires, 15 minutes after issue.
`gasFeeOptions`	Tokens the owner can use to pay gas when executing with a signature.

ExecuteIntent

Starts the route after the owner deposits. Call it within the quote’s 15-minute window. Endpoint: POST /ExecuteIntent

Request

Field	Type	Required	Description
`intentId`	string	Yes	ID from `QuoteIntent`.
`depositTransactionHash`	string	One of	Hash of the confirmed deposit to the intent address.
`depositSignature`	object	One of	Signed intent and token permit, for owners paying gas in a token from `gasFeeOptions` instead of the native token.

Send depositTransactionHash for a standard transfer. Send depositSignature instead when the owner signs a permit and never sends an onchain transaction; it contains intentSignature, permitSignature, permitDeadline, permitAmount, selectedGasFeeOption, userNonce, and deadline.

Response

Field	Description
`intentId`	The intent ID.
`intentStatus`	Usually `EXECUTING`.

For Tron and Solana origins, use ExecuteIntentEdge instead.

AbortIntent

Records that the owner aborted an intent onchain so its status becomes ABORTED. Submit and confirm the abort transaction first. Endpoint: POST /AbortIntent

Field	Type	Required	Description
`intentId`	string	Yes	The intent to abort.
`chainId`	number	Yes	Chain where the abort transaction was sent.
`abortTransactionHash`	string	Yes	Hash of the confirmed abort transaction.

const { status } = await intents.abortIntent({ intentId, chainId: 42161, abortTransactionHash });

Tron and Solana

Tron and Solana connect to the EVM route through a handoff on an EVM network. In ORIGIN mode, the payer sends from Tron or Solana and the intent continues on EVM. In DESTINATION mode, the intent ends with a transfer to a Tron or Solana address. Call GetEdges for the networks and modes currently enabled.

GetEdges

Returns the non-EVM networks and the modes each supports. Endpoint: POST /GetEdges

{ "edges": [{ "rail": "TRON", "modes": ["ORIGIN", "DESTINATION"] }] }

QuoteIntentEdge

Quotes an intent with a Tron or Solana side. Endpoint: POST /QuoteIntentEdge

Field	Type	Required	Description
`intent`	object	Yes	A `QuoteIntent` request. In `ORIGIN` mode, leave the origin unset: `originChainId` is `0`, and the edge sets the origin at quote time.
`edge.rail`	string	Yes	`TRON` or `SOLANA`.
`edge.mode`	string	Yes	`ORIGIN` or `DESTINATION`.
`edge.tradeType`	string	No	`EXACT_OUTPUT` (default) funds the exact handoff amount the intent needs. `EXACT_INPUT` spends `originTokenAmount` and sizes the intent from the result.
`edge.originChainId`	number	`ORIGIN`	Chain ID of the Tron or Solana network.
`edge.originAddress`	string	`ORIGIN`	The payer’s Tron or Solana address.
`edge.originTokenAddress`	string	`ORIGIN`	Token the payer sends, such as USDT on Tron.
`edge.originTokenAmount`	bigint	No	Amount to spend with `EXACT_INPUT`.
`edge.refundAddress`	string	No	Tron or Solana address for refunds.
`edge.destinationChainId`	number	`DESTINATION`	Chain ID of the Tron or Solana network.
`edge.destinationAddress`	string	`DESTINATION`	The recipient’s Tron or Solana address.
`edge.destinationTokenAddress`	string	`DESTINATION`	Token the recipient receives.

The response contains edgeId, the intent, and an edge object with the handoff (chainId, tokenAddress, amount, recipientAddress) and providerQuote, which holds the transactions the payer signs on Tron or Solana in ORIGIN mode.

ExecuteIntentEdge

Arms an ORIGIN mode intent so OMS watches for the handoff and completes the route when funds arrive. Call it before the payer sends on Tron or Solana. No deposit hash is needed. Calling it again for the same intent succeeds. Endpoint: POST /ExecuteIntentEdge

Field	Type	Required	Description
`intentId`	string	Yes	ID from `QuoteIntentEdge`.

GetEdgeStatus

Returns the state of the Tron or Solana side. Endpoint: POST /GetEdgeStatus

Field	Type	Required	Description
`edgeId`	string	Yes	ID from `QuoteIntentEdge`.

The response includes status and, as each step happens, initTransactionHash with initChainId, fillTransactionHash with fillChainId, and, if funds are returned, refundTransactionHash with refundChainId. Always read a hash with its paired chain ID: the deposit runs on Tron or Solana in ORIGIN mode but on the EVM handoff chain in DESTINATION mode.

Overview

Guides

SDK

API reference

QuoteIntent

Request

Response

ExecuteIntent

Request

Response

AbortIntent

Tron and Solana

GetEdges

QuoteIntentEdge

ExecuteIntentEdge

GetEdgeStatus