coinsFund the wallet

A new wallet starts empty. Before it can submit transactions, it must hold the right asset on the right network, plus enough native gas to pay for the transaction.

For transfers and approvals, always check funding before you submit requests. All transactions are constructed, signed, and broadcast locally - WLFI is not involved in any transfer of funds.

The examples below use the default BSC + USD1 configuration from the overview. The same logic applies on any EVM chain - only the chain, token address, and gas asset change.

Check the balances

Always verify two balances: the asset you want to transfer and the chain's native gas token. A wallet with enough USD1 will still fail if it has no BNB for gas.

Check native gas first:

agentpay rpc balance --address <ADDRESS> --rpc-url <RPC_URL> --json

Then check the ERC-20 balance when needed:

agentpay rpc balance \
  --address <ADDRESS> \
  --token <TOKEN_ADDRESS> \
  --rpc-url <RPC_URL> \
  --json

For the default BSC + USD1 path:

agentpay rpc balance \
  --address <ADDRESS> \
  --rpc-url https://bsc.drpc.org \
  --json

agentpay rpc balance \
  --address <ADDRESS> \
  --token 0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d \
  --rpc-url https://bsc.drpc.org \
  --json

If the wallet is short, stop and fund it before attempting the transfer.

What a funding request should include

A useful funding request should include:

  • wallet address

  • network name

  • chain ID

  • asset needed for value, if relevant

  • asset needed for gas

  • a funding QR or funding URI if you want a mobile-friendly top-up path

The skill pack includes a helper script at scripts/prepare-funding-request.mjs that generates structured funding instructions with a QR code. Agent hosts with the skill pack installed can invoke it automatically when they detect a funding gap.

In a host-driven flow, a request can be as simple as:

Example

This is the point where a host should stop cleanly instead of retrying a doomed transfer.

Funding instructions shown in Codex for a BSC wallet
When the wallet is short on gas or token balance, the correct next step is to show funding instructions, not to keep attempting the transfer.

Once funding is in place, continue to Policy, then Transfers. If some requests should pause for human review, add Manual approval between those two steps.

Last updated