@bitgo/wasm-utxo 1.29.0 → 1.30.0

package/dist/cjs/js/bip32.d.ts

@@ -62,6 +62,14 @@ export declare class BIP32 implements BIP32Interface {
      * @returns A BIP32 instance
      */
     static fromSeed(seed: Uint8Array, network?: string | null): BIP32;
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString: string, network?: string | null): BIP32;
     /**
      * Get the chain code as a Uint8Array
      */

package/dist/cjs/js/bip32.js

@@ -63,6 +63,17 @@ class BIP32 {
         const wasm = wasm_utxo_js_1.WasmBIP32.from_seed(seed, network);
         return new BIP32(wasm);
     }
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString, network) {
+        const wasm = wasm_utxo_js_1.WasmBIP32.from_seed_sha256(seedString, network);
+        return new BIP32(wasm);
+    }
     /**
      * Get the chain code as a Uint8Array
      */

package/dist/cjs/js/index.d.ts

@@ -6,6 +6,7 @@ export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as bip32 from "./bip32.js";
 export * as ecpair from "./ecpair.js";
+export * as testutils from "./testutils/index.js";
 export { ECPair } from "./ecpair.js";
 export { BIP32 } from "./bip32.js";
 export { Dimensions } from "./fixedScriptWallet/Dimensions.js";
@@ -44,3 +45,4 @@ export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { hasPsbtMagic } from "./psbt.js";

package/dist/cjs/js/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
+exports.hasPsbtMagic = exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.testutils = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
 const wasm = __importStar(require("./wasm/wasm_utxo.js"));
 // we need to access the wasm module here, otherwise webpack gets all weird
 // and forgets to include it in the bundle
@@ -48,6 +48,7 @@ exports.utxolibCompat = __importStar(require("./utxolibCompat.js"));
 exports.fixedScriptWallet = __importStar(require("./fixedScriptWallet/index.js"));
 exports.bip32 = __importStar(require("./bip32.js"));
 exports.ecpair = __importStar(require("./ecpair.js"));
+exports.testutils = __importStar(require("./testutils/index.js"));
 // Only the most commonly used classes and types are exported at the top level for convenience
 var ecpair_js_1 = require("./ecpair.js");
 Object.defineProperty(exports, "ECPair", { enumerable: true, get: function () { return ecpair_js_1.ECPair; } });
@@ -65,3 +66,5 @@ var transaction_js_1 = require("./transaction.js");
 Object.defineProperty(exports, "DashTransaction", { enumerable: true, get: function () { return transaction_js_1.DashTransaction; } });
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_js_1.Transaction; } });
 Object.defineProperty(exports, "ZcashTransaction", { enumerable: true, get: function () { return transaction_js_1.ZcashTransaction; } });
+var psbt_js_1 = require("./psbt.js");
+Object.defineProperty(exports, "hasPsbtMagic", { enumerable: true, get: function () { return psbt_js_1.hasPsbtMagic; } });

package/dist/cjs/js/psbt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+export declare function hasPsbtMagic(bytes: Uint8Array): boolean;

package/dist/cjs/js/psbt.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasPsbtMagic = hasPsbtMagic;
+/** PSBT magic bytes: "psbt" (0x70 0x73 0x62 0x74) followed by separator 0xff */
+const PSBT_MAGIC = new Uint8Array([0x70, 0x73, 0x62, 0x74, 0xff]);
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+function hasPsbtMagic(bytes) {
+    if (bytes.length < PSBT_MAGIC.length) {
+        return false;
+    }
+    for (let i = 0; i < PSBT_MAGIC.length; i++) {
+        if (bytes[i] !== PSBT_MAGIC[i]) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/cjs/js/testutils/keys.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getKey = getKey;
 exports.getKeyTriple = getKeyTriple;
@@ -39,7 +6,6 @@ exports.getWalletKeysForSeed = getWalletKeysForSeed;
 exports.getDefaultWalletKeys = getDefaultWalletKeys;
 exports.getKeyName = getKeyName;
 exports.getDefaultCosigner = getDefaultCosigner;
-const crypto = __importStar(require("crypto"));
 const bip32_js_1 = require("../bip32.js");
 const RootWalletKeys_js_1 = require("../fixedScriptWallet/RootWalletKeys.js");
 /**
@@ -56,7 +22,7 @@ const RootWalletKeys_js_1 = require("../fixedScriptWallet/RootWalletKeys.js");
  * ```
  */
 function getKey(seed) {
-    return bip32_js_1.BIP32.fromSeed(crypto.createHash("sha256").update(seed).digest());
+    return bip32_js_1.BIP32.fromSeedSha256(seed);
 }
 /**
  * Generate a triple of BIP32 keys for a 2-of-3 multisig wallet.

package/dist/cjs/js/wasm/wasm_utxo.d.ts

@@ -772,6 +772,11 @@ export class WasmBIP32 {
    * Derive a hardened child key (only works for private keys)
    */
   derive_hardened(index: number): WasmBIP32;
+  /**
+   * Create a BIP32 master key from a string by hashing it with SHA256.
+   * This is useful for deterministic test key generation.
+   */
+  static from_seed_sha256(seed_string: string, network?: string | null): WasmBIP32;
   /**
    * Create a BIP32 key from a BIP32Interface JavaScript object properties
    * Expects an object with: network.bip32.public, depth, parentFingerprint,

package/dist/cjs/js/wasm/wasm_utxo.js

@@ -2357,6 +2357,32 @@ class WasmBIP32 {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * This is useful for deterministic test key generation.
+     * @param {string} seed_string
+     * @param {string | null} [network]
+     * @returns {WasmBIP32}
+     */
+    static from_seed_sha256(seed_string, network) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(seed_string, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            var ptr1 = isLikeNone(network) ? 0 : passStringToWasm0(network, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.wasmbip32_from_seed_sha256(retptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return WasmBIP32.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Get the parent fingerprint
      * @returns {number}

package/dist/cjs/js/wasm/wasm_utxo_bg.wasm.d.ts

@@ -113,6 +113,7 @@ export const wasmbip32_fingerprint: (a: number) => number;
 export const wasmbip32_from_base58: (a: number, b: number, c: number) => void;
 export const wasmbip32_from_bip32_interface: (a: number, b: number) => void;
 export const wasmbip32_from_seed: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmbip32_from_seed_sha256: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmbip32_from_xprv: (a: number, b: number, c: number) => void;
 export const wasmbip32_from_xpub: (a: number, b: number, c: number) => void;
 export const wasmbip32_identifier: (a: number) => number;

package/dist/esm/js/bip32.d.ts

@@ -62,6 +62,14 @@ export declare class BIP32 implements BIP32Interface {
      * @returns A BIP32 instance
      */
     static fromSeed(seed: Uint8Array, network?: string | null): BIP32;
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString: string, network?: string | null): BIP32;
     /**
      * Get the chain code as a Uint8Array
      */

package/dist/esm/js/bip32.js

@@ -59,6 +59,17 @@ export class BIP32 {
         const wasm = WasmBIP32.from_seed(seed, network);
         return new BIP32(wasm);
     }
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString, network) {
+        const wasm = WasmBIP32.from_seed_sha256(seedString, network);
+        return new BIP32(wasm);
+    }
     /**
      * Get the chain code as a Uint8Array
      */

package/dist/esm/js/index.d.ts

@@ -6,6 +6,7 @@ export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as bip32 from "./bip32.js";
 export * as ecpair from "./ecpair.js";
+export * as testutils from "./testutils/index.js";
 export { ECPair } from "./ecpair.js";
 export { BIP32 } from "./bip32.js";
 export { Dimensions } from "./fixedScriptWallet/Dimensions.js";
@@ -44,3 +45,4 @@ export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { hasPsbtMagic } from "./psbt.js";

package/dist/esm/js/index.js

@@ -12,6 +12,7 @@ export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as bip32 from "./bip32.js";
 export * as ecpair from "./ecpair.js";
+export * as testutils from "./testutils/index.js";
 // Only the most commonly used classes and types are exported at the top level for convenience
 export { ECPair } from "./ecpair.js";
 export { BIP32 } from "./bip32.js";
@@ -20,3 +21,4 @@ export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { hasPsbtMagic } from "./psbt.js";

package/dist/esm/js/psbt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+export declare function hasPsbtMagic(bytes: Uint8Array): boolean;

package/dist/esm/js/psbt.js

@@ -0,0 +1,31 @@
+/** PSBT magic bytes: "psbt" (0x70 0x73 0x62 0x74) followed by separator 0xff */
+const PSBT_MAGIC = new Uint8Array([0x70, 0x73, 0x62, 0x74, 0xff]);
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+export function hasPsbtMagic(bytes) {
+    if (bytes.length < PSBT_MAGIC.length) {
+        return false;
+    }
+    for (let i = 0; i < PSBT_MAGIC.length; i++) {
+        if (bytes[i] !== PSBT_MAGIC[i]) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/esm/js/testutils/keys.js

@@ -1,4 +1,3 @@
-import * as crypto from "crypto";
 import { BIP32 } from "../bip32.js";
 import { RootWalletKeys } from "../fixedScriptWallet/RootWalletKeys.js";
 /**
@@ -15,7 +14,7 @@ import { RootWalletKeys } from "../fixedScriptWallet/RootWalletKeys.js";
  * ```
  */
 export function getKey(seed) {
-    return BIP32.fromSeed(crypto.createHash("sha256").update(seed).digest());
+    return BIP32.fromSeedSha256(seed);
 }
 /**
  * Generate a triple of BIP32 keys for a 2-of-3 multisig wallet.

package/dist/esm/js/wasm/wasm_utxo.d.ts

@@ -772,6 +772,11 @@ export class WasmBIP32 {
    * Derive a hardened child key (only works for private keys)
    */
   derive_hardened(index: number): WasmBIP32;
+  /**
+   * Create a BIP32 master key from a string by hashing it with SHA256.
+   * This is useful for deterministic test key generation.
+   */
+  static from_seed_sha256(seed_string: string, network?: string | null): WasmBIP32;
   /**
    * Create a BIP32 key from a BIP32Interface JavaScript object properties
    * Expects an object with: network.bip32.public, depth, parentFingerprint,

package/dist/esm/js/wasm/wasm_utxo_bg.js

@@ -2360,6 +2360,32 @@ export class WasmBIP32 {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * This is useful for deterministic test key generation.
+     * @param {string} seed_string
+     * @param {string | null} [network]
+     * @returns {WasmBIP32}
+     */
+    static from_seed_sha256(seed_string, network) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(seed_string, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            var ptr1 = isLikeNone(network) ? 0 : passStringToWasm0(network, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.wasmbip32_from_seed_sha256(retptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return WasmBIP32.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Get the parent fingerprint
      * @returns {number}

package/dist/esm/js/wasm/wasm_utxo_bg.wasm.d.ts

@@ -113,6 +113,7 @@ export const wasmbip32_fingerprint: (a: number) => number;
 export const wasmbip32_from_base58: (a: number, b: number, c: number) => void;
 export const wasmbip32_from_bip32_interface: (a: number, b: number) => void;
 export const wasmbip32_from_seed: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmbip32_from_seed_sha256: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmbip32_from_xprv: (a: number, b: number, c: number) => void;
 export const wasmbip32_from_xpub: (a: number, b: number, c: number) => void;
 export const wasmbip32_identifier: (a: number) => number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitgo/wasm-utxo",
   "description": "WebAssembly wrapper for rust-bitcoin (beta)",
-  "version": "1.29.0",
+  "version": "1.30.0",
   "type": "module",
   "repository": {
     "type": "git",