@bsv/wallet-toolbox 1.7.14 → 1.7.16

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/LocalKVStore.js

@@ -0,0 +1,328 @@
+import PushDrop from '../script/templates/PushDrop.js';
+import * as Utils from '../primitives/utils.js';
+import WalletClient from '../wallet/WalletClient.js';
+import Transaction from '../transaction/Transaction.js';
+import { Beef } from '../transaction/Beef.js';
+/**
+ * Implements a key-value storage system backed by transaction outputs managed by a wallet.
+ * Each key-value pair is represented by a PushDrop token output in a specific context (basket).
+ * Allows setting, getting, and removing key-value pairs, with optional encryption.
+ */
+export default class LocalKVStore {
+    /**
+     * The wallet interface used to manage outputs and perform cryptographic operations.
+     * @private
+     * @readonly
+     */
+    wallet;
+    /**
+     * The context (basket name) used to namespace the key-value pairs within the wallet.
+     * @private
+     * @readonly
+     */
+    context;
+    /**
+     * Flag indicating whether values should be encrypted before storing.
+     * @private
+     * @readonly
+     */
+    encrypt;
+    /**
+     * An originator to use with PushDrop and the wallet.
+     * @private
+     * @readonly
+     */
+    originator;
+    acceptDelayedBroadcast = false;
+    /**
+     * A map to store locks for each key to ensure atomic updates.
+     * @private
+     */
+    keyLocks = new Map();
+    /**
+     * Creates an instance of the localKVStore.
+     *
+     * @param {WalletInterface} [wallet=new WalletClient()] - The wallet interface to use. Defaults to a new WalletClient instance.
+     * @param {string} [context='kvstoredefault'] - The context (basket) for namespacing keys. Defaults to 'kvstore default'.
+     * @param {boolean} [encrypt=true] - Whether to encrypt values. Defaults to true.
+     * @param {string} [originator] — An originator to use with PushDrop and the wallet, if provided.
+     * @throws {Error} If the context is missing or empty.
+     */
+    constructor(wallet = new WalletClient(), context = 'kvstore default', encrypt = true, originator, acceptDelayedBroadcast = false) {
+        if (typeof context !== 'string' || context.length < 1) {
+            throw new Error('A context in which to operate is required.');
+        }
+        this.wallet = wallet;
+        this.context = context;
+        this.encrypt = encrypt;
+        this.originator = originator;
+        this.acceptDelayedBroadcast = acceptDelayedBroadcast;
+    }
+    async queueOperationOnKey(key) {
+        // Check if a lock exists for this key and wait for it to resolve
+        let lockQueue = this.keyLocks.get(key);
+        if (lockQueue == null) {
+            lockQueue = [];
+            this.keyLocks.set(key, lockQueue);
+        }
+        let resolveNewLock = () => { };
+        const newLock = new Promise((resolve) => {
+            resolveNewLock = resolve;
+            if (lockQueue != null) {
+                lockQueue.push(resolve);
+            }
+        });
+        // If we are the only request, resolve the lock immediately, queue remains at 1 item until request ends.
+        if (lockQueue.length === 1) {
+            resolveNewLock();
+        }
+        await newLock;
+        return lockQueue;
+    }
+    finishOperationOnKey(key, lockQueue) {
+        lockQueue.shift(); // Remove the current lock from the queue
+        if (lockQueue.length > 0) {
+            // If there are more locks waiting, resolve the next one
+            lockQueue[0]();
+        }
+    }
+    getProtocol(key) {
+        return { protocolID: [2, this.context], keyID: key };
+    }
+    async getOutputs(key, limit) {
+        const results = await this.wallet.listOutputs({
+            basket: this.context,
+            tags: [key],
+            tagQueryMode: 'all',
+            include: 'entire transactions',
+            limit
+        }, this.originator);
+        return results;
+    }
+    /**
+     * Retrieves the value associated with a given key.
+     *
+     * @param {string} key - The key to retrieve the value for.
+     * @param {string | undefined} [defaultValue=undefined] - The value to return if the key is not found.
+     * @returns {Promise<string | undefined>} A promise that resolves to the value as a string,
+     *   the defaultValue if the key is not found, or undefined if no defaultValue is provided.
+     * @throws {Error} If too many outputs are found for the key (ambiguous state).
+     * @throws {Error} If the found output's locking script cannot be decoded or represents an invalid token format.
+     */
+    async get(key, defaultValue = undefined) {
+        const lockQueue = await this.queueOperationOnKey(key);
+        try {
+            const r = await this.lookupValue(key, defaultValue, 5);
+            return r.value;
+        }
+        finally {
+            this.finishOperationOnKey(key, lockQueue);
+        }
+    }
+    getLockingScript(output, beef) {
+        const [txid, vout] = output.outpoint.split('.');
+        const tx = beef.findTxid(txid)?.tx;
+        if (tx == null) {
+            throw new Error(`beef must contain txid ${txid}`);
+        }
+        const lockingScript = tx.outputs[Number(vout)].lockingScript;
+        return lockingScript;
+    }
+    async lookupValue(key, defaultValue, limit) {
+        const lor = await this.getOutputs(key, limit);
+        const r = { value: defaultValue, outpoint: undefined, lor };
+        const { outputs } = lor;
+        if (outputs.length === 0) {
+            return r;
+        }
+        const output = outputs.slice(-1)[0];
+        r.outpoint = output.outpoint;
+        let field;
+        try {
+            if (lor.BEEF === undefined) {
+                throw new Error('entire transactions listOutputs option must return valid BEEF');
+            }
+            const lockingScript = this.getLockingScript(output, Beef.fromBinary(lor.BEEF));
+            const decoded = PushDrop.decode(lockingScript);
+            if (decoded.fields.length < 1 || decoded.fields.length > 2) {
+                throw new Error('Invalid token.');
+            }
+            field = decoded.fields[0];
+        }
+        catch (error) {
+            throw new Error(`Invalid value found. You need to call set to collapse the corrupted state (or relinquish the corrupted ${outputs[0].outpoint} output from the ${this.context} basket) before you can get this value again. Original error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!this.encrypt) {
+            r.value = Utils.toUTF8(field);
+        }
+        else {
+            const { plaintext } = await this.wallet.decrypt({
+                ...this.getProtocol(key),
+                ciphertext: field
+            }, this.originator);
+            r.value = Utils.toUTF8(plaintext);
+        }
+        return r;
+    }
+    getInputs(outputs) {
+        const inputs = [];
+        for (let i = 0; i < outputs.length; i++) {
+            inputs.push({
+                outpoint: outputs[i].outpoint,
+                unlockingScriptLength: 74,
+                inputDescription: 'Previous key-value token'
+            });
+        }
+        return inputs;
+    }
+    async getSpends(key, outputs, pushdrop, atomicBEEF) {
+        const p = this.getProtocol(key);
+        const tx = Transaction.fromAtomicBEEF(atomicBEEF);
+        const spends = {};
+        for (let i = 0; i < outputs.length; i++) {
+            const unlocker = pushdrop.unlock(p.protocolID, p.keyID, 'self');
+            const unlockingScript = await unlocker.sign(tx, i);
+            spends[i] = {
+                unlockingScript: unlockingScript.toHex()
+            };
+        }
+        return spends;
+    }
+    /**
+     * Sets or updates the value associated with a given key atomically.
+     * If the key already exists (one or more outputs found), it spends the existing output(s)
+     * and creates a new one with the updated value. If multiple outputs exist for the key,
+     * they are collapsed into a single new output.
+     * If the key does not exist, it creates a new output.
+     * Handles encryption if enabled.
+     * If signing the update/collapse transaction fails, it relinquishes the original outputs and starts over with a new chain.
+     * Ensures atomicity by locking the key during the operation, preventing concurrent updates
+     * to the same key from missing earlier changes.
+     *
+     * @param {string} key - The key to set or update.
+     * @param {string} value - The value to associate with the key.
+     * @returns {Promise<OutpointString>} A promise that resolves to the outpoint string (txid.vout) of the new or updated token output.
+     */
+    async set(key, value) {
+        const lockQueue = await this.queueOperationOnKey(key);
+        try {
+            const current = await this.lookupValue(key, undefined, 10);
+            if (current.value === value) {
+                if (current.outpoint === undefined) {
+                    throw new Error('outpoint must be valid when value is valid and unchanged');
+                }
+                // Don't create a new transaction if the value doesn't need to change
+                return current.outpoint;
+            }
+            const protocol = this.getProtocol(key);
+            let valueAsArray = Utils.toArray(value, 'utf8');
+            if (this.encrypt) {
+                const { ciphertext } = await this.wallet.encrypt({
+                    ...protocol,
+                    plaintext: valueAsArray
+                }, this.originator);
+                valueAsArray = ciphertext;
+            }
+            const pushdrop = new PushDrop(this.wallet, this.originator);
+            const lockingScript = await pushdrop.lock([valueAsArray], protocol.protocolID, protocol.keyID, 'self');
+            const { outputs, BEEF: inputBEEF } = current.lor;
+            let outpoint;
+            try {
+                const inputs = this.getInputs(outputs);
+                const { txid, signableTransaction } = await this.wallet.createAction({
+                    description: `Update ${key} in ${this.context}`,
+                    inputBEEF,
+                    inputs,
+                    outputs: [{
+                            basket: this.context,
+                            tags: [key],
+                            lockingScript: lockingScript.toHex(),
+                            satoshis: 1,
+                            outputDescription: 'Key-value token'
+                        }],
+                    options: {
+                        acceptDelayedBroadcast: this.acceptDelayedBroadcast,
+                        randomizeOutputs: false
+                    }
+                }, this.originator);
+                if (outputs.length > 0 && typeof signableTransaction !== 'object') {
+                    throw new Error('Wallet did not return a signable transaction when expected.');
+                }
+                if (signableTransaction == null) {
+                    outpoint = `${txid}.0`;
+                }
+                else {
+                    const spends = await this.getSpends(key, outputs, pushdrop, signableTransaction.tx);
+                    const { txid } = await this.wallet.signAction({
+                        reference: signableTransaction.reference,
+                        spends
+                    }, this.originator);
+                    outpoint = `${txid}.0`;
+                }
+            }
+            catch (error) {
+                throw new Error(`There are ${outputs.length} outputs with tag ${key} that cannot be unlocked. Original error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return outpoint;
+        }
+        finally {
+            this.finishOperationOnKey(key, lockQueue);
+        }
+    }
+    /**
+     * Removes the key-value pair associated with the given key.
+     * It finds the existing output(s) for the key and spends them without creating a new output.
+     * If multiple outputs exist, they are all spent in the same transaction.
+     * If the key does not exist, it does nothing.
+     * If signing the removal transaction fails, it relinquishes the original outputs instead of spending.
+     *
+     * @param {string} key - The key to remove.
+     * @returns {Promise<string[]>} A promise that resolves to the txids of the removal transactions if successful.
+     */
+    async remove(key) {
+        const lockQueue = await this.queueOperationOnKey(key);
+        try {
+            const txids = [];
+            for (;;) {
+                const { outputs, BEEF: inputBEEF, totalOutputs } = await this.getOutputs(key);
+                if (outputs.length > 0) {
+                    const pushdrop = new PushDrop(this.wallet, this.originator);
+                    try {
+                        const inputs = this.getInputs(outputs);
+                        const { signableTransaction } = await this.wallet.createAction({
+                            description: `Remove ${key} in ${this.context}`,
+                            inputBEEF,
+                            inputs,
+                            options: {
+                                acceptDelayedBroadcast: this.acceptDelayedBroadcast
+                            }
+                        }, this.originator);
+                        if (typeof signableTransaction !== 'object') {
+                            throw new Error('Wallet did not return a signable transaction when expected.');
+                        }
+                        const spends = await this.getSpends(key, outputs, pushdrop, signableTransaction.tx);
+                        const { txid } = await this.wallet.signAction({
+                            reference: signableTransaction.reference,
+                            spends
+                        }, this.originator);
+                        if (txid === undefined) {
+                            throw new Error('signAction must return a valid txid');
+                        }
+                        txids.push(txid);
+                    }
+                    catch (error) {
+                        throw new Error(`There are ${totalOutputs} outputs with tag ${key} that cannot be unlocked. Original error: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+                if (outputs.length === totalOutputs) {
+                    break;
+                }
+            }
+            return txids;
+        }
+        finally {
+            this.finishOperationOnKey(key, lockQueue);
+        }
+    }
+}
+//# sourceMappingURL=LocalKVStore.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/LocalKVStore.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/index.js

@@ -0,0 +1,3 @@
+export { default as LocalKVStore } from './LocalKVStore.js';
+export { default as GlobalKVStore } from './GlobalKVStore.js';
+//# sourceMappingURL=index.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kvstore/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAA"}

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/kvStoreInterpreter.js

@@ -0,0 +1,51 @@
+import { PushDrop } from '../script/index.js';
+import * as Utils from '../primitives/utils.js';
+import { kvProtocol } from './types.js';
+/**
+ * KVStore interpreter used by Historian.
+ *
+ * Validates the KVStore PushDrop tokens: [protocolID, key, value, controller, signature] (old format)
+ * or [protocolID, key, value, controller, tags, signature] (new format).
+ * Filters outputs by the provided key in the interpreter context.
+ * Produces the plaintext value for matching outputs; returns undefined otherwise.
+ *
+ * @param transaction - The transaction to inspect.
+ * @param outputIndex - The index of the output within transaction.outputs.
+ * @param ctx - { key: string, protocolID: WalletProtocol } — per-call context specifying which key to match.
+ *
+ * @returns string | undefined — the decoded KV value if the output is a valid KVStore token for the
+ *   given key; otherwise undefined.
+ */
+export const kvStoreInterpreter = async (transaction, outputIndex, ctx) => {
+    try {
+        const output = transaction.outputs[outputIndex];
+        if (output == null || output.lockingScript == null)
+            return undefined;
+        if (ctx == null || ctx.key == null)
+            return undefined;
+        // Decode the KVStore token
+        const decoded = PushDrop.decode(output.lockingScript);
+        // Support backwards compatibility: old format without tags, new format with tags
+        const expectedFieldCount = Object.keys(kvProtocol).length;
+        const hasTagsField = decoded.fields.length === expectedFieldCount;
+        const isOldFormat = decoded.fields.length === expectedFieldCount - 1;
+        if (!isOldFormat && !hasTagsField)
+            return undefined;
+        // Only return values for the given key and protocolID
+        const key = Utils.toUTF8(decoded.fields[kvProtocol.key]);
+        const protocolID = Utils.toUTF8(decoded.fields[kvProtocol.protocolID]);
+        if (key !== ctx.key || protocolID !== JSON.stringify(ctx.protocolID))
+            return undefined;
+        try {
+            return Utils.toUTF8(decoded.fields[kvProtocol.value]);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    catch {
+        // Skip non-KVStore outputs or malformed tokens
+        return undefined;
+    }
+};
+//# sourceMappingURL=kvStoreInterpreter.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/kvStoreInterpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kvStoreInterpreter.js","sourceRoot":"","sources":["../../../../src/kvstore/kvStoreInterpreter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAMvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2C,KAAK,EAAE,WAAwB,EAAE,WAAmB,EAAE,GAAe,EAA+B,EAAE;IAC9K,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC/C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI;YAAE,OAAO,SAAS,CAAA;QACpE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI;YAAE,OAAO,SAAS,CAAA;QAEpD,2BAA2B;QAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QAErD,iFAAiF;QACjF,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAA;QACzD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,kBAAkB,CAAA;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,kBAAkB,GAAG,CAAC,CAAA;QAEpE,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAA;QAEnD,sDAAsD;QACtD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;QACxD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;QACtE,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,UAAU,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,SAAS,CAAA;QACtF,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA"}

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/types.js

@@ -0,0 +1,9 @@
+export const kvProtocol = {
+    protocolID: 0,
+    key: 1,
+    value: 2,
+    controller: 3,
+    tags: 4,
+    signature: 5 // Note: signature moves to position 5 when tags are present
+};
+//# sourceMappingURL=types.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/kvstore/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/kvstore/types.ts"],"names":[],"mappings":"AAsHA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,EAAE,CAAC;IACb,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,CAAC;IACb,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,4DAA4D;CAC1E,CAAA"}

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/EncryptedMessage.js

@@ -0,0 +1,63 @@
+import PublicKey from '../primitives/PublicKey.js';
+import SymmetricKey from '../primitives/SymmetricKey.js';
+import Random from '../primitives/Random.js';
+import { toBase64, toArray, Reader, toHex } from '../primitives/utils.js';
+const VERSION = '42421033';
+/**
+ * Encrypts a message from one party to another using the BRC-78 message encryption protocol.
+ * @param message The message to encrypt
+ * @param sender The private key of the sender
+ * @param recipient The public key of the recipient
+ *
+ * @returns The encrypted message
+ */
+export const encrypt = (message, sender, recipient) => {
+    const keyID = Random(32);
+    const keyIDBase64 = toBase64(keyID);
+    const invoiceNumber = `2-message encryption-${keyIDBase64}`;
+    const signingPriv = sender.deriveChild(recipient, invoiceNumber);
+    const recipientPub = recipient.deriveChild(sender, invoiceNumber);
+    const sharedSecret = signingPriv.deriveSharedSecret(recipientPub);
+    const symmetricKey = new SymmetricKey(sharedSecret.encode(true).slice(1));
+    const encrypted = symmetricKey.encrypt(message);
+    const senderPublicKey = sender.toPublicKey().encode(true);
+    const version = toArray(VERSION, 'hex');
+    return [
+        ...version,
+        ...senderPublicKey,
+        ...recipient.encode(true),
+        ...keyID,
+        ...encrypted
+    ];
+};
+/**
+ * Decrypts a message from one party to another using the BRC-78 message encryption protocol.
+ * @param message The message to decrypt
+ * @param sender The private key of the recipient
+ *
+ * @returns The decrypted message
+ */
+export const decrypt = (message, recipient) => {
+    const reader = new Reader(message);
+    const messageVersion = toHex(reader.read(4));
+    if (messageVersion !== VERSION) {
+        throw new Error(`Message version mismatch: Expected ${VERSION}, received ${messageVersion}`);
+    }
+    const sender = PublicKey.fromString(toHex(reader.read(33)));
+    const expectedRecipientDER = toHex(reader.read(33));
+    const actualRecipientDER = recipient
+        .toPublicKey()
+        .encode(true, 'hex');
+    if (expectedRecipientDER !== actualRecipientDER) {
+        throw new Error(`The encrypted message expects a recipient public key of ${expectedRecipientDER}, but the provided key is ${actualRecipientDER}`);
+    }
+    const keyID = toBase64(reader.read(32));
+    const encrypted = reader.read(reader.bin.length - reader.pos);
+    const invoiceNumber = `2-message encryption-${keyID}`;
+    const signingPriv = sender.deriveChild(recipient, invoiceNumber);
+    const recipientPub = recipient.deriveChild(sender, invoiceNumber);
+    const sharedSecret = signingPriv.deriveSharedSecret(recipientPub);
+    const symmetricKey = new SymmetricKey(sharedSecret.encode(true).slice(1));
+    return symmetricKey.decrypt(encrypted);
+};
+//# sourceMappingURL=EncryptedMessage.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/EncryptedMessage.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/SignedMessage.js

@@ -0,0 +1,78 @@
+// @ts-nocheck
+import PublicKey from '../primitives/PublicKey.js';
+import PrivateKey from '../primitives/PrivateKey.js';
+import Signature from '../primitives/Signature.js';
+import Curve from '../primitives/Curve.js';
+import Random from '../primitives/Random.js';
+import { toBase64, toArray, Reader, toHex } from '../primitives/utils.js';
+const VERSION = '42423301';
+/**
+ * Signs a message from one party to be verified by another, or for verification by anyone, using the BRC-77 message signing protocol.
+ * @param message The message to sign
+ * @param signer The private key of the message signer
+ * @param [verifier] The public key of the person who can verify the message. If not provided, anyone will be able to verify the message signature.
+ *
+ * @returns The message signature.
+ */
+export const sign = (message, signer, verifier) => {
+    const recipientAnyone = typeof verifier !== 'object';
+    if (recipientAnyone) {
+        const curve = new Curve();
+        const anyone = new PrivateKey(1);
+        const anyonePoint = curve.g.mul(anyone);
+        verifier = new PublicKey(anyonePoint.x, anyonePoint.y);
+    }
+    const keyID = Random(32);
+    const keyIDBase64 = toBase64(keyID);
+    const invoiceNumber = `2-message signing-${keyIDBase64}`;
+    const signingKey = signer.deriveChild(verifier, invoiceNumber);
+    const signature = signingKey.sign(message).toDER();
+    const senderPublicKey = signer.toPublicKey().encode(true);
+    const version = toArray(VERSION, 'hex');
+    return [
+        ...version,
+        ...senderPublicKey,
+        ...(recipientAnyone ? [0] : verifier.encode(true)),
+        ...keyID,
+        ...signature
+    ];
+};
+/**
+ * Verifies a message using the BRC-77 message signing protocol.
+ * @param message The message to verify.
+ * @param sig The message signature to be verified.
+ * @param [recipient] The private key of the message verifier. This can be omitted if the message is verifiable by anyone.
+ *
+ * @returns True if the message is verified.
+ */
+export const verify = (message, sig, recipient) => {
+    const reader = new Reader(sig);
+    const messageVersion = toHex(reader.read(4));
+    if (messageVersion !== VERSION) {
+        throw new Error(`Message version mismatch: Expected ${VERSION}, received ${messageVersion}`);
+    }
+    const signer = PublicKey.fromString(toHex(reader.read(33)));
+    const [verifierFirst] = reader.read(1);
+    if (verifierFirst === 0) {
+        recipient = new PrivateKey(1);
+    }
+    else {
+        const verifierRest = reader.read(32);
+        const verifierDER = toHex([verifierFirst, ...verifierRest]);
+        if (typeof recipient !== 'object') {
+            throw new Error(`This signature can only be verified with knowledge of a specific private key. The associated public key is: ${verifierDER}`);
+        }
+        const recipientDER = recipient.toPublicKey().encode(true, 'hex');
+        if (verifierDER !== recipientDER) {
+            throw new Error(`The recipient public key is ${recipientDER} but the signature requres the recipient to have public key ${verifierDER}`);
+        }
+    }
+    const keyID = toBase64(reader.read(32));
+    const signatureDER = toHex(reader.read(reader.bin.length - reader.pos));
+    const signature = Signature.fromDER(signatureDER, 'hex');
+    const invoiceNumber = `2-message signing-${keyID}`;
+    const signingKey = signer.deriveChild(recipient, invoiceNumber);
+    const verified = signingKey.verify(message, signature);
+    return verified;
+};
+//# sourceMappingURL=SignedMessage.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/SignedMessage.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/index.js

@@ -0,0 +1,3 @@
+export * as SignedMessage from './SignedMessage.js';
+export * as EncryptedMessage from './EncryptedMessage.js';
+//# sourceMappingURL=index.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA"}