@metamask-previews/wallet-cli 0.0.0-preview-b3db565c8 → 0.0.0-preview-8bfa290fb

package/dist/daemon/send-transaction.cjs

@@ -0,0 +1,147 @@
+"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

@@ -0,0 +1 @@
+{"version":3,"file":"send-transaction.cjs","sourceRoot":"","sources":["../../src/daemon/send-transaction.ts"],"names":[],"mappings":"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","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.ts → send-transaction.d.cts}

@@ -1,5 +1,5 @@
-import type { Infer } from '@metamask/superstruct';
-import type { DefaultActions, DefaultEvents, RootMessenger } from '@metamask/wallet';
+import type { Infer } from "@metamask/superstruct";
+import type { DefaultActions, DefaultEvents, RootMessenger } from "@metamask/wallet";
 /**
  * Params struct for the `sendTransaction` RPC method.
  *
@@ -12,9 +12,9 @@ import type { DefaultActions, DefaultEvents, RootMessenger } from '@metamask/wal
  */
 export declare const SendTransactionParamsStruct: import("@metamask/superstruct").Struct<{
     to: `0x${string}`;
-    from?: `0x${string}` | undefined;
-    value?: `0x${string}` | undefined;
     data?: `0x${string}` | undefined;
+    value?: `0x${string}` | undefined;
+    from?: `0x${string}` | undefined;
     gas?: `0x${string}` | undefined;
     maxFeePerGas?: `0x${string}` | undefined;
     maxPriorityFeePerGas?: `0x${string}` | undefined;
@@ -43,11 +43,11 @@ export type SendTransactionParams = Infer<typeof SendTransactionParamsStruct>;
  * (which erases types on the wire) rather than trusting its shape.
  */
 export declare const SendTransactionDryRunResultStruct: import("@metamask/superstruct").Struct<{
-    dryRun: true;
-    from: `0x${string}`;
-    to: `0x${string}`;
     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>;
@@ -61,9 +61,9 @@ export declare const SendTransactionDryRunResultStruct: import("@metamask/supers
  * client-side validation reason as {@link SendTransactionDryRunResultStruct}.
  */
 export declare const SendTransactionBroadcastResultStruct: import("@metamask/superstruct").Struct<{
+    status: string;
     transactionHash: string;
     transactionId: string;
-    status: string;
 }, {
     transactionHash: import("@metamask/superstruct").Struct<string, null>;
     transactionId: import("@metamask/superstruct").Struct<string, null>;
@@ -99,4 +99,4 @@ export type SendTransactionResult = SendTransactionDryRunResult | SendTransactio
  * @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.ts.map
+//# sourceMappingURL=send-transaction.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-transaction.d.cts","sourceRoot":"","sources":["../../src/daemon/send-transaction.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAGnD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,yBAAyB;AAqB1B;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAmCvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;EAM5C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;EAI/C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAC7C,OAAO,iCAAiC,CACzC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAChD,OAAO,oCAAoC,CAC5C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,2BAA2B,GAC3B,8BAA8B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,EACjE,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAiEhC"}

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

@@ -0,0 +1,102 @@
+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.mts.map

package/dist/daemon/send-transaction.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-transaction.d.mts","sourceRoot":"","sources":["../../src/daemon/send-transaction.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAGnD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,yBAAyB;AAqB1B;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAmCvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;EAM5C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;EAI/C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAC7C,OAAO,iCAAiC,CACzC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAChD,OAAO,oCAAoC,CAC5C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,2BAA2B,GAC3B,8BAA8B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,EACjE,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAiEhC"}

package/dist/daemon/{send-transaction.js → send-transaction.mjs}

@@ -1,5 +1,5 @@
-import { boolean, define, literal, nonempty, object, optional, refine, string, } from '@metamask/superstruct';
-import { isValidHexAddress, StrictHexStruct } from '@metamask/utils';
+import { boolean, define, literal, nonempty, object, optional, refine, string } from "@metamask/superstruct";
+import { isValidHexAddress, StrictHexStruct } from "@metamask/utils";
 /**
  * Origin recorded on daemon-initiated transactions. Mirrors
  * `ORIGIN_METAMASK` from `@metamask/controller-utils` (a single string
@@ -140,4 +140,4 @@ export async function runSendTransaction(messenger, params) {
         status: current?.status ?? 'submitted',
     };
 }
-//# sourceMappingURL=send-transaction.js.map
+//# sourceMappingURL=send-transaction.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-transaction.mjs","sourceRoot":"","sources":["../../src/daemon/send-transaction.ts"],"names":[],"mappings":"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","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/socket-line.cjs

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readLine = exports.writeLine = void 0;
+/**
+ * Write a newline-delimited line to a socket.
+ *
+ * @param socket - The socket to write to.
+ * @param line - The line to write (without trailing newline).
+ */
+async function writeLine(socket, line) {
+    return new Promise((resolve, reject) => {
+        // A socket 'error' can fire while the write is in flight without ever
+        // reaching the write callback; without this listener Node would treat it
+        // as an unhandled 'error' event and crash the process.
+        const onError = (error) => {
+            socket.removeListener('error', onError);
+            reject(error);
+        };
+        socket.once('error', onError);
+        socket.write(`${line}\n`, (error) => {
+            if (error) {
+                // A failed write (e.g. EPIPE) is delivered BOTH here AND as a later
+                // 'error' event. Leave `onError` attached to handle that event —
+                // detaching here would let Node treat it as unhandled and crash the
+                // process. This reject settles the promise; `onError` detaches itself
+                // when/if the event arrives.
+                reject(error);
+                return;
+            }
+            socket.removeListener('error', onError);
+            resolve();
+        });
+    });
+}
+exports.writeLine = writeLine;
+/**
+ * Read a single newline-delimited line from a socket.
+ *
+ * @param socket - The socket to read from.
+ * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
+ * error if no complete line is received within the limit.
+ * @returns The line read (without trailing newline).
+ */
+async function readLine(socket, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let buffer = '';
+        let timer;
+        if (timeoutMs !== undefined) {
+            timer = setTimeout(() => {
+                cleanup();
+                reject(new Error('Socket read timed out'));
+            }, timeoutMs);
+        }
+        const onData = (data) => {
+            buffer += data.toString();
+            const idx = buffer.indexOf('\n');
+            if (idx !== -1) {
+                cleanup();
+                resolve(buffer.slice(0, idx));
+            }
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onEnd = () => {
+            cleanup();
+            reject(new Error('Socket closed before response received'));
+        };
+        const onClose = () => {
+            cleanup();
+            reject(new Error('Socket closed before response received'));
+        };
+        /**
+         * Remove listeners registered by this call and clear the timeout.
+         */
+        function cleanup() {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            socket.removeListener('data', onData);
+            socket.removeListener('error', onError);
+            socket.removeListener('end', onEnd);
+            socket.removeListener('close', onClose);
+        }
+        socket.on('data', onData);
+        socket.once('error', onError);
+        socket.once('end', onEnd);
+        socket.once('close', onClose);
+    });
+}
+exports.readLine = readLine;
+//# sourceMappingURL=socket-line.cjs.map

package/dist/daemon/socket-line.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-line.cjs","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Socket } from 'node:net';\n\n/**\n * Write a newline-delimited line to a socket.\n *\n * @param socket - The socket to write to.\n * @param line - The line to write (without trailing newline).\n */\nexport async function writeLine(socket: Socket, line: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    // A socket 'error' can fire while the write is in flight without ever\n    // reaching the write callback; without this listener Node would treat it\n    // as an unhandled 'error' event and crash the process.\n    const onError = (error: Error): void => {\n      socket.removeListener('error', onError);\n      reject(error);\n    };\n    socket.once('error', onError);\n\n    socket.write(`${line}\\n`, (error) => {\n      if (error) {\n        // A failed write (e.g. EPIPE) is delivered BOTH here AND as a later\n        // 'error' event. Leave `onError` attached to handle that event —\n        // detaching here would let Node treat it as unhandled and crash the\n        // process. This reject settles the promise; `onError` detaches itself\n        // when/if the event arrives.\n        reject(error);\n        return;\n      }\n      socket.removeListener('error', onError);\n      resolve();\n    });\n  });\n}\n\n/**\n * Read a single newline-delimited line from a socket.\n *\n * @param socket - The socket to read from.\n * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout\n * error if no complete line is received within the limit.\n * @returns The line read (without trailing newline).\n */\nexport async function readLine(\n  socket: Socket,\n  timeoutMs?: number,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buffer = '';\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    if (timeoutMs !== undefined) {\n      timer = setTimeout(() => {\n        cleanup();\n        reject(new Error('Socket read timed out'));\n      }, timeoutMs);\n    }\n\n    const onData = (data: Buffer): void => {\n      buffer += data.toString();\n      const idx = buffer.indexOf('\\n');\n      if (idx !== -1) {\n        cleanup();\n        resolve(buffer.slice(0, idx));\n      }\n    };\n\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n\n    const onEnd = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    const onClose = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    /**\n     * Remove listeners registered by this call and clear the timeout.\n     */\n    function cleanup(): void {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n      socket.removeListener('data', onData);\n      socket.removeListener('error', onError);\n      socket.removeListener('end', onEnd);\n      socket.removeListener('close', onClose);\n    }\n\n    socket.on('data', onData);\n    socket.once('error', onError);\n    socket.once('end', onEnd);\n    socket.once('close', onClose);\n  });\n}\n"]}

package/dist/daemon/{socket-line.d.ts → socket-line.d.cts}

@@ -1,4 +1,7 @@
-import type { Socket } from 'node:net';
+/// <reference types="node" />
+/// <reference types="node/net" />
+/// <reference types="npm-which/node_modules/@types/node/net" />
+import type { Socket } from "node:net";
 /**
  * Write a newline-delimited line to a socket.
  *
@@ -15,4 +18,4 @@ export declare function writeLine(socket: Socket, line: string): Promise<void>;
  * @returns The line read (without trailing newline).
  */
 export declare function readLine(socket: Socket, timeoutMs?: number): Promise<string>;
-//# sourceMappingURL=socket-line.d.ts.map
+//# sourceMappingURL=socket-line.d.cts.map

package/dist/daemon/socket-line.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-line.d.cts","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":";;;AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB;AAEvC;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/daemon/socket-line.d.mts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+/// <reference types="node/net" />
+/// <reference types="npm-which/node_modules/@types/node/net" />
+import type { Socket } from "node:net";
+/**
+ * Write a newline-delimited line to a socket.
+ *
+ * @param socket - The socket to write to.
+ * @param line - The line to write (without trailing newline).
+ */
+export declare function writeLine(socket: Socket, line: string): Promise<void>;
+/**
+ * Read a single newline-delimited line from a socket.
+ *
+ * @param socket - The socket to read from.
+ * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
+ * error if no complete line is received within the limit.
+ * @returns The line read (without trailing newline).
+ */
+export declare function readLine(socket: Socket, timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=socket-line.d.mts.map

package/dist/daemon/socket-line.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-line.d.mts","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":";;;AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB;AAEvC;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/daemon/{socket-line.js → socket-line.mjs}

@@ -85,4 +85,4 @@ export async function readLine(socket, timeoutMs) {
         socket.once('close', onClose);
     });
 }
-//# sourceMappingURL=socket-line.js.map
+//# sourceMappingURL=socket-line.mjs.map

package/dist/daemon/socket-line.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-line.mjs","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Socket } from 'node:net';\n\n/**\n * Write a newline-delimited line to a socket.\n *\n * @param socket - The socket to write to.\n * @param line - The line to write (without trailing newline).\n */\nexport async function writeLine(socket: Socket, line: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    // A socket 'error' can fire while the write is in flight without ever\n    // reaching the write callback; without this listener Node would treat it\n    // as an unhandled 'error' event and crash the process.\n    const onError = (error: Error): void => {\n      socket.removeListener('error', onError);\n      reject(error);\n    };\n    socket.once('error', onError);\n\n    socket.write(`${line}\\n`, (error) => {\n      if (error) {\n        // A failed write (e.g. EPIPE) is delivered BOTH here AND as a later\n        // 'error' event. Leave `onError` attached to handle that event —\n        // detaching here would let Node treat it as unhandled and crash the\n        // process. This reject settles the promise; `onError` detaches itself\n        // when/if the event arrives.\n        reject(error);\n        return;\n      }\n      socket.removeListener('error', onError);\n      resolve();\n    });\n  });\n}\n\n/**\n * Read a single newline-delimited line from a socket.\n *\n * @param socket - The socket to read from.\n * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout\n * error if no complete line is received within the limit.\n * @returns The line read (without trailing newline).\n */\nexport async function readLine(\n  socket: Socket,\n  timeoutMs?: number,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buffer = '';\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    if (timeoutMs !== undefined) {\n      timer = setTimeout(() => {\n        cleanup();\n        reject(new Error('Socket read timed out'));\n      }, timeoutMs);\n    }\n\n    const onData = (data: Buffer): void => {\n      buffer += data.toString();\n      const idx = buffer.indexOf('\\n');\n      if (idx !== -1) {\n        cleanup();\n        resolve(buffer.slice(0, idx));\n      }\n    };\n\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n\n    const onEnd = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    const onClose = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    /**\n     * Remove listeners registered by this call and clear the timeout.\n     */\n    function cleanup(): void {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n      socket.removeListener('data', onData);\n      socket.removeListener('error', onError);\n      socket.removeListener('end', onEnd);\n      socket.removeListener('close', onClose);\n    }\n\n    socket.on('data', onData);\n    socket.once('error', onError);\n    socket.once('end', onEnd);\n    socket.once('close', onClose);\n  });\n}\n"]}