Merge pull request #237 from bobanetwork/add-fjord-hardfork-docs

Add Fjord hardfork docs
bobanetwork · Aug 19, 2024 · 2eac454 · 2eac454
2 parents d89f932 + 9c5c5ef
commit 2eac454
Show file tree

Hide file tree

Showing 3 changed files with 43 additions and 21 deletions.
diff --git a/.gitbook/SUMMARY.md b/.gitbook/SUMMARY.md
@@ -2,6 +2,7 @@
 
 * [Welcome to Boba](README.md)
 * [Notices](contents/notices/README.md)
+  * [Prepare for Fjord Breaking Changes](contents/notices/fjord-breaking-changes.md)
   * [Prepare for Fraud Proofs on Boba Sepolia and Boba BNB Testnet](contents/notices/fraud-proofs.md)
 * [FAQ](FAQ.md)
 * [User Docs](contents/user/README.md)

diff --git a/.gitbook/contents/developer/node-operators/software-release.md b/.gitbook/contents/developer/node-operators/software-release.md
@@ -10,29 +10,29 @@ These are the minimal required versions for the `op-node`, `op-erigon` and `op-g
 
 | Network          | op-node                                                      | op-erigon                                                    | op-geth                                                      |
 | ---------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| Boba Mainnet | [v1.6.3](https://github.com/bobanetwork/boba/releases/tag/v1.6.3) | [v1.1.5](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.5) | [v1.101308.1](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101308.1) |
+| Boba Mainnet | [v1.6.8](https://github.com/bobanetwork/boba/releases/tag/v1.6.8) | [v1.2.0](https://github.com/bobanetwork/op-erigon/releases/tag/v1.2.0) | [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2) |
 | Boba Sepolia | [v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7) | [v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10) | [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2) |
 | Op Mainnet   | [v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7) | [v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10) | [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2) |
 | Op Sepolia   | [v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7) | [v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10) | [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2) |
 | Boba Bnb Testnet | [v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7) | [v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10) | [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2) |
 
-## [op-node v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7)
+## [op-node v1.6.8](https://github.com/bobanetwork/boba/releases/tag/v1.6.8)
 
 **Description**
 
-This is a mandatory release for node operators on Boba Sepolia and Boba BNB Testnet networks. The **Fjord** protocol upgrades will activate on Tue Jul 30 2024 00:00:00 UTC 2024 on Boba Sepolia and Boba BNB Testnet networks.
+This is a mandatory release for node operators on Boba Mainnet networks. The **Fjord** protocol upgrades will activate on Tue Sep 10 07:00:00 UTC 2024 on Boba Mainnet networks.
 
 The `op-node`  needs the flag `--plasma.enabled=false` to start it.
 
 **Required Action**
 
 Upgrade your `op-node` software and add  the `--plasma.enabled=false` to the configuration.
 
-## [op-erigon v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10)
+## [op-erigon v1.2.0](https://github.com/bobanetwork/op-erigon/releases/tag/v1.2.0)
 
 **Description**
 
-This is a mandatory release for node operators on Boba Sepolia and Boba BNB Testnet networks. The **Fjord** protocol upgrades will activate on Tue Jul 30 2024 00:00:00 UTC 2024 on Boba Sepolia and Boba BNB Testnet networks.
+This is a mandatory release for node operators on Boba Sepolia and Boba BNB Testnet networks. The **Fjord** protocol upgrades will activate onTue Sep 10 07:00:00 UTC 2024 on Boba Sepolia and Boba BNB Testnet networks.
 
 **Required Action**
 
@@ -47,34 +47,27 @@ This is a mandatory release for node operators on Op networks and Boba Sepolia a
 **Required Action**
 
 * Upgrade your `op-geth` software.
-* Add `--override.fjord=1722297600` for the Boba Sepolia and Boba BNB Testnet networks when you start it for the first time.
+* Add `--override.fjord=1725951600` for the `Boba Mainnet` networks when you start it for the first time.
+* Add `--override.fjord=1722297600` for the `Boba Sepolia` and `Boba BNB Testnet` networks when you start it for the first time.
 
-## [op-node v1.6.3](https://github.com/bobanetwork/boba/releases/tag/v1.6.3)
+## [op-node v1.6.7](https://github.com/bobanetwork/boba/releases/tag/v1.6.7)
 
 **Description**
 
-This is a mandatory release for node operators on Boba Mainnet network. The Anchorage upgrades will activate on Apr 16 2024 21:27:59 UTC 2024 on Boba Mainnet network.
-
-**Required Action**
-
-Upgrade your `op-node` software.
-
-## [op-erigon v1.1.5](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.5)
-
-**Description**
+This is a mandatory release for node operators on Boba Sepolia and Boba BNB Testnet networks. The **Fjord** protocol upgrades will activate on Tue Jul 30 2024 00:00:00 UTC 2024 on Boba Sepolia and Boba BNB Testnet networks.
 
-This is a mandatory release for node operators on Boba Mainnet network. The Anchorage upgrades will activate on Apr 16 2024 21:27:59 UTC 2024 on Boba Mainnet network.
+The `op-node`  needs the flag `--plasma.enabled=false` to start it.
 
 **Required Action**
 
-Upgrade your `op-erigon` software.
+Upgrade your `op-node` software and add  the `--plasma.enabled=false` to the configuration.
 
-## [op-geth v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2)
+## [op-erigon v1.1.10](https://github.com/bobanetwork/op-erigon/releases/tag/v1.1.10)
 
 **Description**
 
-This is a mandatory release for node operators on Op networks.
+This is a mandatory release for node operators on Boba Sepolia and Boba BNB Testnet networks. The **Fjord** protocol upgrades will activate on Tue Jul 30 2024 00:00:00 UTC 2024 on Boba Sepolia and Boba BNB Testnet networks.
 
 **Required Action**
 
-* Upgrade your `op-geth` software.
+Upgrade your `op-erigon` software.
diff --git a/.gitbook/contents/notices/fjord-breaking-changes.md b/.gitbook/contents/notices/fjord-breaking-changes.md
@@ -0,0 +1,28 @@
+# Prepare for Fjord Breaking Changes
+
+The Fjord upgrade for Boba Sepolia was activated on **1722297600 Tue July 30 00:00:00 UTC 2024**. The Fjord Boba Mainnet upgrade will be optimistically activated **1725951600 Tue Sep 10 7:00:00 UTC 2024**.
+
+## For Node Operators
+
+Node operators are required to upgrade to Fjord before the activation date to avoid chain divergence. For Boba Mainnet, the `op-node` release [v1.6.8](https://github.com/bobanetwork/boba/releases/tag/v1.6.8) and the `op-erigon` release [v1.2.0](https://github.com/bobanetwork/op-erigon/releases/tag/v1.2.0) contain these changes.
+
+### Update to the Lastest Release
+
+* op-node [v1.6.8](https://github.com/bobanetwork/boba/releases/tag/v1.6.8)
+* op-erigon [v1.2.0](https://github.com/bobanetwork/op-erigon/releases/tag/v1.2.0)
+* op-geth [v1.101315.2](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101315.2)
+
+### Configure the Fjord Activation Date
+
+For `op-node` and `op-erigon`, the Fjord activation date is included in the release, so no action is needed by the operators to configure the node.
+
+For `op-geth`, the node operator is required to add `--override.fjord=1725951600` to set up the Fjord hardfork.
+
+### Verify Your Configuration
+
+Make the following checks to verify that your node is properly configured.
+
+- `op-node` , `op-erigon` and `op-geth` will log their configurations at startup
+- Check that the Fjord time is set to `activation-timestamp` in the `op-node` startup logs
+- Check that the Fjord time is set to `activation-timestamp` in the `op-erigon` startup logs
+- Check that the Fjord time is set to `activation-timestamp` in the `op-geth` startup logs