Check Balances

This guide explains how to check native token balances, ERC-20 token balances, multiple token balances, paymaster token balances, and read-only account balances.

Native Token Balance

You can retrieve the native token balance (e.g., ETH) using account.getBalance():

Get Native Balance

const balance = await account.getBalance()
console.log('Native balance:', balance, 'wei')

ERC-20 Token Balance

You can check the balance of a specific ERC-20 token using account.getTokenBalance():

Get ERC-20 Balance

const tokenBalance = await account.getTokenBalance('0xdAC17F958D2ee523a2206206994597C13D831ec7') // USDT
console.log('USDT balance:', tokenBalance)

Multiple Token Balances

You can check balances for multiple ERC-20 tokens in a single call using account.getTokenBalances():

Get Multiple Token Balances

const tokenBalances = await account.getTokenBalances([
  '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT
  '0x68749665FF8D2d112Fa859AA293F07A622782F38'  // XAUT
])
console.log('Multi-token balances:', tokenBalances)

Paymaster Token Balance

You can check the paymaster token balance used for paying gas fees using account.getPaymasterTokenBalance():

Get Paymaster Token Balance

const paymasterBalance = await account.getPaymasterTokenBalance()
console.log('Paymaster token balance:', paymasterBalance)

The paymaster token balance determines how many gasless transactions you can execute. Ensure the paymaster has sufficient token balance before initiating gasless operations.

Read-Only Account Balances

You can check balances for any smart account address without a seed phrase using WalletAccountReadOnlyEvmErc4337:

Read-Only Balance

import { WalletAccountReadOnlyEvmErc4337 } from '@tetherto/wdk-wallet-evm-erc-4337'

const readOnlyAccount = new WalletAccountReadOnlyEvmErc4337('0x...', {
  chainId: 1,
  provider: 'https://rpc.mevblocker.io/fast',
  bundlerUrl: 'https://api.candide.dev/public/v3/ethereum',
  paymasterUrl: 'https://api.candide.dev/public/v3/ethereum',
  paymasterAddress: '0x8b1f6cb5d062aa2ce8d581942bbb960420d875ba',
  entryPointAddress: '0x0000000071727De22E5E9d8BAf0edAc6f37da032',
  safeModulesVersion: '0.3.0',
  paymasterToken: {
    address: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
  }
})

const balance = await readOnlyAccount.getBalance()
console.log('Read-only account balance:', balance, 'wei')

Next Steps

With balance checks in place, learn how to send gasless transactions.