@bsv/sdk 1.0.0

package/dist/esm/src/primitives/Signature.js

@@ -0,0 +1,223 @@
+import BigNumber from './BigNumber.js';
+import { verify } from './ECDSA.js';
+import { sha256 } from './Hash.js';
+import { toArray, toHex, toBase64 } from './utils.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);
+        // Support compact signatures
+        if (data.length === 65) {
+            return new Signature(new BigNumber(data.slice(1, 33)), new BigNumber(data.slice(33, 65)));
+        }
+        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));
+    }
+    /**
+     * 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;
+        }
+    }
+}
+//# sourceMappingURL=Signature.js.map

package/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/dist/esm/src/primitives/SymmetricKey.js

@@ -0,0 +1,63 @@
+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 {
+    /**
+    * 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 { result, authenticationTag } = AESGCM(msg, [], iv, this.toArray());
+        return encode([...iv, ...result, ...authenticationTag], 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 iv = msg.slice(0, 32);
+        const ciphertextWithTag = msg.slice(32);
+        const messageTag = ciphertextWithTag.slice(-16);
+        const ciphertext = ciphertextWithTag.slice(0, -16);
+        const result = AESGCMDecrypt(ciphertext, [], iv, messageTag, this.toArray());
+        if (result === null) {
+            throw new Error('Decryption failed!');
+        }
+        return encode(result, enc);
+    }
+}
+//# sourceMappingURL=SymmetricKey.js.map

package/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;;;;;;;;;;;;;MAaE;IACF,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,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAC1C,GAAG,EACH,EAAE,EACF,EAAE,EACF,IAAI,CAAC,OAAO,EAAE,CACf,CAAA;QACD,OAAO,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAA;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAE,GAAsB,EAAE,GAAoB;QACnD,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAa,CAAA;QACnC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC3B,MAAM,iBAAiB,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;QAC/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,aAAa,CAC1B,UAAU,EACV,EAAE,EACF,EAAE,EACF,UAAU,EACV,IAAI,CAAC,OAAO,EAAE,CACf,CAAA;QACD,IAAI,MAAM,KAAK,IAAI,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;SACtC;QACD,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF"}

package/dist/esm/src/primitives/TransactionSignature.js

@@ -0,0 +1,144 @@
+import Signature from './Signature.js';
+import BigNumber from './BigNumber.js';
+import * as Hash from './Hash.js';
+import { toArray, Writer } from './utils.js';
+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;
+    static format(params) {
+        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.sourceTransaction === 'undefined') {
+                    writer.writeReverse(toArray(input.sourceTXID, 'hex'));
+                }
+                else {
+                    writer.writeReverse(input.sourceTransaction.id());
+                }
+                writer.writeUInt32LE(input.sourceOutputIndex);
+            }
+            const buf = writer.toArray();
+            const ret = Hash.hash256(buf);
+            return ret;
+        };
+        const getSequenceHash = () => {
+            const writer = new Writer();
+            for (const input of inputs) {
+                writer.writeUInt32LE(input.sequence);
+            }
+            const buf = writer.toArray();
+            const ret = Hash.hash256(buf);
+            return ret;
+        };
+        function getOutputsHash(outputIndex) {
+            const writer = new Writer();
+            if (typeof outputIndex === 'undefined') {
+                let script;
+                for (const output of params.outputs) {
+                    writer.writeUInt64LE(output.satoshis);
+                    script = output.lockingScript.toBinary();
+                    writer.writeVarIntNum(script.length);
+                    writer.write(script);
+                }
+            }
+            else {
+                const output = params.outputs[outputIndex];
+                writer.writeUInt64LE(output.satoshis);
+                const script = output.lockingScript.toBinary();
+                writer.writeVarIntNum(script.length);
+                writer.write(script);
+            }
+            const buf = writer.toArray();
+            const ret = Hash.hash256(buf);
+            return ret;
+        }
+        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) {
+            hashPrevouts = getPrevoutHash();
+        }
+        if ((params.scope & TransactionSignature.SIGHASH_ANYONECANPAY) === 0 &&
+            (params.scope & 31) !== TransactionSignature.SIGHASH_SINGLE &&
+            (params.scope & 31) !== TransactionSignature.SIGHASH_NONE) {
+            hashSequence = getSequenceHash();
+        }
+        if ((params.scope & 31) !== TransactionSignature.SIGHASH_SINGLE && (params.scope & 31) !== TransactionSignature.SIGHASH_NONE) {
+            hashOutputs = getOutputsHash();
+        }
+        else if ((params.scope & 31) === TransactionSignature.SIGHASH_SINGLE && params.inputIndex < params.outputs.length) {
+            hashOutputs = getOutputsHash(params.inputIndex);
+        }
+        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)
+        writer.writeVarIntNum(params.subscript.toBinary().length);
+        writer.write(params.subscript.toBinary());
+        // 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);
+        const buf = writer.toArray();
+        return buf;
+    }
+    // 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

package/dist/esm/src/primitives/TransactionSignature.js.map

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

package/dist/esm/src/primitives/index.js

@@ -0,0 +1,9 @@
+export { default as BigNumber } from './BigNumber.js';
+export { default as Point } from './Point.js';
+export { default as PublicKey } from './PublicKey.js';
+export { default as Signature } from './Signature.js';
+export { default as PrivateKey } from './PrivateKey.js';
+export { default as SymmetricKey } from './SymmetricKey.js';
+export * as Hash from './Hash.js';
+export { default as Random } from './Random.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA"}