Token Utilities
formatTokenAmount
formatTokenAmount(amount: bigint, decimals: number): string
Converts a raw token amount (e.g. 1250000000000000000000n) into a clean, formatted string like "1250.00" — perfect for UI display.
Works with any ERC20 token (USDT, USDC, etc.).
Parameters
amount: bigint– Raw token amount from contract (e.g. fromgetTokenBalance)decimals: number– Token decimals (e.g. 6 for USDT on Base Sepolia)
Returns
string – Formatted number with proper decimal places
import { createPalindromeSDK } from '@/lib/createSDK';
const { sdk } = await connectAndInitSDK();
const USDT = "0x337610d27c682E347C9cD60BD4b3b107C9d34dDd"; // Base Sepolia USDT
try {
const rawBalance = await sdk.getTokenBalance("0xbuyer...", USDT);
// Format with 6 decimals (standard for USDT on Base Sepolia)
const decimals = await sdk.getTokenDecimals(USDT);
const formatted = sdk.formatTokenAmount(rawBalance, decimals);
console.log("Buyer has:", formatted, "USDT");
// → "Buyer has: 1250.00 USDT"
} catch (error) {
console.error("Error:", error);
}
Real Examples
| Raw Amount | Decimals | Result |
|---|---|---|
1250000000000000000000n | 18 | "1250.00" |
999000000n | 6 | "999.00" |
5000000000000000000n | 18 | "5.00" |
1234567890123456789n | 18 | "1.234567890123456789" |
Best For
- Displaying balances in wallets
- Showing escrow amounts
- Order summaries
- Any user-facing number
No more guessing decimals — clean, readable token amounts every time!
See also → getTokenBalance() · getTokenDecimals()