Cross-chain swaps let you convert tokens across different blockchain networks in a single transaction. They’re built natively into Smart Wallets and you can integrate in minutes.

Cross-chain swaps work just like any other Smart Wallet transaction, so you can sponsor gas to do gasless swaps, or pay for gas in an ERC-20 token.

The Cross-chain Swap flow

Flow

1. Request a cross-chain swap quote
2. Sign the prepared swap calls
3. Send prepared calls
4. Wait for cross-chain confirmation

Swap options

When requesting a cross-chain swap quote, you can specify either a fromAmount , or a minimumToAmount.

1
// Mode 1: Swap exact input amount
2
{
3
  fromAmount: "0x2710";
4
} // Swap exactly 0.01 USDC (10000 in hex, 6 decimals)
5
6
// Mode 2: Get minimum output amount
7
{
8
  minimumToAmount: "0x5AF3107A4000";
9
} // Get at least 0.0001 ETH (18 decimals). The amount you need to spend is calculated to get at least your desired ETH amount.

Prerequisites

Before you begin, ensure you have:

• An Alchemy API Key
• If you’re sponsoring gas, then a Gas Manager policy
• A small amount of tokens for testing (~$1 worth is enough!)
  • Important: You’ll need to send these tokens to your smart wallet address to be able to swap!
• A signer to own the account and sign messages

1
import { swapActions } from "@account-kit/wallet-client/experimental";
2
import { client } from "./client";
3
4
const account = await client.requestAccount();
5
6
// Add the swap actions to the client
7
const swapClient = client.extend(swapActions);
8
9
// Request the cross-chain swap quote
10
// Note: toChainId specifies the destination chain for the swap
11
const { quote, callId, ...calls } = await swapClient.requestQuoteV0({
12
  from: account.address,
13
  toChainId: "0x...", // Destination chain ID
14
  fromToken: "0x...",
15
  toToken: "0x...",
16
  minimumToAmount: "0x...",
17
});
18
19
// Display the swap quote, including the minimum amount to receive and the expiry
20
console.log(quote);
21
console.log(`Cross-chain swap callId: ${callId}`);
22
23
// Assert that the calls are not raw calls.
24
// This will always be the case when requestQuoteV0 is used without the `returnRawCalls` option,
25
// the assertion is just needed for Typescript to recognize the result type.
26
if (calls.rawCalls) {
27
  throw new Error("Expected user operation calls");
28
}
29
30
// Sign the quote, getting back prepared and signed calls
31
// The callId is automatically included in the signed calls
32
const signedCalls = await swapClient.signPreparedCalls(calls);
33
34
// Send the prepared calls
35
// The callId is passed through automatically
36
const { preparedCallIds } = await swapClient.sendPreparedCalls(signedCalls);
37
38
// Wait for the call to resolve
39
// Cross-chain swaps may take longer due to cross-chain messaging
40
const callStatusResult = await swapClient.waitForCallsStatus({
41
  id: preparedCallIds[0]!,
42
});
43
44
// Filter through success or failure cases
45
// Cross-chain swaps have additional status codes:
46
// - 120: Cross-Chain In Progress
47
// - 410: Cross-chain Refund
48
if (
49
  callStatusResult.status !== "success" ||
50
  !callStatusResult.receipts ||
51
  !callStatusResult.receipts[0]
52
) {
53
  throw new Error(
54
    `Cross-chain swap failed with status ${callStatusResult.status}, full receipt:\n ${JSON.stringify(callStatusResult, null, 2)}`,
55
  );
56
}
57
58
console.log("Cross-chain swap confirmed!");
59
console.log(
60
  `Transaction hash: ${callStatusResult.receipts[0].transactionHash}`,
61
);

FAQs

What chains are supported for cross-chain swaps?

Chains supported (for now) are: Arbitrum, Arbitrum Nova, Base, Berachain, Boba Network, BSC/BNB, Celo, Ethereum, Hyperliquid, Ink, Optimism, Plasma, Polygon, Shape, Soneium, Story, Unichain, World Chain, and Zora mainnets.

Can I batch additional calls after a cross-chain swap?

No, postCalls are not supported for cross-chain swaps (for now). You can only perform the swap itself across chains.

How long do cross-chain swaps take?

Cross-chain swaps typically take longer than single-chain swaps due to the need for cross-chain messaging and confirmation. The exact time depends on the source and destination chains involved in the swap.

How do you encode values?

Values are simply passed as hexadecimal strings. The Swap API doesn’t add complexity to consider decimals, so 0x01 is always the smallest amount of a given asset. 1 ETH, or DAI (18 decimals) is 0xDE0B6B3A7640000 1 USDC (6 decimals) is 0xF4240 This removes any ambiguity— if it’s numerical, it’s a hex.

What is the expiry?

The expiry is an informational indicator of when you can expect to be able to process the swap request. If you’re at/near the expiry, it might be a good time to request a new quote.

What are the different status codes for cross-chain swaps?

Cross-chain swaps may have additional status codes beyond standard transaction statuses to reflect the cross-chain nature of the transaction. These are:

• 120: Cross-chain in progress
• 410: Cross-chain refund

When is a CallId returned from wallet_requestQuote_v0?

Any time you’re requesting a cross-chain quote via wallet_requestQuote_v0 , a callId is returned. This callId includes important data for cross-chain tracking. You can use this just like any other callId in wallet_getCallsStatus!