Skip to content

fix(swap-docs): correct amount types to bigint + viem helpers for v5 SDK #1332

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jakehobbs merged 2 commits into from
May 26, 2026
+11 −7
Merged

fix(swap-docs): correct amount types to bigint + viem helpers for v5 SDK #1332

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6ab4722
fix(swap-docs): correct amount types to bigint + viem helpers for v5 SDK
jakehobbs May 26, 2026
63dc1bb
fix(swap-docs): use parseUnits consistently; decimals depend on toToken
jakehobbs May 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion content/wallets/pages/transactions/swap-tokens/client.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ You need the following environment variables:

<CodeBlocks>
```ts title="requestQuote.ts"
import { parseUnits } from "viem";
import { swapActions } from "@alchemy/wallet-apis/experimental";
import { client } from "./client";

Expand All @@ -16,7 +17,7 @@ You need the following environment variables:
const { quote, ...calls } = await swapClient.requestQuoteV0({
fromToken: "0x...",
toToken: "0x...",
minimumToAmount: "0x...",
minimumToAmount: parseUnits("1", 6), // decimals must match toToken (e.g. 6 for USDC, 18 for ETH)
});

// Display the swap quote, including the minimum amount to receive and the expiry
Expand Down
15 changes: 9 additions & 6 deletions content/wallets/pages/transactions/swap-tokens/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,15 +31,17 @@ Swaps work like any other Smart Wallet transaction, so you can sponsor gas for g
When requesting a swap quote, specify either an amount in, or a minimum amount out.

```tsx
import { parseUnits } from "viem";

// Mode 1: Swap exact input amount
{
fromAmount: "0x2710";
} // Swap exactly 0.01 USDC (10000 in hex, 6 decimals)
fromAmount: parseUnits("0.01", 6);
} // Swap exactly 0.01 USDC (6 decimals)

// Mode 2: Get minimum output amount
{
minimumToAmount: "0x5AF3107A4000";
} // Get at least 0.0001 ETH (18 decimals). We calculate how much USDC you need to spend to get at least your desired ETH amount.
minimumToAmount: parseUnits("1", 6);
} // Get at least 1 USDC. Decimals must match toToken (e.g. 6 for USDC, 18 for ETH). We calculate how much you need to spend to receive at least your desired amount.
```

## Prerequisites
Expand Down Expand Up @@ -76,10 +78,11 @@ Currently, the Swap API supports only single-chain swaps. Cross-chain swaps are

## How do you encode values?

Values are passed as hexadecimal strings. The Swap API does not add complexity to consider decimals, so 0x01 is always the smallest amount of a given asset.
**JavaScript SDK**: amounts are passed as `bigint` values. For example, 1 ETH is `1_000_000_000_000_000_000n` and 1 USDC is `1_000_000n`.

**Raw API**: values are passed as hexadecimal strings. The Swap API does not 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?

Expand Down
Loading