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

package/build/generators/builders/LegacyCalldataGenerator.js

@@ -1,14 +1,27 @@
-import { crypto, networks, opcodes, script } from '@btc-vision/bitcoin';
+import { concat, crypto, networks, opcodes, script } from '@btc-vision/bitcoin';
+import {} from '@btc-vision/ecpair';
 import { Compressor } from '../../bytecode/Compressor.js';
 import { EcKeyPair } from '../../keypair/EcKeyPair.js';
 import { Generator } from '../Generator.js';
+import { Features } from '../Features.js';
 import { BinaryWriter } from '../../buffer/BinaryWriter.js';
+/**
+ * Class to generate bitcoin script for interaction transactions
+ * @deprecated
+ */
 export class LegacyCalldataGenerator extends Generator {
     constructor(senderPubKey, network = networks.bitcoin) {
-        super(senderPubKey, Buffer.alloc(0), network);
+        super(senderPubKey, new Uint8Array(0), network);
     }
+    /**
+     * Get the public key as a buffer
+     * @param {Uint8Array[]} witnessKeys - The public keys
+     * @param {Network} network - The network to use
+     * @private
+     * @returns {Uint8Array} - The public key as a buffer
+     */
     static getPubKeyAsBuffer(witnessKeys, network) {
-        let finalBuffer = Buffer.alloc(0);
+        let finalBuffer = new Uint8Array(0);
         for (const pubKey of witnessKeys) {
             const key = EcKeyPair.fromPublicKey(pubKey, network);
             if (!key.compressed) {
@@ -17,14 +30,27 @@ export class LegacyCalldataGenerator extends Generator {
             if (pubKey.byteLength !== 33) {
                 throw new Error(`Public key must be 33 bytes, got ${pubKey.byteLength} bytes.`);
             }
-            finalBuffer = Buffer.concat([finalBuffer, pubKey]);
+            finalBuffer = concat([finalBuffer, pubKey]);
         }
+        // compress the public keys
         const compressed = Compressor.compress(finalBuffer);
         if (compressed.byteLength >= finalBuffer.byteLength) {
+            // we ensure that the user pays the smallest amount of fees. [micro-optimization]
             return finalBuffer;
         }
+        // if compressed is smaller, return compressed.
         return compressed;
     }
+    /**
+     * Compile an interaction bitcoin script
+     * @param {Uint8Array} calldata - The calldata to use
+     * @param {Uint8Array} contractSecret - The contract secret
+     * @param {Uint8Array} challenge - The challenge to use
+     * @param {bigint} maxPriority - The maximum priority
+     * @param {number[]} [featuresRaw=[]] - The features to use (optional)
+     * @returns {Uint8Array} - The compiled script
+     * @throws {Error} - If something goes wrong
+     */
     compile(calldata, contractSecret, challenge, maxPriority, featuresRaw = []) {
         const dataChunks = this.splitBufferIntoChunks(calldata);
         if (!dataChunks.length)
@@ -39,11 +65,12 @@ export class LegacyCalldataGenerator extends Generator {
                 featuresList.push(feature.opcode);
                 this.encodeFeature(feature, finalBuffer);
             }
-            featureData.push(...this.splitBufferIntoChunks(Buffer.from(finalBuffer.getBuffer())));
+            featureData.push(...this.splitBufferIntoChunks(new Uint8Array(finalBuffer.getBuffer())));
         }
         let compiledData = [
             this.getHeader(maxPriority, featuresList),
             opcodes.OP_TOALTSTACK,
+            // CHALLENGE PREIMAGE FOR REWARD,
             challenge,
             opcodes.OP_TOALTSTACK,
             this.senderPubKey,
@@ -60,9 +87,11 @@ export class LegacyCalldataGenerator extends Generator {
             opcodes.OP_IF,
             Generator.MAGIC,
         ];
+        // Write calldata
         compiledData = compiledData.concat(...featureData, ...[opcodes.OP_1NEGATE, ...dataChunks, opcodes.OP_ELSE, opcodes.OP_1, opcodes.OP_ENDIF]);
         const asm = compiledData.flat();
         const compiled = script.compile(asm);
+        /** Verify the validity of the script */
         const decompiled = script.decompile(compiled);
         if (!decompiled) {
             throw new Error('Failed to decompile script??');
@@ -70,3 +99,4 @@ export class LegacyCalldataGenerator extends Generator {
         return compiled;
     }
 }
+//# sourceMappingURL=LegacyCalldataGenerator.js.map

package/build/generators/builders/LegacyCalldataGenerator.js.map

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

package/build/generators/builders/MultiSignGenerator.d.ts

@@ -1,4 +1,9 @@
+import { type PublicKey, type XOnlyPublicKey } from '@btc-vision/bitcoin';
+/**
+ * Generate a bitcoin script for a multisign interaction
+ */
 export declare class MultiSignGenerator {
     static readonly MAXIMUM_SUPPORTED_SIGNATURE = 255;
-    static compile(vaultPublicKeys: Buffer[], minimumSignatures?: number, internal?: Buffer): Buffer;
+    static compile(vaultPublicKeys: Uint8Array[] | PublicKey[], minimumSignatures?: number, internal?: Uint8Array | XOnlyPublicKey): Uint8Array;
 }
+//# sourceMappingURL=MultiSignGenerator.d.ts.map

package/build/generators/builders/MultiSignGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiSignGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/builders/MultiSignGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,SAAS,EAAmB,KAAK,cAAc,EAAG,MAAM,qBAAqB,CAAC;AAE7H;;GAEG;AACH,qBAAa,kBAAkB;IAC3B,gBAAuB,2BAA2B,OAAO;WAE3C,OAAO,CACjB,eAAe,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,EAC3C,iBAAiB,GAAE,MAAU,EAC7B,QAAQ,CAAC,EAAE,UAAU,GAAG,cAAc,GACvC,UAAU;CA6DhB"}

package/build/generators/builders/MultiSignGenerator.js

@@ -1,5 +1,9 @@
-import { opcodes, script, toXOnly } from '@btc-vision/bitcoin';
+import { alloc, compare, equals, opcodes, script, toXOnly, } from '@btc-vision/bitcoin';
+/**
+ * Generate a bitcoin script for a multisign interaction
+ */
 export class MultiSignGenerator {
+    static MAXIMUM_SUPPORTED_SIGNATURE = 255;
     static compile(vaultPublicKeys, minimumSignatures = 0, internal) {
         if (minimumSignatures < 2) {
             throw new Error('Minimum signatures must be greater than 1');
@@ -10,30 +14,36 @@ export class MultiSignGenerator {
         if (minimumSignatures > MultiSignGenerator.MAXIMUM_SUPPORTED_SIGNATURE) {
             throw new Error(`The maximum amount of signatures is ${MultiSignGenerator.MAXIMUM_SUPPORTED_SIGNATURE}`);
         }
-        const minimumRequired = Buffer.alloc(1);
-        minimumRequired.writeUInt8(minimumSignatures);
-        vaultPublicKeys = vaultPublicKeys.filter((buf, index, self) => index === self.findIndex((otherBuf) => buf.equals(otherBuf)));
-        vaultPublicKeys = vaultPublicKeys.sort((a, b) => a.compare(b));
+        const minimumRequired = alloc(1);
+        minimumRequired[0] = minimumSignatures;
+        /** Remove duplicates **/
+        vaultPublicKeys = vaultPublicKeys.filter((buf, index, self) => index === self.findIndex((otherBuf) => equals(buf, otherBuf)));
+        /** We must order the pub keys. */
+        vaultPublicKeys = vaultPublicKeys.sort((a, b) => compare(a, b));
         let included = false;
         const data = vaultPublicKeys.map((key) => {
             const newKey = toXOnly(key);
             if (internal && !included)
-                included = internal.equals(newKey);
+                included = equals(internal, newKey);
             return newKey;
         });
         if (internal && !included)
             data.push(internal);
         const compiledData = [
+            // Push the initial 0 (for OP_CHECKSIGADD)
             opcodes.OP_0,
+            // For each public key, add CHECKSIGADD operation
             ...data.flatMap((key) => [
-                key,
-                opcodes.OP_CHECKSIGADD,
+                key, // Push the public key
+                opcodes.OP_CHECKSIGADD, // Add the public key to the signature set
             ]),
+            // Finally, compare the sum with the minimum required signatures
             minimumRequired,
-            opcodes.OP_NUMEQUAL,
+            opcodes.OP_NUMEQUAL, // Use NUMEQUALVERIFY to ensure the correct number of signatures
         ];
         const asm = compiledData.flat();
         const compiled = script.compile(asm);
+        /** Verify the validity of the script */
         const decompiled = script.decompile(compiled);
         if (!decompiled) {
             throw new Error('Failed to decompile script.');
@@ -41,4 +51,4 @@ export class MultiSignGenerator {
         return compiled;
     }
 }
-MultiSignGenerator.MAXIMUM_SUPPORTED_SIGNATURE = 255;
+//# sourceMappingURL=MultiSignGenerator.js.map

package/build/generators/builders/MultiSignGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiSignGenerator.js","sourceRoot":"","sources":["../../../src/generators/builders/MultiSignGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAkB,MAAM,EAAE,OAAO,GAAwB,MAAM,qBAAqB,CAAC;AAE7H;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACpB,MAAM,CAAU,2BAA2B,GAAG,GAAG,CAAC;IAElD,MAAM,CAAC,OAAO,CACjB,eAA2C,EAC3C,oBAA4B,CAAC,EAC7B,QAAsC;QAEtC,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,eAAe,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,iBAAiB,GAAG,kBAAkB,CAAC,2BAA2B,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACX,uCAAuC,kBAAkB,CAAC,2BAA2B,EAAE,CAC1F,CAAC;QACN,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,eAAe,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;QAEvC,yBAAyB;QACzB,eAAe,GAAG,eAAe,CAAC,MAAM,CACpC,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CACtF,CAAC;QAEF,kCAAkC;QAClC,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEhE,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAgB,CAAC,CAAC;YACzC,IAAI,QAAQ,IAAI,CAAC,QAAQ;gBAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE/D,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,QAA0B,CAAC,CAAC;QACjE,MAAM,YAAY,GAA4B;YAC1C,0CAA0C;YAC1C,OAAO,CAAC,IAAI;YAEZ,iDAAiD;YACjD,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;gBACrB,GAAG,EAAE,sBAAsB;gBAC3B,OAAO,CAAC,cAAc,EAAE,0CAA0C;aACrE,CAAC;YAEF,gEAAgE;YAChE,eAAe;YACf,OAAO,CAAC,WAAW,EAAE,gEAAgE;SACxF,CAAC;QAEF,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAErC,wCAAwC;QACxC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC"}

package/build/generators/builders/P2WDAGenerator.d.ts

@@ -1,12 +1,50 @@
-import { Network } from '@btc-vision/bitcoin';
-import { Feature, Features } from '../Features.js';
+import { type Network, type PublicKey } from '@btc-vision/bitcoin';
+import { type Feature, Features } from '../Features.js';
 import { Generator } from '../Generator.js';
-import { IChallengeSolution } from '../../epoch/interfaces/IChallengeSolution.js';
+import type { IChallengeSolution } from '../../epoch/interfaces/IChallengeSolution.js';
+/**
+ * @category Generators
+ * @remarks Not fully implemented yet
+ */
 export declare class P2WDAGenerator extends Generator {
     private static readonly P2WDA_VERSION;
-    constructor(senderPubKey: Buffer, contractSaltPubKey: Buffer, network?: Network);
+    constructor(senderPubKey: PublicKey, contractSaltPubKey: Uint8Array, network?: Network);
+    /**
+     * Validate that operation data will fit in P2WDA witness fields
+     *
+     * @param dataSize Size of the operation data
+     * @param maxWitnessFields Maximum number of witness fields (default 10)
+     * @param maxBytesPerWitness Maximum bytes per witness field (default 80)
+     * @returns true if data will fit, false otherwise
+     */
     static validateWitnessSize(dataSize: number, maxWitnessFields?: number, maxBytesPerWitness?: number): boolean;
-    compile(calldata: Buffer, contractSecret: Buffer, challenge: IChallengeSolution, maxPriority: bigint, featuresRaw?: Feature<Features>[]): Buffer;
-    getHeader(maxPriority: bigint, features?: Features[]): Buffer;
+    /**
+     * Compile operation data for P2WDA witness embedding
+     *
+     * This creates a binary structure containing all operation information
+     * without Bitcoin script opcodes. The structure is:
+     *
+     * [version(1)] [header(12)] [contract(32)] [challenge_pubkey(33)] [challenge_solution(32)]
+     * [calldata_length(4)] [calldata] [features_length(2)] [features_data]
+     *
+     * @param calldata The compressed calldata for the contract interaction
+     * @param contractSecret The 32-byte contract secret
+     * @param challenge The challenge solution for epoch rewards
+     * @param maxPriority Maximum priority fee in satoshis
+     * @param featuresRaw Optional features like access lists
+     * @returns Raw operation data ready for signing and compression
+     */
+    compile(calldata: Uint8Array, contractSecret: Uint8Array, challenge: IChallengeSolution, maxPriority: bigint, featuresRaw?: Feature<Features>[]): Uint8Array;
+    getHeader(maxPriority: bigint, features?: Features[]): Uint8Array;
+    /**
+     * Write features section to the operation data
+     *
+     * Features are encoded as:
+     * [feature_count(2)] [feature1_opcode(1)] [feature1_length(4)] [feature1_data] ...
+     *
+     * @param writer Binary writer to write to
+     * @param features Array of features to encode
+     */
     private writeFeatures;
 }
+//# sourceMappingURL=P2WDAGenerator.d.ts.map

package/build/generators/builders/P2WDAGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"P2WDAGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/builders/P2WDAGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,KAAK,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAEvF;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAGzC,YAAY,EAAE,SAAS,EACvB,kBAAkB,EAAE,UAAU,EAC9B,OAAO,GAAE,OAA0B;IAKvC;;;;;;;OAOG;WACW,mBAAmB,CAC7B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,GAAE,MAAW,EAC7B,kBAAkB,GAAE,MAAW,GAChC,OAAO;IAYV;;;;;;;;;;;;;;;OAeG;IACI,OAAO,CACV,QAAQ,EAAE,UAAU,EACpB,cAAc,EAAE,UAAU,EAC1B,SAAS,EAAE,kBAAkB,EAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,OAAO,CAAC,QAAQ,CAAC,EAAO,GACtC,UAAU;IAmCG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,EAAO,GAAG,UAAU;IAIrF;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;CAQxB"}

package/build/generators/builders/P2WDAGenerator.js

@@ -1,10 +1,24 @@
 import { networks } from '@btc-vision/bitcoin';
 import { BinaryWriter } from '../../buffer/BinaryWriter.js';
+import { Features } from '../Features.js';
 import { Generator } from '../Generator.js';
+/**
+ * @category Generators
+ * @remarks Not fully implemented yet
+ */
 export class P2WDAGenerator extends Generator {
+    static P2WDA_VERSION = 0x01;
     constructor(senderPubKey, contractSaltPubKey, network = networks.bitcoin) {
         super(senderPubKey, contractSaltPubKey, network);
     }
+    /**
+     * Validate that operation data will fit in P2WDA witness fields
+     *
+     * @param dataSize Size of the operation data
+     * @param maxWitnessFields Maximum number of witness fields (default 10)
+     * @param maxBytesPerWitness Maximum bytes per witness field (default 80)
+     * @returns true if data will fit, false otherwise
+     */
     static validateWitnessSize(dataSize, maxWitnessFields = 10, maxBytesPerWitness = 80) {
         const signatureSize = 64;
         const compressionRatio = 0.7;
@@ -13,6 +27,22 @@ export class P2WDAGenerator extends Generator {
         const requiredFields = Math.ceil(compressedSize / maxBytesPerWitness);
         return requiredFields <= maxWitnessFields;
     }
+    /**
+     * Compile operation data for P2WDA witness embedding
+     *
+     * This creates a binary structure containing all operation information
+     * without Bitcoin script opcodes. The structure is:
+     *
+     * [version(1)] [header(12)] [contract(32)] [challenge_pubkey(33)] [challenge_solution(32)]
+     * [calldata_length(4)] [calldata] [features_length(2)] [features_data]
+     *
+     * @param calldata The compressed calldata for the contract interaction
+     * @param contractSecret The 32-byte contract secret
+     * @param challenge The challenge solution for epoch rewards
+     * @param maxPriority Maximum priority fee in satoshis
+     * @param featuresRaw Optional features like access lists
+     * @returns Raw operation data ready for signing and compression
+     */
     compile(calldata, contractSecret, challenge, maxPriority, featuresRaw = []) {
         if (!this.contractSaltPubKey) {
             throw new Error('Contract salt public key not set');
@@ -30,11 +60,20 @@ export class P2WDAGenerator extends Generator {
         writer.writeU32(calldata.length);
         writer.writeBytes(calldata);
         this.writeFeatures(writer, features);
-        return Buffer.from(writer.getBuffer());
+        return new Uint8Array(writer.getBuffer());
     }
     getHeader(maxPriority, features = []) {
         return super.getHeader(maxPriority, features);
     }
+    /**
+     * Write features section to the operation data
+     *
+     * Features are encoded as:
+     * [feature_count(2)] [feature1_opcode(1)] [feature1_length(4)] [feature1_data] ...
+     *
+     * @param writer Binary writer to write to
+     * @param features Array of features to encode
+     */
     writeFeatures(writer, features) {
         writer.writeU16(features.length);
         for (const feature of features) {
@@ -43,4 +82,4 @@ export class P2WDAGenerator extends Generator {
         }
     }
 }
-P2WDAGenerator.P2WDA_VERSION = 0x01;
+//# sourceMappingURL=P2WDAGenerator.js.map

package/build/generators/builders/P2WDAGenerator.js.map

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

package/build/index.d.ts

@@ -1,3 +1,4 @@
 import * as opnet from './opnet.js';
 export { opnet };
 export * from './opnet.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,cAAc,YAAY,CAAC"}

package/build/index.js

@@ -1,3 +1,4 @@
 import * as opnet from './opnet.js';
 export { opnet };
 export * from './opnet.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,cAAc,YAAY,CAAC"}