Skip to content

Releases: scroll-tech/go-ethereum

scroll-v5.8.38

15 Apr 09:05
bda2089
Compare
Choose a tag to compare

This is a hotfix release for scroll-v5.8.33.

Note

For instructions on how to upgrade Scroll Euclid, please refer to: https://github.com/scroll-tech/go-ethereum/releases/tag/scroll-v5.8.33

What's Changed

Full Changelog: scroll-v5.8.33...scroll-v5.8.38

scroll-v5.8.33

31 Mar 03:53
2475786
Compare
Choose a tag to compare

Overview

This release enables the upcoming Euclid upgrade on Scroll Mainnet. Euclid consists of two phases (two forks):

  • Euclid phase-1 at timestamp 1744815600 (Wed Apr 16 2025 15:00:00 GMT+0000).
  • Euclid phase-2 at timestamp 1745305200 (Tue Apr 22 2025 07:00:00 GMT+0000).

This upgrade enables a series of important changes including:

  • Support for MPT state commitment.
  • Disable CCC and transaction skipping.
  • Enable EIP-7702 and RIP-7212.
  • Support for DACodecV7 and MessageQueueV2.
  • Deprecate Clique and migrate to the new SystemContract Proof-of-Authority consensus.
  • Add tools for permissionless batch submission and recovery.

Who should upgrade?

Node operators running on Scroll Mainnet must upgrade to this release.

Node operators running on Scroll Sepolia do not need to upgrade to this release.

How to upgrade?

DA Sync

From this release on, nodes that fetch rollup data from L1 (nodes running with the --rollup.verify flag, and L1 follower nodes) must connect to a blob data source.

We recommend directly connecting to a beacon node endpoint:

--da.blob.beaconnode "http://l1geth-cl:5052" // change to your endpoint

Note: The beacon node should store all past Scroll blobs. If the node prunes past blobs, it will not be suitable for syncing. In that case you might see errors like failed to fetch blob from blob client.

In addition, you can also configure other blob sources:

Mainnet:
--da.blob.blobscan "https://api.blobscan.com/blobs/" 
--da.blob.blocknative "https://api.ethernow.xyz/v1/blob/"

Sepolia:
--da.blob.blobscan "https://api.sepolia.blobscan.com/blobs/"

You must configure at least one of these flags. (You can configure all.)

MPT Mode

In the Euclid upgrade Scroll will migrate to a new state commitment scheme (from zktrie to MPT). In this release we continue supporting both modes. From here on we will refer to these as l2geth-zktrie and l2geth-mpt nodes. Both types of nodes use the same binary / Docker image, but slightly different configuration.

Existing nodes (l2geth-zktrie) can be upgraded in place without any changes to the database. These nodes will work just fine prior to the Euclid fork and provide all the functionality they normally provide. After the fork boundary, they will be allowed to stay connected to the network, follow the chain, and take part in the P2P gossip network. But they will stop verifying state roots that come with block headers and they won’t be able to provide state proofs for any of the Euclid blocks.

We recommend that node operators set up new l2geth-mpt nodes. This requires a full resync:

  • Set up a new node. You can use your previous configuration flags, but add --scroll-mpt and --gcmode=archive to enable mpt mode
  • Wait for the node to fully sync.
  • If you maintain a load balancer (e.g. RPC operators), redirect it to the new l2geth-mpt nodes during or shortly after Euclid phase-1. This will ensure that eth_getProof returns correct results.
  • After Euclid, you can remove all the previous l2geth-zktrie nodes.

For faster sync, node operators can use the Scroll Mainnet l2geth-mpt snapshot: https://scroll-geth-snapshot.s3.us-west-2.amazonaws.com/mpt/latest.tar

Compatibility

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

If you do not use the --scroll flag, then you must update and reimport genesis.json.

genesis.json for l2geth-zktrie nodes
{
  "config": {
    "chainId": 534352,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip150Hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "eip155Block": 0,
    "eip158Block": 0,
    "byzantiumBlock": 0,
    "constantinopleBlock": 0,
    "petersburgBlock": 0,
    "istanbulBlock": 0,
    "berlinBlock": 0,
    "londonBlock": 0,
    "archimedesBlock": 0,
    "shanghaiBlock": 0,
    "bernoulliBlock": 5220340,
    "curieBlock": 7096836,
    "darwinTime": 1724227200,
    "darwinV2Time": 1725264000,
    "euclidTime": 1744815600,
    "euclidV2Time": 1745305200,
    "clique": {
      "period": 3,
      "epoch": 30000
    },
    "systemContract": {
      "period": 3,
      "system_contract_address": "0x8432728A257646449245558B8b7Dbe51A16c7a4D",
      "system_contract_slot": "0x0000000000000000000000000000000000000000000000000000000000000067"
    },
    "scroll": {
      "useZktrie": true,
      "maxTxPerBlock": 100,
      "maxTxPayloadBytesPerBlock": 122880,
      "feeVaultAddress": "0x5300000000000000000000000000000000000005",
      "l1Config": {
        "l1ChainId": "1",
        "l1MessageQueueAddress": "0x0d7E906BD9cAFa154b048cFa766Cc1E54E39AF9B",
        "l1MessageQueueV2Address": "0x56971da63A3C0205184FEF096E9ddFc7A8C2D18a",
        "l1MessageQueueV2DeploymentBlock": 22088276,
        "scrollChainAddress": "0xa13BAF47339d63B743e7Da8741db5456DAc1E556",
        "numL1MessagesPerBlock": "10"
      },
      "genesisStateRoot": "0x08d535cc60f40af5dd3b31e0998d7567c2d568b224bed2ba26070aeb078d1339"
    }
  },
  "nonce": "0x0",
  "timestamp": "0x6524e860",
  "extraData": "0x4c61206573746f6e7465636f206573746173206d616c6665726d6974612e0000d2ACF5d16a983DB0d909d9D761B8337Fabd6cBd10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "gasLimit": "10000000",
  "difficulty": "0x1",
  "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "coinbase": "0x0000000000000000000000000000000000000000",
  "alloc": {
    "0xF9062b8a30e0d7722960e305049FA50b86ba6253": {
      "balance": "2000000000000000000"
    },
    "0x781e90f1c8Fc4611c9b7497C3B47F99Ef6969CbC": {
      "balance": "226156424291633194186662080095093570025917938800079226637565593765455331328"
    },
    "0x5300000000000000000000000000000000000000": {
      "balance": "0x0",
      "code": "0x608060405234801561001057600080fd5b50600436106100935760003560e01c806383cc76601161006657806383cc7660146100fc5780638da5cb5b1461010f578063c4d66de814610122578063d4b9f4fa14610135578063f2fde38b1461013e57600080fd5b806326aad7b7146100985780633cb747bf146100b4578063600a2e77146100df578063715018a6146100f2575b600080fd5b6100a160015481565b6040519081526020015b60405180910390f35b6053546100c7906001600160a01b031681565b6040516001600160a01b0390911681526020016100ab565b6100a16100ed36600461054a565b610151565b6100fa6101f6565b005b6100a161010a36600461054a565b61022c565b6052546100c7906001600160a01b031681565b6100fa610130366004610563565b610243565b6100a160005481565b6100fa61014c366004610563565b6102db565b6053546000906001600160a01b031633146101a45760405162461bcd60e51b815260206004820152600e60248201526d37b7363c9036b2b9b9b2b733b2b960911b60448201526064015b60405180910390fd5b6000806101b084610367565b60408051838152602081018890529294509092507ffaa617c2d8ce12c62637dbce76efcc18dae60574aa95709bdcedce7e76071693910160405180910390a19392505050565b6052546001600160a01b031633146102205760405162461bcd60e51b815260040161019b90610593565b61022a6000610486565b565b602a816028811061023c57600080fd5b0154905081565b6052546001600160a01b0316331461026d5760405162461bcd60e51b815260040161019b90610593565b600154156102b15760405162461bcd60e51b815260206004820152601160248201527063616e6e6f7420696e697469616c697a6560781b604482015260640161019b565b6102b96104d8565b605380546001600160a01b0319166001600160a01b0392909216919091179055565b6052546001600160a01b031633146103055760405162461bcd60e51b815260040161019b90610593565b6001600160a01b03811661035b5760405162461bcd60e51b815260206004820152601d60248201527f6e6577206f776e657220697320746865207a65726f2061646472657373000000604482015260640161019b565b61036481610486565b50565b60035460009081906103bb5760405162461bcd60e51b815260206004820152601a60248201527f63616c6c206265666f726520696e697469616c697a6174696f6e000000000000604482015260640161019b565b6001548360005b8215610456576103d36002846105e0565b60000361041f5781602a82602881106103ee576103ee6105ca565b01556104188260028360288110610407576104076105ca565b015460009182526020526040902090565b915061044a565b610447602a8260288110610435576104356105ca565b01548360009182526020526040902090565b91505b600192831c92016103c2565b81602a826028811061046a5761046a6105ca565b0155506000819055600180548082019091559590945092505050565b605280546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60005b60286104e8826001610618565b10156103645761051960028260288110610504576105046105ca565b015460028360288110610407576104076105ca565b6002610526836001610618565b60288110610536576105366105ca565b01558061054281610631565b9150506104db565b60006020828403121561055c57600080fd5b5035919050565b60006020828403121561057557600080fd5b81356001600160a01b038116811461058c57600080fd5b9392505050565b60208082526017908201527f63616c6c6572206973206e6f7420746865206f776e6572000000000000000000604082015260600190565b634e487b7160e01b600052603260045260246000fd5b6000826105fd57634e487b7160e01b600052601260045260246000fd5b500690565b634e487b7160e01b600052601160045260246000fd5b8082018082111561062b5761062b610602565b92915050565b60006001820161064357610643610602565b506001019056fea26469706673582212208fb1cb9933bb17dd0a7c17de7c890919b08d2fd7eb2bede7b41caa32709b30b564736f6c63430008100033",
      "storage": {
        "0x0000000000000000000000000000000000000000000000000000000000000052": "0xF9062b8a30e0d7722960e305049FA50b86ba6253"
      }
    },
    "0x5300000000000000000000000000000000000002": {
      "balan...
Read more

scroll-v5.8.25

13 Mar 15:20
scroll-v5.8.25
aec0089
Compare
Choose a tag to compare

Overview

This is a hotfix release for Scroll Sepolia.

This is a mandatory release for l2geth nodes running on the Scroll Sepolia testnet that have --rollup.verify enabled. Nodes can be upgraded to the new version in place, without any additional configuration changes, and they should recover automatically.

For other nodes (mainnet ones or ones that do not run with rollup verification) this release is not required.

A batch decoding issue led to l2geth nodes deriving the wrong batch hash and crashing with Batch hash mismatch. In this release we fix the codec and automatically reset the node's sync height when it encounters the problematic batch. This will make the node re-sync recent batches and derive the correct batch hash.

scroll-v5.8.23

05 Mar 20:53
scroll-v5.8.23
478940e
Compare
Choose a tag to compare

Edit(2025/03/10): Added note about beacon node requirements.

Overview

This release enables the upcoming Euclid upgrade on the Scroll Sepolia testnet. Euclid consists of two phases (two forks):

  • Euclid phase-1 at timestamp 1741680000 (Tue Mar 11 2025 08:00:00 GMT+0000).
  • Euclid phase-2 at timestamp 1741852800 (Thu Mar 13 2025 08:00:00 GMT+0000).

This upgrade enables a series of important changes including:

  • Support for MPT state commitment.
  • Disable CCC and transaction skipping.
  • Enable EIP-7702 and RIP-7212.
  • Support for DaCodecV7 and MessageQueueV2.
  • Deprecate Clique and migrate to the new SystemContract Proof-of-Authority consensus.
  • Add tools for permissionless batch submission and recovery.

Who should upgrade?

Node operators running on Scroll Sepolia must upgrade to this release.

Node operators running on Scroll mainnet should not upgrade to this release. We will publish a separate release for mainnet around the end of March.

How to upgrade?

DA Sync

From this release on, nodes that fetch rollup data from L1 (nodes running with the --rollup.verify flag, and L1 follower nodes) must connect to a blob data source.

We recommend directly connecting to a beacon node endpoint:

--da.blob.beaconnode "http://l1geth-cl:5052" // change to your endpoint

Note: The beacon node should store all past Scroll blobs. If the node prunes past blobs, it will not be suitable for syncing. In that case you might see errors like failed to fetch blob from blob client.

In addition, you can also configure other blob sources:

--da.blob.blobscan "https://api.sepolia.blobscan.com/blobs/"

You must configure at least one of these flags. (You can configure both.)

MPT Mode

In the Euclid upgrade Scroll will migrate to a new state commitment scheme (from zktrie to MPT). In this release we continue supporting both modes. From here on we will refer to these as l2geth-zktrie and l2geth-mpt nodes. Both types of nodes use the same binary / Docker image, but slightly different configuration.

Existing nodes (l2geth-zktrie) can be upgraded in place without any changes to the database. These nodes will work just fine prior to the Euclid fork and provide all the functionality they normally provide. After the fork boundary, they will be allowed to stay connected to the network, follow the chain, and take part in the P2P gossip network. But they will stop verifying state roots that come with block headers and they won’t be able to provide state proofs for any of the Euclid blocks.

We recommend that node operators set up new l2geth-mpt nodes. This requires a full resync:

  • Set up a new node. You can use your previous configuration flags, but add --scroll-mpt to enable mpt mode.
  • Wait for the node to fully sync.
  • If you maintain a load balancer (e.g. RPC operators), redirect it to the new l2geth-mpt nodes during or shortly after Euclid phase-1. This will ensure that eth_getProof returns correct results.
  • After Euclid, you can remove all the previous l2geth-zktrie nodes.

For faster sync, node operators can use the Sepolia l2geth-mpt snapshot: https://scroll-sepolia-l2geth-snapshots.s3.us-west-2.amazonaws.com/scroll-mpt-2025-03-02.tar

Compatibility

This release updates the embedded hard fork block timestamp for Scroll Sepolia. Nodes that are not upgraded will be unable to follow the network after the hard fork block. To follow the Euclid upgrade, simply run your node with the --scroll-sepolia flag.

If you do not use the --scroll-sepolia flag, then you must update and reimport genesis.json.

genesis.json for l2geth-zktrie nodes
{
  "config": {
    "chainId": 534351,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip150Hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "eip155Block": 0,
    "eip158Block": 0,
    "byzantiumBlock": 0,
    "constantinopleBlock": 0,
    "petersburgBlock": 0,
    "istanbulBlock": 0,
    "berlinBlock": 0,
    "londonBlock": 0,
    "archimedesBlock": 0,
    "shanghaiBlock": 0,
    "bernoulliBlock": 3747132,
    "curieBlock": 4740239,
    "darwinTime": 1723622400,
    "darwinV2Time": 1724832000,
    "euclidTime": 1741680000,
    "euclidV2Time": 1741852800,
    "clique": {
      "period": 3,
      "epoch": 30000
    },
    "systemContract": {
      "period": 3,
      "system_contract_address": "0xC706Ba9fa4fedF4507CB7A898b4766c1bbf9be57",
      "system_contract_slot": "0x0000000000000000000000000000000000000000000000000000000000000067"
    },
    "scroll": {
      "useZktrie": true,
      "maxTxPerBlock": 100,
      "maxTxPayloadBytesPerBlock": 122880,
      "feeVaultAddress": "0x5300000000000000000000000000000000000005",
      "l1Config": {
        "l1ChainId": "11155111",
        "l1MessageQueueAddress": "0xF0B2293F5D834eAe920c6974D50957A1732de763",
        "l1MessageQueueV2Address": "0xA0673eC0A48aa924f067F1274EcD281A10c5f19F",
        "l1MessageQueueV2DeploymentBlock": 7773746,
        "scrollChainAddress": "0x2D567EcE699Eabe5afCd141eDB7A4f2D0D6ce8a0",
        "numL1MessagesPerBlock": "10"
      },
      "genesisStateRoot": "0x20695989e9038823e35f0e88fbc44659ffdbfa1fe89fbeb2689b43f15fa64cb5"
    }
  },
  "nonce": "0x0",
  "timestamp": "0x64cfd015",
  "extraData": "0x000000000000000000000000000000000000000000000000000000000000000048C3F81f3D998b6652900e1C3183736C238Fe4290000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "gasLimit": "8000000",
  "difficulty": "0x1",
  "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "coinbase": "0x0000000000000000000000000000000000000000",
  "alloc": {
    "0x18960EEc21b1878C581937a14c5c3C43008F6b6B": {
      "balance": "10000000000000000000"
    },
    "0xBa50f5340FB9F3Bd074bD638c9BE13eCB36E603d": {
      "balance": "226156424291633194186662080095093570025917938800079226629565593765455331328"
    },
    "0x5300000000000000000000000000000000000000": {
      "balance": "0x0",
      "code": "0x608060405234801561001057600080fd5b50600436106100935760003560e01c806383cc76601161006657806383cc7660146100fc5780638da5cb5b1461010f578063c4d66de814610122578063d4b9f4fa14610135578063f2fde38b1461013e57600080fd5b806326aad7b7146100985780633cb747bf146100b4578063600a2e77146100df578063715018a6146100f2575b600080fd5b6100a160015481565b6040519081526020015b60405180910390f35b6053546100c7906001600160a01b031681565b6040516001600160a01b0390911681526020016100ab565b6100a16100ed36600461054a565b610151565b6100fa6101f6565b005b6100a161010a36600461054a565b61022c565b6052546100c7906001600160a01b031681565b6100fa610130366004610563565b610243565b6100a160005481565b6100fa61014c366004610563565b6102db565b6053546000906001600160a01b031633146101a45760405162461bcd60e51b815260206004820152600e60248201526d37b7363c9036b2b9b9b2b733b2b960911b60448201526064015b60405180910390fd5b6000806101b084610367565b60408051838152602081018890529294509092507ffaa617c2d8ce12c62637dbce76efcc18dae60574aa95709bdcedce7e76071693910160405180910390a19392505050565b6052546001600160a01b031633146102205760405162461bcd60e51b815260040161019b90610593565b61022a6000610486565b565b602a816028811061023c57600080fd5b0154905081565b6052546001600160a01b0316331461026d5760405162461bcd60e51b815260040161019b90610593565b600154156102b15760405162461bcd60e51b815260206004820152601160248201527063616e6e6f7420696e697469616c697a6560781b604482015260640161019b565b6102b96104d8565b605380546001600160a01b0319166001600160a01b0392909216919091179055565b6052546001600160a01b031633146103055760405162461bcd60e51b815260040161019b90610593565b6001600160a01b03811661035b5760405162461bcd60e51b815260206004820152601d60248201527f6e6577206f776e657220697320746865207a65726f2061646472657373000000604482015260640161019b565b61036481610486565b50565b60035460009081906103bb5760405162461bcd60e51b815260206004820152601a60248201527f63616c6c206265666f726520696e697469616c697a6174696f6e000000000000604482015260640161019b565b6001548360005b8215610456576103d36002846105e0565b60000361041f5781602a82602881106103ee576103ee6105ca565b01556104188260028360288110610407576104076105ca565b015460009182526020526040902090565b915061044a565b610447602a8260288110610435576104356105ca565b01548360009182526020526040902090565b91505b600192831c92016103c2565b81602a826028811061046a5761046a6105ca565b0155506000819055600180548082019091559590945092505050565b605280546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60005b60286104e8826001610618565b10156103645761051960028260288110610504576105046105ca565b015460028360288110610407576104076105ca565b6002610526836001610618565b60288110610536576105366105ca565b01558061054281610631565b9150506104db565b60006020828403121561055c57600080fd5b5035919050565b60006020828403121561057557600080fd5b81356001600160a01b038116811461058c57600080fd5b9392505050565b60208082526017908201527f63616c6c6572206973206e6f7420746865206f776e6572000000000000000000604082015260600190565b634e487b7160e01b600052603260045260246000fd5b6000826105fd57634e487b7160e01b600052601260045260246000fd5b500690565b634e487b7160e01b600052601160045260246000fd5b8082018082111561062b5761062b610602565b92915050565b60006001820161064357610643610602565b506001019056fea26469706673582212208fb1cb9933bb17dd0a7c17de7c890919b08d2fd7eb2bede7b41caa32709b30b564736f6c63430008100033",
      "storage": {
        "0x0000000000000000000000000000000000000000000000000000000000000052": "0x18960EEc21b1878C581937a14c5c3C43008F6b6B"
      }
    },
    "0x5300000000000000000000000000000000000002...
Read more

scroll-v5.8.0

20 Dec 12:19
scroll-v5.8.0
ac8164f
Compare
Choose a tag to compare

Overview

This is a maintenance release that introduces various minor improvements and the new experimental L1 follower mode. Upgrading is optional.

Compatibility

This release is fully backward-compatible.

L1 Follower Mode

#1098 adds experimental support for L1 follower mode in l2geth.

In L1 follower mode, the node syncs the chain directly from L1 DA (consuming events, calldata, and blobs) instead of acquiring the block data from the L2 peer-to-peer network. As such, this is a safer and more censorship-resistant way to sync the ledger, but the current release has important caveats:

  • L1 follower mode sync is slower as it relies heavily on L1 EL and CL endpoints and 3rd-party APIs.
  • Currently only finalized Ethereum blocks are processed.
  • L1 follower nodes are able to reconstruct L2 state. However, their derived L2 chain will have different block hashes compared to other L2 nodes. This will be fixed in a later upgrade.
  • L1 follower mode is experimental and it is not considered production ready in this release.

Current node operators can safely upgrade their nodes to scroll-v5.8.0, but they should not enable L1 follower mode.

For non-production nodes, we invite the community to experiment with L1 follower modes and provide feedback. To run an L1 follower node, simply specify the --da.sync and --da.blob.beaconnode "<L1 beacon node>" CLI flags when running l2geth.

For more instructions and details, please refer to the documentation.

Other Notable Changes

#1096 sets the default gas tip returned by the GPO as 100 wei. This should help clients avoid certain types of issues when bumping gas (see the PR description for details). This value is configurable through the newly added --gpo.defaultgastipcap flag.

#1095 adopts an eth_call RPC adjustment from upstream geth.

What's Changed

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

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