@feelyourprotocol/statemanager 8141.0.0

package/dist/esm/rpcStateManager.js

@@ -0,0 +1,308 @@
+import { Common, Mainnet } from '@feelyourprotocol/common';
+import { RLP } from '@feelyourprotocol/rlp';
+import { Account, EthereumJSErrorWithoutCode, bigIntToHex, bytesToHex, createAccount, createAccountFromRLP, equalsBytes, fetchFromProvider, hexToBytes, intToHex, isDebugEnabled, toBytes, } from '@feelyourprotocol/util';
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import debugDefault from 'debug';
+import { Caches, OriginalStorageCache } from "./cache/index.js";
+import { modifyAccountFields } from "./util.js";
+const KECCAK256_RLP_EMPTY_ACCOUNT = RLP.encode(new Account().serialize()).slice(2);
+export class RPCStateManager {
+    constructor(opts) {
+        /**
+         * @deprecated This method is not used by the RPC State Manager and is a stub required by the State Manager interface
+         */
+        this.getStateRoot = async () => {
+            return new Uint8Array(32);
+        };
+        /**
+         * @deprecated This method is not used by the RPC State Manager and is a stub required by the State Manager interface
+         */
+        this.setStateRoot = async (_root) => { };
+        /**
+         * @deprecated This method is not used by the RPC State Manager and is a stub required by the State Manager interface
+         */
+        this.hasStateRoot = () => {
+            throw EthereumJSErrorWithoutCode('function not implemented');
+        };
+        // Skip DEBUG calls unless 'ethjs' included in environmental DEBUG variables
+        this.DEBUG = isDebugEnabled('ethjs');
+        this._debug = debugDefault('statemanager:rpc');
+        if (typeof opts.provider === 'string' && opts.provider.startsWith('http')) {
+            this._provider = opts.provider;
+        }
+        else {
+            throw EthereumJSErrorWithoutCode(`valid RPC provider url required; got ${opts.provider}`);
+        }
+        this._blockTag = opts.blockTag === 'earliest' ? opts.blockTag : bigIntToHex(opts.blockTag);
+        this._caches = new Caches({ storage: { size: 100000 }, code: { size: 100000 } });
+        this.originalStorageCache = new OriginalStorageCache(this.getStorage.bind(this));
+        this.common = opts.common ?? new Common({ chain: Mainnet });
+        this.keccakFunction = opts.common?.customCrypto.keccak256 ?? keccak_256;
+    }
+    /**
+     * Note that the returned statemanager will share the same JSONRPCProvider as the original
+     *
+     * @returns RPCStateManager
+     */
+    shallowCopy() {
+        const newState = new RPCStateManager({
+            provider: this._provider,
+            blockTag: BigInt(this._blockTag),
+        });
+        newState._caches = new Caches({ storage: { size: 100000 } });
+        return newState;
+    }
+    /**
+     * Sets the new block tag used when querying the provider and clears the
+     * internal cache.
+     * @param blockTag - the new block tag to use when querying the provider
+     */
+    setBlockTag(blockTag) {
+        this._blockTag = blockTag === 'earliest' ? blockTag : bigIntToHex(blockTag);
+        this.clearCaches();
+        if (this.DEBUG)
+            this._debug(`setting block tag to ${this._blockTag}`);
+    }
+    /**
+     * Clears the internal cache so all accounts, contract code, and storage slots will
+     * initially be retrieved from the provider
+     */
+    clearCaches() {
+        this._caches.clear();
+    }
+    /**
+     * Gets the code corresponding to the provided `address`.
+     * @param address - Address to get the `code` for
+     * @returns {Promise<Uint8Array>} - Resolves with the code corresponding to the provided address.
+     * Returns an empty `Uint8Array` if the account has no associated code.
+     */
+    async getCode(address) {
+        let codeBytes = this._caches.code?.get(address)?.code;
+        if (codeBytes !== undefined)
+            return codeBytes;
+        const code = await fetchFromProvider(this._provider, {
+            method: 'eth_getCode',
+            params: [address.toString(), this._blockTag],
+        });
+        codeBytes = toBytes(code);
+        this._caches.code?.put(address, codeBytes);
+        return codeBytes;
+    }
+    async getCodeSize(address) {
+        const contractCode = await this.getCode(address);
+        return contractCode.length;
+    }
+    /**
+     * Adds `value` to the state trie as code, and sets `codeHash` on the account
+     * corresponding to `address` to reference this.
+     * @param address - Address of the `account` to add the `code` for
+     * @param value - The value of the `code`
+     */
+    async putCode(address, value) {
+        // Store contract code in the cache
+        this._caches.code?.put(address, value);
+    }
+    /**
+     * Gets the storage value associated with the provided `address` and `key`. This method returns
+     * the shortest representation of the stored value.
+     * @param address - Address of the account to get the storage for
+     * @param key - Key in the account's storage to get the value for. Must be 32 bytes long.
+     * @returns {Uint8Array} - The storage value for the account
+     * corresponding to the provided address at the provided key.
+     * If this does not exist an empty `Uint8Array` is returned.
+     */
+    async getStorage(address, key) {
+        // Check storage slot in cache
+        if (key.length !== 32) {
+            throw EthereumJSErrorWithoutCode('Storage key must be 32 bytes long');
+        }
+        let value = this._caches.storage?.get(address, key);
+        if (value !== undefined) {
+            return value;
+        }
+        // Retrieve storage slot from provider if not found in cache
+        const storage = await fetchFromProvider(this._provider, {
+            method: 'eth_getStorageAt',
+            params: [address.toString(), bytesToHex(key), this._blockTag],
+        });
+        value = toBytes(storage);
+        await this.putStorage(address, key, value);
+        return value;
+    }
+    /**
+     * Adds value to the cache for the `account`
+     * corresponding to `address` at the provided `key`.
+     * @param address - Address to set a storage value for
+     * @param key - Key to set the value at. Must be 32 bytes long.
+     * @param value - Value to set at `key` for account corresponding to `address`.
+     * Cannot be more than 32 bytes. Leading zeros are stripped.
+     * If it is empty or filled with zeros, deletes the value.
+     */
+    async putStorage(address, key, value) {
+        this._caches.storage?.put(address, key, value);
+    }
+    /**
+     * Clears all storage entries for the account corresponding to `address`.
+     * @param address - Address to clear the storage of
+     */
+    async clearStorage(address) {
+        this._caches.storage?.clearStorage(address);
+    }
+    /**
+     * Dumps the RLP-encoded storage values for an `account` specified by `address`.
+     * @param address - The address of the `account` to return storage for
+     * @returns {Promise<StorageDump>} - The state of the account as an `Object` map.
+     * Keys are the storage keys, values are the storage values as strings.
+     * Both are represented as `0x` prefixed hex strings.
+     */
+    dumpStorage(address) {
+        const storageMap = this._caches.storage?.dump(address);
+        const dump = {};
+        if (storageMap !== undefined) {
+            for (const slot of storageMap) {
+                dump[slot[0]] = bytesToHex(slot[1]);
+            }
+        }
+        return Promise.resolve(dump);
+    }
+    /**
+     * Gets the account associated with `address` or `undefined` if account does not exist
+     * @param address - Address of the `account` to get
+     */
+    async getAccount(address) {
+        const elem = this._caches.account?.get(address);
+        if (elem !== undefined) {
+            return elem.accountRLP !== undefined ? createAccountFromRLP(elem.accountRLP) : undefined;
+        }
+        const accountFromProvider = await this.getAccountFromProvider(address);
+        const account = equalsBytes(accountFromProvider.codeHash, new Uint8Array(32)) ||
+            equalsBytes(accountFromProvider.serialize(), KECCAK256_RLP_EMPTY_ACCOUNT)
+            ? undefined
+            : createAccountFromRLP(accountFromProvider.serialize());
+        this._caches.account?.put(address, account);
+        return account;
+    }
+    /**
+     * Retrieves an account from the provider and stores in the local trie
+     * @param address Address of account to be retrieved from provider
+     * @private
+     */
+    async getAccountFromProvider(address) {
+        if (this.DEBUG)
+            this._debug(`retrieving account data from ${address.toString()} from provider`);
+        const accountData = await fetchFromProvider(this._provider, {
+            method: 'eth_getProof',
+            params: [address.toString(), [], this._blockTag],
+        });
+        const account = createAccount({
+            balance: BigInt(accountData.balance),
+            nonce: BigInt(accountData.nonce),
+            codeHash: toBytes(accountData.codeHash),
+            storageRoot: toBytes(accountData.storageHash),
+        });
+        return account;
+    }
+    /**
+     * Saves an account into state under the provided `address`.
+     * @param address - Address under which to store `account`
+     * @param account - The account to store
+     */
+    async putAccount(address, account) {
+        if (this.DEBUG) {
+            this._debug(`Save account address=${address} nonce=${account?.nonce} balance=${account?.balance} contract=${account && account.isContract() ? 'yes' : 'no'} empty=${account && account.isEmpty() ? 'yes' : 'no'}`);
+        }
+        if (account !== undefined) {
+            this._caches.account.put(address, account);
+        }
+        else {
+            this._caches.account.del(address);
+        }
+    }
+    /**
+     * Gets the account associated with `address`, modifies the given account
+     * fields, then saves the account into state. Account fields can include
+     * `nonce`, `balance`, `storageRoot`, and `codeHash`.
+     * @param address - Address of the account to modify
+     * @param accountFields - Object containing account fields and values to modify
+     */
+    async modifyAccountFields(address, accountFields) {
+        if (this.DEBUG) {
+            this._debug(`modifying account fields for ${address.toString()}`);
+            this._debug(JSON.stringify(accountFields, (k, v) => {
+                if (k === 'nonce')
+                    return v.toString();
+                return v;
+            }, 2));
+        }
+        await modifyAccountFields(this, address, accountFields);
+    }
+    /**
+     * Deletes an account from state under the provided `address`.
+     * @param address - Address of the account which should be deleted
+     */
+    async deleteAccount(address) {
+        if (this.DEBUG) {
+            this._debug(`deleting account corresponding to ${address.toString()}`);
+        }
+        this._caches.account?.del(address);
+    }
+    /**
+     * Returns the applied key for a given address
+     * Used for saving preimages
+     * @param address - The address to return the applied key
+     * @returns {Uint8Array} - The applied key (e.g. hashed address)
+     */
+    getAppliedKey(address) {
+        return this.keccakFunction(address);
+    }
+    /**
+     * Checkpoints the current state of the StateManager instance.
+     * State changes that follow can then be committed by calling
+     * `commit` or `reverted` by calling rollback.
+     */
+    async checkpoint() {
+        this._caches.checkpoint();
+    }
+    /**
+     * Commits the current change-set to the instance since the
+     * last call to checkpoint.
+     *
+     * Partial implementation, called from the subclass.
+     */
+    async commit() {
+        // setup cache checkpointing
+        this._caches.account?.commit();
+    }
+    /**
+     * Reverts the current change-set to the instance since the
+     * last call to checkpoint.
+     *
+     * Partial implementation , called from the subclass.
+     */
+    async revert() {
+        this._caches.revert();
+    }
+    async flush() {
+        this._caches.account?.flush();
+    }
+}
+export class RPCBlockChain {
+    constructor(provider) {
+        if (provider === undefined || provider === '')
+            throw EthereumJSErrorWithoutCode('provider URL is required');
+        this.provider = provider;
+    }
+    async getBlock(blockId) {
+        const block = await fetchFromProvider(this.provider, {
+            method: 'eth_getBlockByNumber',
+            params: [intToHex(blockId), false],
+        });
+        return {
+            hash: () => hexToBytes(block.hash),
+        };
+    }
+    shallowCopy() {
+        return this;
+    }
+}
+//# sourceMappingURL=rpcStateManager.js.map

package/dist/esm/rpcStateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcStateManager.js","sourceRoot":"","sources":["../../src/rpcStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,EACL,OAAO,EACP,0BAA0B,EAC1B,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,OAAO,GACR,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,YAAY,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAO/C,MAAM,2BAA2B,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,OAAO,eAAe;IAU1B,YAAY,IAAyB;QA6SrC;;WAEG;QACH,iBAAY,GAAG,KAAK,IAAI,EAAE;YACxB,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;QAC3B,CAAC,CAAA;QAED;;WAEG;QACH,iBAAY,GAAG,KAAK,EAAE,KAAiB,EAAE,EAAE,GAAE,CAAC,CAAA;QAE9C;;WAEG;QACH,iBAAY,GAAG,GAAG,EAAE;YAClB,MAAM,0BAA0B,CAAC,0BAA0B,CAAC,CAAA;QAC9D,CAAC,CAAA;QA7TC,4EAA4E;QAC5E,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAEpC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAA;QAC9C,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAA;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,0BAA0B,CAAC,wCAAwC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC3F,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE1F,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;QAEhF,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAC3D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,IAAI,UAAU,CAAA;IACzE,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;YACnC,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;SACjC,CAAC,CAAA;QACF,QAAQ,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;QAE5D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAA6B;QACvC,IAAI,CAAC,SAAS,GAAG,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAC3E,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACvE,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;QACrD,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC7C,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;YACnD,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC;SAC7C,CAAC,CAAA;QACF,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAC1C,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgB;QAChC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAChD,OAAO,YAAY,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,KAAiB;QAC/C,mCAAmC;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,GAAe;QAChD,8BAA8B;QAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACtB,MAAM,0BAA0B,CAAC,mCAAmC,CAAC,CAAA;QACvE,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,4DAA4D;QAC5D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;YACtD,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;SAC9D,CAAC,CAAA;QACF,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QAExB,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QAC1C,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,GAAe,EAAE,KAAiB;QACnE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,OAAgB;QACjC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAAgB;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACtD,MAAM,IAAI,GAAgB,EAAE,CAAA;QAC5B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;QAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1F,CAAC;QAED,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAA;QACtE,MAAM,OAAO,GACX,WAAW,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;YAC7D,WAAW,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,2BAA2B,CAAC;YACvE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC,CAAA;QAE3D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE3C,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,sBAAsB,CAAC,OAAgB;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,gCAAgC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QAC/F,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;YAC1D,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAS,EAAE,IAAI,CAAC,SAAS,CAAC;SACxD,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;YACpC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAChC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;SAC9C,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,OAA4B;QAC7D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CACT,wBAAwB,OAAO,UAAU,OAAO,EAAE,KAAK,YACrD,OAAO,EAAE,OACX,aAAa,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UACzD,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IACzC,EAAE,CACH,CAAA;QACH,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,OAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,OAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAAgB,EAAE,aAA4B;QACtE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,gCAAgC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;YACjE,IAAI,CAAC,MAAM,CACT,IAAI,CAAC,SAAS,CACZ,aAAa,EACb,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,KAAK,OAAO;oBAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAA;gBACtC,OAAO,CAAC,CAAA;YACV,CAAC,EACD,CAAC,CACF,CACF,CAAA;QACH,CAAC;QACD,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,qCAAqC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,OAAmB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;IAC3B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,4BAA4B;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;IAChC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;IAC/B,CAAC;CAoBF;AAED,MAAM,OAAO,aAAa;IAExB,YAAY,QAAgB;QAC1B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;YAC3C,MAAM,0BAA0B,CAAC,0BAA0B,CAAC,CAAA;QAC9D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE;YACnD,MAAM,EAAE,sBAAsB;YAC9B,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;SACnC,CAAC,CAAA;QACF,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;SACnC,CAAA;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/esm/simpleStateManager.d.ts

@@ -0,0 +1,54 @@
+import { Account } from '@feelyourprotocol/util';
+import type { AccountFields, Common, StateManagerInterface } from '@feelyourprotocol/common';
+import type { Address, PrefixedHexString } from '@feelyourprotocol/util';
+import type { SimpleStateManagerOpts } from './index.ts';
+/**
+ * Simple and dependency-free state manager for basic state access use cases
+ * where a merkle-patricia or binary tree backed state manager is too heavy-weight.
+ *
+ * This state manager comes with the basic state access logic for
+ * accounts, storage and code (put* and get* methods) as well as a simple
+ * implementation of checkpointing but lacks methods implementations of
+ * state root related logic as well as some other non-core functions.
+ *
+ * Functionality provided is sufficient to be used for simple EVM use
+ * cases and the state manager is used as default there.
+ *
+ * For a more full fledged and MPT-backed state manager implementation
+ * have a look at the [`@feelyourprotocol/statemanager` package docs](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/docs/README.md).
+ */
+export declare class SimpleStateManager implements StateManagerInterface {
+    accountStack: Map<PrefixedHexString, Account | undefined>[];
+    codeStack: Map<PrefixedHexString, Uint8Array>[];
+    storageStack: Map<string, Uint8Array>[];
+    originalStorageCache: {
+        get(address: Address, key: Uint8Array): Promise<Uint8Array>;
+        clear(): void;
+    };
+    readonly common?: Common;
+    constructor(opts?: SimpleStateManagerOpts);
+    protected topAccountStack(): Map<`0x${string}`, Account | undefined>;
+    protected topCodeStack(): Map<`0x${string}`, Uint8Array<ArrayBufferLike>>;
+    protected topStorageStack(): Map<string, Uint8Array<ArrayBufferLike>>;
+    protected checkpointSync(): void;
+    getAccount(address: Address): Promise<Account | undefined>;
+    putAccount(address: Address, account?: Account | undefined): Promise<void>;
+    deleteAccount(address: Address): Promise<void>;
+    modifyAccountFields(address: Address, accountFields: AccountFields): Promise<void>;
+    getCode(address: Address): Promise<Uint8Array>;
+    putCode(address: Address, value: Uint8Array): Promise<void>;
+    getCodeSize(address: Address): Promise<number>;
+    getStorage(address: Address, key: Uint8Array): Promise<Uint8Array>;
+    putStorage(address: Address, key: Uint8Array, value: Uint8Array): Promise<void>;
+    clearStorage(): Promise<void>;
+    checkpoint(): Promise<void>;
+    commit(): Promise<void>;
+    revert(): Promise<void>;
+    flush(): Promise<void>;
+    clearCaches(): void;
+    shallowCopy(): StateManagerInterface;
+    getStateRoot(): Promise<Uint8Array>;
+    setStateRoot(): Promise<void>;
+    hasStateRoot(): Promise<boolean>;
+}
+//# sourceMappingURL=simpleStateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simpleStateManager.d.ts","sourceRoot":"","sources":["../../src/simpleStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,kBAAkB,CAAA;AAMlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IACvD,YAAY,EAAE,GAAG,CAAC,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAC,EAAE,CAAK;IAChE,SAAS,EAAE,GAAG,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,CAAK;IACpD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAK;IAEnD,oBAAoB,EAAE;QACpB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;QAC3D,KAAK,IAAI,IAAI,CAAA;KACd,CAAA;IAED,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,GAAE,sBAA2B;IAM7C,SAAS,CAAC,eAAe;IAGzB,SAAS,CAAC,YAAY;IAGtB,SAAS,CAAC,eAAe;IAKzB,SAAS,CAAC,cAAc;IAclB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAI1D,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9C,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAMlE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAMvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAMvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC5B,WAAW,IAAI,IAAI;IAEnB,WAAW,IAAI,qBAAqB;IAWpC,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAGnC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAG7B,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;CAGjC"}

package/dist/esm/simpleStateManager.js

@@ -0,0 +1,121 @@
+import { Account, EthereumJSErrorWithoutCode, bytesToHex } from '@feelyourprotocol/util';
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import { OriginalStorageCache } from "./cache/originalStorageCache.js";
+import { modifyAccountFields } from "./util.js";
+/**
+ * Simple and dependency-free state manager for basic state access use cases
+ * where a merkle-patricia or binary tree backed state manager is too heavy-weight.
+ *
+ * This state manager comes with the basic state access logic for
+ * accounts, storage and code (put* and get* methods) as well as a simple
+ * implementation of checkpointing but lacks methods implementations of
+ * state root related logic as well as some other non-core functions.
+ *
+ * Functionality provided is sufficient to be used for simple EVM use
+ * cases and the state manager is used as default there.
+ *
+ * For a more full fledged and MPT-backed state manager implementation
+ * have a look at the [`@feelyourprotocol/statemanager` package docs](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/docs/README.md).
+ */
+export class SimpleStateManager {
+    constructor(opts = {}) {
+        this.accountStack = [];
+        this.codeStack = [];
+        this.storageStack = [];
+        this.checkpointSync();
+        this.originalStorageCache = new OriginalStorageCache(this.getStorage.bind(this));
+        this.common = opts.common;
+    }
+    topAccountStack() {
+        return this.accountStack[this.accountStack.length - 1];
+    }
+    topCodeStack() {
+        return this.codeStack[this.codeStack.length - 1];
+    }
+    topStorageStack() {
+        return this.storageStack[this.storageStack.length - 1];
+    }
+    // Synchronous version of checkpoint() to allow to call from constructor
+    checkpointSync() {
+        const newTopA = new Map(this.topAccountStack());
+        for (const [address, account] of newTopA) {
+            const accountCopy = account !== undefined
+                ? Object.assign(Object.create(Object.getPrototypeOf(account)), account)
+                : undefined;
+            newTopA.set(address, accountCopy);
+        }
+        this.accountStack.push(newTopA);
+        this.codeStack.push(new Map(this.topCodeStack()));
+        this.storageStack.push(new Map(this.topStorageStack()));
+    }
+    async getAccount(address) {
+        return this.topAccountStack().get(address.toString());
+    }
+    async putAccount(address, account) {
+        this.topAccountStack().set(address.toString(), account);
+    }
+    async deleteAccount(address) {
+        this.topAccountStack().set(address.toString(), undefined);
+    }
+    async modifyAccountFields(address, accountFields) {
+        await modifyAccountFields(this, address, accountFields);
+    }
+    async getCode(address) {
+        return this.topCodeStack().get(address.toString()) ?? new Uint8Array(0);
+    }
+    async putCode(address, value) {
+        this.topCodeStack().set(address.toString(), value);
+        if ((await this.getAccount(address)) === undefined) {
+            await this.putAccount(address, new Account());
+        }
+        await this.modifyAccountFields(address, {
+            codeHash: (this.common?.customCrypto.keccak256 ?? keccak_256)(value),
+        });
+    }
+    async getCodeSize(address) {
+        const contractCode = await this.getCode(address);
+        return contractCode.length;
+    }
+    async getStorage(address, key) {
+        return (this.topStorageStack().get(`${address.toString()}_${bytesToHex(key)}`) ?? new Uint8Array(0));
+    }
+    async putStorage(address, key, value) {
+        this.topStorageStack().set(`${address.toString()}_${bytesToHex(key)}`, value);
+    }
+    async clearStorage() { }
+    async checkpoint() {
+        this.checkpointSync();
+    }
+    async commit() {
+        this.accountStack.splice(-2, 1);
+        this.codeStack.splice(-2, 1);
+        this.storageStack.splice(-2, 1);
+    }
+    async revert() {
+        this.accountStack.pop();
+        this.codeStack.pop();
+        this.storageStack.pop();
+    }
+    async flush() { }
+    clearCaches() { }
+    shallowCopy() {
+        const copy = new SimpleStateManager({ common: this.common });
+        for (let i = 0; i < this.accountStack.length; i++) {
+            copy.accountStack.push(new Map(this.accountStack[i]));
+            copy.codeStack.push(new Map(this.codeStack[i]));
+            copy.storageStack.push(new Map(this.storageStack[i]));
+        }
+        return copy;
+    }
+    // State root functionality not implemented
+    getStateRoot() {
+        throw EthereumJSErrorWithoutCode('Method not implemented.');
+    }
+    setStateRoot() {
+        throw EthereumJSErrorWithoutCode('Method not implemented.');
+    }
+    hasStateRoot() {
+        throw EthereumJSErrorWithoutCode('Method not implemented.');
+    }
+}
+//# sourceMappingURL=simpleStateManager.js.map

package/dist/esm/simpleStateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleStateManager.js","sourceRoot":"","sources":["../../src/simpleStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAM/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IAY7B,YAAY,OAA+B,EAAE;QAXtC,iBAAY,GAAkD,EAAE,CAAA;QAChE,cAAS,GAAyC,EAAE,CAAA;QACpD,iBAAY,GAA8B,EAAE,CAAA;QAUjD,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC3B,CAAC;IAES,eAAe;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACxD,CAAC;IACS,YAAY;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClD,CAAC;IACS,eAAe;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACxD,CAAC;IAED,wEAAwE;IAC9D,cAAc;QACtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAA;QAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;YACzC,MAAM,WAAW,GACf,OAAO,KAAK,SAAS;gBACnB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC;gBACvE,CAAC,CAAC,SAAS,CAAA;YACf,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAgB;QAC/B,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,OAA6B;QAC9D,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAgB,EAAE,aAA4B;QACtE,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,KAAiB;QAC/C,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACnD,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC,CAAA;QAC/C,CAAC;QACD,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE;YACtC,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,IAAI,UAAU,CAAC,CAAC,KAAK,CAAC;SACrE,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgB;QAChC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAChD,OAAO,YAAY,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,GAAe;QAChD,OAAO,CACL,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAC5F,CAAA;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,GAAe,EAAE,KAAiB;QACnE,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAC/E,CAAC;IAED,KAAK,CAAC,YAAY,KAAmB,CAAC;IAEtC,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,cAAc,EAAE,CAAA;IACvB,CAAC;IACD,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAA;QACvB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QACpB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;IAC/B,WAAW,KAAU,CAAC;IAEtB,WAAW;QACT,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2CAA2C;IAC3C,YAAY;QACV,MAAM,0BAA0B,CAAC,yBAAyB,CAAC,CAAA;IAC7D,CAAC;IACD,YAAY;QACV,MAAM,0BAA0B,CAAC,yBAAyB,CAAC,CAAA;IAC7D,CAAC;IACD,YAAY;QACV,MAAM,0BAA0B,CAAC,yBAAyB,CAAC,CAAA;IAC7D,CAAC;CACF"}

package/dist/esm/statefulBinaryTreeStateManager.d.ts

@@ -0,0 +1,69 @@
+import { BinaryTree } from '@feelyourprotocol/binarytree';
+import type { Address, BinaryTreeExecutionWitness, PrefixedHexString } from '@feelyourprotocol/util';
+import { Account } from '@feelyourprotocol/util';
+import { OriginalStorageCache } from './cache/originalStorageCache.ts';
+import type { AccountFields, BinaryTreeAccessWitnessInterface, BinaryTreeAccessedStateWithAddress, GenesisState, StateManagerInterface, StorageDump, StorageRange } from '@feelyourprotocol/common';
+import type { Debugger } from 'debug';
+import type { Caches } from './cache/caches.ts';
+import type { StatefulBinaryTreeStateManagerOpts } from './types.ts';
+export declare class StatefulBinaryTreeStateManager implements StateManagerInterface {
+    protected _debug: Debugger;
+    protected _caches?: Caches;
+    preStateRoot: Uint8Array;
+    originalStorageCache: OriginalStorageCache;
+    hashFunction: (input: Uint8Array) => Uint8Array;
+    protected _tree: BinaryTree;
+    protected _checkpointCount: number;
+    private _postState;
+    /**
+     * StateManager 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;
+    private keccakFunction;
+    constructor(opts: StatefulBinaryTreeStateManagerOpts);
+    /**
+     * Gets the account associated with `address` or `undefined` if account does not exist
+     * @param address - Address of the `account` to get
+     */
+    getAccount: (address: Address) => Promise<Account | undefined>;
+    initBinaryTreeExecutionWitness(_blockNum: bigint, executionWitness?: BinaryTreeExecutionWitness | null): void;
+    /**
+     * Saves an account into state under the provided `address`.
+     * @param address - Address under which to store `account`
+     * @param account - The account to store or undefined if to be deleted
+     */
+    putAccount: (address: Address, account?: Account) => Promise<void>;
+    /**
+     * Deletes an account from state under the provided `address`.
+     * @param address - Address of the account which should be deleted
+     */
+    deleteAccount: (address: Address) => Promise<void>;
+    modifyAccountFields: (address: Address, accountFields: AccountFields) => Promise<void>;
+    putCode: (address: Address, value: Uint8Array) => Promise<void>;
+    getCode: (address: Address) => Promise<Uint8Array>;
+    getCodeSize: (address: Address) => Promise<number>;
+    getStorage: (address: Address, key: Uint8Array) => Promise<Uint8Array>;
+    putStorage: (address: Address, key: Uint8Array, value: Uint8Array) => Promise<void>;
+    clearStorage: (address: Address) => Promise<void>;
+    checkpoint: () => Promise<void>;
+    commit: () => Promise<void>;
+    revert: () => Promise<void>;
+    flush: () => Promise<void>;
+    getComputedValue(accessedState: BinaryTreeAccessedStateWithAddress): Promise<PrefixedHexString | null>;
+    verifyBinaryTreePostState(accessWitness: BinaryTreeAccessWitnessInterface): Promise<boolean>;
+    getStateRoot(): Promise<Uint8Array>;
+    setStateRoot(stateRoot: Uint8Array, clearCache?: boolean): Promise<void>;
+    hasStateRoot(root: Uint8Array): Promise<boolean>;
+    dumpStorage?(_address: Address): Promise<StorageDump>;
+    dumpStorageRange?(_address: Address, _startKey: bigint, _limit: number): Promise<StorageRange>;
+    clearCaches(): void;
+    shallowCopy(_downlevelCaches?: boolean): StateManagerInterface;
+    checkChunkWitnessPresent(_address: Address, _codeOffset: number): Promise<boolean>;
+    generateCanonicalGenesis(genesisState: GenesisState): Promise<void>;
+}
+//# sourceMappingURL=statefulBinaryTreeStateManager.d.ts.map

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

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