@feelyourprotocol/statemanager 8141.0.0

package/dist/cjs/types.d.ts

@@ -0,0 +1,92 @@
+import { type PrefixedHexString } from '@feelyourprotocol/util';
+import type { BinaryTree } from '@feelyourprotocol/binarytree';
+import type { Common } from '@feelyourprotocol/common';
+import type { MerklePatriciaTrie } from '@feelyourprotocol/mpt';
+import type { Caches } from './index.ts';
+/**
+ * Basic state manager options (not to be used directly)
+ */
+interface BaseStateManagerOpts {
+    /**
+     * The common to use
+     */
+    common?: Common;
+}
+/**
+ * Options for constructing a {@link SimpleStateManager}.
+ */
+export interface SimpleStateManagerOpts extends BaseStateManagerOpts {
+}
+export interface RPCStateManagerOpts extends BaseStateManagerOpts {
+    provider: string;
+    blockTag: bigint | 'earliest';
+}
+/**
+ * Options for constructing a {@link StateManager}.
+ */
+export interface MerkleStateManagerOpts extends BaseStateManagerOpts {
+    /**
+     * A {@link MerklePatriciaTrie} instance
+     */
+    trie?: MerklePatriciaTrie;
+    /**
+     * Option to prefix codehashes in the database. This defaults to `true`.
+     * If this is disabled, note that it is possible to corrupt the trie, by deploying code
+     * which code is equal to the preimage of a trie-node.
+     * E.g. by putting the code `0x80` into the empty trie, will lead to a corrupted trie.
+     */
+    prefixCodeHashes?: boolean;
+    /**
+     * Option to prefix the keys for the storage tries with the first 7 bytes from the
+     * associated account address. Activating this option gives a noticeable performance
+     * boost for storage DB reads when operating on larger tries.
+     *
+     * Note: Activating/deactivating this option causes continued state reads to be
+     * incompatible with existing databases.
+     *
+     * Default: false (for backwards compatibility reasons)
+     */
+    prefixStorageTrieKeys?: boolean;
+    /**
+     * Options to enable and configure the use of a cache account, code and storage
+     * This can be useful for speeding up reads, especially when the trie is large.
+     * The cache is only used for reading from the trie and is not used for writing to the trie.
+     *
+     * Default: false
+     */
+    caches?: Caches;
+}
+/**
+ * Options dictionary.
+ */
+export interface StatelessVerkleStateManagerOpts extends BaseStateManagerOpts {
+    common: Common;
+    caches?: Caches;
+}
+export interface StatefulBinaryTreeStateManagerOpts extends BaseStateManagerOpts {
+    hashFunction?: (data: Uint8Array) => Uint8Array;
+    tree?: BinaryTree;
+    caches?: Caches;
+}
+export interface BinaryTreeState {
+    [key: PrefixedHexString]: PrefixedHexString | null;
+}
+export interface EncodedBinaryTreeState {
+    [key: PrefixedHexString]: PrefixedHexString | null;
+}
+export type StorageProof = {
+    key: PrefixedHexString;
+    proof: PrefixedHexString[];
+    value: PrefixedHexString;
+};
+export type Proof = {
+    address: PrefixedHexString;
+    balance: PrefixedHexString;
+    codeHash: PrefixedHexString;
+    nonce: PrefixedHexString;
+    storageHash: PrefixedHexString;
+    accountProof: PrefixedHexString[];
+    storageProof: StorageProof[];
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC;;GAEG;AACH,UAAU,oBAAoB;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;CAEnE;AAED,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE;;OAEG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAE1B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kCAAmC,SAAQ,oBAAoB;IAC9E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAA;IAC/C,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,IAAI,CAAA;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,IAAI,CAAA;CACnD;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,iBAAiB,CAAA;IACtB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,KAAK,EAAE,iBAAiB,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,OAAO,EAAE,iBAAiB,CAAA;IAC1B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,KAAK,EAAE,iBAAiB,CAAA;IACxB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,YAAY,EAAE,iBAAiB,EAAE,CAAA;IACjC,YAAY,EAAE,YAAY,EAAE,CAAA;CAC7B,CAAA"}

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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

package/dist/cjs/util.d.ts

@@ -0,0 +1,4 @@
+import type { AccountFields, StateManagerInterface } from '@feelyourprotocol/common';
+import type { Address } from '@feelyourprotocol/util';
+export declare function modifyAccountFields(stateManager: StateManagerInterface, address: Address, accountFields: AccountFields): Promise<void>;
+//# sourceMappingURL=util.d.ts.map

package/dist/cjs/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/cjs/util.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modifyAccountFields = modifyAccountFields;
+const util_1 = require("@feelyourprotocol/util");
+async function modifyAccountFields(stateManager, address, accountFields) {
+    const account = (await stateManager.getAccount(address)) ?? new util_1.Account();
+    account.nonce = accountFields.nonce ?? account.nonce;
+    account.balance = accountFields.balance ?? account.balance;
+    account.storageRoot = accountFields.storageRoot ?? account.storageRoot;
+    account.codeHash = accountFields.codeHash ?? account.codeHash;
+    account.codeSize = accountFields.codeSize ?? account.codeSize;
+    //@ts-expect-error -- Checking for an instantiated property that is not part of the interface
+    if (stateManager['_debug'] !== undefined) {
+        for (const [field, value] of Object.entries(accountFields)) {
+            //@ts-expect-error -- Accessing an instantiated property that is not part of the interface
+            stateManager['_debug'](`modifyAccountFields address=${address.toString()} ${field}=${value instanceof Uint8Array ? (0, util_1.bytesToHex)(value) : value} `);
+        }
+    }
+    await stateManager.putAccount(address, account);
+}
+//# sourceMappingURL=util.js.map

package/dist/cjs/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":";;AAKA,kDAsBC;AA3BD,2CAAsD;AAK/C,KAAK,UAAU,mBAAmB,CACvC,YAAmC,EACnC,OAAgB,EAChB,aAA4B;IAE5B,MAAM,OAAO,GAAG,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,cAAO,EAAE,CAAA;IAEzE,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAA;IACpD,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;IAC1D,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAA;IACtE,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IAC7D,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IAC7D,6FAA6F;IAC7F,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3D,0FAA0F;YAC1F,YAAY,CAAC,QAAQ,CAAC,CACpB,+BAA+B,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,IAAA,iBAAU,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CACzH,CAAA;QACH,CAAC;IACH,CAAC;IACD,MAAM,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACjD,CAAC"}

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

@@ -0,0 +1,85 @@
+import { OrderedMap } from '@js-sdsl/ordered-map';
+import { LRUCache } from 'lru-cache';
+import { Cache } from './cache.ts';
+import type { Account, Address } from '@feelyourprotocol/util';
+import type { CacheOpts } from './types.ts';
+/**
+ * account: undefined
+ *
+ * Account is known to not exist in the trie
+ */
+type AccountCacheElement = {
+    accountRLP: Uint8Array | undefined;
+};
+export declare class AccountCache extends Cache {
+    _lruCache: LRUCache<string, AccountCacheElement> | undefined;
+    _orderedMapCache: OrderedMap<string, AccountCacheElement> | 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, AccountCacheElement | undefined>[];
+    constructor(opts: CacheOpts);
+    _saveCachePreState(cacheKeyHex: string): void;
+    /**
+     * Puts account to cache under its address.
+     * @param address - Address of account
+     * @param account - Account or undefined if account doesn't exist in the trie
+     */
+    put(address: Address, account: Account | undefined, couldBePartialAccount?: boolean): void;
+    /**
+     * Returns the queried account or undefined if account doesn't exist
+     * @param address - Address of account
+     */
+    get(address: Address): AccountCacheElement | undefined;
+    /**
+     * Marks address as deleted in cache.
+     * @param address - Address
+     */
+    del(address: Address): void;
+    /**
+     * Flushes cache by returning accounts that have been modified
+     * or deleted and resetting the diff cache (at checkpoint height).
+     */
+    flush(): [string, AccountCacheElement][];
+    /**
+     * 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;
+}
+export {};
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/cache/account.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,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;GAIG;AACH,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAA;CACnC,CAAA;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAA;IAC5D,gBAAgB,EAAE,UAAU,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAA;IAErE;;;;;;;;OAQG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC,EAAE,CAAK;gBACnD,IAAI,EAAE,SAAS;IAe3B,kBAAkB,CAAC,WAAW,EAAE,MAAM;IAatC;;;;OAIG;IACH,GAAG,CACD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,qBAAqB,GAAE,OAAe,GACrC,IAAI;IAwBP;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS;IAoBtD;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAoB3B;;;OAGG;IACH,KAAK,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE;IA0BxC;;OAEG;IACH,MAAM,IAAI,IAAI;IAyBd;;OAEG;IACH,MAAM,IAAI,IAAI;IAgBd;;;OAGG;IACH,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACH,IAAI;IAQJ;;;OAGG;IACH,KAAK,CAAC,KAAK,UAAO;;;;;;;IAelB;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd"}

package/dist/esm/cache/account.js

@@ -0,0 +1,248 @@
+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 AccountCache 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());
+        this._debug = debugDefault('statemanager:cache:account');
+    }
+    _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 account to cache under its address.
+     * @param address - Address of account
+     * @param account - Account or undefined if account doesn't exist in the trie
+     */
+    put(address, account, couldBePartialAccount = false) {
+        // Using deprecated bytesToUnprefixedHex for performance: used as Map keys for cache lookups.
+        const addressHex = bytesToUnprefixedHex(address.bytes);
+        this._saveCachePreState(addressHex);
+        const elem = {
+            accountRLP: account !== undefined
+                ? couldBePartialAccount
+                    ? account.serializeWithPartialInfo()
+                    : account.serialize()
+                : undefined,
+        };
+        if (this.DEBUG) {
+            this._debug(`Put account ${addressHex}`);
+        }
+        if (this._lruCache) {
+            this._lruCache.set(addressHex, elem);
+        }
+        else {
+            this._orderedMapCache.setElement(addressHex, elem);
+        }
+        this._stats.writes += 1;
+    }
+    /**
+     * Returns the queried account or undefined if account doesn't exist
+     * @param address - Address of account
+     */
+    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 account ${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 address as deleted in cache.
+     * @param address - Address
+     */
+    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 account ${addressHex}`);
+        }
+        if (this._lruCache) {
+            this._lruCache.set(addressHex, {
+                accountRLP: undefined,
+            });
+        }
+        else {
+            this._orderedMapCache.setElement(addressHex, {
+                accountRLP: undefined,
+            });
+        }
+        this._stats.deletions += 1;
+    }
+    /**
+     * Flushes cache by returning accounts 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 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 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 to current state of 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 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();
+        }
+    }
+}
+//# sourceMappingURL=account.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { Debugger } from 'debug';
+export declare class Cache {
+    _debug: Debugger;
+    _checkpoints: number;
+    _stats: {
+        size: number;
+        reads: number;
+        hits: number;
+        writes: number;
+        deletions: number;
+    };
+    /**
+     * StateManager cache is run in DEBUG mode (default: false)
+     * Taken from DEBUG environment variable
+     *
+     * Safeguards on debug() calls are added for
+     * performance reasons to avoid string literal evaluation
+     * @hidden
+     */
+    protected readonly DEBUG: boolean;
+    constructor();
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/cache/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,qBAAa,KAAK;IAChB,MAAM,EAAE,QAAQ,CAAA;IAEhB,YAAY,SAAI;IAEhB,MAAM;;;;;;MAML;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAQ;;CAQ1C"}

package/dist/esm/cache/cache.js

@@ -0,0 +1,27 @@
+import { isDebugEnabled } from '@feelyourprotocol/util';
+import debugDefault from 'debug';
+export class Cache {
+    constructor() {
+        this._checkpoints = 0;
+        this._stats = {
+            size: 0,
+            reads: 0,
+            hits: 0,
+            writes: 0,
+            deletions: 0,
+        };
+        /**
+         * StateManager cache is run in DEBUG mode (default: false)
+         * Taken from DEBUG environment variable
+         *
+         * Safeguards on debug() calls are added for
+         * performance reasons to avoid string literal evaluation
+         * @hidden
+         */
+        this.DEBUG = false;
+        // Skip DEBUG calls unless 'ethjs' included in environmental DEBUG variables
+        this.DEBUG = isDebugEnabled('ethjs');
+        this._debug = debugDefault('statemanager:cache');
+    }
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,YAAY,MAAM,OAAO,CAAA;AAIhC,MAAM,OAAO,KAAK;IAuBhB;QApBA,iBAAY,GAAG,CAAC,CAAA;QAEhB,WAAM,GAAG;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;SACb,CAAA;QAED;;;;;;;WAOG;QACgB,UAAK,GAAY,KAAK,CAAA;QAGvC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAEpC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAA;IAClD,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import { AccountCache } from './account.ts';
+import { CodeCache } from './code.ts';
+import { StorageCache } from './storage.ts';
+import { type CacheOpts, type CachesStateManagerOpts } from './types.ts';
+import type { Address } from '@feelyourprotocol/util';
+export declare class Caches {
+    account?: AccountCache;
+    code?: CodeCache;
+    storage?: StorageCache;
+    settings: Record<'account' | 'code' | 'storage', CacheOpts>;
+    constructor(opts?: CachesStateManagerOpts);
+    checkpoint(): void;
+    clear(): void;
+    commit(): void;
+    deleteAccount(address: Address): void;
+    shallowCopy(downlevelCaches: boolean): Caches | undefined;
+    revert(): void;
+}
+//# sourceMappingURL=caches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caches.d.ts","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,EAAE,KAAK,SAAS,EAAa,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,qBAAa,MAAM;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB,QAAQ,EAAE,MAAM,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,CAAA;gBAE/C,IAAI,GAAE,sBAA2B;IA4C7C,UAAU;IAMV,KAAK;IAML,MAAM;IAMN,aAAa,CAAC,OAAO,EAAE,OAAO;IAM9B,WAAW,CAAC,eAAe,EAAE,OAAO;IAqCpC,MAAM;CAKP"}