primitives/MemoryDump

Auto-generated API documentation

@tevm/voltaire

---

@tevm/voltaire / primitives/MemoryDump

primitives/MemoryDump

Type Aliases

MemoryDumpType

MemoryDumpType = object

Defined in: src/primitives/MemoryDump/MemoryDumpType.ts:15

Memory state snapshot from EVM execution

Represents the complete memory state at a point in EVM execution. EVM memory is byte-addressable and grows dynamically, organized in 32-byte words.

Example

const dump: MemoryDumpType = {
  data: new Uint8Array([...]), // Full memory contents
  length: 128, // Memory size in bytes
};

Properties

data

readonly data: Uint8Array

Defined in: src/primitives/MemoryDump/MemoryDumpType.ts:19

Raw memory bytes - complete memory contents

length

readonly length: number

Defined in: src/primitives/MemoryDump/MemoryDumpType.ts:24

Total memory size in bytes

Variables

MemoryDump

const MemoryDump: object

Defined in: src/primitives/MemoryDump/index.ts:30

Type Declaration

from()

from: (value) => MemoryDumpType = _from

Create MemoryDump from raw bytes or object

Parameters

value

Memory data or object

Uint8Array<ArrayBufferLike> | { data: Uint8Array; length?: number; }

Returns

MemoryDumpType

MemoryDump

Example

const dump1 = MemoryDump.from(new Uint8Array(64));
const dump2 = MemoryDump.from({ data: new Uint8Array(64), length: 64 });

readWord()

readWord: (dump, offset) => Uint8Array

Parameters

dump

Uint8Array<ArrayBufferLike> | MemoryDumpType

offset

number

Returns

Uint8Array

slice()

slice: (dump, start, end?) => Uint8Array

Parameters

dump

Uint8Array<ArrayBufferLike> | MemoryDumpType

start

number

end?

number

Returns

Uint8Array

Functions

_readWord()

_readWord(dump, offset): Uint8Array<ArrayBufferLike>

Defined in: src/primitives/MemoryDump/readWord.js:15

Read a 32-byte word from memory at the given offset

Parameters

dump

MemoryDumpType

Memory dump

offset

number

Byte offset to read from

Returns

Uint8Array<ArrayBufferLike>

32-byte word

Throws

If offset is out of bounds or insufficient data

Example

const word = MemoryDump.readWord(dump, 0); // First 32 bytes
const word2 = MemoryDump.readWord(dump, 32); // Second 32 bytes

---

_slice()

_slice(dump, start, end?): Uint8Array<ArrayBufferLike>

Defined in: src/primitives/MemoryDump/slice.js:16

Extract a slice of memory

Parameters

dump

MemoryDumpType

Memory dump

start

number

Start offset (inclusive)

end?

number

End offset (exclusive, defaults to length)

Returns

Uint8Array<ArrayBufferLike>

Memory slice

Throws

If offsets are invalid

Example

const slice = MemoryDump.slice(dump, 0, 64); // First 64 bytes
const tail = MemoryDump.slice(dump, 64); // From byte 64 to end

---

from()

from(value): MemoryDumpType

Defined in: src/primitives/MemoryDump/from.js:13

Create MemoryDump from raw bytes or object

Parameters

value

Memory data or object

Uint8Array<ArrayBufferLike> | { data: Uint8Array; length?: number; }

Returns

MemoryDumpType

MemoryDump

Example

const dump1 = MemoryDump.from(new Uint8Array(64));
const dump2 = MemoryDump.from({ data: new Uint8Array(64), length: 64 });

---

readWord()

readWord(dump, offset): Uint8Array

Defined in: src/primitives/MemoryDump/index.ts:11

Parameters

dump

Uint8Array<ArrayBufferLike> | MemoryDumpType

offset

number

Returns

Uint8Array

---

slice()

slice(dump, start, end?): Uint8Array

Defined in: src/primitives/MemoryDump/index.ts:18

Parameters

dump

Uint8Array<ArrayBufferLike> | MemoryDumpType

start

number

end?

number

Returns

Uint8Array