Skip to content

Releases: scroll-tech/go-ethereum

scroll-v5.7.25

19 Nov 17:47
9fff27e
Compare
Choose a tag to compare

Overview

This is a maintenance release, including various minor fixes and improvements.

This release also fixes incorrect base fee estimation in various RPC APIs. We recommend that all RPC node operators gradually upgrade their nodes to this version.

Compatibility

This release is fully backward-compatible.

What's Changed

New Contributors

Full Changelog: scroll-v5.7.0...scroll-v5.7.25

scroll-v5.7.0

27 Aug 06:08
scroll-v5.7.0
ff23c52
Compare
Choose a tag to compare

Overview

This is a mandatory release for nodes running with rollup verification enabled. For other nodes, this is a recommended release.

This is a small follow-up release after the recent Darwin upgrade. This release embeds the fork timestamps for DarwinV2 for Scroll mainnet and Scroll Sepolia.

Compatibility

Similar to the previous release, this upgrade does not change Scroll's state transition function, so it is backward compatible. However, the format of the batch data committed to Ethereum changes. As a result, nodes that enabled rollup verification (--rollup.verify) must upgrade to be able to follow the chain.

To follow the DarwinV2 upgrade, simply upgrade your node and run it with the --scroll or --scroll-sepolia flag respectively. If you do not use these flags, then you must update your genesis.json file and reimport it using geth init genesis.json:

  • Add "darwinV2Time": 1725264000 for Scroll mainnet.
  • Add "darwinV2Time": 1724832000 for Scroll Sepolia.

What's Changed

New Contributors

Full Changelog: scroll-v5.6.0...scroll-v5.7.0

scroll-v5.6.0

05 Aug 17:19
scroll-v5.6.0
dfd4039
Compare
Choose a tag to compare

Overview

This is a mandatory release for nodes running with rollup verification enabled. For other nodes, this is a recommended release.

We recommend that all node operators subscribe to release notifications on this repository.

This release introduces timestamp-based upgrades and embeds the Darwin upgrade timestamp for Scroll mainnet and Scroll Sepolia.

This release also includes additional robustness and compatibility improvements.

Compatibility

The Darwin upgrade does not change Scroll's state transition function, so this upgrade is backward compatible. However, the format of the batch data committed to Ethereum changes. As a result, nodes that enabled rollup verification (--rollup.verify) must upgrade to be able to follow the chain.

To follow the Darwin upgrade, simply upgrade your node and run it with the --scroll or --scroll-sepolia flag respectively. If you do not use these flags, then you must update your genesis.json file and reimport it using geth init genesis.json:

  • Add "darwinTime": 1724227200 for Scroll mainnet.
  • Add "darwinTime": 1723622400 for Scroll Sepolia.

Note for RPC Node Operators

We recommend that RPC node operators configure the following flag:

--gpo.congestionthreshold=500

This configuration allows nodes to provide more accurate fee estimates.

What's Changed

  • feat: make descartes a timestamp based fork by @omerfirmak in #852
  • fix: add missing CA certificates to Dockerfile.mockccc by @jonastheis in #861
  • feat: rename next upgrade to Darwin by @Thegaram in #863
  • feat(rollup_sync_service): handle multiple batches in FinalizeBatch event by @amoylan2 in #865
  • feat: update to ccc v0.11.4 by @Thegaram in #872
  • fix(CI): remove libzktrie.so by @colinlyguo in #878
  • feat: Configure l2geth Docker pipeline to push latest tag by @NazariiDenha in #831
  • fix(p2p): re-enable ENRUpdater by @HAOYUatHZ in #869
  • fix(signer): update LatestSigner logic by @HAOYUatHZ in #880
  • fix: scroll greeting message by @omerfirmak in #885
  • feat: add codecv3 for darwin batches by @amoylan2 in #866
  • feat: update L2 base fee formula by @Thegaram in #891
  • fix(GPO): min suggested tip cap if there's congestion to avoid filtering through DefaultIgnorePrice by @jonastheis in #883
  • feat(txpool): StatsWithMinBaseFee by @jonastheis in #884
  • fix: return early as expected when engine.Prepare fails by @omerfirmak in #886
  • fix(tracing): fix error handling in fillBlockTrace by @HAOYUatHZ in #890
  • feat(txpool): use GasFeeCapIntCmp to check min fee by @Thegaram in #901
  • fix(rollup-verifier): decode commitBatchWithBlobProof calldata by @colinlyguo in #896
  • refactor(trace): clean outdated fields by @lispc in #842
  • fix(l2geth-verifier): only check last batch of the bundle by @colinlyguo in #904
  • fix(verifier): nil panic due to batch write by @colinlyguo in #911
  • fix(miner,rpc): fix updateSnapshot by @HAOYUatHZ in #916
  • fix: log Rust trace parsing error by @Thegaram in #918
  • feat(libzkp):unbounded depth serde json by @georgehao in #920
  • fix: treat JSON errors as CCC error by @omerfirmak in #922
  • feat: defer txpool reorg until worker fetches txns for the next block by @omerfirmak in #905
  • feat(clique): allow shadowforking a clique network by @omerfirmak in #828
  • refactor: reduce number of heap allocations in tracing by @omerfirmak in #952
  • feat: update L2 base fee formula by @HAOYUatHZ in #951
  • Revert "refactor: reduce number of heap allocations in tracing (#952)" by @omerfirmak in #959
  • feat: schedule Darwin hard fork by @Thegaram in #963

Full Changelog: scroll-v5.5.0...scroll-v5.6.0

scroll-v5.5.0

24 Jun 14:28
scroll-v5.5.0
7da0bd5
Compare
Choose a tag to compare

Overview

This is a mandatory release for Scroll mainnet nodes.

This release updates the embedded Scroll mainnet fork height for the upcoming Curie upgrade.

This release also includes additional robustness and compatibility improvements.

Compatibility

This release updates the embedded hard fork block height for Scroll mainnet. Nodes that are not upgraded will be unable to follow the network after the hard fork block. To follow the Curie upgrade, simply upgrade your node and run it with the --scroll flag.

If you do not use the --scroll flag, then you must upgrade your genesis.json file to "curieBlock": 7096836 and reimport it using geth init genesis.json. In this case, upgrading to this release is optional but recommended.

For Scroll Sepolia nodes, upgrading to this version is optional.

What's Changed

Full Changelog: scroll-v5.4.2...scroll-v5.5.0

scroll-v5.4.2

12 Jun 12:15
scroll-v5.4.2
69aae68
Compare
Choose a tag to compare

⚠️ For Scroll mainnet nodes, this version has been superseded by scroll-v5.5.0, please use this newer version.

Overview

This is a mandatory release for Scroll mainnet and Scroll Sepolia nodes.

This release embeds the Scroll mainnet fork height for the upcoming Curie upgrade.

The Curie hard fork upgrade contains the following changes:

  • Pack more chunks into each batch and compress blob data using zstd.
  • Support EIP-1559 transactions.
  • Support the BASEFEE, MCOPY, TLOAD, TSTORE opcodes.
  • More accurate transaction pricing for both execution (gas) fee and L1 data fee.

Other notable changes:

  • Significant performance and robustness improvements. In particular, the storage requirements of running an l2geth node on Scroll mainnet are reduced by about 50% (only applicable to newly synced nodes).
  • l2geth nodes will no longer automatically configure the --cache.noprefetch flag. For now, we recommend that node operators still run their nodes with this flag.
  • Added support for the eth_getBlockReceipts API.

Compatibility

This release introduces a hard fork upgrade on both Scroll mainnet and Scroll Sepolia. Nodes that are not upgraded will be unable to follow the network after the hard fork block.

To follow the Curie upgrade, simply upgrade your node and run it with the --scroll or --scroll-sepolia flag, depending on which network you want to join.

If you do not use this flag but provide a custom genesis file instead, then you must add "curieBlock": N (replace N with the fork block from the previous section) to the fork list in genesis.json, and reimport it using geth init genesis.json.

What's Changed

New Contributors

Full Changelog: scroll-v5.3.0...scroll-v5.4.2

scroll-v5.3.0

22 Apr 07:53
scroll-v5.3.0
246955a
Compare
Choose a tag to compare

Overview

This is a mandatory release for Scroll mainnet nodes.

This release embeds the Scroll mainnet fork height for Bernoulli, scheduled to go live at block 5220340 (within a few hours after Mon Apr 29 02:00 am UTC). The Bernoulli hard fork upgrade contains the following changes:

  • Enable SHA-256 precompile.
  • Use EIP-4844 blobs for Data Availability (not part of l2geth).

Compatibility

This release introduces a hard fork upgrade on Scroll mainnet. Nodes that are not upgraded will be unable to follow the network after the hard fork block.

To follow the Bernoulli upgrade on Scroll mainnet, simply upgrade your node and run it with the --scroll flag. If you do not use this flag but provide a custom genesis file instead, then you must add "bernoulliBlock": 5220340 to the fork list in genesis.json.

Please refer to this document for further notes on compatibility.

What's Changed

  • fix(rollup-verifier): hardcode genesis codec version as codecv0 and sync codecv1 implementation by @colinlyguo in #699
  • feat: add more state_transition, worker, and tracing metrics by @georgehao in #700
  • CI: build image which supports arm64 platform by @sbaizet-ledger in #702
  • Ci add support for arm64 platform by @sbaizet-ledger in #703
  • fix(ci): fix version bot by @HAOYUatHZ in #705
  • feat(worker): add a commit tx failed metric by @colinlyguo in #704
  • feat(worker): seal block early if we're over target block time by @Thegaram in #706
  • feat: add block time metric by @Thegaram in #707
  • feat: enable Bernoulli upgrade on Scroll mainnet by @Thegaram in #710

New Contributors

Full Changelog: scroll-v5.2.0...scroll-v5.3.0

scroll-v5.2.0

08 Apr 09:35
scroll-v5.2.0
85447ec
Compare
Choose a tag to compare

Overview

This release embeds the Scroll Sepolia testnet fork height for Bernoulli, scheduled to go live at block 3747132 (within a few hours after Mon Apr 15 02:30 am UTC). The Bernoulli hard fork upgrade contains the following changes:

  • Enable SHA-256 precompile.
  • Use EIP-4844 blobs for Data Availability (not part of l2geth).

Additionally, this release contains new features and important robustness improvements. This release aims to fix a long-standing bug #592 that would lead to database corruption in rare cases when the L1 endpoint would become temporarily unavailable. When this happens, the best recourse is to re-sync the node. To avoid this, it is recommended to upgrade to this release.

For nodes running on Scroll Sepolia, upgrading is mandatory. On Scroll mainnet, upgrading is optional but recommended.

Compatibility

This release introduces a hard fork upgrade on the Scroll Sepolia testnet. Nodes that are not upgraded will be unable to follow the testnet after the hard fork block.

To follow the Bernoulli upgrade on Scroll Sepolia, simply upgrade your node and run it with the --scroll-sepolia flag. If you do not use this flag but provide a custom genesis file instead, then you must add "bernoulliBlock": 3747132 to the fork list in genesis.json.

Please refer to this document for further notes on compatibility.

Notable changes

  • #679 and #682 aim to fix a long-standing bug #592 that would lead to database corruption in some rare cases.
  • #627 fixes an issue where unexecutable transactions would in certain cases be kept in the transaction pool.
  • #636 aims to fix building l2geth on Windows systems.
  • #688 enables the Bernoulli hard fork on Scroll Sepolia.

What's Changed

  • fix(txpool): revert duplicated l1 data fee check by @colinlyguo in #612
  • fix(receipt): L1 message type tx RLP decoding by @colinlyguo in #616
  • feat: add mux tracer for native call tracer and native prestate tracers by @HAOYUatHZ in #615
  • docs: update README.md by @crzrh in #593
  • fix(ethclient): support new cancun fields in header by @colinlyguo in #623
  • feat(transactions): support blob tx only in encoding/decoding by @colinlyguo in #626
  • ci: fix goimports lint in CI by @Thegaram in #628
  • feat: setup configuration for upcoming hard fork and re-enable sha256 precompile by @NazariiDenha in #562
  • fix(rollup sync service): remove syscall.Kill by @colinlyguo in #636
  • ci: fix blocktraces submodule url by @qezz in #632
  • feat: add metric to evm call by @georgehao in #646
  • feat: add transactions len metrics of block processer by @georgehao in #650
  • fix(txJSON): L1 message type MarshalJSON by @colinlyguo in #630
  • feat(ethclient): export GetTxBlockTraceOnTopOfBlock & GetNumSkippedTransactions & GetSkippedTransactionHashes & GetSkippedTransaction by @HAOYUatHZ in #644
  • feat: re-enable EIP-1559 in Banach hard fork by @Thegaram in #634
  • feat(ethclient & gethclient): support blob transaction by @colinlyguo in #661
  • chore(docker): make sure the libzkp directory is clean by @omerfirmak in #664
  • chore(libzkp): upgrade to v0.9.10, optimize ccc for follower&chunking by @lispc in #676
  • fix: ensure L1 messages are stored in db consistently by @Thegaram in #679
  • feat: update upcoming fork names by @Thegaram in #680
  • fix(zktrie): fix NewZktrieDatabase by @HAOYUatHZ in #638
  • fix(sync-service): only add queue index when message index is not zero by @colinlyguo in #682
  • fix: Check L1DataFee in txpool promoteExecutables and demoteUnexecutables by @vyzo in #627
  • feat: add metrics to block validation by @Thegaram in #677
  • fix(tracing): disable storage for block_traces by @HAOYUatHZ in #684
  • ci: add bump_version bot by @HAOYUatHZ in #538
  • feat(rollup-verifier): support codecv1 by @colinlyguo in #678
  • fix(state): fix iterativeDump.OnAccount by @HAOYUatHZ in #649
  • fix(txpool): rollback false optimization by @georgehao in #694
  • chore(libzkp): upgrade to v0.9.13, support next hard fork transition by @lispc in #693
  • feat(sepolia): enable Bernoulli hard fork by @Thegaram in #688

New Contributors

Full Changelog: scroll-v5.1.10...scroll-v5.2.0

scroll-v5.1.10

04 Jan 15:57
scroll-v5.1.10
5b7079b
Compare
Choose a tag to compare

Overview

This release contains new features and robustness improvements.

For nodes running on Scroll mainnet and Scroll Sepolia, upgrading is optional but recommended.

Compatibility

This version is compatible with the previous release scroll-v5.0.0.

If you run your node with the --scroll or --scroll-sepolia flag, you do not need to change anything. If you use a custom genesis.json configuration, you will need to add scroll.l1Config.scrollChainAddress (see here for Scroll mainnet and here for Scroll Sepolia).

Rollup Verification

#515 adds additional verification by syncing finalized batch data from L1 and comparing it with the node's local ledger. This ensures that the node's local data matches the data committed to L1. This check is optional; to enable it, simply add the --rollup.verify flag when starting your node.

Note: There is an initial catch-up phase when you first enable this feature on a node, as the node needs to sync all finalized batches from L1. This initial sync happens in the background, it does not prevent the node from syncing the L2 ledger or from serving queries. During this period, it is expected to see increased L1 RPC load (on the node specified through the --l1.endpoint flag), as well as higher CPU and memory load.

#548 enables the "finalized" tag on a number of APIs. This tag is only supported when rollup verification is enabled (--rollup.verify flag, see above). eth_getBlockByNumber("finalized", false) will return the latest L2 block that is finalized on L1.

An L2 block is considered finalized when all of the following hold: (1) the block has been published to L1 (as part of a batch), (2) the state root after the execution of the batch has been published to L1 along with a correct validity proof (see the relevant contract code), and (3) the transaction that submitted the validity proof to L1 is considered finalized by L1 consensus.

Other Notable Features

  • #537 fixes a bug where it was impossible to call eth_estimateGas with a sender account with zero balance.
  • #548 adds new APIs scroll_syncStatus and scroll_estimateL1DataFee.
  • #564 and #561 change the Scroll tracing API. If you rely on this API, please consult the Scroll team.

What's Changed

  • fix(libzkp): upgrade to use prover v0.9.7 by @silathdiir in #535
  • refactor(tracing): refactor wrappedProof by @HAOYUatHZ in #536
  • fix (libzkp): free Rust CString by from_raw (potential memory leak) by @silathdiir in #539
  • fix: eth_estimateGas error in zero balance address by @colinlyguo in #537
  • feat(rollup): sync finalized batches from L1 by @colinlyguo in #515
  • perf(miner): reduce rawdb calls for getting StartL1QueueIndex when inniting environment by @GDdark in #550
  • feat(rpc): add scroll_* rollup APIs by @colinlyguo in #548
  • Add metrics around block commit, block traces, and CCC by @vyzo in #552
  • refactor(evm): Remove duplicate defined variables by @GDdark in #559
  • fix(worker): prioritize overflow tx as first tx in next block by @Thegaram in #563
  • feat: add scroll_getTxBlockTraceOnTopOfBlock API by @HAOYUatHZ in #558
  • feat (libzkp-v0.9.8): recordStorageDetail even when LogConfig.DisableStorage == true by @lispc in #564
  • fix(tracing): fix getTxResult returned error format by @HAOYUatHZ in #561
  • feat(rollup): add fallback if TransactionByHash fails in getting commitBatch calldata by @colinlyguo in #601
  • feat: improve balance check by @HAOYUatHZ in #607
  • feat: remove instead of pop insufficient-funds tx by @HAOYUatHZ in #608
  • fix(tx-pool): consider L1 data fee in validateTx by @colinlyguo in #609

New Contributors

Full Changelog: scroll-v5.0.0...scroll-v5.1.10

scroll-v5.0.0

12 Oct 09:34
scroll-v5.0.0
cfd9de0
Compare
Choose a tag to compare

Overview

This release contains numerous robustness improvements.

⚠️ For nodes running on Scroll Sepolia, upgrading is optional but recommended.

Compatibility

This version is compatible with the previous release scroll-v4.3.51.

Notable Features

  • The node now supports the --rpc.getlogs.maxrange option to limit the block range accepted by the eth_getLogs API. Example usage: --rpc.getlogs.maxrange 5000.

What's Changed

  • fix: update libzkp to use scroll-prover v0.7.5 by @silathdiir in #484
  • feat: store skipped transactions in local db by @Thegaram in #467
  • feat(miner): consider l1msg in txCount by @HAOYUatHZ in #486
  • docs(ccc): add more logs for skipping msg by @HAOYUatHZ in #490
  • fix(miner): fix repeatedly processing dropped txs in a new block by @HAOYUatHZ in #491
  • chore(ccc): v0.7.6: fix: if rws reaches limit, stop early by @lispc in #495
  • fix(modexp): disallow len of 0x8000000000000000000000000000000000000000000… by @lispc in #496
  • feat(metrics): add skipped txs metrics for miner by @Lawliet-Chan in #494
  • fix(trace): more consistent invalid opcode trace by @lispc in #487
  • fix(trace): fix memory trace size by @lispc in #497
  • fix(trace): record account proof for ErrContractAddressCollision by @lispc in #488
  • feat(api/rawdb): allow storing traces for skipped txs by @HAOYUatHZ in #500
  • refactor(ccc): throw error instead of panic for recognized errors by @Lawliet-Chan in #499
  • fix: libzkp v0.8.1 by @silathdiir in #502
  • fix(libzkp): upgrade to v0.8.2 by @silathdiir in #504
  • fix(rawdb, api): fix rawdb.writeSkippedTransaction & api.GetSkippedTransaction by @HAOYUatHZ in #503
  • fix (libzkp): check tx num when CCC ErrUnknown error occurred by @silathdiir in #505
  • fix(ccc): fix CCC build errors by @Thegaram in #506
  • fix(trace): use correct roots in trace of block with one transaction by @Thegaram in #508
  • p2p: limit ping requests from a single peer by @iczc in #510
  • fix(sdk): accept blocks where coinbase is null (e.g. pending block) by @mask-pp in #509
  • fix(worker): check gas limit before running ccc by @Thegaram in #511
  • fix(libzkp): upgrade to use prover v0.9.0 by @silathdiir in #513
  • fix(libzkp): upgrade to use prover v0.9.1 by @silathdiir in #517
  • refactor(worker): order L1 messages by queue index by @Thegaram in #512
  • fix(libzkp): upgrade libzkp to v0.9.2 (fix ccc panic CodeNotFound) by @silathdiir in #520
  • feat: use light_mode = false for block ccc by @lispc in #519
  • fix(ccc): revert light mode by @Thegaram in #524
  • fix(worker): short-circuit l1 message iteration by @Thegaram in #525
  • feat: add metrics in L1 message iterator by @Thegaram in #527
  • feat: configure max block range for eth_getLogs by @NazariiDenha in #521
  • Revert "feat: configure max block range for eth_getLogs (#521)" by @Thegaram in #528
  • fix(libzkp): upgrade libzkp to v0.9.4 and add ccc SetLightMode by @silathdiir in #522
  • fix: re-enable CCC light mode by @Thegaram in #530
  • fix(libzkp): upgrade libzkp to v0.9.5 by @silathdiir in #531
  • Fix/config fix small bug and set default maxBlockRange to -1 to not use it by @NazariiDenha in #529
  • fix: use non-overlapping DB prefix for L1 messages by @Thegaram in #532
  • feat: add new configuration by @Thegaram in #526
  • feat: update network configuration by @Thegaram in #533

Full Changelog: scroll-v4.3.51...scroll-v5.0.0

scroll-v4.3.51

24 Aug 17:31
scroll-v4.3.51
b0657a7
Compare
Choose a tag to compare

Overview

⚠️ This is a required update for nodes running on Scroll Sepolia.

scroll-v4.3.51 fixes a block validation corner case and addresses some performance issues.

What's Changed

  • refactor(trace): wrap the core routine in CreateTraceEnv by @noel2004 in #460
  • fix: free raw result returned from CCC by @Thegaram in #477
  • fix: use correct CGo syntax for Free by @Thegaram in #478
  • fix the bug when calculating l2TxCount. by @mask-pp in #479
  • fix: exclude L1 message from block payload size validation by @Thegaram in #476
  • fix: update row estimation with scroll-prover v0.7.2 by @silathdiir in #475
  • refactor: simplify ccc revert to snapshot by @iczc in #480
  • feat: use --gcmode=archive and --cache.noprefetch=true by default by @Thegaram in #482
  • feat(sdk): support compressed response by @mask-pp in #469
  • fix: disable pruning and prefetch if not flags are provided by @Thegaram in #483

Full Changelog: scroll-v4.3.43...scroll-v4.3.51