CLI: ERC-20 wallet commands — approve, allowance, token, transfers, watch (stacked on #35)

[kylecrawshaw]

Stacked on #35 (CLI on the SDK's ERC-20 actions), itself on #24 and #23. Review only the last commit.

What

Five new wallet commands, thin wrappers over the erc20Actions that #35 wires onto the CLI's clients. Each takes SBC (the default) or any token address as its last argument; symbol and decimals are read on-chain for a bare address.

• wallet approve <spender> <amount> [token]: ERC-20 approve, max for an unlimited approval, --gas-limit and --no-wait as for wallet send. Output {hash, receipt?}.
• wallet allowance <spender> [token] [--owner]: owner defaults to the local account.
• wallet token [token]: name, symbol, decimals, total supply.
• wallet transfers [token]: decoded Transfer events over a block range through getTransfers. Last 10 000 blocks by default, or --blocks <n>, --from-block <n>, --to-block <n>. One line per transfer; --json wraps the rows with the token and block range.
• wallet watch [token]: the same streamed through watchTransfers until Ctrl-C, --poll <ms> for the polling interval. With --json, one JSON object per line; the status line goes to stderr so stdout pipes cleanly.

transfers and watch default to transfers sent or received by the local account: two log filters, merged, deduped and ordered by block then log index, since a self-transfer matches both sides. --from / --to pick one side, --address another account, --all every transfer of the token. lib/erc20.ts gains describeToken, transferFilters, sortTransfers, toTransferRow and listTransfers so that logic is testable apart from commander.

Tests

Five tests added in tests/erc20.test.ts: max amounts, describeToken, side-filter expansion, dedupe/ordering, row formatting, and listTransfers against fake eth_getLogs responses that check both filters carry the block range. CLI total 36 passing, pnpm build clean. Not run against a live node.

ENG-2276

🤖 Generated with Claude Code

[github-actions]

🦋 Changeset detected

Latest commit: 597f349

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
radius-cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR