@btc-vision/transaction 1.8.0-beta.3 → 1.8.0-beta.5

package/build/keypair/MessageSigner.js

@@ -1,23 +1,25 @@
-import * as ecc from '@bitcoinerlab/secp256k1';
-import { crypto, toXOnly } from '@btc-vision/bitcoin';
+import {} from '@btc-vision/ecpair';
+import { backend } from '../ecc/backend.js';
+import { crypto, fromHex, toHex, toXOnly } from '@btc-vision/bitcoin';
 import { TweakedSigner } from '../signer/TweakedSigner.js';
 import { EcKeyPair } from './EcKeyPair.js';
+import { MLDSASecurityLevel } from '@btc-vision/bip32';
 import { isOPWallet } from '../transaction/browser/types/OPWallet.js';
 class MessageSignerBase {
     sha256(message) {
-        return crypto.sha256(Buffer.from(message));
+        return crypto.sha256(message);
     }
     async trySignSchnorrWithOPWallet(message) {
         const wallet = this.getOPWallet();
         if (!wallet) {
             return null;
         }
-        const messageBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : Buffer.from(message);
+        const messageBuffer = typeof message === 'string' ? new TextEncoder().encode(message) : message;
         const hashedMessage = this.sha256(messageBuffer);
-        const messageHex = hashedMessage.toString('hex');
+        const messageHex = toHex(hashedMessage);
         const signatureHex = await wallet.web3.signSchnorr(messageHex);
         return {
-            signature: Buffer.from(signatureHex, 'hex'),
+            signature: fromHex(signatureHex),
             message: hashedMessage,
         };
     }
@@ -26,14 +28,14 @@ class MessageSignerBase {
         if (!wallet) {
             return null;
         }
-        const messageBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : Buffer.from(message);
+        const messageBuffer = typeof message === 'string' ? new TextEncoder().encode(message) : message;
         const hashedMessage = this.sha256(messageBuffer);
-        const messageHex = hashedMessage.toString('hex');
+        const messageHex = toHex(hashedMessage);
         const result = await wallet.web3.signMLDSAMessage(messageHex);
         return {
-            signature: Buffer.from(result.signature, 'hex'),
+            signature: fromHex(result.signature),
             message: hashedMessage,
-            publicKey: Buffer.from(result.publicKey, 'hex'),
+            publicKey: fromHex(result.publicKey),
             securityLevel: result.securityLevel,
         };
     }
@@ -75,15 +77,15 @@ class MessageSignerBase {
         if (!wallet) {
             return null;
         }
-        const messageBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : Buffer.from(message);
+        const messageBuffer = typeof message === 'string' ? new TextEncoder().encode(message) : message;
         const hashedMessage = this.sha256(messageBuffer);
         const mldsaSignature = {
-            signature: Buffer.from(signature.signature).toString('hex'),
-            publicKey: Buffer.from(signature.publicKey).toString('hex'),
+            signature: toHex(signature.signature),
+            publicKey: toHex(signature.publicKey),
             securityLevel: signature.securityLevel,
-            messageHash: hashedMessage.toString('hex'),
+            messageHash: toHex(hashedMessage),
         };
-        return wallet.web3.verifyMLDSASignature(hashedMessage.toString('hex'), mldsaSignature);
+        return wallet.web3.verifyMLDSASignature(toHex(hashedMessage), mldsaSignature);
     }
     async getMLDSAPublicKeyFromOPWallet() {
         const wallet = this.getOPWallet();
@@ -91,7 +93,7 @@ class MessageSignerBase {
             return null;
         }
         const publicKeyHex = await wallet.web3.getMLDSAPublicKey();
-        return Buffer.from(publicKeyHex, 'hex');
+        return fromHex(publicKeyHex);
     }
     tweakAndSignMessage(keypair, message, network) {
         const tweaked = TweakedSigner.tweakSigner(keypair, { network });
@@ -99,34 +101,40 @@ class MessageSignerBase {
     }
     signMessage(keypair, message) {
         if (typeof message === 'string') {
-            message = Buffer.from(message, 'utf-8');
+            message = new TextEncoder().encode(message);
         }
         if (!keypair.privateKey) {
             throw new Error('Private key not found in keypair.');
         }
         const hashedMessage = this.sha256(message);
+        if (!backend.signSchnorr) {
+            throw new Error('backend.signSchnorr is not available.');
+        }
         return {
-            signature: ecc.signSchnorr(hashedMessage, keypair.privateKey),
+            signature: backend.signSchnorr(hashedMessage, keypair.privateKey),
             message: hashedMessage,
         };
     }
     verifySignature(publicKey, message, signature) {
         if (typeof message === 'string') {
-            message = Buffer.from(message, 'utf-8');
+            message = new TextEncoder().encode(message);
         }
         if (signature.length !== 64) {
             throw new Error('Invalid signature length.');
         }
         const hashedMessage = this.sha256(message);
-        return ecc.verifySchnorr(hashedMessage, toXOnly(Buffer.from(publicKey)), signature);
+        if (!backend.verifySchnorr) {
+            throw new Error('backend.verifySchnorr is not available.');
+        }
+        return backend.verifySchnorr(hashedMessage, toXOnly(publicKey), signature);
     }
     tweakAndVerifySignature(publicKey, message, signature) {
-        const tweakedPublicKey = EcKeyPair.tweakPublicKey(Buffer.from(publicKey));
+        const tweakedPublicKey = EcKeyPair.tweakPublicKey(publicKey);
         return this.verifySignature(tweakedPublicKey, message, signature);
     }
     signMLDSAMessage(mldsaKeypair, message) {
         if (typeof message === 'string') {
-            message = Buffer.from(message, 'utf-8');
+            message = new TextEncoder().encode(message);
         }
         if (!mldsaKeypair.privateKey) {
             throw new Error('ML-DSA private key not found in keypair.');
@@ -134,15 +142,15 @@ class MessageSignerBase {
         const hashedMessage = this.sha256(message);
         const signature = mldsaKeypair.sign(hashedMessage);
         return {
-            signature: Buffer.from(signature),
+            signature: new Uint8Array(signature),
             message: hashedMessage,
-            publicKey: Buffer.from(mldsaKeypair.publicKey),
+            publicKey: new Uint8Array(mldsaKeypair.publicKey),
             securityLevel: mldsaKeypair.securityLevel,
         };
     }
     verifyMLDSASignature(mldsaKeypair, message, signature) {
         if (typeof message === 'string') {
-            message = Buffer.from(message, 'utf-8');
+            message = new TextEncoder().encode(message);
         }
         const hashedMessage = this.sha256(message);
         return mldsaKeypair.verify(hashedMessage, signature);
@@ -162,3 +170,4 @@ class MessageSignerBase {
     }
 }
 export const MessageSigner = new MessageSignerBase();
+//# sourceMappingURL=MessageSigner.js.map

package/build/keypair/MessageSigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageSigner.js","sourceRoot":"","sources":["../../src/keypair/MessageSigner.ts"],"names":[],"mappings":"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"}

package/build/keypair/Secp256k1PointDeriver.d.ts

@@ -1,16 +1,71 @@
 export declare class Secp256k1PointDeriver {
+    /**
+     * The maximum increments to try before giving up on deriving a valid x.
+     */
     private maxTries;
     constructor(maxTries?: number);
+    /**
+     * Main entry point.
+     * Given a 32-byte input, ensures we obtain a "real" x on secp256k1.
+     * - If the given x is valid, we use it.
+     * - Otherwise, we increment x (mod p) until we find one whose (x^3 + 7) is a quadratic residue.
+     * Then we return { x, y1, y2 } for that valid point.
+     *
+     * @param xBytes A 32-byte Uint8Array for the candidate x
+     * @param failOnInvalidX (optional) whether to throw if the given x is not a valid curve point, defaults to true
+     * @param maxTries (optional) number of increments to attempt, defaults to this.maxTries
+     * @returns An object { x: bigint; y1: bigint; y2: bigint } describing a valid curve point
+     * @throws If no valid x found within maxTries
+     */
     findOrDeriveValidPoint(xBytes: Uint8Array, failOnInvalidX?: boolean, maxTries?: number): {
         x: bigint;
         y1: bigint;
         y2: bigint;
     };
+    /**
+     * Given two candidate y values, returns the one with the smaller y-coordinate.
+     * @param {bigint} y
+     * @param {bigint} y2
+     */
     getCanonicalY(y: bigint, y2: bigint): bigint;
+    /**
+     * Creates a 65-byte "hybrid public key" from the specified x and y.
+     * - First byte:
+     *   - 0x06 if y is even
+     *   - 0x07 if y is odd
+     * - Next 32 bytes: x
+     * - Last 32 bytes: y
+     *
+     * @param x X-coordinate as a bigint
+     * @param y Y-coordinate as a bigint
+     * @returns A Uint8Array of length 65
+     */
     getHybridPublicKey(x: bigint, y: bigint): Uint8Array;
+    /**
+     * Checks if (x^3 + 7) is a quadratic residue mod p.
+     * Returns the square root if it is, or null if not.
+     */
     private isValidX;
+    /**
+     * Computes base^exp (mod m) using exponentiation by squaring.
+     */
     private modPow;
+    /**
+     * sqrtModP(a, p):
+     *   Attempts to compute the square root of `a` modulo prime `p`.
+     *   Returns the root if it exists, or null if `a` is not a quadratic residue.
+     *
+     * Since p ≡ 3 (mod 4), we can do:
+     *   sqrt(a) = a^((p+1)/4) mod p
+     */
     private sqrtModP;
+    /**
+     * Convert a 32-byte Uint8Array (big-endian) to a BigInt.
+     */
     private bytesToBigInt;
+    /**
+     * Convert a BigInt to a 32-byte array (big-endian).
+     */
     private bigIntTo32Bytes;
 }
+//# sourceMappingURL=Secp256k1PointDeriver.d.ts.map

package/build/keypair/Secp256k1PointDeriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secp256k1PointDeriver.d.ts","sourceRoot":"","sources":["../../src/keypair/Secp256k1PointDeriver.ts"],"names":[],"mappings":"AAEA,qBAAa,qBAAqB;IAC9B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAQ;IAI5B;;;;;;;;;;;;OAYG;IACI,sBAAsB,CACzB,MAAM,EAAE,UAAU,EAClB,cAAc,GAAE,OAAc,EAC9B,QAAQ,GAAE,MAAsB,GACjC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAiCxC;;;;OAIG;IACI,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAInD;;;;;;;;;;;OAWG;IACI,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IAiB3D;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACH,OAAO,CAAC,MAAM;IAed;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAWhB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAQ1B"}

package/build/keypair/Secp256k1PointDeriver.js

@@ -1,13 +1,32 @@
 const P = 0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffefffffc2fn;
 export class Secp256k1PointDeriver {
+    /**
+     * The maximum increments to try before giving up on deriving a valid x.
+     */
+    maxTries;
     constructor(maxTries = 10000) {
         this.maxTries = maxTries;
     }
+    /**
+     * Main entry point.
+     * Given a 32-byte input, ensures we obtain a "real" x on secp256k1.
+     * - If the given x is valid, we use it.
+     * - Otherwise, we increment x (mod p) until we find one whose (x^3 + 7) is a quadratic residue.
+     * Then we return { x, y1, y2 } for that valid point.
+     *
+     * @param xBytes A 32-byte Uint8Array for the candidate x
+     * @param failOnInvalidX (optional) whether to throw if the given x is not a valid curve point, defaults to true
+     * @param maxTries (optional) number of increments to attempt, defaults to this.maxTries
+     * @returns An object { x: bigint; y1: bigint; y2: bigint } describing a valid curve point
+     * @throws If no valid x found within maxTries
+     */
     findOrDeriveValidPoint(xBytes, failOnInvalidX = true, maxTries = this.maxTries) {
         if (xBytes.length !== 32) {
             throw new Error('xBytes must be exactly 32 bytes.');
         }
+        // Convert input to a BigInt in [0, p-1]
         let xCandidate = this.bytesToBigInt(xBytes) % P;
+        // 2. Loop up to maxTries to find a valid x
         let sqrtVal = this.isValidX(xCandidate);
         if (failOnInvalidX && sqrtVal === null) {
             throw new Error(`The given x is not a valid curve point.`);
@@ -21,27 +40,57 @@ export class Secp256k1PointDeriver {
                 throw new Error(`Could not find a valid X point within ${maxTries} increments.`);
             }
         }
+        // Now, sqrtVal is a valid 'r' for alpha = x^3 + 7
+        // The two roots for y are: r and p-r
         const y1 = sqrtVal;
         const y2 = (P - y1) % P;
         return { x: xCandidate, y1, y2 };
     }
+    /**
+     * Given two candidate y values, returns the one with the smaller y-coordinate.
+     * @param {bigint} y
+     * @param {bigint} y2
+     */
     getCanonicalY(y, y2) {
         return y < y2 ? y : y2;
     }
+    /**
+     * Creates a 65-byte "hybrid public key" from the specified x and y.
+     * - First byte:
+     *   - 0x06 if y is even
+     *   - 0x07 if y is odd
+     * - Next 32 bytes: x
+     * - Last 32 bytes: y
+     *
+     * @param x X-coordinate as a bigint
+     * @param y Y-coordinate as a bigint
+     * @returns A Uint8Array of length 65
+     */
     getHybridPublicKey(x, y) {
+        // Determine prefix based on parity of y
         const prefix = y % 2n === 0n ? 0x06 : 0x07;
+        // Convert x and y to 32-byte big-endian arrays
         const xBytes = this.bigIntTo32Bytes(x);
         const yBytes = this.bigIntTo32Bytes(y);
+        // Allocate 65 bytes: 1 for prefix + 32 for x + 32 for y
         const hybrid = new Uint8Array(65);
         hybrid[0] = prefix;
         hybrid.set(xBytes, 1);
         hybrid.set(yBytes, 33);
         return hybrid;
     }
+    /**
+     * Checks if (x^3 + 7) is a quadratic residue mod p.
+     * Returns the square root if it is, or null if not.
+     */
     isValidX(x) {
+        // alpha = (x^3 + 7) mod p
         const alpha = (this.modPow(x, 3n, P) + 7n) % P;
         return this.sqrtModP(alpha, P);
     }
+    /**
+     * Computes base^exp (mod m) using exponentiation by squaring.
+     */
     modPow(base, exp, m) {
         let result = 1n;
         let cur = base % m;
@@ -55,13 +104,26 @@ export class Secp256k1PointDeriver {
         }
         return result;
     }
+    /**
+     * sqrtModP(a, p):
+     *   Attempts to compute the square root of `a` modulo prime `p`.
+     *   Returns the root if it exists, or null if `a` is not a quadratic residue.
+     *
+     * Since p ≡ 3 (mod 4), we can do:
+     *   sqrt(a) = a^((p+1)/4) mod p
+     */
     sqrtModP(a, prime) {
+        // Candidate root
         const root = this.modPow(a, (prime + 1n) >> 2n, prime);
+        // Check if it's truly a root
         if ((root * root) % prime !== a % prime) {
             return null;
         }
         return root;
     }
+    /**
+     * Convert a 32-byte Uint8Array (big-endian) to a BigInt.
+     */
     bytesToBigInt(bytes) {
         let b = 0n;
         for (const byte of bytes) {
@@ -69,6 +131,9 @@ export class Secp256k1PointDeriver {
         }
         return b;
     }
+    /**
+     * Convert a BigInt to a 32-byte array (big-endian).
+     */
     bigIntTo32Bytes(value) {
         const bytes = new Uint8Array(32);
         for (let i = 31; i >= 0; i--) {
@@ -78,3 +143,4 @@ export class Secp256k1PointDeriver {
         return bytes;
     }
 }
+//# sourceMappingURL=Secp256k1PointDeriver.js.map

package/build/keypair/Secp256k1PointDeriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secp256k1PointDeriver.js","sourceRoot":"","sources":["../../src/keypair/Secp256k1PointDeriver.ts"],"names":[],"mappings":"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"}

package/build/keypair/Wallet.d.ts

@@ -1,9 +1,12 @@
-import { ECPairInterface } from 'ecpair';
-import { Network } from '@btc-vision/bitcoin';
+import { type UniversalSigner } from '@btc-vision/ecpair';
+import { type Network } from '@btc-vision/bitcoin';
 import { Address } from './Address.js';
-import { IP2WSHAddress } from '../transaction/mineable/IP2WSHAddress.js';
-import { MLDSASecurityLevel, QuantumBIP32Interface } from '@btc-vision/bip32';
-export declare class Wallet {
+import type { IP2WSHAddress } from '../transaction/mineable/IP2WSHAddress.js';
+import { MLDSASecurityLevel, type QuantumBIP32Interface } from '@btc-vision/bip32';
+/**
+ * Wallet class for managing both classical and quantum-resistant keys
+ */
+export declare class Wallet implements Disposable {
     readonly network: Network;
     private readonly _keypair;
     private readonly _mldsaKeypair;
@@ -17,31 +20,42 @@ export declare class Wallet {
     private readonly _bufferPubKey;
     private readonly _tweakedKey;
     private readonly _address;
-    constructor(privateKeyOrWif: string, mldsaPrivateKeyOrBase58: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Buffer);
+    constructor(privateKeyOrWif: string, mldsaPrivateKeyOrBase58: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Uint8Array);
     get address(): Address;
-    get tweakedPubKeyKey(): Buffer;
-    get keypair(): ECPairInterface;
+    get tweakedPubKeyKey(): Uint8Array;
+    get keypair(): UniversalSigner;
     get mldsaKeypair(): QuantumBIP32Interface;
     get securityLevel(): MLDSASecurityLevel;
-    get chainCode(): Buffer;
+    get chainCode(): Uint8Array;
     get p2wpkh(): string;
     get p2tr(): string;
     get p2wda(): IP2WSHAddress;
     get legacy(): string;
     get addresses(): string[];
     get segwitLegacy(): string;
-    get publicKey(): Buffer;
-    get quantumPublicKey(): Buffer;
-    get quantumPrivateKey(): Buffer;
+    get publicKey(): Uint8Array;
+    get quantumPublicKey(): Uint8Array;
+    get quantumPrivateKey(): Uint8Array;
     get quantumPublicKeyHex(): string;
     get quantumPrivateKeyHex(): string;
-    get xOnly(): Buffer;
-    static fromWif(wif: string, quantumPrivateKeyHex: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Buffer): Wallet;
+    get xOnly(): Uint8Array;
+    static fromWif(wif: string, quantumPrivateKeyHex: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Uint8Array): Wallet;
     static generate(network?: Network, securityLevel?: MLDSASecurityLevel): Wallet;
-    static fromPrivateKeys(privateKeyHexOrWif: string, mldsaPrivateKeyOrBase58: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Buffer): Wallet;
+    static fromPrivateKeys(privateKeyHexOrWif: string, mldsaPrivateKeyOrBase58: string, network?: Network, securityLevel?: MLDSASecurityLevel, chainCode?: Uint8Array): Wallet;
     toWIF(): string;
     toPrivateKeyHex(): string;
     toPublicKeyHex(): string;
     toQuantumBase58(): string;
+    /**
+     * Best-effort zeroing of private key material held by this wallet.
+     *
+     * Zeros classical and quantum private key buffers and the chain code in-place.
+     * This cannot guarantee all copies are erased (the JS runtime may have copied
+     * buffers internally, and string representations cannot be zeroed), but it
+     * eliminates the primary references.
+     */
+    zeroize(): void;
+    [Symbol.dispose](): void;
     derivePath(path: string): Wallet;
 }
+//# sourceMappingURL=Wallet.d.ts.map

package/build/keypair/Wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.d.ts","sourceRoot":"","sources":["../../src/keypair/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAEH,KAAK,OAAO,EAKf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAEH,kBAAkB,EAElB,KAAK,qBAAqB,EAC7B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,MAAO,YAAW,UAAU;aAiBjB,OAAO,EAAE,OAAO;IAhBpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAG/B,eAAe,EAAE,MAAM,EACvB,uBAAuB,EAAE,MAAM,EACf,OAAO,GAAE,OAA0B,EACnD,aAAa,GAAE,kBAA8C,EAC7D,SAAS,CAAC,EAAE,UAAU;IAoE1B,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,gBAAgB,IAAI,UAAU,CAExC;IAED,IAAW,OAAO,IAAI,eAAe,CAGpC;IAED,IAAW,YAAY,IAAI,qBAAqB,CAE/C;IAED,IAAW,aAAa,IAAI,kBAAkB,CAE7C;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,KAAK,IAAI,aAAa,CAEhC;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,SAAS,IAAI,MAAM,EAAE,CAE/B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,SAAS,IAAI,UAAU,CAGjC;IAED,IAAW,gBAAgB,IAAI,UAAU,CAExC;IAED,IAAW,iBAAiB,IAAI,UAAU,CAMzC;IAED,IAAW,mBAAmB,IAAI,MAAM,CAEvC;IAED,IAAW,oBAAoB,IAAI,MAAM,CAMxC;IAED,IAAW,KAAK,IAAI,UAAU,CAG7B;WAEa,OAAO,CACjB,GAAG,EAAE,MAAM,EACX,oBAAoB,EAAE,MAAM,EAC5B,OAAO,GAAE,OAA0B,EACnC,aAAa,GAAE,kBAA8C,EAC7D,SAAS,CAAC,EAAE,UAAU,GACvB,MAAM;WAIK,QAAQ,CAClB,OAAO,GAAE,OAA0B,EACnC,aAAa,GAAE,kBAA8C,GAC9D,MAAM;WAeK,eAAe,CACzB,kBAAkB,EAAE,MAAM,EAC1B,uBAAuB,EAAE,MAAM,EAC/B,OAAO,GAAE,OAA0B,EACnC,aAAa,GAAE,kBAA8C,EAC7D,SAAS,CAAC,EAAE,UAAU,GACvB,MAAM;IAUF,KAAK,IAAI,MAAM;IAIf,eAAe,IAAI,MAAM;IAOzB,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM;IAIhC;;;;;;;OAOG;IACI,OAAO,IAAI,IAAI;IAMf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CA8B1C"}

package/build/keypair/Wallet.js

@@ -1,11 +1,26 @@
+import {} from '@btc-vision/ecpair';
 import { EcKeyPair } from './EcKeyPair.js';
-import { initEccLib, networks, toXOnly } from '@btc-vision/bitcoin';
+import { fromHex, networks, toHex, toXOnly, } from '@btc-vision/bitcoin';
 import { Address } from './Address.js';
 import { BitcoinUtils } from '../utils/BitcoinUtils.js';
-import * as ecc from '@bitcoinerlab/secp256k1';
 import { getMLDSAConfig, MLDSASecurityLevel, QuantumBIP32Factory, } from '@btc-vision/bip32';
-initEccLib(ecc);
+/**
+ * Wallet class for managing both classical and quantum-resistant keys
+ */
 export class Wallet {
+    network;
+    _keypair;
+    _mldsaKeypair;
+    _securityLevel;
+    _chainCode;
+    _p2wpkh;
+    _p2tr;
+    _p2wda;
+    _legacy;
+    _segwitLegacy;
+    _bufferPubKey;
+    _tweakedKey;
+    _address;
     constructor(privateKeyOrWif, mldsaPrivateKeyOrBase58, network = networks.bitcoin, securityLevel = MLDSASecurityLevel.LEVEL2, chainCode) {
         this.network = network;
         this._securityLevel = securityLevel;
@@ -13,7 +28,7 @@ export class Wallet {
             ? privateKeyOrWif.replace('0x', '')
             : privateKeyOrWif;
         if (BitcoinUtils.isValidHex(parsedPrivateKey)) {
-            this._keypair = EcKeyPair.fromPrivateKey(Buffer.from(parsedPrivateKey, 'hex'), this.network);
+            this._keypair = EcKeyPair.fromPrivateKey(fromHex(parsedPrivateKey), this.network);
         }
         else {
             this._keypair = EcKeyPair.fromWIF(parsedPrivateKey, this.network);
@@ -22,7 +37,7 @@ export class Wallet {
             ? mldsaPrivateKeyOrBase58.replace('0x', '')
             : mldsaPrivateKeyOrBase58;
         if (BitcoinUtils.isValidHex(parsedMLDSAKey)) {
-            const mldsaBuffer = Buffer.from(parsedMLDSAKey, 'hex');
+            const mldsaBuffer = fromHex(parsedMLDSAKey);
             const config = getMLDSAConfig(securityLevel, this.network);
             const privateKeySize = config.privateKeySize;
             const publicKeySize = config.publicKeySize;
@@ -40,12 +55,12 @@ export class Wallet {
             if (chainCode && chainCode.length !== 32) {
                 throw new Error('Chain code must be 32 bytes');
             }
-            this._chainCode = chainCode || Buffer.alloc(32);
+            this._chainCode = chainCode || new Uint8Array(32);
             this._mldsaKeypair = QuantumBIP32Factory.fromPrivateKey(mldsaPrivateKeyBuffer, this._chainCode, this.network, securityLevel);
         }
         else {
             this._mldsaKeypair = QuantumBIP32Factory.fromBase58(parsedMLDSAKey);
-            this._chainCode = Buffer.from(this._mldsaKeypair.chainCode);
+            this._chainCode = new Uint8Array(this._mldsaKeypair.chainCode);
             this._securityLevel = this._mldsaKeypair.securityLevel;
         }
         this._bufferPubKey = this._keypair.publicKey;
@@ -101,22 +116,22 @@ export class Wallet {
         return this._bufferPubKey;
     }
     get quantumPublicKey() {
-        return Buffer.from(this._mldsaKeypair.publicKey);
+        return new Uint8Array(this._mldsaKeypair.publicKey);
     }
     get quantumPrivateKey() {
         if (!this._mldsaKeypair.privateKey) {
             throw new Error('Quantum private key not set');
         }
-        return Buffer.from(this._mldsaKeypair.privateKey);
+        return new Uint8Array(this._mldsaKeypair.privateKey);
     }
     get quantumPublicKeyHex() {
-        return Buffer.from(this._mldsaKeypair.publicKey).toString('hex');
+        return toHex(new Uint8Array(this._mldsaKeypair.publicKey));
     }
     get quantumPrivateKeyHex() {
         if (!this._mldsaKeypair.privateKey) {
             throw new Error('Quantum private key not set');
         }
-        return Buffer.from(this._mldsaKeypair.privateKey).toString('hex');
+        return toHex(new Uint8Array(this._mldsaKeypair.privateKey));
     }
     get xOnly() {
         if (!this.keypair)
@@ -143,14 +158,30 @@ export class Wallet {
         if (!this._keypair.privateKey) {
             throw new Error('Private key not available');
         }
-        return this._keypair.privateKey.toString('hex');
+        return toHex(this._keypair.privateKey);
     }
     toPublicKeyHex() {
-        return this._bufferPubKey.toString('hex');
+        return toHex(this._bufferPubKey);
     }
     toQuantumBase58() {
         return this._mldsaKeypair.toBase58();
     }
+    /**
+     * Best-effort zeroing of private key material held by this wallet.
+     *
+     * Zeros classical and quantum private key buffers and the chain code in-place.
+     * This cannot guarantee all copies are erased (the JS runtime may have copied
+     * buffers internally, and string representations cannot be zeroed), but it
+     * eliminates the primary references.
+     */
+    zeroize() {
+        this._keypair.privateKey?.fill(0);
+        this._mldsaKeypair.privateKey?.fill(0);
+        this._chainCode.fill(0);
+    }
+    [Symbol.dispose]() {
+        this.zeroize();
+    }
     derivePath(path) {
         const derivedQuantum = this._mldsaKeypair.derivePath(path);
         if (!this._keypair.privateKey) {
@@ -164,6 +195,7 @@ export class Wallet {
         if (!derivedClassical.chainCode) {
             throw new Error('Failed to derive classical chain code');
         }
-        return new Wallet(Buffer.from(derivedClassical.privateKey).toString('hex'), derivedQuantum.toBase58(), this.network, this._securityLevel, Buffer.from(derivedClassical.chainCode));
+        return new Wallet(toHex(new Uint8Array(derivedClassical.privateKey)), derivedQuantum.toBase58(), this.network, this._securityLevel, new Uint8Array(derivedClassical.chainCode));
     }
 }
+//# sourceMappingURL=Wallet.js.map

package/build/keypair/Wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.js","sourceRoot":"","sources":["../../src/keypair/Wallet.ts"],"names":[],"mappings":"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"}

package/build/keypair/interfaces/IWallet.d.ts

@@ -1,7 +1,26 @@
+/**
+ * Interface for the generated wallet
+ */
 export interface IWallet {
+    /**
+     * The classical Bitcoin address of the wallet (P2WPKH)
+     */
     readonly address: string;
+    /**
+     * The classical private key of the wallet (WIF format or hex)
+     */
     readonly privateKey: string;
+    /**
+     * The classical public key of the wallet (hex)
+     */
     readonly publicKey: string;
+    /**
+     * The quantum ML-DSA private key (hex)
+     */
     readonly quantumPrivateKey: string;
+    /**
+     * The quantum ML-DSA public key (hex)
+     */
     readonly quantumPublicKey: string;
 }
+//# sourceMappingURL=IWallet.d.ts.map

package/build/keypair/interfaces/IWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWallet.d.ts","sourceRoot":"","sources":["../../../src/keypair/interfaces/IWallet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACrC"}

package/build/keypair/interfaces/IWallet.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=IWallet.js.map

package/build/keypair/interfaces/IWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWallet.js","sourceRoot":"","sources":["../../../src/keypair/interfaces/IWallet.ts"],"names":[],"mappings":""}