@btc-vision/transaction 1.7.19 → 1.7.22

package/build/transaction/shared/TweakedTransaction.js

@@ -36,6 +36,10 @@ export class TweakedTransaction extends Logger {
         this.txVersion = 2;
         this._mldsaSigner = null;
         this._hashedPublicKey = null;
+        this.addressRotationEnabled = false;
+        this.signerMap = new Map();
+        this.inputSignerMap = new Map();
+        this.tweakedSignerCache = new Map();
         this.customFinalizerP2SH = (inputIndex, input, scriptA, isSegwit, isP2SH, isP2WSH) => {
             const inputDecoded = this.inputs[inputIndex];
             if (isP2SH && input.partialSig && inputDecoded && inputDecoded.redeemScript) {
@@ -84,6 +88,10 @@ export class TweakedTransaction extends Logger {
             this._mldsaSigner = data.mldsaSigner;
             this._hashedPublicKey = MessageSigner.sha256(this._mldsaSigner.publicKey);
         }
+        if (data.addressRotation?.enabled) {
+            this.addressRotationEnabled = true;
+            this.signerMap = data.addressRotation.signerMap;
+        }
     }
     get mldsaSigner() {
         if (!this._mldsaSigner) {
@@ -153,6 +161,9 @@ export class TweakedTransaction extends Logger {
         }
         return signHash || 0;
     }
+    isAddressRotationEnabled() {
+        return this.addressRotationEnabled;
+    }
     ignoreSignatureError() {
         this.ignoreSignatureErrors = true;
     }
@@ -198,6 +209,53 @@ export class TweakedTransaction extends Logger {
         const vSize = weight / 4n;
         return vSize * feeRate;
     }
+    getSignerForInput(inputIndex) {
+        if (this.addressRotationEnabled) {
+            const inputSigner = this.inputSignerMap.get(inputIndex);
+            if (inputSigner) {
+                return inputSigner;
+            }
+        }
+        return this.signer;
+    }
+    registerInputSigner(inputIndex, utxo) {
+        if (!this.addressRotationEnabled) {
+            return;
+        }
+        if (utxo.signer) {
+            this.inputSignerMap.set(inputIndex, utxo.signer);
+            return;
+        }
+        const address = utxo.scriptPubKey?.address;
+        if (address && this.signerMap.has(address)) {
+            const signer = this.signerMap.get(address);
+            if (signer) {
+                this.inputSignerMap.set(inputIndex, signer);
+                return;
+            }
+        }
+    }
+    internalPubKeyToXOnlyForInput(inputIndex) {
+        const signer = this.getSignerForInput(inputIndex);
+        return toXOnly(Buffer.from(signer.publicKey));
+    }
+    getTweakedSignerForInput(inputIndex, useTweakedHash = false) {
+        if (!this.addressRotationEnabled) {
+            if (useTweakedHash) {
+                this.tweakSigner();
+                return this.tweakedSigner;
+            }
+            return this.getTweakedSigner(useTweakedHash);
+        }
+        const cacheKey = inputIndex * 2 + (useTweakedHash ? 1 : 0);
+        if (this.tweakedSignerCache.has(cacheKey)) {
+            return this.tweakedSignerCache.get(cacheKey);
+        }
+        const signer = this.getSignerForInput(inputIndex);
+        const tweaked = this.getTweakedSigner(useTweakedHash, signer);
+        this.tweakedSignerCache.set(cacheKey, tweaked);
+        return tweaked;
+    }
     generateTapData() {
         return {
             internalPubkey: this.internalPubKeyToXOnly(),
@@ -289,7 +347,8 @@ export class TweakedTransaction extends Logger {
                     const index = offset + j;
                     const input = batch[j];
                     try {
-                        promises.push(this.signInput(transaction, input, index, this.signer));
+                        const inputSigner = this.getSignerForInput(index);
+                        promises.push(this.signInput(transaction, input, index, inputSigner));
                     }
                     catch (e) {
                         this.log(`Failed to sign input ${index}: ${e.stack}`);
@@ -370,10 +429,13 @@ export class TweakedTransaction extends Logger {
         }
         return;
     }
-    generateP2SHP2PKHRedeemScript(inputAddr) {
-        const pubkey = Buffer.isBuffer(this.signer.publicKey)
-            ? this.signer.publicKey
-            : Buffer.from(this.signer.publicKey, 'hex');
+    generateP2SHP2PKHRedeemScript(inputAddr, inputIndex) {
+        const signer = this.addressRotationEnabled && inputIndex !== undefined
+            ? this.getSignerForInput(inputIndex)
+            : this.signer;
+        const pubkey = Buffer.isBuffer(signer.publicKey)
+            ? signer.publicKey
+            : Buffer.from(signer.publicKey, 'hex');
         const w = payments.p2wpkh({
             pubkey: pubkey,
             network: this.network,
@@ -432,7 +494,7 @@ export class TweakedTransaction extends Logger {
                 if (!utxo.scriptPubKey.address) {
                     throw new Error('Missing redeemScript and no address to regenerate it for P2SH UTXO');
                 }
-                const legacyScripts = this.generateP2SHP2PKHRedeemScript(utxo.scriptPubKey.address);
+                const legacyScripts = this.generateP2SHP2PKHRedeemScript(utxo.scriptPubKey.address, i);
                 if (!legacyScripts) {
                     throw new Error('Missing redeemScript for P2SH UTXO and unable to regenerate');
                 }
@@ -469,8 +531,13 @@ export class TweakedTransaction extends Logger {
                 if (inputSign)
                     input.sighashType = inputSign;
             }
-            this.tweakSigner();
-            input.tapInternalKey = this.internalPubKeyToXOnly();
+            if (this.addressRotationEnabled) {
+                input.tapInternalKey = this.internalPubKeyToXOnlyForInput(i);
+            }
+            else {
+                this.tweakSigner();
+                input.tapInternalKey = this.internalPubKeyToXOnly();
+            }
         }
         else if (isP2A(scriptPub)) {
             this.anchorInputIndices.add(i);

package/build/utxo/interfaces/IUTXO.d.ts

@@ -1,4 +1,5 @@
 import { ScriptPubKey } from '@btc-vision/bitcoin-rpc';
+import { RotationSigner } from '../../signer/AddressRotation.js';
 export interface UTXO {
     readonly transactionId: string;
     readonly outputIndex: number;
@@ -7,6 +8,7 @@ export interface UTXO {
     redeemScript?: string | Buffer;
     witnessScript?: string | Buffer;
     nonWitnessUtxo?: string | Buffer;
+    signer?: RotationSigner;
 }
 export interface FetchUTXOParams {
     readonly address: string;

package/documentation/README.md

@@ -19,6 +19,11 @@ Complete documentation for the OPNet Transaction Library - Bitcoin transaction b
 - **Universal Public Key** - `address.toHex()` returns the SHA256 hash of ML-DSA public key (32 bytes)
 - This is the user's universal identifier across the OPNet protocol
 
+### Transaction Building
+
+- **[Transaction Building Guide](./transaction-building.md)** - Complete guide to TransactionFactory, UTXO flow, fee calculation, signing, and all transaction types
+- **[Offline Transaction Signing](./offline-transaction-signing.md)** - Serialize transactions for offline/air-gapped signing, fee bumping (RBF), address rotation, and MultiSig support
+
 ### Quantum Support (ML-DSA)
 
 **[Complete Quantum Support Guide](./quantum-support/README.md)**