Query Wallet Balances

Query ETH and ERC-20 token balances for Para wallets across different networks.

Prerequisites

You need Web3 libraries configured with Para authentication.

Ethers.js
Viem
Wagmi

Query ETH Balance

import { ethers } from "ethers";
import { ParaEthersSigner } from "@getpara/ethers-v6-integration";

async function getETHBalance(signer: ParaEthersSigner, provider: ethers.Provider) {
  const address = await signer.getAddress();
  const balance = await provider.getBalance(address);

  const formattedBalance = ethers.formatEther(balance);
  console.log(`ETH Balance: ${formattedBalance} ETH`);

  return {
    wei: balance.toString(),
    ether: formattedBalance
  };
}

Query ERC-20 Token Balance

import { ethers } from "ethers";

const ERC20_ABI = [
  "function balanceOf(address owner) view returns (uint256)",
  "function decimals() view returns (uint8)",
  "function symbol() view returns (string)"
];

async function getTokenBalance(
  signer: any,
  tokenAddress: string,
  provider: ethers.Provider
) {
  const contract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
  const address = await signer.getAddress();

  const [balance, decimals, symbol] = await Promise.all([
    contract.balanceOf(address),
    contract.decimals(),
    contract.symbol()
  ]);

  const formattedBalance = ethers.formatUnits(balance, decimals);
  console.log(`${symbol} Balance: ${formattedBalance}`);

  return {
    raw: balance.toString(),
    formatted: formattedBalance,
    symbol,
    decimals
  };
}

Query ETH Balance

import { formatEther } from "viem";
import { useParaViemAccount } from "@getpara/react-sdk";

function useETHBalance(publicClient: any) {
  const { viemAccount } = useParaViemAccount();

  const getETHBalance = async () => {
    if (!viemAccount) return;
    const balance = await publicClient.getBalance({
      address: viemAccount.address
    });

    const formattedBalance = formatEther(balance);
    console.log(`ETH Balance: ${formattedBalance} ETH`);

    return {
      wei: balance.toString(),
      ether: formattedBalance
    };
  };

  return { getETHBalance };
}

Query ERC-20 Token Balance

import { formatUnits } from "viem";

const ERC20_ABI = [
  {
    name: "balanceOf",
    type: "function",
    stateMutability: "view",
    inputs: [{ name: "owner", type: "address" }],
    outputs: [{ type: "uint256" }]
  },
  {
    name: "decimals",
    type: "function",
    stateMutability: "view",
    inputs: [],
    outputs: [{ type: "uint8" }]
  },
  {
    name: "symbol",
    type: "function",
    stateMutability: "view",
    inputs: [],
    outputs: [{ type: "string" }]
  }
] as const;

async function getTokenBalance(
  publicClient: any,
  account: any,
  tokenAddress: `0x${string}`
) {
  const [balance, decimals, symbol] = await Promise.all([
    publicClient.readContract({
      address: tokenAddress,
      abi: ERC20_ABI,
      functionName: "balanceOf",
      args: [account.address]
    }),
    publicClient.readContract({
      address: tokenAddress,
      abi: ERC20_ABI,
      functionName: "decimals"
    }),
    publicClient.readContract({
      address: tokenAddress,
      abi: ERC20_ABI,
      functionName: "symbol"
    })
  ]);

  const formattedBalance = formatUnits(balance, decimals);
  console.log(`${symbol} Balance: ${formattedBalance}`);

  return {
    raw: balance.toString(),
    formatted: formattedBalance,
    symbol,
    decimals
  };
}

Query ETH Balance

import { useBalance, useAccount } from "@getpara/react-sdk/wagmi";

function ETHBalance() {
  const { address } = useAccount();
  const { data, isError, isLoading } = useBalance({
    address: address
  });

  if (isLoading) return <div>Loading balance...</div>;
  if (isError) return <div>Error fetching balance</div>;

  return (
    <div>
      <p>ETH Balance: {data?.formatted} {data?.symbol}</p>
      <p>Wei: {data?.value.toString()}</p>
    </div>
  );
}

Query ERC-20 Token Balance

import { useAccount, useReadContracts } from "@getpara/react-sdk/wagmi";

const ERC20_ABI = [
  {
    name: "balanceOf",
    type: "function",
    stateMutability: "view",
    inputs: [{ name: "owner", type: "address" }],
    outputs: [{ type: "uint256" }]
  },
  {
    name: "decimals",
    type: "function",
    stateMutability: "view",
    inputs: [],
    outputs: [{ type: "uint8" }]
  },
  {
    name: "symbol",
    type: "function",
    stateMutability: "view",
    inputs: [],
    outputs: [{ type: "string" }]
  }
] as const;

function TokenBalance({ tokenAddress }: { tokenAddress: `0x${string}` }) {
  const { address } = useAccount();

  const { data, isLoading } = useReadContracts({
    contracts: [
      {
        address: tokenAddress,
        abi: ERC20_ABI,
        functionName: "balanceOf",
        args: [address!]
      },
      {
        address: tokenAddress,
        abi: ERC20_ABI,
        functionName: "decimals"
      },
      {
        address: tokenAddress,
        abi: ERC20_ABI,
        functionName: "symbol"
      }
    ]
  });

  if (isLoading) return <div>Loading token balance...</div>;

  const balance = data?.[0]?.result;
  const decimals = data?.[1]?.result;
  const symbol = data?.[2]?.result;

  if (!balance || !decimals) return <div>No balance data</div>;

  const formatted = (Number(balance) / 10 ** decimals).toFixed(4);

  return (
    <div>
      <p>{symbol} Balance: {formatted}</p>
    </div>
  );
}

​Prerequisites

​Query ETH Balance

​Query ERC-20 Token Balance

​Query ETH Balance

​Query ERC-20 Token Balance

​Query ETH Balance

​Query ERC-20 Token Balance

​Next Steps

Prerequisites

Query ETH Balance

Query ERC-20 Token Balance

Query ETH Balance

Query ERC-20 Token Balance

Query ETH Balance

Query ERC-20 Token Balance

Next Steps