@feelyourprotocol/statemanager 8141.0.0

package/dist/esm/cache/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/cache/storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGlC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;GAIG;AACH,KAAK,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAAA;AAC9D,KAAK,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAE9C,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,CAAA;IACxD,gBAAgB,EAAE,UAAU,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,CAAA;IAEjE;;;;;;;;OAQG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAK;gBAEvC,IAAI,EAAE,SAAS;IAkB3B,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAuBrD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IA+B/D;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS;IAoB9D;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IA0B5C;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASpC;;;OAGG;IACH,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,EAAE;IAmCnD;;OAEG;IACH,MAAM,IAAI,IAAI;IAuCd;;OAEG;IACH,MAAM,IAAI,IAAI;IA6Bd;;;OAGG;IACH,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACH,IAAI;IAQJ;;;OAGG;IACH,KAAK,CAAC,KAAK,UAAO;;;;;;;IAelB;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS;CASpD"}

package/dist/esm/cache/storage.js

@@ -0,0 +1,333 @@
+import { EthereumJSErrorWithoutCode, bytesToUnprefixedHex, hexToBytes } from '@feelyourprotocol/util';
+import { OrderedMap } from '@js-sdsl/ordered-map';
+import debugDefault from 'debug';
+import { LRUCache } from 'lru-cache';
+import { Cache } from "./cache.js";
+import { CacheType } from "./types.js";
+export class StorageCache extends Cache {
+    constructor(opts) {
+        super();
+        /**
+         * Diff cache collecting the state of the cache
+         * at the beginning of checkpoint height
+         * (respectively: before a first modification)
+         *
+         * If the whole cache element is undefined (in contrast
+         * to the account), the element didn't exist in the cache
+         * before.
+         */
+        this._diffCache = [];
+        if (opts.type === CacheType.LRU) {
+            this._lruCache = new LRUCache({
+                max: opts.size,
+                updateAgeOnGet: true,
+            });
+        }
+        else {
+            this._orderedMapCache = new OrderedMap();
+        }
+        this._diffCache.push(new Map());
+        if (this.DEBUG) {
+            this._debug = debugDefault('statemanager:cache:storage');
+        }
+    }
+    _saveCachePreState(addressHex, keyHex) {
+        const addressStoragePreState = this._diffCache[this._checkpoints].get(addressHex);
+        const diffStorageMap = addressStoragePreState ?? new Map();
+        if (!diffStorageMap.has(keyHex)) {
+            let oldStorageMap;
+            let oldStorage = undefined;
+            if (this._lruCache) {
+                oldStorageMap = this._lruCache.get(addressHex);
+                if (oldStorageMap) {
+                    oldStorage = oldStorageMap.get(keyHex);
+                }
+            }
+            else {
+                oldStorageMap = this._orderedMapCache.getElementByKey(addressHex);
+                if (oldStorageMap) {
+                    oldStorage = oldStorageMap.get(keyHex);
+                }
+            }
+            diffStorageMap.set(keyHex, oldStorage);
+            this._diffCache[this._checkpoints].set(addressHex, diffStorageMap);
+        }
+    }
+    /**
+     * Puts storage value to cache under address_key cache key.
+     * @param address - Account address
+     * @param key - Storage key
+     * @param val - RLP-encoded storage value
+     */
+    put(address, key, value) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        const keyHex = bytesToUnprefixedHex(key);
+        this._saveCachePreState(addressHex, keyHex);
+        if (this.DEBUG) {
+            this._debug(`Put storage for ${addressHex}: ${keyHex} -> ${value !== undefined ? bytesToUnprefixedHex(value) : ''}`);
+        }
+        if (this._lruCache) {
+            let storageMap = this._lruCache.get(addressHex);
+            if (!storageMap) {
+                storageMap = new Map();
+            }
+            storageMap.set(keyHex, value);
+            this._lruCache.set(addressHex, storageMap);
+        }
+        else {
+            let storageMap = this._orderedMapCache.getElementByKey(addressHex);
+            if (!storageMap) {
+                storageMap = new Map();
+            }
+            storageMap.set(keyHex, value);
+            this._orderedMapCache.setElement(addressHex, storageMap);
+        }
+        this._stats.writes += 1;
+    }
+    /**
+     * Returns the queried slot as the RLP encoded storage value
+     * hexToBytes('0x80'): slot is known to be empty
+     * undefined: slot is not in cache
+     * @param address - Address of account
+     * @param key - Storage key
+     * @returns Storage value or undefined
+     */
+    get(address, key) {
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        const keyHex = bytesToUnprefixedHex(key);
+        if (this.DEBUG) {
+            this._debug(`Get storage for ${addressHex}`);
+        }
+        let storageMap;
+        if (this._lruCache) {
+            storageMap = this._lruCache.get(addressHex);
+        }
+        else {
+            storageMap = this._orderedMapCache.getElementByKey(addressHex);
+        }
+        this._stats.reads += 1;
+        if (storageMap) {
+            this._stats.hits += 1;
+            return storageMap.get(keyHex);
+        }
+    }
+    /**
+     * Marks storage key for address as deleted in cache.
+     * @param address - Address
+     * @param key - Storage key
+     */
+    del(address, key) {
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        const keyHex = bytesToUnprefixedHex(key);
+        this._saveCachePreState(addressHex, keyHex);
+        if (this.DEBUG) {
+            this._debug(`Delete storage for ${addressHex}: ${keyHex}`);
+        }
+        if (this._lruCache) {
+            let storageMap = this._lruCache.get(addressHex);
+            if (!storageMap) {
+                storageMap = new Map();
+            }
+            storageMap.set(keyHex, hexToBytes('0x80'));
+            this._lruCache.set(addressHex, storageMap);
+        }
+        else {
+            let storageMap = this._orderedMapCache.getElementByKey(addressHex);
+            if (!storageMap) {
+                storageMap = new Map();
+            }
+            storageMap.set(keyHex, hexToBytes('0x80'));
+            this._orderedMapCache.setElement(addressHex, storageMap);
+        }
+        this._stats.deletions += 1;
+    }
+    /**
+     * Deletes all storage slots for address from the cache
+     * @param address
+     */
+    clearStorage(address) {
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        if (this._lruCache) {
+            this._lruCache.set(addressHex, new Map());
+        }
+        else {
+            this._orderedMapCache.setElement(addressHex, new Map());
+        }
+    }
+    /**
+     * Flushes cache by returning storage slots that have been modified
+     * or deleted and resetting the diff cache (at checkpoint height).
+     */
+    flush() {
+        if (this.DEBUG) {
+            this._debug(`Flushing cache on checkpoint ${this._checkpoints}`);
+        }
+        const diffMap = this._diffCache[this._checkpoints];
+        const items = [];
+        for (const entry of diffMap.entries()) {
+            const addressHex = entry[0];
+            const diffStorageMap = entry[1];
+            let storageMap;
+            if (this._lruCache) {
+                storageMap = this._lruCache.get(addressHex);
+            }
+            else {
+                storageMap = this._orderedMapCache.getElementByKey(addressHex);
+            }
+            if (storageMap !== undefined) {
+                for (const entry of diffStorageMap.entries()) {
+                    const keyHex = entry[0];
+                    const value = storageMap.get(keyHex);
+                    items.push([addressHex, keyHex, value]);
+                }
+            }
+            else {
+                throw EthereumJSErrorWithoutCode('internal error: storage cache map for account should be defined');
+            }
+        }
+        this._diffCache[this._checkpoints] = new Map();
+        return items;
+    }
+    /**
+     * Revert changes to cache last checkpoint (no effect on trie).
+     */
+    revert() {
+        this._checkpoints -= 1;
+        if (this.DEBUG) {
+            this._debug(`Revert to checkpoint ${this._checkpoints}`);
+        }
+        const diffMap = this._diffCache.pop();
+        for (const entry of diffMap.entries()) {
+            const addressHex = entry[0];
+            const diffStorageMap = entry[1];
+            for (const entry of diffStorageMap.entries()) {
+                const keyHex = entry[0];
+                const value = entry[1];
+                if (this._lruCache) {
+                    const storageMap = this._lruCache.get(addressHex) ?? new Map();
+                    if (value === undefined) {
+                        // Value is known not to be in the cache before
+                        // -> delete from cache
+                        storageMap.delete(keyHex);
+                    }
+                    else {
+                        // Value is known to be in the cache before
+                        // (being either some storage value or the RLP-encoded empty Uint8Array)
+                        storageMap.set(keyHex, value);
+                    }
+                    this._lruCache.set(addressHex, storageMap);
+                }
+                else {
+                    const storageMap = this._orderedMapCache.getElementByKey(addressHex) ?? new Map();
+                    if (!value) {
+                        storageMap.delete(keyHex);
+                    }
+                    else {
+                        storageMap.set(keyHex, value);
+                    }
+                    this._orderedMapCache.setElement(addressHex, storageMap);
+                }
+            }
+        }
+    }
+    /**
+     * Commits to current state of cache (no effect on trie).
+     */
+    commit() {
+        this._checkpoints -= 1;
+        if (this.DEBUG) {
+            this._debug(`Commit to checkpoint ${this._checkpoints}`);
+        }
+        const higherHeightDiffMap = this._diffCache.pop();
+        const lowerHeightDiffMap = this._diffCache[this._checkpoints];
+        // Go through diffMap from the pre-commit checkpoint height.
+        // 1. Iterate through all state pre states
+        // 2. If state pre-state is not in the new (lower) height diff map, take pre commit pre state value
+        // 3. If state is in new map, take this one, since this supersedes subsequent changes
+        for (const entry of higherHeightDiffMap.entries()) {
+            const addressHex = entry[0];
+            const higherHeightStorageDiff = entry[1];
+            const lowerHeightStorageDiff = lowerHeightDiffMap.get(addressHex) ?? new Map();
+            for (const entry of higherHeightStorageDiff.entries()) {
+                const keyHex = entry[0];
+                if (!lowerHeightStorageDiff.has(keyHex)) {
+                    const elem = entry[1];
+                    lowerHeightStorageDiff.set(keyHex, elem);
+                }
+            }
+            lowerHeightDiffMap.set(addressHex, lowerHeightStorageDiff);
+        }
+    }
+    /**
+     * Marks current state of cache as checkpoint, which can
+     * later on be reverted or committed.
+     */
+    checkpoint() {
+        this._checkpoints += 1;
+        if (this.DEBUG) {
+            this._debug(`New checkpoint ${this._checkpoints}`);
+        }
+        this._diffCache.push(new Map());
+    }
+    /**
+     * Returns the size of the cache
+     * @returns
+     */
+    size() {
+        if (this._lruCache) {
+            return this._lruCache.size;
+        }
+        else {
+            return this._orderedMapCache.size();
+        }
+    }
+    /**
+     * Returns a dict with cache stats
+     * @param reset
+     */
+    stats(reset = true) {
+        const stats = { ...this._stats };
+        stats.size = this.size();
+        if (reset) {
+            this._stats = {
+                size: 0,
+                reads: 0,
+                hits: 0,
+                writes: 0,
+                deletions: 0,
+            };
+        }
+        return stats;
+    }
+    /**
+     * Clears cache.
+     */
+    clear() {
+        if (this.DEBUG) {
+            this._debug(`Clear cache`);
+        }
+        if (this._lruCache) {
+            this._lruCache.clear();
+        }
+        else {
+            this._orderedMapCache.clear();
+        }
+    }
+    /**
+     * Dumps the RLP-encoded storage values for an `account` specified by `address`.
+     * @param address - The address of the `account` to return storage for
+     * @returns {StorageCacheMap | undefined} - The storage values for the `account` or undefined if the `account` is not in the cache
+     */
+    dump(address) {
+        let storageMap;
+        if (this._lruCache) {
+            storageMap = this._lruCache.get(bytesToUnprefixedHex(address.bytes));
+        }
+        else {
+            storageMap = this._orderedMapCache?.getElementByKey(bytesToUnprefixedHex(address.bytes));
+        }
+        return storageMap;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/esm/cache/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/cache/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,YAAY,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAatC,MAAM,OAAO,YAAa,SAAQ,KAAK;IAerC,YAAY,IAAe;QACzB,KAAK,EAAE,CAAA;QAZT;;;;;;;;WAQG;QACH,eAAU,GAAuC,EAAE,CAAA;QAIjD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,CAAC;gBAC5B,GAAG,EAAE,IAAI,CAAC,IAAI;gBACd,cAAc,EAAE,IAAI;aACrB,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAgB,GAAG,IAAI,UAAU,EAAE,CAAA;QAC1C,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;QAE/B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,4BAA4B,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,UAAkB,EAAE,MAAc;QACnD,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACjF,MAAM,cAAc,GAAwB,sBAAsB,IAAI,IAAI,GAAG,EAAE,CAAA;QAE/E,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,IAAI,aAA0C,CAAA;YAC9C,IAAI,UAAU,GAA2B,SAAS,CAAA;YAClD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,aAAa,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;gBAC/C,IAAI,aAAa,EAAE,CAAC;oBAClB,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACxC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;gBAClE,IAAI,aAAa,EAAE,CAAC;oBAClB,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACxC,CAAC;YACH,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;YACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAgB,EAAE,GAAe,EAAE,KAAiB;QACtD,6FAA6F;QAC7F,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAE3C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CACT,mBAAmB,UAAU,KAAK,MAAM,OACtC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACtD,EAAE,CACH,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAChD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAC7B,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,UAAU,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;YACnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAC7B,IAAI,CAAC,gBAAiB,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QAC3D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAgB,EAAE,GAAe;QACnC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAA;QAC9C,CAAC;QAED,IAAI,UAAuC,CAAA;QAC3C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAA;QACtB,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAA;YACrB,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAgB,EAAE,GAAe;QACnC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,sBAAsB,UAAU,KAAK,MAAM,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAChD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;YAC1C,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,UAAU,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;YACnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;YAC1C,IAAI,CAAC,gBAAiB,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAgB;QAC3B,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAC5C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAiB,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,gCAAgC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QAClE,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAE,CAAA;QAEnD,MAAM,KAAK,GAA+C,EAAE,CAAA;QAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,UAAuC,CAAA;YAC3C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAC9C,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;YACjE,CAAC;YAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;oBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;oBACvB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;oBACpC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;gBACzC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,0BAA0B,CAC9B,iEAAiE,CAClE,CAAA;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,GAAG,EAAE,CAAA;QAC9C,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,YAAY,IAAI,CAAC,CAAA;QACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAG,CAAA;QAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAE/B,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;gBACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;gBACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;oBAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,+CAA+C;wBAC/C,uBAAuB;wBACvB,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;oBAC3B,CAAC;yBAAM,CAAC;wBACN,2CAA2C;wBAC3C,wEAAwE;wBACxE,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;oBAC/B,CAAC;oBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;gBAC5C,CAAC;qBAAM,CAAC;oBACN,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAiB,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;oBAClF,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;oBAC3B,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;oBAC/B,CAAC;oBACD,IAAI,CAAC,gBAAiB,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,YAAY,IAAI,CAAC,CAAA;QACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAG,CAAA;QAClD,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAE7D,4DAA4D;QAC5D,0CAA0C;QAC1C,mGAAmG;QACnG,qFAAqF;QACrF,KAAK,MAAM,KAAK,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,MAAM,uBAAuB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAExC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;YAE9E,KAAK,MAAM,KAAK,IAAI,uBAAuB,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;gBACvB,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;oBACrB,sBAAsB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;YACD,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,YAAY,IAAI,CAAC,CAAA;QACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;IACjC,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAU,CAAC,IAAI,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,gBAAiB,CAAC,IAAI,EAAE,CAAA;QACtC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,GAAG,IAAI;QAChB,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QAChC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,GAAG;gBACZ,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,CAAC;gBACP,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,CAAC;aACb,CAAA;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAU,CAAC,KAAK,EAAE,CAAA;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAiB,CAAC,KAAK,EAAE,CAAA;QAChC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAgB;QACnB,IAAI,UAAU,CAAA;QACd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QACvE,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1F,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;CACF"}

package/dist/esm/cache/types.d.ts

@@ -0,0 +1,36 @@
+export type CacheType = (typeof CacheType)[keyof typeof CacheType];
+export declare const CacheType: {
+    readonly LRU: "lru";
+    readonly ORDERED_MAP: "ordered_map";
+};
+export interface CacheOpts {
+    /**
+     * Size of the cache (only for LRU cache)
+     *
+     * Default: 100000 (account cache) / 20000 (storage cache) / 20000 (code cache)
+     *
+     * Note: the cache/trie interplay mechanism is designed in a way that
+     * the theoretical number of max modified accounts between two flush operations
+     * should be smaller than the cache size, otherwise the cache will "forget" the
+     * old modifications resulting in an incomplete set of trie-flushed accounts.
+     */
+    size: number;
+    /**
+     * Cache type to use.
+     *
+     * Available options:
+     *
+     * ORDERED_MAP: Cache with no fixed upper bound and dynamic allocation,
+     * use for dynamic setups like testing or similar.
+     *
+     * LRU: LRU cache with pre-allocation of memory and a fixed size.
+     * Use for larger and more persistent caches.
+     */
+    type: CacheType;
+}
+export interface CachesStateManagerOpts {
+    account?: Partial<CacheOpts>;
+    code?: Partial<CacheOpts>;
+    storage?: Partial<CacheOpts>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cache/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAElE,eAAO,MAAM,SAAS;;;CAGZ,CAAA;AAEV,MAAM,WAAW,SAAS;IACxB;;;;;;;;;OASG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;OAUG;IACH,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;CAC7B"}

package/dist/esm/cache/types.js

@@ -0,0 +1,5 @@
+export const CacheType = {
+    LRU: 'lru',
+    ORDERED_MAP: 'ordered_map',
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cache/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,EAAE,KAAK;IACV,WAAW,EAAE,aAAa;CAClB,CAAA"}

package/dist/esm/index.d.ts

@@ -0,0 +1,8 @@
+export * from './cache/index.ts';
+export * from './merkleStateManager.ts';
+export * from './proof/index.ts';
+export * from './rpcStateManager.ts';
+export * from './simpleStateManager.ts';
+export * from './statefulBinaryTreeStateManager.ts';
+export * from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qCAAqC,CAAA;AACnD,cAAc,YAAY,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+export * from "./cache/index.js";
+export * from "./merkleStateManager.js";
+export * from "./proof/index.js";
+export * from "./rpcStateManager.js";
+export * from "./simpleStateManager.js";
+export * from "./statefulBinaryTreeStateManager.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qCAAqC,CAAA;AACnD,cAAc,YAAY,CAAA"}