ethereumjs-monorepo

@ethereumjs/common

---

@ethereumjs/common / StateManagerInterface

Interface: StateManagerInterface

Defined in: interfaces.ts:177

Core state access surface implemented by EthereumJS state managers.

Matches the @ethereumjs/statemanager package API.

Properties

originalStorageCache

originalStorageCache: object

Defined in: interfaces.ts:231

clear()

clear(): void

Returns

void

get()

get(address, key): Promise<Uint8Array<ArrayBufferLike>>

Parameters

address

Address

key

Uint8Array

Returns

Promise<Uint8Array<ArrayBufferLike>>

Methods

checkChunkWitnessPresent()?

optional checkChunkWitnessPresent(contract, programCounter): Promise<boolean>

Defined in: interfaces.ts:241

Parameters

contract

Address

programCounter

number

Returns

Promise<boolean>

---

checkpoint()

checkpoint(): Promise<void>

Defined in: interfaces.ts:200

Returns

Promise<void>

---

clearCaches()

clearCaches(): void

Defined in: interfaces.ts:247

Returns

void

---

clearStorage()

clearStorage(address): Promise<void>

Defined in: interfaces.ts:195

Parameters

address

Address

Returns

Promise<void>

---

commit()

commit(): Promise<void>

Defined in: interfaces.ts:201

Returns

Promise<void>

---

consumeBAL()?

optional consumeBAL(bal, expectedStateRoot?): Promise<void>

Defined in: interfaces.ts:226

Apply an EIP-7928 block-level access list onto this state (no EVM execution). Implementations in @ethereumjs/statemanager forward to the shared consumeBAL() helper.

Parameters

bal

BALJSONBlockAccessList

expectedStateRoot?

Uint8Array<ArrayBufferLike>

Returns

Promise<void>

Remarks

Experimental (Amsterdam): may change on patch releases.

---

deleteAccount()

deleteAccount(address): Promise<void>

Defined in: interfaces.ts:184

Parameters

address

Address

Returns

Promise<void>

---

dumpStorage()?

optional dumpStorage(address): Promise<StorageDump>

Defined in: interfaces.ts:218

Parameters

address

Address

Returns

Promise<StorageDump>

---

dumpStorageRange()?

optional dumpStorageRange(address, startKey, limit): Promise<StorageRange>

Defined in: interfaces.ts:219

Parameters

address

Address

startKey

bigint

limit

number

Returns

Promise<StorageRange>

---

generateCanonicalGenesis()?

optional generateCanonicalGenesis(initState): Promise<void>

Defined in: interfaces.ts:235

Parameters

initState

any

Returns

Promise<void>

---

getAccount()

getAccount(address): Promise<Account | undefined>

Defined in: interfaces.ts:182

Parameters

address

Address

Returns

Promise<Account | undefined>

---

getAppliedKey()?

optional getAppliedKey(address): Uint8Array

Defined in: interfaces.ts:242

Parameters

address

Uint8Array

Returns

Uint8Array

---

getCode()

getCode(address): Promise<Uint8Array<ArrayBufferLike>>

Defined in: interfaces.ts:189

Parameters

address

Address

Returns

Promise<Uint8Array<ArrayBufferLike>>

---

getCodeSize()

getCodeSize(address): Promise<number>

Defined in: interfaces.ts:190

Parameters

address

Address

Returns

Promise<number>

---

getStateRoot()

getStateRoot(): Promise<Uint8Array<ArrayBufferLike>>

Defined in: interfaces.ts:207

Returns

Promise<Uint8Array<ArrayBufferLike>>

---

getStorage()

getStorage(address, key): Promise<Uint8Array<ArrayBufferLike>>

Defined in: interfaces.ts:193

Parameters

address

Address

key

Uint8Array

Returns

Promise<Uint8Array<ArrayBufferLike>>

---

hasStateRoot()

hasStateRoot(root): Promise<boolean>

Defined in: interfaces.ts:209

Parameters

root

Uint8Array

Returns

Promise<boolean>

---

initBinaryTreeExecutionWitness()?

optional initBinaryTreeExecutionWitness(blockNum, executionWitness?): void

Defined in: interfaces.ts:236

Parameters

blockNum

bigint

executionWitness?

BinaryTreeExecutionWitness | null

Returns

void

---

modifyAccountFields()

modifyAccountFields(address, accountFields): Promise<void>

Defined in: interfaces.ts:185

Parameters

address

Address

accountFields

AccountFields

Returns

Promise<void>

---

putAccount()

putAccount(address, account?): Promise<void>

Defined in: interfaces.ts:183

Parameters

address

Address

account?

Account

Returns

Promise<void>

---

putCode()

putCode(address, value): Promise<void>

Defined in: interfaces.ts:188

Parameters

address

Address

value

Uint8Array

Returns

Promise<void>

---

putStorage()

putStorage(address, key, value): Promise<void>

Defined in: interfaces.ts:194

Parameters

address

Address

key

Uint8Array

value

Uint8Array

Returns

Promise<void>

---

revert()

revert(): Promise<void>

Defined in: interfaces.ts:202

Returns

Promise<void>

---

setStateRoot()

setStateRoot(stateRoot, clearCache?): Promise<void>

Defined in: interfaces.ts:208

Parameters

stateRoot

Uint8Array

clearCache?

boolean

Returns

Promise<void>

---

shallowCopy()

shallowCopy(downlevelCaches?): StateManagerInterface

Defined in: interfaces.ts:248

Parameters

downlevelCaches?

boolean

Returns

StateManagerInterface

---

verifyBinaryTreePostState()?

optional verifyBinaryTreePostState(accessWitness): Promise<boolean>

Defined in: interfaces.ts:240

Parameters

accessWitness

BinaryTreeAccessWitnessInterface

Returns

Promise<boolean>