Raw token amount
Token decimals (default: 18)
Decimals to show in formatted output (default: 4)
Formatted token amount as string
Generic token formatter that handles any ERC20-style token with configurable decimal places. Most tokens use 18 decimals like ETH, but some use different values (e.g., USDC uses 6).
// 18 decimal token (like ETH)
formatToken(1000000000000000000n) // Returns: "1.0000"
formatToken(1500000000000000000n, 18, 2) // Returns: "1.50"
// 6 decimal token (like USDC)
formatToken(1000000n, 6) // Returns: "1.0000"
formatToken(1500000n, 6, 2) // Returns: "1.50"
// Whole numbers
formatToken(5000000000000000000n) // Returns: "5"
formatToken(5123456789000000000n, 18, 6) // Returns: "5.123456"
Format a token amount based on its decimals