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

package/dist/daemon/utils.d.mts

@@ -0,0 +1,87 @@
+/// <reference types="node" />
+import type { JsonRpcError } from "@metamask/utils";
+/**
+ * Check whether an unknown error is a Node.js system error with the given code.
+ *
+ * @param error - The error to check.
+ * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').
+ * @returns True if the error matches the code.
+ */
+export declare function isErrorWithCode(error: unknown, code: string): boolean;
+/**
+ * Turn an error thrown while contacting the daemon socket into a user-facing
+ * message for `Command.error`, so every command reports the same failure the
+ * same way. Distinguishes a stopped daemon (`ENOENT`/`ECONNREFUSED`), a
+ * connection dropped mid-request (`ECONNRESET`), and a permission problem
+ * (`EACCES`/`EPERM`), falling back to the raw error message.
+ *
+ * @param error - The value thrown while contacting the daemon.
+ * @returns A human-readable explanation of the failure.
+ */
+export declare function makeDaemonConnectionError(error: unknown): string;
+/**
+ * Format the error of a JSON-RPC failure response into a user-facing message
+ * for `Command.error`, so every command reports RPC failures the same way.
+ *
+ * @param error - The `error` field of a JSON-RPC failure response.
+ * @returns The error message annotated with its numeric code.
+ */
+export declare function formatJsonRpcError(error: JsonRpcError): string;
+/**
+ * Treat an empty string the same as `undefined` — "no value supplied". Used
+ * to normalise `--password ''` and `MM_WALLET_PASSWORD=''` so they trigger
+ * the interactive prompt rather than sending an empty string to the keyring.
+ *
+ * @param value - The value to normalise.
+ * @returns `undefined` if `value` is `undefined` or `''`; `value` otherwise.
+ */
+export declare function emptyToUndefined(value: string | undefined): string | undefined;
+/**
+ * Check whether a value is an array of strings. Used to validate untyped RPC
+ * results (e.g. the daemon's `listActions`) before treating them as `string[]`.
+ *
+ * @param value - The value to check.
+ * @returns True if the value is an array whose every element is a string.
+ */
+export declare function isStringArray(value: unknown): value is string[];
+/**
+ * Read a PID from a file. The file may contain just the PID, or the PID on
+ * the first line followed by additional metadata (e.g. start time written by
+ * the daemon).
+ *
+ * @param pidPath - The PID file path.
+ * @returns The PID, or undefined if the file is missing or its first line is
+ * not a positive integer.
+ */
+export declare function readPidFile(pidPath: string): Promise<number | undefined>;
+/**
+ * Check whether a process is alive by sending signal 0.
+ *
+ * Treats `ESRCH` as "process is gone", `EPERM` as "process exists but we
+ * cannot signal it" (still alive from our perspective), and rethrows
+ * anything else so the caller can surface unexpected failures rather than
+ * silently assuming the process is dead.
+ *
+ * @param pid - The process ID to check.
+ * @returns True if the process exists.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Send a signal to a process. Returns true if the signal was sent, false if
+ * the process does not exist (ESRCH). Re-throws on permission errors and
+ * other failures.
+ *
+ * @param pid - The process ID.
+ * @param signal - The signal to send.
+ * @returns True if the signal was delivered, false if the process is gone.
+ */
+export declare function sendSignal(pid: number, signal: NodeJS.Signals): boolean;
+/**
+ * Poll until a condition is met or the timeout elapses.
+ *
+ * @param check - A function that returns true when the condition is met.
+ * @param timeoutMs - Maximum time to wait in milliseconds.
+ * @returns True if the condition was met, false on timeout.
+ */
+export declare function waitFor(check: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean>;
+//# sourceMappingURL=utils.d.mts.map

package/dist/daemon/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/daemon/utils.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB;AAIpD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuBhE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAUvE;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/daemon/{utils.js → utils.mjs}

@@ -1,5 +1,5 @@
-import { isErrorWithCode as hasErrorCode } from '@metamask/utils';
-import { readFile } from 'node:fs/promises';
+import { isErrorWithCode as hasErrorCode } from "@metamask/utils";
+import { readFile } from "node:fs/promises";
 /**
  * Check whether an unknown error is a Node.js system error with the given code.
  *
@@ -157,4 +157,4 @@ export async function waitFor(check, timeoutMs) {
     }
     return false;
 }
-//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.mjs.map

package/dist/daemon/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/daemon/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonRpcError } from '@metamask/utils';\nimport { isErrorWithCode as hasErrorCode } from '@metamask/utils';\nimport { readFile } from 'node:fs/promises';\n\n/**\n * Check whether an unknown error is a Node.js system error with the given code.\n *\n * @param error - The error to check.\n * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').\n * @returns True if the error matches the code.\n */\nexport function isErrorWithCode(error: unknown, code: string): boolean {\n  return hasErrorCode(error) && error.code === code;\n}\n\n/**\n * Turn an error thrown while contacting the daemon socket into a user-facing\n * message for `Command.error`, so every command reports the same failure the\n * same way. Distinguishes a stopped daemon (`ENOENT`/`ECONNREFUSED`), a\n * connection dropped mid-request (`ECONNRESET`), and a permission problem\n * (`EACCES`/`EPERM`), falling back to the raw error message.\n *\n * @param error - The value thrown while contacting the daemon.\n * @returns A human-readable explanation of the failure.\n */\nexport function makeDaemonConnectionError(error: unknown): string {\n  if (\n    isErrorWithCode(error, 'ENOENT') ||\n    isErrorWithCode(error, 'ECONNREFUSED')\n  ) {\n    return 'Daemon is not running. Start it with `mm daemon start`.';\n  }\n  // A reset drops an already-established connection, so the daemon was running\n  // — most likely it crashed mid-request. Don't tell the user to start it.\n  if (isErrorWithCode(error, 'ECONNRESET')) {\n    return (\n      'Lost the connection to the daemon; it may have crashed while ' +\n      'handling the request. Check `mm daemon status` and the daemon log.'\n    );\n  }\n  if (isErrorWithCode(error, 'EACCES') || isErrorWithCode(error, 'EPERM')) {\n    return (\n      'Cannot connect to the daemon socket: permission denied. ' +\n      'The socket may be owned by another user, or MM_DAEMON_DATA_DIR ' +\n      'may point to a directory you cannot access.'\n    );\n  }\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Format the error of a JSON-RPC failure response into a user-facing message\n * for `Command.error`, so every command reports RPC failures the same way.\n *\n * @param error - The `error` field of a JSON-RPC failure response.\n * @returns The error message annotated with its numeric code.\n */\nexport function formatJsonRpcError(error: JsonRpcError): string {\n  return `${error.message} (code ${String(error.code)})`;\n}\n\n/**\n * Treat an empty string the same as `undefined` — \"no value supplied\". Used\n * to normalise `--password ''` and `MM_WALLET_PASSWORD=''` so they trigger\n * the interactive prompt rather than sending an empty string to the keyring.\n *\n * @param value - The value to normalise.\n * @returns `undefined` if `value` is `undefined` or `''`; `value` otherwise.\n */\nexport function emptyToUndefined(\n  value: string | undefined,\n): string | undefined {\n  return value === '' ? undefined : value;\n}\n\n/**\n * Check whether a value is an array of strings. Used to validate untyped RPC\n * results (e.g. the daemon's `listActions`) before treating them as `string[]`.\n *\n * @param value - The value to check.\n * @returns True if the value is an array whose every element is a string.\n */\nexport function isStringArray(value: unknown): value is string[] {\n  return (\n    Array.isArray(value) && value.every((item) => typeof item === 'string')\n  );\n}\n\n/**\n * Read a PID from a file. The file may contain just the PID, or the PID on\n * the first line followed by additional metadata (e.g. start time written by\n * the daemon).\n *\n * @param pidPath - The PID file path.\n * @returns The PID, or undefined if the file is missing or its first line is\n * not a positive integer.\n */\nexport async function readPidFile(\n  pidPath: string,\n): Promise<number | undefined> {\n  let contents: string;\n  try {\n    contents = await readFile(pidPath, 'utf-8');\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ENOENT')) {\n      return undefined;\n    }\n    throw error;\n  }\n  // String.prototype.split always returns at least one element, so [0] is safe.\n  const pid = Number(contents.split('\\n')[0].trim());\n  return Number.isInteger(pid) && pid > 0 ? pid : undefined;\n}\n\n/**\n * Check whether a process is alive by sending signal 0.\n *\n * Treats `ESRCH` as \"process is gone\", `EPERM` as \"process exists but we\n * cannot signal it\" (still alive from our perspective), and rethrows\n * anything else so the caller can surface unexpected failures rather than\n * silently assuming the process is dead.\n *\n * @param pid - The process ID to check.\n * @returns True if the process exists.\n */\nexport function isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ESRCH')) {\n      return false;\n    }\n    if (isErrorWithCode(error, 'EPERM')) {\n      return true;\n    }\n    throw error;\n  }\n}\n\n/**\n * Send a signal to a process. Returns true if the signal was sent, false if\n * the process does not exist (ESRCH). Re-throws on permission errors and\n * other failures.\n *\n * @param pid - The process ID.\n * @param signal - The signal to send.\n * @returns True if the signal was delivered, false if the process is gone.\n */\nexport function sendSignal(pid: number, signal: NodeJS.Signals): boolean {\n  try {\n    process.kill(pid, signal);\n    return true;\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ESRCH')) {\n      return false;\n    }\n    throw error;\n  }\n}\n\n/**\n * Poll until a condition is met or the timeout elapses.\n *\n * @param check - A function that returns true when the condition is met.\n * @param timeoutMs - Maximum time to wait in milliseconds.\n * @returns True if the condition was met, false on timeout.\n */\nexport async function waitFor(\n  check: () => boolean | Promise<boolean>,\n  timeoutMs: number,\n): Promise<boolean> {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() < deadline) {\n    if (await check()) {\n      return true;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 250));\n  }\n  return false;\n}\n"]}

package/dist/daemon/wallet-factory.cjs

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWallet = void 0;
+const analytics_controller_1 = require("@metamask/analytics-controller");
+const config_registry_controller_1 = require("@metamask/config-registry-controller");
+const messenger_1 = require("@metamask/messenger");
+const remote_feature_flag_controller_1 = require("@metamask/remote-feature-flag-controller");
+const storage_service_1 = require("@metamask/storage-service");
+const wallet_1 = require("@metamask/wallet");
+const promises_1 = require("node:fs/promises");
+const KeyValueStore_js_1 = require("../persistence/KeyValueStore.cjs");
+const persistence_js_1 = require("../persistence/persistence.cjs");
+const auto_approval_js_1 = require("./auto-approval.cjs");
+const IN_MEMORY_DATABASE_PATH = ':memory:';
+/**
+ * Build the per-instance options the daemon's `Wallet` is constructed with.
+ *
+ * Returns a fresh set on every call so the metadata probe and the real wallet
+ * never share adapter/service instances (the probe is destroyed, which may
+ * tear those instances down).
+ *
+ * Only the slots wired on `@metamask/wallet` today are populated:
+ * - `storageService` — backed by an in-memory adapter. This is the wallet's
+ *   large-blob store (snap source, caches), distinct from the SQLite
+ *   `KeyValueStore` that persists controller state; no wired controller
+ *   offloads durable data to it yet, so in-memory suffices.
+ * - `connectivityController` — the `AlwaysOnlineAdapter` exported for
+ *   node-like hosts that have no platform connectivity signal.
+ * - `networkController` — the Infura project ID used to reach Infura RPC
+ *   endpoints.
+ * - `remoteFeatureFlagController` — a `ClientConfigApiService` fetching real
+ *   flags over the network.
+ * - `approvalController` — a no-op `showApprovalRequest` (the daemon is
+ *   headless); pending requests are accepted separately by the auto-approval
+ *   subscription `createWallet` installs, not by this hook.
+ * - `gasFeeController` — only `clientId: 'cli'` (sent as `X-Client-Id` to the
+ *   gas API); the API endpoints, poll interval, and compatibility callbacks are
+ *   left at the wallet package's platform-agnostic defaults (the default
+ *   `EIP1559APIEndpoint` is already the production URL, so the daemon does not
+ *   re-specify it).
+ * - `transactionController` — swaps processing disabled and no client hooks;
+ *   see the slot's inline comment for why the daemon relies on the
+ *   controller's defaults for everything else.
+ *
+ * The optional `keyringController` slot is intentionally omitted so the
+ * controller's built-in defaults (e.g. the PBKDF2 encryptor) apply.
+ *
+ * @param infuraProjectId - The Infura project ID for the `NetworkController`.
+ * @returns The `instanceOptions` for the `Wallet` constructor.
+ */
+function buildInstanceOptions(infuraProjectId) {
+    return {
+        configRegistryApiService: {
+            env: config_registry_controller_1.ConfigRegistryApiEnv.PRD,
+        },
+        approvalController: {
+            // The daemon is headless, so there is no UI to open: requests are
+            // resolved by the auto-approval subscription (see `subscribeToAutoApproval`)
+            // rather than by this hook, which stays a no-op.
+            // TODO: surface approval requests over the daemon transport.
+            showApprovalRequest: () => undefined,
+        },
+        connectivityController: {
+            connectivityAdapter: new wallet_1.AlwaysOnlineAdapter(),
+        },
+        gasFeeController: {
+            // Identifies the CLI to the gas estimation API via the `X-Client-Id`
+            // header.
+            clientId: 'cli',
+        },
+        networkController: {
+            infuraProjectId,
+        },
+        remoteFeatureFlagController: {
+            clientConfigApiService: new remote_feature_flag_controller_1.ClientConfigApiService({
+                fetch: globalThis.fetch,
+                config: {
+                    // TODO: switch to a CLI-specific `ClientType` once one exists; until
+                    // then `Extension` buckets feature flags as an extension client.
+                    client: remote_feature_flag_controller_1.ClientType.Extension,
+                    distribution: remote_feature_flag_controller_1.DistributionType.Main,
+                    environment: remote_feature_flag_controller_1.EnvironmentType.Production,
+                },
+            }),
+            getMetaMetricsId: () => 'cli',
+            clientVersion: '0.0.0',
+        },
+        storageService: {
+            storage: new storage_service_1.InMemoryStorageAdapter(),
+        },
+        transactionController: {
+            // The CLI exposes no swaps surface, so skip the swaps-specific
+            // post-processing a full wallet client runs (mobile makes the same
+            // choice; the extension keeps swaps enabled).
+            disableSwaps: true,
+            // No CLI-specific transaction hooks: the controller's built-in publish
+            // path broadcasts through the wired `NetworkController` provider, and the
+            // remaining hooks (metrics, notifications, gas-fee tokens) are client-UI
+            // concerns the headless daemon has no equivalent for. Every other option
+            // (`getPermittedAccounts`, `isSimulationEnabled`, `trace`, …) is left at
+            // the controller's default.
+            hooks: {},
+        },
+    };
+}
+/**
+ * Register handlers for the `AnalyticsController` actions that
+ * `NetworkController` calls to emit RPC service analytics. The daemon does not
+ * report analytics, so these do nothing: `getState` returns an empty analytics
+ * ID, which stops the controller before it tracks anything, and `trackEvent` is
+ * a no-op. Registering them keeps those messenger calls from throwing.
+ *
+ * @param messenger - The wallet's root messenger.
+ */
+function registerAnalyticsStubHandlers(messenger) {
+    // Register on an `AnalyticsController`-namespaced messenger, not the root: a
+    // messenger can only register handlers for its own namespace, and doing so
+    // delegates them up to the root, where `NetworkController` can reach them.
+    const analyticsMessenger = new messenger_1.Messenger({
+        namespace: 'AnalyticsController',
+        parent: messenger,
+    });
+    analyticsMessenger.registerActionHandler('AnalyticsController:getState', () => ({
+        ...(0, analytics_controller_1.getDefaultAnalyticsControllerState)(),
+        analyticsId: '',
+    }));
+    analyticsMessenger.registerActionHandler('AnalyticsController:trackEvent', () => undefined);
+}
+/**
+ * Create a configured `Wallet` for daemon use, backed by a SQLite key-value
+ * store for controller-state persistence.
+ *
+ * Loads any previously-persisted controller state from the store, seeds the
+ * wallet with it, then subscribes the store to subsequent state changes so all
+ * persist-flagged properties are written through.
+ *
+ * If the store does not yet contain a keyring vault (first run), the supplied
+ * secret recovery phrase is imported using the supplied password. On
+ * subsequent runs, the persisted vault is reused: when a password is
+ * supplied, the wallet is unlocked via `KeyringController:submitPassword` so
+ * keyring-bound messenger actions work immediately; when no password is
+ * supplied, the wallet starts locked and the caller is expected to invoke
+ * `mm wallet unlock` before any keyring-bound operation. First-run startup
+ * without a password is rejected (the SRP cannot be imported without one).
+ * On a subsequent run, a wrong password rejects startup with a `Failed to
+ * unlock the persisted vault` error that wraps the `submitPassword` rejection.
+ *
+ * On any failure after the store is opened, the store is closed (and the wallet
+ * destroyed, if constructed). On a first-run failure, the on-disk database is
+ * also removed so a retry does not latch onto an orphaned partial vault — this
+ * covers in-process failures only; a hard crash (SIGKILL/power loss) mid-import
+ * can still leave a vault on disk.
+ *
+ * @param config - Wallet configuration.
+ * @param config.databasePath - Path to the SQLite database file (or
+ * `':memory:'` for ephemeral use).
+ * @param config.password - The wallet password. Optional on subsequent runs;
+ * when omitted, the daemon starts with a locked keyring. Required on first
+ * run (to import the SRP).
+ * @param config.srp - The secret recovery phrase (BIP-39 mnemonic). Used
+ * only on first run.
+ * @param config.infuraProjectId - The Infura project ID for the
+ * `NetworkController`.
+ * @param config.log - Optional logger for persistence-write and teardown
+ * failures. Without it, failures fall back to `console.error` (which a detached
+ * daemon's `stdio: 'ignore'` discards).
+ * @returns The `Wallet` and a `dispose` handle that tears it down.
+ */
+async function createWallet({ databasePath, password, srp, infuraProjectId, log, }) {
+    const logFn = log ?? ((message) => console.error(message));
+    const store = new KeyValueStore_js_1.KeyValueStore(databasePath);
+    let wallet;
+    let persistenceUnsubscribe;
+    let autoApprovalUnsubscribe;
+    let wasFirstRun = false;
+    try {
+        const state = await loadPersistedState(store, infuraProjectId, logFn);
+        wasFirstRun = !hasPersistedKeyring(state);
+        // Validate the first-run precondition BEFORE constructing the wallet,
+        // so a doomed startup doesn't build a Wallet (and wire persistence
+        // handlers) just to tear it down.
+        if (wasFirstRun && password === undefined) {
+            throw new Error('A password is required on first run to import the secret recovery phrase. ' +
+                'Pass `--password` (or `MM_WALLET_PASSWORD`) on `mm daemon start`.');
+        }
+        wallet = new wallet_1.Wallet({
+            state,
+            instanceOptions: buildInstanceOptions(infuraProjectId),
+        });
+        registerAnalyticsStubHandlers(wallet.messenger);
+        persistenceUnsubscribe = (0, persistence_js_1.subscribeToChanges)(wallet.messenger, wallet.controllerMetadata, store, logFn);
+        // Installed before `init` so any approval raised during initialization is covered.
+        autoApprovalUnsubscribe = (0, auto_approval_js_1.subscribeToAutoApproval)(wallet.messenger, logFn);
+        // Complete post-construction controller setup before serving requests —
+        // e.g. `NetworkController.init` applies the selected network so a provider
+        // is available. `init` settles every step independently; a rejected step
+        // leaves the wallet only partially usable, so abort startup (the catch
+        // below tears down and, on first run, removes the partial database) rather
+        // than serving a degraded daemon.
+        const initResults = await wallet.init();
+        const initFailures = initResults.filter((result) => result.status === 'rejected');
+        for (const failure of initFailures) {
+            logFn(`Wallet init step failed: ${String(failure.reason)}`);
+        }
+        if (initFailures.length > 0) {
+            const firstReason = String(initFailures[0].reason);
+            throw new Error(`Wallet initialization failed (${initFailures.length} step(s)); refusing to serve a partially initialized wallet. First failure: ${firstReason}`);
+        }
+        if (wasFirstRun) {
+            // The precondition check above throws when `wasFirstRun && password ===
+            // undefined`, so `password` is defined here. TS does not correlate the
+            // two separate variables, so it cannot narrow `password` from
+            // `wasFirstRun` alone — hence the assertion.
+            await (0, wallet_1.importSecretRecoveryPhrase)(wallet, password.unwrap(), srp.unwrap());
+        }
+        else if (password !== undefined) {
+            try {
+                await wallet.messenger.call('KeyringController:submitPassword', password.unwrap());
+            }
+            catch (error) {
+                throw new Error(`Failed to unlock the persisted vault: ${String(error)}`);
+            }
+        }
+        let disposePromise;
+        return {
+            wallet,
+            dispose: async () => (disposePromise ?? (disposePromise = teardown(persistenceUnsubscribe, autoApprovalUnsubscribe, wallet, store, logFn))),
+        };
+    }
+    catch (error) {
+        await teardown(persistenceUnsubscribe, autoApprovalUnsubscribe, wallet, store, logFn);
+        if (wasFirstRun && databasePath !== IN_MEMORY_DATABASE_PATH) {
+            // Best-effort cleanup of the on-disk SQLite files (main, WAL, SHM) so a
+            // partially-persisted KeyringController vault cannot mislead the next run
+            // into skipping SRP import. Covers in-process failures only — a crash
+            // (SIGKILL/power loss) mid-import leaves the vault on disk.
+            await Promise.all([databasePath, `${databasePath}-wal`, `${databasePath}-shm`].map((path) => (0, promises_1.rm)(path, { force: true }).catch((rmError) => {
+                logFn(`Failed to remove ${path} during first-run cleanup: ${String(rmError)}`);
+            })));
+        }
+        throw error;
+    }
+}
+exports.createWallet = createWallet;
+/**
+ * Load persisted controller state, filtered to currently persist-flagged
+ * properties.
+ *
+ * `loadState` filters against the live controller metadata, but that metadata
+ * is only knowable from a constructed `Wallet` — and its output is what seeds
+ * the real wallet. So this constructs a short-lived probe purely to read the
+ * metadata, then tears it down.
+ *
+ * TODO: drop the probe once `@metamask/wallet` exposes controller metadata
+ * without constructing a `Wallet`.
+ *
+ * @param store - The key-value store to read from.
+ * @param infuraProjectId - The Infura project ID for the probe's
+ * `NetworkController`.
+ * @param logFn - Logger for a probe-teardown failure.
+ * @returns The filtered persisted state, suitable for the `Wallet` `state`
+ * option.
+ */
+async function loadPersistedState(store, infuraProjectId, logFn) {
+    const probe = new wallet_1.Wallet({
+        instanceOptions: buildInstanceOptions(infuraProjectId),
+    });
+    registerAnalyticsStubHandlers(probe.messenger);
+    try {
+        return (0, persistence_js_1.loadState)(store, probe.controllerMetadata);
+    }
+    finally {
+        await probe.destroy().catch((error) => {
+            logFn(`Metadata probe destroy failed: ${String(error)}`);
+        });
+    }
+}
+/**
+ * Best-effort unsubscribe: run the function if present, logging (and
+ * swallowing) any error so a later teardown step still runs.
+ *
+ * @param unsubscribe - The unsubscribe function, if one was registered.
+ * @param label - Human-readable subscription name for the failure log.
+ * @param logFn - Logger for a failure.
+ */
+function runUnsubscribe(unsubscribe, label, logFn) {
+    if (!unsubscribe) {
+        return;
+    }
+    try {
+        unsubscribe();
+    }
+    catch (error) {
+        logFn(`${label} unsubscribe failed during teardown — subscription may remain ` +
+            `live until the process exits: ${String(error)}`);
+    }
+}
+/**
+ * Persistence-safe teardown of a wallet and its store; see {@link
+ * CreateWalletResult.dispose} for the ordering rationale. Each step is
+ * best-effort, so a failure is logged and the remaining steps still run.
+ *
+ * @param persistenceUnsubscribe - The persistence-subscription unsubscribe
+ * function, if one was registered.
+ * @param autoApprovalUnsubscribe - The auto-approval-subscription unsubscribe
+ * function, if one was registered.
+ * @param wallet - The wallet to destroy, if one was constructed.
+ * @param store - The store to close.
+ * @param logFn - Logger for step failures.
+ */
+async function teardown(persistenceUnsubscribe, autoApprovalUnsubscribe, wallet, store, logFn) {
+    runUnsubscribe(persistenceUnsubscribe, 'Persistence', logFn);
+    runUnsubscribe(autoApprovalUnsubscribe, 'Auto-approval', logFn);
+    if (wallet) {
+        try {
+            await wallet.destroy();
+        }
+        catch (error) {
+            logFn(`wallet.destroy() failed during teardown: ${String(error)}`);
+        }
+    }
+    try {
+        store.close();
+    }
+    catch (error) {
+        logFn(`store.close() failed during teardown: ${String(error)}`);
+    }
+}
+/**
+ * Determine whether the loaded state already contains a keyring vault.
+ *
+ * The KeyringController persists its `vault` once an SRP has been imported, so
+ * its presence indicates that first-run setup completed before.
+ *
+ * @param state - The state loaded from the key-value store.
+ * @returns True if a KeyringController vault string is present.
+ */
+function hasPersistedKeyring(state) {
+    return typeof state.KeyringController?.vault === 'string';
+}
+//# sourceMappingURL=wallet-factory.cjs.map

package/dist/daemon/wallet-factory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-factory.cjs","sourceRoot":"","sources":["../../src/daemon/wallet-factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDefaultAnalyticsControllerState } from '@metamask/analytics-controller';\nimport type {\n  AnalyticsControllerGetStateAction,\n  AnalyticsControllerTrackEventAction,\n} from '@metamask/analytics-controller';\nimport { ConfigRegistryApiEnv } from '@metamask/config-registry-controller';\nimport { Messenger } from '@metamask/messenger';\nimport {\n  ClientConfigApiService,\n  ClientType,\n  DistributionType,\n  EnvironmentType,\n} from '@metamask/remote-feature-flag-controller';\nimport { InMemoryStorageAdapter } from '@metamask/storage-service';\nimport type { Json } from '@metamask/utils';\nimport {\n  AlwaysOnlineAdapter,\n  importSecretRecoveryPhrase,\n  Wallet,\n} from '@metamask/wallet';\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n  WalletOptions,\n} from '@metamask/wallet';\nimport { rm } from 'node:fs/promises';\n\nimport { KeyValueStore } from '../persistence/KeyValueStore.js';\nimport { loadState, subscribeToChanges } from '../persistence/persistence.js';\nimport { subscribeToAutoApproval } from './auto-approval.js';\nimport type { Password, Srp } from './secrets.js';\nimport type { Logger } from './types.js';\n\nconst IN_MEMORY_DATABASE_PATH = ':memory:';\n\nexport type CreateWalletConfig = {\n  databasePath: string;\n  password?: Password;\n  srp: Srp;\n  infuraProjectId: string;\n  log?: Logger;\n};\n\nexport type CreateWalletResult = {\n  wallet: Wallet;\n  /**\n   * Tear down everything `createWallet` set up, in the order that keeps\n   * in-flight persistence writes valid: stop the state-change subscription,\n   * destroy the wallet, then close the store (closing first would cause a\n   * teardown-time persistence write to fail). Resilient — a failure in any\n   * step is logged and the remaining steps still run — and idempotent (repeat\n   * calls coalesce onto the same teardown).\n   */\n  dispose: () => Promise<void>;\n};\n\n/**\n * Build the per-instance options the daemon's `Wallet` is constructed with.\n *\n * Returns a fresh set on every call so the metadata probe and the real wallet\n * never share adapter/service instances (the probe is destroyed, which may\n * tear those instances down).\n *\n * Only the slots wired on `@metamask/wallet` today are populated:\n * - `storageService` — backed by an in-memory adapter. This is the wallet's\n *   large-blob store (snap source, caches), distinct from the SQLite\n *   `KeyValueStore` that persists controller state; no wired controller\n *   offloads durable data to it yet, so in-memory suffices.\n * - `connectivityController` — the `AlwaysOnlineAdapter` exported for\n *   node-like hosts that have no platform connectivity signal.\n * - `networkController` — the Infura project ID used to reach Infura RPC\n *   endpoints.\n * - `remoteFeatureFlagController` — a `ClientConfigApiService` fetching real\n *   flags over the network.\n * - `approvalController` — a no-op `showApprovalRequest` (the daemon is\n *   headless); pending requests are accepted separately by the auto-approval\n *   subscription `createWallet` installs, not by this hook.\n * - `gasFeeController` — only `clientId: 'cli'` (sent as `X-Client-Id` to the\n *   gas API); the API endpoints, poll interval, and compatibility callbacks are\n *   left at the wallet package's platform-agnostic defaults (the default\n *   `EIP1559APIEndpoint` is already the production URL, so the daemon does not\n *   re-specify it).\n * - `transactionController` — swaps processing disabled and no client hooks;\n *   see the slot's inline comment for why the daemon relies on the\n *   controller's defaults for everything else.\n *\n * The optional `keyringController` slot is intentionally omitted so the\n * controller's built-in defaults (e.g. the PBKDF2 encryptor) apply.\n *\n * @param infuraProjectId - The Infura project ID for the `NetworkController`.\n * @returns The `instanceOptions` for the `Wallet` constructor.\n */\nfunction buildInstanceOptions(\n  infuraProjectId: string,\n): WalletOptions['instanceOptions'] {\n  return {\n    configRegistryApiService: {\n      env: ConfigRegistryApiEnv.PRD,\n    },\n    approvalController: {\n      // The daemon is headless, so there is no UI to open: requests are\n      // resolved by the auto-approval subscription (see `subscribeToAutoApproval`)\n      // rather than by this hook, which stays a no-op.\n      // TODO: surface approval requests over the daemon transport.\n      showApprovalRequest: (): undefined => undefined,\n    },\n    connectivityController: {\n      connectivityAdapter: new AlwaysOnlineAdapter(),\n    },\n    gasFeeController: {\n      // Identifies the CLI to the gas estimation API via the `X-Client-Id`\n      // header.\n      clientId: 'cli',\n    },\n    networkController: {\n      infuraProjectId,\n    },\n    remoteFeatureFlagController: {\n      clientConfigApiService: new ClientConfigApiService({\n        fetch: globalThis.fetch,\n        config: {\n          // TODO: switch to a CLI-specific `ClientType` once one exists; until\n          // then `Extension` buckets feature flags as an extension client.\n          client: ClientType.Extension,\n          distribution: DistributionType.Main,\n          environment: EnvironmentType.Production,\n        },\n      }),\n      getMetaMetricsId: (): string => 'cli',\n      clientVersion: '0.0.0',\n    },\n    storageService: {\n      storage: new InMemoryStorageAdapter(),\n    },\n    transactionController: {\n      // The CLI exposes no swaps surface, so skip the swaps-specific\n      // post-processing a full wallet client runs (mobile makes the same\n      // choice; the extension keeps swaps enabled).\n      disableSwaps: true,\n      // No CLI-specific transaction hooks: the controller's built-in publish\n      // path broadcasts through the wired `NetworkController` provider, and the\n      // remaining hooks (metrics, notifications, gas-fee tokens) are client-UI\n      // concerns the headless daemon has no equivalent for. Every other option\n      // (`getPermittedAccounts`, `isSimulationEnabled`, `trace`, …) is left at\n      // the controller's default.\n      hooks: {},\n    },\n  };\n}\n\n/**\n * Register handlers for the `AnalyticsController` actions that\n * `NetworkController` calls to emit RPC service analytics. The daemon does not\n * report analytics, so these do nothing: `getState` returns an empty analytics\n * ID, which stops the controller before it tracks anything, and `trackEvent` is\n * a no-op. Registering them keeps those messenger calls from throwing.\n *\n * @param messenger - The wallet's root messenger.\n */\nfunction registerAnalyticsStubHandlers(messenger: Wallet['messenger']): void {\n  // Register on an `AnalyticsController`-namespaced messenger, not the root: a\n  // messenger can only register handlers for its own namespace, and doing so\n  // delegates them up to the root, where `NetworkController` can reach them.\n  const analyticsMessenger = new Messenger<\n    'AnalyticsController',\n    AnalyticsControllerGetStateAction | AnalyticsControllerTrackEventAction,\n    never,\n    RootMessenger<DefaultActions, DefaultEvents>\n  >({\n    namespace: 'AnalyticsController',\n    parent: messenger as RootMessenger<DefaultActions, DefaultEvents>,\n  });\n  analyticsMessenger.registerActionHandler(\n    'AnalyticsController:getState',\n    () => ({\n      ...getDefaultAnalyticsControllerState(),\n      analyticsId: '',\n    }),\n  );\n  analyticsMessenger.registerActionHandler(\n    'AnalyticsController:trackEvent',\n    () => undefined,\n  );\n}\n\n/**\n * Create a configured `Wallet` for daemon use, backed by a SQLite key-value\n * store for controller-state persistence.\n *\n * Loads any previously-persisted controller state from the store, seeds the\n * wallet with it, then subscribes the store to subsequent state changes so all\n * persist-flagged properties are written through.\n *\n * If the store does not yet contain a keyring vault (first run), the supplied\n * secret recovery phrase is imported using the supplied password. On\n * subsequent runs, the persisted vault is reused: when a password is\n * supplied, the wallet is unlocked via `KeyringController:submitPassword` so\n * keyring-bound messenger actions work immediately; when no password is\n * supplied, the wallet starts locked and the caller is expected to invoke\n * `mm wallet unlock` before any keyring-bound operation. First-run startup\n * without a password is rejected (the SRP cannot be imported without one).\n * On a subsequent run, a wrong password rejects startup with a `Failed to\n * unlock the persisted vault` error that wraps the `submitPassword` rejection.\n *\n * On any failure after the store is opened, the store is closed (and the wallet\n * destroyed, if constructed). On a first-run failure, the on-disk database is\n * also removed so a retry does not latch onto an orphaned partial vault — this\n * covers in-process failures only; a hard crash (SIGKILL/power loss) mid-import\n * can still leave a vault on disk.\n *\n * @param config - Wallet configuration.\n * @param config.databasePath - Path to the SQLite database file (or\n * `':memory:'` for ephemeral use).\n * @param config.password - The wallet password. Optional on subsequent runs;\n * when omitted, the daemon starts with a locked keyring. Required on first\n * run (to import the SRP).\n * @param config.srp - The secret recovery phrase (BIP-39 mnemonic). Used\n * only on first run.\n * @param config.infuraProjectId - The Infura project ID for the\n * `NetworkController`.\n * @param config.log - Optional logger for persistence-write and teardown\n * failures. Without it, failures fall back to `console.error` (which a detached\n * daemon's `stdio: 'ignore'` discards).\n * @returns The `Wallet` and a `dispose` handle that tears it down.\n */\nexport async function createWallet({\n  databasePath,\n  password,\n  srp,\n  infuraProjectId,\n  log,\n}: CreateWalletConfig): Promise<CreateWalletResult> {\n  const logFn = log ?? ((message: string): void => console.error(message));\n  const store = new KeyValueStore(databasePath);\n  let wallet: Wallet | undefined;\n  let persistenceUnsubscribe: (() => void) | undefined;\n  let autoApprovalUnsubscribe: (() => void) | undefined;\n  let wasFirstRun = false;\n\n  try {\n    const state = await loadPersistedState(store, infuraProjectId, logFn);\n    wasFirstRun = !hasPersistedKeyring(state);\n\n    // Validate the first-run precondition BEFORE constructing the wallet,\n    // so a doomed startup doesn't build a Wallet (and wire persistence\n    // handlers) just to tear it down.\n    if (wasFirstRun && password === undefined) {\n      throw new Error(\n        'A password is required on first run to import the secret recovery phrase. ' +\n          'Pass `--password` (or `MM_WALLET_PASSWORD`) on `mm daemon start`.',\n      );\n    }\n\n    wallet = new Wallet({\n      state,\n      instanceOptions: buildInstanceOptions(infuraProjectId),\n    });\n    registerAnalyticsStubHandlers(wallet.messenger);\n    persistenceUnsubscribe = subscribeToChanges(\n      wallet.messenger,\n      wallet.controllerMetadata,\n      store,\n      logFn,\n    );\n\n    // Installed before `init` so any approval raised during initialization is covered.\n    autoApprovalUnsubscribe = subscribeToAutoApproval(wallet.messenger, logFn);\n\n    // Complete post-construction controller setup before serving requests —\n    // e.g. `NetworkController.init` applies the selected network so a provider\n    // is available. `init` settles every step independently; a rejected step\n    // leaves the wallet only partially usable, so abort startup (the catch\n    // below tears down and, on first run, removes the partial database) rather\n    // than serving a degraded daemon.\n    const initResults = await wallet.init();\n    const initFailures = initResults.filter(\n      (result): result is PromiseRejectedResult => result.status === 'rejected',\n    );\n    for (const failure of initFailures) {\n      logFn(`Wallet init step failed: ${String(failure.reason)}`);\n    }\n    if (initFailures.length > 0) {\n      const firstReason = String(initFailures[0].reason);\n      throw new Error(\n        `Wallet initialization failed (${initFailures.length} step(s)); refusing to serve a partially initialized wallet. First failure: ${firstReason}`,\n      );\n    }\n\n    if (wasFirstRun) {\n      // The precondition check above throws when `wasFirstRun && password ===\n      // undefined`, so `password` is defined here. TS does not correlate the\n      // two separate variables, so it cannot narrow `password` from\n      // `wasFirstRun` alone — hence the assertion.\n      await importSecretRecoveryPhrase(\n        wallet,\n        (password as Password).unwrap(),\n        srp.unwrap(),\n      );\n    } else if (password !== undefined) {\n      try {\n        await wallet.messenger.call(\n          'KeyringController:submitPassword',\n          password.unwrap(),\n        );\n      } catch (error) {\n        throw new Error(\n          `Failed to unlock the persisted vault: ${String(error)}`,\n        );\n      }\n    }\n\n    let disposePromise: Promise<void> | undefined;\n    return {\n      wallet,\n      dispose: async () =>\n        (disposePromise ??= teardown(\n          persistenceUnsubscribe,\n          autoApprovalUnsubscribe,\n          wallet,\n          store,\n          logFn,\n        )),\n    };\n  } catch (error) {\n    await teardown(\n      persistenceUnsubscribe,\n      autoApprovalUnsubscribe,\n      wallet,\n      store,\n      logFn,\n    );\n\n    if (wasFirstRun && databasePath !== IN_MEMORY_DATABASE_PATH) {\n      // Best-effort cleanup of the on-disk SQLite files (main, WAL, SHM) so a\n      // partially-persisted KeyringController vault cannot mislead the next run\n      // into skipping SRP import. Covers in-process failures only — a crash\n      // (SIGKILL/power loss) mid-import leaves the vault on disk.\n      await Promise.all(\n        [databasePath, `${databasePath}-wal`, `${databasePath}-shm`].map(\n          (path) =>\n            rm(path, { force: true }).catch((rmError: unknown) => {\n              logFn(\n                `Failed to remove ${path} during first-run cleanup: ${String(rmError)}`,\n              );\n            }),\n        ),\n      );\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Load persisted controller state, filtered to currently persist-flagged\n * properties.\n *\n * `loadState` filters against the live controller metadata, but that metadata\n * is only knowable from a constructed `Wallet` — and its output is what seeds\n * the real wallet. So this constructs a short-lived probe purely to read the\n * metadata, then tears it down.\n *\n * TODO: drop the probe once `@metamask/wallet` exposes controller metadata\n * without constructing a `Wallet`.\n *\n * @param store - The key-value store to read from.\n * @param infuraProjectId - The Infura project ID for the probe's\n * `NetworkController`.\n * @param logFn - Logger for a probe-teardown failure.\n * @returns The filtered persisted state, suitable for the `Wallet` `state`\n * option.\n */\nasync function loadPersistedState(\n  store: KeyValueStore,\n  infuraProjectId: string,\n  logFn: Logger,\n): Promise<Record<string, Record<string, Json>>> {\n  const probe = new Wallet({\n    instanceOptions: buildInstanceOptions(infuraProjectId),\n  });\n  registerAnalyticsStubHandlers(probe.messenger);\n  try {\n    return loadState(store, probe.controllerMetadata);\n  } finally {\n    await probe.destroy().catch((error: unknown) => {\n      logFn(`Metadata probe destroy failed: ${String(error)}`);\n    });\n  }\n}\n\n/**\n * Best-effort unsubscribe: run the function if present, logging (and\n * swallowing) any error so a later teardown step still runs.\n *\n * @param unsubscribe - The unsubscribe function, if one was registered.\n * @param label - Human-readable subscription name for the failure log.\n * @param logFn - Logger for a failure.\n */\nfunction runUnsubscribe(\n  unsubscribe: (() => void) | undefined,\n  label: string,\n  logFn: Logger,\n): void {\n  if (!unsubscribe) {\n    return;\n  }\n  try {\n    unsubscribe();\n  } catch (error) {\n    logFn(\n      `${label} unsubscribe failed during teardown — subscription may remain ` +\n        `live until the process exits: ${String(error)}`,\n    );\n  }\n}\n\n/**\n * Persistence-safe teardown of a wallet and its store; see {@link\n * CreateWalletResult.dispose} for the ordering rationale. Each step is\n * best-effort, so a failure is logged and the remaining steps still run.\n *\n * @param persistenceUnsubscribe - The persistence-subscription unsubscribe\n * function, if one was registered.\n * @param autoApprovalUnsubscribe - The auto-approval-subscription unsubscribe\n * function, if one was registered.\n * @param wallet - The wallet to destroy, if one was constructed.\n * @param store - The store to close.\n * @param logFn - Logger for step failures.\n */\nasync function teardown(\n  persistenceUnsubscribe: (() => void) | undefined,\n  autoApprovalUnsubscribe: (() => void) | undefined,\n  wallet: Wallet | undefined,\n  store: KeyValueStore,\n  logFn: Logger,\n): Promise<void> {\n  runUnsubscribe(persistenceUnsubscribe, 'Persistence', logFn);\n  runUnsubscribe(autoApprovalUnsubscribe, 'Auto-approval', logFn);\n  if (wallet) {\n    try {\n      await wallet.destroy();\n    } catch (error) {\n      logFn(`wallet.destroy() failed during teardown: ${String(error)}`);\n    }\n  }\n  try {\n    store.close();\n  } catch (error) {\n    logFn(`store.close() failed during teardown: ${String(error)}`);\n  }\n}\n\n/**\n * Determine whether the loaded state already contains a keyring vault.\n *\n * The KeyringController persists its `vault` once an SRP has been imported, so\n * its presence indicates that first-run setup completed before.\n *\n * @param state - The state loaded from the key-value store.\n * @returns True if a KeyringController vault string is present.\n */\nfunction hasPersistedKeyring(\n  state: Record<string, Record<string, unknown>>,\n): boolean {\n  return typeof state.KeyringController?.vault === 'string';\n}\n"]}

package/dist/daemon/{wallet-factory.d.ts → wallet-factory.d.cts}

@@ -1,6 +1,6 @@
-import { Wallet } from '@metamask/wallet';
-import type { Password, Srp } from './secrets.js';
-import type { Logger } from './types.js';
+import { Wallet } from "@metamask/wallet";
+import type { Password, Srp } from "./secrets.cjs";
+import type { Logger } from "./types.cjs";
 export type CreateWalletConfig = {
     databasePath: string;
     password?: Password;
@@ -61,4 +61,4 @@ export type CreateWalletResult = {
  * @returns The `Wallet` and a `dispose` handle that tears it down.
  */
 export declare function createWallet({ databasePath, password, srp, infuraProjectId, log, }: CreateWalletConfig): Promise<CreateWalletResult>;
-//# sourceMappingURL=wallet-factory.d.ts.map
+//# sourceMappingURL=wallet-factory.d.cts.map

package/dist/daemon/wallet-factory.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-factory.d.cts","sourceRoot":"","sources":["../../src/daemon/wallet-factory.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,MAAM,EACP,yBAAyB;AAY1B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAqB;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAmB;AAIzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,GAAG,CAAC;IACT,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAmIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,YAAY,CAAC,EACjC,YAAY,EACZ,QAAQ,EACR,GAAG,EACH,eAAe,EACf,GAAG,GACJ,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwHlD"}

package/dist/daemon/wallet-factory.d.mts

@@ -0,0 +1,64 @@
+import { Wallet } from "@metamask/wallet";
+import type { Password, Srp } from "./secrets.mjs";
+import type { Logger } from "./types.mjs";
+export type CreateWalletConfig = {
+    databasePath: string;
+    password?: Password;
+    srp: Srp;
+    infuraProjectId: string;
+    log?: Logger;
+};
+export type CreateWalletResult = {
+    wallet: Wallet;
+    /**
+     * Tear down everything `createWallet` set up, in the order that keeps
+     * in-flight persistence writes valid: stop the state-change subscription,
+     * destroy the wallet, then close the store (closing first would cause a
+     * teardown-time persistence write to fail). Resilient — a failure in any
+     * step is logged and the remaining steps still run — and idempotent (repeat
+     * calls coalesce onto the same teardown).
+     */
+    dispose: () => Promise<void>;
+};
+/**
+ * Create a configured `Wallet` for daemon use, backed by a SQLite key-value
+ * store for controller-state persistence.
+ *
+ * Loads any previously-persisted controller state from the store, seeds the
+ * wallet with it, then subscribes the store to subsequent state changes so all
+ * persist-flagged properties are written through.
+ *
+ * If the store does not yet contain a keyring vault (first run), the supplied
+ * secret recovery phrase is imported using the supplied password. On
+ * subsequent runs, the persisted vault is reused: when a password is
+ * supplied, the wallet is unlocked via `KeyringController:submitPassword` so
+ * keyring-bound messenger actions work immediately; when no password is
+ * supplied, the wallet starts locked and the caller is expected to invoke
+ * `mm wallet unlock` before any keyring-bound operation. First-run startup
+ * without a password is rejected (the SRP cannot be imported without one).
+ * On a subsequent run, a wrong password rejects startup with a `Failed to
+ * unlock the persisted vault` error that wraps the `submitPassword` rejection.
+ *
+ * On any failure after the store is opened, the store is closed (and the wallet
+ * destroyed, if constructed). On a first-run failure, the on-disk database is
+ * also removed so a retry does not latch onto an orphaned partial vault — this
+ * covers in-process failures only; a hard crash (SIGKILL/power loss) mid-import
+ * can still leave a vault on disk.
+ *
+ * @param config - Wallet configuration.
+ * @param config.databasePath - Path to the SQLite database file (or
+ * `':memory:'` for ephemeral use).
+ * @param config.password - The wallet password. Optional on subsequent runs;
+ * when omitted, the daemon starts with a locked keyring. Required on first
+ * run (to import the SRP).
+ * @param config.srp - The secret recovery phrase (BIP-39 mnemonic). Used
+ * only on first run.
+ * @param config.infuraProjectId - The Infura project ID for the
+ * `NetworkController`.
+ * @param config.log - Optional logger for persistence-write and teardown
+ * failures. Without it, failures fall back to `console.error` (which a detached
+ * daemon's `stdio: 'ignore'` discards).
+ * @returns The `Wallet` and a `dispose` handle that tears it down.
+ */
+export declare function createWallet({ databasePath, password, srp, infuraProjectId, log, }: CreateWalletConfig): Promise<CreateWalletResult>;
+//# sourceMappingURL=wallet-factory.d.mts.map

package/dist/daemon/wallet-factory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-factory.d.mts","sourceRoot":"","sources":["../../src/daemon/wallet-factory.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,MAAM,EACP,yBAAyB;AAY1B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAqB;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAmB;AAIzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,GAAG,CAAC;IACT,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAmIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,YAAY,CAAC,EACjC,YAAY,EACZ,QAAQ,EACR,GAAG,EACH,eAAe,EACf,GAAG,GACJ,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwHlD"}