Merge pull request #522 from bane-labs/rel-0.5.0

Release v0.5.0

Author: txhsl

CHANGELOG.md

@@ -2,6 +2,46 @@
 
 This document outlines major changes between releases.
 
+## 0.5.0 "Neutralization‌" (23 Oct 2025)
+
+This version introduces the support for two Ethereum major upgrades: Cancun and
+Prague. Since this repository starts from and still is an Execution Layer (EL),
+this upgrade is only a part of Dencun and Pectra. As a result, the proposal of
+EIP-4844 (Shard Blob Transactions) are not fully implemented. Currently, blob
+data is only very short-lived in the network, and doesn't have any API to get
+properly accessed.
+
+Follow the instructions below to upgrade your node from v0.4.2 to v0.5.0:
+
+1. Download new binary and new genesis configuration file from the release page.
+2. Gracefully stop the node.
+3. Replace the old binary with the new binary.
+4. For TestNet nodes only: reinitialize DB using new binary and
+   new genesis configuration file with the following command:
+   ```
+   ## If you are running a full node, don't remove DB.
+   ./geth init --state.scheme hash --datadir ./node-datadir ./config/genesis.json
+
+   ## If you are running a snap node, you can reserve the DB by reiniting with 
+   ## "--state.scheme hash". Or, remove existing DB and init a new one with 
+   ## "--state.scheme path" as default.
+   ./geth removedb --datadir ./node-datadir
+   ./geth init --datadir ./node-datadir ./config/genesis.json
+   ```
+5. Start the node with `--state.scheme` set to `hash` or `path` (default)
+   correspondingly.
+
+Behaviour changes:
+ * `Cancun` fork is enabled at timestamp `1761600000` on TestNet (#522)
+ * `Prague` fork is enabled at timestamp `1761600000` on TestNet (#522)
+
+Improvements:
+ * base Geth source code is updated to v1.14.13 (#487)
+ * base Geth source code is updated to v1.15.11 (#499)
+ * reschedule `NeoXAMEV` and `NeoXEthSig` forks for PrivNet setups (#510)
+ * update hardware requirement documentation (#514)
+ * remove proxy checks from system contracts and upgrade hardhat (#519)
+
 ## 0.4.2 "Mutualization" (2 Sep 2025)
 
 A couple of ZK-based DKG rounds passed on TestNet, hence it may be safely
@@ -27,9 +67,9 @@ your node from v0.4.1 to v0.4.2:
 5. Start the node.
 
 Behaviour changes:
- * NeoXDKG, NeoXAMEV and NeoXEthSig forks of MainNet are rescheduled to 3623040,
+ * `NeoXDKG`, `NeoXAMEV` and `NeoXEthSig` forks of MainNet are rescheduled to 3623040,
    3689280 and 3689280 blocks correspondingly (#512)
- * reschedule NeoXDKG fork for PrivNet setups (#502)
+ * reschedule `NeoXDKG` fork for PrivNet setups (#502)
 
 Improvements:
  * check DKG-related files are available on node startup (#503)

README.md

@@ -98,7 +98,7 @@ To run a full node on the Neo X Testnet network follow the steps below.
 3. Download 3 pairs of R1CS files and proving key files from [Neo X MPC ceremony](https://github.com/bane-labs/mpc) for participanting ZK-DKG.
 4. Initialize node database with the downloaded Neo X testnet genesis configuration:
    ```shell
-   ./geth init --datadir ./nodes/node1 ./genesis_testnet.json
+   ./geth init --state.scheme hash --datadir ./nodes/node1 ./genesis_testnet.json
    ```
 5. Create an account for the node operation or use an existing one. The following
    command may be used to create a new account (you'll be prompted for a password):
@@ -140,8 +140,8 @@ To run a full node on the Neo X Testnet network follow the steps below.
       --nat extip:10.148.0.2 \
       --port $port \
       --authrpc.port $rpcport \
-      --identity=$node \
-      --maxpeers=50 \
+      --identity $node \
+      --maxpeers 50 \
       --syncmode full \
       --gcmode archive \
       --datadir $node \
@@ -195,19 +195,19 @@ To run a full node on the Neo X Testnet network follow the steps below.
       --networkid 12227332 \
       --nat extip:10.148.0.2 \
       --port $port \
-      --mine --miner.etherbase=$miner \
+      --mine --miner.etherbase $miner \
       --unlock $miner \
       --password $node/password.txt \
       --antimev.password $node/password.txt \
-      --dkg.one-msg-r1cs=$node/r1cs/one_message.ccs \
-      --dkg.two-msg-r1cs=$node/r1cs/two_message.ccs \
-      --dkg.seven-msg-r1cs=$node/r1cs/seven_message.ccs \
-      --dkg.one-msg-pk=$node/pk/one_message.pk \
-      --dkg.two-msg-pk=$node/pk/two_message.pk \
-      --dkg.seven-msg-pk=$node/pk/seven_message.pk \
+      --dkg.one-msg-r1cs $node/r1cs/one_message.ccs \
+      --dkg.two-msg-r1cs $node/r1cs/two_message.ccs \
+      --dkg.seven-msg-r1cs $node/r1cs/seven_message.ccs \
+      --dkg.one-msg-pk $node/pk/one_message.pk \
+      --dkg.two-msg-pk $node/pk/two_message.pk \
+      --dkg.seven-msg-pk $node/pk/seven_message.pk \
       --authrpc.port $rpcport \
-      --identity=$node \
-      --maxpeers=50 \
+      --identity $node \
+      --maxpeers 50 \
       --syncmode full \
       --gcmode archive \
       --datadir $node \

config/genesis_testnet.json

@@ -18,6 +18,20 @@
     "neoXDKGBlock": 1990080,
     "neoXAMEVBlock": 2088000,
     "neoXEthSigBlock": 3750000,
+    "cancunTime": 1761600000,
+    "pragueTime": 1761600000,
+    "blobSchedule": {
+      "cancun": {
+        "target": 3,
+        "max": 6,
+        "baseFeeUpdateFraction": 3338477
+      },
+      "prague": {
+        "target": 6,
+        "max": 9,
+        "baseFeeUpdateFraction": 5007716
+      }
+    },
     "dbft": {
       "period": 5,
       "standbyValidators": [

version/version.go

@@ -17,8 +17,8 @@
 package version
 
 const (
-	Major = 0          // Major version component of the current release
-	Minor = 5          // Minor version component of the current release
-	Patch = 0          // Patch version component of the current release
-	Meta  = "unstable" // Version metadata to append to the version string
+	Major = 0        // Major version component of the current release
+	Minor = 5        // Minor version component of the current release
+	Patch = 0        // Patch version component of the current release
+	Meta  = "stable" // Version metadata to append to the version string
 )