@bsv/wallet-toolbox 1.7.14 → 1.7.15

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

@@ -0,0 +1,358 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BigNumber_js_1 = __importDefault(require("./BigNumber.js"));
+const PublicKey_js_1 = __importDefault(require("./PublicKey.js"));
+const ECDSA_js_1 = require("./ECDSA.js");
+const Hash_js_1 = require("./Hash.js");
+const utils_js_1 = require("./utils.js");
+const Point_js_1 = __importDefault(require("./Point.js"));
+const Curve_js_1 = __importDefault(require("./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
+ */
+class Signature {
+    /**
+     * 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 {
+            constructor() {
+                this.place = 0;
+            }
+        }
+        data = (0, utils_js_1.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_js_1.default(r), new BigNumber_js_1.default(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 = (0, utils_js_1.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_js_1.default(data.slice(1, 33)), new BigNumber_js_1.default(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_js_1.default((0, Hash_js_1.sha256)(msg, enc), 16);
+        return (0, ECDSA_js_1.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 (0, utils_js_1.toHex)(res);
+        }
+        else if (enc === 'base64') {
+            return (0, utils_js_1.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 (0, utils_js_1.toHex)(arr);
+        }
+        else if (enc === 'base64') {
+            return (0, utils_js_1.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_js_1.default();
+        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_js_1.default.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_js_1.default(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');
+    }
+}
+exports.default = Signature;
+//# sourceMappingURL=Signature.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/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/cjs/src/primitives/SymmetricKey.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BigNumber_js_1 = __importDefault(require("./BigNumber.js"));
+const AESGCM_js_1 = require("./AESGCM.js");
+const Random_js_1 = __importDefault(require("./Random.js"));
+const utils_js_1 = require("./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}
+ */
+class SymmetricKey extends BigNumber_js_1.default {
+    /**
+     * Generates a symmetric key randomly.
+     *
+     * @method fromRandom
+     * @static
+     * @returns The newly generated Symmetric Key.
+     *
+     * @example
+     * const symmetricKey = SymmetricKey.fromRandom();
+     */
+    static fromRandom() {
+        return new SymmetricKey((0, Random_js_1.default)(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 = (0, Random_js_1.default)(32);
+        msg = (0, utils_js_1.toArray)(msg, enc);
+        const keyBytes = this.toArray('be', 32);
+        const { result, authenticationTag } = (0, AESGCM_js_1.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 (0, utils_js_1.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 = (0, utils_js_1.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 = (0, AESGCM_js_1.AESGCMDecrypt)(ciphertext, [], iv, messageTag, this.toArray('be', 32));
+        if (result === null) {
+            throw new Error('Decryption failed!');
+        }
+        return (0, utils_js_1.encode)(result, enc);
+    }
+}
+exports.default = SymmetricKey;
+//# sourceMappingURL=SymmetricKey.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SymmetricKey.js","sourceRoot":"","sources":["../../../../src/primitives/SymmetricKey.ts"],"names":[],"mappings":";;;;;AAAA,kEAAsC;AACtC,2CAAmD;AACnD,4DAAgC;AAChC,yCAA4C;AAE5C;;;;;;;GAOG;AACH,MAAqB,YAAa,SAAQ,sBAAS;IACjD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,YAAY,CAAC,IAAA,mBAAM,EAAC,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAE,GAAsB,EAAE,GAAW;QAC1C,MAAM,EAAE,GAAG,IAAA,mBAAM,EAAC,EAAE,CAAC,CAAA;QACrB,GAAG,GAAG,IAAA,kBAAO,EAAC,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,IAAA,kBAAM,EAAC,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,IAAA,iBAAM,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAE,GAAsB,EAAE,GAAoB;QACnD,GAAG,GAAG,IAAA,kBAAO,EAAC,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,IAAA,yBAAa,EAC1B,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,IAAA,iBAAM,EAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF;AAxFD,+BAwFC"}