@btc-vision/transaction 1.6.18 → 1.7.0

package/build/mnemonic/Mnemonic.d.ts

@@ -0,0 +1,29 @@
+import { BIP32Interface, MLDSASecurityLevel, QuantumBIP32Interface } from '@btc-vision/bip32';
+import { Network } from '@btc-vision/bitcoin';
+import { Wallet } from '../keypair/Wallet.js';
+import { MnemonicStrength } from './MnemonicStrength.js';
+export declare class Mnemonic {
+    private readonly _phrase;
+    private readonly _passphrase;
+    private readonly _network;
+    private readonly _securityLevel;
+    private readonly _seed;
+    private readonly _classicalRoot;
+    private readonly _quantumRoot;
+    constructor(phrase: string, passphrase?: string, network?: Network, securityLevel?: MLDSASecurityLevel);
+    get phrase(): string;
+    get network(): Network;
+    get securityLevel(): MLDSASecurityLevel;
+    get seed(): Buffer;
+    static generatePhrase(strength?: MnemonicStrength): string;
+    static generate(strength?: MnemonicStrength, passphrase?: string, network?: Network, securityLevel?: MLDSASecurityLevel): Mnemonic;
+    static validate(phrase: string): boolean;
+    derive(index?: number, account?: number, isChange?: boolean): Wallet;
+    deriveMultiple(count: number, startIndex?: number, account?: number, isChange?: boolean): Wallet[];
+    deriveCustomPath(classicalPath: string, quantumPath: string): Wallet;
+    getClassicalRoot(): BIP32Interface;
+    getQuantumRoot(): QuantumBIP32Interface;
+    private buildClassicalPath;
+    private buildQuantumPath;
+    private getCoinType;
+}

package/build/mnemonic/Mnemonic.js

@@ -0,0 +1,98 @@
+import * as bip39 from 'bip39';
+import { BIP32Factory, MLDSASecurityLevel, QuantumBIP32Factory, } from '@btc-vision/bip32';
+import * as ecc from '@bitcoinerlab/secp256k1';
+import { initEccLib, networks } from '@btc-vision/bitcoin';
+import { Wallet } from '../keypair/Wallet.js';
+import { MnemonicStrength } from './MnemonicStrength.js';
+initEccLib(ecc);
+const bip32 = BIP32Factory(ecc);
+export class Mnemonic {
+    constructor(phrase, passphrase = '', network = networks.bitcoin, securityLevel = MLDSASecurityLevel.LEVEL2) {
+        if (!bip39.validateMnemonic(phrase)) {
+            throw new Error('Invalid mnemonic phrase');
+        }
+        this._phrase = phrase;
+        this._passphrase = passphrase;
+        this._network = network;
+        this._securityLevel = securityLevel;
+        this._seed = bip39.mnemonicToSeedSync(this._phrase, this._passphrase);
+        this._classicalRoot = bip32.fromSeed(this._seed, this._network);
+        this._quantumRoot = QuantumBIP32Factory.fromSeed(this._seed, this._network, this._securityLevel);
+    }
+    get phrase() {
+        return this._phrase;
+    }
+    get network() {
+        return this._network;
+    }
+    get securityLevel() {
+        return this._securityLevel;
+    }
+    get seed() {
+        return Buffer.from(this._seed);
+    }
+    static generatePhrase(strength = MnemonicStrength.MAXIMUM) {
+        return bip39.generateMnemonic(strength);
+    }
+    static generate(strength = MnemonicStrength.MAXIMUM, passphrase = '', network = networks.bitcoin, securityLevel = MLDSASecurityLevel.LEVEL2) {
+        const phrase = bip39.generateMnemonic(strength);
+        return new Mnemonic(phrase, passphrase, network, securityLevel);
+    }
+    static validate(phrase) {
+        return bip39.validateMnemonic(phrase);
+    }
+    derive(index = 0, account = 0, isChange = false) {
+        const classicalPath = this.buildClassicalPath(account, index, isChange);
+        const classicalChild = this._classicalRoot.derivePath(classicalPath);
+        if (!classicalChild.privateKey) {
+            throw new Error(`Failed to derive classical private key at index ${index}`);
+        }
+        const quantumPath = this.buildQuantumPath(account, index, isChange);
+        const quantumChild = this._quantumRoot.derivePath(quantumPath);
+        if (!quantumChild.privateKey) {
+            throw new Error(`Failed to derive quantum private key at index ${index}`);
+        }
+        return new Wallet(Buffer.from(classicalChild.privateKey).toString('hex'), Buffer.from(quantumChild.privateKey).toString('hex'), this._network, this._securityLevel);
+    }
+    deriveMultiple(count, startIndex = 0, account = 0, isChange = false) {
+        const wallets = [];
+        for (let i = 0; i < count; i++) {
+            wallets.push(this.derive(startIndex + i, account, isChange));
+        }
+        return wallets;
+    }
+    deriveCustomPath(classicalPath, quantumPath) {
+        const classicalChild = this._classicalRoot.derivePath(classicalPath);
+        const quantumChild = this._quantumRoot.derivePath(quantumPath);
+        if (!classicalChild.privateKey) {
+            throw new Error(`Failed to derive classical private key at path ${classicalPath}`);
+        }
+        if (!quantumChild.privateKey) {
+            throw new Error(`Failed to derive quantum private key at path ${quantumPath}`);
+        }
+        return new Wallet(Buffer.from(classicalChild.privateKey).toString('hex'), Buffer.from(quantumChild.privateKey).toString('hex'), this._network, this._securityLevel);
+    }
+    getClassicalRoot() {
+        return this._classicalRoot;
+    }
+    getQuantumRoot() {
+        return this._quantumRoot;
+    }
+    buildClassicalPath(account, index, isChange) {
+        const coinType = this.getCoinType();
+        const change = isChange ? 1 : 0;
+        return `m/84'/${coinType}'/${account}'/${change}/${index}`;
+    }
+    buildQuantumPath(account, index, isChange) {
+        const coinType = this.getCoinType();
+        const change = isChange ? 1 : 0;
+        return `m/360'/${coinType}'/${account}'/${change}/${index}`;
+    }
+    getCoinType() {
+        if (this._network.bech32 === networks.testnet.bech32 ||
+            this._network.bech32 === networks.regtest.bech32) {
+            return 1;
+        }
+        return 0;
+    }
+}

package/build/mnemonic/MnemonicStrength.d.ts

@@ -0,0 +1,7 @@
+export declare enum MnemonicStrength {
+    MINIMUM = 128,
+    LOW = 160,
+    MEDIUM = 192,
+    HIGH = 224,
+    MAXIMUM = 256
+}

package/build/mnemonic/MnemonicStrength.js

@@ -0,0 +1,8 @@
+export var MnemonicStrength;
+(function (MnemonicStrength) {
+    MnemonicStrength[MnemonicStrength["MINIMUM"] = 128] = "MINIMUM";
+    MnemonicStrength[MnemonicStrength["LOW"] = 160] = "LOW";
+    MnemonicStrength[MnemonicStrength["MEDIUM"] = 192] = "MEDIUM";
+    MnemonicStrength[MnemonicStrength["HIGH"] = 224] = "HIGH";
+    MnemonicStrength[MnemonicStrength["MAXIMUM"] = 256] = "MAXIMUM";
+})(MnemonicStrength || (MnemonicStrength = {}));

package/build/opnet.d.ts

@@ -19,6 +19,9 @@ export * from './keypair/EcKeyPair.js';
 export * from './keypair/interfaces/IWallet.js';
 export * from './keypair/MessageSigner.js';
 export * from './keypair/Wallet.js';
+export * from './mnemonic/Mnemonic.js';
+export * from './mnemonic/MnemonicStrength.js';
+export { MLDSASecurityLevel, MLDSAKeyPair, QuantumBIP32Interface, QuantumBIP32API, QuantumSigner, QuantumBIP32Factory, QuantumDerivationPath, } from '@btc-vision/bip32';
 export * from './metadata/ContractBaseMetadata.js';
 export * from './network/ChainId.js';
 export * from './signer/TweakedSigner.js';
@@ -66,6 +69,7 @@ export * from './transaction/browser/extensions/UnisatSigner.js';
 export * from './transaction/browser/extensions/XverseSigner.js';
 export * from './transaction/browser/types/Unisat.js';
 export * from './transaction/browser/types/Xverse.js';
+export * from './transaction/browser/types/OPWallet.js';
 export * from './metadata/tokens.js';
 export * from './transaction/browser/Web3Provider.js';
 export * from './keypair/Secp256k1PointDeriver.js';

package/build/opnet.js

@@ -18,6 +18,9 @@ export * from './keypair/EcKeyPair.js';
 export * from './keypair/interfaces/IWallet.js';
 export * from './keypair/MessageSigner.js';
 export * from './keypair/Wallet.js';
+export * from './mnemonic/Mnemonic.js';
+export * from './mnemonic/MnemonicStrength.js';
+export { MLDSASecurityLevel, QuantumBIP32Factory, QuantumDerivationPath, } from '@btc-vision/bip32';
 export * from './metadata/ContractBaseMetadata.js';
 export * from './network/ChainId.js';
 export * from './signer/TweakedSigner.js';
@@ -65,6 +68,7 @@ export * from './transaction/browser/extensions/UnisatSigner.js';
 export * from './transaction/browser/extensions/XverseSigner.js';
 export * from './transaction/browser/types/Unisat.js';
 export * from './transaction/browser/types/Xverse.js';
+export * from './transaction/browser/types/OPWallet.js';
 export * from './metadata/tokens.js';
 export * from './transaction/browser/Web3Provider.js';
 export * from './keypair/Secp256k1PointDeriver.js';

package/build/transaction/browser/types/OPWallet.d.ts

@@ -0,0 +1,14 @@
+import { Unisat } from './Unisat.js';
+import { MLDSASecurityLevel } from '@btc-vision/bip32';
+export interface MLDSASignature {
+    readonly signature: string;
+    readonly publicKey: string;
+    readonly securityLevel: MLDSASecurityLevel;
+    readonly messageHash: string;
+}
+export interface OPWallet extends Unisat {
+    getMLDSAPublicKey(): Promise<string>;
+    signMLDSAMessage(message: string): Promise<MLDSASignature>;
+    verifyMLDSASignature(message: string, signature: MLDSASignature): Promise<boolean>;
+}
+export declare function isOPWallet(wallet: unknown): wallet is OPWallet;

package/build/transaction/browser/types/OPWallet.js

@@ -0,0 +1,6 @@
+export function isOPWallet(wallet) {
+    return (typeof wallet === 'object' &&
+        wallet !== null &&
+        'getMLDSAPublicKey' in wallet &&
+        'signMLDSAMessage' in wallet);
+}

package/gulpfile.js

@@ -13,8 +13,8 @@ process.on('uncaughtException', function (err) {
 const tsProject = ts.createProject('tsconfig.json');
 
 function buildESM() {
-    return tsProject
-        .src()
+    return gulp
+        .src(['src/**/*.ts', 'src/**/*.js', '!test/**/*'])
         .pipe(gulpcache('ts-esm'))
         .pipe(
             logger({

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@btc-vision/transaction",
     "type": "module",
-    "version": "1.6.18",
+    "version": "1.7.0",
     "author": "BlobMaster41",
     "description": "OPNet transaction library allows you to create and sign transactions for the OPNet network.",
     "engines": {
@@ -61,19 +61,24 @@
         "build": "gulp build",
         "setup": "npm i && npm run build",
         "browserBuild": "webpack --mode production",
-        "docs": "typedoc --out docs --exclude 'src/tests/*.ts' --tsconfig tsconfig.json --readme README.md --name OPNet --plugin typedoc-material-theme --themeColor '#cb9820' --exclude src/tests/test.ts --exclude src/index.ts src"
+        "docs": "typedoc --out docs --exclude 'src/tests/*.ts' --tsconfig tsconfig.json --readme README.md --name OPNet --plugin typedoc-material-theme --themeColor '#cb9820' --exclude src/tests/test.ts --exclude src/index.ts src",
+        "test": "npm run build && vitest run",
+        "test:watch": "npm run build && vitest",
+        "test:ui": "npm run build && vitest --ui",
+        "test:coverage": "npm run build && vitest run --coverage"
     },
     "devDependencies": {
-        "@babel/core": "^7.28.0",
+        "@babel/core": "^7.28.5",
         "@babel/plugin-proposal-class-properties": "^7.18.6",
-        "@babel/plugin-transform-runtime": "^7.28.0",
-        "@babel/preset-env": "^7.28.0",
+        "@babel/plugin-transform-runtime": "^7.28.5",
+        "@babel/preset-env": "^7.28.5",
         "@babel/preset-flow": "^7.27.1",
-        "@babel/preset-react": "^7.27.1",
-        "@babel/preset-typescript": "^7.27.1",
-        "@types/node": "^24.2.1",
+        "@babel/preset-react": "^7.28.5",
+        "@babel/preset-typescript": "^7.28.5",
+        "@types/node": "^24.10.0",
         "@types/sha.js": "^2.4.4",
-        "eslint": "^9.33.0",
+        "@vitest/ui": "^4.0.8",
+        "eslint": "^9.39.1",
         "gulp": "^5.0.1",
         "gulp-cached": "^1.1.1",
         "gulp-typescript": "^6.0.0-alpha.1",
@@ -82,18 +87,21 @@
         "prettier": "^3.6.2",
         "stream-browserify": "^3.0.0",
         "stream-http": "^3.2.0",
-        "typedoc": "^0.28.10",
-        "typescript-eslint": "^8.39.1",
+        "typedoc": "^0.28.14",
+        "typescript-eslint": "^8.46.3",
+        "vitest": "^4.0.8",
         "webpack-cli": "^6.0.1"
     },
     "dependencies": {
         "@babel/plugin-proposal-object-rest-spread": "^7.20.7",
         "@bitcoinerlab/secp256k1": "^1.2.0",
-        "@btc-vision/bitcoin": "^6.4.10",
-        "@btc-vision/bitcoin-rpc": "^1.0.2",
-        "@btc-vision/logger": "^1.0.6",
-        "@eslint/js": "^9.33.0",
-        "@noble/secp256k1": "^2.3.0",
+        "@btc-vision/bip32": "^6.0.3",
+        "@btc-vision/bitcoin": "^6.4.11",
+        "@btc-vision/bitcoin-rpc": "^1.0.5",
+        "@btc-vision/logger": "^1.0.7",
+        "@btc-vision/post-quantum": "^0.5.3",
+        "@eslint/js": "^9.39.1",
+        "@noble/secp256k1": "^3.0.0",
         "assert": "^2.1.0",
         "babel-loader": "^10.0.0",
         "babel-plugin-transform-import-meta": "^2.3.3",
@@ -101,7 +109,7 @@
         "babelify": "^10.0.0",
         "bech32": "^2.0.0",
         "bip174": "^2.1.1",
-        "bip32": "^5.0.0-rc.0",
+        "bip39": "^3.1.0",
         "browserify-zlib": "^0.2.0",
         "buffer": "^6.0.3",
         "ecpair": "^2.1.0",
@@ -110,9 +118,9 @@
         "gulp-logger-new": "^1.0.1",
         "process": "^0.11.10",
         "sha.js": "^2.4.12",
-        "ts-loader": "^9.5.2",
+        "ts-loader": "^9.5.4",
         "ts-node": "^10.9.2",
-        "typescript": "^5.9.2",
-        "webpack": "^5.101.0"
+        "typescript": "^5.9.3",
+        "webpack": "^5.102.1"
     }
 }

package/src/_version.ts

@@ -1 +1 @@
-export const version = '1.6.18';
+export const version = '1.7.0';

package/src/epoch/ChallengeSolution.ts

@@ -42,7 +42,7 @@ export class ChallengeSubmission implements IChallengeSubmission {
         data: RawChallengeSubmission,
         public readonly epochNumber: bigint,
     ) {
-        this.publicKey = Address.fromString(data.publicKey);
+        this.publicKey = Address.fromString(data.publicKey, data.classicPublicKey);
         this.solution = stringToBuffer(data.solution);
         this.graffiti = data.graffiti ? stringToBuffer(data.graffiti) : undefined;
         this.signature = stringToBuffer(data.signature);
@@ -76,7 +76,7 @@ export class ChallengeSolution implements IChallengeSolution {
 
     constructor(data: RawChallenge) {
         this.epochNumber = BigInt(data.epochNumber);
-        this.publicKey = Address.fromString(data.publicKey);
+        this.publicKey = Address.fromString(data.publicKey, data.classicPublicKey);
         this.solution = stringToBuffer(data.solution);
         this.salt = stringToBuffer(data.salt);
         this.graffiti = stringToBuffer(data.graffiti);
@@ -145,6 +145,7 @@ export class ChallengeSolution implements IChallengeSolution {
         return {
             epochNumber: this.epochNumber.toString(),
             publicKey: this.publicKey.toHex(),
+            classicPublicKey: this.publicKey.tweakedToHex(),
             solution: this.toHex(),
             salt: '0x' + this.salt.toString('hex'),
             graffiti: '0x' + this.graffiti.toString('hex'),

package/src/epoch/interfaces/IChallengeSolution.ts

@@ -31,6 +31,7 @@ export interface RawChallengeVerification {
 }
 
 export interface RawChallengeSubmission {
+    readonly classicPublicKey: string;
     readonly publicKey: string;
     readonly solution: string;
     readonly graffiti?: string;
@@ -46,6 +47,7 @@ export interface IChallengeSubmission {
 
 export interface RawChallenge {
     readonly epochNumber: string;
+    readonly classicPublicKey: string;
     readonly publicKey: string;
     readonly solution: string;
     readonly salt: string;