Wallet balances and gas estimates

Before building or signing a transaction, agents need to know whether an address has enough funds and what the operation will cost. Syenite exposes wallet.balances and gas.estimate so you can check native and token balances across chains and get current gas cost estimates for common operations.

wallet.balances

Returns native gas token and common stablecoin balances for any EVM address on Ethereum, Arbitrum, Base, and BNB Chain.

Parameters:

Response includes per chain: native balance (symbol and raw), token balances (e.g. USDC, USDT, DAI), and optional USD totals. Use it to confirm an address has sufficient gas and stablecoins before calling swap.quote or submitting a registration tx.

gas.estimate

Returns current gas prices and estimated costs for common operations on the same four chains.

Parameters:

Response includes gas price (gwei, wei) and per-operation cost in native token and approximate USD. Use it to choose the cheapest chain for a given operation or to ensure the wallet has enough native token.

Demo: before you swap or register

1. Call wallet.balances with the sender address. Check native balance on the chain you will use. 2. Call gas.estimate with operations: ["swap"] or ["contract_register"] to see cost. 3. If the address is short on gas, use swap.quote to bridge gas from another chain or top up before proceeding. 4. Run your swap or registration; the agent or user signs the tx.

Example prompts

"Check wallet 0x... balances on Base and Ethereum." "What is the gas cost for a swap on Arbitrum vs Base?" "Estimate gas for contract_register on all chains." The agent calls wallet.balances and gas.estimate with the right parameters and summarizes.

Related

ERC-8004 agent registration (uses contract_register gas). Cross-chain swap and bridge. Batch swaps. Tool list.