Skip to main content
@tevm/voltaire
@tevm/voltaire / primitives/AccessList

​
primitives/AccessList

​
Type Aliases

​
BrandedAccessList

BrandedAccessList = readonly Item[] & object
Defined in: src/primitives/AccessList/AccessListType.ts:27 Branded AccessList type Array of access list items (EIP-2930)

​
Type Declaration

__brand?
readonly optional __brand: typeof accessListSymbol

​
Item

Item<TAddress, TStorageKeys> = object
Defined in: src/primitives/AccessList/AccessListType.ts:13 Single access list entry Contains address and its accessed storage keys

​
Type Parameters

TAddress
TAddress extends AddressType = AddressType
TStorageKeys
TStorageKeys extends readonly HashType[] = readonly HashType[]

​
Properties

address
address: TAddress
Defined in: src/primitives/AccessList/AccessListType.ts:18 Contract address
storageKeys
storageKeys: TStorageKeys
Defined in: src/primitives/AccessList/AccessListType.ts:20 Storage keys accessed at this address

​
Variables

​
AccessList

const AccessList: object
Defined in: src/primitives/AccessList/index.ts:115 Namespace for AccessList operations

​
Type Declaration

ADDRESS_COST
ADDRESS_COST: bigint
Gas cost per address in access list (EIP-2930)
addressCount()
addressCount: (list) => number
Parameters
list
BrandedAccessList
Returns
number
assertValid()
assertValid: (list) => void
Parameters
list
BrandedAccessList
Returns
void
COLD_ACCOUNT_ACCESS_COST
COLD_ACCOUNT_ACCESS_COST: bigint
Cold account access cost (pre-EIP-2930)
COLD_STORAGE_ACCESS_COST
COLD_STORAGE_ACCESS_COST: bigint
Cold storage access cost (pre-EIP-2930)
create()
create: () => BrandedAccessList
Returns
BrandedAccessList
deduplicate()
deduplicate: (list) => BrandedAccessList
Parameters
list
BrandedAccessList
Returns
BrandedAccessList
from()
from: (value) => BrandedAccessList
Parameters
value
Uint8Array<ArrayBufferLike> | readonly Item[]
Returns
BrandedAccessList
fromBytes()
fromBytes: (bytes) => BrandedAccessList
Parameters
bytes
Uint8Array
Returns
BrandedAccessList
gasCost()
gasCost: (list) => bigint
Parameters
list
BrandedAccessList
Returns
bigint
gasSavings()
gasSavings: (list) => bigint
Parameters
list
BrandedAccessList
Returns
bigint
hasSavings()
hasSavings: (list) => boolean
Parameters
list
BrandedAccessList
Returns
boolean
includesAddress()
includesAddress: (list, address) => boolean
Parameters
list
BrandedAccessList
address
AddressType
Returns
boolean
includesStorageKey()
includesStorageKey: (list, address, storageKey) => boolean
Parameters
list
BrandedAccessList
address
AddressType
storageKey
HashType
Returns
boolean
is()
is: (value) => value is BrandedAccessList
Parameters
value
unknown
Returns
value is BrandedAccessList
isEmpty()
isEmpty: (list) => boolean
Parameters
list
BrandedAccessList
Returns
boolean
isItem()
isItem: (value) => value is Item
Parameters
value
unknown
Returns
value is Item
keysFor()
keysFor: (list, address) => readonly HashType[] | undefined
Parameters
list
BrandedAccessList
address
AddressType
Returns
readonly HashType[] | undefined
merge()
merge: (…accessLists) => BrandedAccessList
Parameters
accessLists
…BrandedAccessList[]
Returns
BrandedAccessList
STORAGE_KEY_COST
STORAGE_KEY_COST: bigint
Gas cost per storage key in access list (EIP-2930)
storageKeyCount()
storageKeyCount: (list) => number
Parameters
list
BrandedAccessList
Returns
number
toBytes()
toBytes: (list) => Uint8Array
Parameters
list
BrandedAccessList
Returns
Uint8Array
WARM_STORAGE_ACCESS_COST
WARM_STORAGE_ACCESS_COST: bigint
Warm storage access cost (post-EIP-2929)
withAddress()
withAddress: (list, address) => BrandedAccessList
Parameters
list
BrandedAccessList
address
AddressType
Returns
BrandedAccessList
withStorageKey()
withStorageKey: (list, address, storageKey) => BrandedAccessList
Parameters
list
BrandedAccessList
address
AddressType
storageKey
HashType
Returns
BrandedAccessList

​
ADDRESS_COST

const ADDRESS_COST: 2400n = 2400n
Defined in: src/primitives/AccessList/constants.js:6 Gas cost per address in access list (EIP-2930)

​
addressCount()

const addressCount: (list) => number = _addressCount
Defined in: src/primitives/AccessList/index.ts:84

​
Parameters

list
BrandedAccessList

​
Returns

number

​
assertValid()

const assertValid: (list) => void = _assertValid
Defined in: src/primitives/AccessList/index.ts:82

​
Parameters

list
BrandedAccessList

​
Returns

void

​
COLD_ACCOUNT_ACCESS_COST

const COLD_ACCOUNT_ACCESS_COST: 2600n = 2600n
Defined in: src/primitives/AccessList/constants.js:12 Cold account access cost (pre-EIP-2930)

​
COLD_STORAGE_ACCESS_COST

const COLD_STORAGE_ACCESS_COST: 2100n = 2100n
Defined in: src/primitives/AccessList/constants.js:15 Cold storage access cost (pre-EIP-2930)

​
create()

const create: () => BrandedAccessList = _create
Defined in: src/primitives/AccessList/index.ts:52

​
Returns

BrandedAccessList

​
deduplicate()

const deduplicate: (list) => BrandedAccessList = _deduplicate
Defined in: src/primitives/AccessList/index.ts:71

​
Parameters

list
BrandedAccessList

​
Returns

BrandedAccessList

​
from()

const from: (value) => BrandedAccessList = _from
Defined in: src/primitives/AccessList/index.ts:48

​
Parameters

value
readonly Item[] | Uint8Array

​
Returns

BrandedAccessList

​
fromBytes()

const fromBytes: (bytes) => BrandedAccessList = _fromBytes
Defined in: src/primitives/AccessList/index.ts:49

​
Parameters

bytes
Uint8Array

​
Returns

BrandedAccessList

​
gasCost()

const gasCost: (list) => bigint = _gasCost
Defined in: src/primitives/AccessList/index.ts:55

​
Parameters

list
BrandedAccessList

​
Returns

bigint

​
gasSavings()

const gasSavings: (list) => bigint = _gasSavings
Defined in: src/primitives/AccessList/index.ts:56

​
Parameters

list
BrandedAccessList

​
Returns

bigint

​
hasSavings()

const hasSavings: (list) => boolean = _hasSavings
Defined in: src/primitives/AccessList/index.ts:57

​
Parameters

list
BrandedAccessList

​
Returns

boolean

​
includesAddress()

const includesAddress: (list, address) => boolean = _includesAddress
Defined in: src/primitives/AccessList/index.ts:58

​
Parameters

list
BrandedAccessList
address
AddressType

​
Returns

boolean

​
includesStorageKey()

const includesStorageKey: (list, address, storageKey) => boolean = _includesStorageKey
Defined in: src/primitives/AccessList/index.ts:62

​
Parameters

list
BrandedAccessList
address
AddressType
storageKey
HashType

​
Returns

boolean

​
is()

const is: (value) => value is BrandedAccessList = _is
Defined in: src/primitives/AccessList/index.ts:50

​
Parameters

value
unknown

​
Returns

value is BrandedAccessList

​
isEmpty()

const isEmpty: (list) => boolean = _isEmpty
Defined in: src/primitives/AccessList/index.ts:86

​
Parameters

list
BrandedAccessList

​
Returns

boolean

​
isItem()

const isItem: (value) => value is Item = _isItem
Defined in: src/primitives/AccessList/index.ts:51

​
Parameters

value
unknown

​
Returns

value is Item

​
keysFor()

const keysFor: (list, address) => readonly HashType[] | undefined = _keysFor
Defined in: src/primitives/AccessList/index.ts:67

​
Parameters

list
BrandedAccessList
address
AddressType

​
Returns

readonly HashType[] | undefined

​
merge()

const merge: (…accessLists) => BrandedAccessList = _merge
Defined in: src/primitives/AccessList/index.ts:53

​
Parameters

accessLists
…BrandedAccessList[]

​
Returns

BrandedAccessList

​
STORAGE_KEY_COST

const STORAGE_KEY_COST: 1900n = 1900n
Defined in: src/primitives/AccessList/constants.js:9 Gas cost per storage key in access list (EIP-2930)

​
storageKeyCount()

const storageKeyCount: (list) => number = _storageKeyCount
Defined in: src/primitives/AccessList/index.ts:85

​
Parameters

list
BrandedAccessList

​
Returns

number

​
toBytes()

const toBytes: (list) => Uint8Array = _toBytes
Defined in: src/primitives/AccessList/index.ts:83

​
Parameters

list
BrandedAccessList

​
Returns

Uint8Array

​
WARM_STORAGE_ACCESS_COST

const WARM_STORAGE_ACCESS_COST: 100n = 100n
Defined in: src/primitives/AccessList/constants.js:18 Warm storage access cost (post-EIP-2929)

​
withAddress()

const withAddress: (list, address) => BrandedAccessList = _withAddress
Defined in: src/primitives/AccessList/index.ts:73

​
Parameters

list
BrandedAccessList
address
AddressType

​
Returns

BrandedAccessList

​
withStorageKey()

const withStorageKey: (list, address, storageKey) => BrandedAccessList = _withStorageKey
Defined in: src/primitives/AccessList/index.ts:77

​
Parameters

list
BrandedAccessList
address
AddressType
storageKey
HashType

​
Returns

BrandedAccessList

​
References

​
AccessListNamespace

Renames and re-exports AccessList