Partial implementation of CLI funds commands

[mkysel]

This is getting pretty large so I decided to split off the initial PR.

• add both app/settlement chain RPC urls to the CLI
• implement balances
• refactor a few things
• generate bindings for ERC20 and FeeToken
• Deposit flow is implemented but it fails. It will be the next step after this.

[graphite-app]

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• Queue - adds this PR to the back of the merge queue
• Hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

[macroscopeapp]

Add partial CLI funds commands and dual RPC resolution by introducing cmd/xmtpd-cli/commands/funds.go with deposit, balances, hidden mint, and new RPC resolvers supporting --settlement-rpc-url and --app-rpc-url in root.go

This change adds a new funds command group with deposit, balances, and a hidden mint, introduces helpers to construct a dual-chain funds admin, and replaces single RPC URL usage with settlement/app-specific resolvers while updating configs and bindings to int64 chain IDs. Key changes include:

• Add funds CLI with deposit execution, balances query, and hidden mint; withdraw and check-withdrawals are stubs in funds.go.
• Introduce blockchain.IFundsAdmin and blockchain.NewFundsAdmin with Deposit, Balances, and MintMockUSDC, plus ERC20 and FeeToken bindings in funds_admin.go and generated bindings ERC20.go, FeeToken.go.
• Add RPC resolvers resolveSettlementRPCURL and resolveAppRPCURL, deprecate --rpc-url, and wire funds root command in root.go.
• Add setup helpers for admins/fetchers in admin_setup.go and refactor rate registry commands in rate_registry.go.
• Remove settlement hidden underlying mint command in settlement.go.
• Switch chain ID types to int64 across blockchain, config, and indexer code (e.g., signer.go, options.go, validation.go, app_chain.go, settlement_chain.go).
• Extend config to include FeeToken and UnderlyingFeeToken and update test utilities in blockchain.go, options.go, validation.go, and config.go.

📍Where to Start

Start with the CLI entry points and RPC resolution in root.go, then review funds command wiring and handlers in funds.go, followed by the construction and methods of blockchain.NewFundsAdmin in funds_admin.go.

---

Macroscope summarized 7c830cd.

[macroscopeapp]

Invalid or non-hex address inputs cause the handler to silently query the zero address balances instead of reporting an input error.

The balancesHandler calls common.HexToAddress(opts.Address) without validating the string, and HexToAddress maps invalid hex strings to the zero address without an error.

Consider checking the address with common.IsHexAddress and returning an error if it's invalid before calling HexToAddress.

+    if !common.IsHexAddress(opts.Address) {
+        return fmt.Errorf("invalid address: %s", opts.Address)
+    }

🚀 Reply to ask Macroscope to explain or update this suggestion.

👍 Helpful? React to give us feedback.