Executing a Swap

This guide performs a fixed(variable)-output(input) swap on Fuji, exchanging AUSD → CTK.

Ensuring the wallet is whitelisted

Before spending gas, verify your address holds the APPROVED_SWAPPER role. If it does not, the swap will revert later.

To check whether the wallet is whitelisted, we’ll call hasRole on the contract with the role identifier (APPROVED_SWAPPER ) and the wallet address.

1
async function isWhiteListed(
2
  pair: `0x${string}`,
3
  callerAddress: `0x${string}`,
4
) {
5
  return await client.readContract({
6
    address: pair,
7
    abi: stableSwapAbi,
8
    functionName: "hasRole",
9
    args: ["APPROVED_SWAPPER", callerAddress],
10
  });
11
}

Fetch token decimals

In order to calculate the swap amounts correctly, you need to know the decimal precision of both tokens in the pair. The AgoraStableSwapPair contract exposes the decimals for both tokens through getter functions:

1
async function getTokenDecimals(
2
  client: PublicActions,
3
  pairAddress: `0x${string}`,
4
) {
5
  const [decimalsToken0, decimalsToken1] = await Promise.all([
6
    client.readContract({
7
      address: pairAddress,
8
      abi: stableSwapAbi,
9
      functionName: "token0Decimals",
10
      args: [],
11
    }),
12
    client.readContract({
13
      address: pairAddress,
14
      abi: stableSwapAbi,
15
      functionName: "token1Decimals",
16
      args: [],
17
    }),
18
  ]);
19
20
  return { decimalsToken0, decimalsToken1 };
21
}

Define swapPath

swapPath tells the pair which direction you’re swapping.

For an Agora pair (which always contains exactly two tokens) it must be:

• [token0, token1] – swap token0 → token1
• [token1, token0] – swap token1 → token0

Because you funded your wallet with AUSD earlier (see Get testnet ERC-20 tokens), we’ll swap AUSD for CTK:

1
// token0 = AUSD, token1 = CTK on Fuji
2
const swapPath = [TOKEN0, TOKEN1] as const; // AUSD → CTK
3
4
// Need the opposite direction?  Use:
5
// const swapPath = [TOKEN1, TOKEN0] as const; // CTK → AUSD

Once we have verified that the wallet is whitelisted we can proceed to swap. For swapping there are two high-level functions that abstract some of the low-level logic.