diff --git a/package-lock.json b/package-lock.json index 1f410ceabf..17f68103b9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15683,14 +15683,14 @@ }, "packages/block": { "name": "@ethereumjs/block", - "version": "5.0.0", + "version": "5.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "ethereum-cryptography": "^2.1.2" }, "devDependencies": { @@ -15702,16 +15702,16 @@ }, "packages/blockchain": { "name": "@ethereumjs/blockchain", - "version": "7.0.0", + "version": "7.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/ethash": "^3.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/ethash": "^3.0.1", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", "lru-cache": "^10.0.0" @@ -15731,23 +15731,23 @@ }, "packages/client": { "name": "@ethereumjs/client", - "version": "0.8.1", + "version": "0.9.0", "hasInstallScript": true, "license": "MPL-2.0", "dependencies": { - "@ethereumjs/block": "5.0.0", - "@ethereumjs/blockchain": "7.0.0", - "@ethereumjs/common": "4.0.0", - "@ethereumjs/devp2p": "6.0.0", - "@ethereumjs/ethash": "3.0.0", - "@ethereumjs/evm": "2.0.0", - "@ethereumjs/genesis": "0.1.0", - "@ethereumjs/rlp": "5.0.0", - "@ethereumjs/statemanager": "2.0.0", - "@ethereumjs/trie": "6.0.0", - "@ethereumjs/tx": "5.0.0", - "@ethereumjs/util": "9.0.0", - "@ethereumjs/vm": "7.0.0", + "@ethereumjs/block": "5.0.1", + "@ethereumjs/blockchain": "7.0.1", + "@ethereumjs/common": "4.1.0", + "@ethereumjs/devp2p": "6.0.1", + "@ethereumjs/ethash": "3.0.1", + "@ethereumjs/evm": "2.1.0", + "@ethereumjs/genesis": "0.2.0", + "@ethereumjs/rlp": "5.0.1", + "@ethereumjs/statemanager": "2.1.0", + "@ethereumjs/trie": "6.0.1", + "@ethereumjs/tx": "5.1.0", + "@ethereumjs/util": "9.0.1", + "@ethereumjs/vm": "7.1.0", "abstract-level": "^1.0.3", "body-parser": "^1.19.2", "c-kzg": "^2.1.2", @@ -15866,21 +15866,21 @@ }, "packages/common": { "name": "@ethereumjs/common", - "version": "4.0.0", + "version": "4.1.0", "license": "MIT", "dependencies": { - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/util": "^9.0.1", "crc": "^4.3.2" } }, "packages/devp2p": { "name": "@ethereumjs/devp2p", - "version": "6.0.0", + "version": "6.0.1", "license": "MIT", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "@scure/base": "1.1.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", @@ -15890,8 +15890,8 @@ "snappyjs": "^0.6.1" }, "devDependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/tx": "^5.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/tx": "^5.1.0", "@types/debug": "^4.1.9", "@types/k-bucket": "^5.0.0", "chalk": "^2.4.2", @@ -15974,17 +15974,17 @@ }, "packages/ethash": { "name": "@ethereumjs/ethash", - "version": "3.0.0", + "version": "3.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "bigint-crypto-utils": "^3.2.2", "ethereum-cryptography": "^2.1.2" }, "devDependencies": { - "@ethereumjs/common": "^4.0.0" + "@ethereumjs/common": "^4.1.0" }, "engines": { "node": ">=18" @@ -15992,13 +15992,13 @@ }, "packages/evm": { "name": "@ethereumjs/evm", - "version": "2.0.0", + "version": "2.1.0", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/statemanager": "^2.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/statemanager": "^2.1.0", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "@types/debug": "^4.1.9", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", @@ -16024,14 +16024,14 @@ }, "packages/genesis": { "name": "@ethereumjs/genesis", - "version": "0.1.0", + "version": "0.2.0", "license": "MIT", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/util": "^9.0.0" + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/util": "^9.0.1" }, "devDependencies": { - "@ethereumjs/trie": "^6.0.0" + "@ethereumjs/trie": "^6.0.1" }, "engines": { "node": ">=18" @@ -16039,7 +16039,7 @@ }, "packages/rlp": { "name": "@ethereumjs/rlp", - "version": "5.0.0", + "version": "5.0.1", "license": "MPL-2.0", "bin": { "rlp": "bin/rlp.cjs" @@ -16050,13 +16050,13 @@ }, "packages/statemanager": { "name": "@ethereumjs/statemanager", - "version": "2.0.0", + "version": "2.1.0", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", "ethers": "^6.4.0", @@ -16064,8 +16064,8 @@ "lru-cache": "^10.0.0" }, "devDependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/genesis": "^0.1.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/genesis": "^0.2.0", "@types/debug": "^4.1.9" } }, @@ -16079,18 +16079,18 @@ }, "packages/trie": { "name": "@ethereumjs/trie", - "version": "6.0.0", + "version": "6.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "@types/readable-stream": "^2.3.13", "ethereum-cryptography": "^2.1.2", "lru-cache": "^10.0.0", "readable-stream": "^3.6.0" }, "devDependencies": { - "@ethereumjs/genesis": "^0.1.0", + "@ethereumjs/genesis": "^0.2.0", "@types/benchmark": "^1.0.33", "abstract-level": "^1.0.3", "debug": "^4.3.4", @@ -16116,12 +16116,12 @@ }, "packages/tx": { "name": "@ethereumjs/tx", - "version": "5.0.0", + "version": "5.1.0", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "ethereum-cryptography": "^2.1.2" }, "devDependencies": { @@ -16144,10 +16144,10 @@ }, "packages/util": { "name": "@ethereumjs/util", - "version": "9.0.0", + "version": "9.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/rlp": "^5.0.0", + "@ethereumjs/rlp": "^5.0.1", "ethereum-cryptography": "^2.1.2" }, "devDependencies": {}, @@ -16168,8 +16168,8 @@ "version": "0.0.1", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/rlp": "5.0.0", - "@ethereumjs/util": "9.0.0", + "@ethereumjs/rlp": "5.0.1", + "@ethereumjs/util": "9.0.1", "lru-cache": "^10.0.0" }, "engines": { @@ -16186,18 +16186,18 @@ }, "packages/vm": { "name": "@ethereumjs/vm", - "version": "7.0.0", + "version": "7.1.0", "license": "MPL-2.0", "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/blockchain": "^7.0.0", - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/evm": "^2.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/statemanager": "^2.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/blockchain": "^7.0.1", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/evm": "^2.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/statemanager": "^2.1.0", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2" }, @@ -16221,10 +16221,10 @@ }, "packages/wallet": { "name": "@ethereumjs/wallet", - "version": "2.0.0", + "version": "2.0.1", "license": "MIT", "dependencies": { - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/util": "^9.0.1", "@scure/base": "^1.1.1", "ethereum-cryptography": "^2.1.2", "js-md5": "^0.7.3", diff --git a/packages/block/CHANGELOG.md b/packages/block/CHANGELOG.md index af46672cb2..4f3ff34780 100644 --- a/packages/block/CHANGELOG.md +++ b/packages/block/CHANGELOG.md @@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 5.0.1 - 2023-10-26 + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update peer dependency for `kzg` module to use the official trusted setup for `mainnet`, PR [#3107](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3107) + ## 5.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/block/docs/README.md b/packages/block/docs/README.md index e96fd37b93..91db86da88 100644 --- a/packages/block/docs/README.md +++ b/packages/block/docs/README.md @@ -29,6 +29,10 @@ - [WithdrawalV1](README.md#withdrawalv1) - [WithdrawalsBytes](README.md#withdrawalsbytes) +### Functions + +- [executionPayloadFromBeaconPayload](README.md#executionpayloadfrombeaconpayload) + ## Type Aliases ### BlockBodyBytes @@ -142,3 +146,26 @@ ___ #### Defined in [types.ts:113](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/types.ts#L113) + +## Functions + +### executionPayloadFromBeaconPayload + +▸ **executionPayloadFromBeaconPayload**(`payload`): [`ExecutionPayload`](README.md#executionpayload) + +Converts a beacon block execution payload JSON object BeaconPayloadJson to the [ExecutionPayload](README.md#executionpayload) data needed to construct a [Block](classes/Block.md). +The JSON data can be retrieved from a consensus layer (CL) client on this Beacon API `/eth/v2/beacon/blocks/[block number]` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `payload` | `BeaconPayloadJson` | + +#### Returns + +[`ExecutionPayload`](README.md#executionpayload) + +#### Defined in + +[from-beacon-payload.ts:39](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/from-beacon-payload.ts#L39) diff --git a/packages/block/docs/classes/Block.md b/packages/block/docs/classes/Block.md index ce2e631017..6a6754cba5 100644 --- a/packages/block/docs/classes/Block.md +++ b/packages/block/docs/classes/Block.md @@ -69,7 +69,7 @@ Use the static factory methods to assist in creating a Block object from varying #### Defined in -[block.ts:360](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L360) +[block.ts:361](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L361) ## Properties @@ -79,7 +79,7 @@ Use the static factory methods to assist in creating a Block object from varying #### Defined in -[block.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L51) +[block.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L52) ___ @@ -89,7 +89,7 @@ ___ #### Defined in -[block.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L46) +[block.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L47) ___ @@ -99,7 +99,7 @@ ___ #### Defined in -[block.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L47) +[block.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L48) ___ @@ -109,7 +109,7 @@ ___ #### Defined in -[block.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L50) +[block.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L51) ___ @@ -119,7 +119,7 @@ ___ #### Defined in -[block.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L48) +[block.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L49) ___ @@ -129,7 +129,7 @@ ___ #### Defined in -[block.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L49) +[block.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L50) ## Methods @@ -145,7 +145,7 @@ Return a compact error string representation of the object #### Defined in -[block.ts:698](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L698) +[block.ts:701](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L701) ___ @@ -167,7 +167,7 @@ Returns the canonical difficulty for this block. #### Defined in -[block.ts:664](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L664) +[block.ts:667](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L667) ___ @@ -183,7 +183,7 @@ Generates transaction trie for validation. #### Defined in -[block.ts:441](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L441) +[block.ts:442](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L442) ___ @@ -201,7 +201,7 @@ an array of error strings #### Defined in -[block.ts:469](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L469) +[block.ts:470](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L470) ___ @@ -217,7 +217,7 @@ Returns the hash of the block. #### Defined in -[block.ts:420](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L420) +[block.ts:421](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L421) ___ @@ -233,7 +233,7 @@ Determines if this block is the genesis block. #### Defined in -[block.ts:427](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L427) +[block.ts:428](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L428) ___ @@ -249,7 +249,7 @@ Returns a Array of the raw Bytes Arays of this block, in order. #### Defined in -[block.ts:402](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L402) +[block.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L403) ___ @@ -265,7 +265,7 @@ Returns the rlp encoding of the block. #### Defined in -[block.ts:434](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L434) +[block.ts:435](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L435) ___ @@ -281,7 +281,7 @@ Returns the block in JSON format. #### Defined in -[block.ts:681](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L681) +[block.ts:684](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L684) ___ @@ -299,7 +299,7 @@ True if all transactions are valid, false otherwise #### Defined in -[block.ts:519](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L519) +[block.ts:520](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L520) ___ @@ -318,7 +318,7 @@ True if the transaction trie is valid, false otherwise #### Defined in -[block.ts:451](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L451) +[block.ts:452](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L452) ___ @@ -336,7 +336,7 @@ true if the uncle's hash is valid, false otherwise. #### Defined in -[block.ts:613](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L613) +[block.ts:616](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L616) ___ @@ -360,7 +360,7 @@ blob gas per block #### Defined in -[block.ts:567](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L567) +[block.ts:568](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L568) ___ @@ -387,7 +387,7 @@ It checks: #### Defined in -[block.ts:534](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L534) +[block.ts:535](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L535) ___ @@ -410,7 +410,7 @@ Throws if invalid #### Defined in -[block.ts:674](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L674) +[block.ts:677](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L677) ___ @@ -432,7 +432,7 @@ Header does not count an uncle twice. #### Defined in -[block.ts:640](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L640) +[block.ts:643](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L643) ___ @@ -450,7 +450,7 @@ true if the withdrawals trie root is valid, false otherwise #### Defined in -[block.ts:623](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L623) +[block.ts:626](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L626) ___ @@ -475,7 +475,7 @@ the block constructed block #### Defined in -[block.ts:348](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L348) +[block.ts:349](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L349) ___ @@ -498,7 +498,7 @@ Static constructor to create a block from a block data dictionary #### Defined in -[block.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L85) +[block.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L86) ___ @@ -523,7 +523,7 @@ the block constructed block #### Defined in -[block.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L288) +[block.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L289) ___ @@ -549,7 +549,7 @@ the block specified by `blockTag` #### Defined in -[block.ts:228](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L228) +[block.ts:229](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L229) ___ @@ -572,7 +572,7 @@ Static constructor to create a block from a RLP-serialized block #### Defined in -[block.ts:134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L134) +[block.ts:135](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L135) ___ @@ -596,7 +596,7 @@ Creates a new block object from Ethereum JSON RPC. #### Defined in -[block.ts:217](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L217) +[block.ts:218](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L218) ___ @@ -619,7 +619,7 @@ Static constructor to create a block from an array of Bytes values #### Defined in -[block.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L150) +[block.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L151) ___ @@ -642,7 +642,7 @@ Returns the txs trie root for array of TypedTransaction #### Defined in -[block.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L71) +[block.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L72) ___ @@ -665,4 +665,4 @@ Returns the withdrawals trie root for array of Withdrawal. #### Defined in -[block.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L58) +[block.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/block.ts#L59) diff --git a/packages/block/docs/classes/BlockHeader.md b/packages/block/docs/classes/BlockHeader.md index 42fe23d234..8702dba176 100644 --- a/packages/block/docs/classes/BlockHeader.md +++ b/packages/block/docs/classes/BlockHeader.md @@ -85,7 +85,7 @@ varying data types. For a default empty header, use [fromHeaderData](BlockHeader #### Defined in -[header.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L142) +[header.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L147) ## Properties @@ -95,7 +95,7 @@ varying data types. For a default empty header, use [fromHeaderData](BlockHeader #### Defined in -[header.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L55) +[header.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L60) ___ @@ -105,7 +105,7 @@ ___ #### Defined in -[header.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L57) +[header.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L62) ___ @@ -115,7 +115,7 @@ ___ #### Defined in -[header.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L42) +[header.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L47) ___ @@ -125,7 +125,7 @@ ___ #### Defined in -[header.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L61) +[header.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L66) ___ @@ -135,7 +135,7 @@ ___ #### Defined in -[header.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L47) +[header.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L52) ___ @@ -145,7 +145,7 @@ ___ #### Defined in -[header.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L58) +[header.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L63) ___ @@ -155,7 +155,7 @@ ___ #### Defined in -[header.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L52) +[header.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L57) ___ @@ -165,7 +165,7 @@ ___ #### Defined in -[header.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L49) +[header.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L54) ___ @@ -175,7 +175,7 @@ ___ #### Defined in -[header.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L50) +[header.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L55) ___ @@ -185,7 +185,7 @@ ___ #### Defined in -[header.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L46) +[header.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L51) ___ @@ -195,7 +195,7 @@ ___ #### Defined in -[header.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L53) +[header.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L58) ___ @@ -205,7 +205,7 @@ ___ #### Defined in -[header.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L54) +[header.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L59) ___ @@ -215,7 +215,7 @@ ___ #### Defined in -[header.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L48) +[header.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L53) ___ @@ -225,7 +225,7 @@ ___ #### Defined in -[header.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L59) +[header.ts:64](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L64) ___ @@ -235,7 +235,7 @@ ___ #### Defined in -[header.ts:40](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L40) +[header.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L45) ___ @@ -245,7 +245,7 @@ ___ #### Defined in -[header.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L45) +[header.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L50) ___ @@ -255,7 +255,7 @@ ___ #### Defined in -[header.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L43) +[header.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L48) ___ @@ -265,7 +265,7 @@ ___ #### Defined in -[header.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L51) +[header.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L56) ___ @@ -275,7 +275,7 @@ ___ #### Defined in -[header.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L44) +[header.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L49) ___ @@ -285,7 +285,7 @@ ___ #### Defined in -[header.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L41) +[header.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L46) ___ @@ -295,7 +295,7 @@ ___ #### Defined in -[header.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L56) +[header.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L61) ## Accessors @@ -311,7 +311,7 @@ EIP-4399: After merge to PoS, `mixHash` supplanted as `prevRandao` #### Defined in -[header.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L70) +[header.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L75) ## Methods @@ -335,7 +335,7 @@ the total blob gas fee for numBlobs blobs #### Defined in -[header.ts:599](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L599) +[header.ts:598](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L598) ___ @@ -367,7 +367,7 @@ Calculates the excess blob gas for next (hopefully) post EIP 4844 block. #### Defined in -[header.ts:610](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L610) +[header.ts:609](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L609) ___ @@ -388,7 +388,7 @@ in conjunction with [cliqueIsEpochTransition](BlockHeader.md#cliqueisepochtransi #### Defined in -[header.ts:838](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L838) +[header.ts:830](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L830) ___ @@ -405,7 +405,7 @@ Returns extra seal data #### Defined in -[header.ts:802](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L802) +[header.ts:798](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L798) ___ @@ -422,7 +422,7 @@ Returns extra vanity data #### Defined in -[header.ts:793](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L793) +[header.ts:789](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L789) ___ @@ -439,7 +439,7 @@ header (only clique PoA, throws otherwise) #### Defined in -[header.ts:781](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L781) +[header.ts:777](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L777) ___ @@ -455,7 +455,7 @@ PoA clique signature hash without the seal. #### Defined in -[header.ts:770](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L770) +[header.ts:766](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L766) ___ @@ -471,7 +471,7 @@ Returns the signer address #### Defined in -[header.ts:875](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L875) +[header.ts:867](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L867) ___ @@ -496,7 +496,7 @@ Verifies the signature of the block (last 65 bytes of extraData field) #### Defined in -[header.ts:863](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L863) +[header.ts:855](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L855) ___ @@ -512,7 +512,7 @@ Return a compact error string representation of the object #### Defined in -[header.ts:958](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L958) +[header.ts:950](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L950) ___ @@ -534,7 +534,7 @@ Returns the canonical difficulty for this block. #### Defined in -[header.ts:697](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L697) +[header.ts:695](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L695) ___ @@ -552,7 +552,7 @@ the price in gwei per unit of blob gas spent #### Defined in -[header.ts:582](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L582) +[header.ts:581](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L581) ___ @@ -568,7 +568,7 @@ Returns the hash of the block header. #### Defined in -[header.ts:665](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L665) +[header.ts:664](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L664) ___ @@ -584,7 +584,7 @@ Checks if the block header is a genesis header. #### Defined in -[header.ts:679](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L679) +[header.ts:677](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L677) ___ @@ -600,7 +600,7 @@ Returns a Uint8Array Array of the raw Bytes in this header, in order. #### Defined in -[header.ts:625](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L625) +[header.ts:624](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L624) ___ @@ -616,7 +616,7 @@ Returns the rlp encoding of the block header. #### Defined in -[header.ts:892](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L892) +[header.ts:884](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L884) ___ @@ -632,7 +632,7 @@ Returns the block header in JSON format. #### Defined in -[header.ts:899](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L899) +[header.ts:891](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L891) ___ @@ -655,7 +655,7 @@ Throws if out of bounds. #### Defined in -[header.ts:495](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L495) +[header.ts:499](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L499) ___ @@ -678,7 +678,7 @@ Static constructor to create a block header from a header data dictionary #### Defined in -[header.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L86) +[header.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L91) ___ @@ -701,7 +701,7 @@ Static constructor to create a block header from a RLP-serialized header #### Defined in -[header.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L96) +[header.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L101) ___ @@ -724,4 +724,4 @@ Static constructor to create a block header from an array of Bytes values #### Defined in -[header.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L110) +[header.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/block/src/header.ts#L115) diff --git a/packages/block/package.json b/packages/block/package.json index 3ebfa6dd48..df3543c3e7 100644 --- a/packages/block/package.json +++ b/packages/block/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/block", - "version": "5.0.0", + "version": "5.0.1", "description": "Provides Block serialization and help functions", "keywords": [ "ethereum", @@ -45,11 +45,11 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "ethereum-cryptography": "^2.1.2" }, "devDependencies": { diff --git a/packages/blockchain/CHANGELOG.md b/packages/blockchain/CHANGELOG.md index cb6aa475ef..3c9230cd4b 100644 --- a/packages/blockchain/CHANGELOG.md +++ b/packages/blockchain/CHANGELOG.md @@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 7.0.1 - 2023-10-26 + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update peer dependency for `kzg` module to use the official trusted setup for `mainnet`, PR [#3107](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3107) + +### Other Changes + +- New `getIteratorHeadSafe()` method which returns `undefined` if the provided head is not found. This differs from `getIteratorHead`, which returns the genesis block in case if the provided head is not found, PR [#3099](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3099) + ## 7.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/blockchain/docs/classes/Blockchain.md b/packages/blockchain/docs/classes/Blockchain.md index f6afb57954..741a3b67a6 100644 --- a/packages/blockchain/docs/classes/Blockchain.md +++ b/packages/blockchain/docs/classes/Blockchain.md @@ -32,6 +32,7 @@ This class stores and interacts with blocks. - [getCanonicalHeadHeader](Blockchain.md#getcanonicalheadheader) - [getCanonicalHeader](Blockchain.md#getcanonicalheader) - [getIteratorHead](Blockchain.md#getiteratorhead) +- [getIteratorHeadSafe](Blockchain.md#getiteratorheadsafe) - [getParentTD](Blockchain.md#getparenttd) - [getTotalDifficulty](Blockchain.md#gettotaldifficulty) - [iterator](Blockchain.md#iterator) @@ -57,7 +58,7 @@ This class stores and interacts with blocks. #### Defined in -[blockchain.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L75) +[blockchain.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L78) ___ @@ -71,7 +72,7 @@ ___ #### Defined in -[blockchain.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L47) +[blockchain.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L50) ___ @@ -81,7 +82,7 @@ ___ #### Defined in -[blockchain.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L48) +[blockchain.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L51) ___ @@ -91,7 +92,7 @@ ___ #### Defined in -[blockchain.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L49) +[blockchain.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L52) ## Accessors @@ -107,7 +108,7 @@ The genesis Block for the blockchain. #### Defined in -[blockchain.ts:1318](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1318) +[blockchain.ts:1345](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1345) ## Methods @@ -129,7 +130,7 @@ The genesis Block for the blockchain. #### Defined in -[blockchain.ts:1255](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1255) +[blockchain.ts:1282](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1282) ___ @@ -151,7 +152,7 @@ Creates a genesis Block for the blockchain with params from Common.genesis #### Defined in -[blockchain.ts:1327](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1327) +[blockchain.ts:1354](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1354) ___ @@ -184,7 +185,7 @@ we can be sure it is correct). #### Defined in -[blockchain.ts:856](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L856) +[blockchain.ts:883](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L883) ___ @@ -211,7 +212,7 @@ block will be the canonical block at that number in the chain #### Defined in -[blockchain.ts:724](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L724) +[blockchain.ts:751](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L751) ___ @@ -237,7 +238,7 @@ Looks up many blocks relative to blockId Note: due to `GetBlockHeaders #### Defined in -[blockchain.ts:773](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L773) +[blockchain.ts:800](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L800) ___ @@ -257,7 +258,7 @@ Returns the latest full block in the canonical chain. #### Defined in -[blockchain.ts:333](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L333) +[blockchain.ts:354](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L354) ___ @@ -273,7 +274,7 @@ Returns the latest header in the canonical chain. #### Defined in -[blockchain.ts:322](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L322) +[blockchain.ts:343](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L343) ___ @@ -295,7 +296,7 @@ Gets a header by number. Header must be in the canonical chain #### Defined in -[blockchain.ts:1296](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1296) +[blockchain.ts:1323](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1323) ___ @@ -326,7 +327,29 @@ has not been run. This matches the behavior of [iterator](Blockchain.md#iterator #### Defined in -[blockchain.ts:310](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L310) +[blockchain.ts:313](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L313) + +___ + +### getIteratorHeadSafe + +▸ **getIteratorHeadSafe**(`name?`): `Promise`<`undefined` \| `Block`\> + +This method differs from `getIteratorHead`. If the head is not found, it returns `undefined`. + +#### Parameters + +| Name | Type | Default value | Description | +| :------ | :------ | :------ | :------ | +| `name` | `string` | `'vm'` | Optional name of the iterator head (default: 'vm') | + +#### Returns + +`Promise`<`undefined` \| `Block`\> + +#### Defined in + +[blockchain.ts:324](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L324) ___ @@ -348,7 +371,7 @@ Gets total difficulty for a header's parent, helpful for determining terminal bl #### Defined in -[blockchain.ts:759](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L759) +[blockchain.ts:786](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L786) ___ @@ -375,7 +398,7 @@ Gets total difficulty for a block specified by hash and number #### Defined in -[blockchain.ts:745](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L745) +[blockchain.ts:772](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L772) ___ @@ -408,7 +431,7 @@ number of blocks actually iterated #### Defined in -[blockchain.ts:957](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L957) +[blockchain.ts:984](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L984) ___ @@ -438,7 +461,7 @@ heads/hashes are overwritten. #### Defined in -[blockchain.ts:363](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L363) +[blockchain.ts:384](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L384) ___ @@ -465,7 +488,7 @@ chain is rebuilt and any stale heads/hashes are overwritten. #### Defined in -[blockchain.ts:349](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L349) +[blockchain.ts:370](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L370) ___ @@ -491,7 +514,7 @@ heads/hashes are overwritten. #### Defined in -[blockchain.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L390) +[blockchain.ts:411](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L411) ___ @@ -518,7 +541,7 @@ chain is rebuilt and any stale heads/hashes are overwritten. #### Defined in -[blockchain.ts:376](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L376) +[blockchain.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L397) ___ @@ -543,7 +566,7 @@ canonicalHead and cleans up canonical references greater than canonicalHead #### Defined in -[blockchain.ts:402](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L402) +[blockchain.ts:423](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L423) ___ @@ -567,7 +590,7 @@ any other error, this function throws. #### Defined in -[blockchain.ts:1310](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1310) +[blockchain.ts:1337](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1337) ___ @@ -591,7 +614,7 @@ Therefore, the array needs to be ordered upon number. #### Defined in -[blockchain.ts:815](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L815) +[blockchain.ts:842](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L842) ___ @@ -619,7 +642,7 @@ When calling the iterator, the iterator will start running the first child block #### Defined in -[blockchain.ts:1040](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1040) +[blockchain.ts:1067](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L1067) ___ @@ -647,7 +670,7 @@ the original. #### Defined in -[blockchain.ts:197](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L197) +[blockchain.ts:200](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L200) ___ @@ -670,7 +693,7 @@ whether the block is internally consistent #### Defined in -[blockchain.ts:627](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L627) +[blockchain.ts:654](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L654) ___ @@ -708,7 +731,7 @@ It verifies the current block against the `parentHash`: #### Defined in -[blockchain.ts:560](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L560) +[blockchain.ts:587](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L587) ___ @@ -731,7 +754,7 @@ encouraged method to use when creating a blockchain object. #### Defined in -[blockchain.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L87) +[blockchain.ts:90](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L90) ___ @@ -755,4 +778,4 @@ objects must be readable by Block.fromBlockData #### Defined in -[blockchain.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L101) +[blockchain.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/blockchain.ts#L104) diff --git a/packages/blockchain/docs/classes/CasperConsensus.md b/packages/blockchain/docs/classes/CasperConsensus.md index ab231f096d..697b133a9a 100644 --- a/packages/blockchain/docs/classes/CasperConsensus.md +++ b/packages/blockchain/docs/classes/CasperConsensus.md @@ -34,7 +34,7 @@ This class encapsulates Casper-related consensus functionality when used with th #### Defined in -[consensus/casper.ts:12](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L12) +[consensus/casper.ts:13](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L13) ## Properties @@ -48,7 +48,7 @@ This class encapsulates Casper-related consensus functionality when used with th #### Defined in -[consensus/casper.ts:10](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L10) +[consensus/casper.ts:11](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L11) ## Methods @@ -68,7 +68,7 @@ Initialize genesis for consensus mechanism #### Defined in -[consensus/casper.ts:16](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L16) +[consensus/casper.ts:17](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L17) ___ @@ -88,7 +88,7 @@ Update consensus on new block #### Defined in -[consensus/casper.ts:28](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L28) +[consensus/casper.ts:29](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L29) ___ @@ -108,7 +108,7 @@ Set up consensus mechanism #### Defined in -[consensus/casper.ts:18](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L18) +[consensus/casper.ts:19](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L19) ___ @@ -128,7 +128,7 @@ Validate block consensus parameters #### Defined in -[consensus/casper.ts:20](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L20) +[consensus/casper.ts:21](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L21) ___ @@ -152,4 +152,4 @@ ___ #### Defined in -[consensus/casper.ts:22](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L22) +[consensus/casper.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/casper.ts#L23) diff --git a/packages/blockchain/docs/classes/CliqueConsensus.md b/packages/blockchain/docs/classes/CliqueConsensus.md index 684a2213fc..3a53a4bbc7 100644 --- a/packages/blockchain/docs/classes/CliqueConsensus.md +++ b/packages/blockchain/docs/classes/CliqueConsensus.md @@ -44,7 +44,7 @@ Now replay all blocks on top of it. This should validate the chain up to the new #### Defined in -[consensus/clique.ts:109](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L109) +[consensus/clique.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L112) ## Properties @@ -60,7 +60,7 @@ On reorgs elements from the array are removed until BLOCK_NUMBER > REORG_BLOCK. #### Defined in -[consensus/clique.ts:107](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L107) +[consensus/clique.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L110) ___ @@ -81,7 +81,7 @@ Always keep at least one item on the stack. #### Defined in -[consensus/clique.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L82) +[consensus/clique.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L85) ___ @@ -104,7 +104,7 @@ On reorgs elements from the array are removed until BLOCK_NUMBER > REORG_BLOCK. #### Defined in -[consensus/clique.ts:98](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L98) +[consensus/clique.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L101) ___ @@ -118,7 +118,7 @@ ___ #### Defined in -[consensus/clique.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L60) +[consensus/clique.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L63) ___ @@ -128,7 +128,7 @@ ___ #### Defined in -[consensus/clique.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L59) +[consensus/clique.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L62) ## Methods @@ -150,7 +150,7 @@ Returns a list with the current block signers #### Defined in -[consensus/clique.ts:426](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L426) +[consensus/clique.ts:429](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L429) ___ @@ -173,7 +173,7 @@ Helper to determine if a signer is in or out of turn for the next block. #### Defined in -[consensus/clique.ts:598](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L598) +[consensus/clique.ts:601](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L601) ___ @@ -199,7 +199,7 @@ Initialize genesis for consensus mechanism #### Defined in -[consensus/clique.ts:127](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L127) +[consensus/clique.ts:130](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L130) ___ @@ -226,7 +226,7 @@ Update consensus on new block #### Defined in -[consensus/clique.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L191) +[consensus/clique.ts:194](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L194) ___ @@ -250,7 +250,7 @@ ___ #### Defined in -[consensus/clique.ts:119](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L119) +[consensus/clique.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L122) ___ @@ -276,7 +276,7 @@ Validate block consensus parameters #### Defined in -[consensus/clique.ts:131](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L131) +[consensus/clique.ts:134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L134) ___ @@ -300,4 +300,4 @@ ___ #### Defined in -[consensus/clique.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L162) +[consensus/clique.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/blockchain/src/consensus/clique.ts#L165) diff --git a/packages/blockchain/package.json b/packages/blockchain/package.json index a8874f43ef..af08fa0d3a 100644 --- a/packages/blockchain/package.json +++ b/packages/blockchain/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/blockchain", - "version": "7.0.0", + "version": "7.0.1", "description": "A module to store and interact with blocks", "keywords": [ "ethereum", @@ -45,13 +45,13 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/ethash": "^3.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/ethash": "^3.0.1", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", "lru-cache": "^10.0.0" diff --git a/packages/client/CHANGELOG.md b/packages/client/CHANGELOG.md index 83ed1611c1..0f49ac2d67 100644 --- a/packages/client/CHANGELOG.md +++ b/packages/client/CHANGELOG.md @@ -6,6 +6,95 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 0.9.0 - 2023-10-26 + +This client release now syncs with the new Holesky and Dencun devnet-11 test networks and comes with improved sync performance, a revamped post-Merge client UX experience and various beacon sync related fixes and robustness improvements. + +### Holesky Testnet Support + +This client release now fully supports running the new [Holesky](https://holesky.ethpandaops.io/) public Ethereum testnet replacing the `Goerli` test network, see , PR [#2982](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2982) and some following PRs. + +The following command starts an EthereumJS client on Holesky: + +```typescript +ethereumjs --network=holesky --rpc --rpcEngine +``` + +Then start a corresponding CL client (e.g. Lodestar with checkpoint sync towards `https://lodestar-holesky.chainsafe.io`), also see client [README](https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/client/README.md). + +### Dencun devnet-11 Compatibility + +Another testnet to be run with this client: Dencun `devnet-11`, which is one of the last and eventually the _very_ last testnet before running the Dencun hardfork on the official testnet. + +Following spec updates included: + +- Update `EIP-4788`: do not use precompile anymore but use the pre-deployed bytecode, PR [#2955](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2955) +- Additional `EIP-4788` updates (address + modulus), PR [#3068](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3068) +- Update the beacon block root contract address, PR [#3003](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3003) +- Fix `newPayloadV2` having `PayloadV3` params, PR [#2954](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2954) +- Include parent beacon block root for proposal payload uniquness, PR [#2967](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2967) +- Fixes for new engine api method validations for hive pr-834, PR [#2973](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2973) +- Track and respond to invalid blocks in engine api and other hive engine-cancun fixes, PR [#3077](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3077) +- Make the newpayload execution of big blocks non blocking, PR [#3076](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3076) +- Hive Cancun fixes, PR [#3099](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3099) + +See [devnet-11](https://github.com/ethpandaops/dencun-testnet) EthPandaOps GitHub repository for instructions on how to run the testnet. + +### Sync and EVM/VM (Execution) Performance + +This client release integrates with the EthereumJS EVM v2.1.0 (see EVM [CHANGELOG](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/CHANGELOG.md) for details) which comes with significant performance improvements for various opcodes as well as overall EVM execution. + +Furthermore the data model for saving the state has been optimized to improve storage DB read performance, see PR [#3023](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3023) and PR [#3067](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3067). + +Both changes together should increase client sync performance by 30% or more. + +**Important**: The new db model is not backwards-compatible with existing client databases. Use the new `--prefixStorageTrieKeys` (set it to `false`) and `--useStringValueTrieDB` (set it to `true`) flags to preserve the old DB behavior. + +### New Post-Merge UX Experience + +We have gone through the complete post-Merge beacon sync process and reworked the client output along, see PR [#3085](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3085) and some follow-up PRs. It is now substantially easier to follow the different stages of the sync process (backfilling, forwardfilling & execution, following the chain) and track the overall sync progress. Holesky with its newly initialized state is a great testbed to see the new client capabilities in practice! 🤩 + +### Block/Tx Profiling + +The client can be now leveraged as a tool for block and/or tx profiling by using the new `--vmProfileBlocks` and `--vmProfileTxs` options, see PR [#3042](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3042). This gives details into the EVM/VM execution performance for specific blocks. See profiler related EVM [README section](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/README.md#profiling-the-evm) for further details. + +### Discovery Improvements + +A new more fine-tuned discovery `discV4` mechanism has been integrated along PR [#3120](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3120). This should now make it substantially easier to find new peers especially on smaller networks like the `devnet-11` and related Dencun test networks. Additionally the `--bootnodes` option has been expanded to now also take `bootnode.txt` files for easier loading of bootnodes. + +### Skeleton/Beacon Sync Reworks and Fixes + +- Some skeleton improvements from observations on devnet syncs, PR [#3014](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3014) +- Decouple skeleton from beacon sync, PR [#3028](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3028) +- Fix canonical reset of the chain by the skeleton, PR [#3078](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3078) +- Skeleton reorg head fixes, PR [#3085](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3085) +- Fixes regarding beacon sync, vmexecution and further log improvs, PR [#3094](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3094) +- Various rebase and sync related improvements along PR [#3031](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3031) + +### Other Features + +- Add `eth_coinbase` RPC method, PR [#3079](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3079) +- Add Option to Return Actual Caught Error Message and Stack Trace when RPC Call Fails, PR [#3059](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3059) +- More fine-grained `--rpcDebug` option (enable/disable specific RPC module logs), PRs [#3102](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3102) and [#3127](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3127) + +### Other Changes and Fixes + +- Properly handle errors in `storageRangeAt` RPC method, PR [#2952](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2952) +- Fix TxPool not being started along FCU, PR [#3100](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3100) +- Fix initialization order when blocks are preloaded, PR [#2979](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2979) +- Add error handling for async errors in client, PR [#2984](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2984) +- Deactivate storage/account caches for cache size 0, PR [#3012](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3012) +- Rewrites block fetcher `sync()` without the `async-promise-generator` api, PR [#3030](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3030) +- Clean up CLI arg passing, PR [#3036](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3036) +- Docker related updates, PR [#3065](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3065) +- Use same Cache Setup for normal and executeBlocks-triggered Execution, PR [#3063](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3063) +- Simplify client transports, **breaking**: removed `--transports`, PR [#3069](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3069) +- Experimental SNAP sync integration (larger announcement later on, but feel free to already experiment with it using the `--snap` option)! 😆), PR [#3031](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3031) +- Guard against rpc port collisions, PR [#3083](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3083) +- Change execution stats intervals, PR [#3106](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3106) +- pendingBlock fix if FCU is called with withdrawals=null pre-cancun, PR [#3119](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3119) +- Handle an edge case in `newpayload` block execution, PR [#3131](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3131) + ## 0.8.1 - 2023-08-09 Note: this release is not yet fully ready for `4844-devnet-8` (launch in August 2023). diff --git a/packages/client/README.md b/packages/client/README.md index 4492a71c0f..1ac5e15e8e 100644 --- a/packages/client/README.md +++ b/packages/client/README.md @@ -6,8 +6,8 @@ [![Code Coverage][client-coverage-badge]][client-coverage-link] [![Discord][discord-badge]][discord-link] -| Ethereum Execution (Eth 1.0) Client built in TypeScript/JavaScript. | -| ------------------------------------------------------------------- | +| Ethereum Execution Layer (EL) Client built in TypeScript/JavaScript. | +| -------------------------------------------------------------------- | ## Table of Contents @@ -29,7 +29,7 @@ The EthereumJS Client is an Ethereum Execution Client (similar to [go-ethereum]( Here are some use cases: -- Sync the main Ethereum networks (`mainnet` (experimental), `goerli`, `sepolia`, ...) +- Sync the main Ethereum networks (`mainnet` (experimental), `sepolia`, `holesky`, ...) - Set up your own local development networks (PoS with consensus client / PoA Clique / PoW with CPU miner) - Run a network with your own custom [EthereumJS VM](../vm) - Analyze what's in the Ethereum `mainnet` [transaction pool (mempool)](./lib/sync/txpool.ts) @@ -104,10 +104,10 @@ And pass in CLI parameters like: ```shell # npm installation -ethereumjs --network=goerli +ethereumjs --network=holesky # Source installation -npm run client:start -- --network=goerli +npm run client:start -- --network=holesky ``` To see a help page with the full list of client options available run: @@ -125,13 +125,13 @@ The EthereumJS client is tightly integrated with the EthereumJS [Common](../comm The main supported networks are: - `mainnet` (experimental) -- `goerli` - `sepolia` (`v0.3.0`+) +- `holesky` (`v0.9.0`+) Use the CLI `--network` option to switch the network: ```shell -ethereumjs --network=sepolia +ethereumjs --network=holesky ``` The client currently supports `full` sync being set as a default and has experimental support for `light` sync. @@ -179,11 +179,11 @@ JWT authentication can be disabled by adding the `--rpcEngineAuth false` flag (d The following is a rough guidance to run Lodestar as a beacon (non-validating) Node, see Lodestar [docs](https://chainsafe.github.io/lodestar/usage/beacon-management/) for more complete and up-to-date instructions on beacon management with Lodestar. 1. Use lodestar branch `stable` and run `yarn && yarn build` -2. Run cmd: `./lodestar beacon --network sepolia --jwt-secret /path/to/jwtsecret/file` +2. Run cmd: `./lodestar beacon --network holesky --jwt-secret /path/to/jwtsecret/file` This will by default try connecting to `ethereumjs` over the endpoint `8551`. (You may customize this in conjunction with `ethereumjs`, see lodestar cli help via `--help`). -You may provide `--checkpointSyncUrl` (with a synced `sepolia` beacon node endpoint as arg value) to start directly off the head/provided checkpoint on the `sepolia` beacon chain, possibly triggering (backfill) beacon sync on ethereumjs. +You may provide `--checkpointSyncUrl` (with a synced `holesky` beacon node endpoint as arg value) to start directly off the head/provided checkpoint on the `holesky` beacon chain, possibly triggering (backfill) beacon sync on ethereumjs. #### (Optional) Validator @@ -199,26 +199,20 @@ For a testnet chain, you may skip keystore generation and directly provide lodes (Modify the mnemonic and range indices as per your validator configuration). -#### Running EthereumJS/Lodestar on Sepolia +#### Running EthereumJS/Lodestar on Holesky -A suited network to test the EthereumJS/Lodestar client combination is the Sepolia network, being still somewhat lightweight but nevertheless being actively used with a significant transaction load. +A suited network to test the EthereumJS/Lodestar client combination is the Holesky network, being still somewhat lightweight but nevertheless being actively used with a significant transaction load. -To sync the EthereumJS client pre-Merge run: +To start the EthereumJS client with JSON RPC and Engine API endpoints exposed: ```shell -ethereumjs --network=sepolia -``` - -After the Merge you need to expand and start with JSON RPC and Engine API endpoints exposed: - -```shell -ethereumjs --network=sepolia --rpc --rpcEngine +ethereumjs --network=holesky --rpc --rpcEngine ``` Then start the Lodestar client with: ```shell -./lodestar beacon --network=sepolia --jwt-secret=[PATH-TO-JWT-SECRET-FROM-ETHEREUMJS-CLIENT] +./lodestar beacon --network=holesky --jwt-secret=[PATH-TO-JWT-SECRET-FROM-ETHEREUMJS-CLIENT] ``` ## Custom Chains diff --git a/packages/client/archive/libp2p/net/package.json.browser.deps b/packages/client/archive/libp2p/net/package.json.browser.deps index cd671351f0..286c43f04c 100644 --- a/packages/client/archive/libp2p/net/package.json.browser.deps +++ b/packages/client/archive/libp2p/net/package.json.browser.deps @@ -57,18 +57,18 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/block": "5.0.0", - "@ethereumjs/blockchain": "7.0.0", - "@ethereumjs/common": "4.0.0", - "@ethereumjs/devp2p": "6.0.0", - "@ethereumjs/ethash": "3.0.0", - "@ethereumjs/evm": "2.0.0", - "@ethereumjs/rlp": "5.0.0", - "@ethereumjs/statemanager": "2.0.0", - "@ethereumjs/trie": "6.0.0", - "@ethereumjs/tx": "5.0.0", - "@ethereumjs/util": "9.0.0", - "@ethereumjs/vm": "7.0.0", + "@ethereumjs/block": "5.0.1", + "@ethereumjs/blockchain": "7.0.1", + "@ethereumjs/common": "4.1.0", + "@ethereumjs/devp2p": "6.0.1", + "@ethereumjs/ethash": "3.0.1", + "@ethereumjs/evm": "2.1.0", + "@ethereumjs/rlp": "5.0.1", + "@ethereumjs/statemanager": "2.1.0", + "@ethereumjs/trie": "6.0.1", + "@ethereumjs/tx": "5.1.0", + "@ethereumjs/util": "9.0.1", + "@ethereumjs/vm": "7.1.0", "abstract-level": "^1.0.3", "body-parser": "^1.19.2", "c-kzg": "^2.1.0", diff --git a/packages/client/package.json b/packages/client/package.json index 30fbc29f61..47d6f38824 100644 --- a/packages/client/package.json +++ b/packages/client/package.json @@ -1,7 +1,7 @@ { "name": "@ethereumjs/client", - "version": "0.8.1", - "description": "EthereumJS client implementation", + "version": "0.9.0", + "description": "EthereumJS Execution Layer (EL) Client Implementation", "keywords": [ "ethereum", "ethereumjs", @@ -56,19 +56,19 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/block": "5.0.0", - "@ethereumjs/blockchain": "7.0.0", - "@ethereumjs/common": "4.0.0", - "@ethereumjs/devp2p": "6.0.0", - "@ethereumjs/ethash": "3.0.0", - "@ethereumjs/evm": "2.0.0", - "@ethereumjs/genesis": "0.1.0", - "@ethereumjs/rlp": "5.0.0", - "@ethereumjs/statemanager": "2.0.0", - "@ethereumjs/trie": "6.0.0", - "@ethereumjs/tx": "5.0.0", - "@ethereumjs/util": "9.0.0", - "@ethereumjs/vm": "7.0.0", + "@ethereumjs/block": "5.0.1", + "@ethereumjs/blockchain": "7.0.1", + "@ethereumjs/common": "4.1.0", + "@ethereumjs/devp2p": "6.0.1", + "@ethereumjs/ethash": "3.0.1", + "@ethereumjs/evm": "2.1.0", + "@ethereumjs/genesis": "0.2.0", + "@ethereumjs/rlp": "5.0.1", + "@ethereumjs/statemanager": "2.1.0", + "@ethereumjs/trie": "6.0.1", + "@ethereumjs/tx": "5.1.0", + "@ethereumjs/util": "9.0.1", + "@ethereumjs/vm": "7.1.0", "abstract-level": "^1.0.3", "body-parser": "^1.19.2", "c-kzg": "^2.1.2", diff --git a/packages/common/CHANGELOG.md b/packages/common/CHANGELOG.md index 528e802f44..f6666e98c7 100644 --- a/packages/common/CHANGELOG.md +++ b/packages/common/CHANGELOG.md @@ -6,6 +6,34 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 4.1.0 - 2023-10-26 + +### Holesky Testnet Support + +This release comes with full support for the [Holesky](https://holesky.ethpandaops.io/) public Ethereum testnet replacing the `Goerli` test network. + +- Add Holesky chain specification, PR [#2982](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2982), [#2989](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2989), [#2997](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2997), [#3049](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3049), [#3074](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3074) and [#3088](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3088) + +### EIP-7516 BLOBBASEFEE Opcode + +This release supports [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) with a new `BLOBBASEFEE` opcode added to and scheduled for the Dencun HF, see PR [#3035](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3035) and [#3068](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3068). The opcode returns the value of the blob base-fee of the current block it is executing in. + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update `EIP-4788`: do not use precompile anymore but use the pre-deployed bytecode, PR [#2955](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2955) +- Small Cancun-related fixes, PR [#3099](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3099) + +### Bugfixes + +- Updates and fixes along Geth genesis file parsing, PR [#2961](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2961) +- Handle `forkHash` on timestamp == genesis timestamp, PR [#2959](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2959) + +### Other Changes + +- Performance: Cache Parameter Values + activated EIPs for current Hardfork, PR [#2994](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2994) + ## 4.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/common/README.md b/packages/common/README.md index 0fa2b57e8b..12703d954a 100644 --- a/packages/common/README.md +++ b/packages/common/README.md @@ -139,6 +139,7 @@ Supported chains: - `mainnet` (`Chain.Mainnet`) - `goerli` (`Chain.Goerli`) - `sepolia` (`Chain.Sepolia`) (`v2.6.1`+) +- `holesky` (`Chain.Holesky`) (`v4.1.0`+) - Private/custom chain parameters The following chain-specific parameters are provided: @@ -327,8 +328,10 @@ The following EIPs are currently supported: - [EIP-4788](https://eips.ethereum.org/EIPS/eip-4788) - Beacon block root in the EVM (Cancun) - [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) - Shard Blob Transactions (Cancun) (`experimental`) - [EIP-4895](https://eips.ethereum.org/EIPS/eip-4895) - Beacon chain push withdrawals as operations (Shanghai) +- [EIP-5133](https://eips.ethereum.org/EIPS/eip-5133) - Delaying Difficulty Bomb to mid-September 2022 (Gray Glacier) - [EIP-5656](https://eips.ethereum.org/EIPS/eip-5656) - MCOPY - Memory copying instruction (Cancun) - [EIP-6780](https://eips.ethereum.org/EIPS/eip-6780) - SELFDESTRUCT only in same transaction (Cancun) +- [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) - BLOBBASEFEE opcode (Cancun) ### Bootstrap Nodes diff --git a/packages/common/docs/README.md b/packages/common/docs/README.md index bf12ca39d9..6683fdcca7 100644 --- a/packages/common/docs/README.md +++ b/packages/common/docs/README.md @@ -31,6 +31,7 @@ - [HardforkTransitionConfig](interfaces/HardforkTransitionConfig.md) - [StateManagerInterface](interfaces/StateManagerInterface.md) - [StorageDump](interfaces/StorageDump.md) +- [StorageRange](interfaces/StorageRange.md) ### Type Aliases @@ -42,6 +43,7 @@ - [CasperConfig](README.md#casperconfig) - [CliqueConfig](README.md#cliqueconfig) - [EIPConfig](README.md#eipconfig) +- [EIPOrHFConfig](README.md#eiporhfconfig) - [EthashConfig](README.md#ethashconfig) - [HardforkConfig](README.md#hardforkconfig) - [Proof](README.md#proof) @@ -63,7 +65,7 @@ #### Defined in -[interfaces.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L43) +[interfaces.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L66) ___ @@ -73,7 +75,7 @@ ___ #### Defined in -[interfaces.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L42) +[interfaces.ts:65](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L65) ___ @@ -83,7 +85,7 @@ ___ #### Defined in -[interfaces.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L41) +[interfaces.ts:64](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L64) ___ @@ -100,7 +102,7 @@ ___ #### Defined in -[interfaces.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L33) +[interfaces.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L56) ___ @@ -110,7 +112,7 @@ ___ #### Defined in -[interfaces.ts:11](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L11) +[interfaces.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L34) ___ @@ -143,7 +145,7 @@ ___ ### EIPConfig -Ƭ **EIPConfig**: { `minimumHardfork`: [`Hardfork`](enums/Hardfork.md) ; `requiredEIPs`: `number`[] } & `EIPOrHFConfig` +Ƭ **EIPConfig**: { `minimumHardfork`: [`Hardfork`](enums/Hardfork.md) ; `requiredEIPs`: `number`[] } & [`EIPOrHFConfig`](README.md#eiporhfconfig) #### Defined in @@ -151,6 +153,29 @@ ___ ___ +### EIPOrHFConfig + +Ƭ **EIPOrHFConfig**: `Object` + +#### Type declaration + +| Name | Type | +| :------ | :------ | +| `comment` | `string` | +| `gasConfig?` | { `[key: string]`: `ParamDict`; } | +| `gasPrices?` | { `[key: string]`: `ParamDict`; } | +| `pow?` | { `[key: string]`: `ParamDict`; } | +| `sharding?` | { `[key: string]`: `ParamDict`; } | +| `status` | `string` | +| `url` | `string` | +| `vm?` | { `[key: string]`: `ParamDict`; } | + +#### Defined in + +[types.ts:136](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/types.ts#L136) + +___ + ### EthashConfig Ƭ **EthashConfig**: `Object` @@ -163,7 +188,7 @@ ___ ### HardforkConfig -Ƭ **HardforkConfig**: { `consensus?`: `ConsensusConfig` ; `eips?`: `number`[] ; `name`: `string` } & `EIPOrHFConfig` +Ƭ **HardforkConfig**: { `consensus?`: `ConsensusConfig` ; `eips?`: `number`[] ; `name`: `string` } & [`EIPOrHFConfig`](README.md#eiporhfconfig) #### Defined in @@ -189,7 +214,7 @@ ___ #### Defined in -[interfaces.ts:19](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L19) +[interfaces.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L42) ___ @@ -207,7 +232,7 @@ ___ #### Defined in -[interfaces.ts:13](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L13) +[interfaces.ts:36](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L36) ## Variables @@ -219,7 +244,7 @@ GenesisState info about well known ethereum chains #### Defined in -[enums.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L23) +[enums.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L25) ## Functions @@ -265,4 +290,4 @@ parsed params #### Defined in -[utils.ts:199](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/utils.ts#L199) +[utils.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/utils.ts#L205) diff --git a/packages/common/docs/classes/Common.md b/packages/common/docs/classes/Common.md index 13ed2fe046..a280cadbe3 100644 --- a/packages/common/docs/classes/Common.md +++ b/packages/common/docs/classes/Common.md @@ -76,7 +76,7 @@ can be created via the main constructor and the [customChains](../interfaces/Com #### Defined in -[common.ts:223](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L223) +[common.ts:233](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L233) ## Properties @@ -86,7 +86,7 @@ can be created via the main constructor and the [customChains](../interfaces/Com #### Defined in -[common.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L47) +[common.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L54) ___ @@ -96,7 +96,7 @@ ___ #### Defined in -[common.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L56) +[common.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L66) ## Methods @@ -120,7 +120,7 @@ True if HF is active on block number #### Defined in -[common.ts:613](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L613) +[common.ts:700](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L700) ___ @@ -138,7 +138,7 @@ Dict with bootstrap nodes #### Defined in -[common.ts:863](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L863) +[common.ts:950](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L950) ___ @@ -156,7 +156,7 @@ chain Id #### Defined in -[common.ts:887](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L887) +[common.ts:974](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L974) ___ @@ -174,7 +174,7 @@ chain name (lower case) #### Defined in -[common.ts:895](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L895) +[common.ts:982](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L982) ___ @@ -196,7 +196,7 @@ Note: This value can update along a Hardfork. #### Defined in -[common.ts:943](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L943) +[common.ts:1031](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L1031) ___ @@ -222,7 +222,7 @@ Note: This value can update along a Hardfork. #### Defined in -[common.ts:969](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L969) +[common.ts:1057](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L1057) ___ @@ -241,7 +241,7 @@ Note: This value can update along a Hardfork. #### Defined in -[common.ts:921](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L921) +[common.ts:1009](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L1009) ___ @@ -257,7 +257,7 @@ Returns a deep copy of this [Common](Common.md) instance. #### Defined in -[common.ts:990](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L990) +[common.ts:1078](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L1078) ___ @@ -275,7 +275,7 @@ Array of DNS ENR urls #### Defined in -[common.ts:871](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L871) +[common.ts:958](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L958) ___ @@ -299,7 +299,7 @@ Block number or null if unscheduled #### Defined in -[common.ts:676](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L676) +[common.ts:763](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L763) ___ @@ -307,7 +307,8 @@ ___ ▸ **eips**(): `number`[] -Returns the active EIPs +Returns the additionally activated EIPs +(by using the `eips` constructor option) #### Returns @@ -317,7 +318,7 @@ List of EIPs #### Defined in -[common.ts:911](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L911) +[common.ts:999](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L999) ___ @@ -340,7 +341,7 @@ Returns an eth/64 compliant fork hash (EIP-2124) #### Defined in -[common.ts:797](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L797) +[common.ts:884](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L884) ___ @@ -358,7 +359,7 @@ Genesis dictionary #### Defined in -[common.ts:847](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L847) +[common.ts:934](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L934) ___ @@ -387,7 +388,7 @@ The name of the HF #### Defined in -[common.ts:307](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L307) +[common.ts:323](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L323) ___ @@ -411,7 +412,7 @@ True if hardfork set is greater than hardfork provided #### Defined in -[common.ts:644](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L644) +[common.ts:731](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L731) ___ @@ -429,7 +430,7 @@ Hardfork name #### Defined in -[common.ts:879](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L879) +[common.ts:966](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L966) ___ @@ -453,7 +454,7 @@ Block number or null if unscheduled #### Defined in -[common.ts:653](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L653) +[common.ts:740](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L740) ___ @@ -475,7 +476,7 @@ Array with hardfork data (name, block, forkHash) #### Defined in -[common.ts:819](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L819) +[common.ts:906](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L906) ___ @@ -500,7 +501,7 @@ True if HF1 gte HF2 #### Defined in -[common.ts:624](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L624) +[common.ts:711](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L711) ___ @@ -525,7 +526,7 @@ True if HF is active on block number #### Defined in -[common.ts:598](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L598) +[common.ts:685](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L685) ___ @@ -549,7 +550,7 @@ Total difficulty or null if no set #### Defined in -[common.ts:694](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L694) +[common.ts:781](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L781) ___ @@ -569,7 +570,7 @@ ___ #### Defined in -[common.ts:662](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L662) +[common.ts:749](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L749) ___ @@ -587,7 +588,7 @@ Array with arrays of hardforks #### Defined in -[common.ts:855](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L855) +[common.ts:942](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L942) ___ @@ -614,7 +615,7 @@ by the [eips](../interfaces/CommonOpts.md#eips) constructor option #### Defined in -[common.ts:577](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L577) +[common.ts:672](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L672) ___ @@ -632,7 +633,7 @@ network Id #### Defined in -[common.ts:903](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L903) +[common.ts:990](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L990) ___ @@ -656,7 +657,7 @@ Block timestamp, number or null if not available #### Defined in -[common.ts:708](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L708) +[common.ts:795](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L795) ___ @@ -667,7 +668,7 @@ ___ Returns a parameter for the current chain setup If the parameter is present in an EIP, the EIP always takes precedence. -Otherwise the parameter if taken from the latest applied HF with +Otherwise the parameter is taken from the latest applied HF with a change on the respective parameter. #### Parameters @@ -685,7 +686,7 @@ The value requested or `BigInt(0)` if not found #### Defined in -[common.ts:483](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L483) +[common.ts:576](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L576) ___ @@ -714,7 +715,7 @@ The value requested or `BigInt(0)` if not found #### Defined in -[common.ts:557](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L557) +[common.ts:652](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L652) ___ @@ -740,7 +741,7 @@ The value requested or `undefined` if not found #### Defined in -[common.ts:532](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L532) +[common.ts:627](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L627) ___ @@ -766,7 +767,7 @@ The value requested or `BigInt(0)` if not found #### Defined in -[common.ts:501](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L501) +[common.ts:596](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L596) ___ @@ -790,7 +791,7 @@ The dictionary with parameters set as chain #### Defined in -[common.ts:249](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L249) +[common.ts:263](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L263) ___ @@ -812,7 +813,7 @@ Sets the active EIPs #### Defined in -[common.ts:450](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L450) +[common.ts:466](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L466) ___ @@ -834,7 +835,7 @@ Sets any missing forkHashes on the passed-in [Common](Common.md) instance #### Defined in -[common.ts:831](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L831) +[common.ts:918](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L918) ___ @@ -856,7 +857,7 @@ Sets the hardfork to get params for #### Defined in -[common.ts:280](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L280) +[common.ts:294](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L294) ___ @@ -885,7 +886,7 @@ The name of the HF set #### Defined in -[common.ts:427](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L427) +[common.ts:443](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L443) ___ @@ -926,7 +927,7 @@ the `@ethereumjs/tx` library to a Layer-2 chain). #### Defined in -[common.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L82) +[common.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L92) ___ @@ -951,7 +952,7 @@ Common #### Defined in -[common.ts:173](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L173) +[common.ts:183](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L183) ___ @@ -971,7 +972,7 @@ ___ #### Defined in -[common.ts:996](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L996) +[common.ts:1084](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L1084) ___ @@ -995,4 +996,4 @@ boolean #### Defined in -[common.ts:195](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L195) +[common.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/common.ts#L205) diff --git a/packages/common/docs/enums/Chain.md b/packages/common/docs/enums/Chain.md index 07fb5268e2..dbd033969c 100644 --- a/packages/common/docs/enums/Chain.md +++ b/packages/common/docs/enums/Chain.md @@ -7,6 +7,7 @@ ### Enumeration Members - [Goerli](Chain.md#goerli) +- [Holesky](Chain.md#holesky) - [Mainnet](Chain.md#mainnet) - [Sepolia](Chain.md#sepolia) @@ -22,6 +23,16 @@ ___ +### Holesky + +• **Holesky** = ``17000`` + +#### Defined in + +[enums.ts:7](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L7) + +___ + ### Mainnet • **Mainnet** = ``1`` diff --git a/packages/common/docs/enums/ConsensusAlgorithm.md b/packages/common/docs/enums/ConsensusAlgorithm.md index eab4fbf638..cb8ce35b14 100644 --- a/packages/common/docs/enums/ConsensusAlgorithm.md +++ b/packages/common/docs/enums/ConsensusAlgorithm.md @@ -18,7 +18,7 @@ #### Defined in -[enums.ts:68](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L68) +[enums.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L78) ___ @@ -28,7 +28,7 @@ ___ #### Defined in -[enums.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L67) +[enums.ts:77](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L77) ___ @@ -38,4 +38,4 @@ ___ #### Defined in -[enums.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L66) +[enums.ts:76](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L76) diff --git a/packages/common/docs/enums/ConsensusType.md b/packages/common/docs/enums/ConsensusType.md index 18f8a63631..af7deb7b9b 100644 --- a/packages/common/docs/enums/ConsensusType.md +++ b/packages/common/docs/enums/ConsensusType.md @@ -18,7 +18,7 @@ #### Defined in -[enums.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L62) +[enums.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L72) ___ @@ -28,7 +28,7 @@ ___ #### Defined in -[enums.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L60) +[enums.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L70) ___ @@ -38,4 +38,4 @@ ___ #### Defined in -[enums.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L61) +[enums.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L71) diff --git a/packages/common/docs/enums/CustomChain.md b/packages/common/docs/enums/CustomChain.md index f5a91f34d0..e8fe045c1b 100644 --- a/packages/common/docs/enums/CustomChain.md +++ b/packages/common/docs/enums/CustomChain.md @@ -25,7 +25,7 @@ Arbitrum One - mainnet for Arbitrum roll-up #### Defined in -[enums.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L91) +[enums.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L101) ___ @@ -39,7 +39,7 @@ Optimistic Ethereum - mainnet for Optimism roll-up #### Defined in -[enums.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L112) +[enums.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L122) ___ @@ -53,7 +53,7 @@ Optimistic Kovan - testnet for Optimism roll-up #### Defined in -[enums.ts:105](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L105) +[enums.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L115) ___ @@ -67,7 +67,7 @@ Polygon (Matic) Mainnet #### Defined in -[enums.ts:77](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L77) +[enums.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L87) ___ @@ -81,7 +81,7 @@ Polygon (Matic) Mumbai Testnet #### Defined in -[enums.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L84) +[enums.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L94) ___ @@ -95,4 +95,4 @@ xDai EVM sidechain with a native stable token #### Defined in -[enums.ts:98](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L98) +[enums.ts:108](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L108) diff --git a/packages/common/docs/enums/Hardfork.md b/packages/common/docs/enums/Hardfork.md index db5e234fc1..b23a37e20a 100644 --- a/packages/common/docs/enums/Hardfork.md +++ b/packages/common/docs/enums/Hardfork.md @@ -33,7 +33,7 @@ #### Defined in -[enums.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L51) +[enums.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L61) ___ @@ -43,7 +43,7 @@ ___ #### Defined in -[enums.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L49) +[enums.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L59) ___ @@ -53,7 +53,7 @@ ___ #### Defined in -[enums.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L44) +[enums.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L54) ___ @@ -63,7 +63,7 @@ ___ #### Defined in -[enums.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L56) +[enums.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L66) ___ @@ -73,7 +73,7 @@ ___ #### Defined in -[enums.ts:39](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L39) +[enums.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L49) ___ @@ -83,7 +83,7 @@ ___ #### Defined in -[enums.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L45) +[enums.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L55) ___ @@ -93,7 +93,7 @@ ___ #### Defined in -[enums.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L41) +[enums.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L51) ___ @@ -103,7 +103,7 @@ ___ #### Defined in -[enums.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L52) +[enums.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L62) ___ @@ -113,7 +113,7 @@ ___ #### Defined in -[enums.ts:40](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L40) +[enums.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L50) ___ @@ -123,7 +123,7 @@ ___ #### Defined in -[enums.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L47) +[enums.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L57) ___ @@ -133,7 +133,7 @@ ___ #### Defined in -[enums.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L50) +[enums.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L60) ___ @@ -143,7 +143,7 @@ ___ #### Defined in -[enums.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L53) +[enums.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L63) ___ @@ -153,7 +153,7 @@ ___ #### Defined in -[enums.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L48) +[enums.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L58) ___ @@ -163,7 +163,7 @@ ___ #### Defined in -[enums.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L54) +[enums.ts:64](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L64) ___ @@ -173,7 +173,7 @@ ___ #### Defined in -[enums.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L46) +[enums.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L56) ___ @@ -183,7 +183,7 @@ ___ #### Defined in -[enums.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L55) +[enums.ts:65](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L65) ___ @@ -193,7 +193,7 @@ ___ #### Defined in -[enums.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L43) +[enums.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L53) ___ @@ -203,4 +203,4 @@ ___ #### Defined in -[enums.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L42) +[enums.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/enums.ts#L52) diff --git a/packages/common/docs/interfaces/EVMStateManagerInterface.md b/packages/common/docs/interfaces/EVMStateManagerInterface.md index 9388add533..45d4f52172 100644 --- a/packages/common/docs/interfaces/EVMStateManagerInterface.md +++ b/packages/common/docs/interfaces/EVMStateManagerInterface.md @@ -21,6 +21,7 @@ - [commit](EVMStateManagerInterface.md#commit) - [deleteAccount](EVMStateManagerInterface.md#deleteaccount) - [dumpStorage](EVMStateManagerInterface.md#dumpstorage) +- [dumpStorageRange](EVMStateManagerInterface.md#dumpstoragerange) - [generateCanonicalGenesis](EVMStateManagerInterface.md#generatecanonicalgenesis) - [getAccount](EVMStateManagerInterface.md#getaccount) - [getContractCode](EVMStateManagerInterface.md#getcontractcode) @@ -51,7 +52,7 @@ #### Defined in -[interfaces.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L66) +[interfaces.ts:89](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L89) ## Methods @@ -69,7 +70,7 @@ #### Defined in -[interfaces.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L55) +[interfaces.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L78) ___ @@ -93,7 +94,7 @@ ___ #### Defined in -[interfaces.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L54) +[interfaces.ts:77](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L77) ___ @@ -111,7 +112,7 @@ ___ #### Defined in -[interfaces.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L56) +[interfaces.ts:79](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L79) ___ @@ -135,7 +136,7 @@ ___ #### Defined in -[interfaces.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L48) +[interfaces.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L71) ___ @@ -155,7 +156,29 @@ ___ #### Defined in -[interfaces.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L71) +[interfaces.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L94) + +___ + +### dumpStorageRange + +▸ **dumpStorageRange**(`address`, `startKey`, `limit`): `Promise`<[`StorageRange`](StorageRange.md)\> + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `address` | `Address` | +| `startKey` | `bigint` | +| `limit` | `number` | + +#### Returns + +`Promise`<[`StorageRange`](StorageRange.md)\> + +#### Defined in + +[interfaces.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L95) ___ @@ -175,7 +198,7 @@ ___ #### Defined in -[interfaces.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L72) +[interfaces.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L96) ___ @@ -199,7 +222,7 @@ ___ #### Defined in -[interfaces.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L46) +[interfaces.ts:69](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L69) ___ @@ -223,7 +246,7 @@ ___ #### Defined in -[interfaces.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L51) +[interfaces.ts:74](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L74) ___ @@ -248,7 +271,7 @@ ___ #### Defined in -[interfaces.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L52) +[interfaces.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L75) ___ @@ -273,7 +296,7 @@ ___ #### Defined in -[interfaces.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L73) +[interfaces.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L97) ___ @@ -291,7 +314,7 @@ ___ #### Defined in -[interfaces.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L58) +[interfaces.ts:81](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L81) ___ @@ -315,7 +338,7 @@ ___ #### Defined in -[interfaces.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L61) +[interfaces.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L84) ___ @@ -340,7 +363,7 @@ ___ #### Defined in -[interfaces.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L49) +[interfaces.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L72) ___ @@ -365,7 +388,7 @@ ___ #### Defined in -[interfaces.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L47) +[interfaces.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L70) ___ @@ -390,7 +413,7 @@ ___ #### Defined in -[interfaces.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L50) +[interfaces.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L73) ___ @@ -416,7 +439,7 @@ ___ #### Defined in -[interfaces.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L53) +[interfaces.ts:76](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L76) ___ @@ -434,7 +457,7 @@ ___ #### Defined in -[interfaces.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L57) +[interfaces.ts:80](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L80) ___ @@ -459,13 +482,19 @@ ___ #### Defined in -[interfaces.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L59) +[interfaces.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L82) ___ ### shallowCopy -▸ **shallowCopy**(): [`EVMStateManagerInterface`](EVMStateManagerInterface.md) +▸ **shallowCopy**(`downlevelCaches?`): [`EVMStateManagerInterface`](EVMStateManagerInterface.md) + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `downlevelCaches?` | `boolean` | #### Returns @@ -477,4 +506,4 @@ ___ #### Defined in -[interfaces.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L75) +[interfaces.ts:99](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L99) diff --git a/packages/common/docs/interfaces/StateManagerInterface.md b/packages/common/docs/interfaces/StateManagerInterface.md index e827c5ee53..dbd7240d39 100644 --- a/packages/common/docs/interfaces/StateManagerInterface.md +++ b/packages/common/docs/interfaces/StateManagerInterface.md @@ -42,7 +42,7 @@ #### Defined in -[interfaces.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L55) +[interfaces.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L78) ___ @@ -62,7 +62,7 @@ ___ #### Defined in -[interfaces.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L54) +[interfaces.ts:77](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L77) ___ @@ -76,7 +76,7 @@ ___ #### Defined in -[interfaces.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L56) +[interfaces.ts:79](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L79) ___ @@ -96,7 +96,7 @@ ___ #### Defined in -[interfaces.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L48) +[interfaces.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L71) ___ @@ -116,7 +116,7 @@ ___ #### Defined in -[interfaces.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L46) +[interfaces.ts:69](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L69) ___ @@ -136,7 +136,7 @@ ___ #### Defined in -[interfaces.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L51) +[interfaces.ts:74](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L74) ___ @@ -157,7 +157,7 @@ ___ #### Defined in -[interfaces.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L52) +[interfaces.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L75) ___ @@ -178,7 +178,7 @@ ___ #### Defined in -[interfaces.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L60) +[interfaces.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L83) ___ @@ -192,7 +192,7 @@ ___ #### Defined in -[interfaces.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L58) +[interfaces.ts:81](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L81) ___ @@ -212,7 +212,7 @@ ___ #### Defined in -[interfaces.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L61) +[interfaces.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L84) ___ @@ -233,7 +233,7 @@ ___ #### Defined in -[interfaces.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L49) +[interfaces.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L72) ___ @@ -254,7 +254,7 @@ ___ #### Defined in -[interfaces.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L47) +[interfaces.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L70) ___ @@ -275,7 +275,7 @@ ___ #### Defined in -[interfaces.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L50) +[interfaces.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L73) ___ @@ -297,7 +297,7 @@ ___ #### Defined in -[interfaces.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L53) +[interfaces.ts:76](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L76) ___ @@ -311,7 +311,7 @@ ___ #### Defined in -[interfaces.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L57) +[interfaces.ts:80](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L80) ___ @@ -332,13 +332,19 @@ ___ #### Defined in -[interfaces.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L59) +[interfaces.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L82) ___ ### shallowCopy -▸ **shallowCopy**(): [`StateManagerInterface`](StateManagerInterface.md) +▸ **shallowCopy**(`downlevelCaches?`): [`StateManagerInterface`](StateManagerInterface.md) + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `downlevelCaches?` | `boolean` | #### Returns @@ -346,4 +352,4 @@ ___ #### Defined in -[interfaces.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L62) +[interfaces.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L85) diff --git a/packages/common/docs/interfaces/StorageRange.md b/packages/common/docs/interfaces/StorageRange.md new file mode 100644 index 0000000000..c6025a2a34 --- /dev/null +++ b/packages/common/docs/interfaces/StorageRange.md @@ -0,0 +1,44 @@ +[@ethereumjs/common](../README.md) / StorageRange + +# Interface: StorageRange + +Object that can contain a set of storage keys associated with an account. + +## Table of contents + +### Properties + +- [nextKey](StorageRange.md#nextkey) +- [storage](StorageRange.md#storage) + +## Properties + +### nextKey + +• **nextKey**: ``null`` \| `string` + +The next (hashed) storage key after the greatest storage key +contained in `storage`. + +#### Defined in + +[interfaces.ts:31](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L31) + +___ + +### storage + +• **storage**: `Object` + +A dictionary where the keys are hashed storage keys, and the values are +objects containing the preimage of the hashed key (in `key`) and the +storage key (in `value`). Currently, there is no way to retrieve preimages, +so they are always `null`. + +#### Index signature + +▪ [key: `string`]: { `key`: `string` \| ``null`` ; `value`: `string` } + +#### Defined in + +[interfaces.ts:21](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/common/src/interfaces.ts#L21) diff --git a/packages/common/package.json b/packages/common/package.json index 5221fb074d..24a9b87523 100644 --- a/packages/common/package.json +++ b/packages/common/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/common", - "version": "4.0.0", + "version": "4.1.0", "description": "Resources common to all Ethereum implementations", "keywords": [ "ethereum", @@ -55,7 +55,7 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/util": "^9.0.1", "crc": "^4.3.2" } } diff --git a/packages/devp2p/CHANGELOG.md b/packages/devp2p/CHANGELOG.md index 69781584d2..299daf0b50 100644 --- a/packages/devp2p/CHANGELOG.md +++ b/packages/devp2p/CHANGELOG.md @@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 6.0.1 - 2023-10-26 + +- Kademlia bucket add fix, PR [#2957](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2957) +- Performance: only create `DEBUG` msgs if debugging, PR [#2958](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2958) +- Pin `scanf` dependency (fixes broken types), PR [#3060](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3060) +- Minimal `RLPx` test suite, PR [#3126](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3126) + ## 6.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/devp2p/docs/classes/ETH-1.md b/packages/devp2p/docs/classes/ETH-1.md index a636ab6f90..deb4d040a4 100644 --- a/packages/devp2p/docs/classes/ETH-1.md +++ b/packages/devp2p/docs/classes/ETH-1.md @@ -57,7 +57,7 @@ Protocol.constructor #### Defined in -[packages/devp2p/src/protocol/eth.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L33) +[packages/devp2p/src/protocol/eth.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L34) ## Properties @@ -76,7 +76,7 @@ Protocol.constructor #### Defined in -[packages/devp2p/src/protocol/eth.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L52) +[packages/devp2p/src/protocol/eth.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L53) ___ @@ -95,7 +95,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L53) +[packages/devp2p/src/protocol/eth.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L54) ___ @@ -114,7 +114,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L54) +[packages/devp2p/src/protocol/eth.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L55) ___ @@ -133,7 +133,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L55) +[packages/devp2p/src/protocol/eth.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L56) ___ @@ -152,7 +152,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L56) +[packages/devp2p/src/protocol/eth.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L57) ___ @@ -171,7 +171,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L57) +[packages/devp2p/src/protocol/eth.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L58) ___ @@ -190,7 +190,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L58) +[packages/devp2p/src/protocol/eth.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L59) ## Methods @@ -210,7 +210,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:236](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L236) +[packages/devp2p/src/protocol/eth.ts:246](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L246) ___ @@ -230,7 +230,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L244) +[packages/devp2p/src/protocol/eth.ts:254](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L254) ___ @@ -255,7 +255,7 @@ Protocol.\_handleMessage #### Defined in -[packages/devp2p/src/protocol/eth.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L60) +[packages/devp2p/src/protocol/eth.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L61) ___ @@ -269,7 +269,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L174) +[packages/devp2p/src/protocol/eth.ts:184](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L184) ___ @@ -289,7 +289,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:240](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L240) +[packages/devp2p/src/protocol/eth.ts:250](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L250) ___ @@ -311,7 +311,7 @@ Eth 64 Fork ID validation (EIP-2124) #### Defined in -[packages/devp2p/src/protocol/eth.ts:131](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L131) +[packages/devp2p/src/protocol/eth.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L141) ___ @@ -331,7 +331,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:370](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L370) +[packages/devp2p/src/protocol/eth.ts:380](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L380) ___ @@ -345,7 +345,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:232](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L232) +[packages/devp2p/src/protocol/eth.ts:242](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L242) ___ @@ -366,7 +366,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:315](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L315) +[packages/devp2p/src/protocol/eth.ts:325](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L325) ___ @@ -386,4 +386,4 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:264](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L264) +[packages/devp2p/src/protocol/eth.ts:274](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L274) diff --git a/packages/devp2p/docs/enums/ETH.MESSAGE_CODES.md b/packages/devp2p/docs/enums/ETH.MESSAGE_CODES.md index db593f4dc0..1344953058 100644 --- a/packages/devp2p/docs/enums/ETH.MESSAGE_CODES.md +++ b/packages/devp2p/docs/enums/ETH.MESSAGE_CODES.md @@ -32,7 +32,7 @@ #### Defined in -[packages/devp2p/src/protocol/eth.ts:393](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L393) +[packages/devp2p/src/protocol/eth.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L403) ___ @@ -42,7 +42,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:391](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L391) +[packages/devp2p/src/protocol/eth.ts:401](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L401) ___ @@ -52,7 +52,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:392](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L392) +[packages/devp2p/src/protocol/eth.ts:402](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L402) ___ @@ -62,7 +62,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L390) +[packages/devp2p/src/protocol/eth.ts:400](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L400) ___ @@ -72,7 +72,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L397) +[packages/devp2p/src/protocol/eth.ts:407](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L407) ___ @@ -82,7 +82,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:404](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L404) +[packages/devp2p/src/protocol/eth.ts:414](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L414) ___ @@ -92,7 +92,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:399](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L399) +[packages/devp2p/src/protocol/eth.ts:409](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L409) ___ @@ -102,7 +102,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:394](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L394) +[packages/devp2p/src/protocol/eth.ts:404](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L404) ___ @@ -112,7 +112,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:388](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L388) +[packages/devp2p/src/protocol/eth.ts:398](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L398) ___ @@ -122,7 +122,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L403) +[packages/devp2p/src/protocol/eth.ts:413](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L413) ___ @@ -132,7 +132,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:398](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L398) +[packages/devp2p/src/protocol/eth.ts:408](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L408) ___ @@ -142,7 +142,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:405](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L405) +[packages/devp2p/src/protocol/eth.ts:415](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L415) ___ @@ -152,7 +152,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:400](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L400) +[packages/devp2p/src/protocol/eth.ts:410](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L410) ___ @@ -162,7 +162,7 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:387](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L387) +[packages/devp2p/src/protocol/eth.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L397) ___ @@ -172,4 +172,4 @@ ___ #### Defined in -[packages/devp2p/src/protocol/eth.ts:389](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L389) +[packages/devp2p/src/protocol/eth.ts:399](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L399) diff --git a/packages/devp2p/docs/modules/eth.md b/packages/devp2p/docs/modules/eth.md index 1ce05fdaee..b1db41fbd3 100644 --- a/packages/devp2p/docs/modules/eth.md +++ b/packages/devp2p/docs/modules/eth.md @@ -33,4 +33,4 @@ #### Defined in -[packages/devp2p/src/protocol/eth.ts:378](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L378) +[packages/devp2p/src/protocol/eth.ts:388](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/devp2p/src/protocol/eth.ts#L388) diff --git a/packages/devp2p/package.json b/packages/devp2p/package.json index 7f27c33d2c..7b0b7bfe78 100644 --- a/packages/devp2p/package.json +++ b/packages/devp2p/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/devp2p", - "version": "6.0.0", + "version": "6.0.1", "description": "A JavaScript implementation of ÐΞVp2p", "keywords": [ "ethereum", @@ -56,9 +56,9 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "@scure/base": "1.1.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", @@ -68,8 +68,8 @@ "snappyjs": "^0.6.1" }, "devDependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/tx": "^5.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/tx": "^5.1.0", "@types/debug": "^4.1.9", "@types/k-bucket": "^5.0.0", "chalk": "^2.4.2", diff --git a/packages/ethash/CHANGELOG.md b/packages/ethash/CHANGELOG.md index 907917391e..0d466462f1 100644 --- a/packages/ethash/CHANGELOG.md +++ b/packages/ethash/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 3.0.1 - 2023-10-26 + +- Performance: Cache often used BigInt constants, PR [#3050](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3050) + ## 3.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/ethash/package.json b/packages/ethash/package.json index 780be4b12d..ce8d7e36db 100644 --- a/packages/ethash/package.json +++ b/packages/ethash/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/ethash", - "version": "3.0.0", + "version": "3.0.1", "description": "An implementation of the Ethash consensus algorithm in JavaScript", "keywords": [ "ethash", @@ -44,14 +44,14 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "bigint-crypto-utils": "^3.2.2", "ethereum-cryptography": "^2.1.2" }, "devDependencies": { - "@ethereumjs/common": "^4.0.0" + "@ethereumjs/common": "^4.1.0" }, "engines": { "node": ">=18" diff --git a/packages/evm/CHANGELOG.md b/packages/evm/CHANGELOG.md index 1ac6f739bd..f08ef21ac3 100644 --- a/packages/evm/CHANGELOG.md +++ b/packages/evm/CHANGELOG.md @@ -6,6 +6,37 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 2.1.0 - 2023-10-26 + +### New EVM Profiler / EVM Performance + +This releases ships with a completely new dedicated EVM profiler (❤️ to Jochem for the integration) to measure how the different opcode implementations are doing, see PR [#2988](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2988), [#3011](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3011), [#3013](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3013) and [#3041](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3041). + +See the new dedicated [README section](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/README.md#profiling-the-evm) for a detailed usage instruction. + +We were already able to do various performance related improvements using this tool (and we hope that you will be too) 🤩: + +- Substantial stack optimizations (`PUSH` and `POPn` +30-40%, `DUP` +40%), PR [#3000](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3000) +- `JUMPDEST` optimizations, PR [#3000](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3000) +- Various EVM interpreter optimizations (overall 7-15% performance gain), PR [#2996](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2996) +- Memory optimizations (`MLOAD` and `MSTORE` + 10-20%), PR [#3032](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3032) +- Reused BigInts cache, PR [#3034](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3034) and [#3050](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3050) +- `EXP` opcode optimizations (real-world 3x gain, not attack resistant), PR [#3034](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3034) + +### EIP-7516 BLOBBASEFEE Opcode + +This release supports [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) with a new `BLOBBASEFEE` opcode added to and scheduled for the Dencun HF, see PR [#3035](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3035) and [#3068](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3068). The opcode returns the value of the blob base-fee of the current block it is executing in. + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update `EIP-4788`: do not use precompile anymore but use the pre-deployed bytecode, PR [#2955](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2955) + +### Other Changes + +- Add missing `debug` dependency types, PR [#3072](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3072) + ## 2.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/evm/README.md b/packages/evm/README.md index 0b02f6cdee..e09daf88bf 100644 --- a/packages/evm/README.md +++ b/packages/evm/README.md @@ -224,8 +224,10 @@ Currently supported EIPs: - [EIP-4788](https://eips.ethereum.org/EIPS/eip-4788) - Beacon block root in the EVM (Cancun) - [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) - Shard Blob Transactions (Cancun) (`experimental`) - [EIP-4895](https://eips.ethereum.org/EIPS/eip-4895) - Beacon chain push withdrawals as operations (Shanghai) +- [EIP-5133](https://eips.ethereum.org/EIPS/eip-5133) - Delaying Difficulty Bomb to mid-September 2022 (Gray Glacier) - [EIP-5656](https://eips.ethereum.org/EIPS/eip-5656) - MCOPY - Memory copying instruction (Cancun) - [EIP-6780](https://eips.ethereum.org/EIPS/eip-6780) - SELFDESTRUCT only in same transaction (Cancun) +- [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) - BLOBBASEFEE opcode (Cancun) ### EIP-4844 Shard Blob Transactions Support @@ -361,6 +363,40 @@ The opFns for `CREATE`, `CALL`, and `CALLCODE` call back up to `runCall`. TODO: this section likely needs an update. +## Profiling the EVM + +Starting with the `v2.1.0` release the EVM comes with build-in profiling capabilities to detect performance bottlenecks and to generally support the targeted evolution of the JavaScript EVM performance. + +While the EVM now has a dedicated `profiler` setting to activate, the profiler can best and most useful be run through the EthereumJS [client](https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/client) since this gives the most realistic conditions providing both real-world txs and a meaningful state size. + +To repeatedly run the EVM profiler within the client sync the client on mainnet or a larger testnet to the desired block. Then the profiler should be run without sync (to not distort the results) by using the `--executeBlocks` and the `--vmProfileBlocks` (or `--vmProfileTxs`) flags in conjunction like: + +```shell +npm run client:start -- --sync=none --vmProfileBlocks --executeBlocks=962720 +``` + +This will give a profile output like the following: + +![EthereumJS EVM Profiler](./profiler.png?raw=true) + +The `total (ms)` column gives you a good overview what takes the most significant amount of time, to be put in relation with the number of calls. + +The number to optimize for is the `Mgas/s` value. This value indicates how much gas (being a measure for the computational cost for an opcode) can be processed by the second. + +A good measure to putting this relation with is by taking both the Ethereum gas limit (the max amount of "computation" per block) and the time/slot into account. With a gas limit of 30 Mio and a 12 sec slot time this leads to a following (very) minimum `Mgas/s` value: + +```shell +30M / 12 sec = 2.5 Million gas per second +``` + +Note that this is nevertheless a very theoretical value but pretty valuable for some first rough orientation though. + +Another note: profiler results for at least some opcodes are heavily distorted, first to mention the `SSTORE` opcode where the major "cost" occurs after block execution on checkpoint commit, which is not taken into account by the profiler. + +Generally all results should rather encourage and need "self thinking" 😋 and are not suited to be blindedly taken over without a deeper understanding/grasping of the underlying measurement conditions. + +Happy EVM Profiling! 🎉 🤩 + ## Development See [@ethereumjs/vm](https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/vm) README. diff --git a/packages/evm/docs/README.md b/packages/evm/docs/README.md index 2bdb8c53c1..0b366a1419 100644 --- a/packages/evm/docs/README.md +++ b/packages/evm/docs/README.md @@ -43,7 +43,7 @@ Log that the contract emits. #### Defined in -[types.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L319) +[types.ts:329](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L329) ## Variables @@ -84,4 +84,4 @@ Log that the contract emits. #### Defined in -[precompiles/index.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/precompiles/index.ts#L166) +[precompiles/index.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/precompiles/index.ts#L167) diff --git a/packages/evm/docs/classes/Message.md b/packages/evm/docs/classes/Message.md index fee647a6bd..3051551151 100644 --- a/packages/evm/docs/classes/Message.md +++ b/packages/evm/docs/classes/Message.md @@ -12,6 +12,7 @@ - [\_codeAddress](Message.md#_codeaddress) - [authcallOrigin](Message.md#authcallorigin) +- [blobVersionedHashes](Message.md#blobversionedhashes) - [caller](Message.md#caller) - [code](Message.md#code) - [containerCode](Message.md#containercode) @@ -27,7 +28,6 @@ - [selfdestruct](Message.md#selfdestruct) - [to](Message.md#to) - [value](Message.md#value) -- [versionedHashes](Message.md#versionedhashes) ### Accessors @@ -74,6 +74,18 @@ the purpose is to figure out where `value` should be taken from (not from `calle ___ +### blobVersionedHashes + +• `Optional` **blobVersionedHashes**: `Uint8Array`[] + +List of versioned hashes if message is a blob transaction in the outer VM + +#### Defined in + +[message.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/message.ts#L73) + +___ + ### caller • **caller**: `Address` @@ -226,18 +238,6 @@ ___ [message.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/message.ts#L44) -___ - -### versionedHashes - -• `Optional` **versionedHashes**: `Uint8Array`[] - -List of versioned hashes if message is a blob transaction in the outer VM - -#### Defined in - -[message.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/message.ts#L73) - ## Accessors ### codeAddress diff --git a/packages/evm/docs/interfaces/EVMResult.md b/packages/evm/docs/interfaces/EVMResult.md index a51b656b58..e8986cfcbd 100644 --- a/packages/evm/docs/interfaces/EVMResult.md +++ b/packages/evm/docs/interfaces/EVMResult.md @@ -21,7 +21,7 @@ Address of created account during transaction, if any #### Defined in -[types.ts:266](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L266) +[types.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L276) ___ @@ -33,4 +33,4 @@ Contains the results from running the code, if any, as described in runCode #### Defined in -[types.ts:270](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L270) +[types.ts:280](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L280) diff --git a/packages/evm/docs/interfaces/ExecResult.md b/packages/evm/docs/interfaces/ExecResult.md index 4e910878b8..3d939f35de 100644 --- a/packages/evm/docs/interfaces/ExecResult.md +++ b/packages/evm/docs/interfaces/ExecResult.md @@ -29,7 +29,7 @@ Amount of blob gas consumed by the transaction #### Defined in -[types.ts:313](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L313) +[types.ts:323](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L323) ___ @@ -41,7 +41,7 @@ Map of addresses which were created (used in EIP 6780) #### Defined in -[types.ts:305](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L305) +[types.ts:315](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L315) ___ @@ -53,7 +53,7 @@ Description of the exception, if any occurred #### Defined in -[types.ts:281](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L281) +[types.ts:291](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L291) ___ @@ -65,7 +65,7 @@ Amount of gas the code used to run #### Defined in -[types.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L289) +[types.ts:299](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L299) ___ @@ -77,7 +77,7 @@ Amount of gas left #### Defined in -[types.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L285) +[types.ts:295](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L295) ___ @@ -89,7 +89,7 @@ The gas refund counter #### Defined in -[types.ts:309](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L309) +[types.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L319) ___ @@ -101,7 +101,7 @@ Array of logs that the contract emitted #### Defined in -[types.ts:297](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L297) +[types.ts:307](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L307) ___ @@ -113,7 +113,7 @@ Return value from the contract #### Defined in -[types.ts:293](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L293) +[types.ts:303](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L303) ___ @@ -123,7 +123,7 @@ ___ #### Defined in -[types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L277) +[types.ts:287](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L287) ___ @@ -135,4 +135,4 @@ A set of accounts to selfdestruct #### Defined in -[types.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L301) +[types.ts:311](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/types.ts#L311) diff --git a/packages/evm/docs/interfaces/InterpreterStep.md b/packages/evm/docs/interfaces/InterpreterStep.md index d80038b37b..e9507d2aca 100644 --- a/packages/evm/docs/interfaces/InterpreterStep.md +++ b/packages/evm/docs/interfaces/InterpreterStep.md @@ -28,7 +28,7 @@ #### Defined in -[interpreter.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L102) +[interpreter.ts:114](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L114) ___ @@ -38,7 +38,7 @@ ___ #### Defined in -[interpreter.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L103) +[interpreter.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L115) ___ @@ -48,7 +48,7 @@ ___ #### Defined in -[interpreter.ts:106](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L106) +[interpreter.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L118) ___ @@ -58,7 +58,7 @@ ___ #### Defined in -[interpreter.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L95) +[interpreter.ts:107](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L107) ___ @@ -68,7 +68,7 @@ ___ #### Defined in -[interpreter.ts:89](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L89) +[interpreter.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L101) ___ @@ -78,7 +78,7 @@ ___ #### Defined in -[interpreter.ts:90](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L90) +[interpreter.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L102) ___ @@ -88,7 +88,7 @@ ___ #### Defined in -[interpreter.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L104) +[interpreter.ts:116](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L116) ___ @@ -98,7 +98,7 @@ ___ #### Defined in -[interpreter.ts:105](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L105) +[interpreter.ts:117](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L117) ___ @@ -117,7 +117,7 @@ ___ #### Defined in -[interpreter.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L96) +[interpreter.ts:108](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L108) ___ @@ -127,7 +127,7 @@ ___ #### Defined in -[interpreter.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L94) +[interpreter.ts:106](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L106) ___ @@ -137,7 +137,7 @@ ___ #### Defined in -[interpreter.ts:93](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L93) +[interpreter.ts:105](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L105) ___ @@ -147,7 +147,7 @@ ___ #### Defined in -[interpreter.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L92) +[interpreter.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L104) ___ @@ -157,4 +157,4 @@ ___ #### Defined in -[interpreter.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L91) +[interpreter.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/src/interpreter.ts#L103) diff --git a/packages/evm/package.json b/packages/evm/package.json index ed880e3743..c7e5ba2f9e 100644 --- a/packages/evm/package.json +++ b/packages/evm/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/evm", - "version": "2.0.0", + "version": "2.1.0", "description": "JavaScript Ethereum Virtual Machine (EVM) implementation", "keywords": [ "ethereum", @@ -52,10 +52,10 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/statemanager": "^2.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/statemanager": "^2.1.0", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "@types/debug": "^4.1.9", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", diff --git a/packages/evm/profiler.png b/packages/evm/profiler.png new file mode 100644 index 0000000000..d94aa42c50 Binary files /dev/null and b/packages/evm/profiler.png differ diff --git a/packages/evm/src/types.ts b/packages/evm/src/types.ts index 00013e3de1..e330fb4a89 100644 --- a/packages/evm/src/types.ts +++ b/packages/evm/src/types.ts @@ -197,8 +197,10 @@ export interface EVMOpts { * - [EIP-4788](https://eips.ethereum.org/EIPS/eip-4788) - Beacon block root in the EVM (Cancun) * - [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) - Shard Blob Transactions (Cancun) (`experimental`) * - [EIP-4895](https://eips.ethereum.org/EIPS/eip-4895) - Beacon chain push withdrawals as operations (Shanghai) + * - [EIP-5133](https://eips.ethereum.org/EIPS/eip-5133) - Delaying Difficulty Bomb to mid-September 2022 (Gray Glacier) * - [EIP-5656](https://eips.ethereum.org/EIPS/eip-5656) - MCOPY - Memory copying instruction (Cancun) * - [EIP-6780](https://eips.ethereum.org/EIPS/eip-6780) - SELFDESTRUCT only in same transaction (Cancun) + * - [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) - BLOBBASEFEE opcode (Cancun) * * *Annotations:* * diff --git a/packages/genesis/CHANGELOG.md b/packages/genesis/CHANGELOG.md index 5d963e38bf..a1152ca311 100644 --- a/packages/genesis/CHANGELOG.md +++ b/packages/genesis/CHANGELOG.md @@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 0.2.0 - 2023-10-26 + +### Holesky Testnet Support + +This release comes with full support for the [Holesky](https://holesky.ethpandaops.io/) public Ethereum testnet replacing the `Goerli` test network. + +- Add Holesky genesis specification, PR [2982](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2982), [#2989](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2989), [#2997](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2997), [#3049](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3049), [#3074](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3074) and [#3088](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3088) + +### Other Changes + +- Package CI integration, PR [#3098](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3098) + ## 0.1.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/genesis/package.json b/packages/genesis/package.json index 3c1bae310e..bbd4ecc4d9 100644 --- a/packages/genesis/package.json +++ b/packages/genesis/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/genesis", - "version": "0.1.0", + "version": "0.2.0", "description": "A module to provide genesis states of well known networks", "keywords": [ "ethereum", @@ -56,13 +56,13 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/util": "^9.0.0" + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/util": "^9.0.1" }, "engines": { "node": ">=18" }, "devDependencies": { - "@ethereumjs/trie": "^6.0.0" + "@ethereumjs/trie": "^6.0.1" } } diff --git a/packages/rlp/CHANGELOG.md b/packages/rlp/CHANGELOG.md index 3d03022242..edfb580d01 100644 --- a/packages/rlp/CHANGELOG.md +++ b/packages/rlp/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 5.0.1 - 2023-10-26 + +- Fixes the RLP CLI, PR [#3007](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3007) + ## 5.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/rlp/README.md b/packages/rlp/README.md index bed2fbd362..811d71c355 100644 --- a/packages/rlp/README.md +++ b/packages/rlp/README.md @@ -60,7 +60,7 @@ const decodedAsBuffers = arrToBufArr(decoded) assert.deepEqual(bufferList, decodedAsBuffers) ``` -### Buffer -> Uint8Arrayy +### Buffer -> Uint8Array With the breaking releases from Summer 2023 we have removed all Node.js specific `Buffer` usages from our libraries and replace these with [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) representations, which are available both in Node.js and the browser (`Buffer` is a subclass of `Uint8Array`). diff --git a/packages/rlp/package.json b/packages/rlp/package.json index 7d5f9f03b7..c6591fee01 100644 --- a/packages/rlp/package.json +++ b/packages/rlp/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/rlp", - "version": "5.0.0", + "version": "5.0.1", "description": "Recursive Length Prefix Encoding Module", "keywords": [ "rlp", diff --git a/packages/statemanager/CHANGELOG.md b/packages/statemanager/CHANGELOG.md index 78abf80dd3..eb1f2b5464 100644 --- a/packages/statemanager/CHANGELOG.md +++ b/packages/statemanager/CHANGELOG.md @@ -6,6 +6,30 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 2.1.0 - 2023-10-23 + +### New Diff-Based Code Cache + +This release introduces a new code cache implementation, see PR [#3022](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3022) and [#3080](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3080). The new cache complements the expanded account and storage caches and now also tracks stored/deployed-code-changes along commits and reverts and so only keeps code in the cache which made it to the final state change. + +The new cache is substantially more robust towards various type of revert-based attacks and grows a more-used cache over time, since never-applied values are consecutively sorted out. + +### Peformance Option to store Storage Keys with Prefix + +This release introduces a new option `prefixStorageTrieKeys` which triggers the underlying trie to store storage key values with a prefix based on the account address, see PR [#3023](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3023). This significantly increases performance for consecutive storage accesses for the same account on especially larger tries, since trie node accesses get noticeably faster when performed by the underlying key-value store since values are stored close to each other. + +While this option is deactivated by default it is recommended for most use cases for it to be activated. Note that this option is not backwards-compatible with existing databases and therefore can't be used if access to existing DBs needs to be guaranteed. + +### Bugfixes + +- Fix for `dumpStorage()` for `EthersStateManager`, PR [#3009](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3009) + +### Other Changes + +- Allow for users to decide if to either downlevel (so: adopt them for a short-lived scenario) caches or not on `shallowCopy()` by adding a new `downlevelCaches` parameter (default: `true`), PR [#3063](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3063) +- Return zero values for `getProof()` as `0x0`, PR [#3038](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3038) +- Deactivate storage/account caches for cache size 0, PR [#3012](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3012) + ## 2.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/statemanager/README.md b/packages/statemanager/README.md index 43a29a8d3f..ba422a68d8 100644 --- a/packages/statemanager/README.md +++ b/packages/statemanager/README.md @@ -45,9 +45,9 @@ await stateManager.commit() await stateManager.flush() ``` -### Account and Storage Caches +### Account, Storage and Code Caches -Starting with the v2 release the StateManager comes with a significantly more elaborate caching mechanism for account and storage caches. +Starting with the v2 release and complemented by the v2.1 release the StateManager comes with a significantly more elaborate caching mechanism for account, storage and code caches. There are now two cache options available: an unbounded cache (`CacheType.ORDERED_MAP`) for short-lived usage scenarios (this one is the default cache) and a fixed-size cache (`CacheType.LRU`) for a long-lived large cache scenario. diff --git a/packages/statemanager/docs/README.md b/packages/statemanager/docs/README.md index ad44bbc825..32060346d8 100644 --- a/packages/statemanager/docs/README.md +++ b/packages/statemanager/docs/README.md @@ -11,6 +11,7 @@ ### Classes - [AccountCache](classes/AccountCache.md) +- [CodeCache](classes/CodeCache.md) - [DefaultStateManager](classes/DefaultStateManager.md) - [EthersStateManager](classes/EthersStateManager.md) - [StorageCache](classes/StorageCache.md) @@ -50,7 +51,7 @@ #### Defined in -[stateManager.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L41) +[stateManager.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L43) ___ @@ -68,7 +69,7 @@ ___ #### Defined in -[stateManager.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L35) +[stateManager.ts:37](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L37) ## Variables @@ -85,4 +86,4 @@ misbehaviour in the underlying trie library. #### Defined in -[stateManager.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L102) +[stateManager.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L104) diff --git a/packages/statemanager/docs/classes/CodeCache.md b/packages/statemanager/docs/classes/CodeCache.md new file mode 100644 index 0000000000..ac047c287e --- /dev/null +++ b/packages/statemanager/docs/classes/CodeCache.md @@ -0,0 +1,359 @@ +[@ethereumjs/statemanager](../README.md) / CodeCache + +# Class: CodeCache + +## Hierarchy + +- `Cache` + + ↳ **`CodeCache`** + +## Table of contents + +### Constructors + +- [constructor](CodeCache.md#constructor) + +### Properties + +- [\_checkpoints](CodeCache.md#_checkpoints) +- [\_debug](CodeCache.md#_debug) +- [\_diffCache](CodeCache.md#_diffcache) +- [\_lruCache](CodeCache.md#_lrucache) +- [\_orderedMapCache](CodeCache.md#_orderedmapcache) +- [\_stats](CodeCache.md#_stats) + +### Methods + +- [\_saveCachePreState](CodeCache.md#_savecacheprestate) +- [checkpoint](CodeCache.md#checkpoint) +- [clear](CodeCache.md#clear) +- [commit](CodeCache.md#commit) +- [del](CodeCache.md#del) +- [flush](CodeCache.md#flush) +- [get](CodeCache.md#get) +- [put](CodeCache.md#put) +- [revert](CodeCache.md#revert) +- [size](CodeCache.md#size) +- [stats](CodeCache.md#stats) + +## Constructors + +### constructor + +• **new CodeCache**(`opts`) + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `opts` | [`CacheOpts`](../interfaces/CacheOpts.md) | + +#### Overrides + +Cache.constructor + +#### Defined in + +[cache/code.ts:36](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L36) + +## Properties + +### \_checkpoints + +• **\_checkpoints**: `number` = `0` + +#### Inherited from + +Cache.\_checkpoints + +#### Defined in + +[cache/cache.ts:9](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/cache.ts#L9) + +___ + +### \_debug + +• **\_debug**: `Debugger` + +#### Inherited from + +Cache.\_debug + +#### Defined in + +[cache/cache.ts:7](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/cache.ts#L7) + +___ + +### \_diffCache + +• **\_diffCache**: `Map`<`string`, `undefined` \| `CodeCacheElement`\>[] = `[]` + +Diff cache collecting the state of the cache +at the beginning of checkpoint height +(respectively: before a first modification) + +If the whole cache element is undefined (in contrast +to the code), the element didn't exist in the cache +before. + +#### Defined in + +[cache/code.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L34) + +___ + +### \_lruCache + +• **\_lruCache**: `undefined` \| `LRUCache`<`string`, `CodeCacheElement`, `unknown`\> + +#### Defined in + +[cache/code.ts:22](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L22) + +___ + +### \_orderedMapCache + +• **\_orderedMapCache**: `undefined` \| `OrderedMap`<`string`, `CodeCacheElement`\> + +#### Defined in + +[cache/code.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L23) + +___ + +### \_stats + +• **\_stats**: `Object` + +#### Type declaration + +| Name | Type | +| :------ | :------ | +| `dels` | `number` | +| `hits` | `number` | +| `reads` | `number` | +| `size` | `number` | +| `writes` | `number` | + +#### Inherited from + +Cache.\_stats + +#### Defined in + +[cache/cache.ts:11](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/cache.ts#L11) + +## Methods + +### \_saveCachePreState + +▸ **_saveCachePreState**(`cacheKeyHex`): `void` + +Saves the state of the code cache before making changes to it. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `cacheKeyHex` | `string` | Account key for which code is being modified. | + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L56) + +___ + +### checkpoint + +▸ **checkpoint**(): `void` + +Marks the current state of the cache as a checkpoint, which can +later be reverted or committed. + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:222](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L222) + +___ + +### clear + +▸ **clear**(): `void` + +Clears the cache. + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:266](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L266) + +___ + +### commit + +▸ **commit**(): `void` + +Commits the current state of the cache (no effect on trie). + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:202](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L202) + +___ + +### del + +▸ **del**(`address`): `void` + +Marks code as deleted in the cache. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `address` | `Address` | Account address for which code is being fetched. | + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L122) + +___ + +### flush + +▸ **flush**(): [`string`, `CodeCacheElement`][] + +Flushes the cache by returning codes that have been modified +or deleted and resetting the diff cache (at checkpoint height). + +#### Returns + +[`string`, `CodeCacheElement`][] + +#### Defined in + +[cache/code.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L145) + +___ + +### get + +▸ **get**(`address`): `undefined` \| `CodeCacheElement` + +Returns the queried code or undefined if it doesn't exist. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `address` | `Address` | Account address for which code is being fetched. | + +#### Returns + +`undefined` \| `CodeCacheElement` + +#### Defined in + +[cache/code.ts:98](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L98) + +___ + +### put + +▸ **put**(`address`, `code`): `void` + +Puts code into the cache under its hash. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `address` | `Address` | Address of account code is being modified for. | +| `code` | `undefined` \| `Uint8Array` | Bytecode or undefined if code doesn't exist. | + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L75) + +___ + +### revert + +▸ **revert**(): `void` + +Revert changes to the cache to the last checkpoint (no effect on trie). + +#### Returns + +`void` + +#### Defined in + +[cache/code.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L174) + +___ + +### size + +▸ **size**(): `number` + +Returns the size of the cache + +#### Returns + +`number` + +#### Defined in + +[cache/code.ts:234](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L234) + +___ + +### stats + +▸ **stats**(`reset?`): `any` + +Returns a dictionary with cache statistics. + +#### Parameters + +| Name | Type | Default value | Description | +| :------ | :------ | :------ | :------ | +| `reset` | `boolean` | `true` | Whether to reset statistics after retrieval. | + +#### Returns + +`any` + +A dictionary with cache statistics. + +#### Defined in + +[cache/code.ts:248](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/code.ts#L248) diff --git a/packages/statemanager/docs/classes/DefaultStateManager.md b/packages/statemanager/docs/classes/DefaultStateManager.md index d02c155e18..9402e63b36 100644 --- a/packages/statemanager/docs/classes/DefaultStateManager.md +++ b/packages/statemanager/docs/classes/DefaultStateManager.md @@ -34,6 +34,7 @@ The default state manager implementation uses a - [commit](DefaultStateManager.md#commit) - [deleteAccount](DefaultStateManager.md#deleteaccount) - [dumpStorage](DefaultStateManager.md#dumpstorage) +- [dumpStorageRange](DefaultStateManager.md#dumpstoragerange) - [flush](DefaultStateManager.md#flush) - [generateCanonicalGenesis](DefaultStateManager.md#generatecanonicalgenesis) - [getAccount](DefaultStateManager.md#getaccount) @@ -67,7 +68,7 @@ Instantiate the StateManager interface. #### Defined in -[stateManager.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L174) +[stateManager.ts:192](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L192) ## Properties @@ -77,7 +78,7 @@ Instantiate the StateManager interface. #### Defined in -[stateManager.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L155) +[stateManager.ts:173](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L173) ___ @@ -91,7 +92,7 @@ EVMStateManagerInterface.originalStorageCache #### Defined in -[stateManager.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L145) +[stateManager.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L162) ## Methods @@ -113,7 +114,7 @@ EVMStateManagerInterface.checkpoint #### Defined in -[stateManager.ts:528](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L528) +[stateManager.ts:584](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L584) ___ @@ -129,7 +130,7 @@ Clears all underlying caches #### Defined in -[stateManager.ts:885](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L885) +[stateManager.ts:1047](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L1047) ___ @@ -155,7 +156,7 @@ EVMStateManagerInterface.clearContractStorage #### Defined in -[stateManager.ts:511](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L511) +[stateManager.ts:567](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L567) ___ @@ -176,7 +177,7 @@ EVMStateManagerInterface.commit #### Defined in -[stateManager.ts:539](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L539) +[stateManager.ts:596](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L596) ___ @@ -202,7 +203,7 @@ EVMStateManagerInterface.deleteAccount #### Defined in -[stateManager.ts:299](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L299) +[stateManager.ts:333](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L333) ___ @@ -232,7 +233,39 @@ EVMStateManagerInterface.dumpStorage #### Defined in -[stateManager.ts:778](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L778) +[stateManager.ts:861](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L861) + +___ + +### dumpStorageRange + +▸ **dumpStorageRange**(`address`, `startKey`, `limit`): `Promise`<`StorageRange`\> + +Dumps a limited number of RLP-encoded storage values for an account specified by `address`, +starting from `startKey` or greater. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `address` | `Address` | The address of the `account` to return storage for. | +| `startKey` | `bigint` | The bigint representation of the smallest storage key that will be returned. | +| `limit` | `number` | The maximum number of storage values that will be returned. | + +#### Returns + +`Promise`<`StorageRange`\> + +- A StorageRange object that will contain at most `limit` entries in its `storage` field. +The object will also contain `nextKey`, the next (hashed) storage key after the range included in `storage`. + +#### Implementation of + +EVMStateManagerInterface.dumpStorageRange + +#### Defined in + +[stateManager.ts:894](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L894) ___ @@ -248,7 +281,7 @@ Writes all cache items to the trie #### Defined in -[stateManager.ts:579](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L579) +[stateManager.ts:638](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L638) ___ @@ -275,7 +308,7 @@ EVMStateManagerInterface.generateCanonicalGenesis #### Defined in -[stateManager.ts:809](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L809) +[stateManager.ts:950](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L950) ___ @@ -301,7 +334,7 @@ EVMStateManagerInterface.getAccount #### Defined in -[stateManager.ts:226](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L226) +[stateManager.ts:260](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L260) ___ @@ -330,7 +363,7 @@ EVMStateManagerInterface.getContractCode #### Defined in -[stateManager.ts:347](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L347) +[stateManager.ts:379](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L379) ___ @@ -362,7 +395,7 @@ EVMStateManagerInterface.getContractStorage #### Defined in -[stateManager.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L397) +[stateManager.ts:453](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L453) ___ @@ -389,7 +422,7 @@ EVMStateManagerInterface.getProof #### Defined in -[stateManager.ts:617](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L617) +[stateManager.ts:698](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L698) ___ @@ -413,7 +446,7 @@ EVMStateManagerInterface.getStateRoot #### Defined in -[stateManager.ts:738](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L738) +[stateManager.ts:819](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L819) ___ @@ -439,7 +472,7 @@ EVMStateManagerInterface.hasStateRoot #### Defined in -[stateManager.ts:845](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L845) +[stateManager.ts:986](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L986) ___ @@ -468,7 +501,7 @@ EVMStateManagerInterface.modifyAccountFields #### Defined in -[stateManager.ts:283](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L283) +[stateManager.ts:317](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L317) ___ @@ -495,7 +528,7 @@ EVMStateManagerInterface.putAccount #### Defined in -[stateManager.ts:250](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L250) +[stateManager.ts:284](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L284) ___ @@ -523,7 +556,7 @@ EVMStateManagerInterface.putContractCode #### Defined in -[stateManager.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L319) +[stateManager.ts:356](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L356) ___ @@ -552,7 +585,7 @@ EVMStateManagerInterface.putContractStorage #### Defined in -[stateManager.ts:484](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L484) +[stateManager.ts:540](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L540) ___ @@ -573,7 +606,7 @@ EVMStateManagerInterface.revert #### Defined in -[stateManager.ts:560](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L560) +[stateManager.ts:618](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L618) ___ @@ -603,25 +636,40 @@ EVMStateManagerInterface.setStateRoot #### Defined in -[stateManager.ts:750](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L750) +[stateManager.ts:831](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L831) ___ ### shallowCopy -▸ **shallowCopy**(): [`DefaultStateManager`](DefaultStateManager.md) +▸ **shallowCopy**(`downlevelCaches?`): [`DefaultStateManager`](DefaultStateManager.md) Copies the current instance of the `StateManager` at the last fully committed point, i.e. as if all current checkpoints were reverted. -Note on caches: +Caches are downleveled (so: adopted for short-term usage) +by default. + +This means in particular: 1. For caches instantiated as an LRU cache type the copy() method will instantiate with an ORDERED_MAP cache instead, since copied instantances are mostly used in short-term usage contexts and LRU cache instantation would create a large overhead here. -2. Cache values are generally not copied along +2. The underlying trie object is initialized with 0 cache size + +Both adoptions can be deactivated by setting `downlevelCaches` to +`false`. + +Cache values are generally not copied along regardless of the +`downlevelCaches` setting. + +#### Parameters + +| Name | Type | Default value | +| :------ | :------ | :------ | +| `downlevelCaches` | `boolean` | `true` | #### Returns @@ -633,7 +681,7 @@ EVMStateManagerInterface.shallowCopy #### Defined in -[stateManager.ts:862](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L862) +[stateManager.ts:1012](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L1012) ___ @@ -655,4 +703,4 @@ Verify an EIP-1186 proof. Throws if proof is invalid, otherwise returns true. #### Defined in -[stateManager.ts:665](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L665) +[stateManager.ts:746](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L746) diff --git a/packages/statemanager/docs/classes/EthersStateManager.md b/packages/statemanager/docs/classes/EthersStateManager.md index e16cda6264..045ac8c890 100644 --- a/packages/statemanager/docs/classes/EthersStateManager.md +++ b/packages/statemanager/docs/classes/EthersStateManager.md @@ -25,6 +25,7 @@ - [commit](EthersStateManager.md#commit) - [deleteAccount](EthersStateManager.md#deleteaccount) - [dumpStorage](EthersStateManager.md#dumpstorage) +- [dumpStorageRange](EthersStateManager.md#dumpstoragerange) - [flush](EthersStateManager.md#flush) - [generateCanonicalGenesis](EthersStateManager.md#generatecanonicalgenesis) - [getAccount](EthersStateManager.md#getaccount) @@ -56,7 +57,7 @@ #### Defined in -[ethersStateManager.ts:30](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L30) +[ethersStateManager.ts:31](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L31) ## Properties @@ -70,7 +71,7 @@ EVMStateManagerInterface.originalStorageCache #### Defined in -[ethersStateManager.ts:27](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L27) +[ethersStateManager.ts:28](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L28) ## Methods @@ -92,7 +93,7 @@ Checks if an `account` exists at `address` #### Defined in -[ethersStateManager.ts:198](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L198) +[ethersStateManager.ts:204](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L204) ___ @@ -116,7 +117,7 @@ EVMStateManagerInterface.checkpoint #### Defined in -[ethersStateManager.ts:348](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L348) +[ethersStateManager.ts:354](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L354) ___ @@ -133,7 +134,7 @@ initially be retrieved from the provider #### Defined in -[ethersStateManager.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L91) +[ethersStateManager.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L92) ___ @@ -159,7 +160,7 @@ EVMStateManagerInterface.clearContractStorage #### Defined in -[ethersStateManager.ts:172](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L172) +[ethersStateManager.ts:173](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L173) ___ @@ -182,7 +183,7 @@ EVMStateManagerInterface.commit #### Defined in -[ethersStateManager.ts:359](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L359) +[ethersStateManager.ts:365](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L365) ___ @@ -208,7 +209,7 @@ EVMStateManagerInterface.deleteAccount #### Defined in -[ethersStateManager.ts:317](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L317) +[ethersStateManager.ts:323](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L323) ___ @@ -238,7 +239,33 @@ EVMStateManagerInterface.dumpStorage #### Defined in -[ethersStateManager.ts:183](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L183) +[ethersStateManager.ts:184](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L184) + +___ + +### dumpStorageRange + +▸ **dumpStorageRange**(`_address`, `_startKey`, `_limit`): `Promise`<`StorageRange`\> + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `_address` | `Address` | +| `_startKey` | `bigint` | +| `_limit` | `number` | + +#### Returns + +`Promise`<`StorageRange`\> + +#### Implementation of + +EVMStateManagerInterface.dumpStorageRange + +#### Defined in + +[ethersStateManager.ts:195](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L195) ___ @@ -252,7 +279,7 @@ ___ #### Defined in -[ethersStateManager.ts:376](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L376) +[ethersStateManager.ts:382](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L382) ___ @@ -276,7 +303,7 @@ EVMStateManagerInterface.generateCanonicalGenesis #### Defined in -[ethersStateManager.ts:399](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L399) +[ethersStateManager.ts:405](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L405) ___ @@ -305,7 +332,7 @@ EVMStateManagerInterface.getAccount #### Defined in -[ethersStateManager.ts:224](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L224) +[ethersStateManager.ts:230](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L230) ___ @@ -334,7 +361,7 @@ EVMStateManagerInterface.getContractCode #### Defined in -[ethersStateManager.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L103) +[ethersStateManager.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L104) ___ @@ -366,7 +393,7 @@ EVMStateManagerInterface.getContractStorage #### Defined in -[ethersStateManager.ts:132](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L132) +[ethersStateManager.ts:133](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L133) ___ @@ -395,7 +422,7 @@ EVMStateManagerInterface.getProof #### Defined in -[ethersStateManager.ts:330](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L330) +[ethersStateManager.ts:336](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L336) ___ @@ -417,7 +444,7 @@ EVMStateManagerInterface.getStateRoot #### Defined in -[ethersStateManager.ts:383](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L383) +[ethersStateManager.ts:389](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L389) ___ @@ -439,7 +466,7 @@ EVMStateManagerInterface.hasStateRoot #### Defined in -[ethersStateManager.ts:395](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L395) +[ethersStateManager.ts:401](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L401) ___ @@ -468,7 +495,7 @@ EVMStateManagerInterface.modifyAccountFields #### Defined in -[ethersStateManager.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L288) +[ethersStateManager.ts:294](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L294) ___ @@ -495,7 +522,7 @@ EVMStateManagerInterface.putAccount #### Defined in -[ethersStateManager.ts:264](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L264) +[ethersStateManager.ts:270](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L270) ___ @@ -523,7 +550,7 @@ EVMStateManagerInterface.putContractCode #### Defined in -[ethersStateManager.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L118) +[ethersStateManager.ts:119](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L119) ___ @@ -552,7 +579,7 @@ EVMStateManagerInterface.putContractStorage #### Defined in -[ethersStateManager.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L164) +[ethersStateManager.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L165) ___ @@ -575,7 +602,7 @@ EVMStateManagerInterface.revert #### Defined in -[ethersStateManager.ts:370](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L370) +[ethersStateManager.ts:376](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L376) ___ @@ -598,7 +625,7 @@ internal cache. #### Defined in -[ethersStateManager.ts:81](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L81) +[ethersStateManager.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L82) ___ @@ -626,7 +653,7 @@ EVMStateManagerInterface.setStateRoot #### Defined in -[ethersStateManager.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L390) +[ethersStateManager.ts:396](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L396) ___ @@ -648,4 +675,4 @@ EVMStateManagerInterface.shallowCopy #### Defined in -[ethersStateManager.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L59) +[ethersStateManager.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L60) diff --git a/packages/statemanager/docs/classes/StorageCache.md b/packages/statemanager/docs/classes/StorageCache.md index ef5690fd22..10139ce949 100644 --- a/packages/statemanager/docs/classes/StorageCache.md +++ b/packages/statemanager/docs/classes/StorageCache.md @@ -31,6 +31,7 @@ - [clearContractStorage](StorageCache.md#clearcontractstorage) - [commit](StorageCache.md#commit) - [del](StorageCache.md#del) +- [dump](StorageCache.md#dump) - [flush](StorageCache.md#flush) - [get](StorageCache.md#get) - [put](StorageCache.md#put) @@ -184,7 +185,7 @@ later on be reverted or committed. #### Defined in -[cache/storage.ts:305](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L305) +[cache/storage.ts:300](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L300) ___ @@ -200,7 +201,7 @@ Clears cache. #### Defined in -[cache/storage.ts:347](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L347) +[cache/storage.ts:342](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L342) ___ @@ -222,7 +223,7 @@ Deletes all storage slots for address from the cache #### Defined in -[cache/storage.ts:181](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L181) +[cache/storage.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L176) ___ @@ -238,7 +239,7 @@ Commits to current state of cache (no effect on trie). #### Defined in -[cache/storage.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L272) +[cache/storage.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L267) ___ @@ -261,7 +262,31 @@ Marks storage key for address as deleted in cache. #### Defined in -[cache/storage.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L151) +[cache/storage.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L146) + +___ + +### dump + +▸ **dump**(`address`): `undefined` \| `StorageCacheMap` + +Dumps the RLP-encoded storage values for an `account` specified by `address`. + +#### Parameters + +| Name | Type | Description | +| :------ | :------ | :------ | +| `address` | `Address` | The address of the `account` to return storage for | + +#### Returns + +`undefined` \| `StorageCacheMap` + +- The storage values for the `account` or undefined if the `account` is not in the cache + +#### Defined in + +[cache/storage.ts:358](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L358) ___ @@ -278,7 +303,7 @@ or deleted and resetting the diff cache (at checkpoint height). #### Defined in -[cache/storage.ts:194](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L194) +[cache/storage.ts:189](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L189) ___ @@ -305,7 +330,7 @@ Storage value or undefined #### Defined in -[cache/storage.ts:126](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L126) +[cache/storage.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L121) ___ @@ -329,7 +354,7 @@ Puts storage value to cache under address_key cache key. #### Defined in -[cache/storage.ts:88](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L88) +[cache/storage.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L83) ___ @@ -345,7 +370,7 @@ Revert changes to cache last checkpoint (no effect on trie). #### Defined in -[cache/storage.ts:230](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L230) +[cache/storage.ts:225](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L225) ___ @@ -361,7 +386,7 @@ Returns the size of the cache #### Defined in -[cache/storage.ts:317](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L317) +[cache/storage.ts:312](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L312) ___ @@ -391,4 +416,4 @@ Returns a dict with cache stats #### Defined in -[cache/storage.ts:329](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L329) +[cache/storage.ts:324](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/cache/storage.ts#L324) diff --git a/packages/statemanager/docs/interfaces/DefaultStateManagerOpts.md b/packages/statemanager/docs/interfaces/DefaultStateManagerOpts.md index 8faf333411..2fbde8e450 100644 --- a/packages/statemanager/docs/interfaces/DefaultStateManagerOpts.md +++ b/packages/statemanager/docs/interfaces/DefaultStateManagerOpts.md @@ -9,8 +9,10 @@ Options for constructing a StateManager. ### Properties - [accountCacheOpts](DefaultStateManagerOpts.md#accountcacheopts) +- [codeCacheOpts](DefaultStateManagerOpts.md#codecacheopts) - [common](DefaultStateManagerOpts.md#common) - [prefixCodeHashes](DefaultStateManagerOpts.md#prefixcodehashes) +- [prefixStorageTrieKeys](DefaultStateManagerOpts.md#prefixstoragetriekeys) - [storageCacheOpts](DefaultStateManagerOpts.md#storagecacheopts) - [trie](DefaultStateManagerOpts.md#trie) @@ -22,7 +24,17 @@ Options for constructing a StateManager. #### Defined in -[stateManager.ts:120](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L120) +[stateManager.ts:134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L134) + +___ + +### codeCacheOpts + +• `Optional` **codeCacheOpts**: `CacheOptions` + +#### Defined in + +[stateManager.ts:138](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L138) ___ @@ -34,7 +46,7 @@ The common to use #### Defined in -[stateManager.ts:127](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L127) +[stateManager.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L143) ___ @@ -49,7 +61,26 @@ E.g. by putting the code `0x80` into the empty trie, will lead to a corrupted tr #### Defined in -[stateManager.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L118) +[stateManager.ts:120](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L120) + +___ + +### prefixStorageTrieKeys + +• `Optional` **prefixStorageTrieKeys**: `boolean` + +Option to prefix the keys for the storage tries with the first 7 bytes from the +associated account address. Activating this option gives a noticeable performance +boost for storage DB reads when operating on larger tries. + +Note: Activating/deactivating this option causes continued state reads to be +incompatible with existing databases. + +Default: false (for backwards compatibility reasons) + +#### Defined in + +[stateManager.ts:132](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L132) ___ @@ -59,7 +90,7 @@ ___ #### Defined in -[stateManager.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L122) +[stateManager.ts:136](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L136) ___ @@ -71,4 +102,4 @@ A Trie instance #### Defined in -[stateManager.ts:111](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L111) +[stateManager.ts:113](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/stateManager.ts#L113) diff --git a/packages/statemanager/docs/interfaces/EthersStateManagerOpts.md b/packages/statemanager/docs/interfaces/EthersStateManagerOpts.md index 6a202fab0f..dc2db4f843 100644 --- a/packages/statemanager/docs/interfaces/EthersStateManagerOpts.md +++ b/packages/statemanager/docs/interfaces/EthersStateManagerOpts.md @@ -17,7 +17,7 @@ #### Defined in -[ethersStateManager.ts:18](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L18) +[ethersStateManager.ts:19](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L19) ___ @@ -27,4 +27,4 @@ ___ #### Defined in -[ethersStateManager.ts:17](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L17) +[ethersStateManager.ts:18](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/statemanager/src/ethersStateManager.ts#L18) diff --git a/packages/statemanager/package.json b/packages/statemanager/package.json index cb98d21aee..25ead1e932 100644 --- a/packages/statemanager/package.json +++ b/packages/statemanager/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/statemanager", - "version": "2.0.0", + "version": "2.1.0", "description": "An Ethereum statemanager implementation", "keywords": [ "ethereum", @@ -48,10 +48,10 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2", "ethers": "^6.4.0", @@ -59,8 +59,8 @@ "lru-cache": "^10.0.0" }, "devDependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/genesis": "^0.1.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/genesis": "^0.2.0", "@types/debug": "^4.1.9" } } diff --git a/packages/trie/CHANGELOG.md b/packages/trie/CHANGELOG.md index 449a3813b0..1459a4e01d 100644 --- a/packages/trie/CHANGELOG.md +++ b/packages/trie/CHANGELOG.md @@ -6,6 +6,36 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 6.0.1 - 2023-10-26 + +### Native Support for Uint8Array Values in DBs + +The trie library now allows to store values being passed as native `Uint8Array` values instead of strings, see PR [#3067](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3067). + +This leads to a significant performance increase when dealing with larger state DBs and it is recommended to activate for new DBs by using the new `valueEncoding` option. + +**Attention!**: Switching value encoding by using this new option is not compatible with existing databases. + +### Debug Logging + +The trie library now allows for using debug logging with the `DEBUG=ethjs,trie:*` flag on the command line as already being implemented in other EthereumJS libraries, see PR [#3019](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3019). + +See [Debugging](https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/trie#debugging) README section for usage instructions. This comes in pretty handy if in-depth trie analysis with step-by-step following of path reads is needed. + +### Bugfixes + +- Fix empty-root check, PR [#3001](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3001) + +### Other Changes + +- New parameter `skipKeyTransform` (default: `false`) for Trie `put()`, `del()` and `batch()` method to allow to pass in already hashed keys, PR [#2950](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2950) +- New `keyPrefix` option tries to store node keys with a static prefix (used upstream in the `statemanager` package to speed to storage trie reads), PR [#3023](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3023) +- Peformance: `findPath()` optimizations, PR [#3066](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3066) +- Make `null` available as type option for `put()` method value, PR [#3020](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3020) +- Allow partial trie options for `shallowCopy()` (e.g. for a more flexible cache configuration for the trie copy), PR [#3063](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3063) +- Use `lock` class from `@ethereumjs/util`, PR [#3109](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3109) +- Improve util types and handling, PR [#2951](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2951) + ## 6.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/trie/docs/README.md b/packages/trie/docs/README.md index 532b5fe1bb..33cf2622b4 100644 --- a/packages/trie/docs/README.md +++ b/packages/trie/docs/README.md @@ -19,6 +19,7 @@ - [CheckpointDBOpts](interfaces/CheckpointDBOpts.md) - [TrieOpts](interfaces/TrieOpts.md) +- [TrieShallowCopyOpts](interfaces/TrieShallowCopyOpts.md) ### Type Aliases @@ -69,7 +70,7 @@ #### Defined in -[packages/trie/src/types.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L95) +[packages/trie/src/types.ts:108](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L108) ___ @@ -170,7 +171,7 @@ ___ #### Defined in -[packages/trie/src/types.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L75) +[packages/trie/src/types.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L83) ## Variables @@ -180,7 +181,7 @@ ___ #### Defined in -[packages/trie/src/types.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L102) +[packages/trie/src/types.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L115) ## Functions @@ -250,13 +251,13 @@ ___ ### decodeNode -▸ **decodeNode**(`raw`): [`BranchNode`](classes/BranchNode.md) \| [`ExtensionNode`](classes/ExtensionNode.md) \| [`LeafNode`](classes/LeafNode.md) +▸ **decodeNode**(`node`): [`BranchNode`](classes/BranchNode.md) \| [`ExtensionNode`](classes/ExtensionNode.md) \| [`LeafNode`](classes/LeafNode.md) #### Parameters | Name | Type | | :------ | :------ | -| `raw` | `Uint8Array` | +| `node` | `Uint8Array` | #### Returns @@ -264,7 +265,7 @@ ___ #### Defined in -[packages/trie/src/node/util.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L24) +[packages/trie/src/node/util.ts:30](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L30) ___ @@ -284,7 +285,7 @@ ___ #### Defined in -[packages/trie/src/node/util.ts:10](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L10) +[packages/trie/src/node/util.ts:12](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L12) ___ @@ -355,21 +356,21 @@ ___ ### isRawNode -▸ **isRawNode**(`n`): `boolean` +▸ **isRawNode**(`n`): n is Uint8Array[] #### Parameters | Name | Type | | :------ | :------ | -| `n` | `any` | +| `n` | `Uint8Array` \| `NestedUint8Array` | #### Returns -`boolean` +n is Uint8Array[] #### Defined in -[packages/trie/src/node/util.ts:32](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L32) +[packages/trie/src/node/util.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/node/util.ts#L26) ___ diff --git a/packages/trie/docs/classes/Trie.md b/packages/trie/docs/classes/Trie.md index 2aa22c7cc9..a94258ad75 100644 --- a/packages/trie/docs/classes/Trie.md +++ b/packages/trie/docs/classes/Trie.md @@ -61,7 +61,7 @@ Creates a new trie. #### Defined in -[packages/trie/src/trie.ts:75](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L75) +[packages/trie/src/trie.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L86) ## Properties @@ -73,7 +73,7 @@ The root for an empty trie #### Defined in -[packages/trie/src/trie.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L61) +[packages/trie/src/trie.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L67) ___ @@ -97,13 +97,13 @@ ___ #### Defined in -[packages/trie/src/trie.ts:355](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L355) +[packages/trie/src/trie.ts:443](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L443) ## Methods ### batch -▸ **batch**(`ops`): `Promise`<`void`\> +▸ **batch**(`ops`, `skipKeyTransform?`): `Promise`<`void`\> The given hash of operations (key additions or deletions) are executed on the trie (delete operations are only executed on DB with `deleteFromDB` set to `true`) @@ -126,6 +126,7 @@ await trie.batch(ops) | Name | Type | | :------ | :------ | | `ops` | `BatchDBOp`<`Uint8Array`, `Uint8Array`\>[] | +| `skipKeyTransform?` | `boolean` | #### Returns @@ -133,7 +134,7 @@ await trie.batch(ops) #### Defined in -[packages/trie/src/trie.ts:755](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L755) +[packages/trie/src/trie.ts:844](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L844) ___ @@ -155,7 +156,7 @@ Checks if a given root exists. #### Defined in -[packages/trie/src/trie.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L150) +[packages/trie/src/trie.ts:182](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L182) ___ @@ -172,7 +173,7 @@ After this is called, all changes can be reverted until `commit` is called. #### Defined in -[packages/trie/src/trie.ts:1001](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1001) +[packages/trie/src/trie.ts:1124](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1124) ___ @@ -193,7 +194,7 @@ If not during a checkpoint phase #### Defined in -[packages/trie/src/trie.ts:1010](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1010) +[packages/trie/src/trie.ts:1134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1134) ___ @@ -215,7 +216,7 @@ Creates a proof from a trie and key that can be verified using [verifyProof](Tri #### Defined in -[packages/trie/src/trie.ts:795](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L795) +[packages/trie/src/trie.ts:892](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L892) ___ @@ -233,7 +234,7 @@ Returns a [stream](https://nodejs.org/dist/latest-v12.x/docs/api/stream.html#str #### Defined in -[packages/trie/src/trie.ts:917](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L917) +[packages/trie/src/trie.ts:1029](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1029) ___ @@ -253,22 +254,23 @@ ___ #### Defined in -[packages/trie/src/trie.ts:116](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L116) +[packages/trie/src/trie.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L149) ___ ### del -▸ **del**(`key`): `Promise`<`void`\> +▸ **del**(`key`, `skipKeyTransform?`): `Promise`<`void`\> Deletes a value given a `key` from the trie (delete operations are only executed on DB with `deleteFromDB` set to `true`) #### Parameters -| Name | Type | -| :------ | :------ | -| `key` | `Uint8Array` | +| Name | Type | Default value | +| :------ | :------ | :------ | +| `key` | `Uint8Array` | `undefined` | +| `skipKeyTransform` | `boolean` | `false` | #### Returns @@ -278,7 +280,7 @@ A Promise that resolves once value is deleted. #### Defined in -[packages/trie/src/trie.ts:242](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L242) +[packages/trie/src/trie.ts:283](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L283) ___ @@ -302,7 +304,7 @@ It returns a `stack` of nodes to the closest node. #### Defined in -[packages/trie/src/trie.ts:280](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L280) +[packages/trie/src/trie.ts:323](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L323) ___ @@ -318,7 +320,7 @@ Flushes all checkpoints, restoring the initial checkpoint state. #### Defined in -[packages/trie/src/trie.ts:1040](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1040) +[packages/trie/src/trie.ts:1166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1166) ___ @@ -340,7 +342,7 @@ Saves the nodes from a proof into the trie. #### Defined in -[packages/trie/src/trie.ts:773](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L773) +[packages/trie/src/trie.ts:862](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L862) ___ @@ -365,7 +367,7 @@ A Promise that resolves to `Uint8Array` if a value was found or `null` if no val #### Defined in -[packages/trie/src/trie.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L169) +[packages/trie/src/trie.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L201) ___ @@ -381,13 +383,13 @@ Is the trie during a checkpoint phase? #### Defined in -[packages/trie/src/trie.ts:993](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L993) +[packages/trie/src/trie.ts:1116](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1116) ___ ### lookupNode -▸ **lookupNode**(`node`): `Promise`<``null`` \| [`TrieNode`](../README.md#trienode)\> +▸ **lookupNode**(`node`): `Promise`<[`TrieNode`](../README.md#trienode)\> Retrieves a node from db by hash. @@ -399,11 +401,11 @@ Retrieves a node from db by hash. #### Returns -`Promise`<``null`` \| [`TrieNode`](../README.md#trienode)\> +`Promise`<[`TrieNode`](../README.md#trienode)\> #### Defined in -[packages/trie/src/trie.ts:402](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L402) +[packages/trie/src/trie.ts:492](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L492) ___ @@ -419,23 +421,24 @@ Persists the root hash in the underlying database #### Defined in -[packages/trie/src/trie.ts:949](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L949) +[packages/trie/src/trie.ts:1063](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1063) ___ ### put -▸ **put**(`key`, `value`): `Promise`<`void`\> +▸ **put**(`key`, `value`, `skipKeyTransform?`): `Promise`<`void`\> Stores a given `value` at the given `key` or do a delete if `value` is empty (delete operations are only executed on DB with `deleteFromDB` set to `true`) #### Parameters -| Name | Type | -| :------ | :------ | -| `key` | `Uint8Array` | -| `value` | `Uint8Array` | +| Name | Type | Default value | +| :------ | :------ | :------ | +| `key` | `Uint8Array` | `undefined` | +| `value` | ``null`` \| `Uint8Array` | `undefined` | +| `skipKeyTransform` | `boolean` | `false` | #### Returns @@ -445,7 +448,7 @@ A Promise that resolves once value is stored. #### Defined in -[packages/trie/src/trie.ts:185](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L185) +[packages/trie/src/trie.ts:219](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L219) ___ @@ -463,7 +466,7 @@ parent checkpoint as current. #### Defined in -[packages/trie/src/trie.ts:1026](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1026) +[packages/trie/src/trie.ts:1150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1150) ___ @@ -485,7 +488,7 @@ Gets and/or Sets the current root of the `trie` #### Defined in -[packages/trie/src/trie.ts:131](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L131) +[packages/trie/src/trie.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L164) ___ @@ -509,28 +512,30 @@ Saves a stack of nodes to the database. #### Defined in -[packages/trie/src/trie.ts:670](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L670) +[packages/trie/src/trie.ts:758](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L758) ___ ### shallowCopy -▸ **shallowCopy**(`includeCheckpoints?`): [`Trie`](Trie.md) +▸ **shallowCopy**(`includeCheckpoints?`, `opts?`): [`Trie`](Trie.md) Returns a copy of the underlying trie. Note on db: the copy will create a reference to the same underlying database. -Note on cache: for memory reasons a copy will not -recreate a new LRU cache but initialize with cache -being deactivated. +Note on cache: for memory reasons a copy will by default +not recreate a new LRU cache but initialize with cache +being deactivated. This behavior can be overwritten by +explicitly setting `cacheSize` as an option on the method. #### Parameters | Name | Type | Default value | Description | | :------ | :------ | :------ | :------ | | `includeCheckpoints` | `boolean` | `true` | If true and during a checkpoint, the copy will contain the checkpointing metadata and will use the same scratch as underlying db. | +| `opts?` | [`TrieShallowCopyOpts`](../interfaces/TrieShallowCopyOpts.md) | `undefined` | - | #### Returns @@ -538,7 +543,7 @@ being deactivated. #### Defined in -[packages/trie/src/trie.ts:933](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L933) +[packages/trie/src/trie.ts:1046](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L1046) ___ @@ -568,7 +573,7 @@ The value from the key, or null if valid proof of non-existence. #### Defined in -[packages/trie/src/trie.ts:811](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L811) +[packages/trie/src/trie.ts:910](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L910) ___ @@ -582,7 +587,7 @@ ___ #### Defined in -[packages/trie/src/trie.ts:863](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L863) +[packages/trie/src/trie.ts:975](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L975) ___ @@ -609,7 +614,7 @@ ___ #### Defined in -[packages/trie/src/trie.ts:840](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L840) +[packages/trie/src/trie.ts:952](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L952) ___ @@ -633,7 +638,7 @@ Resolves when finished walking trie. #### Defined in -[packages/trie/src/trie.ts:362](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L362) +[packages/trie/src/trie.ts:450](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L450) ___ @@ -657,7 +662,7 @@ Resolves when finished walking trie. #### Defined in -[packages/trie/src/trie.ts:373](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L373) +[packages/trie/src/trie.ts:461](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L461) ___ @@ -682,7 +687,7 @@ Resolves when finished walking trie. #### Defined in -[packages/trie/src/trie.ts:351](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L351) +[packages/trie/src/trie.ts:439](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L439) ___ @@ -702,4 +707,4 @@ ___ #### Defined in -[packages/trie/src/trie.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L91) +[packages/trie/src/trie.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/trie.ts#L121) diff --git a/packages/trie/docs/interfaces/CheckpointDBOpts.md b/packages/trie/docs/interfaces/CheckpointDBOpts.md index 3cdc21b172..3014343173 100644 --- a/packages/trie/docs/interfaces/CheckpointDBOpts.md +++ b/packages/trie/docs/interfaces/CheckpointDBOpts.md @@ -19,7 +19,7 @@ Cache size (default: 0) #### Defined in -[packages/trie/src/types.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L92) +[packages/trie/src/types.ts:105](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L105) ___ @@ -31,4 +31,4 @@ A database instance. #### Defined in -[packages/trie/src/types.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L87) +[packages/trie/src/types.ts:100](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L100) diff --git a/packages/trie/docs/interfaces/TrieOpts.md b/packages/trie/docs/interfaces/TrieOpts.md index 555e3b55fe..6d0bfbdc66 100644 --- a/packages/trie/docs/interfaces/TrieOpts.md +++ b/packages/trie/docs/interfaces/TrieOpts.md @@ -8,6 +8,7 @@ - [cacheSize](TrieOpts.md#cachesize) - [db](TrieOpts.md#db) +- [keyPrefix](TrieOpts.md#keyprefix) - [root](TrieOpts.md#root) - [useKeyHashing](TrieOpts.md#usekeyhashing) - [useKeyHashingFunction](TrieOpts.md#usekeyhashingfunction) @@ -26,7 +27,7 @@ Default: 0 (deactivated) #### Defined in -[packages/trie/src/types.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L72) +[packages/trie/src/types.ts:80](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L80) ___ @@ -42,6 +43,21 @@ A database instance. ___ +### keyPrefix + +• `Optional` **keyPrefix**: `Uint8Array` + +Add a prefix to the trie node keys + +(potential performance benefits if multiple tries are stored within the same DB, +e.g. all storage tries being stored in the outer account state DB) + +#### Defined in + +[packages/trie/src/types.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L62) + +___ + ### root • `Optional` **root**: `Uint8Array` @@ -96,7 +112,7 @@ unreachable nodes will be pruned (deleted) from the trie #### Defined in -[packages/trie/src/types.ts:65](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L65) +[packages/trie/src/types.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L73) ___ @@ -108,4 +124,4 @@ Store the root inside the database after every `write` operation #### Defined in -[packages/trie/src/types.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L59) +[packages/trie/src/types.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L67) diff --git a/packages/trie/docs/interfaces/TrieShallowCopyOpts.md b/packages/trie/docs/interfaces/TrieShallowCopyOpts.md new file mode 100644 index 0000000000..83af6b30d7 --- /dev/null +++ b/packages/trie/docs/interfaces/TrieShallowCopyOpts.md @@ -0,0 +1,30 @@ +[@ethereumjs/trie](../README.md) / TrieShallowCopyOpts + +# Interface: TrieShallowCopyOpts + +## Table of contents + +### Properties + +- [cacheSize](TrieShallowCopyOpts.md#cachesize) +- [keyPrefix](TrieShallowCopyOpts.md#keyprefix) + +## Properties + +### cacheSize + +• `Optional` **cacheSize**: `number` + +#### Defined in + +[packages/trie/src/types.ts:93](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L93) + +___ + +### keyPrefix + +• `Optional` **keyPrefix**: `Uint8Array` + +#### Defined in + +[packages/trie/src/types.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/trie/src/types.ts#L92) diff --git a/packages/trie/package.json b/packages/trie/package.json index 2c0b33e24d..16ac347128 100644 --- a/packages/trie/package.json +++ b/packages/trie/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/trie", - "version": "6.0.0", + "version": "6.0.1", "description": "Implementation of the modified merkle patricia tree as specified in Ethereum's yellow paper.", "keywords": [ "merkle", @@ -52,15 +52,15 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "@types/readable-stream": "^2.3.13", "lru-cache": "^10.0.0", "ethereum-cryptography": "^2.1.2", "readable-stream": "^3.6.0" }, "devDependencies": { - "@ethereumjs/genesis": "^0.1.0", + "@ethereumjs/genesis": "^0.2.0", "@types/benchmark": "^1.0.33", "abstract-level": "^1.0.3", "debug": "^4.3.4", diff --git a/packages/tx/CHANGELOG.md b/packages/tx/CHANGELOG.md index 08e84a86a8..a60cbc583e 100644 --- a/packages/tx/CHANGELOG.md +++ b/packages/tx/CHANGELOG.md @@ -6,6 +6,35 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 5.1.0 - 2023-10-26 + +### More Type-Aligned Library Structure + +This release gently introduces a backwards-compatible new/adopted library structure which is more aligned with the idea of independent tx types, bundling various functionalities together in a way that is not necessarily hierarchical, see PR [#2993](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2993) and [#3010](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3010). + +Reused functionality (e.g. calculating the upfront-cost (`getUpfrontCost()`) of an `EIP-1559`-compatible tx - is internally bundled in capability files (e.g. `capabilities/eip1559.ts`), which provide static call access to the respective methods. + +These methods are then called and the functionality exposed by the respective methods in the tx classes, see the following example code for an `FeeMarketEIP1559Transaction`: + +```typescript +getUpfrontCost(baseFee: bigint = BigInt(0)): bigint { + return EIP1559.getUpfrontCost(this, baseFee) + } +``` + +This makes creating additional or custom tx types and reusing of existing functionality substantially easier and makes the library substantially more robust by largely consolidating previously redundant code parts. + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update peer dependency for `kzg` module to use the official trusted setup for `mainnet`, PR [#3107](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3107) + +### Other Changes + +- Performance: cache tx sender to avoid redundant and costly `ecrecover` calls, PR [#2985](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2985) +- Add new method `getDataFee()` to `BlobEIP4844Transaction`, PR [#2955](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2955) + ## 5.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/tx/docs/README.md b/packages/tx/docs/README.md index 7ee5dcce4b..75b4415509 100644 --- a/packages/tx/docs/README.md +++ b/packages/tx/docs/README.md @@ -21,10 +21,16 @@ - [AccessListEIP2930TxData](interfaces/AccessListEIP2930TxData.md) - [BlobEIP4844TxData](interfaces/BlobEIP4844TxData.md) +- [EIP1559CompatibleTx](interfaces/EIP1559CompatibleTx.md) +- [EIP2718CompatibleTx](interfaces/EIP2718CompatibleTx.md) +- [EIP2930CompatibleTx](interfaces/EIP2930CompatibleTx.md) +- [EIP4844CompatibleTx](interfaces/EIP4844CompatibleTx.md) - [FeeMarketEIP1559TxData](interfaces/FeeMarketEIP1559TxData.md) - [JsonRpcTx](interfaces/JsonRpcTx.md) - [JsonTx](interfaces/JsonTx.md) +- [LegacyTxInterface](interfaces/LegacyTxInterface.md) - [Transaction](interfaces/Transaction.md) +- [TransactionCache](interfaces/TransactionCache.md) - [TransactionInterface](interfaces/TransactionInterface.md) - [TxData](interfaces/TxData.md) - [TxOptions](interfaces/TxOptions.md) @@ -62,7 +68,7 @@ #### Defined in -common/dist/cjs/interfaces.d.ts:29 +common/dist/cjs/interfaces.d.ts:51 ___ @@ -72,7 +78,7 @@ ___ #### Defined in -common/dist/cjs/interfaces.d.ts:28 +common/dist/cjs/interfaces.d.ts:50 ___ @@ -82,7 +88,7 @@ ___ #### Defined in -common/dist/cjs/interfaces.d.ts:27 +common/dist/cjs/interfaces.d.ts:49 ___ @@ -99,7 +105,7 @@ ___ #### Defined in -common/dist/cjs/interfaces.d.ts:23 +common/dist/cjs/interfaces.d.ts:45 ___ @@ -109,7 +115,7 @@ ___ #### Defined in -[tx/src/types.ts:371](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L371) +[tx/src/types.ts:422](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L422) ___ @@ -136,7 +142,7 @@ Legacy [Transaction](interfaces/Transaction.md) Data #### Defined in -[tx/src/types.ts:187](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L187) +[tx/src/types.ts:238](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L238) ___ @@ -146,7 +152,7 @@ ___ #### Defined in -[tx/src/types.ts:113](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L113) +[tx/src/types.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L122) ___ @@ -156,7 +162,7 @@ ___ #### Defined in -[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) +[tx/src/types.ts:213](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L213) ## Functions @@ -216,7 +222,7 @@ tx is AccessListEIP2930Transaction #### Defined in -[tx/src/types.ts:119](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L119) +[tx/src/types.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L128) ___ @@ -236,7 +242,7 @@ txData is AccessListEIP2930TxData #### Defined in -[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) +[tx/src/types.ts:220](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L220) ___ @@ -256,7 +262,7 @@ tx is BlobEIP4844Transaction #### Defined in -[tx/src/types.ts:127](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L127) +[tx/src/types.ts:136](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L136) ___ @@ -276,7 +282,7 @@ txData is BlobEIP4844TxData #### Defined in -[tx/src/types.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L179) +[tx/src/types.ts:230](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L230) ___ @@ -296,7 +302,7 @@ tx is FeeMarketEIP1559Transaction #### Defined in -[tx/src/types.ts:123](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L123) +[tx/src/types.ts:132](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L132) ___ @@ -316,7 +322,7 @@ txData is FeeMarketEIP1559TxData #### Defined in -[tx/src/types.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L174) +[tx/src/types.ts:225](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L225) ___ @@ -336,7 +342,7 @@ tx is LegacyTransaction #### Defined in -[tx/src/types.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L115) +[tx/src/types.ts:124](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L124) ___ @@ -356,4 +362,4 @@ txData is LegacyTxData #### Defined in -[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) +[tx/src/types.ts:215](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L215) diff --git a/packages/tx/docs/classes/AccessListEIP2930Transaction.md b/packages/tx/docs/classes/AccessListEIP2930Transaction.md index 358c854658..1c8beb15b4 100644 --- a/packages/tx/docs/classes/AccessListEIP2930Transaction.md +++ b/packages/tx/docs/classes/AccessListEIP2930Transaction.md @@ -23,6 +23,7 @@ Typed transaction with optional access lists - [AccessListJSON](AccessListEIP2930Transaction.md#accesslistjson) - [accessList](AccessListEIP2930Transaction.md#accesslist) +- [cache](AccessListEIP2930Transaction.md#cache) - [chainId](AccessListEIP2930Transaction.md#chainid) - [common](AccessListEIP2930Transaction.md#common) - [data](AccessListEIP2930Transaction.md#data) @@ -90,7 +91,7 @@ BaseTransaction<TransactionType.AccessListEIP2930\>.constructor #### Defined in -[tx/src/eip2930Transaction.ts:135](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L135) +[tx/src/eip2930Transaction.ts:134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L134) ## Properties @@ -100,7 +101,7 @@ BaseTransaction<TransactionType.AccessListEIP2930\>.constructor #### Defined in -[tx/src/eip2930Transaction.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L47) +[tx/src/eip2930Transaction.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L43) ___ @@ -110,7 +111,21 @@ ___ #### Defined in -[tx/src/eip2930Transaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L46) +[tx/src/eip2930Transaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L42) + +___ + +### cache + +• **cache**: [`TransactionCache`](../interfaces/TransactionCache.md) + +#### Inherited from + +BaseTransaction.cache + +#### Defined in + +[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) ___ @@ -120,7 +135,7 @@ ___ #### Defined in -[tx/src/eip2930Transaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L45) +[tx/src/eip2930Transaction.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L41) ___ @@ -134,7 +149,7 @@ BaseTransaction.common #### Defined in -[tx/src/eip2930Transaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L50) +[tx/src/eip2930Transaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L46) ___ @@ -148,7 +163,7 @@ BaseTransaction.data #### Defined in -[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) +[tx/src/baseTransaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L46) ___ @@ -162,7 +177,7 @@ BaseTransaction.gasLimit #### Defined in -[tx/src/baseTransaction.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L51) +[tx/src/baseTransaction.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L43) ___ @@ -172,7 +187,7 @@ ___ #### Defined in -[tx/src/eip2930Transaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L48) +[tx/src/eip2930Transaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L44) ___ @@ -186,7 +201,7 @@ BaseTransaction.nonce #### Defined in -[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) +[tx/src/baseTransaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L42) ___ @@ -200,7 +215,7 @@ BaseTransaction.r #### Defined in -[tx/src/baseTransaction.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L57) +[tx/src/baseTransaction.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L49) ___ @@ -214,7 +229,7 @@ BaseTransaction.s #### Defined in -[tx/src/baseTransaction.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L58) +[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) ___ @@ -228,7 +243,7 @@ BaseTransaction.to #### Defined in -[tx/src/baseTransaction.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L52) +[tx/src/baseTransaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L44) ___ @@ -242,7 +257,7 @@ BaseTransaction.v #### Defined in -[tx/src/baseTransaction.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L56) +[tx/src/baseTransaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L48) ___ @@ -256,7 +271,7 @@ BaseTransaction.value #### Defined in -[tx/src/baseTransaction.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L53) +[tx/src/baseTransaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L45) ## Accessors @@ -278,7 +293,7 @@ BaseTransaction.type #### Defined in -[tx/src/baseTransaction.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L128) +[tx/src/baseTransaction.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L121) ## Methods @@ -298,7 +313,7 @@ BaseTransaction.errorStr #### Defined in -[tx/src/eip2930Transaction.ts:372](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L372) +[tx/src/eip2930Transaction.ts:322](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L322) ___ @@ -318,7 +333,7 @@ BaseTransaction.getBaseFee #### Defined in -[tx/src/baseTransaction.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L205) +[tx/src/baseTransaction.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L176) ___ @@ -338,7 +353,7 @@ BaseTransaction.getDataFee #### Defined in -[tx/src/eip2930Transaction.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L180) +[tx/src/eip2930Transaction.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L179) ___ @@ -362,7 +377,7 @@ BaseTransaction.getHashedMessageToSign #### Defined in -[tx/src/eip2930Transaction.ts:273](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L273) +[tx/src/eip2930Transaction.ts:255](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L255) ___ @@ -390,7 +405,7 @@ BaseTransaction.getMessageToSign #### Defined in -[tx/src/eip2930Transaction.ts:260](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L260) +[tx/src/eip2930Transaction.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L244) ___ @@ -410,7 +425,7 @@ BaseTransaction.getMessageToVerifySignature #### Defined in -[tx/src/eip2930Transaction.ts:302](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L302) +[tx/src/eip2930Transaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L272) ___ @@ -430,7 +445,7 @@ BaseTransaction.getSenderAddress #### Defined in -[tx/src/baseTransaction.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L301) +[tx/src/baseTransaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L272) ___ @@ -450,7 +465,7 @@ BaseTransaction.getSenderPublicKey #### Defined in -[tx/src/eip2930Transaction.ts:309](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L309) +[tx/src/eip2930Transaction.ts:279](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L279) ___ @@ -470,7 +485,7 @@ BaseTransaction.getUpfrontCost #### Defined in -[tx/src/eip2930Transaction.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L201) +[tx/src/eip2930Transaction.ts:186](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L186) ___ @@ -492,7 +507,7 @@ BaseTransaction.getValidationErrors #### Defined in -[tx/src/baseTransaction.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L156) +[tx/src/baseTransaction.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L149) ___ @@ -515,7 +530,7 @@ BaseTransaction.hash #### Defined in -[tx/src/eip2930Transaction.ts:283](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L283) +[tx/src/eip2930Transaction.ts:265](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L265) ___ @@ -533,7 +548,7 @@ BaseTransaction.isSigned #### Defined in -[tx/src/baseTransaction.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L276) +[tx/src/baseTransaction.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L247) ___ @@ -555,7 +570,7 @@ BaseTransaction.isValid #### Defined in -[tx/src/baseTransaction.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L174) +[tx/src/baseTransaction.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L167) ___ @@ -585,7 +600,7 @@ BaseTransaction.raw #### Defined in -[tx/src/eip2930Transaction.ts:218](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L218) +[tx/src/eip2930Transaction.ts:203](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L203) ___ @@ -612,7 +627,7 @@ BaseTransaction.serialize #### Defined in -[tx/src/eip2930Transaction.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L244) +[tx/src/eip2930Transaction.ts:229](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L229) ___ @@ -644,7 +659,7 @@ BaseTransaction.sign #### Defined in -[tx/src/baseTransaction.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L319) +[tx/src/baseTransaction.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L290) ___ @@ -683,7 +698,7 @@ BaseTransaction.supports #### Defined in -[tx/src/baseTransaction.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L148) +[tx/src/baseTransaction.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L141) ___ @@ -703,7 +718,7 @@ BaseTransaction.toCreationAddress #### Defined in -[tx/src/baseTransaction.ts:245](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L245) +[tx/src/baseTransaction.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L216) ___ @@ -723,7 +738,7 @@ BaseTransaction.toJSON #### Defined in -[tx/src/eip2930Transaction.ts:357](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L357) +[tx/src/eip2930Transaction.ts:307](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L307) ___ @@ -743,7 +758,7 @@ BaseTransaction.verifySignature #### Defined in -[tx/src/baseTransaction.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L288) +[tx/src/baseTransaction.ts:259](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L259) ___ @@ -769,7 +784,7 @@ signatureYParity (v), signatureR (r), signatureS (s)])` #### Defined in -[tx/src/eip2930Transaction.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L72) +[tx/src/eip2930Transaction.ts:68](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L68) ___ @@ -799,7 +814,7 @@ Notes: #### Defined in -[tx/src/eip2930Transaction.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L62) +[tx/src/eip2930Transaction.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L58) ___ @@ -825,4 +840,4 @@ signatureYParity (v), signatureR (r), signatureS (s)]` #### Defined in -[tx/src/eip2930Transaction.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L96) +[tx/src/eip2930Transaction.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip2930Transaction.ts#L95) diff --git a/packages/tx/docs/classes/BlobEIP4844Transaction.md b/packages/tx/docs/classes/BlobEIP4844Transaction.md index ecdc1c7f69..f4592bf41e 100644 --- a/packages/tx/docs/classes/BlobEIP4844Transaction.md +++ b/packages/tx/docs/classes/BlobEIP4844Transaction.md @@ -23,15 +23,17 @@ Typed transaction with a new gas fee market mechanism for transactions that incl - [AccessListJSON](BlobEIP4844Transaction.md#accesslistjson) - [accessList](BlobEIP4844Transaction.md#accesslist) +- [blobVersionedHashes](BlobEIP4844Transaction.md#blobversionedhashes) - [blobs](BlobEIP4844Transaction.md#blobs) +- [cache](BlobEIP4844Transaction.md#cache) - [chainId](BlobEIP4844Transaction.md#chainid) - [common](BlobEIP4844Transaction.md#common) - [data](BlobEIP4844Transaction.md#data) - [gasLimit](BlobEIP4844Transaction.md#gaslimit) - [kzgCommitments](BlobEIP4844Transaction.md#kzgcommitments) - [kzgProofs](BlobEIP4844Transaction.md#kzgproofs) +- [maxFeePerBlobGas](BlobEIP4844Transaction.md#maxfeeperblobgas) - [maxFeePerGas](BlobEIP4844Transaction.md#maxfeepergas) -- [maxFeePerblobGas](BlobEIP4844Transaction.md#maxfeeperblobgas) - [maxPriorityFeePerGas](BlobEIP4844Transaction.md#maxpriorityfeepergas) - [nonce](BlobEIP4844Transaction.md#nonce) - [r](BlobEIP4844Transaction.md#r) @@ -39,7 +41,6 @@ Typed transaction with a new gas fee market mechanism for transactions that incl - [to](BlobEIP4844Transaction.md#to) - [v](BlobEIP4844Transaction.md#v) - [value](BlobEIP4844Transaction.md#value) -- [versionedHashes](BlobEIP4844Transaction.md#versionedhashes) ### Accessors @@ -100,7 +101,7 @@ BaseTransaction<TransactionType.BlobEIP4844\>.constructor #### Defined in -[tx/src/eip4844Transaction.ts:105](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L105) +[tx/src/eip4844Transaction.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L103) ## Properties @@ -110,7 +111,7 @@ BaseTransaction<TransactionType.BlobEIP4844\>.constructor #### Defined in -[tx/src/eip4844Transaction.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L87) +[tx/src/eip4844Transaction.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L85) ___ @@ -120,7 +121,17 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L86) +[tx/src/eip4844Transaction.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L84) + +___ + +### blobVersionedHashes + +• **blobVersionedHashes**: `Uint8Array`[] + +#### Defined in + +[tx/src/eip4844Transaction.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L91) ___ @@ -130,7 +141,21 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L94) +[tx/src/eip4844Transaction.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L92) + +___ + +### cache + +• **cache**: [`TransactionCache`](../interfaces/TransactionCache.md) + +#### Inherited from + +BaseTransaction.cache + +#### Defined in + +[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) ___ @@ -140,7 +165,7 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L85) +[tx/src/eip4844Transaction.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L83) ___ @@ -154,7 +179,7 @@ BaseTransaction.common #### Defined in -[tx/src/eip4844Transaction.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L92) +[tx/src/eip4844Transaction.ts:90](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L90) ___ @@ -168,7 +193,7 @@ BaseTransaction.data #### Defined in -[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) +[tx/src/baseTransaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L46) ___ @@ -182,7 +207,7 @@ BaseTransaction.gasLimit #### Defined in -[tx/src/baseTransaction.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L51) +[tx/src/baseTransaction.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L43) ___ @@ -192,7 +217,7 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L95) +[tx/src/eip4844Transaction.ts:93](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L93) ___ @@ -202,27 +227,27 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L96) +[tx/src/eip4844Transaction.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L94) ___ -### maxFeePerGas +### maxFeePerBlobGas -• `Readonly` **maxFeePerGas**: `bigint` +• `Readonly` **maxFeePerBlobGas**: `bigint` #### Defined in -[tx/src/eip4844Transaction.ts:89](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L89) +[tx/src/eip4844Transaction.ts:88](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L88) ___ -### maxFeePerblobGas +### maxFeePerGas -• `Readonly` **maxFeePerblobGas**: `bigint` +• `Readonly` **maxFeePerGas**: `bigint` #### Defined in -[tx/src/eip4844Transaction.ts:90](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L90) +[tx/src/eip4844Transaction.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L87) ___ @@ -232,7 +257,7 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:88](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L88) +[tx/src/eip4844Transaction.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L86) ___ @@ -246,7 +271,7 @@ BaseTransaction.nonce #### Defined in -[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) +[tx/src/baseTransaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L42) ___ @@ -260,7 +285,7 @@ BaseTransaction.r #### Defined in -[tx/src/baseTransaction.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L57) +[tx/src/baseTransaction.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L49) ___ @@ -274,7 +299,7 @@ BaseTransaction.s #### Defined in -[tx/src/baseTransaction.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L58) +[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) ___ @@ -288,7 +313,7 @@ BaseTransaction.to #### Defined in -[tx/src/baseTransaction.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L52) +[tx/src/baseTransaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L44) ___ @@ -302,7 +327,7 @@ BaseTransaction.v #### Defined in -[tx/src/baseTransaction.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L56) +[tx/src/baseTransaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L48) ___ @@ -316,17 +341,7 @@ BaseTransaction.value #### Defined in -[tx/src/baseTransaction.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L53) - -___ - -### versionedHashes - -• **versionedHashes**: `Uint8Array`[] - -#### Defined in - -[tx/src/eip4844Transaction.ts:93](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L93) +[tx/src/baseTransaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L45) ## Accessors @@ -348,7 +363,7 @@ BaseTransaction.type #### Defined in -[tx/src/baseTransaction.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L128) +[tx/src/baseTransaction.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L121) ## Methods @@ -368,7 +383,7 @@ BaseTransaction.errorStr #### Defined in -[tx/src/eip4844Transaction.ts:583](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L583) +[tx/src/eip4844Transaction.ts:552](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L552) ___ @@ -388,7 +403,7 @@ BaseTransaction.getBaseFee #### Defined in -[tx/src/baseTransaction.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L205) +[tx/src/baseTransaction.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L176) ___ @@ -402,13 +417,13 @@ The amount of gas paid for the data in this tx `bigint` -#### Inherited from +#### Overrides BaseTransaction.getDataFee #### Defined in -[tx/src/baseTransaction.ts:219](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L219) +[tx/src/eip4844Transaction.ts:386](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L386) ___ @@ -432,7 +447,7 @@ BaseTransaction.getHashedMessageToSign #### Defined in -[tx/src/eip4844Transaction.ts:482](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L482) +[tx/src/eip4844Transaction.ts:483](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L483) ___ @@ -460,7 +475,7 @@ BaseTransaction.getMessageToSign #### Defined in -[tx/src/eip4844Transaction.ts:469](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L469) +[tx/src/eip4844Transaction.ts:472](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L472) ___ @@ -478,7 +493,7 @@ BaseTransaction.getMessageToVerifySignature #### Defined in -[tx/src/eip4844Transaction.ts:508](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L508) +[tx/src/eip4844Transaction.ts:497](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L497) ___ @@ -498,7 +513,7 @@ BaseTransaction.getSenderAddress #### Defined in -[tx/src/baseTransaction.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L301) +[tx/src/baseTransaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L272) ___ @@ -518,7 +533,7 @@ BaseTransaction.getSenderPublicKey #### Defined in -[tx/src/eip4844Transaction.ts:515](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L515) +[tx/src/eip4844Transaction.ts:504](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L504) ___ @@ -530,9 +545,9 @@ The up front amount that an account must have for this transaction to be valid #### Parameters -| Name | Type | Description | -| :------ | :------ | :------ | -| `baseFee` | `bigint` | The base fee of the block (will be set to 0 if not provided) | +| Name | Type | Default value | Description | +| :------ | :------ | :------ | :------ | +| `baseFee` | `bigint` | `BIGINT_0` | The base fee of the block (will be set to 0 if not provided) | #### Returns @@ -544,7 +559,7 @@ BaseTransaction.getUpfrontCost #### Defined in -[tx/src/eip4844Transaction.ts:382](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L382) +[tx/src/eip4844Transaction.ts:394](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L394) ___ @@ -566,7 +581,7 @@ BaseTransaction.getValidationErrors #### Defined in -[tx/src/baseTransaction.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L156) +[tx/src/baseTransaction.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L149) ___ @@ -589,7 +604,7 @@ BaseTransaction.hash #### Defined in -[tx/src/eip4844Transaction.ts:492](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L492) +[tx/src/eip4844Transaction.ts:493](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L493) ___ @@ -607,7 +622,7 @@ BaseTransaction.isSigned #### Defined in -[tx/src/baseTransaction.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L276) +[tx/src/baseTransaction.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L247) ___ @@ -629,7 +644,7 @@ BaseTransaction.isValid #### Defined in -[tx/src/baseTransaction.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L174) +[tx/src/baseTransaction.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L167) ___ @@ -645,7 +660,7 @@ the number of blobs included with this transaction #### Defined in -[tx/src/eip4844Transaction.ts:602](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L602) +[tx/src/eip4844Transaction.ts:571](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L571) ___ @@ -675,7 +690,7 @@ BaseTransaction.raw #### Defined in -[tx/src/eip4844Transaction.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L403) +[tx/src/eip4844Transaction.ts:411](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L411) ___ @@ -702,7 +717,7 @@ BaseTransaction.serialize #### Defined in -[tx/src/eip4844Transaction.ts:432](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L432) +[tx/src/eip4844Transaction.ts:440](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L440) ___ @@ -718,7 +733,7 @@ the serialized form of a blob transaction in the network wrapper format (used fo #### Defined in -[tx/src/eip4844Transaction.ts:440](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L440) +[tx/src/eip4844Transaction.ts:447](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L447) ___ @@ -750,7 +765,7 @@ BaseTransaction.sign #### Defined in -[tx/src/baseTransaction.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L319) +[tx/src/baseTransaction.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L290) ___ @@ -789,7 +804,7 @@ BaseTransaction.supports #### Defined in -[tx/src/baseTransaction.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L148) +[tx/src/baseTransaction.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L141) ___ @@ -809,7 +824,7 @@ BaseTransaction.toCreationAddress #### Defined in -[tx/src/baseTransaction.ts:245](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L245) +[tx/src/baseTransaction.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L216) ___ @@ -827,7 +842,7 @@ BaseTransaction.toJSON #### Defined in -[tx/src/eip4844Transaction.ts:539](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L539) +[tx/src/eip4844Transaction.ts:508](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L508) ___ @@ -847,7 +862,7 @@ BaseTransaction.verifySignature #### Defined in -[tx/src/baseTransaction.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L288) +[tx/src/baseTransaction.ts:259](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L259) ___ @@ -872,7 +887,7 @@ a BlobEIP4844Transaction #### Defined in -[tx/src/eip4844Transaction.ts:325](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L325) +[tx/src/eip4844Transaction.ts:328](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L328) ___ @@ -898,7 +913,7 @@ access_list, max_fee_per_data_gas, blob_versioned_hashes, y_parity, r, s])` #### Defined in -[tx/src/eip4844Transaction.ts:236](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L236) +[tx/src/eip4844Transaction.ts:237](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L237) ___ @@ -919,7 +934,7 @@ ___ #### Defined in -[tx/src/eip4844Transaction.ts:186](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L186) +[tx/src/eip4844Transaction.ts:182](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L182) ___ @@ -945,7 +960,7 @@ accessList, signatureYParity, signatureR, signatureS]` #### Defined in -[tx/src/eip4844Transaction.ts:260](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L260) +[tx/src/eip4844Transaction.ts:263](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L263) ___ @@ -971,4 +986,4 @@ the "minimal" representation of a BlobEIP4844Transaction (i.e. transaction objec #### Defined in -[tx/src/eip4844Transaction.ts:219](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L219) +[tx/src/eip4844Transaction.ts:217](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip4844Transaction.ts#L217) diff --git a/packages/tx/docs/classes/FeeMarketEIP1559Transaction.md b/packages/tx/docs/classes/FeeMarketEIP1559Transaction.md index 9c944a49f3..786e9b5963 100644 --- a/packages/tx/docs/classes/FeeMarketEIP1559Transaction.md +++ b/packages/tx/docs/classes/FeeMarketEIP1559Transaction.md @@ -23,6 +23,7 @@ Typed transaction with a new gas fee market mechanism - [AccessListJSON](FeeMarketEIP1559Transaction.md#accesslistjson) - [accessList](FeeMarketEIP1559Transaction.md#accesslist) +- [cache](FeeMarketEIP1559Transaction.md#cache) - [chainId](FeeMarketEIP1559Transaction.md#chainid) - [common](FeeMarketEIP1559Transaction.md#common) - [data](FeeMarketEIP1559Transaction.md#data) @@ -91,7 +92,7 @@ BaseTransaction<TransactionType.FeeMarketEIP1559\>.constructor #### Defined in -[tx/src/eip1559Transaction.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L148) +[tx/src/eip1559Transaction.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L150) ## Properties @@ -101,7 +102,7 @@ BaseTransaction<TransactionType.FeeMarketEIP1559\>.constructor #### Defined in -[tx/src/eip1559Transaction.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L47) +[tx/src/eip1559Transaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L46) ___ @@ -111,7 +112,21 @@ ___ #### Defined in -[tx/src/eip1559Transaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L46) +[tx/src/eip1559Transaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L45) + +___ + +### cache + +• **cache**: [`TransactionCache`](../interfaces/TransactionCache.md) + +#### Inherited from + +BaseTransaction.cache + +#### Defined in + +[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) ___ @@ -121,7 +136,7 @@ ___ #### Defined in -[tx/src/eip1559Transaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L45) +[tx/src/eip1559Transaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L44) ___ @@ -135,7 +150,7 @@ BaseTransaction.common #### Defined in -[tx/src/eip1559Transaction.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L51) +[tx/src/eip1559Transaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L50) ___ @@ -149,7 +164,7 @@ BaseTransaction.data #### Defined in -[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) +[tx/src/baseTransaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L46) ___ @@ -163,7 +178,7 @@ BaseTransaction.gasLimit #### Defined in -[tx/src/baseTransaction.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L51) +[tx/src/baseTransaction.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L43) ___ @@ -173,7 +188,7 @@ ___ #### Defined in -[tx/src/eip1559Transaction.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L49) +[tx/src/eip1559Transaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L48) ___ @@ -183,7 +198,7 @@ ___ #### Defined in -[tx/src/eip1559Transaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L48) +[tx/src/eip1559Transaction.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L47) ___ @@ -197,7 +212,7 @@ BaseTransaction.nonce #### Defined in -[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) +[tx/src/baseTransaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L42) ___ @@ -211,7 +226,7 @@ BaseTransaction.r #### Defined in -[tx/src/baseTransaction.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L57) +[tx/src/baseTransaction.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L49) ___ @@ -225,7 +240,7 @@ BaseTransaction.s #### Defined in -[tx/src/baseTransaction.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L58) +[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) ___ @@ -239,7 +254,7 @@ BaseTransaction.to #### Defined in -[tx/src/baseTransaction.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L52) +[tx/src/baseTransaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L44) ___ @@ -253,7 +268,7 @@ BaseTransaction.v #### Defined in -[tx/src/baseTransaction.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L56) +[tx/src/baseTransaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L48) ___ @@ -267,7 +282,7 @@ BaseTransaction.value #### Defined in -[tx/src/baseTransaction.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L53) +[tx/src/baseTransaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L45) ## Accessors @@ -289,7 +304,7 @@ BaseTransaction.type #### Defined in -[tx/src/baseTransaction.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L128) +[tx/src/baseTransaction.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L121) ## Methods @@ -309,7 +324,7 @@ BaseTransaction.errorStr #### Defined in -[tx/src/eip1559Transaction.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L403) +[tx/src/eip1559Transaction.ts:352](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L352) ___ @@ -329,7 +344,7 @@ BaseTransaction.getBaseFee #### Defined in -[tx/src/baseTransaction.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L205) +[tx/src/baseTransaction.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L176) ___ @@ -349,7 +364,7 @@ BaseTransaction.getDataFee #### Defined in -[tx/src/eip1559Transaction.ts:203](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L203) +[tx/src/eip1559Transaction.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L205) ___ @@ -373,7 +388,7 @@ BaseTransaction.getHashedMessageToSign #### Defined in -[tx/src/eip1559Transaction.ts:302](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L302) +[tx/src/eip1559Transaction.ts:283](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L283) ___ @@ -401,7 +416,7 @@ BaseTransaction.getMessageToSign #### Defined in -[tx/src/eip1559Transaction.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L289) +[tx/src/eip1559Transaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L272) ___ @@ -421,7 +436,7 @@ BaseTransaction.getMessageToVerifySignature #### Defined in -[tx/src/eip1559Transaction.ts:331](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L331) +[tx/src/eip1559Transaction.ts:300](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L300) ___ @@ -441,7 +456,7 @@ BaseTransaction.getSenderAddress #### Defined in -[tx/src/baseTransaction.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L301) +[tx/src/baseTransaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L272) ___ @@ -461,7 +476,7 @@ BaseTransaction.getSenderPublicKey #### Defined in -[tx/src/eip1559Transaction.ts:338](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L338) +[tx/src/eip1559Transaction.ts:307](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L307) ___ @@ -473,9 +488,9 @@ The up front amount that an account must have for this transaction to be valid #### Parameters -| Name | Type | Description | -| :------ | :------ | :------ | -| `baseFee` | `bigint` | The base fee of the block (will be set to 0 if not provided) | +| Name | Type | Default value | Description | +| :------ | :------ | :------ | :------ | +| `baseFee` | `bigint` | `BIGINT_0` | The base fee of the block (will be set to 0 if not provided) | #### Returns @@ -487,7 +502,7 @@ BaseTransaction.getUpfrontCost #### Defined in -[tx/src/eip1559Transaction.ts:225](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L225) +[tx/src/eip1559Transaction.ts:213](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L213) ___ @@ -509,7 +524,7 @@ BaseTransaction.getValidationErrors #### Defined in -[tx/src/baseTransaction.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L156) +[tx/src/baseTransaction.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L149) ___ @@ -532,7 +547,7 @@ BaseTransaction.hash #### Defined in -[tx/src/eip1559Transaction.ts:312](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L312) +[tx/src/eip1559Transaction.ts:293](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L293) ___ @@ -550,7 +565,7 @@ BaseTransaction.isSigned #### Defined in -[tx/src/baseTransaction.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L276) +[tx/src/baseTransaction.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L247) ___ @@ -572,7 +587,7 @@ BaseTransaction.isValid #### Defined in -[tx/src/baseTransaction.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L174) +[tx/src/baseTransaction.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L167) ___ @@ -602,7 +617,7 @@ BaseTransaction.raw #### Defined in -[tx/src/eip1559Transaction.ts:246](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L246) +[tx/src/eip1559Transaction.ts:230](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L230) ___ @@ -629,7 +644,7 @@ BaseTransaction.serialize #### Defined in -[tx/src/eip1559Transaction.ts:273](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L273) +[tx/src/eip1559Transaction.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L257) ___ @@ -661,7 +676,7 @@ BaseTransaction.sign #### Defined in -[tx/src/baseTransaction.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L319) +[tx/src/baseTransaction.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L290) ___ @@ -700,7 +715,7 @@ BaseTransaction.supports #### Defined in -[tx/src/baseTransaction.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L148) +[tx/src/baseTransaction.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L141) ___ @@ -720,7 +735,7 @@ BaseTransaction.toCreationAddress #### Defined in -[tx/src/baseTransaction.ts:245](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L245) +[tx/src/baseTransaction.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L216) ___ @@ -740,7 +755,7 @@ BaseTransaction.toJSON #### Defined in -[tx/src/eip1559Transaction.ts:387](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L387) +[tx/src/eip1559Transaction.ts:336](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L336) ___ @@ -760,7 +775,7 @@ BaseTransaction.verifySignature #### Defined in -[tx/src/baseTransaction.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L288) +[tx/src/baseTransaction.ts:259](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L259) ___ @@ -786,7 +801,7 @@ accessList, signatureYParity, signatureR, signatureS])` #### Defined in -[tx/src/eip1559Transaction.ts:73](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L73) +[tx/src/eip1559Transaction.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L72) ___ @@ -816,7 +831,7 @@ Notes: #### Defined in -[tx/src/eip1559Transaction.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L63) +[tx/src/eip1559Transaction.ts:62](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L62) ___ @@ -842,4 +857,4 @@ accessList, signatureYParity, signatureR, signatureS]` #### Defined in -[tx/src/eip1559Transaction.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L97) +[tx/src/eip1559Transaction.ts:99](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/eip1559Transaction.ts#L99) diff --git a/packages/tx/docs/classes/LegacyTransaction.md b/packages/tx/docs/classes/LegacyTransaction.md index b212c2f363..9ce1af0966 100644 --- a/packages/tx/docs/classes/LegacyTransaction.md +++ b/packages/tx/docs/classes/LegacyTransaction.md @@ -18,6 +18,7 @@ An Ethereum non-typed (legacy) transaction ### Properties +- [cache](LegacyTransaction.md#cache) - [common](LegacyTransaction.md#common) - [data](LegacyTransaction.md#data) - [gasLimit](LegacyTransaction.md#gaslimit) @@ -84,10 +85,24 @@ BaseTransaction<TransactionType.Legacy\>.constructor #### Defined in -[tx/src/legacyTransaction.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L110) +[tx/src/legacyTransaction.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L112) ## Properties +### cache + +• **cache**: [`TransactionCache`](../interfaces/TransactionCache.md) + +#### Inherited from + +BaseTransaction.cache + +#### Defined in + +[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) + +___ + ### common • `Readonly` **common**: `Common` @@ -98,7 +113,7 @@ BaseTransaction.common #### Defined in -[tx/src/legacyTransaction.ts:40](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L40) +[tx/src/legacyTransaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L42) ___ @@ -112,7 +127,7 @@ BaseTransaction.data #### Defined in -[tx/src/baseTransaction.ts:54](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L54) +[tx/src/baseTransaction.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L46) ___ @@ -126,7 +141,7 @@ BaseTransaction.gasLimit #### Defined in -[tx/src/baseTransaction.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L51) +[tx/src/baseTransaction.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L43) ___ @@ -136,7 +151,7 @@ ___ #### Defined in -[tx/src/legacyTransaction.ts:38](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L38) +[tx/src/legacyTransaction.ts:40](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L40) ___ @@ -150,7 +165,7 @@ BaseTransaction.nonce #### Defined in -[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) +[tx/src/baseTransaction.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L42) ___ @@ -164,7 +179,7 @@ BaseTransaction.r #### Defined in -[tx/src/baseTransaction.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L57) +[tx/src/baseTransaction.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L49) ___ @@ -178,7 +193,7 @@ BaseTransaction.s #### Defined in -[tx/src/baseTransaction.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L58) +[tx/src/baseTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L50) ___ @@ -192,7 +207,7 @@ BaseTransaction.to #### Defined in -[tx/src/baseTransaction.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L52) +[tx/src/baseTransaction.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L44) ___ @@ -206,7 +221,7 @@ BaseTransaction.v #### Defined in -[tx/src/baseTransaction.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L56) +[tx/src/baseTransaction.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L48) ___ @@ -220,7 +235,7 @@ BaseTransaction.value #### Defined in -[tx/src/baseTransaction.ts:53](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L53) +[tx/src/baseTransaction.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L45) ## Accessors @@ -242,7 +257,7 @@ BaseTransaction.type #### Defined in -[tx/src/baseTransaction.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L128) +[tx/src/baseTransaction.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L121) ## Methods @@ -262,7 +277,7 @@ BaseTransaction.errorStr #### Defined in -[tx/src/legacyTransaction.ts:395](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L395) +[tx/src/legacyTransaction.ts:358](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L358) ___ @@ -282,7 +297,7 @@ BaseTransaction.getBaseFee #### Defined in -[tx/src/baseTransaction.ts:205](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L205) +[tx/src/baseTransaction.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L176) ___ @@ -302,7 +317,7 @@ BaseTransaction.getDataFee #### Defined in -[tx/src/legacyTransaction.ts:230](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L230) +[tx/src/legacyTransaction.ts:233](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L233) ___ @@ -323,7 +338,7 @@ BaseTransaction.getHashedMessageToSign #### Defined in -[tx/src/legacyTransaction.ts:222](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L222) +[tx/src/legacyTransaction.ts:225](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L225) ___ @@ -353,7 +368,7 @@ BaseTransaction.getMessageToSign #### Defined in -[tx/src/legacyTransaction.ts:199](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L199) +[tx/src/legacyTransaction.ts:202](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L202) ___ @@ -373,7 +388,7 @@ BaseTransaction.getMessageToVerifySignature #### Defined in -[tx/src/legacyTransaction.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L277) +[tx/src/legacyTransaction.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L257) ___ @@ -393,7 +408,7 @@ BaseTransaction.getSenderAddress #### Defined in -[tx/src/baseTransaction.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L301) +[tx/src/baseTransaction.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L272) ___ @@ -413,7 +428,7 @@ BaseTransaction.getSenderPublicKey #### Defined in -[tx/src/legacyTransaction.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L288) +[tx/src/legacyTransaction.ts:268](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L268) ___ @@ -433,7 +448,7 @@ BaseTransaction.getUpfrontCost #### Defined in -[tx/src/legacyTransaction.ts:248](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L248) +[tx/src/legacyTransaction.ts:240](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L240) ___ @@ -455,7 +470,7 @@ BaseTransaction.getValidationErrors #### Defined in -[tx/src/baseTransaction.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L156) +[tx/src/baseTransaction.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L149) ___ @@ -478,7 +493,7 @@ BaseTransaction.hash #### Defined in -[tx/src/legacyTransaction.ts:258](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L258) +[tx/src/legacyTransaction.ts:250](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L250) ___ @@ -496,7 +511,7 @@ BaseTransaction.isSigned #### Defined in -[tx/src/baseTransaction.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L276) +[tx/src/baseTransaction.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L247) ___ @@ -518,7 +533,7 @@ BaseTransaction.isValid #### Defined in -[tx/src/baseTransaction.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L174) +[tx/src/baseTransaction.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L167) ___ @@ -548,7 +563,7 @@ BaseTransaction.raw #### Defined in -[tx/src/legacyTransaction.ts:159](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L159) +[tx/src/legacyTransaction.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L162) ___ @@ -574,7 +589,7 @@ BaseTransaction.serialize #### Defined in -[tx/src/legacyTransaction.ts:182](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L182) +[tx/src/legacyTransaction.ts:185](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L185) ___ @@ -606,7 +621,7 @@ BaseTransaction.sign #### Defined in -[tx/src/baseTransaction.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L319) +[tx/src/baseTransaction.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L290) ___ @@ -645,7 +660,7 @@ BaseTransaction.supports #### Defined in -[tx/src/baseTransaction.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L148) +[tx/src/baseTransaction.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L141) ___ @@ -665,7 +680,7 @@ BaseTransaction.toCreationAddress #### Defined in -[tx/src/baseTransaction.ts:245](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L245) +[tx/src/baseTransaction.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L216) ___ @@ -685,7 +700,7 @@ BaseTransaction.toJSON #### Defined in -[tx/src/legacyTransaction.ts:338](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L338) +[tx/src/legacyTransaction.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L301) ___ @@ -705,7 +720,7 @@ BaseTransaction.verifySignature #### Defined in -[tx/src/baseTransaction.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L288) +[tx/src/baseTransaction.ts:259](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/baseTransaction.ts#L259) ___ @@ -730,7 +745,7 @@ Format: `rlp([nonce, gasPrice, gasLimit, to, value, data, v, r, s])` #### Defined in -[tx/src/legacyTransaction.ts:59](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L59) +[tx/src/legacyTransaction.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L61) ___ @@ -758,7 +773,7 @@ Notes: #### Defined in -[tx/src/legacyTransaction.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L50) +[tx/src/legacyTransaction.ts:52](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L52) ___ @@ -783,4 +798,4 @@ Format: `[nonce, gasPrice, gasLimit, to, value, data, v, r, s]` #### Defined in -[tx/src/legacyTransaction.ts:74](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L74) +[tx/src/legacyTransaction.ts:76](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/legacyTransaction.ts#L76) diff --git a/packages/tx/docs/classes/TransactionFactory.md b/packages/tx/docs/classes/TransactionFactory.md index 6c3d1bc6a4..cad9708da3 100644 --- a/packages/tx/docs/classes/TransactionFactory.md +++ b/packages/tx/docs/classes/TransactionFactory.md @@ -16,7 +16,7 @@ ### fromBlockBodyData -▸ `Static` **fromBlockBodyData**(`data`, `txOptions?`): [`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) +▸ `Static` **fromBlockBodyData**(`data`, `txOptions?`): [`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) When decoding a BlockBody, in the transactions field, a field is either: A Uint8Array (a TypedTransaction - encoded as TransactionType || rlp(TransactionPayload)) @@ -32,7 +32,7 @@ This method returns the right transaction. #### Returns -[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) +[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) #### Defined in @@ -42,7 +42,7 @@ ___ ### fromJsonRpcProvider -▸ `Static` **fromJsonRpcProvider**(`provider`, `txHash`, `txOptions?`): `Promise`<[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md)\> +▸ `Static` **fromJsonRpcProvider**(`provider`, `txHash`, `txOptions?`): `Promise`<[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md)\> Method to retrieve a transaction from the provider @@ -56,7 +56,7 @@ Method to retrieve a transaction from the provider #### Returns -`Promise`<[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md)\> +`Promise`<[`FeeMarketEIP1559Transaction`](FeeMarketEIP1559Transaction.md) \| [`LegacyTransaction`](LegacyTransaction.md) \| [`AccessListEIP2930Transaction`](AccessListEIP2930Transaction.md) \| [`BlobEIP4844Transaction`](BlobEIP4844Transaction.md)\> the transaction specified by `txHash` diff --git a/packages/tx/docs/enums/Capability.md b/packages/tx/docs/enums/Capability.md index 95dffe3392..3856fa9f31 100644 --- a/packages/tx/docs/enums/Capability.md +++ b/packages/tx/docs/enums/Capability.md @@ -2,7 +2,7 @@ # Enumeration: Capability -Can be used in conjunction with Transaction.supports +Can be used in conjunction with [[TransactionType].supports](../interfaces/Transaction.md) to query on tx capabilities ## Table of contents diff --git a/packages/tx/docs/enums/TransactionType.md b/packages/tx/docs/enums/TransactionType.md index 6075da19db..df58c08880 100644 --- a/packages/tx/docs/enums/TransactionType.md +++ b/packages/tx/docs/enums/TransactionType.md @@ -21,7 +21,7 @@ Encompassing type for all transaction types. #### Defined in -[tx/src/types.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L101) +[tx/src/types.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L110) ___ @@ -31,7 +31,7 @@ ___ #### Defined in -[tx/src/types.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L103) +[tx/src/types.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L112) ___ @@ -41,7 +41,7 @@ ___ #### Defined in -[tx/src/types.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L102) +[tx/src/types.ts:111](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L111) ___ @@ -51,4 +51,4 @@ ___ #### Defined in -[tx/src/types.ts:100](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L100) +[tx/src/types.ts:109](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L109) diff --git a/packages/tx/docs/interfaces/AccessListEIP2930TxData.md b/packages/tx/docs/interfaces/AccessListEIP2930TxData.md index 871977f14c..a82c16a750 100644 --- a/packages/tx/docs/interfaces/AccessListEIP2930TxData.md +++ b/packages/tx/docs/interfaces/AccessListEIP2930TxData.md @@ -39,7 +39,7 @@ The access list which contains the addresses/storage slots which the transaction #### Defined in -[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) +[tx/src/types.ts:303](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L303) ___ @@ -51,7 +51,7 @@ The transaction's chain ID #### Defined in -[tx/src/types.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L247) +[tx/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L298) ___ @@ -67,7 +67,7 @@ LegacyTxData.data #### Defined in -[tx/src/types.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L216) +[tx/src/types.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L267) ___ @@ -83,7 +83,7 @@ LegacyTxData.gasLimit #### Defined in -[tx/src/types.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L201) +[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) ___ @@ -99,7 +99,7 @@ LegacyTxData.gasPrice #### Defined in -[tx/src/types.ts:196](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L196) +[tx/src/types.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L247) ___ @@ -115,7 +115,7 @@ LegacyTxData.nonce #### Defined in -[tx/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L191) +[tx/src/types.ts:242](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L242) ___ @@ -131,7 +131,7 @@ LegacyTxData.r #### Defined in -[tx/src/types.ts:226](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L226) +[tx/src/types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L277) ___ @@ -147,7 +147,7 @@ LegacyTxData.s #### Defined in -[tx/src/types.ts:231](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L231) +[tx/src/types.ts:282](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L282) ___ @@ -163,7 +163,7 @@ LegacyTxData.to #### Defined in -[tx/src/types.ts:206](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L206) +[tx/src/types.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L257) ___ @@ -179,7 +179,7 @@ LegacyTxData.type #### Defined in -[tx/src/types.ts:237](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L237) +[tx/src/types.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L288) ___ @@ -195,7 +195,7 @@ LegacyTxData.v #### Defined in -[tx/src/types.ts:221](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L221) +[tx/src/types.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L272) ___ @@ -211,4 +211,4 @@ LegacyTxData.value #### Defined in -[tx/src/types.ts:211](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L211) +[tx/src/types.ts:262](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L262) diff --git a/packages/tx/docs/interfaces/BlobEIP4844TxData.md b/packages/tx/docs/interfaces/BlobEIP4844TxData.md index 5e702c00da..d0b209d9c3 100644 --- a/packages/tx/docs/interfaces/BlobEIP4844TxData.md +++ b/packages/tx/docs/interfaces/BlobEIP4844TxData.md @@ -15,6 +15,7 @@ ### Properties - [accessList](BlobEIP4844TxData.md#accesslist) +- [blobVersionedHashes](BlobEIP4844TxData.md#blobversionedhashes) - [blobs](BlobEIP4844TxData.md#blobs) - [blobsData](BlobEIP4844TxData.md#blobsdata) - [chainId](BlobEIP4844TxData.md#chainid) @@ -23,8 +24,8 @@ - [gasPrice](BlobEIP4844TxData.md#gasprice) - [kzgCommitments](BlobEIP4844TxData.md#kzgcommitments) - [kzgProofs](BlobEIP4844TxData.md#kzgproofs) +- [maxFeePerBlobGas](BlobEIP4844TxData.md#maxfeeperblobgas) - [maxFeePerGas](BlobEIP4844TxData.md#maxfeepergas) -- [maxFeePerblobGas](BlobEIP4844TxData.md#maxfeeperblobgas) - [maxPriorityFeePerGas](BlobEIP4844TxData.md#maxpriorityfeepergas) - [nonce](BlobEIP4844TxData.md#nonce) - [r](BlobEIP4844TxData.md#r) @@ -33,7 +34,6 @@ - [type](BlobEIP4844TxData.md#type) - [v](BlobEIP4844TxData.md#v) - [value](BlobEIP4844TxData.md#value) -- [versionedHashes](BlobEIP4844TxData.md#versionedhashes) ## Properties @@ -49,7 +49,19 @@ The access list which contains the addresses/storage slots which the transaction #### Defined in -[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) +[tx/src/types.ts:303](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L303) + +___ + +### blobVersionedHashes + +• `Optional` **blobVersionedHashes**: `BytesLike`[] + +The versioned hashes used to validate the blobs attached to a transaction + +#### Defined in + +[tx/src/types.ts:332](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L332) ___ @@ -61,7 +73,7 @@ The blobs associated with a transaction #### Defined in -[tx/src/types.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L289) +[tx/src/types.ts:340](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L340) ___ @@ -73,7 +85,7 @@ An array of arbitrary strings that blobs are to be constructed from #### Defined in -[tx/src/types.ts:301](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L301) +[tx/src/types.ts:352](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L352) ___ @@ -89,7 +101,7 @@ The transaction's chain ID #### Defined in -[tx/src/types.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L247) +[tx/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L298) ___ @@ -105,7 +117,7 @@ This will contain the data of the message or the init of a contract. #### Defined in -[tx/src/types.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L216) +[tx/src/types.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L267) ___ @@ -121,7 +133,7 @@ The transaction's gas limit. #### Defined in -[tx/src/types.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L201) +[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) ___ @@ -138,7 +150,7 @@ transactions and should always be undefined for this specific transaction type. #### Defined in -[tx/src/types.ts:263](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L263) +[tx/src/types.ts:314](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L314) ___ @@ -150,7 +162,7 @@ The KZG commitments corresponding to the versioned hashes for each blob #### Defined in -[tx/src/types.ts:293](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L293) +[tx/src/types.ts:344](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L344) ___ @@ -162,35 +174,35 @@ The KZG proofs associated with the transaction #### Defined in -[tx/src/types.ts:297](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L297) +[tx/src/types.ts:348](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L348) ___ -### maxFeePerGas +### maxFeePerBlobGas -• `Optional` **maxFeePerGas**: `BigIntLike` +• `Optional` **maxFeePerBlobGas**: `BigIntLike` -The maximum total fee - -#### Inherited from - -[FeeMarketEIP1559TxData](FeeMarketEIP1559TxData.md).[maxFeePerGas](FeeMarketEIP1559TxData.md#maxfeepergas) +The maximum fee per blob gas paid for the transaction #### Defined in -[tx/src/types.ts:271](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L271) +[tx/src/types.ts:336](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L336) ___ -### maxFeePerblobGas +### maxFeePerGas -• `Optional` **maxFeePerblobGas**: `BigIntLike` +• `Optional` **maxFeePerGas**: `BigIntLike` -The maximum fee per blob gas paid for the transaction +The maximum total fee + +#### Inherited from + +[FeeMarketEIP1559TxData](FeeMarketEIP1559TxData.md).[maxFeePerGas](FeeMarketEIP1559TxData.md#maxfeepergas) #### Defined in -[tx/src/types.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L285) +[tx/src/types.ts:322](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L322) ___ @@ -206,7 +218,7 @@ The maximum inclusion fee per gas (this fee is given to the miner) #### Defined in -[tx/src/types.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L267) +[tx/src/types.ts:318](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L318) ___ @@ -222,7 +234,7 @@ The transaction's nonce. #### Defined in -[tx/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L191) +[tx/src/types.ts:242](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L242) ___ @@ -238,7 +250,7 @@ EC signature parameter. #### Defined in -[tx/src/types.ts:226](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L226) +[tx/src/types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L277) ___ @@ -254,7 +266,7 @@ EC signature parameter. #### Defined in -[tx/src/types.ts:231](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L231) +[tx/src/types.ts:282](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L282) ___ @@ -270,7 +282,7 @@ The transaction's the address is sent to. #### Defined in -[tx/src/types.ts:206](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L206) +[tx/src/types.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L257) ___ @@ -286,7 +298,7 @@ The transaction type #### Defined in -[tx/src/types.ts:237](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L237) +[tx/src/types.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L288) ___ @@ -302,7 +314,7 @@ EC recovery ID. #### Defined in -[tx/src/types.ts:221](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L221) +[tx/src/types.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L272) ___ @@ -318,16 +330,4 @@ The amount of Ether sent. #### Defined in -[tx/src/types.ts:211](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L211) - -___ - -### versionedHashes - -• `Optional` **versionedHashes**: `BytesLike`[] - -The versioned hashes used to validate the blobs attached to a transaction - -#### Defined in - -[tx/src/types.ts:281](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L281) +[tx/src/types.ts:262](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L262) diff --git a/packages/tx/docs/interfaces/EIP1559CompatibleTx.md b/packages/tx/docs/interfaces/EIP1559CompatibleTx.md new file mode 100644 index 0000000000..7ad7b85b93 --- /dev/null +++ b/packages/tx/docs/interfaces/EIP1559CompatibleTx.md @@ -0,0 +1,649 @@ +[@ethereumjs/tx](../README.md) / EIP1559CompatibleTx + +# Interface: EIP1559CompatibleTx + +## Type parameters + +| Name | Type | +| :------ | :------ | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- [`EIP2930CompatibleTx`](EIP2930CompatibleTx.md)<`T`\> + + ↳ **`EIP1559CompatibleTx`** + + ↳↳ [`EIP4844CompatibleTx`](EIP4844CompatibleTx.md) + +## Table of contents + +### Properties + +- [AccessListJSON](EIP1559CompatibleTx.md#accesslistjson) +- [accessList](EIP1559CompatibleTx.md#accesslist) +- [cache](EIP1559CompatibleTx.md#cache) +- [chainId](EIP1559CompatibleTx.md#chainid) +- [common](EIP1559CompatibleTx.md#common) +- [data](EIP1559CompatibleTx.md#data) +- [gasLimit](EIP1559CompatibleTx.md#gaslimit) +- [maxFeePerGas](EIP1559CompatibleTx.md#maxfeepergas) +- [maxPriorityFeePerGas](EIP1559CompatibleTx.md#maxpriorityfeepergas) +- [nonce](EIP1559CompatibleTx.md#nonce) +- [r](EIP1559CompatibleTx.md#r) +- [s](EIP1559CompatibleTx.md#s) +- [to](EIP1559CompatibleTx.md#to) +- [type](EIP1559CompatibleTx.md#type) +- [v](EIP1559CompatibleTx.md#v) +- [value](EIP1559CompatibleTx.md#value) + +### Methods + +- [errorStr](EIP1559CompatibleTx.md#errorstr) +- [getBaseFee](EIP1559CompatibleTx.md#getbasefee) +- [getDataFee](EIP1559CompatibleTx.md#getdatafee) +- [getHashedMessageToSign](EIP1559CompatibleTx.md#gethashedmessagetosign) +- [getMessageToSign](EIP1559CompatibleTx.md#getmessagetosign) +- [getMessageToVerifySignature](EIP1559CompatibleTx.md#getmessagetoverifysignature) +- [getSenderAddress](EIP1559CompatibleTx.md#getsenderaddress) +- [getSenderPublicKey](EIP1559CompatibleTx.md#getsenderpublickey) +- [getUpfrontCost](EIP1559CompatibleTx.md#getupfrontcost) +- [getValidationErrors](EIP1559CompatibleTx.md#getvalidationerrors) +- [hash](EIP1559CompatibleTx.md#hash) +- [isSigned](EIP1559CompatibleTx.md#issigned) +- [isValid](EIP1559CompatibleTx.md#isvalid) +- [raw](EIP1559CompatibleTx.md#raw) +- [serialize](EIP1559CompatibleTx.md#serialize) +- [sign](EIP1559CompatibleTx.md#sign) +- [supports](EIP1559CompatibleTx.md#supports) +- [toCreationAddress](EIP1559CompatibleTx.md#tocreationaddress) +- [toJSON](EIP1559CompatibleTx.md#tojson) +- [verifySignature](EIP1559CompatibleTx.md#verifysignature) + +## Properties + +### AccessListJSON + +• `Readonly` **AccessListJSON**: [`AccessList`](../README.md#accesslist) + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[AccessListJSON](EIP2930CompatibleTx.md#accesslistjson) + +#### Defined in + +[tx/src/types.ts:186](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L186) + +___ + +### accessList + +• `Readonly` **accessList**: [`AccessListBytes`](../README.md#accesslistbytes) + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[accessList](EIP2930CompatibleTx.md#accesslist) + +#### Defined in + +[tx/src/types.ts:185](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L185) + +___ + +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[cache](EIP2930CompatibleTx.md#cache) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### chainId + +• `Readonly` **chainId**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[chainId](EIP2930CompatibleTx.md#chainid) + +#### Defined in + +[tx/src/types.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L179) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[common](EIP2930CompatibleTx.md#common) + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[data](EIP2930CompatibleTx.md#data) + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[gasLimit](EIP2930CompatibleTx.md#gaslimit) + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### maxFeePerGas + +• `Readonly` **maxFeePerGas**: `bigint` + +#### Defined in + +[tx/src/types.ts:192](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L192) + +___ + +### maxPriorityFeePerGas + +• `Readonly` **maxPriorityFeePerGas**: `bigint` + +#### Defined in + +[tx/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L191) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[nonce](EIP2930CompatibleTx.md#nonce) + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[r](EIP2930CompatibleTx.md#r) + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[s](EIP2930CompatibleTx.md#s) + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[to](EIP2930CompatibleTx.md#to) + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + +### type + +• **type**: [`TransactionType`](../enums/TransactionType.md) + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[type](EIP2930CompatibleTx.md#type) + +#### Defined in + +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[v](EIP2930CompatibleTx.md#v) + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[value](EIP2930CompatibleTx.md#value) + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) + +## Methods + +### errorStr + +▸ **errorStr**(): `string` + +#### Returns + +`string` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[errorStr](EIP2930CompatibleTx.md#errorstr) + +#### Defined in + +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) + +___ + +### getBaseFee + +▸ **getBaseFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getBaseFee](EIP2930CompatibleTx.md#getbasefee) + +#### Defined in + +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) + +___ + +### getDataFee + +▸ **getDataFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getDataFee](EIP2930CompatibleTx.md#getdatafee) + +#### Defined in + +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) + +___ + +### getHashedMessageToSign + +▸ **getHashedMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getHashedMessageToSign](EIP2930CompatibleTx.md#gethashedmessagetosign) + +#### Defined in + +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) + +___ + +### getMessageToSign + +▸ **getMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getMessageToSign](EIP2930CompatibleTx.md#getmessagetosign) + +#### Defined in + +[tx/src/types.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L180) + +___ + +### getMessageToVerifySignature + +▸ **getMessageToVerifySignature**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getMessageToVerifySignature](EIP2930CompatibleTx.md#getmessagetoverifysignature) + +#### Defined in + +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) + +___ + +### getSenderAddress + +▸ **getSenderAddress**(): `Address` + +#### Returns + +`Address` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getSenderAddress](EIP2930CompatibleTx.md#getsenderaddress) + +#### Defined in + +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) + +___ + +### getSenderPublicKey + +▸ **getSenderPublicKey**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getSenderPublicKey](EIP2930CompatibleTx.md#getsenderpublickey) + +#### Defined in + +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) + +___ + +### getUpfrontCost + +▸ **getUpfrontCost**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getUpfrontCost](EIP2930CompatibleTx.md#getupfrontcost) + +#### Defined in + +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) + +___ + +### getValidationErrors + +▸ **getValidationErrors**(): `string`[] + +#### Returns + +`string`[] + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[getValidationErrors](EIP2930CompatibleTx.md#getvalidationerrors) + +#### Defined in + +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) + +___ + +### hash + +▸ **hash**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[hash](EIP2930CompatibleTx.md#hash) + +#### Defined in + +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) + +___ + +### isSigned + +▸ **isSigned**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[isSigned](EIP2930CompatibleTx.md#issigned) + +#### Defined in + +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) + +___ + +### isValid + +▸ **isValid**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[isValid](EIP2930CompatibleTx.md#isvalid) + +#### Defined in + +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) + +___ + +### raw + +▸ **raw**(): [`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Returns + +[`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[raw](EIP2930CompatibleTx.md#raw) + +#### Defined in + +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) + +___ + +### serialize + +▸ **serialize**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[serialize](EIP2930CompatibleTx.md#serialize) + +#### Defined in + +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) + +___ + +### sign + +▸ **sign**(`privateKey`): [`Transaction`](Transaction.md)[`T`] + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `privateKey` | `Uint8Array` | + +#### Returns + +[`Transaction`](Transaction.md)[`T`] + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[sign](EIP2930CompatibleTx.md#sign) + +#### Defined in + +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) + +___ + +### supports + +▸ **supports**(`capability`): `boolean` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `capability` | [`Capability`](../enums/Capability.md) | + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[supports](EIP2930CompatibleTx.md#supports) + +#### Defined in + +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) + +___ + +### toCreationAddress + +▸ **toCreationAddress**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[toCreationAddress](EIP2930CompatibleTx.md#tocreationaddress) + +#### Defined in + +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) + +___ + +### toJSON + +▸ **toJSON**(): [`JsonTx`](JsonTx.md) + +#### Returns + +[`JsonTx`](JsonTx.md) + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[toJSON](EIP2930CompatibleTx.md#tojson) + +#### Defined in + +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) + +___ + +### verifySignature + +▸ **verifySignature**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2930CompatibleTx](EIP2930CompatibleTx.md).[verifySignature](EIP2930CompatibleTx.md#verifysignature) + +#### Defined in + +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/EIP2718CompatibleTx.md b/packages/tx/docs/interfaces/EIP2718CompatibleTx.md new file mode 100644 index 0000000000..20cfc055dc --- /dev/null +++ b/packages/tx/docs/interfaces/EIP2718CompatibleTx.md @@ -0,0 +1,593 @@ +[@ethereumjs/tx](../README.md) / EIP2718CompatibleTx + +# Interface: EIP2718CompatibleTx + +## Type parameters + +| Name | Type | +| :------ | :------ | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- [`TransactionInterface`](TransactionInterface.md)<`T`\> + + ↳ **`EIP2718CompatibleTx`** + + ↳↳ [`EIP2930CompatibleTx`](EIP2930CompatibleTx.md) + +## Table of contents + +### Properties + +- [cache](EIP2718CompatibleTx.md#cache) +- [chainId](EIP2718CompatibleTx.md#chainid) +- [common](EIP2718CompatibleTx.md#common) +- [data](EIP2718CompatibleTx.md#data) +- [gasLimit](EIP2718CompatibleTx.md#gaslimit) +- [nonce](EIP2718CompatibleTx.md#nonce) +- [r](EIP2718CompatibleTx.md#r) +- [s](EIP2718CompatibleTx.md#s) +- [to](EIP2718CompatibleTx.md#to) +- [type](EIP2718CompatibleTx.md#type) +- [v](EIP2718CompatibleTx.md#v) +- [value](EIP2718CompatibleTx.md#value) + +### Methods + +- [errorStr](EIP2718CompatibleTx.md#errorstr) +- [getBaseFee](EIP2718CompatibleTx.md#getbasefee) +- [getDataFee](EIP2718CompatibleTx.md#getdatafee) +- [getHashedMessageToSign](EIP2718CompatibleTx.md#gethashedmessagetosign) +- [getMessageToSign](EIP2718CompatibleTx.md#getmessagetosign) +- [getMessageToVerifySignature](EIP2718CompatibleTx.md#getmessagetoverifysignature) +- [getSenderAddress](EIP2718CompatibleTx.md#getsenderaddress) +- [getSenderPublicKey](EIP2718CompatibleTx.md#getsenderpublickey) +- [getUpfrontCost](EIP2718CompatibleTx.md#getupfrontcost) +- [getValidationErrors](EIP2718CompatibleTx.md#getvalidationerrors) +- [hash](EIP2718CompatibleTx.md#hash) +- [isSigned](EIP2718CompatibleTx.md#issigned) +- [isValid](EIP2718CompatibleTx.md#isvalid) +- [raw](EIP2718CompatibleTx.md#raw) +- [serialize](EIP2718CompatibleTx.md#serialize) +- [sign](EIP2718CompatibleTx.md#sign) +- [supports](EIP2718CompatibleTx.md#supports) +- [toCreationAddress](EIP2718CompatibleTx.md#tocreationaddress) +- [toJSON](EIP2718CompatibleTx.md#tojson) +- [verifySignature](EIP2718CompatibleTx.md#verifysignature) + +## Properties + +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[cache](TransactionInterface.md#cache) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### chainId + +• `Readonly` **chainId**: `bigint` + +#### Defined in + +[tx/src/types.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L179) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[common](TransactionInterface.md#common) + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[data](TransactionInterface.md#data) + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[gasLimit](TransactionInterface.md#gaslimit) + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[nonce](TransactionInterface.md#nonce) + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[r](TransactionInterface.md#r) + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[s](TransactionInterface.md#s) + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[to](TransactionInterface.md#to) + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + +### type + +• **type**: [`TransactionType`](../enums/TransactionType.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[type](TransactionInterface.md#type) + +#### Defined in + +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[v](TransactionInterface.md#v) + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[value](TransactionInterface.md#value) + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) + +## Methods + +### errorStr + +▸ **errorStr**(): `string` + +#### Returns + +`string` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[errorStr](TransactionInterface.md#errorstr) + +#### Defined in + +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) + +___ + +### getBaseFee + +▸ **getBaseFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getBaseFee](TransactionInterface.md#getbasefee) + +#### Defined in + +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) + +___ + +### getDataFee + +▸ **getDataFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getDataFee](TransactionInterface.md#getdatafee) + +#### Defined in + +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) + +___ + +### getHashedMessageToSign + +▸ **getHashedMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getHashedMessageToSign](TransactionInterface.md#gethashedmessagetosign) + +#### Defined in + +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) + +___ + +### getMessageToSign + +▸ **getMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Overrides + +[TransactionInterface](TransactionInterface.md).[getMessageToSign](TransactionInterface.md#getmessagetosign) + +#### Defined in + +[tx/src/types.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L180) + +___ + +### getMessageToVerifySignature + +▸ **getMessageToVerifySignature**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getMessageToVerifySignature](TransactionInterface.md#getmessagetoverifysignature) + +#### Defined in + +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) + +___ + +### getSenderAddress + +▸ **getSenderAddress**(): `Address` + +#### Returns + +`Address` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getSenderAddress](TransactionInterface.md#getsenderaddress) + +#### Defined in + +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) + +___ + +### getSenderPublicKey + +▸ **getSenderPublicKey**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getSenderPublicKey](TransactionInterface.md#getsenderpublickey) + +#### Defined in + +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) + +___ + +### getUpfrontCost + +▸ **getUpfrontCost**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getUpfrontCost](TransactionInterface.md#getupfrontcost) + +#### Defined in + +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) + +___ + +### getValidationErrors + +▸ **getValidationErrors**(): `string`[] + +#### Returns + +`string`[] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getValidationErrors](TransactionInterface.md#getvalidationerrors) + +#### Defined in + +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) + +___ + +### hash + +▸ **hash**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[hash](TransactionInterface.md#hash) + +#### Defined in + +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) + +___ + +### isSigned + +▸ **isSigned**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[isSigned](TransactionInterface.md#issigned) + +#### Defined in + +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) + +___ + +### isValid + +▸ **isValid**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[isValid](TransactionInterface.md#isvalid) + +#### Defined in + +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) + +___ + +### raw + +▸ **raw**(): [`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Returns + +[`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[raw](TransactionInterface.md#raw) + +#### Defined in + +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) + +___ + +### serialize + +▸ **serialize**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[serialize](TransactionInterface.md#serialize) + +#### Defined in + +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) + +___ + +### sign + +▸ **sign**(`privateKey`): [`Transaction`](Transaction.md)[`T`] + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `privateKey` | `Uint8Array` | + +#### Returns + +[`Transaction`](Transaction.md)[`T`] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[sign](TransactionInterface.md#sign) + +#### Defined in + +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) + +___ + +### supports + +▸ **supports**(`capability`): `boolean` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `capability` | [`Capability`](../enums/Capability.md) | + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[supports](TransactionInterface.md#supports) + +#### Defined in + +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) + +___ + +### toCreationAddress + +▸ **toCreationAddress**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[toCreationAddress](TransactionInterface.md#tocreationaddress) + +#### Defined in + +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) + +___ + +### toJSON + +▸ **toJSON**(): [`JsonTx`](JsonTx.md) + +#### Returns + +[`JsonTx`](JsonTx.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[toJSON](TransactionInterface.md#tojson) + +#### Defined in + +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) + +___ + +### verifySignature + +▸ **verifySignature**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[verifySignature](TransactionInterface.md#verifysignature) + +#### Defined in + +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/EIP2930CompatibleTx.md b/packages/tx/docs/interfaces/EIP2930CompatibleTx.md new file mode 100644 index 0000000000..320ae726a6 --- /dev/null +++ b/packages/tx/docs/interfaces/EIP2930CompatibleTx.md @@ -0,0 +1,619 @@ +[@ethereumjs/tx](../README.md) / EIP2930CompatibleTx + +# Interface: EIP2930CompatibleTx + +## Type parameters + +| Name | Type | +| :------ | :------ | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- [`EIP2718CompatibleTx`](EIP2718CompatibleTx.md)<`T`\> + + ↳ **`EIP2930CompatibleTx`** + + ↳↳ [`EIP1559CompatibleTx`](EIP1559CompatibleTx.md) + +## Table of contents + +### Properties + +- [AccessListJSON](EIP2930CompatibleTx.md#accesslistjson) +- [accessList](EIP2930CompatibleTx.md#accesslist) +- [cache](EIP2930CompatibleTx.md#cache) +- [chainId](EIP2930CompatibleTx.md#chainid) +- [common](EIP2930CompatibleTx.md#common) +- [data](EIP2930CompatibleTx.md#data) +- [gasLimit](EIP2930CompatibleTx.md#gaslimit) +- [nonce](EIP2930CompatibleTx.md#nonce) +- [r](EIP2930CompatibleTx.md#r) +- [s](EIP2930CompatibleTx.md#s) +- [to](EIP2930CompatibleTx.md#to) +- [type](EIP2930CompatibleTx.md#type) +- [v](EIP2930CompatibleTx.md#v) +- [value](EIP2930CompatibleTx.md#value) + +### Methods + +- [errorStr](EIP2930CompatibleTx.md#errorstr) +- [getBaseFee](EIP2930CompatibleTx.md#getbasefee) +- [getDataFee](EIP2930CompatibleTx.md#getdatafee) +- [getHashedMessageToSign](EIP2930CompatibleTx.md#gethashedmessagetosign) +- [getMessageToSign](EIP2930CompatibleTx.md#getmessagetosign) +- [getMessageToVerifySignature](EIP2930CompatibleTx.md#getmessagetoverifysignature) +- [getSenderAddress](EIP2930CompatibleTx.md#getsenderaddress) +- [getSenderPublicKey](EIP2930CompatibleTx.md#getsenderpublickey) +- [getUpfrontCost](EIP2930CompatibleTx.md#getupfrontcost) +- [getValidationErrors](EIP2930CompatibleTx.md#getvalidationerrors) +- [hash](EIP2930CompatibleTx.md#hash) +- [isSigned](EIP2930CompatibleTx.md#issigned) +- [isValid](EIP2930CompatibleTx.md#isvalid) +- [raw](EIP2930CompatibleTx.md#raw) +- [serialize](EIP2930CompatibleTx.md#serialize) +- [sign](EIP2930CompatibleTx.md#sign) +- [supports](EIP2930CompatibleTx.md#supports) +- [toCreationAddress](EIP2930CompatibleTx.md#tocreationaddress) +- [toJSON](EIP2930CompatibleTx.md#tojson) +- [verifySignature](EIP2930CompatibleTx.md#verifysignature) + +## Properties + +### AccessListJSON + +• `Readonly` **AccessListJSON**: [`AccessList`](../README.md#accesslist) + +#### Defined in + +[tx/src/types.ts:186](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L186) + +___ + +### accessList + +• `Readonly` **accessList**: [`AccessListBytes`](../README.md#accesslistbytes) + +#### Defined in + +[tx/src/types.ts:185](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L185) + +___ + +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[cache](EIP2718CompatibleTx.md#cache) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### chainId + +• `Readonly` **chainId**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[chainId](EIP2718CompatibleTx.md#chainid) + +#### Defined in + +[tx/src/types.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L179) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[common](EIP2718CompatibleTx.md#common) + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[data](EIP2718CompatibleTx.md#data) + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[gasLimit](EIP2718CompatibleTx.md#gaslimit) + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[nonce](EIP2718CompatibleTx.md#nonce) + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[r](EIP2718CompatibleTx.md#r) + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[s](EIP2718CompatibleTx.md#s) + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[to](EIP2718CompatibleTx.md#to) + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + +### type + +• **type**: [`TransactionType`](../enums/TransactionType.md) + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[type](EIP2718CompatibleTx.md#type) + +#### Defined in + +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[v](EIP2718CompatibleTx.md#v) + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[value](EIP2718CompatibleTx.md#value) + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) + +## Methods + +### errorStr + +▸ **errorStr**(): `string` + +#### Returns + +`string` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[errorStr](EIP2718CompatibleTx.md#errorstr) + +#### Defined in + +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) + +___ + +### getBaseFee + +▸ **getBaseFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getBaseFee](EIP2718CompatibleTx.md#getbasefee) + +#### Defined in + +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) + +___ + +### getDataFee + +▸ **getDataFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getDataFee](EIP2718CompatibleTx.md#getdatafee) + +#### Defined in + +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) + +___ + +### getHashedMessageToSign + +▸ **getHashedMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getHashedMessageToSign](EIP2718CompatibleTx.md#gethashedmessagetosign) + +#### Defined in + +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) + +___ + +### getMessageToSign + +▸ **getMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getMessageToSign](EIP2718CompatibleTx.md#getmessagetosign) + +#### Defined in + +[tx/src/types.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L180) + +___ + +### getMessageToVerifySignature + +▸ **getMessageToVerifySignature**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getMessageToVerifySignature](EIP2718CompatibleTx.md#getmessagetoverifysignature) + +#### Defined in + +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) + +___ + +### getSenderAddress + +▸ **getSenderAddress**(): `Address` + +#### Returns + +`Address` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getSenderAddress](EIP2718CompatibleTx.md#getsenderaddress) + +#### Defined in + +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) + +___ + +### getSenderPublicKey + +▸ **getSenderPublicKey**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getSenderPublicKey](EIP2718CompatibleTx.md#getsenderpublickey) + +#### Defined in + +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) + +___ + +### getUpfrontCost + +▸ **getUpfrontCost**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getUpfrontCost](EIP2718CompatibleTx.md#getupfrontcost) + +#### Defined in + +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) + +___ + +### getValidationErrors + +▸ **getValidationErrors**(): `string`[] + +#### Returns + +`string`[] + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[getValidationErrors](EIP2718CompatibleTx.md#getvalidationerrors) + +#### Defined in + +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) + +___ + +### hash + +▸ **hash**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[hash](EIP2718CompatibleTx.md#hash) + +#### Defined in + +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) + +___ + +### isSigned + +▸ **isSigned**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[isSigned](EIP2718CompatibleTx.md#issigned) + +#### Defined in + +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) + +___ + +### isValid + +▸ **isValid**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[isValid](EIP2718CompatibleTx.md#isvalid) + +#### Defined in + +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) + +___ + +### raw + +▸ **raw**(): [`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Returns + +[`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[raw](EIP2718CompatibleTx.md#raw) + +#### Defined in + +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) + +___ + +### serialize + +▸ **serialize**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[serialize](EIP2718CompatibleTx.md#serialize) + +#### Defined in + +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) + +___ + +### sign + +▸ **sign**(`privateKey`): [`Transaction`](Transaction.md)[`T`] + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `privateKey` | `Uint8Array` | + +#### Returns + +[`Transaction`](Transaction.md)[`T`] + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[sign](EIP2718CompatibleTx.md#sign) + +#### Defined in + +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) + +___ + +### supports + +▸ **supports**(`capability`): `boolean` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `capability` | [`Capability`](../enums/Capability.md) | + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[supports](EIP2718CompatibleTx.md#supports) + +#### Defined in + +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) + +___ + +### toCreationAddress + +▸ **toCreationAddress**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[toCreationAddress](EIP2718CompatibleTx.md#tocreationaddress) + +#### Defined in + +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) + +___ + +### toJSON + +▸ **toJSON**(): [`JsonTx`](JsonTx.md) + +#### Returns + +[`JsonTx`](JsonTx.md) + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[toJSON](EIP2718CompatibleTx.md#tojson) + +#### Defined in + +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) + +___ + +### verifySignature + +▸ **verifySignature**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP2718CompatibleTx](EIP2718CompatibleTx.md).[verifySignature](EIP2718CompatibleTx.md#verifysignature) + +#### Defined in + +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/EIP4844CompatibleTx.md b/packages/tx/docs/interfaces/EIP4844CompatibleTx.md new file mode 100644 index 0000000000..83b990fba3 --- /dev/null +++ b/packages/tx/docs/interfaces/EIP4844CompatibleTx.md @@ -0,0 +1,740 @@ +[@ethereumjs/tx](../README.md) / EIP4844CompatibleTx + +# Interface: EIP4844CompatibleTx + +## Type parameters + +| Name | Type | +| :------ | :------ | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- [`EIP1559CompatibleTx`](EIP1559CompatibleTx.md)<`T`\> + + ↳ **`EIP4844CompatibleTx`** + +## Table of contents + +### Properties + +- [AccessListJSON](EIP4844CompatibleTx.md#accesslistjson) +- [accessList](EIP4844CompatibleTx.md#accesslist) +- [blobVersionedHashes](EIP4844CompatibleTx.md#blobversionedhashes) +- [blobs](EIP4844CompatibleTx.md#blobs) +- [cache](EIP4844CompatibleTx.md#cache) +- [chainId](EIP4844CompatibleTx.md#chainid) +- [common](EIP4844CompatibleTx.md#common) +- [data](EIP4844CompatibleTx.md#data) +- [gasLimit](EIP4844CompatibleTx.md#gaslimit) +- [kzgCommitments](EIP4844CompatibleTx.md#kzgcommitments) +- [kzgProofs](EIP4844CompatibleTx.md#kzgproofs) +- [maxFeePerBlobGas](EIP4844CompatibleTx.md#maxfeeperblobgas) +- [maxFeePerGas](EIP4844CompatibleTx.md#maxfeepergas) +- [maxPriorityFeePerGas](EIP4844CompatibleTx.md#maxpriorityfeepergas) +- [nonce](EIP4844CompatibleTx.md#nonce) +- [r](EIP4844CompatibleTx.md#r) +- [s](EIP4844CompatibleTx.md#s) +- [to](EIP4844CompatibleTx.md#to) +- [type](EIP4844CompatibleTx.md#type) +- [v](EIP4844CompatibleTx.md#v) +- [value](EIP4844CompatibleTx.md#value) + +### Methods + +- [errorStr](EIP4844CompatibleTx.md#errorstr) +- [getBaseFee](EIP4844CompatibleTx.md#getbasefee) +- [getDataFee](EIP4844CompatibleTx.md#getdatafee) +- [getHashedMessageToSign](EIP4844CompatibleTx.md#gethashedmessagetosign) +- [getMessageToSign](EIP4844CompatibleTx.md#getmessagetosign) +- [getMessageToVerifySignature](EIP4844CompatibleTx.md#getmessagetoverifysignature) +- [getSenderAddress](EIP4844CompatibleTx.md#getsenderaddress) +- [getSenderPublicKey](EIP4844CompatibleTx.md#getsenderpublickey) +- [getUpfrontCost](EIP4844CompatibleTx.md#getupfrontcost) +- [getValidationErrors](EIP4844CompatibleTx.md#getvalidationerrors) +- [hash](EIP4844CompatibleTx.md#hash) +- [isSigned](EIP4844CompatibleTx.md#issigned) +- [isValid](EIP4844CompatibleTx.md#isvalid) +- [numBlobs](EIP4844CompatibleTx.md#numblobs) +- [raw](EIP4844CompatibleTx.md#raw) +- [serialize](EIP4844CompatibleTx.md#serialize) +- [serializeNetworkWrapper](EIP4844CompatibleTx.md#serializenetworkwrapper) +- [sign](EIP4844CompatibleTx.md#sign) +- [supports](EIP4844CompatibleTx.md#supports) +- [toCreationAddress](EIP4844CompatibleTx.md#tocreationaddress) +- [toJSON](EIP4844CompatibleTx.md#tojson) +- [verifySignature](EIP4844CompatibleTx.md#verifysignature) + +## Properties + +### AccessListJSON + +• `Readonly` **AccessListJSON**: [`AccessList`](../README.md#accesslist) + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[AccessListJSON](EIP1559CompatibleTx.md#accesslistjson) + +#### Defined in + +[tx/src/types.ts:186](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L186) + +___ + +### accessList + +• `Readonly` **accessList**: [`AccessListBytes`](../README.md#accesslistbytes) + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[accessList](EIP1559CompatibleTx.md#accesslist) + +#### Defined in + +[tx/src/types.ts:185](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L185) + +___ + +### blobVersionedHashes + +• **blobVersionedHashes**: `Uint8Array`[] + +#### Defined in + +[tx/src/types.ts:198](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L198) + +___ + +### blobs + +• `Optional` **blobs**: `Uint8Array`[] + +#### Defined in + +[tx/src/types.ts:199](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L199) + +___ + +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[cache](EIP1559CompatibleTx.md#cache) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### chainId + +• `Readonly` **chainId**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[chainId](EIP1559CompatibleTx.md#chainid) + +#### Defined in + +[tx/src/types.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L179) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[common](EIP1559CompatibleTx.md#common) + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[data](EIP1559CompatibleTx.md#data) + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[gasLimit](EIP1559CompatibleTx.md#gaslimit) + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### kzgCommitments + +• `Optional` **kzgCommitments**: `Uint8Array`[] + +#### Defined in + +[tx/src/types.ts:200](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L200) + +___ + +### kzgProofs + +• `Optional` **kzgProofs**: `Uint8Array`[] + +#### Defined in + +[tx/src/types.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L201) + +___ + +### maxFeePerBlobGas + +• `Readonly` **maxFeePerBlobGas**: `bigint` + +#### Defined in + +[tx/src/types.ts:197](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L197) + +___ + +### maxFeePerGas + +• `Readonly` **maxFeePerGas**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[maxFeePerGas](EIP1559CompatibleTx.md#maxfeepergas) + +#### Defined in + +[tx/src/types.ts:192](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L192) + +___ + +### maxPriorityFeePerGas + +• `Readonly` **maxPriorityFeePerGas**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[maxPriorityFeePerGas](EIP1559CompatibleTx.md#maxpriorityfeepergas) + +#### Defined in + +[tx/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L191) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[nonce](EIP1559CompatibleTx.md#nonce) + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[r](EIP1559CompatibleTx.md#r) + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[s](EIP1559CompatibleTx.md#s) + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[to](EIP1559CompatibleTx.md#to) + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + +### type + +• **type**: [`TransactionType`](../enums/TransactionType.md) + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[type](EIP1559CompatibleTx.md#type) + +#### Defined in + +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[v](EIP1559CompatibleTx.md#v) + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[value](EIP1559CompatibleTx.md#value) + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) + +## Methods + +### errorStr + +▸ **errorStr**(): `string` + +#### Returns + +`string` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[errorStr](EIP1559CompatibleTx.md#errorstr) + +#### Defined in + +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) + +___ + +### getBaseFee + +▸ **getBaseFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getBaseFee](EIP1559CompatibleTx.md#getbasefee) + +#### Defined in + +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) + +___ + +### getDataFee + +▸ **getDataFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getDataFee](EIP1559CompatibleTx.md#getdatafee) + +#### Defined in + +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) + +___ + +### getHashedMessageToSign + +▸ **getHashedMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getHashedMessageToSign](EIP1559CompatibleTx.md#gethashedmessagetosign) + +#### Defined in + +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) + +___ + +### getMessageToSign + +▸ **getMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getMessageToSign](EIP1559CompatibleTx.md#getmessagetosign) + +#### Defined in + +[tx/src/types.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L180) + +___ + +### getMessageToVerifySignature + +▸ **getMessageToVerifySignature**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getMessageToVerifySignature](EIP1559CompatibleTx.md#getmessagetoverifysignature) + +#### Defined in + +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) + +___ + +### getSenderAddress + +▸ **getSenderAddress**(): `Address` + +#### Returns + +`Address` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getSenderAddress](EIP1559CompatibleTx.md#getsenderaddress) + +#### Defined in + +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) + +___ + +### getSenderPublicKey + +▸ **getSenderPublicKey**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getSenderPublicKey](EIP1559CompatibleTx.md#getsenderpublickey) + +#### Defined in + +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) + +___ + +### getUpfrontCost + +▸ **getUpfrontCost**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getUpfrontCost](EIP1559CompatibleTx.md#getupfrontcost) + +#### Defined in + +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) + +___ + +### getValidationErrors + +▸ **getValidationErrors**(): `string`[] + +#### Returns + +`string`[] + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[getValidationErrors](EIP1559CompatibleTx.md#getvalidationerrors) + +#### Defined in + +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) + +___ + +### hash + +▸ **hash**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[hash](EIP1559CompatibleTx.md#hash) + +#### Defined in + +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) + +___ + +### isSigned + +▸ **isSigned**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[isSigned](EIP1559CompatibleTx.md#issigned) + +#### Defined in + +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) + +___ + +### isValid + +▸ **isValid**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[isValid](EIP1559CompatibleTx.md#isvalid) + +#### Defined in + +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) + +___ + +### numBlobs + +▸ **numBlobs**(): `number` + +#### Returns + +`number` + +#### Defined in + +[tx/src/types.ts:203](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L203) + +___ + +### raw + +▸ **raw**(): [`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Returns + +[`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[raw](EIP1559CompatibleTx.md#raw) + +#### Defined in + +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) + +___ + +### serialize + +▸ **serialize**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[serialize](EIP1559CompatibleTx.md#serialize) + +#### Defined in + +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) + +___ + +### serializeNetworkWrapper + +▸ **serializeNetworkWrapper**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Defined in + +[tx/src/types.ts:202](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L202) + +___ + +### sign + +▸ **sign**(`privateKey`): [`Transaction`](Transaction.md)[`T`] + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `privateKey` | `Uint8Array` | + +#### Returns + +[`Transaction`](Transaction.md)[`T`] + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[sign](EIP1559CompatibleTx.md#sign) + +#### Defined in + +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) + +___ + +### supports + +▸ **supports**(`capability`): `boolean` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `capability` | [`Capability`](../enums/Capability.md) | + +#### Returns + +`boolean` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[supports](EIP1559CompatibleTx.md#supports) + +#### Defined in + +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) + +___ + +### toCreationAddress + +▸ **toCreationAddress**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[toCreationAddress](EIP1559CompatibleTx.md#tocreationaddress) + +#### Defined in + +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) + +___ + +### toJSON + +▸ **toJSON**(): [`JsonTx`](JsonTx.md) + +#### Returns + +[`JsonTx`](JsonTx.md) + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[toJSON](EIP1559CompatibleTx.md#tojson) + +#### Defined in + +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) + +___ + +### verifySignature + +▸ **verifySignature**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[EIP1559CompatibleTx](EIP1559CompatibleTx.md).[verifySignature](EIP1559CompatibleTx.md#verifysignature) + +#### Defined in + +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/FeeMarketEIP1559TxData.md b/packages/tx/docs/interfaces/FeeMarketEIP1559TxData.md index 23cf4fba05..d7a225d4d8 100644 --- a/packages/tx/docs/interfaces/FeeMarketEIP1559TxData.md +++ b/packages/tx/docs/interfaces/FeeMarketEIP1559TxData.md @@ -45,7 +45,7 @@ The access list which contains the addresses/storage slots which the transaction #### Defined in -[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) +[tx/src/types.ts:303](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L303) ___ @@ -61,7 +61,7 @@ The transaction's chain ID #### Defined in -[tx/src/types.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L247) +[tx/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L298) ___ @@ -77,7 +77,7 @@ This will contain the data of the message or the init of a contract. #### Defined in -[tx/src/types.ts:216](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L216) +[tx/src/types.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L267) ___ @@ -93,7 +93,7 @@ The transaction's gas limit. #### Defined in -[tx/src/types.ts:201](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L201) +[tx/src/types.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L252) ___ @@ -110,7 +110,7 @@ transactions and should always be undefined for this specific transaction type. #### Defined in -[tx/src/types.ts:263](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L263) +[tx/src/types.ts:314](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L314) ___ @@ -122,7 +122,7 @@ The maximum total fee #### Defined in -[tx/src/types.ts:271](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L271) +[tx/src/types.ts:322](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L322) ___ @@ -134,7 +134,7 @@ The maximum inclusion fee per gas (this fee is given to the miner) #### Defined in -[tx/src/types.ts:267](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L267) +[tx/src/types.ts:318](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L318) ___ @@ -150,7 +150,7 @@ The transaction's nonce. #### Defined in -[tx/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L191) +[tx/src/types.ts:242](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L242) ___ @@ -166,7 +166,7 @@ EC signature parameter. #### Defined in -[tx/src/types.ts:226](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L226) +[tx/src/types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L277) ___ @@ -182,7 +182,7 @@ EC signature parameter. #### Defined in -[tx/src/types.ts:231](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L231) +[tx/src/types.ts:282](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L282) ___ @@ -198,7 +198,7 @@ The transaction's the address is sent to. #### Defined in -[tx/src/types.ts:206](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L206) +[tx/src/types.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L257) ___ @@ -214,7 +214,7 @@ The transaction type #### Defined in -[tx/src/types.ts:237](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L237) +[tx/src/types.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L288) ___ @@ -230,7 +230,7 @@ EC recovery ID. #### Defined in -[tx/src/types.ts:221](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L221) +[tx/src/types.ts:272](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L272) ___ @@ -246,4 +246,4 @@ The amount of Ether sent. #### Defined in -[tx/src/types.ts:211](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L211) +[tx/src/types.ts:262](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L262) diff --git a/packages/tx/docs/interfaces/JsonRpcTx.md b/packages/tx/docs/interfaces/JsonRpcTx.md index 3b86d8170f..91cfe19f6c 100644 --- a/packages/tx/docs/interfaces/JsonRpcTx.md +++ b/packages/tx/docs/interfaces/JsonRpcTx.md @@ -7,6 +7,7 @@ ### Properties - [accessList](JsonRpcTx.md#accesslist) +- [blobVersionedHashes](JsonRpcTx.md#blobversionedhashes) - [blockHash](JsonRpcTx.md#blockhash) - [blockNumber](JsonRpcTx.md#blocknumber) - [chainId](JsonRpcTx.md#chainid) @@ -15,8 +16,8 @@ - [gasPrice](JsonRpcTx.md#gasprice) - [hash](JsonRpcTx.md#hash) - [input](JsonRpcTx.md#input) +- [maxFeePerBlobGas](JsonRpcTx.md#maxfeeperblobgas) - [maxFeePerGas](JsonRpcTx.md#maxfeepergas) -- [maxFeePerblobGas](JsonRpcTx.md#maxfeeperblobgas) - [maxPriorityFeePerGas](JsonRpcTx.md#maxpriorityfeepergas) - [nonce](JsonRpcTx.md#nonce) - [r](JsonRpcTx.md#r) @@ -26,7 +27,6 @@ - [type](JsonRpcTx.md#type) - [v](JsonRpcTx.md#v) - [value](JsonRpcTx.md#value) -- [versionedHashes](JsonRpcTx.md#versionedhashes) ## Properties @@ -36,7 +36,17 @@ #### Defined in -[tx/src/types.ts:419](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L419) +[tx/src/types.ts:470](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L470) + +___ + +### blobVersionedHashes + +• `Optional` **blobVersionedHashes**: `string`[] + +#### Defined in + +[tx/src/types.ts:482](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L482) ___ @@ -46,7 +56,7 @@ ___ #### Defined in -[tx/src/types.ts:411](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L411) +[tx/src/types.ts:462](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L462) ___ @@ -56,7 +66,7 @@ ___ #### Defined in -[tx/src/types.ts:412](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L412) +[tx/src/types.ts:463](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L463) ___ @@ -66,7 +76,7 @@ ___ #### Defined in -[tx/src/types.ts:420](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L420) +[tx/src/types.ts:471](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L471) ___ @@ -76,7 +86,7 @@ ___ #### Defined in -[tx/src/types.ts:413](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L413) +[tx/src/types.ts:464](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L464) ___ @@ -86,7 +96,7 @@ ___ #### Defined in -[tx/src/types.ts:414](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L414) +[tx/src/types.ts:465](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L465) ___ @@ -96,7 +106,7 @@ ___ #### Defined in -[tx/src/types.ts:415](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L415) +[tx/src/types.ts:466](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L466) ___ @@ -106,7 +116,7 @@ ___ #### Defined in -[tx/src/types.ts:421](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L421) +[tx/src/types.ts:472](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L472) ___ @@ -116,27 +126,27 @@ ___ #### Defined in -[tx/src/types.ts:422](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L422) +[tx/src/types.ts:473](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L473) ___ -### maxFeePerGas +### maxFeePerBlobGas -• `Optional` **maxFeePerGas**: `string` +• `Optional` **maxFeePerBlobGas**: `string` #### Defined in -[tx/src/types.ts:416](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L416) +[tx/src/types.ts:481](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L481) ___ -### maxFeePerblobGas +### maxFeePerGas -• `Optional` **maxFeePerblobGas**: `string` +• `Optional` **maxFeePerGas**: `string` #### Defined in -[tx/src/types.ts:430](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L430) +[tx/src/types.ts:467](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L467) ___ @@ -146,7 +156,7 @@ ___ #### Defined in -[tx/src/types.ts:417](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L417) +[tx/src/types.ts:468](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L468) ___ @@ -156,7 +166,7 @@ ___ #### Defined in -[tx/src/types.ts:423](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L423) +[tx/src/types.ts:474](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L474) ___ @@ -166,7 +176,7 @@ ___ #### Defined in -[tx/src/types.ts:428](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L428) +[tx/src/types.ts:479](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L479) ___ @@ -176,7 +186,7 @@ ___ #### Defined in -[tx/src/types.ts:429](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L429) +[tx/src/types.ts:480](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L480) ___ @@ -186,7 +196,7 @@ ___ #### Defined in -[tx/src/types.ts:424](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L424) +[tx/src/types.ts:475](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L475) ___ @@ -196,7 +206,7 @@ ___ #### Defined in -[tx/src/types.ts:425](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L425) +[tx/src/types.ts:476](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L476) ___ @@ -206,7 +216,7 @@ ___ #### Defined in -[tx/src/types.ts:418](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L418) +[tx/src/types.ts:469](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L469) ___ @@ -216,7 +226,7 @@ ___ #### Defined in -[tx/src/types.ts:427](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L427) +[tx/src/types.ts:478](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L478) ___ @@ -226,14 +236,4 @@ ___ #### Defined in -[tx/src/types.ts:426](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L426) - -___ - -### versionedHashes - -• `Optional` **versionedHashes**: `string`[] - -#### Defined in - -[tx/src/types.ts:431](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L431) +[tx/src/types.ts:477](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L477) diff --git a/packages/tx/docs/interfaces/JsonTx.md b/packages/tx/docs/interfaces/JsonTx.md index a64e4e88de..d345b8d8e7 100644 --- a/packages/tx/docs/interfaces/JsonTx.md +++ b/packages/tx/docs/interfaces/JsonTx.md @@ -14,12 +14,13 @@ and not all the values are present on all tx types ### Properties - [accessList](JsonTx.md#accesslist) +- [blobVersionedHashes](JsonTx.md#blobversionedhashes) - [chainId](JsonTx.md#chainid) - [data](JsonTx.md#data) - [gasLimit](JsonTx.md#gaslimit) - [gasPrice](JsonTx.md#gasprice) +- [maxFeePerBlobGas](JsonTx.md#maxfeeperblobgas) - [maxFeePerGas](JsonTx.md#maxfeepergas) -- [maxFeePerblobGas](JsonTx.md#maxfeeperblobgas) - [maxPriorityFeePerGas](JsonTx.md#maxpriorityfeepergas) - [nonce](JsonTx.md#nonce) - [r](JsonTx.md#r) @@ -28,7 +29,6 @@ and not all the values are present on all tx types - [type](JsonTx.md#type) - [v](JsonTx.md#v) - [value](JsonTx.md#value) -- [versionedHashes](JsonTx.md#versionedhashes) ## Properties @@ -38,7 +38,17 @@ and not all the values are present on all tx types #### Defined in -[tx/src/types.ts:399](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L399) +[tx/src/types.ts:450](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L450) + +___ + +### blobVersionedHashes + +• `Optional` **blobVersionedHashes**: `string`[] + +#### Defined in + +[tx/src/types.ts:455](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L455) ___ @@ -48,7 +58,7 @@ ___ #### Defined in -[tx/src/types.ts:398](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L398) +[tx/src/types.ts:449](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L449) ___ @@ -58,7 +68,7 @@ ___ #### Defined in -[tx/src/types.ts:393](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L393) +[tx/src/types.ts:444](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L444) ___ @@ -68,7 +78,7 @@ ___ #### Defined in -[tx/src/types.ts:391](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L391) +[tx/src/types.ts:442](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L442) ___ @@ -78,27 +88,27 @@ ___ #### Defined in -[tx/src/types.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L390) +[tx/src/types.ts:441](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L441) ___ -### maxFeePerGas +### maxFeePerBlobGas -• `Optional` **maxFeePerGas**: `string` +• `Optional` **maxFeePerBlobGas**: `string` #### Defined in -[tx/src/types.ts:402](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L402) +[tx/src/types.ts:454](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L454) ___ -### maxFeePerblobGas +### maxFeePerGas -• `Optional` **maxFeePerblobGas**: `string` +• `Optional` **maxFeePerGas**: `string` #### Defined in -[tx/src/types.ts:403](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L403) +[tx/src/types.ts:453](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L453) ___ @@ -108,7 +118,7 @@ ___ #### Defined in -[tx/src/types.ts:401](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L401) +[tx/src/types.ts:452](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L452) ___ @@ -118,7 +128,7 @@ ___ #### Defined in -[tx/src/types.ts:389](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L389) +[tx/src/types.ts:440](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L440) ___ @@ -128,7 +138,7 @@ ___ #### Defined in -[tx/src/types.ts:395](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L395) +[tx/src/types.ts:446](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L446) ___ @@ -138,7 +148,7 @@ ___ #### Defined in -[tx/src/types.ts:396](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L396) +[tx/src/types.ts:447](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L447) ___ @@ -148,7 +158,7 @@ ___ #### Defined in -[tx/src/types.ts:392](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L392) +[tx/src/types.ts:443](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L443) ___ @@ -158,7 +168,7 @@ ___ #### Defined in -[tx/src/types.ts:400](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L400) +[tx/src/types.ts:451](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L451) ___ @@ -168,7 +178,7 @@ ___ #### Defined in -[tx/src/types.ts:394](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L394) +[tx/src/types.ts:445](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L445) ___ @@ -178,14 +188,4 @@ ___ #### Defined in -[tx/src/types.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L397) - -___ - -### versionedHashes - -• `Optional` **versionedHashes**: `string`[] - -#### Defined in - -[tx/src/types.ts:404](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L404) +[tx/src/types.ts:448](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L448) diff --git a/packages/tx/docs/interfaces/LegacyTxInterface.md b/packages/tx/docs/interfaces/LegacyTxInterface.md new file mode 100644 index 0000000000..c7b82b833d --- /dev/null +++ b/packages/tx/docs/interfaces/LegacyTxInterface.md @@ -0,0 +1,580 @@ +[@ethereumjs/tx](../README.md) / LegacyTxInterface + +# Interface: LegacyTxInterface + +## Type parameters + +| Name | Type | +| :------ | :------ | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- [`TransactionInterface`](TransactionInterface.md)<`T`\> + + ↳ **`LegacyTxInterface`** + +## Table of contents + +### Properties + +- [cache](LegacyTxInterface.md#cache) +- [common](LegacyTxInterface.md#common) +- [data](LegacyTxInterface.md#data) +- [gasLimit](LegacyTxInterface.md#gaslimit) +- [nonce](LegacyTxInterface.md#nonce) +- [r](LegacyTxInterface.md#r) +- [s](LegacyTxInterface.md#s) +- [to](LegacyTxInterface.md#to) +- [type](LegacyTxInterface.md#type) +- [v](LegacyTxInterface.md#v) +- [value](LegacyTxInterface.md#value) + +### Methods + +- [errorStr](LegacyTxInterface.md#errorstr) +- [getBaseFee](LegacyTxInterface.md#getbasefee) +- [getDataFee](LegacyTxInterface.md#getdatafee) +- [getHashedMessageToSign](LegacyTxInterface.md#gethashedmessagetosign) +- [getMessageToSign](LegacyTxInterface.md#getmessagetosign) +- [getMessageToVerifySignature](LegacyTxInterface.md#getmessagetoverifysignature) +- [getSenderAddress](LegacyTxInterface.md#getsenderaddress) +- [getSenderPublicKey](LegacyTxInterface.md#getsenderpublickey) +- [getUpfrontCost](LegacyTxInterface.md#getupfrontcost) +- [getValidationErrors](LegacyTxInterface.md#getvalidationerrors) +- [hash](LegacyTxInterface.md#hash) +- [isSigned](LegacyTxInterface.md#issigned) +- [isValid](LegacyTxInterface.md#isvalid) +- [raw](LegacyTxInterface.md#raw) +- [serialize](LegacyTxInterface.md#serialize) +- [sign](LegacyTxInterface.md#sign) +- [supports](LegacyTxInterface.md#supports) +- [toCreationAddress](LegacyTxInterface.md#tocreationaddress) +- [toJSON](LegacyTxInterface.md#tojson) +- [verifySignature](LegacyTxInterface.md#verifysignature) + +## Properties + +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[cache](TransactionInterface.md#cache) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[common](TransactionInterface.md#common) + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[data](TransactionInterface.md#data) + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[gasLimit](TransactionInterface.md#gaslimit) + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[nonce](TransactionInterface.md#nonce) + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[r](TransactionInterface.md#r) + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[s](TransactionInterface.md#s) + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[to](TransactionInterface.md#to) + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + +### type + +• **type**: [`TransactionType`](../enums/TransactionType.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[type](TransactionInterface.md#type) + +#### Defined in + +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[v](TransactionInterface.md#v) + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[value](TransactionInterface.md#value) + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) + +## Methods + +### errorStr + +▸ **errorStr**(): `string` + +#### Returns + +`string` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[errorStr](TransactionInterface.md#errorstr) + +#### Defined in + +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) + +___ + +### getBaseFee + +▸ **getBaseFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getBaseFee](TransactionInterface.md#getbasefee) + +#### Defined in + +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) + +___ + +### getDataFee + +▸ **getDataFee**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getDataFee](TransactionInterface.md#getdatafee) + +#### Defined in + +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) + +___ + +### getHashedMessageToSign + +▸ **getHashedMessageToSign**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getHashedMessageToSign](TransactionInterface.md#gethashedmessagetosign) + +#### Defined in + +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) + +___ + +### getMessageToSign + +▸ **getMessageToSign**(): `Uint8Array` \| `Uint8Array`[] + +#### Returns + +`Uint8Array` \| `Uint8Array`[] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getMessageToSign](TransactionInterface.md#getmessagetosign) + +#### Defined in + +[tx/src/types.ts:159](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L159) + +___ + +### getMessageToVerifySignature + +▸ **getMessageToVerifySignature**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getMessageToVerifySignature](TransactionInterface.md#getmessagetoverifysignature) + +#### Defined in + +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) + +___ + +### getSenderAddress + +▸ **getSenderAddress**(): `Address` + +#### Returns + +`Address` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getSenderAddress](TransactionInterface.md#getsenderaddress) + +#### Defined in + +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) + +___ + +### getSenderPublicKey + +▸ **getSenderPublicKey**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getSenderPublicKey](TransactionInterface.md#getsenderpublickey) + +#### Defined in + +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) + +___ + +### getUpfrontCost + +▸ **getUpfrontCost**(): `bigint` + +#### Returns + +`bigint` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getUpfrontCost](TransactionInterface.md#getupfrontcost) + +#### Defined in + +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) + +___ + +### getValidationErrors + +▸ **getValidationErrors**(): `string`[] + +#### Returns + +`string`[] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[getValidationErrors](TransactionInterface.md#getvalidationerrors) + +#### Defined in + +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) + +___ + +### hash + +▸ **hash**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[hash](TransactionInterface.md#hash) + +#### Defined in + +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) + +___ + +### isSigned + +▸ **isSigned**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[isSigned](TransactionInterface.md#issigned) + +#### Defined in + +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) + +___ + +### isValid + +▸ **isValid**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[isValid](TransactionInterface.md#isvalid) + +#### Defined in + +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) + +___ + +### raw + +▸ **raw**(): [`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Returns + +[`TxValuesArray`](TxValuesArray.md)[`T`] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[raw](TransactionInterface.md#raw) + +#### Defined in + +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) + +___ + +### serialize + +▸ **serialize**(): `Uint8Array` + +#### Returns + +`Uint8Array` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[serialize](TransactionInterface.md#serialize) + +#### Defined in + +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) + +___ + +### sign + +▸ **sign**(`privateKey`): [`Transaction`](Transaction.md)[`T`] + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `privateKey` | `Uint8Array` | + +#### Returns + +[`Transaction`](Transaction.md)[`T`] + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[sign](TransactionInterface.md#sign) + +#### Defined in + +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) + +___ + +### supports + +▸ **supports**(`capability`): `boolean` + +#### Parameters + +| Name | Type | +| :------ | :------ | +| `capability` | [`Capability`](../enums/Capability.md) | + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[supports](TransactionInterface.md#supports) + +#### Defined in + +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) + +___ + +### toCreationAddress + +▸ **toCreationAddress**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[toCreationAddress](TransactionInterface.md#tocreationaddress) + +#### Defined in + +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) + +___ + +### toJSON + +▸ **toJSON**(): [`JsonTx`](JsonTx.md) + +#### Returns + +[`JsonTx`](JsonTx.md) + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[toJSON](TransactionInterface.md#tojson) + +#### Defined in + +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) + +___ + +### verifySignature + +▸ **verifySignature**(): `boolean` + +#### Returns + +`boolean` + +#### Inherited from + +[TransactionInterface](TransactionInterface.md).[verifySignature](TransactionInterface.md#verifysignature) + +#### Defined in + +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/Transaction.md b/packages/tx/docs/interfaces/Transaction.md index 4de1d9a8b0..511db46217 100644 --- a/packages/tx/docs/interfaces/Transaction.md +++ b/packages/tx/docs/interfaces/Transaction.md @@ -19,7 +19,7 @@ #### Defined in -[tx/src/types.ts:107](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L107) +[tx/src/types.ts:116](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L116) ___ @@ -29,7 +29,7 @@ ___ #### Defined in -[tx/src/types.ts:109](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L109) +[tx/src/types.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L118) ___ @@ -39,7 +39,7 @@ ___ #### Defined in -[tx/src/types.ts:108](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L108) +[tx/src/types.ts:117](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L117) ___ @@ -49,4 +49,4 @@ ___ #### Defined in -[tx/src/types.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L110) +[tx/src/types.ts:119](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L119) diff --git a/packages/tx/docs/interfaces/TransactionCache.md b/packages/tx/docs/interfaces/TransactionCache.md new file mode 100644 index 0000000000..e806707eb4 --- /dev/null +++ b/packages/tx/docs/interfaces/TransactionCache.md @@ -0,0 +1,48 @@ +[@ethereumjs/tx](../README.md) / TransactionCache + +# Interface: TransactionCache + +## Table of contents + +### Properties + +- [dataFee](TransactionCache.md#datafee) +- [hash](TransactionCache.md#hash) +- [senderPubKey](TransactionCache.md#senderpubkey) + +## Properties + +### dataFee + +• `Optional` **dataFee**: `Object` + +#### Type declaration + +| Name | Type | +| :------ | :------ | +| `hardfork` | `string` | +| `value` | `bigint` | + +#### Defined in + +[tx/src/types.ts:98](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L98) + +___ + +### hash + +• `Optional` **hash**: `Uint8Array` + +#### Defined in + +[tx/src/types.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L97) + +___ + +### senderPubKey + +• `Optional` **senderPubKey**: `Uint8Array` + +#### Defined in + +[tx/src/types.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L102) diff --git a/packages/tx/docs/interfaces/TransactionInterface.md b/packages/tx/docs/interfaces/TransactionInterface.md index 1991069e1b..2c81fa286e 100644 --- a/packages/tx/docs/interfaces/TransactionInterface.md +++ b/packages/tx/docs/interfaces/TransactionInterface.md @@ -6,13 +6,31 @@ | Name | Type | | :------ | :------ | -| `T` | extends [`TransactionType`](../enums/TransactionType.md) | +| `T` | extends [`TransactionType`](../enums/TransactionType.md) = [`TransactionType`](../enums/TransactionType.md) | + +## Hierarchy + +- **`TransactionInterface`** + + ↳ [`LegacyTxInterface`](LegacyTxInterface.md) + + ↳ [`EIP2718CompatibleTx`](EIP2718CompatibleTx.md) ## Table of contents ### Properties +- [cache](TransactionInterface.md#cache) +- [common](TransactionInterface.md#common) +- [data](TransactionInterface.md#data) +- [gasLimit](TransactionInterface.md#gaslimit) +- [nonce](TransactionInterface.md#nonce) +- [r](TransactionInterface.md#r) +- [s](TransactionInterface.md#s) +- [to](TransactionInterface.md#to) - [type](TransactionInterface.md#type) +- [v](TransactionInterface.md#v) +- [value](TransactionInterface.md#value) ### Methods @@ -39,13 +57,113 @@ ## Properties +### cache + +• `Readonly` **cache**: [`TransactionCache`](TransactionCache.md) + +#### Defined in + +[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) + +___ + +### common + +• `Readonly` **common**: `Common` + +#### Defined in + +[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) + +___ + +### data + +• `Readonly` **data**: `Uint8Array` + +#### Defined in + +[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) + +___ + +### gasLimit + +• `Readonly` **gasLimit**: `bigint` + +#### Defined in + +[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) + +___ + +### nonce + +• `Readonly` **nonce**: `bigint` + +#### Defined in + +[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) + +___ + +### r + +• `Optional` `Readonly` **r**: `bigint` + +#### Defined in + +[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) + +___ + +### s + +• `Optional` `Readonly` **s**: `bigint` + +#### Defined in + +[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) + +___ + +### to + +• `Optional` `Readonly` **to**: `Address` + +#### Defined in + +[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) + +___ + ### type -• **type**: `number` +• **type**: [`TransactionType`](../enums/TransactionType.md) #### Defined in -[tx/src/types.ts:133](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L133) +[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) + +___ + +### v + +• `Optional` `Readonly` **v**: `bigint` + +#### Defined in + +[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) + +___ + +### value + +• `Readonly` **value**: `bigint` + +#### Defined in + +[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) ## Methods @@ -59,7 +177,7 @@ #### Defined in -[tx/src/types.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L152) +[tx/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L171) ___ @@ -73,7 +191,7 @@ ___ #### Defined in -[tx/src/types.ts:134](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L134) +[tx/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L153) ___ @@ -87,7 +205,7 @@ ___ #### Defined in -[tx/src/types.ts:135](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L135) +[tx/src/types.ts:154](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L154) ___ @@ -101,7 +219,7 @@ ___ #### Defined in -[tx/src/types.ts:141](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L141) +[tx/src/types.ts:160](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L160) ___ @@ -115,7 +233,7 @@ ___ #### Defined in -[tx/src/types.ts:140](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L140) +[tx/src/types.ts:159](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L159) ___ @@ -129,7 +247,7 @@ ___ #### Defined in -[tx/src/types.ts:143](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L143) +[tx/src/types.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L162) ___ @@ -143,7 +261,7 @@ ___ #### Defined in -[tx/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L148) +[tx/src/types.ts:167](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L167) ___ @@ -157,7 +275,7 @@ ___ #### Defined in -[tx/src/types.ts:149](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L149) +[tx/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L168) ___ @@ -171,7 +289,7 @@ ___ #### Defined in -[tx/src/types.ts:136](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L136) +[tx/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L155) ___ @@ -185,7 +303,7 @@ ___ #### Defined in -[tx/src/types.ts:144](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L144) +[tx/src/types.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L163) ___ @@ -199,7 +317,7 @@ ___ #### Defined in -[tx/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L142) +[tx/src/types.ts:161](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L161) ___ @@ -213,7 +331,7 @@ ___ #### Defined in -[tx/src/types.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L145) +[tx/src/types.ts:164](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L164) ___ @@ -227,7 +345,7 @@ ___ #### Defined in -[tx/src/types.ts:146](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L146) +[tx/src/types.ts:165](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L165) ___ @@ -241,7 +359,7 @@ ___ #### Defined in -[tx/src/types.ts:138](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L138) +[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) ___ @@ -255,7 +373,7 @@ ___ #### Defined in -[tx/src/types.ts:139](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L139) +[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) ___ @@ -275,7 +393,7 @@ ___ #### Defined in -[tx/src/types.ts:150](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L150) +[tx/src/types.ts:169](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L169) ___ @@ -295,7 +413,7 @@ ___ #### Defined in -[tx/src/types.ts:132](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L132) +[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) ___ @@ -309,7 +427,7 @@ ___ #### Defined in -[tx/src/types.ts:137](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L137) +[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) ___ @@ -323,7 +441,7 @@ ___ #### Defined in -[tx/src/types.ts:151](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L151) +[tx/src/types.ts:170](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L170) ___ @@ -337,4 +455,4 @@ ___ #### Defined in -[tx/src/types.ts:147](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L147) +[tx/src/types.ts:166](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L166) diff --git a/packages/tx/docs/interfaces/TxData.md b/packages/tx/docs/interfaces/TxData.md index 62335de250..1257ff0e03 100644 --- a/packages/tx/docs/interfaces/TxData.md +++ b/packages/tx/docs/interfaces/TxData.md @@ -19,7 +19,7 @@ #### Defined in -[tx/src/types.ts:156](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L156) +[tx/src/types.ts:207](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L207) ___ @@ -29,7 +29,7 @@ ___ #### Defined in -[tx/src/types.ts:157](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L157) +[tx/src/types.ts:208](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L208) ___ @@ -39,7 +39,7 @@ ___ #### Defined in -[tx/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L158) +[tx/src/types.ts:209](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L209) ___ @@ -49,4 +49,4 @@ ___ #### Defined in -[tx/src/types.ts:159](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L159) +[tx/src/types.ts:210](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L210) diff --git a/packages/tx/docs/interfaces/TxValuesArray.md b/packages/tx/docs/interfaces/TxValuesArray.md index f7cefd4179..03a201642b 100644 --- a/packages/tx/docs/interfaces/TxValuesArray.md +++ b/packages/tx/docs/interfaces/TxValuesArray.md @@ -19,7 +19,7 @@ #### Defined in -[tx/src/types.ts:305](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L305) +[tx/src/types.ts:356](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L356) ___ @@ -29,7 +29,7 @@ ___ #### Defined in -[tx/src/types.ts:306](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L306) +[tx/src/types.ts:357](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L357) ___ @@ -39,7 +39,7 @@ ___ #### Defined in -[tx/src/types.ts:307](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L307) +[tx/src/types.ts:358](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L358) ___ @@ -49,4 +49,4 @@ ___ #### Defined in -[tx/src/types.ts:308](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L308) +[tx/src/types.ts:359](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/tx/src/types.ts#L359) diff --git a/packages/tx/package.json b/packages/tx/package.json index 156dbc6ff8..063eeae7f7 100644 --- a/packages/tx/package.json +++ b/packages/tx/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/tx", - "version": "5.0.0", + "version": "5.1.0", "description": "Implementation of the various Ethereum Transaction Types", "keywords": [ "ethereum", @@ -56,9 +56,9 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/util": "^9.0.1", "ethereum-cryptography": "^2.1.2" }, "peerDependencies": { diff --git a/packages/util/CHANGELOG.md b/packages/util/CHANGELOG.md index 422f425dd8..cc1e44613d 100644 --- a/packages/util/CHANGELOG.md +++ b/packages/util/CHANGELOG.md @@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 9.0.1 - 2023-10-26 + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update peer dependency for `kzg` module to use the official trusted setup for `mainnet`, PR [#3107](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3107) + +### Other Changes + +- Performance: New reoccurringly used BigInt constants (`BIGINT_0`, `BIGINT_32`, `BIGINT_2EXP96`,...) in the `bytes` module for reusage along performance optimizations, PR [#3050](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3050) +- Performance: `bytesToBigInt()` performance optimization for 1-byte bytes, PR [#3054](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3054) +- Fix a bug in `fromUtf8()`, PR [#3112](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3112) + ## 9.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/util/docs/README.md b/packages/util/docs/README.md index 953bda072c..1da20cd2a9 100644 --- a/packages/util/docs/README.md +++ b/packages/util/docs/README.md @@ -53,6 +53,27 @@ ### Variables +- [BIGINT\_0](README.md#bigint_0) +- [BIGINT\_1](README.md#bigint_1) +- [BIGINT\_128](README.md#bigint_128) +- [BIGINT\_160](README.md#bigint_160) +- [BIGINT\_2](README.md#bigint_2) +- [BIGINT\_224](README.md#bigint_224) +- [BIGINT\_255](README.md#bigint_255) +- [BIGINT\_256](README.md#bigint_256) +- [BIGINT\_27](README.md#bigint_27) +- [BIGINT\_28](README.md#bigint_28) +- [BIGINT\_2EXP160](README.md#bigint_2exp160) +- [BIGINT\_2EXP224](README.md#bigint_2exp224) +- [BIGINT\_2EXP96](README.md#bigint_2exp96) +- [BIGINT\_3](README.md#bigint_3) +- [BIGINT\_31](README.md#bigint_31) +- [BIGINT\_32](README.md#bigint_32) +- [BIGINT\_64](README.md#bigint_64) +- [BIGINT\_7](README.md#bigint_7) +- [BIGINT\_8](README.md#bigint_8) +- [BIGINT\_96](README.md#bigint_96) +- [BIGINT\_NEG1](README.md#bigint_neg1) - [GWEI\_TO\_WEI](README.md#gwei_to_wei) - [KECCAK256\_NULL](README.md#keccak256_null) - [KECCAK256\_NULL\_S](README.md#keccak256_null_s) @@ -156,7 +177,7 @@ #### Defined in -[packages/util/src/account.ts:31](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L31) +[packages/util/src/account.ts:29](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L29) ___ @@ -286,7 +307,7 @@ ___ #### Defined in -[packages/util/src/bytes.ts:229](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L229) +[packages/util/src/bytes.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L244) ___ @@ -315,7 +336,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:29](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L29) +[packages/util/src/withdrawal.ts:30](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L30) ___ @@ -337,10 +358,222 @@ match CL representation and for eventual ssz withdrawalsRoot #### Defined in -[packages/util/src/withdrawal.ts:11](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L11) +[packages/util/src/withdrawal.ts:12](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L12) ## Variables +### BIGINT\_0 + +• `Const` **BIGINT\_0**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L82) + +___ + +### BIGINT\_1 + +• `Const` **BIGINT\_1**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L83) + +___ + +### BIGINT\_128 + +• `Const` **BIGINT\_128**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:95](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L95) + +___ + +### BIGINT\_160 + +• `Const` **BIGINT\_160**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:100](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L100) + +___ + +### BIGINT\_2 + +• `Const` **BIGINT\_2**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L84) + +___ + +### BIGINT\_224 + +• `Const` **BIGINT\_224**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:101](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L101) + +___ + +### BIGINT\_255 + +• `Const` **BIGINT\_255**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L96) + +___ + +### BIGINT\_256 + +• `Const` **BIGINT\_256**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L97) + +___ + +### BIGINT\_27 + +• `Const` **BIGINT\_27**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:89](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L89) + +___ + +### BIGINT\_28 + +• `Const` **BIGINT\_28**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:90](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L90) + +___ + +### BIGINT\_2EXP160 + +• `Const` **BIGINT\_2EXP160**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L103) + +___ + +### BIGINT\_2EXP224 + +• `Const` **BIGINT\_2EXP224**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L104) + +___ + +### BIGINT\_2EXP96 + +• `Const` **BIGINT\_2EXP96**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:102](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L102) + +___ + +### BIGINT\_3 + +• `Const` **BIGINT\_3**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:85](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L85) + +___ + +### BIGINT\_31 + +• `Const` **BIGINT\_31**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:91](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L91) + +___ + +### BIGINT\_32 + +• `Const` **BIGINT\_32**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:92](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L92) + +___ + +### BIGINT\_64 + +• `Const` **BIGINT\_64**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:93](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L93) + +___ + +### BIGINT\_7 + +• `Const` **BIGINT\_7**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:86](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L86) + +___ + +### BIGINT\_8 + +• `Const` **BIGINT\_8**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L87) + +___ + +### BIGINT\_96 + +• `Const` **BIGINT\_96**: `bigint` + +#### Defined in + +[packages/util/src/constants.ts:99](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L99) + +___ + +### BIGINT\_NEG1 + +• `Const` **BIGINT\_NEG1**: `bigint` + +BigInt constants + +#### Defined in + +[packages/util/src/constants.ts:80](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/constants.ts#L80) + +___ + ### GWEI\_TO\_WEI • `Const` **GWEI\_TO\_WEI**: `bigint` @@ -553,7 +786,7 @@ ___ #### Defined in -[packages/util/src/account.ts:350](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L350) +[packages/util/src/account.ts:357](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L357) ___ @@ -578,7 +811,7 @@ RLP encoded version of the account #### Defined in -[packages/util/src/account.ts:376](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L376) +[packages/util/src/account.ts:383](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L383) ___ @@ -598,7 +831,7 @@ ___ #### Defined in -[packages/util/src/account.ts:361](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L361) +[packages/util/src/account.ts:368](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L368) ___ @@ -620,7 +853,7 @@ Adds "0x" to a given `string` if it does not already start with "0x". #### Defined in -[packages/util/src/bytes.ts:309](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L309) +[packages/util/src/bytes.ts:324](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L324) ___ @@ -668,7 +901,7 @@ Converts a bigint to a Uint8Array #### Defined in -[packages/util/src/bytes.ts:120](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L120) +[packages/util/src/bytes.ts:135](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L135) ___ @@ -690,7 +923,7 @@ Converts a bigint to a `0x` prefixed hex string #### Defined in -[packages/util/src/bytes.ts:363](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L363) +[packages/util/src/bytes.ts:378](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L378) ___ @@ -713,7 +946,7 @@ Convert value from bigint to an unpadded Uint8Array #### Defined in -[packages/util/src/bytes.ts:373](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L373) +[packages/util/src/bytes.ts:388](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L388) ___ @@ -776,7 +1009,7 @@ Converts a Uint8Array to a bigint #### Defined in -[packages/util/src/bytes.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L47) +[packages/util/src/bytes.ts:55](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L55) ___ @@ -796,7 +1029,7 @@ ___ #### Defined in -[packages/util/src/bytes.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L33) +[packages/util/src/bytes.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L35) ___ @@ -822,7 +1055,7 @@ If the input number exceeds 53 bits. #### Defined in -[packages/util/src/bytes.ts:61](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L61) +[packages/util/src/bytes.ts:76](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L76) ___ @@ -920,7 +1153,7 @@ A positive number if value1 is larger than value2, #### Defined in -[packages/util/src/bytes.ts:396](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L396) +[packages/util/src/bytes.ts:411](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L411) ___ @@ -974,7 +1207,7 @@ works like `Buffer.concat` #### Defined in -[packages/util/src/bytes.ts:420](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L420) +[packages/util/src/bytes.ts:435](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L435) ___ @@ -1003,7 +1236,7 @@ Recovered public key #### Defined in -[packages/util/src/signature.ts:64](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L64) +[packages/util/src/signature.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L71) ___ @@ -1030,7 +1263,7 @@ accordingly, otherwise return a "static" `v` just derived from the `recovery` bi #### Defined in -[packages/util/src/signature.ts:28](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L28) +[packages/util/src/signature.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L35) ___ @@ -1128,7 +1361,7 @@ it's a signed message (EIP-191 or EIP-712) adding `27` at the end. Remove if nee #### Defined in -[packages/util/src/signature.ts:135](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L135) +[packages/util/src/signature.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L142) ___ @@ -1150,7 +1383,7 @@ Interprets a `Uint8Array` as a signed integer and returns a `BigInt`. Assumes 25 #### Defined in -[packages/util/src/bytes.ts:291](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L291) +[packages/util/src/bytes.ts:306](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L306) ___ @@ -1197,7 +1430,7 @@ Generates an address of a newly created contract. #### Defined in -[packages/util/src/account.ts:200](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L200) +[packages/util/src/account.ts:207](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L207) ___ @@ -1221,7 +1454,7 @@ Generates an address for a contract created using CREATE2. #### Defined in -[packages/util/src/account.ts:220](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L220) +[packages/util/src/account.ts:227](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L227) ___ @@ -1346,7 +1579,7 @@ used to produce the signature. #### Defined in -[packages/util/src/signature.ts:212](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L212) +[packages/util/src/signature.ts:219](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L219) ___ @@ -1366,7 +1599,7 @@ ___ #### Defined in -[packages/util/src/bytes.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L67) +[packages/util/src/bytes.ts:82](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L82) ___ @@ -1388,7 +1621,7 @@ Converts a public key to the Ethereum format. #### Defined in -[packages/util/src/account.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L319) +[packages/util/src/account.ts:326](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L326) ___ @@ -1431,7 +1664,7 @@ Converts an number to a Uint8Array #### Defined in -[packages/util/src/bytes.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L110) +[packages/util/src/bytes.ts:125](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L125) ___ @@ -1453,7 +1686,7 @@ Converts a number into a [PrefixedHexString](README.md#prefixedhexstring) #### Defined in -[packages/util/src/bytes.ts:98](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L98) +[packages/util/src/bytes.ts:113](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L113) ___ @@ -1476,7 +1709,7 @@ Convert value from number to an unpadded Uint8Array #### Defined in -[packages/util/src/bytes.ts:383](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L383) +[packages/util/src/bytes.ts:398](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L398) ___ @@ -1551,7 +1784,7 @@ Checks if the address is a valid. Accepts checksummed addresses too. #### Defined in -[packages/util/src/account.ts:133](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L133) +[packages/util/src/account.ts:140](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L140) ___ @@ -1576,7 +1809,7 @@ See toChecksumAddress' documentation for details about the eip1191ChainId parame #### Defined in -[packages/util/src/account.ts:188](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L188) +[packages/util/src/account.ts:195](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L195) ___ @@ -1598,7 +1831,7 @@ Checks if the private key satisfies the rules of the curve secp256k1. #### Defined in -[packages/util/src/account.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L244) +[packages/util/src/account.ts:251](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L251) ___ @@ -1622,7 +1855,7 @@ and the requirements of Ethereum. #### Defined in -[packages/util/src/account.ts:254](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L254) +[packages/util/src/account.ts:261](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L261) ___ @@ -1649,7 +1882,7 @@ NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions #### Defined in -[packages/util/src/signature.ts:172](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L172) +[packages/util/src/signature.ts:179](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L179) ___ @@ -1671,7 +1904,7 @@ Checks if a given address is the zero address. #### Defined in -[packages/util/src/account.ts:339](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L339) +[packages/util/src/account.ts:346](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L346) ___ @@ -1739,7 +1972,7 @@ Returns the ethereum address of a given private key. #### Defined in -[packages/util/src/account.ts:312](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L312) +[packages/util/src/account.ts:319](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L319) ___ @@ -1761,7 +1994,7 @@ Returns the ethereum public key of a given private key. #### Defined in -[packages/util/src/account.ts:302](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L302) +[packages/util/src/account.ts:309](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L309) ___ @@ -1785,7 +2018,7 @@ Accepts "Ethereum public keys" and SEC1 encoded keys. #### Defined in -[packages/util/src/account.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L285) +[packages/util/src/account.ts:292](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L292) ___ @@ -1809,7 +2042,7 @@ Accepts "Ethereum public keys" and SEC1 encoded keys. #### Defined in -[packages/util/src/account.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L285) +[packages/util/src/account.ts:292](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L292) ___ @@ -1833,7 +2066,7 @@ A Uint8Array of random bytes of specified length. #### Defined in -[packages/util/src/bytes.ts:408](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L408) +[packages/util/src/bytes.ts:423](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L423) ___ @@ -1857,7 +2090,7 @@ Or it truncates the beginning if it exceeds. #### Defined in -[packages/util/src/bytes.ts:163](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L163) +[packages/util/src/bytes.ts:178](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L178) ___ @@ -1881,7 +2114,7 @@ it truncates the end if it exceeds. #### Defined in -[packages/util/src/bytes.ts:175](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L175) +[packages/util/src/bytes.ts:190](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L190) ___ @@ -1909,7 +2142,7 @@ Output: '657468657265756d0000000000000000000000000000000000…' #### Defined in -[packages/util/src/bytes.ts:328](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L328) +[packages/util/src/bytes.ts:343](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L343) ___ @@ -1981,7 +2214,7 @@ with a `toArray()` or `toBytes()` method. #### Defined in -[packages/util/src/bytes.ts:247](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L247) +[packages/util/src/bytes.ts:262](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L262) ___ @@ -2013,7 +2246,7 @@ Usage of this EIP is therefore discouraged unless you have a very targeted use c #### Defined in -[packages/util/src/account.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L155) +[packages/util/src/account.ts:162](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L162) ___ @@ -2041,7 +2274,7 @@ Signature #### Defined in -[packages/util/src/signature.ts:108](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L108) +[packages/util/src/signature.ts:115](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L115) ___ @@ -2069,7 +2302,7 @@ Signature #### Defined in -[packages/util/src/signature.ts:87](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L87) +[packages/util/src/signature.ts:94](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L94) ___ @@ -2167,7 +2400,7 @@ Converts a `BigInt` to an unsigned integer and returns it as a `Uint8Array`. Ass #### Defined in -[packages/util/src/bytes.ts:300](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L300) +[packages/util/src/bytes.ts:315](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L315) ___ @@ -2189,7 +2422,7 @@ Trims leading zeros from an `Array` (of numbers). #### Defined in -[packages/util/src/bytes.ts:213](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L213) +[packages/util/src/bytes.ts:228](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L228) ___ @@ -2211,7 +2444,7 @@ Trims leading zeros from a `Uint8Array`. #### Defined in -[packages/util/src/bytes.ts:203](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L203) +[packages/util/src/bytes.ts:218](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L218) ___ @@ -2233,7 +2466,7 @@ Trims leading zeros from a `PrefixedHexString`. #### Defined in -[packages/util/src/bytes.ts:223](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L223) +[packages/util/src/bytes.ts:238](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L238) ___ @@ -2255,7 +2488,7 @@ ___ #### Defined in -[packages/util/src/bytes.ts:21](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L21) +[packages/util/src/bytes.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L23) ___ @@ -2315,7 +2548,7 @@ if any provided value is found to have leading zero bytes #### Defined in -[packages/util/src/bytes.ts:350](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L350) +[packages/util/src/bytes.ts:365](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L365) ___ @@ -2331,7 +2564,7 @@ Returns the zero address. #### Defined in -[packages/util/src/account.ts:330](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L330) +[packages/util/src/account.ts:337](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L337) ___ @@ -2353,4 +2586,4 @@ Returns a Uint8Array filled with 0s. #### Defined in -[packages/util/src/bytes.ts:130](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L130) +[packages/util/src/bytes.ts:145](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/bytes.ts#L145) diff --git a/packages/util/docs/classes/Account.md b/packages/util/docs/classes/Account.md index 3148aea150..00acd8322c 100644 --- a/packages/util/docs/classes/Account.md +++ b/packages/util/docs/classes/Account.md @@ -38,14 +38,14 @@ Use the static factory methods to assist in creating an Account from varying dat | Name | Type | Default value | | :------ | :------ | :------ | -| `nonce` | `bigint` | `_0n` | -| `balance` | `bigint` | `_0n` | +| `nonce` | `bigint` | `BIGINT_0` | +| `balance` | `bigint` | `BIGINT_0` | | `storageRoot` | `Uint8Array` | `KECCAK256_RLP` | | `codeHash` | `Uint8Array` | `KECCAK256_NULL` | #### Defined in -[packages/util/src/account.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L70) +[packages/util/src/account.ts:68](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L68) ## Properties @@ -55,7 +55,7 @@ Use the static factory methods to assist in creating an Account from varying dat #### Defined in -[packages/util/src/account.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L35) +[packages/util/src/account.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L33) ___ @@ -65,7 +65,7 @@ ___ #### Defined in -[packages/util/src/account.ts:37](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L37) +[packages/util/src/account.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L35) ___ @@ -75,7 +75,7 @@ ___ #### Defined in -[packages/util/src/account.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L34) +[packages/util/src/account.ts:32](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L32) ___ @@ -85,7 +85,7 @@ ___ #### Defined in -[packages/util/src/account.ts:36](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L36) +[packages/util/src/account.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L34) ## Methods @@ -101,7 +101,7 @@ Returns a `Boolean` determining if the account is a contract. #### Defined in -[packages/util/src/account.ts:116](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L116) +[packages/util/src/account.ts:119](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L119) ___ @@ -119,7 +119,7 @@ account emptiness in [EIP-161](https://eips.ethereum.org/EIPS/eip-161): #### Defined in -[packages/util/src/account.ts:125](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L125) +[packages/util/src/account.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L128) ___ @@ -135,7 +135,7 @@ Returns an array of Uint8Arrays of the raw bytes for the account, in order. #### Defined in -[packages/util/src/account.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L97) +[packages/util/src/account.ts:100](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L100) ___ @@ -151,7 +151,7 @@ Returns the RLP serialization of the account as a `Uint8Array`. #### Defined in -[packages/util/src/account.ts:109](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L109) +[packages/util/src/account.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L112) ___ @@ -171,7 +171,7 @@ ___ #### Defined in -[packages/util/src/account.ts:39](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L39) +[packages/util/src/account.ts:37](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L37) ___ @@ -191,7 +191,7 @@ ___ #### Defined in -[packages/util/src/account.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L50) +[packages/util/src/account.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L48) ___ @@ -211,4 +211,4 @@ ___ #### Defined in -[packages/util/src/account.ts:60](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L60) +[packages/util/src/account.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L58) diff --git a/packages/util/docs/classes/Address.md b/packages/util/docs/classes/Address.md index ca78f9957a..a50735c78c 100644 --- a/packages/util/docs/classes/Address.md +++ b/packages/util/docs/classes/Address.md @@ -42,7 +42,7 @@ Handling and generating Ethereum addresses #### Defined in -[packages/util/src/address.ts:16](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L16) +[packages/util/src/address.ts:17](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L17) ## Properties @@ -52,7 +52,7 @@ Handling and generating Ethereum addresses #### Defined in -[packages/util/src/address.ts:14](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L14) +[packages/util/src/address.ts:15](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L15) ## Methods @@ -74,7 +74,7 @@ Is address equal to another. #### Defined in -[packages/util/src/address.ts:96](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L96) +[packages/util/src/address.ts:97](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L97) ___ @@ -91,7 +91,7 @@ by EIP-1352 #### Defined in -[packages/util/src/address.ts:111](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L111) +[packages/util/src/address.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L112) ___ @@ -107,7 +107,7 @@ Is address zero. #### Defined in -[packages/util/src/address.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L103) +[packages/util/src/address.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L104) ___ @@ -123,7 +123,7 @@ Returns a new Uint8Array representation of address. #### Defined in -[packages/util/src/address.ts:128](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L128) +[packages/util/src/address.ts:129](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L129) ___ @@ -139,7 +139,7 @@ Returns hex encoding of address. #### Defined in -[packages/util/src/address.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L121) +[packages/util/src/address.ts:122](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L122) ___ @@ -161,7 +161,7 @@ Returns an address for a given private key. #### Defined in -[packages/util/src/address.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L57) +[packages/util/src/address.ts:58](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L58) ___ @@ -183,7 +183,7 @@ Returns an address for a given public key. #### Defined in -[packages/util/src/address.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L45) +[packages/util/src/address.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L46) ___ @@ -205,7 +205,7 @@ Returns an Address object from a hex-encoded string. #### Defined in -[packages/util/src/address.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L34) +[packages/util/src/address.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L35) ___ @@ -228,7 +228,7 @@ Generates an address for a newly created contract. #### Defined in -[packages/util/src/address.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L70) +[packages/util/src/address.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L71) ___ @@ -252,7 +252,7 @@ Generates an address for a contract created using CREATE2. #### Defined in -[packages/util/src/address.ts:83](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L83) +[packages/util/src/address.ts:84](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L84) ___ @@ -268,4 +268,4 @@ Returns the zero address. #### Defined in -[packages/util/src/address.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L26) +[packages/util/src/address.ts:27](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/address.ts#L27) diff --git a/packages/util/docs/classes/Withdrawal.md b/packages/util/docs/classes/Withdrawal.md index f5df9ea9ee..9d594fa9d5 100644 --- a/packages/util/docs/classes/Withdrawal.md +++ b/packages/util/docs/classes/Withdrawal.md @@ -47,7 +47,7 @@ Its amount is in Gwei to match CL representation and for eventual ssz withdrawal #### Defined in -[packages/util/src/withdrawal.ts:40](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L40) +[packages/util/src/withdrawal.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L41) ## Properties @@ -57,7 +57,7 @@ Its amount is in Gwei to match CL representation and for eventual ssz withdrawal #### Defined in -[packages/util/src/withdrawal.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L43) +[packages/util/src/withdrawal.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L44) ___ @@ -69,7 +69,7 @@ withdrawal amount in Gwei to match the CL repesentation and eventually ssz withd #### Defined in -[packages/util/src/withdrawal.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L47) +[packages/util/src/withdrawal.ts:48](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L48) ___ @@ -79,7 +79,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L41) +[packages/util/src/withdrawal.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L42) ___ @@ -89,7 +89,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L42) +[packages/util/src/withdrawal.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L43) ## Methods @@ -103,7 +103,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:99](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L99) +[packages/util/src/withdrawal.ts:100](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L100) ___ @@ -124,7 +124,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:112](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L112) +[packages/util/src/withdrawal.ts:113](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L113) ___ @@ -145,7 +145,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L103) +[packages/util/src/withdrawal.ts:104](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L104) ___ @@ -165,7 +165,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:65](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L65) +[packages/util/src/withdrawal.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L66) ___ @@ -185,7 +185,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L50) +[packages/util/src/withdrawal.ts:51](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L51) ___ @@ -209,4 +209,4 @@ buffer array of the withdrawal #### Defined in -[packages/util/src/withdrawal.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L78) +[packages/util/src/withdrawal.ts:79](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L79) diff --git a/packages/util/docs/interfaces/AccountData.md b/packages/util/docs/interfaces/AccountData.md index 1aff89cef0..a48a07da4c 100644 --- a/packages/util/docs/interfaces/AccountData.md +++ b/packages/util/docs/interfaces/AccountData.md @@ -19,7 +19,7 @@ #### Defined in -[packages/util/src/account.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L26) +[packages/util/src/account.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L24) ___ @@ -29,7 +29,7 @@ ___ #### Defined in -[packages/util/src/account.ts:28](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L28) +[packages/util/src/account.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L26) ___ @@ -39,7 +39,7 @@ ___ #### Defined in -[packages/util/src/account.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L25) +[packages/util/src/account.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L23) ___ @@ -49,4 +49,4 @@ ___ #### Defined in -[packages/util/src/account.ts:27](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L27) +[packages/util/src/account.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/account.ts#L25) diff --git a/packages/util/docs/interfaces/ECDSASignature.md b/packages/util/docs/interfaces/ECDSASignature.md index c032be7f89..12053f3308 100644 --- a/packages/util/docs/interfaces/ECDSASignature.md +++ b/packages/util/docs/interfaces/ECDSASignature.md @@ -18,7 +18,7 @@ #### Defined in -[packages/util/src/signature.ts:18](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L18) +[packages/util/src/signature.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L25) ___ @@ -28,7 +28,7 @@ ___ #### Defined in -[packages/util/src/signature.ts:19](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L19) +[packages/util/src/signature.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L26) ___ @@ -38,4 +38,4 @@ ___ #### Defined in -[packages/util/src/signature.ts:17](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L17) +[packages/util/src/signature.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/signature.ts#L24) diff --git a/packages/util/docs/interfaces/JsonRpcWithdrawal.md b/packages/util/docs/interfaces/JsonRpcWithdrawal.md index ef99a9d5c7..1860c7c846 100644 --- a/packages/util/docs/interfaces/JsonRpcWithdrawal.md +++ b/packages/util/docs/interfaces/JsonRpcWithdrawal.md @@ -22,7 +22,7 @@ match CL representation and for eventual ssz withdrawalsRoot #### Defined in -[packages/util/src/withdrawal.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L25) +[packages/util/src/withdrawal.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L26) ___ @@ -32,7 +32,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:26](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L26) +[packages/util/src/withdrawal.ts:27](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L27) ___ @@ -42,7 +42,7 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L23) +[packages/util/src/withdrawal.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L24) ___ @@ -52,4 +52,4 @@ ___ #### Defined in -[packages/util/src/withdrawal.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L24) +[packages/util/src/withdrawal.ts:25](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/util/src/withdrawal.ts#L25) diff --git a/packages/util/package.json b/packages/util/package.json index a728e4bd0b..0d9fcd6559 100644 --- a/packages/util/package.json +++ b/packages/util/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/util", - "version": "9.0.0", + "version": "9.0.1", "description": "A collection of utility functions for Ethereum", "keywords": [ "ethereum", @@ -90,7 +90,7 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/rlp": "^5.0.0", + "@ethereumjs/rlp": "^5.0.1", "ethereum-cryptography": "^2.1.2" }, "devDependencies": {}, diff --git a/packages/verkle/package.json b/packages/verkle/package.json index 94bb67d313..174ec1ec10 100644 --- a/packages/verkle/package.json +++ b/packages/verkle/package.json @@ -50,8 +50,8 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/rlp": "5.0.0", - "@ethereumjs/util": "9.0.0", + "@ethereumjs/rlp": "5.0.1", + "@ethereumjs/util": "9.0.1", "lru-cache": "^10.0.0" }, "engines": { diff --git a/packages/vm/CHANGELOG.md b/packages/vm/CHANGELOG.md index 422631defa..644dc40fae 100644 --- a/packages/vm/CHANGELOG.md +++ b/packages/vm/CHANGELOG.md @@ -6,6 +6,42 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 7.1.0 - 2023-10-26 + +### New EVM/VM Profiler + +This releases ships with a completely new dedicated EVM/VM profiler (❤️ to Jochem for the integration) to measure how the different opcode implementations are doing, see PR [#2988](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2988), [#3011](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3011), [#3013](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3013) and [#3041](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3041). + +Most of profiling is taking place in the EVM (so: the dedicated opcode profiling), see the respective [README section](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/README.md#profiling-the-evm) for usage instructions and the EVM v2.1.0 [CHANGELOG](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/evm/CHANGELOG.md) for latest performance gains. + +The VM adds to the profiler (see new `profiler` option) by adding output within the tx or block scope along `runTx()` or `runBlock()` runs (committing state, block rewards,...). + +The VM profiler addition now also allows for running blockchain or state tests with the profiler activated, e.g. to benchmark certain extreme-case or attack scenarios, see [DEVELOPER](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/DEVELOPER.md) docs for usage instructions (see PR [#3115](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3115)). + +### EIP-7516 BLOBBASEFEE Opcode + +This release supports [EIP-7516](https://eips.ethereum.org/EIPS/eip-7516) with a new `BLOBBASEFEE` opcode added to and scheduled for the Dencun HF, see PR [#3035](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3035) and [#3068](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3068). The opcode returns the value of the blob base-fee of the current block it is executing in. + +### Dencun devnet-11 Compatibility + +This release contains various fixes and spec updates related to the Dencun (Deneb/Cancun) HF and is now compatible with the specs as used in [devnet-11](https://github.com/ethpandaops/dencun-testnet) (October 2023). + +- Update `EIP-4788`: do not use precompile anymore but use the pre-deployed bytecode, PR [#2955](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2955) +- Additional `EIP-4788` updates (address + modulus), PR [#3068](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3068) +- Update the beacon block root contract address, PR [#3003](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3003) + +## Bugfixes + +- Fix block builder `london` HF transition, PR [#3039](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3039) + +## Other Changes + +- Allow for users to decide if to either downlevel (so: adopt them for a short-lived scenario) state caches or not on `shallowCopy()` by adding a new `downlevelCaches` parameter (default: `true`), PR [#3063](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3063) +- Update ethereum tests to 12.3, PR [#2971](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2971) +- Update ethereum tests to 12.4, PR [#3052](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3052) +- Reactivate selected slow tests, PR [#2991](https://github.com/ethereumjs/ethereumjs-monorepo/pull/2991) +- Better error message for `runTx()` `gasLimit` check to avoid confusion with EIP1559 base fee, PR [#3118](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3118) + ## 7.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/vm/DEVELOPER.md b/packages/vm/DEVELOPER.md index 4b0ecd0a4f..aa1b718298 100644 --- a/packages/vm/DEVELOPER.md +++ b/packages/vm/DEVELOPER.md @@ -106,6 +106,12 @@ It is also possible to only run the tests from the skip lists: `ts-node ./test/tester --state --runSkipped=SLOW` +#### Profiling Tests + +Test runs can be profiled using the new EVM/VM profiling functionality by using the `--profile` option for test runs: + +`ts-node ./test/tester --state --test='CreateCollisionToEmpty' --data=0 --gas=1 --value=0 --profile` + ### CI Test Integration Tests and checks are run in CI using [Github Actions](https://github.com/ethereumjs/ethereumjs-monorepo/actions). The configuration can be found in `.github/workflows`. diff --git a/packages/vm/docs/README.md b/packages/vm/docs/README.md index 1213253435..167e66932d 100644 --- a/packages/vm/docs/README.md +++ b/packages/vm/docs/README.md @@ -32,8 +32,10 @@ ### Type Aliases +- [EVMProfilerOpts](README.md#evmprofileropts) - [TxReceipt](README.md#txreceipt) - [VMEvents](README.md#vmevents) +- [VMProfilerOpts](README.md#vmprofileropts) ### Functions @@ -41,6 +43,22 @@ ## Type Aliases +### EVMProfilerOpts + +Ƭ **EVMProfilerOpts**: `Object` + +#### Type declaration + +| Name | Type | +| :------ | :------ | +| `enabled` | `boolean` | + +#### Defined in + +[vm/src/types.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L67) + +___ + ### TxReceipt Ƭ **TxReceipt**: [`PreByzantiumTxReceipt`](interfaces/PreByzantiumTxReceipt.md) \| [`PostByzantiumTxReceipt`](interfaces/PostByzantiumTxReceipt.md) \| [`EIP4844BlobTxReceipt`](interfaces/EIP4844BlobTxReceipt.md) @@ -66,7 +84,24 @@ ___ #### Defined in -[vm/src/types.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L67) +[vm/src/types.ts:72](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L72) + +___ + +### VMProfilerOpts + +Ƭ **VMProfilerOpts**: `Object` + +#### Type declaration + +| Name | Type | +| :------ | :------ | +| `reportAfterBlock?` | `boolean` | +| `reportAfterTx?` | `boolean` | + +#### Defined in + +[vm/src/types.ts:79](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L79) ## Functions @@ -89,4 +124,4 @@ Returns the encoded tx receipt. #### Defined in -[vm/src/runBlock.ts:468](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/runBlock.ts#L468) +[vm/src/runBlock.ts:538](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/runBlock.ts#L538) diff --git a/packages/vm/docs/classes/BlockBuilder.md b/packages/vm/docs/classes/BlockBuilder.md index a1d24a50ea..d7e7b1a67a 100644 --- a/packages/vm/docs/classes/BlockBuilder.md +++ b/packages/vm/docs/classes/BlockBuilder.md @@ -44,31 +44,31 @@ #### Defined in -[vm/src/buildBlock.ts:71](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L71) +[vm/src/buildBlock.ts:74](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L74) ## Properties ### blobGasUsed -• **blobGasUsed**: `bigint` +• **blobGasUsed**: `bigint` = `BIGINT_0` The cumulative blob gas used by the blobs in a block #### Defined in -[vm/src/buildBlock.ts:47](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L47) +[vm/src/buildBlock.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L50) ___ ### gasUsed -• **gasUsed**: `bigint` +• **gasUsed**: `bigint` = `BIGINT_0` The cumulative gas used by the transactions added to the block. #### Defined in -[vm/src/buildBlock.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L43) +[vm/src/buildBlock.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L46) ## Accessors @@ -82,7 +82,7 @@ The cumulative gas used by the transactions added to the block. #### Defined in -[vm/src/buildBlock.ts:67](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L67) +[vm/src/buildBlock.ts:70](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L70) ___ @@ -96,7 +96,7 @@ ___ #### Defined in -[vm/src/buildBlock.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L63) +[vm/src/buildBlock.ts:66](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L66) ## Methods @@ -123,7 +123,7 @@ the remaining gas in the block. #### Defined in -[vm/src/buildBlock.ts:183](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L183) +[vm/src/buildBlock.ts:198](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L198) ___ @@ -153,7 +153,7 @@ as the signer will be awarded the txs amount spent on gas as they are added. #### Defined in -[vm/src/buildBlock.ts:273](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L273) +[vm/src/buildBlock.ts:288](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L288) ___ @@ -167,7 +167,7 @@ ___ #### Defined in -[vm/src/buildBlock.ts:111](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L111) +[vm/src/buildBlock.ts:126](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L126) ___ @@ -181,7 +181,7 @@ ___ #### Defined in -[vm/src/buildBlock.ts:337](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L337) +[vm/src/buildBlock.ts:352](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L352) ___ @@ -197,7 +197,7 @@ Calculates and returns the logs bloom for the block. #### Defined in -[vm/src/buildBlock.ts:125](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L125) +[vm/src/buildBlock.ts:140](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L140) ___ @@ -213,7 +213,7 @@ Calculates and returns the receiptTrie for the block. #### Defined in -[vm/src/buildBlock.ts:137](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L137) +[vm/src/buildBlock.ts:152](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L152) ___ @@ -229,7 +229,7 @@ Reverts the checkpoint on the StateManager to reset the state from any transacti #### Defined in -[vm/src/buildBlock.ts:254](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L254) +[vm/src/buildBlock.ts:269](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L269) ___ @@ -245,4 +245,4 @@ Calculates and returns the transactionsTrie for the block. #### Defined in -[vm/src/buildBlock.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L118) +[vm/src/buildBlock.ts:133](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L133) diff --git a/packages/vm/docs/classes/VM.md b/packages/vm/docs/classes/VM.md index 48182ee1bd..35bac65e4f 100644 --- a/packages/vm/docs/classes/VM.md +++ b/packages/vm/docs/classes/VM.md @@ -37,7 +37,7 @@ The blockchain the VM operates on #### Defined in -[vm/src/vm.ts:41](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L41) +[vm/src/vm.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L42) ___ @@ -47,7 +47,7 @@ ___ #### Defined in -[vm/src/vm.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L43) +[vm/src/vm.ts:44](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L44) ___ @@ -57,7 +57,7 @@ ___ #### Defined in -[vm/src/vm.ts:45](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L45) +[vm/src/vm.ts:46](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L46) ___ @@ -69,7 +69,7 @@ The EVM used for bytecode execution #### Defined in -[vm/src/vm.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L49) +[vm/src/vm.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L50) ___ @@ -81,7 +81,7 @@ The StateManager used by the VM #### Defined in -[vm/src/vm.ts:36](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L36) +[vm/src/vm.ts:37](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L37) ## Methods @@ -113,7 +113,7 @@ An instance of [BlockBuilder](BlockBuilder.md) with methods: #### Defined in -[vm/src/vm.ts:215](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L215) +[vm/src/vm.ts:235](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L235) ___ @@ -129,7 +129,7 @@ Return a compact error string representation of the object #### Defined in -[vm/src/vm.ts:248](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L248) +[vm/src/vm.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L277) ___ @@ -150,7 +150,7 @@ ___ #### Defined in -[vm/src/vm.ts:139](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L139) +[vm/src/vm.ts:159](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L159) ___ @@ -176,7 +176,7 @@ invalid. If an error is thrown from an event handler, the state may or may not b #### Defined in -[vm/src/vm.ts:184](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L184) +[vm/src/vm.ts:204](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L204) ___ @@ -202,17 +202,29 @@ reverted. #### Defined in -[vm/src/vm.ts:197](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L197) +[vm/src/vm.ts:217](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L217) ___ ### shallowCopy -▸ **shallowCopy**(): `Promise`<[`VM`](VM.md)\> +▸ **shallowCopy**(`downlevelCaches?`): `Promise`<[`VM`](VM.md)\> Returns a copy of the [VM](VM.md) instance. -Note that the returned copy will share the same db as the original for the blockchain and the statemanager +Note that the returned copy will share the same db as the original for the blockchain and the statemanager. + +Associated caches will be deleted and caches will be re-initialized for a more short-term focused +usage, being less memory intense (the statemanager caches will switch to using an ORDERED_MAP cache +datastructure more suitable for short-term usage, the trie node LRU cache will not be activated at all). +To fine-tune this behavior (if the shallow-copy-returned object has a longer life span e.g.) you can set +the `downlevelCaches` option to `false`. + +#### Parameters + +| Name | Type | Default value | Description | +| :------ | :------ | :------ | :------ | +| `downlevelCaches` | `boolean` | `true` | Downlevel (so: adopted for short-term usage) associated state caches (default: true) | #### Returns @@ -220,7 +232,7 @@ Note that the returned copy will share the same db as the original for the block #### Defined in -[vm/src/vm.ts:224](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L224) +[vm/src/vm.ts:252](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L252) ___ @@ -242,4 +254,4 @@ VM async constructor. Creates engine instance and initializes it. #### Defined in -[vm/src/vm.ts:78](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L78) +[vm/src/vm.ts:79](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/vm.ts#L79) diff --git a/packages/vm/docs/enums/BuildStatus.md b/packages/vm/docs/enums/BuildStatus.md index 1aa5016ad2..12dc1c0a4c 100644 --- a/packages/vm/docs/enums/BuildStatus.md +++ b/packages/vm/docs/enums/BuildStatus.md @@ -18,7 +18,7 @@ #### Defined in -[vm/src/buildBlock.ts:31](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L31) +[vm/src/buildBlock.ts:34](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L34) ___ @@ -28,7 +28,7 @@ ___ #### Defined in -[vm/src/buildBlock.ts:32](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L32) +[vm/src/buildBlock.ts:35](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L35) ___ @@ -38,4 +38,4 @@ ___ #### Defined in -[vm/src/buildBlock.ts:30](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L30) +[vm/src/buildBlock.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/buildBlock.ts#L33) diff --git a/packages/vm/docs/interfaces/AfterBlockEvent.md b/packages/vm/docs/interfaces/AfterBlockEvent.md index e543d57c07..33d933f8d1 100644 --- a/packages/vm/docs/interfaces/AfterBlockEvent.md +++ b/packages/vm/docs/interfaces/AfterBlockEvent.md @@ -30,7 +30,7 @@ Result of runBlock #### Defined in -[vm/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L298) +[vm/src/types.ts:311](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L311) ___ @@ -46,7 +46,7 @@ The gas used after executing the block #### Defined in -[vm/src/types.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L285) +[vm/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L298) ___ @@ -62,7 +62,7 @@ The bloom filter of the LOGs (events) after executing the block #### Defined in -[vm/src/types.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L289) +[vm/src/types.ts:302](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L302) ___ @@ -78,7 +78,7 @@ Receipts generated for transactions in the block #### Defined in -[vm/src/types.ts:273](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L273) +[vm/src/types.ts:286](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L286) ___ @@ -94,7 +94,7 @@ The receipt root after executing the block #### Defined in -[vm/src/types.ts:293](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L293) +[vm/src/types.ts:306](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L306) ___ @@ -110,7 +110,7 @@ Results of executing the transactions in the block #### Defined in -[vm/src/types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L277) +[vm/src/types.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L290) ___ @@ -126,4 +126,4 @@ The stateRoot after executing the block #### Defined in -[vm/src/types.ts:281](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L281) +[vm/src/types.ts:294](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L294) diff --git a/packages/vm/docs/interfaces/AfterTxEvent.md b/packages/vm/docs/interfaces/AfterTxEvent.md index 608a9847a5..9c84e21b48 100644 --- a/packages/vm/docs/interfaces/AfterTxEvent.md +++ b/packages/vm/docs/interfaces/AfterTxEvent.md @@ -40,7 +40,7 @@ EIP-2930 access list generated for the tx (see `reportAccessList` option) #### Defined in -[vm/src/types.ts:387](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L387) +[vm/src/types.ts:400](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L400) ___ @@ -56,7 +56,7 @@ The amount of ether used by this transaction #### Defined in -[vm/src/types.ts:365](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L365) +[vm/src/types.ts:378](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L378) ___ @@ -72,7 +72,7 @@ This is the blob gas units times the fee per blob gas for 4844 transactions #### Defined in -[vm/src/types.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L397) +[vm/src/types.ts:410](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L410) ___ @@ -88,7 +88,7 @@ Bloom filter resulted from transaction #### Defined in -[vm/src/types.ts:360](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L360) +[vm/src/types.ts:373](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L373) ___ @@ -104,7 +104,7 @@ Address of created account during transaction, if any #### Defined in -evm/dist/cjs/types.d.ts:234 +evm/dist/cjs/types.d.ts:241 ___ @@ -120,7 +120,7 @@ Contains the results from running the code, if any, as described in runCode #### Defined in -evm/dist/cjs/types.d.ts:238 +evm/dist/cjs/types.d.ts:245 ___ @@ -136,7 +136,7 @@ The amount of gas as that was refunded during the transaction (i.e. `gasUsed = t #### Defined in -[vm/src/types.ts:382](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L382) +[vm/src/types.ts:395](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L395) ___ @@ -152,7 +152,7 @@ The value that accrues to the miner by this transaction #### Defined in -[vm/src/types.ts:392](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L392) +[vm/src/types.ts:405](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L405) ___ @@ -168,7 +168,7 @@ The tx receipt #### Defined in -[vm/src/types.ts:370](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L370) +[vm/src/types.ts:383](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L383) ___ @@ -186,7 +186,7 @@ which consists of calldata cost, intrinsic cost and optionally the access list c #### Defined in -[vm/src/types.ts:377](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L377) +[vm/src/types.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L390) ___ @@ -198,4 +198,4 @@ The transaction which just got finished #### Defined in -[vm/src/types.ts:404](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L404) +[vm/src/types.ts:417](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L417) diff --git a/packages/vm/docs/interfaces/BuildBlockOpts.md b/packages/vm/docs/interfaces/BuildBlockOpts.md index 4ff98e8a63..d74beb8584 100644 --- a/packages/vm/docs/interfaces/BuildBlockOpts.md +++ b/packages/vm/docs/interfaces/BuildBlockOpts.md @@ -23,7 +23,7 @@ The block and builder options to use. #### Defined in -[vm/src/types.ts:180](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L180) +[vm/src/types.ts:193](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L193) ___ @@ -36,7 +36,7 @@ Defaults used for any values not provided. #### Defined in -[vm/src/types.ts:174](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L174) +[vm/src/types.ts:187](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L187) ___ @@ -48,7 +48,7 @@ The parent block #### Defined in -[vm/src/types.ts:168](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L168) +[vm/src/types.ts:181](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L181) ___ @@ -58,4 +58,4 @@ ___ #### Defined in -[vm/src/types.ts:176](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L176) +[vm/src/types.ts:189](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L189) diff --git a/packages/vm/docs/interfaces/BuilderOpts.md b/packages/vm/docs/interfaces/BuilderOpts.md index a860c472d4..6331fb5307 100644 --- a/packages/vm/docs/interfaces/BuilderOpts.md +++ b/packages/vm/docs/interfaces/BuilderOpts.md @@ -124,7 +124,7 @@ Default: true #### Defined in -[vm/src/types.ts:158](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L158) +[vm/src/types.ts:171](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L171) ___ diff --git a/packages/vm/docs/interfaces/RunBlockOpts.md b/packages/vm/docs/interfaces/RunBlockOpts.md index 0bfa8747a4..bf4b9f679b 100644 --- a/packages/vm/docs/interfaces/RunBlockOpts.md +++ b/packages/vm/docs/interfaces/RunBlockOpts.md @@ -29,7 +29,7 @@ The @ethereumjs/block to process #### Defined in -[vm/src/types.ts:207](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L207) +[vm/src/types.ts:220](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L220) ___ @@ -45,7 +45,7 @@ Default: true #### Defined in -[vm/src/types.ts:219](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L219) +[vm/src/types.ts:232](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L232) ___ @@ -60,7 +60,7 @@ Defaults to `false`. #### Defined in -[vm/src/types.ts:226](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L226) +[vm/src/types.ts:239](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L239) ___ @@ -72,7 +72,7 @@ Root of the state trie #### Defined in -[vm/src/types.ts:211](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L211) +[vm/src/types.ts:224](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L224) ___ @@ -90,7 +90,7 @@ Default: `false` (HF is set to whatever default HF is set by the Common instance #### Defined in -[vm/src/types.ts:263](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L263) +[vm/src/types.ts:276](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L276) ___ @@ -103,7 +103,7 @@ balance equal equal to the upfront cost (gas limit * gas price + transaction val #### Defined in -[vm/src/types.ts:253](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L253) +[vm/src/types.ts:266](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L266) ___ @@ -117,7 +117,7 @@ the transactions, the transaction trie and the uncle hash. #### Defined in -[vm/src/types.ts:232](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L232) +[vm/src/types.ts:245](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L245) ___ @@ -130,7 +130,7 @@ and tx #### Defined in -[vm/src/types.ts:237](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L237) +[vm/src/types.ts:250](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L250) ___ @@ -145,7 +145,7 @@ consensus of the chain has moved ahead. #### Defined in -[vm/src/types.ts:244](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L244) +[vm/src/types.ts:257](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L257) ___ @@ -157,4 +157,4 @@ If true, skips the nonce check #### Defined in -[vm/src/types.ts:248](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L248) +[vm/src/types.ts:261](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L261) diff --git a/packages/vm/docs/interfaces/RunBlockResult.md b/packages/vm/docs/interfaces/RunBlockResult.md index b6386c406d..718242b70c 100644 --- a/packages/vm/docs/interfaces/RunBlockResult.md +++ b/packages/vm/docs/interfaces/RunBlockResult.md @@ -31,7 +31,7 @@ The gas used after executing the block #### Defined in -[vm/src/types.ts:285](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L285) +[vm/src/types.ts:298](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L298) ___ @@ -43,7 +43,7 @@ The bloom filter of the LOGs (events) after executing the block #### Defined in -[vm/src/types.ts:289](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L289) +[vm/src/types.ts:302](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L302) ___ @@ -55,7 +55,7 @@ Receipts generated for transactions in the block #### Defined in -[vm/src/types.ts:273](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L273) +[vm/src/types.ts:286](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L286) ___ @@ -67,7 +67,7 @@ The receipt root after executing the block #### Defined in -[vm/src/types.ts:293](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L293) +[vm/src/types.ts:306](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L306) ___ @@ -79,7 +79,7 @@ Results of executing the transactions in the block #### Defined in -[vm/src/types.ts:277](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L277) +[vm/src/types.ts:290](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L290) ___ @@ -91,4 +91,4 @@ The stateRoot after executing the block #### Defined in -[vm/src/types.ts:281](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L281) +[vm/src/types.ts:294](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L294) diff --git a/packages/vm/docs/interfaces/RunTxOpts.md b/packages/vm/docs/interfaces/RunTxOpts.md index ae817aba4a..ce4ec7e7a9 100644 --- a/packages/vm/docs/interfaces/RunTxOpts.md +++ b/packages/vm/docs/interfaces/RunTxOpts.md @@ -28,7 +28,7 @@ If omitted, a default blank block will be used. #### Defined in -[vm/src/types.ts:309](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L309) +[vm/src/types.ts:322](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L322) ___ @@ -40,7 +40,7 @@ To obtain an accurate tx receipt input the block gas used up until this tx. #### Defined in -[vm/src/types.ts:350](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L350) +[vm/src/types.ts:363](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L363) ___ @@ -59,7 +59,7 @@ StateManager.generateAccessList must be implemented. #### Defined in -[vm/src/types.ts:345](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L345) +[vm/src/types.ts:358](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L358) ___ @@ -71,7 +71,7 @@ Skip balance checks if true. Adds transaction cost to balance to ensure executio #### Defined in -[vm/src/types.ts:321](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L321) +[vm/src/types.ts:334](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L334) ___ @@ -84,7 +84,7 @@ against the block's gas limit. #### Defined in -[vm/src/types.ts:327](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L327) +[vm/src/types.ts:340](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L340) ___ @@ -97,7 +97,7 @@ and tx #### Defined in -[vm/src/types.ts:333](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L333) +[vm/src/types.ts:346](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L346) ___ @@ -109,7 +109,7 @@ If true, skips the nonce check #### Defined in -[vm/src/types.ts:317](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L317) +[vm/src/types.ts:330](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L330) ___ @@ -121,4 +121,4 @@ An `@ethereumjs/tx` to run #### Defined in -[vm/src/types.ts:313](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L313) +[vm/src/types.ts:326](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L326) diff --git a/packages/vm/docs/interfaces/RunTxResult.md b/packages/vm/docs/interfaces/RunTxResult.md index 28822b2b07..01d8d3d40a 100644 --- a/packages/vm/docs/interfaces/RunTxResult.md +++ b/packages/vm/docs/interfaces/RunTxResult.md @@ -37,7 +37,7 @@ EIP-2930 access list generated for the tx (see `reportAccessList` option) #### Defined in -[vm/src/types.ts:387](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L387) +[vm/src/types.ts:400](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L400) ___ @@ -49,7 +49,7 @@ The amount of ether used by this transaction #### Defined in -[vm/src/types.ts:365](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L365) +[vm/src/types.ts:378](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L378) ___ @@ -61,7 +61,7 @@ This is the blob gas units times the fee per blob gas for 4844 transactions #### Defined in -[vm/src/types.ts:397](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L397) +[vm/src/types.ts:410](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L410) ___ @@ -73,7 +73,7 @@ Bloom filter resulted from transaction #### Defined in -[vm/src/types.ts:360](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L360) +[vm/src/types.ts:373](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L373) ___ @@ -89,7 +89,7 @@ EVMResult.createdAddress #### Defined in -evm/dist/cjs/types.d.ts:234 +evm/dist/cjs/types.d.ts:241 ___ @@ -105,7 +105,7 @@ EVMResult.execResult #### Defined in -evm/dist/cjs/types.d.ts:238 +evm/dist/cjs/types.d.ts:245 ___ @@ -117,7 +117,7 @@ The amount of gas as that was refunded during the transaction (i.e. `gasUsed = t #### Defined in -[vm/src/types.ts:382](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L382) +[vm/src/types.ts:395](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L395) ___ @@ -129,7 +129,7 @@ The value that accrues to the miner by this transaction #### Defined in -[vm/src/types.ts:392](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L392) +[vm/src/types.ts:405](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L405) ___ @@ -141,7 +141,7 @@ The tx receipt #### Defined in -[vm/src/types.ts:370](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L370) +[vm/src/types.ts:383](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L383) ___ @@ -155,4 +155,4 @@ which consists of calldata cost, intrinsic cost and optionally the access list c #### Defined in -[vm/src/types.ts:377](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L377) +[vm/src/types.ts:390](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L390) diff --git a/packages/vm/docs/interfaces/SealBlockOpts.md b/packages/vm/docs/interfaces/SealBlockOpts.md index d2c3eb59fd..181cdae7d0 100644 --- a/packages/vm/docs/interfaces/SealBlockOpts.md +++ b/packages/vm/docs/interfaces/SealBlockOpts.md @@ -22,7 +22,7 @@ Overrides the value passed in the constructor. #### Defined in -[vm/src/types.ts:197](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L197) +[vm/src/types.ts:210](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L210) ___ @@ -35,4 +35,4 @@ Overrides the value passed in the constructor. #### Defined in -[vm/src/types.ts:191](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L191) +[vm/src/types.ts:204](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L204) diff --git a/packages/vm/docs/interfaces/VMOpts.md b/packages/vm/docs/interfaces/VMOpts.md index a75f3e8ec4..7da1e53df6 100644 --- a/packages/vm/docs/interfaces/VMOpts.md +++ b/packages/vm/docs/interfaces/VMOpts.md @@ -13,6 +13,7 @@ Options for instantiating a [VM](../classes/VM.md). - [common](VMOpts.md#common) - [evm](VMOpts.md#evm) - [genesisState](VMOpts.md#genesisstate) +- [profilerOpts](VMOpts.md#profileropts) - [setHardfork](VMOpts.md#sethardfork) - [stateManager](VMOpts.md#statemanager) @@ -36,7 +37,7 @@ Default: `false` #### Defined in -[vm/src/types.ts:121](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L121) +[vm/src/types.ts:132](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L132) ___ @@ -48,7 +49,7 @@ A Blockchain object for storing/retrieving blocks #### Defined in -[vm/src/types.ts:107](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L107) +[vm/src/types.ts:118](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L118) ___ @@ -78,7 +79,7 @@ Default setup if no `Common` instance is provided: #### Defined in -[vm/src/types.ts:99](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L99) +[vm/src/types.ts:110](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L110) ___ @@ -90,7 +91,7 @@ Use a custom EVM to run Messages on. If this is not present, use the default EVM #### Defined in -[vm/src/types.ts:142](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L142) +[vm/src/types.ts:153](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L153) ___ @@ -103,7 +104,17 @@ stateManager not provided for the VM, defaults to an empty state #### Defined in -[vm/src/types.ts:126](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L126) +[vm/src/types.ts:137](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L137) + +___ + +### profilerOpts + +• `Optional` **profilerOpts**: [`VMProfilerOpts`](../README.md#vmprofileropts) + +#### Defined in + +[vm/src/types.ts:155](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L155) ___ @@ -121,7 +132,7 @@ Default: `false` (HF is set to whatever default HF is set by the Common instance #### Defined in -[vm/src/types.ts:137](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L137) +[vm/src/types.ts:148](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L148) ___ @@ -133,4 +144,4 @@ A StateManager instance to use as the state store #### Defined in -[vm/src/types.ts:103](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L103) +[vm/src/types.ts:114](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/vm/src/types.ts#L114) diff --git a/packages/vm/package.json b/packages/vm/package.json index 2ed8ecc9b0..07302f9dfe 100644 --- a/packages/vm/package.json +++ b/packages/vm/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/vm", - "version": "7.0.0", + "version": "7.1.0", "description": "An Ethereum VM implementation", "keywords": [ "ethereum", @@ -62,15 +62,15 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/block": "^5.0.0", - "@ethereumjs/blockchain": "^7.0.0", - "@ethereumjs/common": "^4.0.0", - "@ethereumjs/evm": "^2.0.0", - "@ethereumjs/rlp": "^5.0.0", - "@ethereumjs/statemanager": "^2.0.0", - "@ethereumjs/trie": "^6.0.0", - "@ethereumjs/tx": "^5.0.0", - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/block": "^5.0.1", + "@ethereumjs/blockchain": "^7.0.1", + "@ethereumjs/common": "^4.1.0", + "@ethereumjs/evm": "^2.1.0", + "@ethereumjs/rlp": "^5.0.1", + "@ethereumjs/statemanager": "^2.1.0", + "@ethereumjs/trie": "^6.0.1", + "@ethereumjs/tx": "^5.1.0", + "@ethereumjs/util": "^9.0.1", "debug": "^4.3.3", "ethereum-cryptography": "^2.1.2" }, diff --git a/packages/vm/src/runBlock.ts b/packages/vm/src/runBlock.ts index dae9252bd4..23f51975b1 100644 --- a/packages/vm/src/runBlock.ts +++ b/packages/vm/src/runBlock.ts @@ -452,8 +452,6 @@ async function applyTransactions(this: VM, block: Block, opts: RunBlockOpts) { if (enableProfiler) { // eslint-disable-next-line no-console console.timeEnd(processTxsLabel) - // eslint-disable-next-line no-console - console.timeEnd(entireBlockLabel) } const receiptsRoot = receiptTrie !== undefined ? receiptTrie.root() : KECCAK256_RLP diff --git a/packages/wallet/CHANGELOG.md b/packages/wallet/CHANGELOG.md index 86a42df486..7b28d73d05 100644 --- a/packages/wallet/CHANGELOG.md +++ b/packages/wallet/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) (modification: no type change headlines) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html). +## 2.0.1 - 2023-10-26 + +- Add `fromMnemonic()` static constructor to BIP32 HD wallet, PR [#192](https://github.com/ethereumjs/ethereumjs-wallet/pull/192) + ## 2.0.0 - 2023-08-09 Final release version from the breaking release round from Summer 2023 on the EthereumJS libraries, thanks to the whole team for this amazing accomplishment! ❤️ 🥳 diff --git a/packages/wallet/docs/classes/hdkey.EthereumHDKey.md b/packages/wallet/docs/classes/hdkey.EthereumHDKey.md index 778ee9a95e..6ddff58a2a 100644 --- a/packages/wallet/docs/classes/hdkey.EthereumHDKey.md +++ b/packages/wallet/docs/classes/hdkey.EthereumHDKey.md @@ -19,6 +19,7 @@ - [publicExtendedKey](hdkey.EthereumHDKey.md#publicextendedkey) - [fromExtendedKey](hdkey.EthereumHDKey.md#fromextendedkey) - [fromMasterSeed](hdkey.EthereumHDKey.md#frommasterseed) +- [fromMnemonic](hdkey.EthereumHDKey.md#frommnemonic) ## Constructors @@ -34,7 +35,7 @@ #### Defined in -[hdkey.ts:27](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L27) +[hdkey.ts:28](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L28) ## Methods @@ -56,7 +57,7 @@ Derive a node based on a child index #### Defined in -[hdkey.ts:56](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L56) +[hdkey.ts:57](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L57) ___ @@ -78,7 +79,7 @@ Derives a node based on a path (e.g. m/44'/0'/0/1) #### Defined in -[hdkey.ts:49](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L49) +[hdkey.ts:50](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L50) ___ @@ -94,7 +95,7 @@ Return a `Wallet` instance as seen above #### Defined in -[hdkey.ts:63](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L63) +[hdkey.ts:64](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L64) ___ @@ -110,7 +111,7 @@ Returns a BIP32 extended private key (xprv) #### Defined in -[hdkey.ts:32](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L32) +[hdkey.ts:33](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L33) ___ @@ -126,7 +127,7 @@ Return a BIP32 extended public key (xpub) #### Defined in -[hdkey.ts:42](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L42) +[hdkey.ts:43](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L43) ___ @@ -148,7 +149,7 @@ Create an instance based on a BIP32 extended private or public key. #### Defined in -[hdkey.ts:23](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L23) +[hdkey.ts:24](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L24) ___ @@ -170,22 +171,22 @@ Creates an instance based on a seed. #### Defined in -[hdkey.ts:9](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L9) +[hdkey.ts:10](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L10) ___ ### fromMnemonic -▸ `Static` **fromMnemonic**(`mnemonic`, `_passphrase`): [`EthereumHDKey`](hdkey.EthereumHDKey.md) +▸ `Static` **fromMnemonic**(`mnemonic`, `passphrase?`): [`EthereumHDKey`](hdkey.EthereumHDKey.md) -Creates an instance based on a [BIP39 Mnemonic phrases](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki). +Creates an instance based on BIP39 mnemonic phrases #### Parameters | Name | Type | | :------ | :------ | | `mnemonic` | `string` | -| `_passphrase` | `string` | +| `passphrase?` | `string` | #### Returns @@ -193,4 +194,4 @@ Creates an instance based on a [BIP39 Mnemonic phrases](https://github.com/bitco #### Defined in -[hdkey.ts:16](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L16) +[hdkey.ts:17](https://github.com/ethereumjs/ethereumjs-monorepo/blob/master/packages/wallet/src/hdkey.ts#L17) diff --git a/packages/wallet/package.json b/packages/wallet/package.json index ed03ed2784..e54f2cfe08 100644 --- a/packages/wallet/package.json +++ b/packages/wallet/package.json @@ -1,6 +1,6 @@ { "name": "@ethereumjs/wallet", - "version": "2.0.0", + "version": "2.0.1", "description": "Utilities for handling Ethereum keys", "keywords": [ "ethereum", @@ -46,7 +46,7 @@ "tsc": "../../config/cli/ts-compile.sh" }, "dependencies": { - "@ethereumjs/util": "^9.0.0", + "@ethereumjs/util": "^9.0.1", "@scure/base": "^1.1.1", "ethereum-cryptography": "^2.1.2", "js-md5": "^0.7.3",