@bsv/wallet-toolbox 1.7.14 → 1.7.16

package/mobile/node_modules/@bsv/sdk/dist/esm/src/primitives/Signature.js

@@ -0,0 +1,361 @@
+import BigNumber from './BigNumber.js';
+import PublicKey from './PublicKey.js';
+import { verify } from './ECDSA.js';
+import { sha256 } from './Hash.js';
+import { toArray, toHex, toBase64 } from './utils.js';
+import Point from './Point.js';
+import Curve from './Curve.js';
+/**
+ * Represents a digital signature.
+ *
+ * A digital signature is a mathematical scheme for verifying the authenticity of
+ * digital messages or documents. In many scenarios, it is equivalent to a handwritten signature or stamped seal.
+ * The signature pair (R, S) corresponds to the raw ECDSA ([Elliptic Curve Digital Signature Algorithm](https://en.wikipedia.org/wiki/Elliptic_Curve_Digital_Signature_Algorithm)) signature.
+ * Signatures are often serialized into a format known as '[DER encoding](https://en.wikipedia.org/wiki/X.690#DER_encoding)' for transmission.
+ *
+ * @class Signature
+ */
+export default class Signature {
+    /**
+     * @property Represents the "r" component of the digital signature
+     */
+    r;
+    /**
+     * @property Represents the "s" component of the digital signature
+     */
+    s;
+    /**
+     * Takes an array of numbers or a string and returns a new Signature instance.
+     * This method will throw an error if the DER encoding is invalid.
+     * If a string is provided, it is assumed to represent a hexadecimal sequence.
+     *
+     * @static
+     * @method fromDER
+     * @param data - The sequence to decode from DER encoding.
+     * @param enc - The encoding of the data string.
+     * @returns The decoded data in the form of Signature instance.
+     *
+     * @example
+     * const signature = Signature.fromDER('30440220018c1f5502f8...', 'hex');
+     */
+    static fromDER(data, enc) {
+        const getLength = (buf, p) => {
+            const initial = buf[p.place++];
+            if ((initial & 0x80) === 0) {
+                return initial;
+            }
+            else {
+                throw new Error('Invalid DER entity length');
+            }
+        };
+        class Position {
+            place;
+            constructor() {
+                this.place = 0;
+            }
+        }
+        data = toArray(data, enc);
+        const p = new Position();
+        if (data[p.place++] !== 0x30) {
+            throw new Error('Signature DER must start with 0x30');
+        }
+        const len = getLength(data, p);
+        if (len + p.place !== data.length) {
+            throw new Error('Signature DER invalid');
+        }
+        if (data[p.place++] !== 0x02) {
+            throw new Error('Signature DER invalid');
+        }
+        const rlen = getLength(data, p);
+        let r = data.slice(p.place, rlen + p.place);
+        p.place += rlen;
+        if (data[p.place++] !== 0x02) {
+            throw new Error('Signature DER invalid');
+        }
+        const slen = getLength(data, p);
+        if (data.length !== slen + p.place) {
+            throw new Error('Invalid R-length in signature DER');
+        }
+        let s = data.slice(p.place, slen + p.place);
+        if (r[0] === 0) {
+            if ((r[1] & 0x80) !== 0) {
+                r = r.slice(1);
+            }
+            else {
+                throw new Error('Invalid R-value in signature DER');
+            }
+        }
+        if (s[0] === 0) {
+            if ((s[1] & 0x80) !== 0) {
+                s = s.slice(1);
+            }
+            else {
+                throw new Error('Invalid S-value in signature DER');
+            }
+        }
+        return new Signature(new BigNumber(r), new BigNumber(s));
+    }
+    /**
+     * Takes an array of numbers or a string and returns a new Signature instance.
+     * This method will throw an error if the Compact encoding is invalid.
+     * If a string is provided, it is assumed to represent a hexadecimal sequence.
+     * compactByte value 27-30 means uncompressed public key.
+     * 31-34 means compressed public key.
+     * The range represents the recovery param which can be 0,1,2,3.
+     * We could support recovery functions in future if there's demand.
+     *
+     * @static
+     * @method fromCompact
+     * @param data - The sequence to decode from Compact encoding.
+     * @param enc - The encoding of the data string.
+     * @returns The decoded data in the form of Signature instance.
+     *
+     * @example
+     * const signature = Signature.fromCompact('1b18c1f5502f8...', 'hex');
+     */
+    static fromCompact(data, enc) {
+        data = toArray(data, enc);
+        if (data.length !== 65) {
+            throw new Error('Invalid Compact Signature');
+        }
+        const compactByte = data[0];
+        if (compactByte < 27 || compactByte >= 35) {
+            throw new Error('Invalid Compact Byte');
+        }
+        return new Signature(new BigNumber(data.slice(1, 33)), new BigNumber(data.slice(33, 65)));
+    }
+    /**
+     * Creates an instance of the Signature class.
+     *
+     * @constructor
+     * @param r - The R component of the signature.
+     * @param s - The S component of the signature.
+     *
+     * @example
+     * const r = new BigNumber('208755674028...');
+     * const s = new BigNumber('564745627577...');
+     * const signature = new Signature(r, s);
+     */
+    constructor(r, s) {
+        this.r = r;
+        this.s = s;
+    }
+    /**
+     * Verifies a digital signature.
+     *
+     * This method will return true if the signature, key, and message hash match.
+     * If the data or key do not match the signature, the function returns false.
+     *
+     * @method verify
+     * @param msg - The message to verify.
+     * @param key - The public key used to sign the original message.
+     * @param enc - The encoding of the msg string.
+     * @returns A boolean representing whether the signature is valid.
+     *
+     * @example
+     * const msg = 'The quick brown fox jumps over the lazy dog';
+     * const publicKey = PublicKey.fromString('04188ca1050...');
+     * const isVerified = signature.verify(msg, publicKey);
+     */
+    verify(msg, key, enc) {
+        const msgHash = new BigNumber(sha256(msg, enc), 16);
+        return verify(msgHash, this, key);
+    }
+    /**
+     * Converts an instance of Signature into DER encoding.
+     * An alias for the toDER method.
+     *
+     * If the encoding parameter is set to 'hex', the function will return a hex string.
+     * If 'base64', it will return a base64 string.
+     * Otherwise, it will return an array of numbers.
+     *
+     * @method toDER
+     * @param enc - The encoding to use for the output.
+     * @returns The current instance in DER encoding.
+     *
+     * @example
+     * const der = signature.toString('base64');
+     */
+    toString(enc) {
+        return this.toDER(enc);
+    }
+    /**
+     * Converts an instance of Signature into DER encoding.
+     *
+     * If the encoding parameter is set to 'hex', the function will return a hex string.
+     * If 'base64', it will return a base64 string.
+     * Otherwise, it will return an array of numbers.
+     *
+     * @method toDER
+     * @param enc - The encoding to use for the output.
+     * @returns The current instance in DER encoding.
+     *
+     * @example
+     * const der = signature.toDER('hex');
+     */
+    toDER(enc) {
+        const constructLength = (arr, len) => {
+            if (len < 0x80) {
+                arr.push(len);
+            }
+            else {
+                throw new Error('len must be < 0x80');
+            }
+        };
+        const rmPadding = (buf) => {
+            let i = 0;
+            const len = buf.length - 1;
+            while (buf[i] === 0 && (buf[i + 1] & 0x80) === 0 && i < len) {
+                i++;
+            }
+            if (i === 0) {
+                return buf;
+            }
+            return buf.slice(i);
+        };
+        let r = this.r.toArray();
+        let s = this.s.toArray();
+        // Pad values
+        if ((r[0] & 0x80) !== 0) {
+            r = [0].concat(r);
+        }
+        // Pad values
+        if ((s[0] & 0x80) !== 0) {
+            s = [0].concat(s);
+        }
+        r = rmPadding(r);
+        s = rmPadding(s);
+        while (s[0] === 0 && (s[1] & 0x80) === 0) {
+            s = s.slice(1);
+        }
+        let arr = [0x02];
+        constructLength(arr, r.length);
+        arr = arr.concat(r);
+        arr.push(0x02);
+        constructLength(arr, s.length);
+        const backHalf = arr.concat(s);
+        let res = [0x30];
+        constructLength(res, backHalf.length);
+        res = res.concat(backHalf);
+        if (enc === 'hex') {
+            return toHex(res);
+        }
+        else if (enc === 'base64') {
+            return toBase64(res);
+        }
+        else {
+            return res;
+        }
+    }
+    /**
+     * Converts an instance of Signature into Compact encoding.
+     *
+     * If the encoding parameter is set to 'hex', the function will return a hex string.
+     * If 'base64', it will return a base64 string.
+     * Otherwise, it will return an array of numbers.
+     *
+     * @method toCompact
+     * @param enc - The encoding to use for the output.
+     * @returns The current instance in DER encoding.
+     *
+     * @example
+     * const compact = signature.toCompact(3, true, 'base64');
+     */
+    toCompact(recovery, compressed, enc) {
+        if (recovery < 0 || recovery > 3)
+            throw new Error('Invalid recovery param');
+        if (typeof compressed !== 'boolean') {
+            throw new Error('Invalid compressed param');
+        }
+        let compactByte = 27 + recovery;
+        if (compressed) {
+            compactByte += 4;
+        }
+        let arr = [compactByte];
+        arr = arr.concat(this.r.toArray('be', 32));
+        arr = arr.concat(this.s.toArray('be', 32));
+        if (enc === 'hex') {
+            return toHex(arr);
+        }
+        else if (enc === 'base64') {
+            return toBase64(arr);
+        }
+        else {
+            return arr;
+        }
+    }
+    /**
+     * Recovers the public key from a signature.
+     * This method will return the public key if it finds a valid public key.
+     * If it does not find a valid public key, it will throw an error.
+     * The recovery factor is a number between 0 and 3.
+     * @method RecoverPublicKey
+     * @param recovery - The recovery factor.
+     * @param e - The message hash.
+     * @returns The public key associated with the signature.
+     *
+     * @example
+     * const publicKey = signature.RecoverPublicKey(0, msgHash);
+     */
+    RecoverPublicKey(recovery, e) {
+        const r = this.r;
+        const s = this.s;
+        // A set LSB signifies that the y-coordinate is odd
+        const isYOdd = (recovery & 1) !== 0;
+        // The more significant bit specifies whether we should use the
+        // first or second candidate key.
+        const isSecondKey = recovery >> 1;
+        const curve = new Curve();
+        const n = curve.n;
+        const G = curve.g;
+        // 1.1 LEt x = r + jn
+        const x = isSecondKey !== 0 ? r.add(n) : r;
+        const R = Point.fromX(x, isYOdd);
+        // 1.4 Check that nR is at infinity
+        const nR = R.mul(n);
+        if (!nR.isInfinity()) {
+            throw new Error('nR is not at infinity');
+        }
+        // Compute -e from e
+        const eNeg = e.neg().umod(n);
+        // 1.6.1 Compute Q = r^-1 (sR - eG)
+        // Q = r^-1 (sR + -eG)
+        const rInv = r.invm(n);
+        // const Q = R.multiplyTwo(s, G, eNeg).mul(rInv)
+        const srInv = rInv.mul(s).umod(n);
+        const eInvrInv = rInv.mul(eNeg).umod(n);
+        const Q = G.mul(eInvrInv).add(R.mul(srInv));
+        const pubKey = new PublicKey(Q);
+        pubKey.validate();
+        return pubKey;
+    }
+    /**
+     * Calculates the recovery factor which will work for a particular public key and message hash.
+     * This method will return the recovery factor if it finds a valid recovery factor.
+     * If it does not find a valid recovery factor, it will throw an error.
+     * The recovery factor is a number between 0 and 3.
+     *
+     * @method CalculateRecoveryFactor
+     * @param msgHash - The message hash.
+     * @returns the recovery factor: number
+     * /
+     * @example
+     * const recovery = signature.CalculateRecoveryFactor(publicKey, msgHash);
+     */
+    CalculateRecoveryFactor(pubkey, msgHash) {
+        for (let recovery = 0; recovery < 4; recovery++) {
+            let Qprime;
+            try {
+                Qprime = this.RecoverPublicKey(recovery, msgHash);
+            }
+            catch {
+                continue;
+            }
+            if (pubkey.eq(Qprime)) {
+                return recovery;
+            }
+        }
+        throw new Error('Unable to find valid recovery factor');
+    }
+}
+//# sourceMappingURL=Signature.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/primitives/Signature.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/esm/src/primitives/SymmetricKey.js

@@ -0,0 +1,90 @@
+import BigNumber from './BigNumber.js';
+import { AESGCM, AESGCMDecrypt } from './AESGCM.js';
+import Random from './Random.js';
+import { toArray, encode } from './utils.js';
+/**
+ * `SymmetricKey` is a class that extends the `BigNumber` class and implements symmetric encryption and decryption methods.
+ * Symmetric-Key encryption is a form of encryption where the same key is used to encrypt and decrypt the message.
+ * It leverages the Advanced Encryption Standard Galois/Counter Mode (AES-GCM) for encryption and decryption of messages.
+ *
+ * @class SymmetricKey
+ * @extends {BigNumber}
+ */
+export default class SymmetricKey extends BigNumber {
+    /**
+     * Generates a symmetric key randomly.
+     *
+     * @method fromRandom
+     * @static
+     * @returns The newly generated Symmetric Key.
+     *
+     * @example
+     * const symmetricKey = SymmetricKey.fromRandom();
+     */
+    static fromRandom() {
+        return new SymmetricKey(Random(32));
+    }
+    /**
+     * Encrypts a given message using AES-GCM encryption.
+     * The generated Initialization Vector (IV) is attached to the encrypted message for decryption purposes.
+     * The OpenSSL format of |IV|encryptedContent|authTag| is used.
+     *
+     * @method encrypt
+     * @param msg - The message to be encrypted. It can be a string or an array of numbers.
+     * @param enc - optional. The encoding of the message. If hex, the string is assumed to be hex, UTF-8 otherwise.
+     * @returns Returns the encrypted message as a string or an array of numbers, depending on `enc` argument.
+     *
+     * @example
+     * const key = new SymmetricKey(1234);
+     * const encryptedMessage = key.encrypt('plainText', 'utf8');
+     */
+    encrypt(msg, enc) {
+        const iv = Random(32);
+        msg = toArray(msg, enc);
+        const keyBytes = this.toArray('be', 32);
+        const { result, authenticationTag } = AESGCM(msg, [], iv, keyBytes);
+        const totalLength = iv.length + result.length + authenticationTag.length;
+        const combined = new Array(totalLength);
+        let offset = 0;
+        for (const chunk of [iv, result, authenticationTag]) {
+            for (let i = 0; i < chunk.length; i++) {
+                combined[offset++] = chunk[i];
+            }
+        }
+        return encode(combined, enc);
+    }
+    /**
+     * Decrypts a given AES-GCM encrypted message using the same key that was used for encryption.
+     * The method extracts the IV and the authentication tag from the encrypted message, then attempts to decrypt it.
+     * If the decryption fails (e.g., due to message tampering), an error is thrown.
+     *
+     * @method decrypt
+     * @param msg - The encrypted message to be decrypted. It can be a string or an array of numbers.
+     * @param enc - optional. The encoding of the message (if no encoding is provided, uses utf8 for strings, unless specified as hex).
+     * @returns Returns the decrypted message as a string or an array of numbers, depending on `enc` argument. If absent, an array of numbers is returned.
+     *
+     * @example
+     * const key = new SymmetricKey(1234);
+     * const decryptedMessage = key.decrypt(encryptedMessage, 'utf8');
+     *
+     * @throws {Error} Will throw an error if the decryption fails, likely due to message tampering or incorrect decryption key.
+     */
+    decrypt(msg, enc) {
+        msg = toArray(msg, enc);
+        const ivLength = 32;
+        const tagLength = 16;
+        if (msg.length < ivLength + tagLength) {
+            throw new Error('Ciphertext too short');
+        }
+        const iv = msg.slice(0, ivLength);
+        const tagStart = msg.length - tagLength;
+        const ciphertext = msg.slice(ivLength, tagStart);
+        const messageTag = msg.slice(tagStart);
+        const result = AESGCMDecrypt(ciphertext, [], iv, messageTag, this.toArray('be', 32));
+        if (result === null) {
+            throw new Error('Decryption failed!');
+        }
+        return encode(result, enc);
+    }
+}
+//# sourceMappingURL=SymmetricKey.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/primitives/SymmetricKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymmetricKey.js","sourceRoot":"","sources":["../../../../src/primitives/SymmetricKey.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS;IACjD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAE,GAAsB,EAAE,GAAW;QAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;QACrB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACvC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;QACnE,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAA;QACxE,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;QACvC,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAE,GAAsB,EAAE,GAAoB;QACnD,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAEvB,MAAM,QAAQ,GAAG,EAAE,CAAA;QACnB,MAAM,SAAS,GAAG,EAAE,CAAA;QAEpB,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,SAAS,CAAA;QACvC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAEtC,MAAM,MAAM,GAAG,aAAa,CAC1B,UAAU,EACV,EAAE,EACF,EAAE,EACF,UAAU,EACV,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CACvB,CAAA;QACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF"}

package/mobile/node_modules/@bsv/sdk/dist/esm/src/primitives/TransactionSignature.js

@@ -0,0 +1,197 @@
+import Signature from './Signature.js';
+import BigNumber from './BigNumber.js';
+import * as Hash from './Hash.js';
+import { toArray, Writer } from './utils.js';
+const EMPTY_SCRIPT = new Uint8Array(0);
+export default class TransactionSignature extends Signature {
+    static SIGHASH_ALL = 0x00000001;
+    static SIGHASH_NONE = 0x00000002;
+    static SIGHASH_SINGLE = 0x00000003;
+    static SIGHASH_FORKID = 0x00000040;
+    static SIGHASH_ANYONECANPAY = 0x00000080;
+    scope;
+    /**
+     * Formats the SIGHASH preimage for the targeted input, optionally using a cache to skip recomputing shared hash prefixes.
+     * @param params - Context for the signing input plus transaction metadata.
+     * @param params.cache - Optional cache storing previously computed `hashPrevouts`, `hashSequence`, or `hashOutputs*` values; it will be populated if present.
+     */
+    static format(params) {
+        return Array.from(this.formatBytes(params));
+    }
+    /**
+     * Formats the same SIGHASH preimage bytes as `format`, supporting the optional cache for hash reuse.
+     * @param params - Context for the signing operation.
+     * @param params.cache - Optional `SignatureHashCache` that may already contain hashed prefixes and is populated during formatting.
+     * @returns Bytes for signing.
+     */
+    static formatBytes(params) {
+        const cache = params.cache;
+        const currentInput = {
+            sourceTXID: params.sourceTXID,
+            sourceOutputIndex: params.sourceOutputIndex,
+            sequence: params.inputSequence
+        };
+        const inputs = [...params.otherInputs];
+        inputs.splice(params.inputIndex, 0, currentInput);
+        const getPrevoutHash = () => {
+            const writer = new Writer();
+            for (const input of inputs) {
+                if (typeof input.sourceTXID === 'undefined') {
+                    if (input.sourceTransaction == null) {
+                        throw new Error('Missing sourceTransaction for input');
+                    }
+                    writer.write(input.sourceTransaction.hash());
+                }
+                else {
+                    writer.writeReverse(toArray(input.sourceTXID, 'hex'));
+                }
+                writer.writeUInt32LE(input.sourceOutputIndex);
+            }
+            return Hash.hash256(writer.toUint8Array());
+        };
+        const getSequenceHash = () => {
+            const writer = new Writer();
+            for (const input of inputs) {
+                const sequence = input.sequence ?? 0xffffffff; // Default to max sequence number
+                writer.writeUInt32LE(sequence);
+            }
+            return Hash.hash256(writer.toUint8Array());
+        };
+        function getOutputsHash(outputIndex) {
+            const writer = new Writer();
+            if (typeof outputIndex === 'undefined') {
+                for (const output of params.outputs) {
+                    const satoshis = output.satoshis ?? 0; // Default to 0 if undefined
+                    writer.writeUInt64LE(satoshis);
+                    const script = output.lockingScript?.toUint8Array() ?? EMPTY_SCRIPT;
+                    writer.writeVarIntNum(script.length);
+                    writer.write(script);
+                }
+            }
+            else {
+                const output = params.outputs[outputIndex];
+                if (output === undefined) { // ✅ Explicitly check for undefined
+                    throw new Error(`Output at index ${outputIndex} does not exist`);
+                }
+                const satoshis = output.satoshis ?? 0; // Default to 0 if undefined
+                writer.writeUInt64LE(satoshis);
+                const script = output.lockingScript?.toUint8Array() ?? EMPTY_SCRIPT;
+                writer.writeVarIntNum(script.length);
+                writer.write(script);
+            }
+            return Hash.hash256(writer.toUint8Array());
+        }
+        let hashPrevouts = new Array(32).fill(0);
+        let hashSequence = new Array(32).fill(0);
+        let hashOutputs = new Array(32).fill(0);
+        if ((params.scope & TransactionSignature.SIGHASH_ANYONECANPAY) === 0) {
+            if (cache?.hashPrevouts != null) {
+                hashPrevouts = cache.hashPrevouts;
+            }
+            else {
+                hashPrevouts = getPrevoutHash();
+                if (cache != null)
+                    cache.hashPrevouts = hashPrevouts;
+            }
+        }
+        if ((params.scope & TransactionSignature.SIGHASH_ANYONECANPAY) === 0 &&
+            (params.scope & 31) !== TransactionSignature.SIGHASH_SINGLE &&
+            (params.scope & 31) !== TransactionSignature.SIGHASH_NONE) {
+            if (cache?.hashSequence != null) {
+                hashSequence = cache.hashSequence;
+            }
+            else {
+                hashSequence = getSequenceHash();
+                if (cache != null)
+                    cache.hashSequence = hashSequence;
+            }
+        }
+        if ((params.scope & 31) !== TransactionSignature.SIGHASH_SINGLE &&
+            (params.scope & 31) !== TransactionSignature.SIGHASH_NONE) {
+            if (cache?.hashOutputsAll != null) {
+                hashOutputs = cache.hashOutputsAll;
+            }
+            else {
+                hashOutputs = getOutputsHash();
+                if (cache != null)
+                    cache.hashOutputsAll = hashOutputs;
+            }
+        }
+        else if ((params.scope & 31) === TransactionSignature.SIGHASH_SINGLE &&
+            params.inputIndex < params.outputs.length) {
+            const key = params.inputIndex;
+            const cachedSingle = cache?.hashOutputsSingle?.get(key);
+            if (cachedSingle != null) {
+                hashOutputs = cachedSingle;
+            }
+            else {
+                hashOutputs = getOutputsHash(key);
+                if (cache != null) {
+                    if (cache.hashOutputsSingle == null)
+                        cache.hashOutputsSingle = new Map();
+                    cache.hashOutputsSingle.set(key, hashOutputs);
+                }
+            }
+        }
+        const writer = new Writer();
+        // Version
+        writer.writeInt32LE(params.transactionVersion);
+        // Input prevouts/nSequence (none/all, depending on flags)
+        writer.write(hashPrevouts);
+        writer.write(hashSequence);
+        //  outpoint (32-byte hash + 4-byte little endian)
+        writer.writeReverse(toArray(params.sourceTXID, 'hex'));
+        writer.writeUInt32LE(params.sourceOutputIndex);
+        // scriptCode of the input (serialized as scripts inside CTxOuts)
+        const subscriptBin = params.subscript.toUint8Array();
+        writer.writeVarIntNum(subscriptBin.length);
+        writer.write(subscriptBin);
+        // value of the output spent by this input (8-byte little endian)
+        writer.writeUInt64LE(params.sourceSatoshis);
+        // nSequence of the input (4-byte little endian)
+        const sequenceNumber = currentInput.sequence;
+        writer.writeUInt32LE(sequenceNumber);
+        // Outputs (none/one/all, depending on flags)
+        writer.write(hashOutputs);
+        // Locktime
+        writer.writeUInt32LE(params.lockTime);
+        // sighashType
+        writer.writeUInt32LE(params.scope >>> 0);
+        return writer.toUint8Array();
+    }
+    // The format used in a tx
+    static fromChecksigFormat(buf) {
+        if (buf.length === 0) {
+            // allow setting a "blank" signature
+            const r = new BigNumber(1);
+            const s = new BigNumber(1);
+            const scope = 1;
+            return new TransactionSignature(r, s, scope);
+        }
+        const scope = buf[buf.length - 1];
+        const derbuf = buf.slice(0, buf.length - 1);
+        const tempSig = Signature.fromDER(derbuf);
+        return new TransactionSignature(tempSig.r, tempSig.s, scope);
+    }
+    constructor(r, s, scope) {
+        super(r, s);
+        this.scope = scope;
+    }
+    /**
+     * Compares to bitcoind's IsLowDERSignature
+     * See also Ecdsa signature algorithm which enforces this.
+     * See also Bip 62, "low S values in signatures"
+     */
+    hasLowS() {
+        if (this.s.ltn(1) ||
+            this.s.gt(new BigNumber('7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0', 'hex'))) {
+            return false;
+        }
+        return true;
+    }
+    toChecksigFormat() {
+        const derbuf = this.toDER();
+        return [...derbuf, this.scope];
+    }
+}
+//# sourceMappingURL=TransactionSignature.js.map