feat(wallet-cli): add the mm wallet send command

[sirtimid]

Explanation

Adds the user-facing mm wallet send command that sends a transaction end-to-end through the daemon-hosted TransactionController, closing #9513. This is the CLI surface on top of the daemon's transaction capability (#9512 / #9612): it collects transaction parameters, dispatches them to the daemon, waits for the broadcast, and reports the resulting transaction hash.

Dedicated sendTransaction RPC handler

TransactionController:addTransaction returns a Result shaped like { transactionMeta, result }, where result is a Promise<hash> that resolves once the transaction is signed and broadcast. That promise is not JSON-serializable, so it cannot travel back over the daemon's generic call dispatch. The daemon therefore exposes a dedicated sendTransaction handler (src/daemon/send-transaction.ts) that, server-side:

1. resolves the network client — from networkClientId, or from chainId via NetworkController:findNetworkClientIdByChainId;
2. resolves the sender — the provided --from, or the selected account;
3. calls addTransaction(txParams, { networkClientId, origin: 'metamask', isInternal: true }) (internal, so it skips origin/permitted-account validation and is auto-approved by the headless daemon);
4. awaits the broadcast and re-reads the live record so the returned status reflects the post-broadcast state (submitted), not the unapproved creation snapshot;
5. returns a serializable { transactionHash, transactionId, status }.

Params are validated with superstruct at the daemon boundary (exactly one of networkClientId / chainId; 0x address and hex quantities).

The mm wallet send command

A thin client over that handler (src/commands/wallet/send.ts):

• --to (required), --value (ether — converted to wei via @metamask/utils' shared toWei), --data, --from, --network-client-id / --chain-id, gas overrides (--gas / --max-fee-per-gas / --max-priority-fee-per-gas / --gas-price), --timeout.
• Because the daemon auto-approves, the CLI is the confirmation boundary: it previews the resolved plan and prompts for confirmation before broadcasting. --yes skips the prompt; --dry-run resolves + validates without broadcasting.

Testing

• Unit tests for the handler (network/sender resolution, internal submit, dry-run, broadcast + live status, param validation) and the command (arg parsing, preview/confirm/abort, --yes, --dry-run, error surfaces); 100% coverage maintained.
• Real-chain e2e (tests/wallet-send.e2e.test.ts): boots a local anvil node, adds it as a custom network, and drives the built mm CLI to sign, broadcast, and mine a real transaction (asserts receipt status: 0x1 and a recipient balance increase). It is skip-if-absent; CI installs anvil for it only when packages/wallet-cli/ changed. See packages/wallet-cli/tests/README.md.
• build, package test, test:e2e, yarn lint, changelog:validate pass.

References

• Closes wallet-cli: add the mm send-transaction command #9513
• Builds on wallet-cli: make the daemon transaction-capable — consume GasFeeController + headless auto-approval #9512 / feat!: wire NetworkEnablementController to ConfigRegistryController #9611 (daemon transaction-capable) and feat(wallet-cli): wire the TransactionController slot in the daemon wallet #9509 (the TransactionController slot); the mutating-RPC safety prerequisite wallet-cli: make sendCommand retry idempotency-safe before mutating RPC ships #9511 landed in fix(wallet-cli): retry sendCommand only on ECONNREFUSED #9608.
• packages/wallet-cli/src/daemon/send-transaction.ts, src/commands/wallet/send.ts, tests/wallet-send.e2e.test.ts.

Note

Stacked on sirtimid/wallet-cli-daemon-transaction-capable (#9612); this PR is based on that branch so the diff is scoped. Once #9612 merges, this will be rebased onto main and retargeted.

Checklist

• Tests cover the handler and command (unit) plus a real-chain broadcast (e2e); 100% coverage maintained.
• build, test, test:e2e, yarn lint:fix, yarn lint, changelog:validate pass.
• Confirmation prompt (--yes to skip) and --dry-run gate a real, irreversible send.

🤖 Generated with Claude Code