@metamask-previews/wallet-cli 0.0.0-preview-2dc3d26a4 → 0.0.0-preview-aa202ec10

package/CHANGELOG.md

@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add the `mm wallet send` command and a dedicated daemon `sendTransaction` RPC handler for sending a transaction through the daemon-hosted `TransactionController` ([#9636](https://github.com/MetaMask/core/pull/9636))
+  - The command converts the ether `--value` to wei, resolves the network client (`--network-client-id` or `--chain-id`) and sender (defaulting to the selected account), previews the resolved plan, and broadcasts after confirmation, printing the resulting transaction hash. `--yes` skips the prompt; `--dry-run` resolves and validates without broadcasting.
+  - The `sendTransaction` handler awaits the broadcast server-side and returns a serializable `{ transactionHash, transactionId, status }`, because `addTransaction`'s `result` promise cannot travel back over the generic `call` dispatch. Transactions are submitted as internal (auto-approved by the daemon).
 - Auto-accept pending approval requests in the daemon so a transaction or signature flow resolves instead of hanging on the headless no-op `showApprovalRequest`; the subscription is torn down on `dispose` ([#9612](https://github.com/MetaMask/core/pull/9612))
   - **Security note:** the daemon approves every request without a per-request prompt; the trust boundary is its `0600`, same-user Unix socket.
 - Wire the `transactionController` slot in the daemon wallet's instance options, so the daemon runs the `TransactionController` with an explicit CLI-appropriate configuration (swaps processing disabled, no client hooks) rather than relying on the controller's implicit defaults ([#9509](https://github.com/MetaMask/core/pull/9509))

package/README.md

@@ -32,6 +32,16 @@ mm wallet unlock --password <pw>   # or: MM_WALLET_PASSWORD=<pw> mm wallet unloc
 mm wallet unlock                   # prompts interactively (input masked)
 ```
 
+Send a transaction. `--value` is in ether; select the network with `--network-client-id` or `--chain-id`; the sender defaults to the selected account. The command previews the resolved plan and asks for confirmation before broadcasting, then prints the transaction hash:
+
+```sh
+mm wallet send --to 0xRecipient --value 0.01 --chain-id 0x1
+mm wallet send --to 0xRecipient --value 0.01 --network-client-id mainnet --yes   # skip the prompt
+mm wallet send --to 0xContract --data 0xabcdef --value 0 --chain-id 0x1 --dry-run # resolve + validate only
+```
+
+Because the daemon auto-approves (see the security note below), the confirmation prompt — or your explicit `--yes` — is the only boundary before funds move; use `--dry-run` first if unsure. Gas is estimated automatically unless overridden with `--gas` / `--max-fee-per-gas` / `--max-priority-fee-per-gas` / `--gas-price` (each a `0x`-prefixed hex quantity).
+
 Discover what the running wallet can do — `list` prints every messenger action currently dispatchable via `call`. This surface grows as more controllers are wired, so treat it as evolving rather than a stability contract:
 
 ```sh
@@ -57,7 +67,7 @@ mm daemon purge           # stop, then delete all daemon state files (--force to
 
 State (socket, PID file, log, and the SQLite database) lives in the per-user oclif data directory; override it with `MM_DATA_DIR`.
 
-> **Security model — the daemon auto-approves everything.** Because it is headless, the daemon accepts every approval request (transactions and signatures included) with no per-request prompt; otherwise an awaited request would hang forever with no UI to resolve it. The trust boundary is therefore the daemon's `0600`, same-user Unix socket — anything that can reach the socket can move funds. A scoped/opt-in approval policy is planned for when a user-facing send command lands.
+> **Security model — the daemon auto-approves everything.** Because it is headless, the daemon accepts every approval request (transactions and signatures included) with no per-request prompt; otherwise an awaited request would hang forever with no UI to resolve it. The trust boundary is therefore the daemon's `0600`, same-user Unix socket — anything that can reach the socket can move funds. For `mm wallet send` the confirmation prompt (or `--yes`) is the only per-transaction gate; the daemon itself still applies no per-request policy.
 
 ## Troubleshooting
 

package/dist/commands/wallet/send.cjs

@@ -0,0 +1,332 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _WalletSend_instances, _WalletSend_dispatchSend;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEtherToWeiHex = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+const utils_1 = require("@metamask/utils");
+const core_1 = require("@oclif/core");
+const daemon_client_js_1 = require("../../daemon/daemon-client.cjs");
+const paths_js_1 = require("../../daemon/paths.cjs");
+const prompts_js_1 = require("../../daemon/prompts.cjs");
+const send_transaction_js_1 = require("../../daemon/send-transaction.cjs");
+const utils_js_1 = require("../../daemon/utils.cjs");
+const ETHER_DECIMALS = 18;
+/**
+ * Fallback response timeout (ms) for the broadcast call. Broadcasting waits for
+ * signing and `eth_sendRawTransaction` server-side, which can far outlast the
+ * 30s default used for cheap RPCs; too short a timeout would make a slow but
+ * successful send look like a failure and tempt a duplicate re-send.
+ * `--timeout` overrides it.
+ */
+const BROADCAST_TIMEOUT_MS = 120000;
+/**
+ * Convert a decimal ether amount to a `0x`-prefixed wei quantity.
+ *
+ * The fixed-point conversion is delegated to `@metamask/utils`' `toWei` rather
+ * than re-deriving the wei math here. The daemon's `sendTransaction` boundary
+ * expects canonical hex wei; this is where the human-friendly `--value` (ether)
+ * is turned into it.
+ *
+ * `toWei` silently accepts negatives and throws opaque messages on other
+ * malformed input, so the value is guarded up front for a clear error and a
+ * strictly non-negative amount.
+ *
+ * @param amount - A non-negative decimal ether amount (e.g. `"0.1"`, `"1"`).
+ * @returns The equivalent wei as a `0x`-prefixed hex string.
+ * @throws If `amount` is not a non-negative decimal or has more than 18
+ * fractional digits.
+ */
+function parseEtherToWeiHex(amount) {
+    const trimmed = amount.trim();
+    if (!/^\d+(?:\.\d+)?$/u.test(trimmed)) {
+        throw new Error(`Invalid value "${amount}": expected a non-negative decimal amount of ether (e.g. 0.1).`);
+    }
+    if ((trimmed.split('.')[1] ?? '').length > ETHER_DECIMALS) {
+        throw new Error(`Invalid value "${amount}": ether has at most ${ETHER_DECIMALS} decimal places.`);
+    }
+    return (0, utils_1.bigIntToHex)((0, utils_1.toWei)(trimmed, 'ether'));
+}
+exports.parseEtherToWeiHex = parseEtherToWeiHex;
+class WalletSend extends core_1.Command {
+    constructor() {
+        super(...arguments);
+        _WalletSend_instances.add(this);
+    }
+    async run() {
+        const { flags } = await this.parse(WalletSend);
+        const networkClientId = (0, utils_js_1.emptyToUndefined)(flags['network-client-id']);
+        const chainId = (0, utils_js_1.emptyToUndefined)(flags['chain-id']);
+        if ((networkClientId === undefined) === (chainId === undefined)) {
+            this.error('Provide exactly one of --network-client-id or --chain-id.');
+        }
+        let value;
+        try {
+            value = parseEtherToWeiHex(flags.value);
+        }
+        catch (error) {
+            // `parseEtherToWeiHex` only ever throws `Error`.
+            this.error(error.message);
+        }
+        // Everything except the network selector. The selector is added per call:
+        // a confirmed broadcast pins the `networkClientId` the preview resolved
+        // rather than re-sending `--chain-id` and re-resolving it.
+        const baseParams = {
+            to: flags.to,
+            value,
+            ...(flags.from ? { from: flags.from } : {}),
+            ...(flags.data ? { data: flags.data } : {}),
+            ...(flags.gas ? { gas: flags.gas } : {}),
+            ...(flags['max-fee-per-gas']
+                ? { maxFeePerGas: flags['max-fee-per-gas'] }
+                : {}),
+            ...(flags['max-priority-fee-per-gas']
+                ? { maxPriorityFeePerGas: flags['max-priority-fee-per-gas'] }
+                : {}),
+            ...(flags['gas-price'] ? { gasPrice: flags['gas-price'] } : {}),
+        };
+        // Exactly one selector is defined (guarded above); guard each spread by its
+        // own `undefined` check so the object never carries an `undefined` value.
+        const params = {
+            ...baseParams,
+            ...(networkClientId === undefined ? {} : { networkClientId }),
+            ...(chainId === undefined ? {} : { chainId }),
+        };
+        const planExtras = {
+            data: flags.data,
+            gas: flags.gas,
+            maxFeePerGas: flags['max-fee-per-gas'],
+            maxPriorityFeePerGas: flags['max-priority-fee-per-gas'],
+            gasPrice: flags['gas-price'],
+        };
+        const { socketPath } = (0, paths_js_1.getDaemonPaths)(this.config.dataDir);
+        const timeoutMs = flags.timeout;
+        // A `dryRun` resolves the sender and network client server-side without
+        // broadcasting. `--dry-run` stops after previewing; an interactive run
+        // previews first so the confirmation shows (and then pins) the resolved
+        // sender/network; `--yes` skips straight to the broadcast.
+        if (flags['dry-run']) {
+            const preview = await __classPrivateFieldGet(this, _WalletSend_instances, "m", _WalletSend_dispatchSend).call(this, {
+                socketPath,
+                params: { ...params, dryRun: true },
+                timeoutMs,
+                struct: send_transaction_js_1.SendTransactionDryRunResultStruct,
+                broadcast: false,
+            });
+            this.log(formatPlan(preview, flags.value, planExtras));
+            return;
+        }
+        let resolved;
+        if (!flags.yes) {
+            const preview = await __classPrivateFieldGet(this, _WalletSend_instances, "m", _WalletSend_dispatchSend).call(this, {
+                socketPath,
+                params: { ...params, dryRun: true },
+                timeoutMs,
+                struct: send_transaction_js_1.SendTransactionDryRunResultStruct,
+                broadcast: false,
+            });
+            let confirmed;
+            try {
+                confirmed = await (0, prompts_js_1.confirmSend)(formatPlan(preview, flags.value, planExtras));
+            }
+            catch (error) {
+                // Ctrl+C at the prompt (@inquirer/core's ExitPromptError) is a clean
+                // abort, not a failure; anything else should surface.
+                if (error instanceof Error && error.name === 'ExitPromptError') {
+                    this.log('Aborted.');
+                    return;
+                }
+                throw error;
+            }
+            if (!confirmed) {
+                this.log('Aborted.');
+                return;
+            }
+            resolved = preview;
+        }
+        // Broadcast the exact sender/network the user reviewed (when they confirmed
+        // a preview), so what is signed matches what was shown. `--yes` skips the
+        // preview, so there it re-resolves server-side from `params`.
+        const broadcastParams = resolved
+            ? {
+                ...baseParams,
+                from: resolved.from,
+                networkClientId: resolved.networkClientId,
+            }
+            : params;
+        const result = await __classPrivateFieldGet(this, _WalletSend_instances, "m", _WalletSend_dispatchSend).call(this, {
+            socketPath,
+            params: broadcastParams,
+            timeoutMs: timeoutMs ?? BROADCAST_TIMEOUT_MS,
+            struct: send_transaction_js_1.SendTransactionBroadcastResultStruct,
+            broadcast: true,
+        });
+        this.log('Transaction broadcast.');
+        this.log(`Hash:   ${result.transactionHash}`);
+        this.log(`Id:     ${result.transactionId}`);
+        this.log(`Status: ${result.status}`);
+    }
+}
+_WalletSend_instances = new WeakSet(), _WalletSend_dispatchSend = 
+/**
+ * Send a `sendTransaction` RPC to the daemon and return its validated result,
+ * translating connection errors, broadcast timeouts, JSON-RPC failures, and
+ * unexpected payloads into command errors.
+ *
+ * @param options - Dispatch options.
+ * @param options.socketPath - The daemon Unix socket path.
+ * @param options.params - The `sendTransaction` params (with or without
+ * `dryRun`).
+ * @param options.timeoutMs - Optional response timeout in milliseconds.
+ * @param options.struct - Struct the `result` payload must satisfy; the
+ * return type is inferred from it.
+ * @param options.broadcast - Whether this is the real (fund-moving) broadcast.
+ * When true, a read timeout is reported with guidance that the send may
+ * already be in flight, so the user does not blindly re-send.
+ * @returns The validated `result` payload.
+ */
+async function _WalletSend_dispatchSend(options) {
+    const { socketPath, params, timeoutMs, struct, broadcast } = options;
+    let response;
+    try {
+        response = await (0, daemon_client_js_1.sendCommand)({
+            socketPath,
+            method: 'sendTransaction',
+            params,
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+        });
+    }
+    catch (error) {
+        if (broadcast && isReadTimeout(error)) {
+            this.error(broadcastTimeoutMessage());
+        }
+        this.error((0, utils_js_1.makeDaemonConnectionError)(error));
+    }
+    if ((0, utils_1.isJsonRpcFailure)(response)) {
+        this.error((0, utils_js_1.formatJsonRpcError)(response.error));
+    }
+    const { result } = response;
+    if (!(0, superstruct_1.is)(result, struct)) {
+        this.error(`The daemon returned an unexpected ${broadcast ? 'send' : 'dry-run'} ` +
+            'result. It may be running an incompatible version.');
+    }
+    return result;
+};
+WalletSend.description = 'Send a transaction through the daemon-hosted TransactionController. ' +
+    'Estimates gas automatically unless overridden, signs, broadcasts, and ' +
+    'prints the resulting transaction hash. The daemon auto-approves, so the ' +
+    'confirmation boundary is this command.';
+WalletSend.examples = [
+    '<%= config.bin %> wallet send --to 0xRecipient --value 0.01 --chain-id 0x1',
+    '<%= config.bin %> wallet send --to 0xRecipient --value 0.01 --network-client-id mainnet --yes',
+    '<%= config.bin %> wallet send --to 0xContract --data 0xabcdef --value 0 --chain-id 0x1 --dry-run',
+];
+WalletSend.flags = {
+    to: core_1.Flags.string({
+        description: 'Recipient address (0x-prefixed)',
+        required: true,
+    }),
+    value: core_1.Flags.string({
+        description: 'Amount to send, in ether (e.g. 0.01). Defaults to 0.',
+        default: '0',
+    }),
+    from: core_1.Flags.string({
+        description: 'Sender address (0x-prefixed). Defaults to the selected account.',
+    }),
+    data: core_1.Flags.string({
+        description: 'Calldata as a 0x-prefixed hex string (for contract calls)',
+    }),
+    'network-client-id': core_1.Flags.string({
+        description: 'Network client to send on. Provide this or --chain-id, not both.',
+    }),
+    'chain-id': core_1.Flags.string({
+        description: 'Chain ID (0x-prefixed hex) to resolve to a network client. Provide this or --network-client-id, not both.',
+    }),
+    gas: core_1.Flags.string({
+        description: 'Gas limit override, as a 0x-prefixed hex quantity',
+    }),
+    'max-fee-per-gas': core_1.Flags.string({
+        description: 'maxFeePerGas override, as a 0x-prefixed hex wei quantity',
+    }),
+    'max-priority-fee-per-gas': core_1.Flags.string({
+        description: 'maxPriorityFeePerGas override, as a 0x-prefixed hex wei quantity',
+    }),
+    'gas-price': core_1.Flags.string({
+        description: 'Legacy gasPrice override, as a 0x-prefixed hex wei quantity',
+    }),
+    'dry-run': core_1.Flags.boolean({
+        description: 'Resolve the network client and sender and validate params, but do not broadcast.',
+    }),
+    yes: core_1.Flags.boolean({
+        char: 'y',
+        description: 'Skip the confirmation prompt and broadcast immediately.',
+    }),
+    timeout: core_1.Flags.integer({
+        char: 't',
+        description: 'Response timeout in milliseconds',
+    }),
+};
+exports.default = WalletSend;
+/**
+ * Whether an error is the daemon-client socket read timeout. It carries no
+ * errno code, so its message is the only signal.
+ *
+ * @param error - The caught value.
+ * @returns True if it is the read timeout.
+ */
+function isReadTimeout(error) {
+    return error instanceof Error && error.message === 'Socket read timed out';
+}
+/**
+ * The message shown when the broadcast call times out. A send is not
+ * idempotent, and the daemon may still be broadcasting after the client gives
+ * up waiting, so this warns against a blind re-run rather than reading as a
+ * plain connection failure.
+ *
+ * @returns The user-facing guidance.
+ */
+function broadcastTimeoutMessage() {
+    return ('The daemon did not respond in time, but your transaction may still be ' +
+        'broadcasting. Do NOT re-run this command — you could send it twice. ' +
+        'Check `mm daemon status`, the daemon log, or your account on-chain to ' +
+        'confirm, then use --timeout to wait longer if needed.');
+}
+/**
+ * Format a dry-run plan for display (and as the confirmation prompt body).
+ *
+ * @param plan - The dry-run result returned by the daemon.
+ * @param etherAmount - The original `--value` (ether), shown alongside the
+ * resolved wei so the user sees the human amount they typed.
+ * @param extras - The `--data` / gas overrides the daemon does not echo back,
+ * shown so the user confirms exactly what will be sent.
+ * @returns A multi-line summary of the transaction to be sent.
+ */
+function formatPlan(plan, etherAmount, extras) {
+    const lines = [
+        'About to send:',
+        `  To:      ${plan.to}`,
+        `  From:    ${plan.from}`,
+        `  Value:   ${etherAmount} ETH (${plan.value} wei)`,
+        `  Network: ${plan.networkClientId}`,
+    ];
+    if (extras.data) {
+        lines.push(`  Data:    ${extras.data}`);
+    }
+    const gasParts = [
+        extras.gas ? `gas=${extras.gas}` : undefined,
+        extras.maxFeePerGas ? `maxFeePerGas=${extras.maxFeePerGas}` : undefined,
+        extras.maxPriorityFeePerGas
+            ? `maxPriorityFeePerGas=${extras.maxPriorityFeePerGas}`
+            : undefined,
+        extras.gasPrice ? `gasPrice=${extras.gasPrice}` : undefined,
+    ].filter((part) => part !== undefined);
+    if (gasParts.length > 0) {
+        lines.push(`  Gas:     ${gasParts.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=send.cjs.map

package/dist/commands/wallet/send.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.cjs","sourceRoot":"","sources":["../../../src/commands/wallet/send.ts"],"names":[],"mappings":"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","sourcesContent":["import { is } from '@metamask/superstruct';\nimport type { Struct } from '@metamask/superstruct';\nimport { bigIntToHex, isJsonRpcFailure, toWei } from '@metamask/utils';\nimport type { Hex, Json, JsonRpcParams } from '@metamask/utils';\nimport { Command, Flags } from '@oclif/core';\n\nimport { sendCommand } from '../../daemon/daemon-client.js';\nimport { getDaemonPaths } from '../../daemon/paths.js';\nimport { confirmSend } from '../../daemon/prompts.js';\nimport {\n  SendTransactionBroadcastResultStruct,\n  SendTransactionDryRunResultStruct,\n} from '../../daemon/send-transaction.js';\nimport type { SendTransactionDryRunResult } from '../../daemon/send-transaction.js';\nimport {\n  emptyToUndefined,\n  formatJsonRpcError,\n  makeDaemonConnectionError,\n} from '../../daemon/utils.js';\n\nconst ETHER_DECIMALS = 18;\n\n/**\n * Fallback response timeout (ms) for the broadcast call. Broadcasting waits for\n * signing and `eth_sendRawTransaction` server-side, which can far outlast the\n * 30s default used for cheap RPCs; too short a timeout would make a slow but\n * successful send look like a failure and tempt a duplicate re-send.\n * `--timeout` overrides it.\n */\nconst BROADCAST_TIMEOUT_MS = 120_000;\n\n/**\n * The transaction fields shown in the confirmation preview that the daemon\n * does not echo back (they are the raw `--data` / gas overrides the user\n * passed, so the CLI supplies them for display).\n */\ntype PlanExtras = {\n  data?: string | undefined;\n  gas?: string | undefined;\n  maxFeePerGas?: string | undefined;\n  maxPriorityFeePerGas?: string | undefined;\n  gasPrice?: string | undefined;\n};\n\n/**\n * Convert a decimal ether amount to a `0x`-prefixed wei quantity.\n *\n * The fixed-point conversion is delegated to `@metamask/utils`' `toWei` rather\n * than re-deriving the wei math here. The daemon's `sendTransaction` boundary\n * expects canonical hex wei; this is where the human-friendly `--value` (ether)\n * is turned into it.\n *\n * `toWei` silently accepts negatives and throws opaque messages on other\n * malformed input, so the value is guarded up front for a clear error and a\n * strictly non-negative amount.\n *\n * @param amount - A non-negative decimal ether amount (e.g. `\"0.1\"`, `\"1\"`).\n * @returns The equivalent wei as a `0x`-prefixed hex string.\n * @throws If `amount` is not a non-negative decimal or has more than 18\n * fractional digits.\n */\nexport function parseEtherToWeiHex(amount: string): Hex {\n  const trimmed = amount.trim();\n  if (!/^\\d+(?:\\.\\d+)?$/u.test(trimmed)) {\n    throw new Error(\n      `Invalid value \"${amount}\": expected a non-negative decimal amount of ether (e.g. 0.1).`,\n    );\n  }\n\n  if ((trimmed.split('.')[1] ?? '').length > ETHER_DECIMALS) {\n    throw new Error(\n      `Invalid value \"${amount}\": ether has at most ${ETHER_DECIMALS} decimal places.`,\n    );\n  }\n\n  return bigIntToHex(toWei(trimmed, 'ether'));\n}\n\nexport default class WalletSend extends Command {\n  static override description =\n    'Send a transaction through the daemon-hosted TransactionController. ' +\n    'Estimates gas automatically unless overridden, signs, broadcasts, and ' +\n    'prints the resulting transaction hash. The daemon auto-approves, so the ' +\n    'confirmation boundary is this command.';\n\n  static override examples = [\n    '<%= config.bin %> wallet send --to 0xRecipient --value 0.01 --chain-id 0x1',\n    '<%= config.bin %> wallet send --to 0xRecipient --value 0.01 --network-client-id mainnet --yes',\n    '<%= config.bin %> wallet send --to 0xContract --data 0xabcdef --value 0 --chain-id 0x1 --dry-run',\n  ];\n\n  static override flags = {\n    to: Flags.string({\n      description: 'Recipient address (0x-prefixed)',\n      required: true,\n    }),\n    value: Flags.string({\n      description: 'Amount to send, in ether (e.g. 0.01). Defaults to 0.',\n      default: '0',\n    }),\n    from: Flags.string({\n      description:\n        'Sender address (0x-prefixed). Defaults to the selected account.',\n    }),\n    data: Flags.string({\n      description: 'Calldata as a 0x-prefixed hex string (for contract calls)',\n    }),\n    'network-client-id': Flags.string({\n      description:\n        'Network client to send on. Provide this or --chain-id, not both.',\n    }),\n    'chain-id': Flags.string({\n      description:\n        'Chain ID (0x-prefixed hex) to resolve to a network client. Provide this or --network-client-id, not both.',\n    }),\n    gas: Flags.string({\n      description: 'Gas limit override, as a 0x-prefixed hex quantity',\n    }),\n    'max-fee-per-gas': Flags.string({\n      description: 'maxFeePerGas override, as a 0x-prefixed hex wei quantity',\n    }),\n    'max-priority-fee-per-gas': Flags.string({\n      description:\n        'maxPriorityFeePerGas override, as a 0x-prefixed hex wei quantity',\n    }),\n    'gas-price': Flags.string({\n      description:\n        'Legacy gasPrice override, as a 0x-prefixed hex wei quantity',\n    }),\n    'dry-run': Flags.boolean({\n      description:\n        'Resolve the network client and sender and validate params, but do not broadcast.',\n    }),\n    yes: Flags.boolean({\n      char: 'y',\n      description: 'Skip the confirmation prompt and broadcast immediately.',\n    }),\n    timeout: Flags.integer({\n      char: 't',\n      description: 'Response timeout in milliseconds',\n    }),\n  };\n\n  public async run(): Promise<void> {\n    const { flags } = await this.parse(WalletSend);\n\n    const networkClientId = emptyToUndefined(flags['network-client-id']);\n    const chainId = emptyToUndefined(flags['chain-id']);\n    if ((networkClientId === undefined) === (chainId === undefined)) {\n      this.error('Provide exactly one of --network-client-id or --chain-id.');\n    }\n\n    let value: string;\n    try {\n      value = parseEtherToWeiHex(flags.value);\n    } catch (error) {\n      // `parseEtherToWeiHex` only ever throws `Error`.\n      this.error((error as Error).message);\n    }\n\n    // Everything except the network selector. The selector is added per call:\n    // a confirmed broadcast pins the `networkClientId` the preview resolved\n    // rather than re-sending `--chain-id` and re-resolving it.\n    const baseParams: Record<string, Json> = {\n      to: flags.to,\n      value,\n      ...(flags.from ? { from: flags.from } : {}),\n      ...(flags.data ? { data: flags.data } : {}),\n      ...(flags.gas ? { gas: flags.gas } : {}),\n      ...(flags['max-fee-per-gas']\n        ? { maxFeePerGas: flags['max-fee-per-gas'] }\n        : {}),\n      ...(flags['max-priority-fee-per-gas']\n        ? { maxPriorityFeePerGas: flags['max-priority-fee-per-gas'] }\n        : {}),\n      ...(flags['gas-price'] ? { gasPrice: flags['gas-price'] } : {}),\n    };\n    // Exactly one selector is defined (guarded above); guard each spread by its\n    // own `undefined` check so the object never carries an `undefined` value.\n    const params: Record<string, Json> = {\n      ...baseParams,\n      ...(networkClientId === undefined ? {} : { networkClientId }),\n      ...(chainId === undefined ? {} : { chainId }),\n    };\n    const planExtras: PlanExtras = {\n      data: flags.data,\n      gas: flags.gas,\n      maxFeePerGas: flags['max-fee-per-gas'],\n      maxPriorityFeePerGas: flags['max-priority-fee-per-gas'],\n      gasPrice: flags['gas-price'],\n    };\n\n    const { socketPath } = getDaemonPaths(this.config.dataDir);\n    const timeoutMs = flags.timeout;\n\n    // A `dryRun` resolves the sender and network client server-side without\n    // broadcasting. `--dry-run` stops after previewing; an interactive run\n    // previews first so the confirmation shows (and then pins) the resolved\n    // sender/network; `--yes` skips straight to the broadcast.\n    if (flags['dry-run']) {\n      const preview = await this.#dispatchSend({\n        socketPath,\n        params: { ...params, dryRun: true },\n        timeoutMs,\n        struct: SendTransactionDryRunResultStruct,\n        broadcast: false,\n      });\n      this.log(formatPlan(preview, flags.value, planExtras));\n      return;\n    }\n\n    let resolved: SendTransactionDryRunResult | undefined;\n    if (!flags.yes) {\n      const preview = await this.#dispatchSend({\n        socketPath,\n        params: { ...params, dryRun: true },\n        timeoutMs,\n        struct: SendTransactionDryRunResultStruct,\n        broadcast: false,\n      });\n\n      let confirmed: boolean;\n      try {\n        confirmed = await confirmSend(\n          formatPlan(preview, flags.value, planExtras),\n        );\n      } catch (error) {\n        // Ctrl+C at the prompt (@inquirer/core's ExitPromptError) is a clean\n        // abort, not a failure; anything else should surface.\n        if (error instanceof Error && error.name === 'ExitPromptError') {\n          this.log('Aborted.');\n          return;\n        }\n        throw error;\n      }\n      if (!confirmed) {\n        this.log('Aborted.');\n        return;\n      }\n      resolved = preview;\n    }\n\n    // Broadcast the exact sender/network the user reviewed (when they confirmed\n    // a preview), so what is signed matches what was shown. `--yes` skips the\n    // preview, so there it re-resolves server-side from `params`.\n    const broadcastParams: Record<string, Json> = resolved\n      ? {\n          ...baseParams,\n          from: resolved.from,\n          networkClientId: resolved.networkClientId,\n        }\n      : params;\n\n    const result = await this.#dispatchSend({\n      socketPath,\n      params: broadcastParams,\n      timeoutMs: timeoutMs ?? BROADCAST_TIMEOUT_MS,\n      struct: SendTransactionBroadcastResultStruct,\n      broadcast: true,\n    });\n    this.log('Transaction broadcast.');\n    this.log(`Hash:   ${result.transactionHash}`);\n    this.log(`Id:     ${result.transactionId}`);\n    this.log(`Status: ${result.status}`);\n  }\n\n  /**\n   * Send a `sendTransaction` RPC to the daemon and return its validated result,\n   * translating connection errors, broadcast timeouts, JSON-RPC failures, and\n   * unexpected payloads into command errors.\n   *\n   * @param options - Dispatch options.\n   * @param options.socketPath - The daemon Unix socket path.\n   * @param options.params - The `sendTransaction` params (with or without\n   * `dryRun`).\n   * @param options.timeoutMs - Optional response timeout in milliseconds.\n   * @param options.struct - Struct the `result` payload must satisfy; the\n   * return type is inferred from it.\n   * @param options.broadcast - Whether this is the real (fund-moving) broadcast.\n   * When true, a read timeout is reported with guidance that the send may\n   * already be in flight, so the user does not blindly re-send.\n   * @returns The validated `result` payload.\n   */\n  async #dispatchSend<Value>(options: {\n    socketPath: string;\n    params: JsonRpcParams;\n    timeoutMs: number | undefined;\n    struct: Struct<Value>;\n    broadcast: boolean;\n  }): Promise<Value> {\n    const { socketPath, params, timeoutMs, struct, broadcast } = options;\n    let response;\n    try {\n      response = await sendCommand({\n        socketPath,\n        method: 'sendTransaction',\n        params,\n        ...(timeoutMs === undefined ? {} : { timeoutMs }),\n      });\n    } catch (error) {\n      if (broadcast && isReadTimeout(error)) {\n        this.error(broadcastTimeoutMessage());\n      }\n      this.error(makeDaemonConnectionError(error));\n    }\n\n    if (isJsonRpcFailure(response)) {\n      this.error(formatJsonRpcError(response.error));\n    }\n\n    const { result } = response;\n    if (!is(result, struct)) {\n      this.error(\n        `The daemon returned an unexpected ${broadcast ? 'send' : 'dry-run'} ` +\n          'result. It may be running an incompatible version.',\n      );\n    }\n    return result;\n  }\n}\n\n/**\n * Whether an error is the daemon-client socket read timeout. It carries no\n * errno code, so its message is the only signal.\n *\n * @param error - The caught value.\n * @returns True if it is the read timeout.\n */\nfunction isReadTimeout(error: unknown): boolean {\n  return error instanceof Error && error.message === 'Socket read timed out';\n}\n\n/**\n * The message shown when the broadcast call times out. A send is not\n * idempotent, and the daemon may still be broadcasting after the client gives\n * up waiting, so this warns against a blind re-run rather than reading as a\n * plain connection failure.\n *\n * @returns The user-facing guidance.\n */\nfunction broadcastTimeoutMessage(): string {\n  return (\n    'The daemon did not respond in time, but your transaction may still be ' +\n    'broadcasting. Do NOT re-run this command — you could send it twice. ' +\n    'Check `mm daemon status`, the daemon log, or your account on-chain to ' +\n    'confirm, then use --timeout to wait longer if needed.'\n  );\n}\n\n/**\n * Format a dry-run plan for display (and as the confirmation prompt body).\n *\n * @param plan - The dry-run result returned by the daemon.\n * @param etherAmount - The original `--value` (ether), shown alongside the\n * resolved wei so the user sees the human amount they typed.\n * @param extras - The `--data` / gas overrides the daemon does not echo back,\n * shown so the user confirms exactly what will be sent.\n * @returns A multi-line summary of the transaction to be sent.\n */\nfunction formatPlan(\n  plan: SendTransactionDryRunResult,\n  etherAmount: string,\n  extras: PlanExtras,\n): string {\n  const lines = [\n    'About to send:',\n    `  To:      ${plan.to}`,\n    `  From:    ${plan.from}`,\n    `  Value:   ${etherAmount} ETH (${plan.value} wei)`,\n    `  Network: ${plan.networkClientId}`,\n  ];\n  if (extras.data) {\n    lines.push(`  Data:    ${extras.data}`);\n  }\n  const gasParts = [\n    extras.gas ? `gas=${extras.gas}` : undefined,\n    extras.maxFeePerGas ? `maxFeePerGas=${extras.maxFeePerGas}` : undefined,\n    extras.maxPriorityFeePerGas\n      ? `maxPriorityFeePerGas=${extras.maxPriorityFeePerGas}`\n      : undefined,\n    extras.gasPrice ? `gasPrice=${extras.gasPrice}` : undefined,\n  ].filter((part): part is string => part !== undefined);\n  if (gasParts.length > 0) {\n    lines.push(`  Gas:     ${gasParts.join(', ')}`);\n  }\n  return lines.join('\\n');\n}\n"]}

package/dist/commands/wallet/send.d.cts

@@ -0,0 +1,42 @@
+import type { Hex } from "@metamask/utils";
+import { Command } from "@oclif/core";
+/**
+ * Convert a decimal ether amount to a `0x`-prefixed wei quantity.
+ *
+ * The fixed-point conversion is delegated to `@metamask/utils`' `toWei` rather
+ * than re-deriving the wei math here. The daemon's `sendTransaction` boundary
+ * expects canonical hex wei; this is where the human-friendly `--value` (ether)
+ * is turned into it.
+ *
+ * `toWei` silently accepts negatives and throws opaque messages on other
+ * malformed input, so the value is guarded up front for a clear error and a
+ * strictly non-negative amount.
+ *
+ * @param amount - A non-negative decimal ether amount (e.g. `"0.1"`, `"1"`).
+ * @returns The equivalent wei as a `0x`-prefixed hex string.
+ * @throws If `amount` is not a non-negative decimal or has more than 18
+ * fractional digits.
+ */
+export declare function parseEtherToWeiHex(amount: string): Hex;
+export default class WalletSend extends Command {
+    #private;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        value: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'network-client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'chain-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        gas: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-fee-per-gas': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-priority-fee-per-gas': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gas-price': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=send.d.cts.map

package/dist/commands/wallet/send.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.cts","sourceRoot":"","sources":["../../../src/commands/wallet/send.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAuB,wBAAwB;AAChE,OAAO,EAAE,OAAO,EAAS,oBAAoB;AAwC7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAetD;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;;IAC7C,OAAgB,WAAW,SAIgB;IAE3C,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;MAkDnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgLlC"}

package/dist/commands/wallet/send.d.mts

@@ -0,0 +1,42 @@
+import type { Hex } from "@metamask/utils";
+import { Command } from "@oclif/core";
+/**
+ * Convert a decimal ether amount to a `0x`-prefixed wei quantity.
+ *
+ * The fixed-point conversion is delegated to `@metamask/utils`' `toWei` rather
+ * than re-deriving the wei math here. The daemon's `sendTransaction` boundary
+ * expects canonical hex wei; this is where the human-friendly `--value` (ether)
+ * is turned into it.
+ *
+ * `toWei` silently accepts negatives and throws opaque messages on other
+ * malformed input, so the value is guarded up front for a clear error and a
+ * strictly non-negative amount.
+ *
+ * @param amount - A non-negative decimal ether amount (e.g. `"0.1"`, `"1"`).
+ * @returns The equivalent wei as a `0x`-prefixed hex string.
+ * @throws If `amount` is not a non-negative decimal or has more than 18
+ * fractional digits.
+ */
+export declare function parseEtherToWeiHex(amount: string): Hex;
+export default class WalletSend extends Command {
+    #private;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        value: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'network-client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'chain-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        gas: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-fee-per-gas': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-priority-fee-per-gas': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'gas-price': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=send.d.mts.map

package/dist/commands/wallet/send.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.mts","sourceRoot":"","sources":["../../../src/commands/wallet/send.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAuB,wBAAwB;AAChE,OAAO,EAAE,OAAO,EAAS,oBAAoB;AAwC7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAetD;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;;IAC7C,OAAgB,WAAW,SAIgB;IAE3C,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;MAkDnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgLlC"}