@bsv/wallet-toolbox 1.7.14 → 1.7.15

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/CachedKeyDeriver.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../primitives/index.js");
+const KeyDeriver_js_1 = require("./KeyDeriver.js");
+/**
+ * A cached version of KeyDeriver that caches the results of key derivation methods.
+ * This is useful for optimizing performance when the same keys are derived multiple times.
+ * It supports configurable cache size with sane defaults and maintains cache entries using LRU (Least Recently Used) eviction policy.
+ */
+class CachedKeyDeriver {
+    /**
+     * Initializes the CachedKeyDeriver instance with a root private key and optional cache settings.
+     * @param {PrivateKey | 'anyone'} rootKey - The root private key or the string 'anyone'.
+     * @param {Object} [options] - Optional settings for the cache.
+     * @param {number} [options.maxCacheSize=1000] - The maximum number of entries to store in the cache.
+     */
+    constructor(rootKey, options) {
+        if (rootKey === 'anyone') {
+            this.rootKey = new index_js_1.PrivateKey(1);
+        }
+        else {
+            this.rootKey = rootKey;
+        }
+        this.keyDeriver = new KeyDeriver_js_1.KeyDeriver(this.rootKey, (priv, pub, point) => {
+            this.cacheSet(`${priv.toString()}-${pub.toString()}`, point);
+        }, (priv, pub) => {
+            return this.cacheGet(`${priv.toString()}-${pub.toString()}`);
+        });
+        this.identityKey = this.rootKey.toPublicKey().toString();
+        this.cache = new Map();
+        const maxCacheSize = options?.maxCacheSize;
+        this.maxCacheSize = (maxCacheSize != null && !isNaN(maxCacheSize) && maxCacheSize > 0) ? maxCacheSize : 1000;
+    }
+    /**
+     * Derives a public key based on protocol ID, key ID, and counterparty.
+     * Caches the result for future calls with the same parameters.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @param {boolean} [forSelf=false] - Whether deriving for self.
+     * @returns {PublicKey} - The derived public key.
+     */
+    derivePublicKey(protocolID, keyID, counterparty, forSelf = false) {
+        const cacheKey = this.generateCacheKey('derivePublicKey', protocolID, keyID, counterparty, forSelf);
+        if (this.cache.has(cacheKey)) {
+            const cachedValue = this.cacheGet(cacheKey);
+            if (cachedValue === undefined) {
+                throw new Error('Cached value is undefined');
+            }
+            return cachedValue;
+        }
+        else {
+            const result = this.keyDeriver.derivePublicKey(protocolID, keyID, counterparty, forSelf);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+     * Derives a private key based on protocol ID, key ID, and counterparty.
+     * Caches the result for future calls with the same parameters.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {PrivateKey} - The derived private key.
+     */
+    derivePrivateKey(protocolID, keyID, counterparty) {
+        const cacheKey = this.generateCacheKey('derivePrivateKey', protocolID, keyID, counterparty);
+        if (this.cache.has(cacheKey)) {
+            const cachedValue = this.cacheGet(cacheKey);
+            if (cachedValue === undefined) {
+                throw new Error('Cached value is undefined');
+            }
+            return cachedValue;
+        }
+        else {
+            const result = this.keyDeriver.derivePrivateKey(protocolID, keyID, counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+     * Derives a symmetric key based on protocol ID, key ID, and counterparty.
+     * Caches the result for future calls with the same parameters.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {SymmetricKey} - The derived symmetric key.
+     * @throws {Error} - Throws an error if attempting to derive a symmetric key for 'anyone'.
+     */
+    deriveSymmetricKey(protocolID, keyID, counterparty) {
+        const cacheKey = this.generateCacheKey('deriveSymmetricKey', protocolID, keyID, counterparty);
+        if (this.cache.has(cacheKey)) {
+            const cachedValue = this.cacheGet(cacheKey);
+            if (cachedValue === undefined) {
+                throw new Error('Cached value is undefined');
+            }
+            return cachedValue;
+        }
+        else {
+            const result = this.keyDeriver.deriveSymmetricKey(protocolID, keyID, counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+     * Reveals the shared secret between the root key and the counterparty.
+     * Caches the result for future calls with the same parameters.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {number[]} - The shared secret as a number array.
+     * @throws {Error} - Throws an error if attempting to reveal a shared secret for 'self'.
+     */
+    revealCounterpartySecret(counterparty) {
+        const cacheKey = this.generateCacheKey('revealCounterpartySecret', counterparty);
+        if (this.cache.has(cacheKey)) {
+            const cachedValue = this.cacheGet(cacheKey);
+            if (cachedValue === undefined) {
+                throw new Error('Cached value is undefined');
+            }
+            return cachedValue;
+        }
+        else {
+            const result = this.keyDeriver.revealCounterpartySecret(counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+     * Reveals the specific key association for a given protocol ID, key ID, and counterparty.
+     * Caches the result for future calls with the same parameters.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @returns {number[]} - The specific key association as a number array.
+     */
+    revealSpecificSecret(counterparty, protocolID, keyID) {
+        const cacheKey = this.generateCacheKey('revealSpecificSecret', counterparty, protocolID, keyID);
+        if (this.cache.has(cacheKey)) {
+            const cachedValue = this.cacheGet(cacheKey);
+            if (cachedValue === undefined) {
+                throw new Error('Cached value is undefined');
+            }
+            return cachedValue;
+        }
+        else {
+            const result = this.keyDeriver.revealSpecificSecret(counterparty, protocolID, keyID);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+     * Generates a unique cache key based on the method name and input parameters.
+     * @param {string} methodName - The name of the method.
+     * @param {...any} args - The arguments passed to the method.
+     * @returns {string} - The generated cache key.
+     */
+    generateCacheKey(methodName, ...args) {
+        const serializedArgs = args
+            .map((arg) => this.serializeArgument(arg))
+            .join('|');
+        return `${methodName}|${serializedArgs}`;
+    }
+    /**
+     * Serializes an argument to a string for use in a cache key.
+     * @param {any} arg - The argument to serialize.
+     * @returns {string} - The serialized argument.
+     */
+    serializeArgument(arg) {
+        if (arg instanceof index_js_1.PublicKey || arg instanceof index_js_1.PrivateKey) {
+            return arg.toString();
+        }
+        else if (Array.isArray(arg)) {
+            return arg.map((item) => this.serializeArgument(item)).join(',');
+        }
+        else if (typeof arg === 'object' && arg !== null) {
+            return JSON.stringify(arg);
+        }
+        else {
+            return String(arg);
+        }
+    }
+    /**
+     * Retrieves an item from the cache and updates its position to reflect recent use.
+     * @param {string} cacheKey - The key of the cached item.
+     * @returns {any} - The cached value.
+     */
+    cacheGet(cacheKey) {
+        const value = this.cache.get(cacheKey);
+        // Update the entry to reflect recent use
+        this.cache.delete(cacheKey);
+        if (value !== undefined) {
+            this.cache.set(cacheKey, value);
+        }
+        return value;
+    }
+    /**
+     * Adds an item to the cache and evicts the least recently used item if necessary.
+     * @param {string} cacheKey - The key of the item to cache.
+     * @param {any} value - The value to cache.
+     */
+    cacheSet(cacheKey, value) {
+        if (this.cache.size >= this.maxCacheSize) {
+            // Evict the least recently used item (first item in Map)
+            const firstKey = this.cache.keys().next().value;
+            this.cache.delete(firstKey);
+        }
+        this.cache.set(cacheKey, value);
+    }
+}
+exports.default = CachedKeyDeriver;
+//# sourceMappingURL=CachedKeyDeriver.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/CachedKeyDeriver.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/KeyDeriver.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyDeriver = void 0;
+const index_js_1 = require("../primitives/index.js");
+/**
+ * Class responsible for deriving various types of keys using a root private key.
+ * It supports deriving public and private keys, symmetric keys, and revealing key linkages.
+ */
+class KeyDeriver {
+    /**
+     * Initializes the KeyDeriver instance with a root private key.
+     * @param {PrivateKey | 'anyone'} rootKey - The root private key or the string 'anyone'.
+     */
+    constructor(rootKey, cacheSharedSecret, retrieveCachedSharedSecret) {
+        this.cacheSharedSecret = cacheSharedSecret;
+        this.retrieveCachedSharedSecret = retrieveCachedSharedSecret;
+        this.anyone = new index_js_1.PrivateKey(1).toPublicKey();
+        if (rootKey === 'anyone') {
+            this.rootKey = new index_js_1.PrivateKey(1);
+        }
+        else {
+            this.rootKey = rootKey;
+        }
+        this.identityKey = this.rootKey.toPublicKey().toString();
+    }
+    /**
+     * Derives a public key based on protocol ID, key ID, and counterparty.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @param {boolean} [forSelf=false] - Whether deriving for self.
+     * @returns {PublicKey} - The derived public key.
+     */
+    derivePublicKey(protocolID, keyID, counterparty, forSelf = false) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        if (forSelf) {
+            return this.rootKey
+                .deriveChild(counterparty, this.computeInvoiceNumber(protocolID, keyID), this.cacheSharedSecret, this.retrieveCachedSharedSecret)
+                .toPublicKey();
+        }
+        else {
+            return counterparty.deriveChild(this.rootKey, this.computeInvoiceNumber(protocolID, keyID), this.cacheSharedSecret, this.retrieveCachedSharedSecret);
+        }
+    }
+    /**
+     * Derives a private key based on protocol ID, key ID, and counterparty.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {PrivateKey} - The derived private key.
+     */
+    derivePrivateKey(protocolID, keyID, counterparty) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        return this.rootKey.deriveChild(counterparty, this.computeInvoiceNumber(protocolID, keyID), this.cacheSharedSecret, this.retrieveCachedSharedSecret);
+    }
+    /**
+     * Derives a symmetric key based on protocol ID, key ID, and counterparty.
+     * Note: Symmetric keys should not be derivable by everyone due to security risks.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {SymmetricKey} - The derived symmetric key.
+     */
+    deriveSymmetricKey(protocolID, keyID, counterparty) {
+        // If counterparty is 'anyone', we use 1*G as the public key.
+        // This is a publicly derivable key and should only be used in scenarios where public disclosure is intended.
+        if (counterparty === 'anyone') {
+            counterparty = this.anyone;
+        }
+        else {
+            counterparty = this.normalizeCounterparty(counterparty);
+        }
+        const derivedPublicKey = this.derivePublicKey(protocolID, keyID, counterparty);
+        const derivedPrivateKey = this.derivePrivateKey(protocolID, keyID, counterparty);
+        return new index_js_1.SymmetricKey(derivedPrivateKey.deriveSharedSecret(derivedPublicKey)?.x?.toArray() ?? []);
+    }
+    /**
+     * Reveals the shared secret between the root key and the counterparty.
+     * Note: This should not be used for 'self'.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {number[]} - The shared secret as a number array.
+     * @throws {Error} - Throws an error if attempting to reveal a shared secret for 'self'.
+     */
+    revealCounterpartySecret(counterparty) {
+        if (counterparty === 'self') {
+            throw new Error('Counterparty secrets cannot be revealed for counterparty=self.');
+        }
+        counterparty = this.normalizeCounterparty(counterparty);
+        // Double-check to ensure not revealing the secret for 'self'
+        const self = this.rootKey.toPublicKey();
+        const keyDerivedBySelf = this.rootKey.deriveChild(self, 'test').toHex();
+        const keyDerivedByCounterparty = this.rootKey
+            .deriveChild(counterparty, 'test')
+            .toHex();
+        if (keyDerivedBySelf === keyDerivedByCounterparty) {
+            throw new Error('Counterparty secrets cannot be revealed for counterparty=self.');
+        }
+        return this.rootKey
+            .deriveSharedSecret(counterparty)
+            .encode(true);
+    }
+    /**
+     * Reveals the specific key association for a given protocol ID, key ID, and counterparty.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @returns {number[]} - The specific key association as a number array.
+     */
+    revealSpecificSecret(counterparty, protocolID, keyID) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        const sharedSecret = this.rootKey.deriveSharedSecret(counterparty);
+        const invoiceNumberBin = index_js_1.Utils.toArray(this.computeInvoiceNumber(protocolID, keyID), 'utf8');
+        return index_js_1.Hash.sha256hmac(sharedSecret.encode(true), invoiceNumberBin);
+    }
+    /**
+     * Normalizes the counterparty to a public key.
+     * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+     * @returns {PublicKey} - The normalized counterparty public key.
+     * @throws {Error} - Throws an error if the counterparty is invalid.
+     */
+    normalizeCounterparty(counterparty) {
+        if (counterparty === null || counterparty === undefined) {
+            throw new Error('counterparty must be self, anyone or a public key!');
+        }
+        else if (counterparty === 'self') {
+            return this.rootKey.toPublicKey();
+        }
+        else if (counterparty === 'anyone') {
+            return new index_js_1.PrivateKey(1).toPublicKey();
+        }
+        else if (typeof counterparty === 'string') {
+            return index_js_1.PublicKey.fromString(counterparty);
+        }
+        else {
+            return counterparty;
+        }
+    }
+    /**
+     * Computes the invoice number based on the protocol ID and key ID.
+     * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+     * @param {string} keyID - The key identifier.
+     * @returns {string} - The computed invoice number.
+     * @throws {Error} - Throws an error if protocol ID or key ID are invalid.
+     */
+    computeInvoiceNumber(protocolID, keyID) {
+        const securityLevel = protocolID[0];
+        if (!Number.isInteger(securityLevel) ||
+            securityLevel < 0 ||
+            securityLevel > 2) {
+            throw new Error('Protocol security level must be 0, 1, or 2');
+        }
+        const protocolName = protocolID[1].toLowerCase().trim();
+        if (keyID.length > 800) {
+            throw new Error('Key IDs must be 800 characters or less');
+        }
+        if (keyID.length < 1) {
+            throw new Error('Key IDs must be 1 character or more');
+        }
+        if (protocolName.length > 400) {
+            // Specific linkage revelation is the only protocol ID that can contain another protocol ID.
+            // Therefore, we allow it to be long enough to encapsulate the target protocol
+            if (protocolName.startsWith('specific linkage revelation ')) {
+                // The format is: 'specific linkage revelation x YYYYY'
+                // Where: x is the security level and YYYYY is the target protocol
+                // Thus, the max acceptable length is 30 + 400 = 430 bytes
+                if (protocolName.length > 430) {
+                    throw new Error('Specific linkage revelation protocol names must be 430 characters or less');
+                }
+            }
+            else {
+                throw new Error('Protocol names must be 400 characters or less');
+            }
+        }
+        if (protocolName.length < 5) {
+            throw new Error('Protocol names must be 5 characters or more');
+        }
+        if (protocolName.includes('  ')) {
+            throw new Error('Protocol names cannot contain multiple consecutive spaces ("  ")');
+        }
+        if (!/^[a-z0-9 ]+$/g.test(protocolName)) {
+            throw new Error('Protocol names can only contain letters, numbers and spaces');
+        }
+        if (protocolName.endsWith(' protocol')) {
+            throw new Error('No need to end your protocol name with " protocol"');
+        }
+        return `${securityLevel}-${protocolName}-${keyID}`;
+    }
+}
+exports.KeyDeriver = KeyDeriver;
+exports.default = KeyDeriver;
+//# sourceMappingURL=KeyDeriver.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/KeyDeriver.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/ProtoWallet.js

@@ -0,0 +1,188 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtoWallet = void 0;
+const CachedKeyDeriver_js_1 = __importDefault(require("./CachedKeyDeriver.js"));
+const index_js_1 = require("../primitives/index.js");
+/**
+ * A ProtoWallet is precursor to a full wallet, capable of performing all foundational cryptographic operations.
+ * It can derive keys, create signatures, facilitate encryption and HMAC operations, and reveal key linkages.
+ *
+ * However, ProtoWallet does not create transactions, manage outputs, interact with the blockchain,
+ * enable the management of identity certificates, or store any data. It is also not concerned with privileged keys.
+ */
+class ProtoWallet {
+    constructor(rootKeyOrKeyDeriver) {
+        if (typeof rootKeyOrKeyDeriver.identityKey !== 'string') {
+            rootKeyOrKeyDeriver = new CachedKeyDeriver_js_1.default(rootKeyOrKeyDeriver);
+        }
+        this.keyDeriver = rootKeyOrKeyDeriver;
+    }
+    async getPublicKey(args) {
+        if (args.identityKey) {
+            if (this.keyDeriver == null) {
+                throw new Error('keyDeriver is undefined');
+            }
+            return { publicKey: this.keyDeriver.rootKey.toPublicKey().toString() };
+        }
+        else {
+            if (args.protocolID == null || args.keyID == null || args.keyID === '') {
+                throw new Error('protocolID and keyID are required if identityKey is false or undefined.');
+            }
+            const keyDeriver = this.keyDeriver ??
+                (() => {
+                    throw new Error('keyDeriver is undefined');
+                })();
+            return {
+                publicKey: keyDeriver
+                    .derivePublicKey(args.protocolID, args.keyID, args.counterparty ?? 'self', args.forSelf)
+                    .toString()
+            };
+        }
+    }
+    async revealCounterpartyKeyLinkage(args) {
+        const { publicKey: identityKey } = await this.getPublicKey({
+            identityKey: true
+        });
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const linkage = this.keyDeriver.revealCounterpartySecret(args.counterparty);
+        const linkageProof = new index_js_1.Schnorr().generateProof(this.keyDeriver.rootKey, this.keyDeriver.rootKey.toPublicKey(), index_js_1.PublicKey.fromString(args.counterparty), index_js_1.Point.fromDER(linkage));
+        const linkageProofBin = [
+            ...linkageProof.R.encode(true),
+            ...linkageProof.SPrime.encode(true),
+            ...linkageProof.z.toArray()
+        ];
+        const revelationTime = new Date().toISOString();
+        const { ciphertext: encryptedLinkage } = await this.encrypt({
+            plaintext: linkage,
+            protocolID: [2, 'counterparty linkage revelation'],
+            keyID: revelationTime,
+            counterparty: args.verifier
+        });
+        const { ciphertext: encryptedLinkageProof } = await this.encrypt({
+            plaintext: linkageProofBin,
+            protocolID: [2, 'counterparty linkage revelation'],
+            keyID: revelationTime,
+            counterparty: args.verifier
+        });
+        return {
+            prover: identityKey,
+            verifier: args.verifier,
+            counterparty: args.counterparty,
+            revelationTime,
+            encryptedLinkage,
+            encryptedLinkageProof
+        };
+    }
+    async revealSpecificKeyLinkage(args) {
+        const { publicKey: identityKey } = await this.getPublicKey({
+            identityKey: true
+        });
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const linkage = this.keyDeriver.revealSpecificSecret(args.counterparty, args.protocolID, args.keyID);
+        const { ciphertext: encryptedLinkage } = await this.encrypt({
+            plaintext: linkage,
+            protocolID: [
+                2,
+                `specific linkage revelation ${args.protocolID[0]} ${args.protocolID[1]}`
+            ],
+            keyID: args.keyID,
+            counterparty: args.verifier
+        });
+        const { ciphertext: encryptedLinkageProof } = await this.encrypt({
+            plaintext: [0], // Proof type 0, no proof provided
+            protocolID: [
+                2,
+                `specific linkage revelation ${args.protocolID[0]} ${args.protocolID[1]}`
+            ],
+            keyID: args.keyID,
+            counterparty: args.verifier
+        });
+        return {
+            prover: identityKey,
+            verifier: args.verifier,
+            counterparty: args.counterparty,
+            protocolID: args.protocolID,
+            keyID: args.keyID,
+            encryptedLinkage,
+            encryptedLinkageProof,
+            proofType: 0
+        };
+    }
+    async encrypt(args) {
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty ?? 'self');
+        return { ciphertext: key.encrypt(args.plaintext) };
+    }
+    async decrypt(args, originator) {
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty ?? 'self');
+        return { plaintext: key.decrypt(args.ciphertext) };
+    }
+    async createHmac(args) {
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty ?? 'self');
+        return { hmac: index_js_1.Hash.sha256hmac(key.toArray(), args.data) };
+    }
+    async verifyHmac(args) {
+        if (this.keyDeriver == null) {
+            throw new Error('keyDeriver is undefined');
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty ?? 'self');
+        const valid = index_js_1.Hash.sha256hmac(key.toArray(), args.data).toString() ===
+            args.hmac.toString();
+        if (!valid) {
+            const e = new Error('HMAC is not valid');
+            e.code = 'ERR_INVALID_HMAC';
+            throw e;
+        }
+        return { valid };
+    }
+    async createSignature(args) {
+        if ((args.hashToDirectlySign == null) && (args.data == null)) {
+            throw new Error('args.data or args.hashToDirectlySign must be valid');
+        }
+        const hash = args.hashToDirectlySign ?? index_js_1.Hash.sha256(args.data ?? []);
+        const keyDeriver = this.keyDeriver ??
+            (() => {
+                throw new Error('keyDeriver is undefined');
+            })();
+        const key = keyDeriver.derivePrivateKey(args.protocolID, args.keyID, args.counterparty ?? 'anyone');
+        return {
+            signature: index_js_1.ECDSA.sign(new index_js_1.BigNumber(hash), key, true).toDER()
+        };
+    }
+    async verifySignature(args) {
+        if ((args.hashToDirectlyVerify == null) && (args.data == null)) {
+            throw new Error('args.data or args.hashToDirectlyVerify must be valid');
+        }
+        const hash = args.hashToDirectlyVerify ?? index_js_1.Hash.sha256(args.data ?? []);
+        const keyDeriver = this.keyDeriver ??
+            (() => {
+                throw new Error('keyDeriver is undefined');
+            })();
+        const key = keyDeriver.derivePublicKey(args.protocolID, args.keyID, args.counterparty ?? 'self', args.forSelf);
+        const valid = index_js_1.ECDSA.verify(new index_js_1.BigNumber(hash), index_js_1.Signature.fromDER(args.signature), key);
+        if (!valid) {
+            const e = new Error('Signature is not valid');
+            e.code = 'ERR_INVALID_SIGNATURE';
+            throw e;
+        }
+        return { valid };
+    }
+}
+exports.ProtoWallet = ProtoWallet;
+exports.default = ProtoWallet;
+//# sourceMappingURL=ProtoWallet.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/ProtoWallet.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/WERR_INSUFFICIENT_FUNDS.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WERR_INSUFFICIENT_FUNDS = void 0;
+/**
+ * Insufficient funds in the available inputs to cover the cost of the required outputs
+ * and the transaction fee (${moreSatoshisNeeded} more satoshis are needed,
+ * for a total of ${totalSatoshisNeeded}), plus whatever would be required in order
+ * to pay the fee to unlock and spend the outputs used to provide the additional satoshis.
+ */
+class WERR_INSUFFICIENT_FUNDS extends Error {
+    /**
+     * @param totalSatoshisNeeded Total satoshis required to fund transactions after net of required inputs and outputs.
+     * @param moreSatoshisNeeded Shortfall on total satoshis required to fund transactions after net of required inputs and outputs.
+     */
+    constructor(totalSatoshisNeeded, moreSatoshisNeeded) {
+        super(`Insufficient funds in the available inputs to cover the cost of the required outputs and the transaction fee (${moreSatoshisNeeded} more satoshis are needed, for a total of ${totalSatoshisNeeded}), plus whatever would be required in order to pay the fee to unlock and spend the outputs used to provide the additional satoshis.`);
+        this.totalSatoshisNeeded = totalSatoshisNeeded;
+        this.moreSatoshisNeeded = moreSatoshisNeeded;
+        this.isError = true;
+        this.code = 7;
+        this.name = this.constructor.name;
+    }
+}
+exports.WERR_INSUFFICIENT_FUNDS = WERR_INSUFFICIENT_FUNDS;
+exports.default = WERR_INSUFFICIENT_FUNDS;
+//# sourceMappingURL=WERR_INSUFFICIENT_FUNDS.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/src/wallet/WERR_INSUFFICIENT_FUNDS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WERR_INSUFFICIENT_FUNDS.js","sourceRoot":"","sources":["../../../../src/wallet/WERR_INSUFFICIENT_FUNDS.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAIhD;;;OAGG;IACH,YACS,mBAA2B,EAC3B,kBAA0B;QAEjC,KAAK,CAAC,iHAAiH,kBAAkB,6CAA6C,mBAAmB,qIAAqI,CAAC,CAAA;QAHxU,wBAAmB,GAAnB,mBAAmB,CAAQ;QAC3B,uBAAkB,GAAlB,kBAAkB,CAAQ;QARnC,YAAO,GAAY,IAAI,CAAA;QAWrB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IACnC,CAAC;CACF;AAhBD,0DAgBC;AAED,kBAAe,uBAAuB,CAAA"}