@enbox/dwn-sdk-js 0.4.0 → 0.4.1

package/dist/esm/src/state-index/state-index-level.js

@@ -1,191 +0,0 @@
-/**
- * LevelDB-backed implementation of the StateIndex interface.
- *
- * Manages per-tenant Sparse Merkle Trees (global + per-protocol sub-trees).
- *
- * All data lives within a single LevelDB instance, partitioned by sublevels:
- *   {tenant}/global/        -> SMT nodes + root for the tenant's global tree
- *   {tenant}/proto/{proto}/ -> SMT nodes + root for a protocol-scoped tree
- *   {tenant}/meta/{cid}     -> JSON(indexes) for reverse lookup during deletion
- */
-import { initDefaultHashes } from '../smt/smt-utils.js';
-import { SMTStoreLevel } from '../smt/smt-store-level.js';
-import { SparseMerkleTree } from '../smt/sparse-merkle-tree.js';
-import { createLevelDatabase, LevelWrapper } from '../store/level-wrapper.js';
-export class StateIndexLevel {
-    config;
-    db;
-    /**
-     * Cache of per-tenant global SMTs. Lazily populated on first access.
-     * Stores promises to avoid race conditions when multiple concurrent operations
-     * trigger lazy initialization of the same tenant's SMT.
-     */
-    globalTrees = new Map();
-    /**
-     * Cache of per-tenant, per-protocol SMTs. Key format: `{tenant}\x00{protocol}`
-     * Stores promises to avoid race conditions (same reason as globalTrees).
-     */
-    protocolTrees = new Map();
-    constructor(config) {
-        this.config = {
-            location: 'STATEINDEX',
-            createLevelDatabase: createLevelDatabase,
-            ...config,
-        };
-    }
-    async open() {
-        this.db = new LevelWrapper({
-            location: this.config.location,
-            createLevelDatabase: this.config.createLevelDatabase,
-            keyEncoding: 'utf8',
-        });
-        await this.db.open();
-        // Ensure default hashes are initialized
-        await initDefaultHashes();
-    }
-    async close() {
-        this.globalTrees.clear();
-        this.protocolTrees.clear();
-        await this.db.close();
-    }
-    async clear() {
-        this.globalTrees.clear();
-        this.protocolTrees.clear();
-        await this.db.clear();
-    }
-    async insert(tenant, messageCid, indexes) {
-        // Insert into the global tree
-        const globalSmt = await this.getGlobalTree(tenant);
-        await globalSmt.insert(messageCid);
-        // Insert into the protocol-scoped tree if the message has a protocol (e.g. RecordsWrite).
-        // Non-record messages like ProtocolsConfigure do not have a protocol.
-        const protocol = indexes.protocol;
-        if (protocol !== undefined) {
-            const protoSmt = await this.getProtocolTree(tenant, protocol);
-            await protoSmt.insert(messageCid);
-        }
-        // Store the reverse lookup so we know the protocol during deletion
-        await this.storeIndexes(tenant, messageCid, indexes);
-    }
-    async delete(tenant, messageCids) {
-        const globalSmt = await this.getGlobalTree(tenant);
-        for (const messageCid of messageCids) {
-            // Look up stored indexes to find the protocol
-            const indexes = await this.getStoredIndexes(tenant, messageCid);
-            // Delete from global tree
-            await globalSmt.delete(messageCid);
-            // Delete from protocol tree if the message had a protocol
-            if (indexes !== undefined) {
-                const protocol = indexes.protocol;
-                if (protocol !== undefined) {
-                    const protoSmt = await this.getProtocolTree(tenant, protocol);
-                    await protoSmt.delete(messageCid);
-                }
-            }
-            // Remove the reverse lookup
-            await this.deleteStoredIndexes(tenant, messageCid);
-        }
-    }
-    async getRoot(tenant) {
-        const smt = await this.getGlobalTree(tenant);
-        return smt.getRoot();
-    }
-    async getProtocolRoot(tenant, protocol) {
-        const smt = await this.getProtocolTree(tenant, protocol);
-        return smt.getRoot();
-    }
-    async getSubtreeHash(tenant, prefix) {
-        const smt = await this.getGlobalTree(tenant);
-        return smt.getSubtreeHash(prefix);
-    }
-    async getProtocolSubtreeHash(tenant, protocol, prefix) {
-        const smt = await this.getProtocolTree(tenant, protocol);
-        return smt.getSubtreeHash(prefix);
-    }
-    async getLeaves(tenant, prefix) {
-        const smt = await this.getGlobalTree(tenant);
-        return smt.getLeaves(prefix);
-    }
-    async getProtocolLeaves(tenant, protocol, prefix) {
-        const smt = await this.getProtocolTree(tenant, protocol);
-        return smt.getLeaves(prefix);
-    }
-    // ─── Private helpers ────────────────────────────────────────────────────
-    /**
-     * Get or create the global SMT for a tenant.
-     * Uses a promise-based cache to prevent concurrent callers from racing to
-     * initialize the same tenant's SMT twice.
-     */
-    getGlobalTree(tenant) {
-        let smtPromise = this.globalTrees.get(tenant);
-        if (smtPromise !== undefined) {
-            return smtPromise;
-        }
-        smtPromise = this.createTree(this.db, [tenant, 'global']);
-        this.globalTrees.set(tenant, smtPromise);
-        return smtPromise;
-    }
-    /**
-     * Get or create a protocol-scoped SMT for a tenant.
-     * Uses a promise-based cache to prevent concurrent callers from racing to
-     * initialize the same tenant's SMT twice.
-     */
-    getProtocolTree(tenant, protocol) {
-        const cacheKey = `${tenant}\x00${protocol}`;
-        let smtPromise = this.protocolTrees.get(cacheKey);
-        if (smtPromise !== undefined) {
-            return smtPromise;
-        }
-        smtPromise = this.createTree(this.db, [tenant, 'proto', protocol]);
-        this.protocolTrees.set(cacheKey, smtPromise);
-        return smtPromise;
-    }
-    /**
-     * Create and initialize a new SparseMerkleTree backed by a sublevel chain
-     * within the single LevelDB instance.
-     */
-    async createTree(db, sublevels) {
-        let partition = db;
-        for (const name of sublevels) {
-            partition = await partition.partition(name);
-        }
-        const store = new SMTStoreLevel(partition);
-        const smt = new SparseMerkleTree(store);
-        await smt.initialize();
-        return smt;
-    }
-    /**
-     * Store the indexes for a messageCid so we can look up the protocol during deletion.
-     */
-    async storeIndexes(tenant, messageCid, indexes) {
-        const metaPartition = await this.getMetaPartition(tenant);
-        // Store the protocol index needed for deletion
-        const minimalIndexes = { protocol: indexes.protocol };
-        await metaPartition.put(messageCid, JSON.stringify(minimalIndexes));
-    }
-    /**
-     * Get the stored indexes for a messageCid.
-     */
-    async getStoredIndexes(tenant, messageCid) {
-        const metaPartition = await this.getMetaPartition(tenant);
-        const value = await metaPartition.get(messageCid);
-        if (value === undefined) {
-            return undefined;
-        }
-        return JSON.parse(value);
-    }
-    /**
-     * Delete the stored indexes for a messageCid.
-     */
-    async deleteStoredIndexes(tenant, messageCid) {
-        const metaPartition = await this.getMetaPartition(tenant);
-        await metaPartition.delete(messageCid);
-    }
-    /**
-     * Get the metadata partition for a tenant.
-     */
-    async getMetaPartition(tenant) {
-        return (await this.db.partition(tenant)).partition('meta');
-    }
-}
-//# sourceMappingURL=state-index-level.js.map

package/dist/esm/src/state-index/state-index-level.js.map

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

package/dist/esm/src/types/smt-types.js

@@ -1,5 +0,0 @@
-/**
- * Types for the Sparse Merkle Tree implementation.
- */
-export {};
-//# sourceMappingURL=smt-types.js.map

package/dist/esm/src/types/smt-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"smt-types.js","sourceRoot":"","sources":["../../../../src/types/smt-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/esm/src/types/state-index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=state-index.js.map

package/dist/esm/src/types/state-index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-index.js","sourceRoot":"","sources":["../../../../src/types/state-index.ts"],"names":[],"mappings":""}