@bsv/sdk 1.7.7 → 1.8.1

package/dist/esm/src/kvstore/GlobalKVStore.js

@@ -0,0 +1,416 @@
+import Transaction from '../transaction/Transaction.js';
+import * as Utils from '../primitives/utils.js';
+import { TopicBroadcaster, LookupResolver } from '../overlay-tools/index.js';
+import { PushDrop } from '../script/index.js';
+import WalletClient from '../wallet/WalletClient.js';
+import { Beef } from '../transaction/Beef.js';
+import { Historian } from '../overlay-tools/Historian.js';
+import { kvStoreInterpreter } from './kvStoreInterpreter.js';
+import { ProtoWallet } from '../wallet/ProtoWallet.js';
+import { kvProtocol } from './types.js';
+/**
+ * Default configuration values for GlobalKVStore operations.
+ * Provides sensible defaults for overlay connection and protocol settings.
+ */
+const DEFAULT_CONFIG = {
+    protocolID: [1, 'kvstore'],
+    serviceName: 'ls_kvstore',
+    tokenAmount: 1,
+    topics: ['tm_kvstore'],
+    networkPreset: 'mainnet',
+    acceptDelayedBroadcast: false,
+    tokenSetDescription: '',
+    tokenUpdateDescription: '',
+    tokenRemovalDescription: '' // Will be set dynamically
+};
+/**
+ * Implements a global key-value storage system which uses an overlay service to track key-value pairs.
+ * Each key-value pair is represented by a PushDrop token output.
+ * Allows getting, setting, and removing key-value pairs with optional fetching by protocolID and history tracking.
+ */
+export class GlobalKVStore {
+    /**
+     * The wallet interface used to create transactions and perform cryptographic operations.
+     * @readonly
+     */
+    wallet;
+    /**
+     * Configuration for the KVStore instance containing all runtime options.
+     * @private
+     * @readonly
+     */
+    config;
+    /**
+     * Historian instance used to extract history from transaction outputs.
+     * @private
+     */
+    historian;
+    /**
+     * Lookup resolver used to query the overlay for transaction outputs.
+     * @private
+     */
+    lookupResolver;
+    /**
+     * Topic broadcaster used to broadcast transactions to the overlay.
+     * @private
+     */
+    topicBroadcaster;
+    /**
+     * A map to store locks for each key to ensure atomic updates.
+     * @private
+     */
+    keyLocks = new Map();
+    /**
+     * Cached user identity key
+     * @private
+     */
+    cachedIdentityKey = null;
+    /**
+     * Creates an instance of the GlobalKVStore.
+     *
+     * @param {KVStoreConfig} [config={}] - Configuration options for the KVStore. Defaults to empty object.
+     * @param {WalletInterface} [config.wallet] - Wallet to use for operations. Defaults to WalletClient.
+     * @throws {Error} If the configuration contains invalid parameters.
+     */
+    constructor(config = {}) {
+        // Merge with defaults to create a fully resolved config
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.wallet = config.wallet ?? new WalletClient();
+        this.historian = new Historian(kvStoreInterpreter);
+        this.lookupResolver = new LookupResolver({
+            networkPreset: this.config.networkPreset
+        });
+        this.topicBroadcaster = new TopicBroadcaster(this.config.topics, {
+            networkPreset: this.config.networkPreset
+        });
+    }
+    /**
+     * Retrieves data from the KVStore.
+     * Can query by key+controller (single result), protocolID, controller, or key (multiple results).
+     *
+     * @param {KVStoreQuery} query - Query parameters sent to overlay
+     * @param {KVStoreGetOptions} [options={}] - Configuration options for the get operation
+     * @returns {Promise<KVStoreEntry | KVStoreEntry[] | undefined>} Single entry for key+controller queries, array for all other queries
+     */
+    async get(query, options = {}) {
+        if (Object.keys(query).length === 0) {
+            throw new Error('Must specify either key, controller, or protocolID');
+        }
+        if (query.key != null && query.controller != null) {
+            // Specific key+controller query - return single entry
+            const entries = await this.queryOverlay(query, options);
+            return entries.length > 0 ? entries[0] : undefined;
+        }
+        return await this.queryOverlay(query, options);
+    }
+    /**
+     * Sets a key-value pair. The current user (wallet identity) becomes the controller.
+     *
+     * @param {string} key - The key to set (user computes this however they want)
+     * @param {string} value - The value to store
+     * @param {KVStoreSetOptions} [options={}] - Configuration options for the set operation
+     * @returns {Promise<OutpointString>} The outpoint of the created token
+     */
+    async set(key, value, options = {}) {
+        if (typeof key !== 'string' || key.length === 0) {
+            throw new Error('Key must be a non-empty string.');
+        }
+        if (typeof value !== 'string') {
+            throw new Error('Value must be a string.');
+        }
+        const controller = await this.getIdentityKey();
+        const lockQueue = await this.queueOperationOnKey(key);
+        const protocolID = options.protocolID ?? this.config.protocolID;
+        const tokenSetDescription = (options.tokenSetDescription != null && options.tokenSetDescription !== '') ? options.tokenSetDescription : `Create KVStore value for ${key}`;
+        const tokenUpdateDescription = (options.tokenUpdateDescription != null && options.tokenUpdateDescription !== '') ? options.tokenUpdateDescription : `Update KVStore value for ${key}`;
+        const tokenAmount = options.tokenAmount ?? this.config.tokenAmount;
+        try {
+            // Check for existing token to spend
+            const existingEntries = await this.queryOverlay({ key, controller }, { includeToken: true });
+            const existingToken = existingEntries.length > 0 ? existingEntries[0].token : undefined;
+            // Create PushDrop locking script
+            const pushdrop = new PushDrop(this.wallet, this.config.originator);
+            const lockingScript = await pushdrop.lock([
+                Utils.toArray(JSON.stringify(protocolID), 'utf8'),
+                Utils.toArray(key, 'utf8'),
+                Utils.toArray(value, 'utf8'),
+                Utils.toArray(controller, 'hex')
+            ], protocolID ?? this.config.protocolID, Utils.toUTF8(Utils.toArray(key, 'utf8')), 'anyone', true);
+            let inputs = [];
+            let inputBEEF;
+            if (existingToken != null) {
+                inputs = [{
+                        outpoint: `${existingToken.txid}.${existingToken.outputIndex}`,
+                        unlockingScriptLength: 74,
+                        inputDescription: 'Previous KVStore token'
+                    }];
+                inputBEEF = existingToken.beef;
+            }
+            if (inputs.length > 0) {
+                // Update existing token
+                const { signableTransaction } = await this.wallet.createAction({
+                    description: tokenUpdateDescription,
+                    inputBEEF: inputBEEF?.toBinary(),
+                    inputs,
+                    outputs: [{
+                            satoshis: tokenAmount ?? this.config.tokenAmount,
+                            lockingScript: lockingScript.toHex(),
+                            outputDescription: 'KVStore token'
+                        }],
+                    options: {
+                        acceptDelayedBroadcast: this.config.acceptDelayedBroadcast,
+                        randomizeOutputs: false
+                    }
+                }, this.config.originator);
+                if (signableTransaction == null) {
+                    throw new Error('Unable to create update transaction');
+                }
+                const tx = Transaction.fromAtomicBEEF(signableTransaction.tx);
+                const unlocker = pushdrop.unlock(this.config.protocolID, key, 'anyone');
+                const unlockingScript = await unlocker.sign(tx, 0);
+                const { tx: finalTx } = await this.wallet.signAction({
+                    reference: signableTransaction.reference,
+                    spends: { 0: { unlockingScript: unlockingScript.toHex() } }
+                }, this.config.originator);
+                if (finalTx == null) {
+                    throw new Error('Unable to finalize update transaction');
+                }
+                const transaction = Transaction.fromAtomicBEEF(finalTx);
+                await this.submitToOverlay(transaction);
+                return `${transaction.id('hex')}.0`;
+            }
+            else {
+                // Create new token
+                const { tx } = await this.wallet.createAction({
+                    description: tokenSetDescription,
+                    outputs: [{
+                            satoshis: tokenAmount ?? this.config.tokenAmount,
+                            lockingScript: lockingScript.toHex(),
+                            outputDescription: 'KVStore token'
+                        }],
+                    options: {
+                        acceptDelayedBroadcast: this.config.acceptDelayedBroadcast,
+                        randomizeOutputs: false
+                    }
+                }, this.config.originator);
+                if (tx == null) {
+                    throw new Error('Failed to create transaction');
+                }
+                const transaction = Transaction.fromAtomicBEEF(tx);
+                await this.submitToOverlay(transaction);
+                return `${transaction.id('hex')}.0`;
+            }
+        }
+        finally {
+            if (lockQueue.length > 0) {
+                this.finishOperationOnKey(key, lockQueue);
+            }
+        }
+    }
+    /**
+     * Removes the key-value pair associated with the given key from the overlay service.
+     *
+     * @param {string} key - The key to remove.
+     * @param {CreateActionOutput[] | undefined} [outputs=undefined] - Additional outputs to include in the removal transaction.
+     * @param {KVStoreRemoveOptions} [options=undefined] - Optional parameters for the removal operation.
+     * @returns {Promise<HexString>} A promise that resolves to the txid of the removal transaction if successful.
+     * @throws {Error} If the key is invalid.
+     * @throws {Error} If the key does not exist in the store.
+     * @throws {Error} If the overlay service is unreachable or the transaction fails.
+     * @throws {Error} If there are existing tokens that cannot be unlocked.
+     */
+    async remove(key, outputs, options = {}) {
+        if (typeof key !== 'string' || key.length === 0) {
+            throw new Error('Key must be a non-empty string.');
+        }
+        const controller = await this.getIdentityKey();
+        const lockQueue = await this.queueOperationOnKey(key);
+        const protocolID = options.protocolID ?? this.config.protocolID;
+        const tokenRemovalDescription = (options.tokenRemovalDescription != null && options.tokenRemovalDescription !== '') ? options.tokenRemovalDescription : `Remove KVStore value for ${key}`;
+        try {
+            const existingEntries = await this.queryOverlay({ key, controller }, { includeToken: true });
+            if (existingEntries.length === 0 || existingEntries[0].token == null) {
+                throw new Error('The item did not exist, no item was deleted.');
+            }
+            const existingToken = existingEntries[0].token;
+            const inputs = [{
+                    outpoint: `${existingToken.txid}.${existingToken.outputIndex}`,
+                    unlockingScriptLength: 74,
+                    inputDescription: 'KVStore token to remove'
+                }];
+            const pushdrop = new PushDrop(this.wallet, this.config.originator);
+            const { signableTransaction } = await this.wallet.createAction({
+                description: tokenRemovalDescription,
+                inputBEEF: existingToken.beef.toBinary(),
+                inputs,
+                outputs,
+                options: {
+                    acceptDelayedBroadcast: this.config.acceptDelayedBroadcast
+                }
+            }, this.config.originator);
+            if (signableTransaction == null) {
+                throw new Error('Unable to create removal transaction');
+            }
+            const tx = Transaction.fromAtomicBEEF(signableTransaction.tx);
+            const unlocker = pushdrop.unlock(protocolID ?? this.config.protocolID, key, 'anyone');
+            const unlockingScript = await unlocker.sign(tx, 0);
+            const { tx: finalTx } = await this.wallet.signAction({
+                reference: signableTransaction.reference,
+                spends: { 0: { unlockingScript: unlockingScript.toHex() } }
+            }, this.config.originator);
+            if (finalTx == null) {
+                throw new Error('Unable to finalize removal transaction');
+            }
+            const transaction = Transaction.fromAtomicBEEF(finalTx);
+            await this.submitToOverlay(transaction);
+            return transaction.id('hex');
+        }
+        finally {
+            if (lockQueue.length > 0) {
+                this.finishOperationOnKey(key, lockQueue);
+            }
+        }
+    }
+    /**
+     * Queues an operation on a specific key to ensure atomic updates.
+     * Prevents concurrent operations on the same key from interfering with each other.
+     *
+     * @param {string} key - The key to queue an operation for.
+     * @returns {Promise<Array<(value: void | PromiseLike<void>) => void>>} The lock queue for cleanup.
+     * @private
+     */
+    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;
+    }
+    /**
+     * Finishes an operation on a key and resolves the next waiting operation.
+     *
+     * @param {string} key - The key to finish the operation for.
+     * @param {Array<(value: void | PromiseLike<void>) => void>} lockQueue - The lock queue from queueOperationOnKey.
+     * @private
+     */
+    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]();
+        }
+        else {
+            // Clean up empty queue to prevent memory leak
+            this.keyLocks.delete(key);
+        }
+    }
+    /**
+     * Helper function to fetch and cache user identity key
+     *
+     * @returns {Promise<PubKeyHex>} The identity key of the current user
+     * @private
+     */
+    async getIdentityKey() {
+        if (this.cachedIdentityKey == null) {
+            this.cachedIdentityKey = (await this.wallet.getPublicKey({ identityKey: true }, this.config.originator)).publicKey;
+        }
+        return this.cachedIdentityKey;
+    }
+    /**
+     * Queries the overlay service for KV entries.
+     *
+     * @param {KVStoreQuery} query - Query parameters sent to overlay
+     * @param {KVStoreGetOptions} options - Configuration options for the query
+     * @returns {Promise<KVStoreEntry[]>} Array of matching KV entries
+     * @private
+     */
+    async queryOverlay(query, options = {}) {
+        const answer = await this.lookupResolver.query({
+            service: options.serviceName ?? this.config.serviceName,
+            query
+        });
+        if (answer.type !== 'output-list' || answer.outputs.length === 0) {
+            return [];
+        }
+        const entries = [];
+        for (const result of answer.outputs) {
+            try {
+                const tx = Transaction.fromBEEF(result.beef);
+                const output = tx.outputs[result.outputIndex];
+                const decoded = PushDrop.decode(output.lockingScript);
+                if (decoded.fields.length !== 5) {
+                    continue;
+                }
+                // Verify signature
+                const anyoneWallet = new ProtoWallet('anyone');
+                const signature = decoded.fields.pop();
+                try {
+                    await anyoneWallet.verifySignature({
+                        data: decoded.fields.reduce((a, e) => [...a, ...e], []),
+                        signature,
+                        counterparty: Utils.toHex(decoded.fields[kvProtocol.controller]),
+                        protocolID: JSON.parse(Utils.toUTF8(decoded.fields[kvProtocol.protocolID])),
+                        keyID: Utils.toUTF8(decoded.fields[kvProtocol.key])
+                    });
+                }
+                catch (error) {
+                    // Skip all outputs that fail signature verification
+                    continue;
+                }
+                const entry = {
+                    key: Utils.toUTF8(decoded.fields[kvProtocol.key]),
+                    value: Utils.toUTF8(decoded.fields[kvProtocol.value]),
+                    controller: Utils.toHex(decoded.fields[kvProtocol.controller]),
+                    protocolID: JSON.parse(Utils.toUTF8(decoded.fields[kvProtocol.protocolID]))
+                };
+                if (options.includeToken === true) {
+                    entry.token = {
+                        txid: tx.id('hex'),
+                        outputIndex: result.outputIndex,
+                        beef: Beef.fromBinary(result.beef),
+                        satoshis: output.satoshis ?? 1
+                    };
+                }
+                if (options.history === true) {
+                    entry.history = await this.historian.buildHistory(tx, {
+                        key: entry.key,
+                        protocolID: entry.protocolID
+                    });
+                }
+                entries.push(entry);
+            }
+            catch (error) {
+                continue;
+            }
+        }
+        return entries;
+    }
+    /**
+     * Submits a transaction to an overlay service using TopicBroadcaster.
+     * Broadcasts the transaction to the configured topics for network propagation.
+     *
+     * @param {Transaction} transaction - The transaction to broadcast.
+     * @returns {Promise<BroadcastResponse | BroadcastFailure>} The broadcast result.
+     * @throws {Error} If the broadcast fails or the network is unreachable.
+     * @private
+     */
+    async submitToOverlay(transaction) {
+        return await this.topicBroadcaster.broadcast(transaction);
+    }
+}
+export default GlobalKVStore;
+//# sourceMappingURL=GlobalKVStore.js.map

package/dist/esm/src/kvstore/GlobalKVStore.js.map

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

package/dist/esm/src/kvstore/LocalKVStore.js

@@ -149,8 +149,8 @@ export default class LocalKVStore {
             }
             field = decoded.fields[0];
         }
-        catch (_) {
-            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.`);
+        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);
@@ -260,8 +260,8 @@ export default class LocalKVStore {
                     outpoint = `${txid}.0`;
                 }
             }
-            catch (_) {
-                throw new Error(`There are ${outputs.length} outputs with tag ${key} that cannot be unlocked.`);
+            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;
         }
@@ -310,8 +310,8 @@ export default class LocalKVStore {
                         }
                         txids.push(txid);
                     }
-                    catch (_) {
-                        throw new Error(`There are ${totalOutputs} outputs with tag ${key} that cannot be unlocked.`);
+                    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) {

package/dist/esm/src/kvstore/LocalKVStore.js.map

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

package/dist/esm/src/kvstore/kvStoreInterpreter.js

@@ -0,0 +1,47 @@
+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].
+ * 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);
+        // Validate KVStore token format (must have 5 fields: [protocolID, key, value, controller, signature])
+        if (decoded.fields.length !== Object.keys(kvProtocol).length)
+            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/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;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2C,KAAK,EAAE,WAAwB,EAAE,WAAmB,EAAE,GAAe,EAA+B,EAAE;IAC9K,IAAI;QACF,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,sGAAsG;QACtG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAE9E,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;YACF,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;SACtD;QAAC,MAAM;YACN,OAAO,SAAS,CAAA;SACjB;KACF;IAAC,MAAM;QACN,+CAA+C;QAC/C,OAAO,SAAS,CAAA;KACjB;AACH,CAAC,CAAA"}

package/dist/esm/src/kvstore/types.js

@@ -0,0 +1,8 @@
+export const kvProtocol = {
+    protocolID: 0,
+    key: 1,
+    value: 2,
+    controller: 3,
+    signature: 4
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/src/kvstore/types.js.map

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