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

package/dist/daemon/secrets.cjs

@@ -1,137 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _Password_value, _Srp_value;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Srp = exports.Password = void 0;
-const scure_bip39_1 = require("@metamask/scure-bip39");
-const english_1 = require("@metamask/scure-bip39/dist/wordlists/english.js");
-const REDACTED = '[redacted]';
-const VALID_SRP_WORD_COUNTS = [12, 15, 18, 21, 24];
-const INSPECT_CUSTOM = Symbol.for('nodejs.util.inspect.custom');
-const WORDLIST_SET = new Set(english_1.wordlist);
-/**
- * Opaque wrapper around a wallet password.
- *
- * Constructed via {@link Password.from}, which validates the input. The
- * underlying string is only reachable through {@link Password.unwrap}; every
- * other path (`toString`, `JSON.stringify`, `util.inspect`, template-literal
- * interpolation) yields `[redacted]`. This makes accidental logging produce a
- * harmless placeholder instead of leaking the secret.
- */
-class Password {
-    // See .from() for why this is private.
-    // eslint-disable-next-line no-restricted-syntax
-    constructor(value) {
-        _Password_value.set(this, void 0);
-        __classPrivateFieldSet(this, _Password_value, value, "f");
-    }
-    /**
-     * Wrap a non-empty string as a {@link Password}.
-     *
-     * Matches the `@metamask/keyring-controller` convention: any non-empty
-     * string is acceptable; minimum-length policy is left to the keyring.
-     *
-     * @param value - The raw password string.
-     * @returns A redacting {@link Password} wrapper.
-     * @throws If `value` is empty.
-     */
-    static from(value) {
-        if (value.length === 0) {
-            throw new Error('Password must be a non-empty string');
-        }
-        return new Password(value);
-    }
-    /**
-     * Reveal the underlying password string. Call this only at trust boundaries
-     * (e.g. handing the value to the keyring or to a child-process env var).
-     *
-     * @returns The original password string.
-     */
-    unwrap() {
-        return __classPrivateFieldGet(this, _Password_value, "f");
-    }
-    toString() {
-        return REDACTED;
-    }
-    toJSON() {
-        return REDACTED;
-    }
-    [(_Password_value = new WeakMap(), INSPECT_CUSTOM)]() {
-        return REDACTED;
-    }
-}
-exports.Password = Password;
-/**
- * Opaque wrapper around a BIP-39 secret recovery phrase.
- *
- * Constructed via {@link Srp.from}, which validates the word count
- * (12/15/18/21/24) and that every word is present in the BIP-39 English
- * wordlist. The underlying string is only reachable through {@link Srp.unwrap};
- * every other path yields `[redacted]`.
- */
-class Srp {
-    // See .from() for why this is private.
-    // eslint-disable-next-line no-restricted-syntax
-    constructor(value) {
-        _Srp_value.set(this, void 0);
-        __classPrivateFieldSet(this, _Srp_value, value, "f");
-    }
-    /**
-     * Validate and wrap a BIP-39 mnemonic phrase.
-     *
-     * Whitespace is normalized (trimmed and collapsed) before validation so that
-     * copy-pasted phrases with accidental leading/trailing/extra spaces are
-     * accepted. Catching malformed input here (rather than letting it reach
-     * `KeyringController:createNewVaultAndRestore`) produces a clearer error.
-     *
-     * @param value - The raw mnemonic string.
-     * @returns A redacting {@link Srp} wrapper containing the normalized phrase.
-     * @throws If the word count is not one of 12/15/18/21/24, if any word is
-     * not present in the BIP-39 English wordlist, or if the checksum is invalid.
-     */
-    static from(value) {
-        const words = value.trim().split(/\s+/u);
-        if (!VALID_SRP_WORD_COUNTS.includes(words.length)) {
-            throw new Error(`Secret recovery phrase must be 12, 15, 18, 21, or 24 words (got ${words.length})`);
-        }
-        for (const word of words) {
-            if (!WORDLIST_SET.has(word)) {
-                throw new Error('Secret recovery phrase contains a word not in the BIP-39 English wordlist');
-            }
-        }
-        const normalized = words.join(' ');
-        if (!(0, scure_bip39_1.validateMnemonic)(normalized, english_1.wordlist)) {
-            throw new Error('Secret recovery phrase has an invalid checksum');
-        }
-        return new Srp(normalized);
-    }
-    /**
-     * Reveal the underlying mnemonic string. Call this only at trust boundaries.
-     *
-     * @returns The original mnemonic string.
-     */
-    unwrap() {
-        return __classPrivateFieldGet(this, _Srp_value, "f");
-    }
-    toString() {
-        return REDACTED;
-    }
-    toJSON() {
-        return REDACTED;
-    }
-    [(_Srp_value = new WeakMap(), INSPECT_CUSTOM)]() {
-        return REDACTED;
-    }
-}
-exports.Srp = Srp;
-//# sourceMappingURL=secrets.cjs.map

package/dist/daemon/secrets.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"secrets.cjs","sourceRoot":"","sources":["../../src/daemon/secrets.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,uDAAyD;AACzD,6EAAwE;AAExE,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,qBAAqB,GAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAEhE,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,kBAAQ,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAa,QAAQ;IAGnB,uCAAuC;IACvC,gDAAgD;IAChD,YAAoB,KAAa;QAJxB,kCAAe;QAKtB,uBAAA,IAAI,mBAAU,KAAK,MAAA,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO,uBAAA,IAAI,uBAAO,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mCAAC,cAAc,EAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA/CD,4BA+CC;AAED;;;;;;;GAOG;AACH,MAAa,GAAG;IAGd,uCAAuC;IACvC,gDAAgD;IAChD,YAAoB,KAAa;QAJxB,6BAAe;QAKtB,uBAAA,IAAI,cAAU,KAAK,MAAA,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,mEAAmE,KAAK,CAAC,MAAM,GAAG,CACnF,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,IAAA,8BAAgB,EAAC,UAAU,EAAE,kBAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,uBAAA,IAAI,kBAAO,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8BAAC,cAAc,EAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAhED,kBAgEC","sourcesContent":["import { validateMnemonic } from '@metamask/scure-bip39';\nimport { wordlist } from '@metamask/scure-bip39/dist/wordlists/english';\n\nconst REDACTED = '[redacted]';\n\nconst VALID_SRP_WORD_COUNTS: readonly number[] = [12, 15, 18, 21, 24];\n\nconst INSPECT_CUSTOM = Symbol.for('nodejs.util.inspect.custom');\n\nconst WORDLIST_SET: ReadonlySet<string> = new Set(wordlist);\n\n/**\n * Opaque wrapper around a wallet password.\n *\n * Constructed via {@link Password.from}, which validates the input. The\n * underlying string is only reachable through {@link Password.unwrap}; every\n * other path (`toString`, `JSON.stringify`, `util.inspect`, template-literal\n * interpolation) yields `[redacted]`. This makes accidental logging produce a\n * harmless placeholder instead of leaking the secret.\n */\nexport class Password {\n  readonly #value: string;\n\n  // See .from() for why this is private.\n  // eslint-disable-next-line no-restricted-syntax\n  private constructor(value: string) {\n    this.#value = value;\n  }\n\n  /**\n   * Wrap a non-empty string as a {@link Password}.\n   *\n   * Matches the `@metamask/keyring-controller` convention: any non-empty\n   * string is acceptable; minimum-length policy is left to the keyring.\n   *\n   * @param value - The raw password string.\n   * @returns A redacting {@link Password} wrapper.\n   * @throws If `value` is empty.\n   */\n  static from(value: string): Password {\n    if (value.length === 0) {\n      throw new Error('Password must be a non-empty string');\n    }\n    return new Password(value);\n  }\n\n  /**\n   * Reveal the underlying password string. Call this only at trust boundaries\n   * (e.g. handing the value to the keyring or to a child-process env var).\n   *\n   * @returns The original password string.\n   */\n  unwrap(): string {\n    return this.#value;\n  }\n\n  toString(): string {\n    return REDACTED;\n  }\n\n  toJSON(): string {\n    return REDACTED;\n  }\n\n  [INSPECT_CUSTOM](): string {\n    return REDACTED;\n  }\n}\n\n/**\n * Opaque wrapper around a BIP-39 secret recovery phrase.\n *\n * Constructed via {@link Srp.from}, which validates the word count\n * (12/15/18/21/24) and that every word is present in the BIP-39 English\n * wordlist. The underlying string is only reachable through {@link Srp.unwrap};\n * every other path yields `[redacted]`.\n */\nexport class Srp {\n  readonly #value: string;\n\n  // See .from() for why this is private.\n  // eslint-disable-next-line no-restricted-syntax\n  private constructor(value: string) {\n    this.#value = value;\n  }\n\n  /**\n   * Validate and wrap a BIP-39 mnemonic phrase.\n   *\n   * Whitespace is normalized (trimmed and collapsed) before validation so that\n   * copy-pasted phrases with accidental leading/trailing/extra spaces are\n   * accepted. Catching malformed input here (rather than letting it reach\n   * `KeyringController:createNewVaultAndRestore`) produces a clearer error.\n   *\n   * @param value - The raw mnemonic string.\n   * @returns A redacting {@link Srp} wrapper containing the normalized phrase.\n   * @throws If the word count is not one of 12/15/18/21/24, if any word is\n   * not present in the BIP-39 English wordlist, or if the checksum is invalid.\n   */\n  static from(value: string): Srp {\n    const words = value.trim().split(/\\s+/u);\n    if (!VALID_SRP_WORD_COUNTS.includes(words.length)) {\n      throw new Error(\n        `Secret recovery phrase must be 12, 15, 18, 21, or 24 words (got ${words.length})`,\n      );\n    }\n    for (const word of words) {\n      if (!WORDLIST_SET.has(word)) {\n        throw new Error(\n          'Secret recovery phrase contains a word not in the BIP-39 English wordlist',\n        );\n      }\n    }\n\n    const normalized = words.join(' ');\n    if (!validateMnemonic(normalized, wordlist)) {\n      throw new Error('Secret recovery phrase has an invalid checksum');\n    }\n    return new Srp(normalized);\n  }\n\n  /**\n   * Reveal the underlying mnemonic string. Call this only at trust boundaries.\n   *\n   * @returns The original mnemonic string.\n   */\n  unwrap(): string {\n    return this.#value;\n  }\n\n  toString(): string {\n    return REDACTED;\n  }\n\n  toJSON(): string {\n    return REDACTED;\n  }\n\n  [INSPECT_CUSTOM](): string {\n    return REDACTED;\n  }\n}\n"]}

package/dist/daemon/secrets.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"secrets.d.cts","sourceRoot":"","sources":["../../src/daemon/secrets.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,cAAc,eAA2C,CAAC;AAIhE;;;;;;;;GAQG;AACH,qBAAa,QAAQ;;IAKnB,OAAO;IAIP;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAOpC;;;;;OAKG;IACH,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,CAAC,cAAc,CAAC,IAAI,MAAM;CAG3B;AAED;;;;;;;GAOG;AACH,qBAAa,GAAG;;IAKd,OAAO;IAIP;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAsB/B;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,CAAC,cAAc,CAAC,IAAI,MAAM;CAG3B"}

package/dist/daemon/secrets.d.mts

@@ -1,72 +0,0 @@
-declare const INSPECT_CUSTOM: unique symbol;
-/**
- * Opaque wrapper around a wallet password.
- *
- * Constructed via {@link Password.from}, which validates the input. The
- * underlying string is only reachable through {@link Password.unwrap}; every
- * other path (`toString`, `JSON.stringify`, `util.inspect`, template-literal
- * interpolation) yields `[redacted]`. This makes accidental logging produce a
- * harmless placeholder instead of leaking the secret.
- */
-export declare class Password {
-    #private;
-    private constructor();
-    /**
-     * Wrap a non-empty string as a {@link Password}.
-     *
-     * Matches the `@metamask/keyring-controller` convention: any non-empty
-     * string is acceptable; minimum-length policy is left to the keyring.
-     *
-     * @param value - The raw password string.
-     * @returns A redacting {@link Password} wrapper.
-     * @throws If `value` is empty.
-     */
-    static from(value: string): Password;
-    /**
-     * Reveal the underlying password string. Call this only at trust boundaries
-     * (e.g. handing the value to the keyring or to a child-process env var).
-     *
-     * @returns The original password string.
-     */
-    unwrap(): string;
-    toString(): string;
-    toJSON(): string;
-    [INSPECT_CUSTOM](): string;
-}
-/**
- * Opaque wrapper around a BIP-39 secret recovery phrase.
- *
- * Constructed via {@link Srp.from}, which validates the word count
- * (12/15/18/21/24) and that every word is present in the BIP-39 English
- * wordlist. The underlying string is only reachable through {@link Srp.unwrap};
- * every other path yields `[redacted]`.
- */
-export declare class Srp {
-    #private;
-    private constructor();
-    /**
-     * Validate and wrap a BIP-39 mnemonic phrase.
-     *
-     * Whitespace is normalized (trimmed and collapsed) before validation so that
-     * copy-pasted phrases with accidental leading/trailing/extra spaces are
-     * accepted. Catching malformed input here (rather than letting it reach
-     * `KeyringController:createNewVaultAndRestore`) produces a clearer error.
-     *
-     * @param value - The raw mnemonic string.
-     * @returns A redacting {@link Srp} wrapper containing the normalized phrase.
-     * @throws If the word count is not one of 12/15/18/21/24, if any word is
-     * not present in the BIP-39 English wordlist, or if the checksum is invalid.
-     */
-    static from(value: string): Srp;
-    /**
-     * Reveal the underlying mnemonic string. Call this only at trust boundaries.
-     *
-     * @returns The original mnemonic string.
-     */
-    unwrap(): string;
-    toString(): string;
-    toJSON(): string;
-    [INSPECT_CUSTOM](): string;
-}
-export {};
-//# sourceMappingURL=secrets.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"secrets.d.mts","sourceRoot":"","sources":["../../src/daemon/secrets.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,cAAc,eAA2C,CAAC;AAIhE;;;;;;;;GAQG;AACH,qBAAa,QAAQ;;IAKnB,OAAO;IAIP;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAOpC;;;;;OAKG;IACH,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,CAAC,cAAc,CAAC,IAAI,MAAM;CAG3B;AAED;;;;;;;GAOG;AACH,qBAAa,GAAG;;IAKd,OAAO;IAIP;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAsB/B;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,CAAC,cAAc,CAAC,IAAI,MAAM;CAG3B"}

package/dist/daemon/secrets.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"secrets.mjs","sourceRoot":"","sources":["../../src/daemon/secrets.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA8B;AACzD,OAAO,EAAE,QAAQ,EAAE,wDAAqD;AAExE,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,qBAAqB,GAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAEhE,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAQ;IAGnB,uCAAuC;IACvC,gDAAgD;IAChD,YAAoB,KAAa;QAJxB,kCAAe;QAKtB,uBAAA,IAAI,mBAAU,KAAK,MAAA,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO,uBAAA,IAAI,uBAAO,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mCAAC,cAAc,EAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,GAAG;IAGd,uCAAuC;IACvC,gDAAgD;IAChD,YAAoB,KAAa;QAJxB,6BAAe;QAKtB,uBAAA,IAAI,cAAU,KAAK,MAAA,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,mEAAmE,KAAK,CAAC,MAAM,GAAG,CACnF,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,uBAAA,IAAI,kBAAO,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8BAAC,cAAc,EAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF","sourcesContent":["import { validateMnemonic } from '@metamask/scure-bip39';\nimport { wordlist } from '@metamask/scure-bip39/dist/wordlists/english';\n\nconst REDACTED = '[redacted]';\n\nconst VALID_SRP_WORD_COUNTS: readonly number[] = [12, 15, 18, 21, 24];\n\nconst INSPECT_CUSTOM = Symbol.for('nodejs.util.inspect.custom');\n\nconst WORDLIST_SET: ReadonlySet<string> = new Set(wordlist);\n\n/**\n * Opaque wrapper around a wallet password.\n *\n * Constructed via {@link Password.from}, which validates the input. The\n * underlying string is only reachable through {@link Password.unwrap}; every\n * other path (`toString`, `JSON.stringify`, `util.inspect`, template-literal\n * interpolation) yields `[redacted]`. This makes accidental logging produce a\n * harmless placeholder instead of leaking the secret.\n */\nexport class Password {\n  readonly #value: string;\n\n  // See .from() for why this is private.\n  // eslint-disable-next-line no-restricted-syntax\n  private constructor(value: string) {\n    this.#value = value;\n  }\n\n  /**\n   * Wrap a non-empty string as a {@link Password}.\n   *\n   * Matches the `@metamask/keyring-controller` convention: any non-empty\n   * string is acceptable; minimum-length policy is left to the keyring.\n   *\n   * @param value - The raw password string.\n   * @returns A redacting {@link Password} wrapper.\n   * @throws If `value` is empty.\n   */\n  static from(value: string): Password {\n    if (value.length === 0) {\n      throw new Error('Password must be a non-empty string');\n    }\n    return new Password(value);\n  }\n\n  /**\n   * Reveal the underlying password string. Call this only at trust boundaries\n   * (e.g. handing the value to the keyring or to a child-process env var).\n   *\n   * @returns The original password string.\n   */\n  unwrap(): string {\n    return this.#value;\n  }\n\n  toString(): string {\n    return REDACTED;\n  }\n\n  toJSON(): string {\n    return REDACTED;\n  }\n\n  [INSPECT_CUSTOM](): string {\n    return REDACTED;\n  }\n}\n\n/**\n * Opaque wrapper around a BIP-39 secret recovery phrase.\n *\n * Constructed via {@link Srp.from}, which validates the word count\n * (12/15/18/21/24) and that every word is present in the BIP-39 English\n * wordlist. The underlying string is only reachable through {@link Srp.unwrap};\n * every other path yields `[redacted]`.\n */\nexport class Srp {\n  readonly #value: string;\n\n  // See .from() for why this is private.\n  // eslint-disable-next-line no-restricted-syntax\n  private constructor(value: string) {\n    this.#value = value;\n  }\n\n  /**\n   * Validate and wrap a BIP-39 mnemonic phrase.\n   *\n   * Whitespace is normalized (trimmed and collapsed) before validation so that\n   * copy-pasted phrases with accidental leading/trailing/extra spaces are\n   * accepted. Catching malformed input here (rather than letting it reach\n   * `KeyringController:createNewVaultAndRestore`) produces a clearer error.\n   *\n   * @param value - The raw mnemonic string.\n   * @returns A redacting {@link Srp} wrapper containing the normalized phrase.\n   * @throws If the word count is not one of 12/15/18/21/24, if any word is\n   * not present in the BIP-39 English wordlist, or if the checksum is invalid.\n   */\n  static from(value: string): Srp {\n    const words = value.trim().split(/\\s+/u);\n    if (!VALID_SRP_WORD_COUNTS.includes(words.length)) {\n      throw new Error(\n        `Secret recovery phrase must be 12, 15, 18, 21, or 24 words (got ${words.length})`,\n      );\n    }\n    for (const word of words) {\n      if (!WORDLIST_SET.has(word)) {\n        throw new Error(\n          'Secret recovery phrase contains a word not in the BIP-39 English wordlist',\n        );\n      }\n    }\n\n    const normalized = words.join(' ');\n    if (!validateMnemonic(normalized, wordlist)) {\n      throw new Error('Secret recovery phrase has an invalid checksum');\n    }\n    return new Srp(normalized);\n  }\n\n  /**\n   * Reveal the underlying mnemonic string. Call this only at trust boundaries.\n   *\n   * @returns The original mnemonic string.\n   */\n  unwrap(): string {\n    return this.#value;\n  }\n\n  toString(): string {\n    return REDACTED;\n  }\n\n  toJSON(): string {\n    return REDACTED;\n  }\n\n  [INSPECT_CUSTOM](): string {\n    return REDACTED;\n  }\n}\n"]}

package/dist/daemon/send-transaction.cjs

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

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

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

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

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

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

@@ -1 +0,0 @@
-{"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.mjs.map

@@ -1 +0,0 @@
-{"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"]}