@metamask-previews/wallet-cli 0.0.0-preview-6316943cb → 0.0.0-preview-6cd1bb2f5

package/dist/commands/wallet/send.mjs

@@ -1,328 +0,0 @@
-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;
-import { is } from "@metamask/superstruct";
-import { bigIntToHex, isJsonRpcFailure, toWei } from "@metamask/utils";
-import { Command, Flags } from "@oclif/core";
-import { sendCommand } from "../../daemon/daemon-client.mjs";
-import { getDaemonPaths } from "../../daemon/paths.mjs";
-import { confirmSend } from "../../daemon/prompts.mjs";
-import { SendTransactionBroadcastResultStruct, SendTransactionDryRunResultStruct } from "../../daemon/send-transaction.mjs";
-import { emptyToUndefined, formatJsonRpcError, makeDaemonConnectionError } from "../../daemon/utils.mjs";
-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.
- */
-export 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 bigIntToHex(toWei(trimmed, 'ether'));
-}
-class WalletSend extends Command {
-    constructor() {
-        super(...arguments);
-        _WalletSend_instances.add(this);
-    }
-    async run() {
-        const { flags } = await this.parse(WalletSend);
-        const networkClientId = emptyToUndefined(flags['network-client-id']);
-        const chainId = 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 } = 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: 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: SendTransactionDryRunResultStruct,
-                broadcast: false,
-            });
-            let confirmed;
-            try {
-                confirmed = await 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: 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 sendCommand({
-            socketPath,
-            method: 'sendTransaction',
-            params,
-            ...(timeoutMs === undefined ? {} : { timeoutMs }),
-        });
-    }
-    catch (error) {
-        if (broadcast && isReadTimeout(error)) {
-            this.error(broadcastTimeoutMessage());
-        }
-        this.error(makeDaemonConnectionError(error));
-    }
-    if (isJsonRpcFailure(response)) {
-        this.error(formatJsonRpcError(response.error));
-    }
-    const { result } = response;
-    if (!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: Flags.string({
-        description: 'Recipient address (0x-prefixed)',
-        required: true,
-    }),
-    value: Flags.string({
-        description: 'Amount to send, in ether (e.g. 0.01). Defaults to 0.',
-        default: '0',
-    }),
-    from: Flags.string({
-        description: 'Sender address (0x-prefixed). Defaults to the selected account.',
-    }),
-    data: Flags.string({
-        description: 'Calldata as a 0x-prefixed hex string (for contract calls)',
-    }),
-    'network-client-id': Flags.string({
-        description: 'Network client to send on. Provide this or --chain-id, not both.',
-    }),
-    'chain-id': Flags.string({
-        description: 'Chain ID (0x-prefixed hex) to resolve to a network client. Provide this or --network-client-id, not both.',
-    }),
-    gas: Flags.string({
-        description: 'Gas limit override, as a 0x-prefixed hex quantity',
-    }),
-    'max-fee-per-gas': Flags.string({
-        description: 'maxFeePerGas override, as a 0x-prefixed hex wei quantity',
-    }),
-    'max-priority-fee-per-gas': Flags.string({
-        description: 'maxPriorityFeePerGas override, as a 0x-prefixed hex wei quantity',
-    }),
-    'gas-price': Flags.string({
-        description: 'Legacy gasPrice override, as a 0x-prefixed hex wei quantity',
-    }),
-    'dry-run': Flags.boolean({
-        description: 'Resolve the network client and sender and validate params, but do not broadcast.',
-    }),
-    yes: Flags.boolean({
-        char: 'y',
-        description: 'Skip the confirmation prompt and broadcast immediately.',
-    }),
-    timeout: Flags.integer({
-        char: 't',
-        description: 'Response timeout in milliseconds',
-    }),
-};
-export 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.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"send.mjs","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/daemon/send-transaction.cjs

@@ -1,147 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSendTransaction = exports.SendTransactionBroadcastResultStruct = exports.SendTransactionDryRunResultStruct = exports.SendTransactionParamsStruct = void 0;
-const superstruct_1 = require("@metamask/superstruct");
-const utils_1 = require("@metamask/utils");
-/**
- * Origin recorded on daemon-initiated transactions. Mirrors
- * `ORIGIN_METAMASK` from `@metamask/controller-utils` (a single string
- * constant, inlined here to avoid pulling that whole package in as a
- * dependency for one value).
- */
-const INTERNAL_ORIGIN = 'metamask';
-/**
- * Struct for a `0x`-prefixed 20-byte hex address. `isValidHexAddress` accepts
- * an all-lowercase address or a valid EIP-55 checksummed one, so a plain
- * lowercase paste works while a mistyped mixed-case address is rejected.
- */
-const AddressStruct = (0, superstruct_1.define)('Address', (value) => typeof value === 'string' && (0, utils_1.isValidHexAddress)(value)
-    ? true
-    : 'Expected a 0x-prefixed 20-byte hex address');
-/**
- * Params struct for the `sendTransaction` RPC method.
- *
- * The transaction fields (`to`, `value`, `data`, gas overrides) are canonical
- * `0x`-prefixed hex — any unit conversion (e.g. ether → wei) is the CLI
- * command's job, so the daemon boundary stays unambiguous. Exactly one of
- * `networkClientId` / `chainId` selects the network client; the refinement
- * below rejects supplying both or neither. `dryRun` short-circuits before
- * broadcast (see {@link runSendTransaction}).
- */
-exports.SendTransactionParamsStruct = (0, superstruct_1.refine)((0, superstruct_1.object)({
-    to: AddressStruct,
-    from: (0, superstruct_1.optional)(AddressStruct),
-    value: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    data: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    gas: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    maxFeePerGas: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    maxPriorityFeePerGas: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    gasPrice: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    networkClientId: (0, superstruct_1.optional)((0, superstruct_1.nonempty)((0, superstruct_1.string)())),
-    chainId: (0, superstruct_1.optional)(utils_1.StrictHexStruct),
-    dryRun: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
-}), 'SendTransactionParams', (value) => {
-    if ((value.networkClientId === undefined) ===
-        (value.chainId === undefined)) {
-        return 'Exactly one of `networkClientId` or `chainId` must be provided';
-    }
-    // `gasPrice` (legacy) and the EIP-1559 fields are mutually exclusive:
-    // `TransactionController` rejects the combination at broadcast, so reject
-    // it here at the boundary instead — otherwise a dry-run and the
-    // confirmation preview would show a plan that always fails at send.
-    if (value.gasPrice !== undefined &&
-        (value.maxFeePerGas !== undefined ||
-            value.maxPriorityFeePerGas !== undefined)) {
-        return '`gasPrice` cannot be combined with `maxFeePerGas` or `maxPriorityFeePerGas`';
-    }
-    return true;
-});
-/**
- * The resolved plan a `dryRun` returns: the network client and sender the
- * daemon would use, without adding or broadcasting anything. Exported as a
- * struct so the CLI can validate the payload it reads back over JSON-RPC
- * (which erases types on the wire) rather than trusting its shape.
- */
-exports.SendTransactionDryRunResultStruct = (0, superstruct_1.object)({
-    dryRun: (0, superstruct_1.literal)(true),
-    from: utils_1.StrictHexStruct,
-    to: utils_1.StrictHexStruct,
-    value: utils_1.StrictHexStruct,
-    networkClientId: (0, superstruct_1.string)(),
-});
-/**
- * The outcome of a broadcast send: the on-chain hash plus the id/status the
- * daemon tracks the transaction under. Exported as a struct for the same
- * client-side validation reason as {@link SendTransactionDryRunResultStruct}.
- */
-exports.SendTransactionBroadcastResultStruct = (0, superstruct_1.object)({
-    transactionHash: (0, superstruct_1.string)(),
-    transactionId: (0, superstruct_1.string)(),
-    status: (0, superstruct_1.string)(),
-});
-/**
- * Add and broadcast a transaction through the daemon-hosted
- * `TransactionController`, returning a serializable result.
- *
- * `TransactionController:addTransaction` returns `{ 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 JSON-RPC socket via the generic `call`
- * dispatch — hence this dedicated handler, which awaits the broadcast
- * server-side and returns only the resolved hash (and id/status).
- *
- * The network client is resolved from `chainId` (via `NetworkController`) when
- * `networkClientId` is not given directly, and `from` defaults to the selected
- * account. The transaction is submitted as `isInternal` (the daemon is driven
- * only by its owner over the `0600` same-user socket), which skips
- * origin/permitted-account validation; its approval request is auto-accepted
- * by the daemon's auto-approval subscription.
- *
- * When `dryRun` is set, the network client and sender are resolved and the
- * params validated, but nothing is added or broadcast — the resolved plan is
- * returned so the CLI can preview it before the user confirms.
- *
- * @param messenger - The wallet root messenger.
- * @param params - Validated `sendTransaction` params.
- * @returns The dry-run plan, or the broadcast hash with its id and status.
- */
-async function runSendTransaction(messenger, params) {
-    const { to, value = '0x0', data, gas, maxFeePerGas, maxPriorityFeePerGas, gasPrice, networkClientId: networkClientIdParam, chainId, dryRun, } = params;
-    // The struct guarantees exactly one of `networkClientId` / `chainId`, so
-    // `chainId` is defined whenever `networkClientId` is not.
-    const networkClientId = networkClientIdParam ??
-        messenger.call('NetworkController:findNetworkClientIdByChainId', chainId);
-    const from = params.from ??
-        messenger.call('AccountsController:getSelectedAccount').address;
-    if (dryRun) {
-        return { dryRun: true, from, to, value, networkClientId };
-    }
-    const txParams = {
-        from,
-        to,
-        value,
-        ...(data === undefined ? {} : { data }),
-        ...(gas === undefined ? {} : { gas }),
-        ...(maxFeePerGas === undefined ? {} : { maxFeePerGas }),
-        ...(maxPriorityFeePerGas === undefined ? {} : { maxPriorityFeePerGas }),
-        ...(gasPrice === undefined ? {} : { gasPrice }),
-    };
-    const { result, transactionMeta } = await messenger.call('TransactionController:addTransaction', txParams, { networkClientId, origin: INTERNAL_ORIGIN, isInternal: true });
-    // `result` resolves only once the transaction is signed and broadcast (see
-    // the function JSDoc); awaiting it here is what this handler exists for.
-    const transactionHash = await result;
-    // Re-read the live record for the current status: `transactionMeta` is the
-    // creation snapshot (still `unapproved`). If the record is already gone,
-    // fall back to `submitted` — reaching this point means `result` resolved, so
-    // the transaction was broadcast, never merely `unapproved`.
-    const [current] = messenger.call('TransactionController:getTransactions', {
-        searchCriteria: { id: transactionMeta.id },
-    });
-    return {
-        transactionHash,
-        transactionId: transactionMeta.id,
-        status: current?.status ?? 'submitted',
-    };
-}
-exports.runSendTransaction = runSendTransaction;
-//# sourceMappingURL=send-transaction.cjs.map

package/dist/daemon/send-transaction.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"send-transaction.cjs","sourceRoot":"","sources":["../../src/daemon/send-transaction.ts"],"names":[],"mappings":";;;AAAA,uDAS+B;AAE/B,2CAAqE;AAQrE;;;;;GAKG;AACH,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC;;;;GAIG;AACH,MAAM,aAAa,GAAG,IAAA,oBAAM,EAAM,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACrD,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,yBAAiB,EAAC,KAAY,CAAC;IAC1D,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,4CAA4C,CACjD,CAAC;AAEF;;;;;;;;;GASG;AACU,QAAA,2BAA2B,GAAG,IAAA,oBAAM,EAC/C,IAAA,oBAAM,EAAC;IACL,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,IAAA,sBAAQ,EAAC,aAAa,CAAC;IAC7B,KAAK,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IAChC,IAAI,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IAC/B,GAAG,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IAC9B,YAAY,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IACvC,oBAAoB,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IAC/C,QAAQ,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IACnC,eAAe,EAAE,IAAA,sBAAQ,EAAC,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC,CAAC;IAC7C,OAAO,EAAE,IAAA,sBAAQ,EAAC,uBAAe,CAAC;IAClC,MAAM,EAAE,IAAA,sBAAQ,EAAC,IAAA,qBAAO,GAAE,CAAC;CAC5B,CAAC,EACF,uBAAuB,EACvB,CAAC,KAAK,EAAE,EAAE;IACR,IACE,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC;QACrC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAC7B,CAAC;QACD,OAAO,gEAAgE,CAAC;IAC1E,CAAC;IACD,sEAAsE;IACtE,0EAA0E;IAC1E,gEAAgE;IAChE,oEAAoE;IACpE,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;YAC/B,KAAK,CAAC,oBAAoB,KAAK,SAAS,CAAC,EAC3C,CAAC;QACD,OAAO,6EAA6E,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC;AAIF;;;;;GAKG;AACU,QAAA,iCAAiC,GAAG,IAAA,oBAAM,EAAC;IACtD,MAAM,EAAE,IAAA,qBAAO,EAAC,IAAI,CAAC;IACrB,IAAI,EAAE,uBAAe;IACrB,EAAE,EAAE,uBAAe;IACnB,KAAK,EAAE,uBAAe;IACtB,eAAe,EAAE,IAAA,oBAAM,GAAE;CAC1B,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,oCAAoC,GAAG,IAAA,oBAAM,EAAC;IACzD,eAAe,EAAE,IAAA,oBAAM,GAAE;IACzB,aAAa,EAAE,IAAA,oBAAM,GAAE;IACvB,MAAM,EAAE,IAAA,oBAAM,GAAE;CACjB,CAAC,CAAC;AAcH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAAiE,EACjE,MAA6B;IAE7B,MAAM,EACJ,EAAE,EACF,KAAK,GAAG,KAAK,EACb,IAAI,EACJ,GAAG,EACH,YAAY,EACZ,oBAAoB,EACpB,QAAQ,EACR,eAAe,EAAE,oBAAoB,EACrC,OAAO,EACP,MAAM,GACP,GAAG,MAAM,CAAC;IAEX,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,eAAe,GACnB,oBAAoB;QACpB,SAAS,CAAC,IAAI,CACZ,gDAAgD,EAChD,OAAc,CACf,CAAC;IAEJ,MAAM,IAAI,GACR,MAAM,CAAC,IAAI;QACV,SAAS,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,OAAe,CAAC;IAE3E,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,IAAI;QACJ,EAAE;QACF,KAAK;QACL,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QACrC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,GAAG,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC;QACvE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAChD,CAAC;IAEF,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CACtD,sCAAsC,EACtC,QAAQ,EACR,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,CAC/D,CAAC;IAEF,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC;IAErC,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,4DAA4D;IAC5D,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,uCAAuC,EAAE;QACxE,cAAc,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE;KAC3C,CAAC,CAAC;IAEH,OAAO;QACL,eAAe;QACf,aAAa,EAAE,eAAe,CAAC,EAAE;QACjC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,WAAW;KACvC,CAAC;AACJ,CAAC;AApED,gDAoEC","sourcesContent":["import {\n  boolean,\n  define,\n  literal,\n  nonempty,\n  object,\n  optional,\n  refine,\n  string,\n} from '@metamask/superstruct';\nimport type { Infer } from '@metamask/superstruct';\nimport { isValidHexAddress, StrictHexStruct } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from '@metamask/wallet';\n\n/**\n * Origin recorded on daemon-initiated transactions. Mirrors\n * `ORIGIN_METAMASK` from `@metamask/controller-utils` (a single string\n * constant, inlined here to avoid pulling that whole package in as a\n * dependency for one value).\n */\nconst INTERNAL_ORIGIN = 'metamask';\n\n/**\n * Struct for a `0x`-prefixed 20-byte hex address. `isValidHexAddress` accepts\n * an all-lowercase address or a valid EIP-55 checksummed one, so a plain\n * lowercase paste works while a mistyped mixed-case address is rejected.\n */\nconst AddressStruct = define<Hex>('Address', (value) =>\n  typeof value === 'string' && isValidHexAddress(value as Hex)\n    ? true\n    : 'Expected a 0x-prefixed 20-byte hex address',\n);\n\n/**\n * Params struct for the `sendTransaction` RPC method.\n *\n * The transaction fields (`to`, `value`, `data`, gas overrides) are canonical\n * `0x`-prefixed hex — any unit conversion (e.g. ether → wei) is the CLI\n * command's job, so the daemon boundary stays unambiguous. Exactly one of\n * `networkClientId` / `chainId` selects the network client; the refinement\n * below rejects supplying both or neither. `dryRun` short-circuits before\n * broadcast (see {@link runSendTransaction}).\n */\nexport const SendTransactionParamsStruct = refine(\n  object({\n    to: AddressStruct,\n    from: optional(AddressStruct),\n    value: optional(StrictHexStruct),\n    data: optional(StrictHexStruct),\n    gas: optional(StrictHexStruct),\n    maxFeePerGas: optional(StrictHexStruct),\n    maxPriorityFeePerGas: optional(StrictHexStruct),\n    gasPrice: optional(StrictHexStruct),\n    networkClientId: optional(nonempty(string())),\n    chainId: optional(StrictHexStruct),\n    dryRun: optional(boolean()),\n  }),\n  'SendTransactionParams',\n  (value) => {\n    if (\n      (value.networkClientId === undefined) ===\n      (value.chainId === undefined)\n    ) {\n      return 'Exactly one of `networkClientId` or `chainId` must be provided';\n    }\n    // `gasPrice` (legacy) and the EIP-1559 fields are mutually exclusive:\n    // `TransactionController` rejects the combination at broadcast, so reject\n    // it here at the boundary instead — otherwise a dry-run and the\n    // confirmation preview would show a plan that always fails at send.\n    if (\n      value.gasPrice !== undefined &&\n      (value.maxFeePerGas !== undefined ||\n        value.maxPriorityFeePerGas !== undefined)\n    ) {\n      return '`gasPrice` cannot be combined with `maxFeePerGas` or `maxPriorityFeePerGas`';\n    }\n    return true;\n  },\n);\n\nexport type SendTransactionParams = Infer<typeof SendTransactionParamsStruct>;\n\n/**\n * The resolved plan a `dryRun` returns: the network client and sender the\n * daemon would use, without adding or broadcasting anything. Exported as a\n * struct so the CLI can validate the payload it reads back over JSON-RPC\n * (which erases types on the wire) rather than trusting its shape.\n */\nexport const SendTransactionDryRunResultStruct = object({\n  dryRun: literal(true),\n  from: StrictHexStruct,\n  to: StrictHexStruct,\n  value: StrictHexStruct,\n  networkClientId: string(),\n});\n\n/**\n * The outcome of a broadcast send: the on-chain hash plus the id/status the\n * daemon tracks the transaction under. Exported as a struct for the same\n * client-side validation reason as {@link SendTransactionDryRunResultStruct}.\n */\nexport const SendTransactionBroadcastResultStruct = object({\n  transactionHash: string(),\n  transactionId: string(),\n  status: string(),\n});\n\nexport type SendTransactionDryRunResult = Infer<\n  typeof SendTransactionDryRunResultStruct\n>;\n\nexport type SendTransactionBroadcastResult = Infer<\n  typeof SendTransactionBroadcastResultStruct\n>;\n\nexport type SendTransactionResult =\n  | SendTransactionDryRunResult\n  | SendTransactionBroadcastResult;\n\n/**\n * Add and broadcast a transaction through the daemon-hosted\n * `TransactionController`, returning a serializable result.\n *\n * `TransactionController:addTransaction` returns `{ transactionMeta, result }`\n * where `result` is a `Promise<hash>` that resolves once the transaction is\n * signed and broadcast. That promise is not JSON-serializable, so it cannot\n * travel back over the daemon's JSON-RPC socket via the generic `call`\n * dispatch — hence this dedicated handler, which awaits the broadcast\n * server-side and returns only the resolved hash (and id/status).\n *\n * The network client is resolved from `chainId` (via `NetworkController`) when\n * `networkClientId` is not given directly, and `from` defaults to the selected\n * account. The transaction is submitted as `isInternal` (the daemon is driven\n * only by its owner over the `0600` same-user socket), which skips\n * origin/permitted-account validation; its approval request is auto-accepted\n * by the daemon's auto-approval subscription.\n *\n * When `dryRun` is set, the network client and sender are resolved and the\n * params validated, but nothing is added or broadcast — the resolved plan is\n * returned so the CLI can preview it before the user confirms.\n *\n * @param messenger - The wallet root messenger.\n * @param params - Validated `sendTransaction` params.\n * @returns The dry-run plan, or the broadcast hash with its id and status.\n */\nexport async function runSendTransaction(\n  messenger: Readonly<RootMessenger<DefaultActions, DefaultEvents>>,\n  params: SendTransactionParams,\n): Promise<SendTransactionResult> {\n  const {\n    to,\n    value = '0x0',\n    data,\n    gas,\n    maxFeePerGas,\n    maxPriorityFeePerGas,\n    gasPrice,\n    networkClientId: networkClientIdParam,\n    chainId,\n    dryRun,\n  } = params;\n\n  // The struct guarantees exactly one of `networkClientId` / `chainId`, so\n  // `chainId` is defined whenever `networkClientId` is not.\n  const networkClientId =\n    networkClientIdParam ??\n    messenger.call(\n      'NetworkController:findNetworkClientIdByChainId',\n      chainId as Hex,\n    );\n\n  const from =\n    params.from ??\n    (messenger.call('AccountsController:getSelectedAccount').address as Hex);\n\n  if (dryRun) {\n    return { dryRun: true, from, to, value, networkClientId };\n  }\n\n  const txParams = {\n    from,\n    to,\n    value,\n    ...(data === undefined ? {} : { data }),\n    ...(gas === undefined ? {} : { gas }),\n    ...(maxFeePerGas === undefined ? {} : { maxFeePerGas }),\n    ...(maxPriorityFeePerGas === undefined ? {} : { maxPriorityFeePerGas }),\n    ...(gasPrice === undefined ? {} : { gasPrice }),\n  };\n\n  const { result, transactionMeta } = await messenger.call(\n    'TransactionController:addTransaction',\n    txParams,\n    { networkClientId, origin: INTERNAL_ORIGIN, isInternal: true },\n  );\n\n  // `result` resolves only once the transaction is signed and broadcast (see\n  // the function JSDoc); awaiting it here is what this handler exists for.\n  const transactionHash = await result;\n\n  // Re-read the live record for the current status: `transactionMeta` is the\n  // creation snapshot (still `unapproved`). If the record is already gone,\n  // fall back to `submitted` — reaching this point means `result` resolved, so\n  // the transaction was broadcast, never merely `unapproved`.\n  const [current] = messenger.call('TransactionController:getTransactions', {\n    searchCriteria: { id: transactionMeta.id },\n  });\n\n  return {\n    transactionHash,\n    transactionId: transactionMeta.id,\n    status: current?.status ?? 'submitted',\n  };\n}\n"]}

package/dist/daemon/send-transaction.d.cts

@@ -1,102 +0,0 @@
-import type { Infer } from "@metamask/superstruct";
-import type { DefaultActions, DefaultEvents, RootMessenger } from "@metamask/wallet";
-/**
- * Params struct for the `sendTransaction` RPC method.
- *
- * The transaction fields (`to`, `value`, `data`, gas overrides) are canonical
- * `0x`-prefixed hex — any unit conversion (e.g. ether → wei) is the CLI
- * command's job, so the daemon boundary stays unambiguous. Exactly one of
- * `networkClientId` / `chainId` selects the network client; the refinement
- * below rejects supplying both or neither. `dryRun` short-circuits before
- * broadcast (see {@link runSendTransaction}).
- */
-export declare const SendTransactionParamsStruct: import("@metamask/superstruct").Struct<{
-    to: `0x${string}`;
-    data?: `0x${string}` | undefined;
-    value?: `0x${string}` | undefined;
-    from?: `0x${string}` | undefined;
-    gas?: `0x${string}` | undefined;
-    maxFeePerGas?: `0x${string}` | undefined;
-    maxPriorityFeePerGas?: `0x${string}` | undefined;
-    gasPrice?: `0x${string}` | undefined;
-    networkClientId?: string | undefined;
-    chainId?: `0x${string}` | undefined;
-    dryRun?: boolean | undefined;
-}, {
-    to: import("@metamask/superstruct").Struct<`0x${string}`, null>;
-    from: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    value: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    data: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    gas: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    maxFeePerGas: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    maxPriorityFeePerGas: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    gasPrice: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    networkClientId: import("@metamask/superstruct").Struct<string | undefined, null>;
-    chainId: import("@metamask/superstruct").Struct<`0x${string}` | undefined, null>;
-    dryRun: import("@metamask/superstruct").Struct<boolean | undefined, null>;
-}>;
-export type SendTransactionParams = Infer<typeof SendTransactionParamsStruct>;
-/**
- * The resolved plan a `dryRun` returns: the network client and sender the
- * daemon would use, without adding or broadcasting anything. Exported as a
- * struct so the CLI can validate the payload it reads back over JSON-RPC
- * (which erases types on the wire) rather than trusting its shape.
- */
-export declare const SendTransactionDryRunResultStruct: import("@metamask/superstruct").Struct<{
-    value: `0x${string}`;
-    to: `0x${string}`;
-    from: `0x${string}`;
-    networkClientId: string;
-    dryRun: true;
-}, {
-    dryRun: import("@metamask/superstruct").Struct<true, true>;
-    from: import("@metamask/superstruct").Struct<`0x${string}`, null>;
-    to: import("@metamask/superstruct").Struct<`0x${string}`, null>;
-    value: import("@metamask/superstruct").Struct<`0x${string}`, null>;
-    networkClientId: import("@metamask/superstruct").Struct<string, null>;
-}>;
-/**
- * The outcome of a broadcast send: the on-chain hash plus the id/status the
- * daemon tracks the transaction under. Exported as a struct for the same
- * client-side validation reason as {@link SendTransactionDryRunResultStruct}.
- */
-export declare const SendTransactionBroadcastResultStruct: import("@metamask/superstruct").Struct<{
-    status: string;
-    transactionHash: string;
-    transactionId: string;
-}, {
-    transactionHash: import("@metamask/superstruct").Struct<string, null>;
-    transactionId: import("@metamask/superstruct").Struct<string, null>;
-    status: import("@metamask/superstruct").Struct<string, null>;
-}>;
-export type SendTransactionDryRunResult = Infer<typeof SendTransactionDryRunResultStruct>;
-export type SendTransactionBroadcastResult = Infer<typeof SendTransactionBroadcastResultStruct>;
-export type SendTransactionResult = SendTransactionDryRunResult | SendTransactionBroadcastResult;
-/**
- * Add and broadcast a transaction through the daemon-hosted
- * `TransactionController`, returning a serializable result.
- *
- * `TransactionController:addTransaction` returns `{ 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 JSON-RPC socket via the generic `call`
- * dispatch — hence this dedicated handler, which awaits the broadcast
- * server-side and returns only the resolved hash (and id/status).
- *
- * The network client is resolved from `chainId` (via `NetworkController`) when
- * `networkClientId` is not given directly, and `from` defaults to the selected
- * account. The transaction is submitted as `isInternal` (the daemon is driven
- * only by its owner over the `0600` same-user socket), which skips
- * origin/permitted-account validation; its approval request is auto-accepted
- * by the daemon's auto-approval subscription.
- *
- * When `dryRun` is set, the network client and sender are resolved and the
- * params validated, but nothing is added or broadcast — the resolved plan is
- * returned so the CLI can preview it before the user confirms.
- *
- * @param messenger - The wallet root messenger.
- * @param params - Validated `sendTransaction` params.
- * @returns The dry-run plan, or the broadcast hash with its id and status.
- */
-export declare function runSendTransaction(messenger: Readonly<RootMessenger<DefaultActions, DefaultEvents>>, params: SendTransactionParams): Promise<SendTransactionResult>;
-//# sourceMappingURL=send-transaction.d.cts.map