[**tevm**](../../README.md) *** [tevm](../../modules.md) / [state](../README.md) / StateManager # Interface: StateManager ## Extends - `Omit`\<[`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md), `"getAccount"` \| `"putAccount"` \| `"modifyAccountFields"` \| `"shallowCopy"` \| `"initBinaryTreeExecutionWitness"`\> ## Properties | Property | Type | Description | Inherited from | | ------ | ------ | ------ | ------ | | `_baseState` | [`BaseState`](../type-aliases/BaseState.md) | The internal state representation | - | | `checkChunkWitnessPresent?` | (`contract`, `programCounter`) => `Promise`\<`boolean`\> | - | [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`checkChunkWitnessPresent`](../../common/interfaces/EvmStateManagerInterface.md#checkchunkwitnesspresent) | | `getAccountAddresses` | () => `Set`\<`` `0x${string}` ``\> | Returns contract addresses | - | | `getAppliedKey?` | (`address`) => `Uint8Array` | - | [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`getAppliedKey`](../../common/interfaces/EvmStateManagerInterface.md#getappliedkey) | | `originalStorageCache` | `object` | - | [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`originalStorageCache`](../../common/interfaces/EvmStateManagerInterface.md#originalstoragecache) | | `originalStorageCache.clear` | `void` | - | - | | `originalStorageCache.get` | `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> | - | - | | `ready` | () => `Promise`\<`true`\> | - | - | | `verifyBinaryTreePostState?` | (`accessWitness`) => `Promise`\<`boolean`\> | - | [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`verifyBinaryTreePostState`](../../common/interfaces/EvmStateManagerInterface.md#verifybinarytreepoststate) | ## Methods ### checkpoint() > **checkpoint**(): `Promise`\<`void`\> #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`checkpoint`](../../common/interfaces/EvmStateManagerInterface.md#checkpoint) *** ### clearCaches() > **clearCaches**(): `void` Resets all internal caches #### Returns `void` #### Overrides [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`clearCaches`](../../common/interfaces/EvmStateManagerInterface.md#clearcaches) *** ### clearContractStorage() > **clearContractStorage**(`address`): `Promise`\<`void`\> Clears all storage entries for the account #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | #### Returns `Promise`\<`void`\> *** ### clearStorage() > **clearStorage**(`address`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`clearStorage`](../../common/interfaces/EvmStateManagerInterface.md#clearstorage) *** ### commit() > **commit**(`createNewStateRoot?`): `Promise`\<`void`\> Commits the current state. #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `createNewStateRoot?` | `boolean` | **`Experimental`** Whether to create a new state root Defaults to true. This api is not stable | #### Returns `Promise`\<`void`\> #### Overrides [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`commit`](../../common/interfaces/EvmStateManagerInterface.md#commit) *** ### deepCopy() > **deepCopy**(): `Promise`\<`StateManager`\> Returns a new instance of the ForkStateManager with the same opts and all storage copied over #### Returns `Promise`\<`StateManager`\> *** ### deleteAccount() > **deleteAccount**(`address`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`deleteAccount`](../../common/interfaces/EvmStateManagerInterface.md#deleteaccount) *** ### dumpCanonicalGenesis() > **dumpCanonicalGenesis**(): `Promise`\<[`TevmState`](../../index/type-aliases/TevmState.md)\> Dumps the state of the state manager as a [TevmState](../../index/type-aliases/TevmState.md) #### Returns `Promise`\<[`TevmState`](../../index/type-aliases/TevmState.md)\> *** ### dumpStorage() > **dumpStorage**(`address`): `Promise`\<[`StorageDump`](../../common/interfaces/StorageDump.md)\> Dumps storage based on the input #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | #### Returns `Promise`\<[`StorageDump`](../../common/interfaces/StorageDump.md)\> #### Overrides [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`dumpStorage`](../../common/interfaces/EvmStateManagerInterface.md#dumpstorage) *** ### dumpStorageRange() > **dumpStorageRange**(`address`, `startKey`, `limit`): `Promise`\<[`StorageRange`](../../common/interfaces/StorageRange.md)\> Dumps a range of storage values #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | | `startKey` | `bigint` | | `limit` | `number` | #### Returns `Promise`\<[`StorageRange`](../../common/interfaces/StorageRange.md)\> #### Overrides [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`dumpStorageRange`](../../common/interfaces/EvmStateManagerInterface.md#dumpstoragerange) *** ### generateCanonicalGenesis() > **generateCanonicalGenesis**(`state`): `Promise`\<`void`\> Loads a state from a given state root #### Parameters | Parameter | Type | | ------ | ------ | | `state` | [`TevmState`](../../index/type-aliases/TevmState.md) | #### Returns `Promise`\<`void`\> #### Overrides [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`generateCanonicalGenesis`](../../common/interfaces/EvmStateManagerInterface.md#generatecanonicalgenesis) *** ### getAccount() > **getAccount**(`address`): `Promise`\<[`EthjsAccount`](../../utils/classes/EthjsAccount.md) \| `undefined`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | #### Returns `Promise`\<[`EthjsAccount`](../../utils/classes/EthjsAccount.md) \| `undefined`\> *** ### getCode() > **getCode**(`address`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | #### Returns `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`getCode`](../../common/interfaces/EvmStateManagerInterface.md#getcode) *** ### getCodeSize() > **getCodeSize**(`address`): `Promise`\<`number`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | #### Returns `Promise`\<`number`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`getCodeSize`](../../common/interfaces/EvmStateManagerInterface.md#getcodesize) *** ### getProof() > **getProof**(`address`, `storageSlots?`): `Promise`\<`Proof`\> Get an EIP-1186 proof from the provider #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | The address to get proof for | | `storageSlots?` | `Uint8Array`\<`ArrayBufferLike`\>[] | Storage slots to include in the proof | #### Returns `Promise`\<`Proof`\> The account and storage proof *** ### getStateRoot() > **getStateRoot**(): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Returns `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`getStateRoot`](../../common/interfaces/EvmStateManagerInterface.md#getstateroot) *** ### getStorage() > **getStorage**(`address`, `key`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | | `key` | `Uint8Array` | #### Returns `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`getStorage`](../../common/interfaces/EvmStateManagerInterface.md#getstorage) *** ### hasStateRoot() > **hasStateRoot**(`root`): `Promise`\<`boolean`\> #### Parameters | Parameter | Type | | ------ | ------ | | `root` | `Uint8Array` | #### Returns `Promise`\<`boolean`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`hasStateRoot`](../../common/interfaces/EvmStateManagerInterface.md#hasstateroot) *** ### modifyAccountFields() > **modifyAccountFields**(`address`, `accountFields`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | | `accountFields` | [`AccountFields`](../../common/type-aliases/AccountFields.md) | #### Returns `Promise`\<`void`\> *** ### putAccount() > **putAccount**(`address`, `account?`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | [`EthjsAddress`](../../utils/classes/EthjsAddress.md) | | `account?` | [`EthjsAccount`](../../utils/classes/EthjsAccount.md) | #### Returns `Promise`\<`void`\> *** ### putCode() > **putCode**(`address`, `value`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | | `value` | `Uint8Array` | #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`putCode`](../../common/interfaces/EvmStateManagerInterface.md#putcode) *** ### putStorage() > **putStorage**(`address`, `key`, `value`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `address` | `Address` | | `key` | `Uint8Array` | | `value` | `Uint8Array` | #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`putStorage`](../../common/interfaces/EvmStateManagerInterface.md#putstorage) *** ### revert() > **revert**(): `Promise`\<`void`\> #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`revert`](../../common/interfaces/EvmStateManagerInterface.md#revert) *** ### saveStateRoot() > **saveStateRoot**(`root`, `state`): `void` **`Experimental`** Saves a state root to the state root mapping THis API is considered unstable #### Parameters | Parameter | Type | | ------ | ------ | | `root` | `Uint8Array` | | `state` | [`TevmState`](../../index/type-aliases/TevmState.md) | #### Returns `void` *** ### setStateRoot() > **setStateRoot**(`stateRoot`, `clearCache?`): `Promise`\<`void`\> #### Parameters | Parameter | Type | | ------ | ------ | | `stateRoot` | `Uint8Array` | | `clearCache?` | `boolean` | #### Returns `Promise`\<`void`\> #### Inherited from [`EvmStateManagerInterface`](../../common/interfaces/EvmStateManagerInterface.md).[`setStateRoot`](../../common/interfaces/EvmStateManagerInterface.md#setstateroot) *** ### shallowCopy() > **shallowCopy**(): `StateManager` #### Returns `StateManager`