@feelyourprotocol/statemanager 8141.0.0

package/dist/esm/cache/caches.js

@@ -0,0 +1,103 @@
+import { AccountCache } from "./account.js";
+import { CodeCache } from "./code.js";
+import { StorageCache } from "./storage.js";
+import { CacheType } from "./types.js";
+export class Caches {
+    constructor(opts = {}) {
+        const accountSettings = {
+            type: opts.account?.type ?? CacheType.ORDERED_MAP,
+            size: opts.account?.size ?? 100000,
+        };
+        const codeSettings = {
+            type: opts.code?.type ?? CacheType.ORDERED_MAP,
+            size: opts.code?.size ?? 20000,
+        };
+        const storageSettings = {
+            type: opts.storage?.type ?? CacheType.ORDERED_MAP,
+            size: opts.storage?.size ?? 20000,
+        };
+        this.settings = {
+            account: accountSettings,
+            code: codeSettings,
+            storage: storageSettings,
+        };
+        if (this.settings.account.size !== 0) {
+            this.account = new AccountCache({
+                size: this.settings.account.size,
+                type: this.settings.account.type,
+            });
+        }
+        if (this.settings.code.size !== 0) {
+            this.code = new CodeCache({
+                size: this.settings.code.size,
+                type: this.settings.code.type,
+            });
+        }
+        if (this.settings.storage.size !== 0) {
+            this.storage = new StorageCache({
+                size: this.settings.storage.size,
+                type: this.settings.storage.type,
+            });
+        }
+    }
+    checkpoint() {
+        this.account?.checkpoint();
+        this.storage?.checkpoint();
+        this.code?.checkpoint();
+    }
+    clear() {
+        this.account?.clear();
+        this.storage?.clear();
+        this.code?.clear();
+    }
+    commit() {
+        this.account?.commit();
+        this.storage?.commit();
+        this.code?.commit();
+    }
+    deleteAccount(address) {
+        this.code?.del(address);
+        this.account?.del(address);
+        this.storage?.clearStorage(address);
+    }
+    shallowCopy(downlevelCaches) {
+        let cacheOptions;
+        // Account cache options
+        if (this.settings.account.size !== 0) {
+            cacheOptions = {
+                account: downlevelCaches
+                    ? { size: this.settings.account.size, type: CacheType.ORDERED_MAP }
+                    : this.settings.account,
+            };
+        }
+        // Storage cache options
+        if (this.settings.storage.size !== 0) {
+            cacheOptions = {
+                ...cacheOptions,
+                storage: downlevelCaches
+                    ? { size: this.settings.storage.size, type: CacheType.ORDERED_MAP }
+                    : this.settings.storage,
+            };
+        }
+        // Code cache options
+        if (this.settings.code.size !== 0) {
+            cacheOptions = {
+                ...cacheOptions,
+                code: downlevelCaches
+                    ? { size: this.settings.code.size, type: CacheType.ORDERED_MAP }
+                    : this.settings.code,
+            };
+        }
+        if (cacheOptions !== undefined) {
+            return new Caches(cacheOptions);
+        }
+        else
+            return undefined;
+    }
+    revert() {
+        this.account?.revert();
+        this.storage?.revert();
+        this.code?.revert();
+    }
+}
+//# sourceMappingURL=caches.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caches.js","sourceRoot":"","sources":["../../../src/cache/caches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAkB,SAAS,EAA+B,MAAM,YAAY,CAAA;AAInF,MAAM,OAAO,MAAM;IAOjB,YAAY,OAA+B,EAAE;QAC3C,MAAM,eAAe,GAAG;YACtB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,WAAW;YACjD,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,MAAM;SACnC,CAAA;QAED,MAAM,YAAY,GAAG;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,CAAC,WAAW;YAC9C,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,KAAK;SAC/B,CAAA;QAED,MAAM,eAAe,GAAG;YACtB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,WAAW;YACjD,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,KAAK;SAClC,CAAA;QAED,IAAI,CAAC,QAAQ,GAAG;YACd,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,eAAe;SACzB,CAAA;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;gBAC9B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;gBAChC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;aACjC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC;gBACxB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI;gBAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI;aAC9B,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;gBAC9B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;gBAChC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;aACjC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;IACzB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;QACrB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;QACtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;QACtB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IACrB,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;QAC1B,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,WAAW,CAAC,eAAwB;QAClC,IAAI,YAAgD,CAAA;QAEpD,wBAAwB;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,YAAY,GAAG;gBACb,OAAO,EAAE,eAAe;oBACtB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE;oBACnE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO;aAC1B,CAAA;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,YAAY,GAAG;gBACb,GAAG,YAAY;gBACf,OAAO,EAAE,eAAe;oBACtB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE;oBACnE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO;aAC1B,CAAA;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClC,YAAY,GAAG;gBACb,GAAG,YAAY;gBACf,IAAI,EAAE,eAAe;oBACnB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE;oBAChE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI;aACvB,CAAA;QACH,CAAC;QAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,IAAI,MAAM,CAAC,YAAY,CAAC,CAAA;QACjC,CAAC;;YAAM,OAAO,SAAS,CAAA;IACzB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;QACtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;QACtB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IACrB,CAAC;CACF"}

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

@@ -0,0 +1,87 @@
+import { OrderedMap } from '@js-sdsl/ordered-map';
+import { LRUCache } from 'lru-cache';
+import { Cache } from './cache.ts';
+import type { Address } from '@feelyourprotocol/util';
+import type { CacheOpts } from './types.ts';
+/**
+ * Represents a cached code element.
+ */
+type CodeCacheElement = {
+    code: Uint8Array | undefined;
+};
+export declare class CodeCache extends Cache {
+    _lruCache: LRUCache<string, CodeCacheElement> | undefined;
+    _orderedMapCache: OrderedMap<string, CodeCacheElement> | undefined;
+    /**
+     * 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 code), the element didn't exist in the cache
+     * before.
+     */
+    _diffCache: Map<string, CodeCacheElement | undefined>[];
+    constructor(opts: CacheOpts);
+    /**
+     * Saves the state of the code cache before making changes to it.
+     *
+     * @param cacheKeyHex Account key for which code is being modified.
+     */
+    _saveCachePreState(cacheKeyHex: string): void;
+    /**
+     * Puts code into the cache under its hash.
+     *
+     * @param address - Address of account code is being modified for.
+     * @param code - Bytecode or undefined if code doesn't exist.
+     */
+    put(address: Address, code: Uint8Array | undefined): void;
+    /**
+     * Returns the queried code or undefined if it doesn't exist.
+     *
+     * @param address - Account address for which code is being fetched.
+     */
+    get(address: Address): CodeCacheElement | undefined;
+    /**
+     * Marks code as deleted in the cache.
+     *
+     * @param address - Account address for which code is being fetched.
+     */
+    del(address: Address): void;
+    /**
+     * Flushes the cache by returning codes that have been modified
+     * or deleted and resetting the diff cache (at checkpoint height).
+     */
+    flush(): [string, CodeCacheElement][];
+    /**
+     * Revert changes to the cache to the last checkpoint (no effect on trie).
+     */
+    revert(): void;
+    /**
+     * Commits the current state of the cache (no effect on trie).
+     */
+    commit(): void;
+    /**
+     * Marks the current state of the cache as a checkpoint, which can
+     * later be reverted or committed.
+     */
+    checkpoint(): void;
+    /**
+     * Returns the size of the cache
+     * @returns
+     */
+    size(): number;
+    /**
+     * Returns a dictionary with cache statistics.
+     *
+     * @param reset - Whether to reset statistics after retrieval.
+     * @returns A dictionary with cache statistics.
+     */
+    stats(reset?: boolean): any;
+    /**
+     * Clears the cache.
+     */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/cache/code.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;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;CAC7B,CAAA;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAA;IACzD,gBAAgB,EAAE,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAA;IAElE;;;;;;;;OAQG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC,EAAE,CAAK;gBAEhD,IAAI,EAAE,SAAS;IAe3B;;;;OAIG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM;IAatC;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI;IAmBzD;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS;IAoBnD;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAoB3B;;;OAGG;IACH,KAAK,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE;IA0BrC;;OAEG;IACH,MAAM,IAAI,IAAI;IAyBd;;OAEG;IACH,MAAM,IAAI,IAAI;IAgBd;;;OAGG;IACH,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACH,IAAI;IAQJ;;;;;OAKG;IACH,KAAK,CAAC,KAAK,UAAO,GAAG,GAAG;IAexB;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd"}

package/dist/esm/cache/code.js

@@ -0,0 +1,254 @@
+import { bytesToUnprefixedHex } 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 CodeCache 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 code), 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());
+        this._debug = debugDefault('statemanager:cache:code');
+    }
+    /**
+     * Saves the state of the code cache before making changes to it.
+     *
+     * @param cacheKeyHex Account key for which code is being modified.
+     */
+    _saveCachePreState(cacheKeyHex) {
+        const diffMap = this._diffCache[this._checkpoints];
+        if (!diffMap.has(cacheKeyHex)) {
+            let oldElem;
+            if (this._lruCache) {
+                oldElem = this._lruCache.get(cacheKeyHex);
+            }
+            else {
+                oldElem = this._orderedMapCache.getElementByKey(cacheKeyHex);
+            }
+            diffMap.set(cacheKeyHex, oldElem);
+        }
+    }
+    /**
+     * Puts code into the cache under its hash.
+     *
+     * @param address - Address of account code is being modified for.
+     * @param code - Bytecode or undefined if code doesn't exist.
+     */
+    put(address, code) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        this._saveCachePreState(addressHex);
+        const elem = {
+            code,
+        };
+        if (this.DEBUG) {
+            this._debug(`Put code ${addressHex}`);
+        }
+        if (this._lruCache) {
+            this._lruCache.set(addressHex, elem);
+        }
+        else {
+            this._orderedMapCache.setElement(addressHex, elem);
+        }
+        this._stats.writes += 1;
+    }
+    /**
+     * Returns the queried code or undefined if it doesn't exist.
+     *
+     * @param address - Account address for which code is being fetched.
+     */
+    get(address) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        if (this.DEBUG) {
+            this._debug(`Get code ${addressHex}`);
+        }
+        let elem;
+        if (this._lruCache) {
+            elem = this._lruCache.get(addressHex);
+        }
+        else {
+            elem = this._orderedMapCache.getElementByKey(addressHex);
+        }
+        this._stats.reads += 1;
+        if (elem) {
+            this._stats.hits += 1;
+        }
+        return elem;
+    }
+    /**
+     * Marks code as deleted in the cache.
+     *
+     * @param address - Account address for which code is being fetched.
+     */
+    del(address) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        this._saveCachePreState(addressHex);
+        if (this.DEBUG) {
+            this._debug(`Delete code ${addressHex}`);
+        }
+        if (this._lruCache) {
+            this._lruCache.set(addressHex, {
+                code: undefined,
+            });
+        }
+        else {
+            this._orderedMapCache.setElement(addressHex, {
+                code: undefined,
+            });
+        }
+        this._stats.deletions += 1;
+    }
+    /**
+     * Flushes the cache by returning codes 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 cacheKeyHex = entry[0];
+            let elem;
+            if (this._lruCache) {
+                elem = this._lruCache.get(cacheKeyHex);
+            }
+            else {
+                elem = this._orderedMapCache.getElementByKey(cacheKeyHex);
+            }
+            if (elem !== undefined) {
+                items.push([cacheKeyHex, elem]);
+            }
+        }
+        this._diffCache[this._checkpoints] = new Map();
+        return items;
+    }
+    /**
+     * Revert changes to the cache to the 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 elem = entry[1];
+            if (elem === undefined) {
+                if (this._lruCache) {
+                    this._lruCache.delete(addressHex);
+                }
+                else {
+                    this._orderedMapCache.eraseElementByKey(addressHex);
+                }
+            }
+            else {
+                if (this._lruCache) {
+                    this._lruCache.set(addressHex, elem);
+                }
+                else {
+                    this._orderedMapCache.setElement(addressHex, elem);
+                }
+            }
+        }
+    }
+    /**
+     * Commits the current state of the cache (no effect on trie).
+     */
+    commit() {
+        this._checkpoints -= 1;
+        if (this.DEBUG) {
+            this._debug(`Commit to checkpoint ${this._checkpoints}`);
+        }
+        const diffMap = this._diffCache.pop();
+        for (const entry of diffMap.entries()) {
+            const addressHex = entry[0];
+            const oldEntry = this._diffCache[this._checkpoints].has(addressHex);
+            if (!oldEntry) {
+                const elem = entry[1];
+                this._diffCache[this._checkpoints].set(addressHex, elem);
+            }
+        }
+    }
+    /**
+     * Marks the current state of the cache as a checkpoint, which can
+     * later 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 dictionary with cache statistics.
+     *
+     * @param reset - Whether to reset statistics after retrieval.
+     * @returns A dictionary with cache statistics.
+     */
+    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 the cache.
+     */
+    clear() {
+        if (this.DEBUG) {
+            this._debug(`Clear cache`);
+        }
+        if (this._lruCache) {
+            this._lruCache.clear();
+        }
+        else {
+            this._orderedMapCache.clear();
+        }
+    }
+}
+//# sourceMappingURL=code.js.map

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

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

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

@@ -0,0 +1,7 @@
+export * from './account.ts';
+export * from './caches.ts';
+export * from './code.ts';
+export * from './originalStorageCache.ts';
+export * from './storage.ts';
+export * from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/esm/cache/index.js

@@ -0,0 +1,7 @@
+export * from "./account.js";
+export * from "./caches.js";
+export * from "./code.js";
+export * from "./originalStorageCache.js";
+export * from "./storage.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { Address } from '@feelyourprotocol/util';
+type getStorage = (address: Address, key: Uint8Array) => Promise<Uint8Array>;
+/**
+ * Helper class to cache original storage values (so values already being present in
+ * the pre-state of a call), mainly for correct gas cost calculation in EVM/VM.
+ *
+ * TODO: Usage of this class is very implicit through the injected `getStorage()`
+ * method bound to the calling state manager. It should be examined if there are alternative
+ * designs being more transparent and direct along the next breaking release round.
+ *
+ */
+export declare class OriginalStorageCache {
+    private map;
+    private getStorage;
+    constructor(getStorage: getStorage);
+    get(address: Address, key: Uint8Array): Promise<Uint8Array>;
+    put(address: Address, key: Uint8Array, value: Uint8Array): void;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=originalStorageCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"originalStorageCache.d.ts","sourceRoot":"","sources":["../../../src/cache/originalStorageCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;AAE5E;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAsC;IACjD,OAAO,CAAC,UAAU,CAAY;gBAClB,UAAU,EAAE,UAAU;IAK5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBjE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU;IAcxD,KAAK,IAAI,IAAI;CAGd"}

package/dist/esm/cache/originalStorageCache.js

@@ -0,0 +1,48 @@
+import { bytesToUnprefixedHex } from '@feelyourprotocol/util';
+/**
+ * Helper class to cache original storage values (so values already being present in
+ * the pre-state of a call), mainly for correct gas cost calculation in EVM/VM.
+ *
+ * TODO: Usage of this class is very implicit through the injected `getStorage()`
+ * method bound to the calling state manager. It should be examined if there are alternative
+ * designs being more transparent and direct along the next breaking release round.
+ *
+ */
+export class OriginalStorageCache {
+    constructor(getStorage) {
+        this.map = new Map();
+        this.getStorage = getStorage;
+    }
+    async get(address, key) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        const map = this.map.get(addressHex);
+        if (map !== undefined) {
+            const keyHex = bytesToUnprefixedHex(key);
+            const value = map.get(keyHex);
+            if (value !== undefined) {
+                return value;
+            }
+        }
+        const value = await this.getStorage(address, key);
+        this.put(address, key, value);
+        return value;
+    }
+    put(address, key, value) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        let map = this.map.get(addressHex);
+        if (map === undefined) {
+            map = new Map();
+            this.map.set(addressHex, map);
+        }
+        const keyHex = bytesToUnprefixedHex(key);
+        if (map.has(keyHex) === false) {
+            map.set(keyHex, value);
+        }
+    }
+    clear() {
+        this.map = new Map();
+    }
+}
+//# sourceMappingURL=originalStorageCache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"originalStorageCache.js","sourceRoot":"","sources":["../../../src/cache/originalStorageCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAMvD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAG/B,YAAY,UAAsB;QAChC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;QACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,GAAe;QACzC,6FAA6F;QAC7F,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;YACxC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QAC7B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,GAAG,CAAC,OAAgB,EAAE,GAAe,EAAE,KAAiB;QACtD,6FAA6F;QAC7F,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAClC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;YACf,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,GAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/B,GAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACtB,CAAC;CACF"}

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

@@ -0,0 +1,101 @@
+import { OrderedMap } from '@js-sdsl/ordered-map';
+import { LRUCache } from 'lru-cache';
+import { Cache } from './cache.ts';
+import type { Address } from '@feelyourprotocol/util';
+import type { CacheOpts } from './types.ts';
+/**
+ * key -> storage mapping
+ *
+ * undefined: storage value is known not to exist in the cache
+ */
+type DiffStorageCacheMap = Map<string, Uint8Array | undefined>;
+type StorageCacheMap = Map<string, Uint8Array>;
+export declare class StorageCache extends Cache {
+    _lruCache: LRUCache<string, StorageCacheMap> | undefined;
+    _orderedMapCache: OrderedMap<string, StorageCacheMap> | undefined;
+    /**
+     * 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.
+     */
+    _diffCache: Map<string, DiffStorageCacheMap>[];
+    constructor(opts: CacheOpts);
+    _saveCachePreState(addressHex: string, keyHex: string): void;
+    /**
+     * 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: Address, key: Uint8Array, value: Uint8Array): void;
+    /**
+     * 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: Address, key: Uint8Array): Uint8Array | undefined;
+    /**
+     * Marks storage key for address as deleted in cache.
+     * @param address - Address
+     * @param key - Storage key
+     */
+    del(address: Address, key: Uint8Array): void;
+    /**
+     * Deletes all storage slots for address from the cache
+     * @param address
+     */
+    clearStorage(address: Address): void;
+    /**
+     * Flushes cache by returning storage slots that have been modified
+     * or deleted and resetting the diff cache (at checkpoint height).
+     */
+    flush(): [string, string, Uint8Array | undefined][];
+    /**
+     * Revert changes to cache last checkpoint (no effect on trie).
+     */
+    revert(): void;
+    /**
+     * Commits to current state of cache (no effect on trie).
+     */
+    commit(): void;
+    /**
+     * Marks current state of cache as checkpoint, which can
+     * later on be reverted or committed.
+     */
+    checkpoint(): void;
+    /**
+     * Returns the size of the cache
+     * @returns
+     */
+    size(): number;
+    /**
+     * Returns a dict with cache stats
+     * @param reset
+     */
+    stats(reset?: boolean): {
+        size: number;
+        reads: number;
+        hits: number;
+        writes: number;
+        deletions: number;
+    };
+    /**
+     * Clears cache.
+     */
+    clear(): void;
+    /**
+     * 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: Address): StorageCacheMap | undefined;
+}
+export {};
+//# sourceMappingURL=storage.d.ts.map