> ## Documentation Index > Fetch the complete documentation index at: https://voltaire.tevm.sh/llms.txt > Use this file to discover all available pages before exploring further. # primitives/AccessList > Auto-generated API documentation [**@tevm/voltaire**](../index.mdx) *** [@tevm/voltaire](../index.mdx) / primitives/AccessList # primitives/AccessList ## Type Aliases ### BrandedAccessList > **BrandedAccessList** = readonly [`Item`](#item)\[] & `object` Defined in: [src/primitives/AccessList/AccessListType.ts:27](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/AccessListType.ts#L27) 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](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/AccessListType.ts#L13) Single access list entry Contains address and its accessed storage keys #### Type Parameters ##### TAddress `TAddress` *extends* [`AddressType`](Address.mdx#addresstype) = [`AddressType`](Address.mdx#addresstype) ##### TStorageKeys `TStorageKeys` *extends* readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] = readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] #### Properties ##### address > **address**: `TAddress` Defined in: [src/primitives/AccessList/AccessListType.ts:18](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/AccessListType.ts#L18) Contract address ##### storageKeys > **storageKeys**: `TStorageKeys` Defined in: [src/primitives/AccessList/AccessListType.ts:20](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/AccessListType.ts#L20) Storage keys accessed at this address ## Variables ### AccessList > `const` **AccessList**: `object` Defined in: [src/primitives/AccessList/index.ts:115](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L115) 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`](#brandedaccesslist) ###### Returns `number` ##### assertValid() > **assertValid**: (`list`) => `void` ###### Parameters ###### list [`BrandedAccessList`](#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`](#brandedaccesslist) ###### Returns [`BrandedAccessList`](#brandedaccesslist) ##### deduplicate() > **deduplicate**: (`list`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns [`BrandedAccessList`](#brandedaccesslist) ##### from() > **from**: (`value`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### value `Uint8Array`\<`ArrayBufferLike`> | readonly [`Item`](#item)\[] ###### Returns [`BrandedAccessList`](#brandedaccesslist) ##### fromBytes() > **fromBytes**: (`bytes`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### bytes `Uint8Array` ###### Returns [`BrandedAccessList`](#brandedaccesslist) ##### gasCost() > **gasCost**: (`list`) => `bigint` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns `bigint` ##### gasSavings() > **gasSavings**: (`list`) => `bigint` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns `bigint` ##### hasSavings() > **hasSavings**: (`list`) => `boolean` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns `boolean` ##### includesAddress() > **includesAddress**: (`list`, `address`) => `boolean` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### address [`AddressType`](Address.mdx#addresstype) ###### Returns `boolean` ##### includesStorageKey() > **includesStorageKey**: (`list`, `address`, `storageKey`) => `boolean` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### address [`AddressType`](Address.mdx#addresstype) ###### storageKey [`HashType`](../index/namespaces/HashType.mdx#hashtype) ###### Returns `boolean` ##### is() > **is**: (`value`) => `value is BrandedAccessList` ###### Parameters ###### value `unknown` ###### Returns `value is BrandedAccessList` ##### isEmpty() > **isEmpty**: (`list`) => `boolean` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns `boolean` ##### isItem() > **isItem**: (`value`) => `value is Item` ###### Parameters ###### value `unknown` ###### Returns `value is Item` ##### keysFor() > **keysFor**: (`list`, `address`) => readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] | `undefined` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### address [`AddressType`](Address.mdx#addresstype) ###### Returns readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] | `undefined` ##### merge() > **merge**: (...`accessLists`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### accessLists ...[`BrandedAccessList`](#brandedaccesslist)\[] ###### Returns [`BrandedAccessList`](#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`](#brandedaccesslist) ###### Returns `number` ##### toBytes() > **toBytes**: (`list`) => `Uint8Array` ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### Returns `Uint8Array` ##### WARM\_STORAGE\_ACCESS\_COST > **WARM\_STORAGE\_ACCESS\_COST**: `bigint` Warm storage access cost (post-EIP-2929) ##### withAddress() > **withAddress**: (`list`, `address`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### address [`AddressType`](Address.mdx#addresstype) ###### Returns [`BrandedAccessList`](#brandedaccesslist) ##### withStorageKey() > **withStorageKey**: (`list`, `address`, `storageKey`) => [`BrandedAccessList`](#brandedaccesslist) ###### Parameters ###### list [`BrandedAccessList`](#brandedaccesslist) ###### address [`AddressType`](Address.mdx#addresstype) ###### storageKey [`HashType`](../index/namespaces/HashType.mdx#hashtype) ###### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### ADDRESS\_COST > `const` **ADDRESS\_COST**: `2400n` = `2400n` Defined in: [src/primitives/AccessList/constants.js:6](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/constants.js#L6) Gas cost per address in access list (EIP-2930) *** ### addressCount() > `const` **addressCount**: (`list`) => `number` = `_addressCount` Defined in: [src/primitives/AccessList/index.ts:84](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L84) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `number` *** ### assertValid() > `const` **assertValid**: (`list`) => `void` = `_assertValid` Defined in: [src/primitives/AccessList/index.ts:82](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L82) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `void` *** ### COLD\_ACCOUNT\_ACCESS\_COST > `const` **COLD\_ACCOUNT\_ACCESS\_COST**: `2600n` = `2600n` Defined in: [src/primitives/AccessList/constants.js:12](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/constants.js#L12) 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](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/constants.js#L15) Cold storage access cost (pre-EIP-2930) *** ### create() > `const` **create**: () => [`BrandedAccessList`](#brandedaccesslist) = `_create` Defined in: [src/primitives/AccessList/index.ts:52](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L52) #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### deduplicate() > `const` **deduplicate**: (`list`) => [`BrandedAccessList`](#brandedaccesslist) = `_deduplicate` Defined in: [src/primitives/AccessList/index.ts:71](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L71) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### from() > `const` **from**: (`value`) => [`BrandedAccessList`](#brandedaccesslist) = `_from` Defined in: [src/primitives/AccessList/index.ts:48](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L48) #### Parameters ##### value readonly [`Item`](#item)\[] | `Uint8Array` #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### fromBytes() > `const` **fromBytes**: (`bytes`) => [`BrandedAccessList`](#brandedaccesslist) = `_fromBytes` Defined in: [src/primitives/AccessList/index.ts:49](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L49) #### Parameters ##### bytes `Uint8Array` #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### gasCost() > `const` **gasCost**: (`list`) => `bigint` = `_gasCost` Defined in: [src/primitives/AccessList/index.ts:55](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L55) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `bigint` *** ### gasSavings() > `const` **gasSavings**: (`list`) => `bigint` = `_gasSavings` Defined in: [src/primitives/AccessList/index.ts:56](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L56) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `bigint` *** ### hasSavings() > `const` **hasSavings**: (`list`) => `boolean` = `_hasSavings` Defined in: [src/primitives/AccessList/index.ts:57](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L57) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `boolean` *** ### includesAddress() > `const` **includesAddress**: (`list`, `address`) => `boolean` = `_includesAddress` Defined in: [src/primitives/AccessList/index.ts:58](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L58) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) ##### address [`AddressType`](Address.mdx#addresstype) #### Returns `boolean` *** ### includesStorageKey() > `const` **includesStorageKey**: (`list`, `address`, `storageKey`) => `boolean` = `_includesStorageKey` Defined in: [src/primitives/AccessList/index.ts:62](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L62) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) ##### address [`AddressType`](Address.mdx#addresstype) ##### storageKey [`HashType`](../index/namespaces/HashType.mdx#hashtype) #### Returns `boolean` *** ### is() > `const` **is**: (`value`) => `value is BrandedAccessList` = `_is` Defined in: [src/primitives/AccessList/index.ts:50](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L50) #### Parameters ##### value `unknown` #### Returns `value is BrandedAccessList` *** ### isEmpty() > `const` **isEmpty**: (`list`) => `boolean` = `_isEmpty` Defined in: [src/primitives/AccessList/index.ts:86](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L86) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `boolean` *** ### isItem() > `const` **isItem**: (`value`) => `value is Item` = `_isItem` Defined in: [src/primitives/AccessList/index.ts:51](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L51) #### Parameters ##### value `unknown` #### Returns `value is Item` *** ### keysFor() > `const` **keysFor**: (`list`, `address`) => readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] | `undefined` = `_keysFor` Defined in: [src/primitives/AccessList/index.ts:67](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L67) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) ##### address [`AddressType`](Address.mdx#addresstype) #### Returns readonly [`HashType`](../index/namespaces/HashType.mdx#hashtype)\[] | `undefined` *** ### merge() > `const` **merge**: (...`accessLists`) => [`BrandedAccessList`](#brandedaccesslist) = `_merge` Defined in: [src/primitives/AccessList/index.ts:53](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L53) #### Parameters ##### accessLists ...[`BrandedAccessList`](#brandedaccesslist)\[] #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### STORAGE\_KEY\_COST > `const` **STORAGE\_KEY\_COST**: `1900n` = `1900n` Defined in: [src/primitives/AccessList/constants.js:9](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/constants.js#L9) Gas cost per storage key in access list (EIP-2930) *** ### storageKeyCount() > `const` **storageKeyCount**: (`list`) => `number` = `_storageKeyCount` Defined in: [src/primitives/AccessList/index.ts:85](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L85) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `number` *** ### toBytes() > `const` **toBytes**: (`list`) => `Uint8Array` = `_toBytes` Defined in: [src/primitives/AccessList/index.ts:83](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L83) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) #### Returns `Uint8Array` *** ### WARM\_STORAGE\_ACCESS\_COST > `const` **WARM\_STORAGE\_ACCESS\_COST**: `100n` = `100n` Defined in: [src/primitives/AccessList/constants.js:18](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/constants.js#L18) Warm storage access cost (post-EIP-2929) *** ### withAddress() > `const` **withAddress**: (`list`, `address`) => [`BrandedAccessList`](#brandedaccesslist) = `_withAddress` Defined in: [src/primitives/AccessList/index.ts:73](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L73) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) ##### address [`AddressType`](Address.mdx#addresstype) #### Returns [`BrandedAccessList`](#brandedaccesslist) *** ### withStorageKey() > `const` **withStorageKey**: (`list`, `address`, `storageKey`) => [`BrandedAccessList`](#brandedaccesslist) = `_withStorageKey` Defined in: [src/primitives/AccessList/index.ts:77](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/AccessList/index.ts#L77) #### Parameters ##### list [`BrandedAccessList`](#brandedaccesslist) ##### address [`AddressType`](Address.mdx#addresstype) ##### storageKey [`HashType`](../index/namespaces/HashType.mdx#hashtype) #### Returns [`BrandedAccessList`](#brandedaccesslist) ## References ### AccessListNamespace Renames and re-exports [AccessList](#accesslist)