wallet-cli bai

Check B.AI credits and usage, and recharge a B.AI account with stablecoins.

Synopsis

wallet-cli bai COMMAND

Subcommands

Command	Page	Description
bai usage-summary	usage-summary.md	Credit balance, current-month spend, and monthly trend
bai usage-records	usage-records.md	Individual usage records
bai recharge-orders	recharge-orders.md	Recharge orders
bai recharge	recharge.md	Recharge your own or another B.AI account
bai report-recharge	report-recharge.md	Report an existing recharge transaction again, without paying

The API key

Every command needs your personal B.AI API key. Store it once with config, which reads the key from stdin — here from the $BAI_KEY environment variable:

printf '%s\n' "$BAI_KEY" | wallet-cli config baiApiKey --api-key-stdin

Storing the key only saves it locally: it needs no network, account or master password, and B.AI is not contacted, so a wrong key is not caught until a bai command uses it (bai_auth_failed).

Without a stored key every bai command stops with bai_credentials_missing (exit 2).

How recharging works

1. Optionally, bai recharge --dry-run previews the recharge: it runs the same checks (except the master password), reports whether the paying address still has to be bound (bindingRequired), and shows what would be paid, without binding, creating an order or signing.
2. bai recharge checks the amount, network, token, recipient and master password, and asks B.AI whether the paying address is bound to your B.AI account. If it is not, the CLI signs B.AI's binding message with that account and binds it. Any failure stops it with no order and no payment. It then creates an order, pays it with an x402 payment from your account, and reports the transaction to B.AI.
3. B.AI confirms and adds the credits: creditStatus: "credited".
4. If B.AI cannot confirm in time, the command still succeeds with creditStatus: "unconfirmed" and the transaction hash. The payment went through — do not recharge again. Run bai report-recharge with that hash instead.

See also

x402 · config · x402 and B.AI payment details

---