From 719e518383254157322f39ac58ccead187d2370d Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Wed, 3 Dec 2025 10:32:56 +0000 Subject: [PATCH 1/6] adds deprecation notices for clique Signed-off-by: m4sterbunny --- docs/private-networks/concepts/poa.md | 6 ++++++ .../private-networks/how-to/configure/consensus/clique.md | 6 ++++++ docs/private-networks/tutorials/clique.md | 8 +++++++- 3 files changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/private-networks/concepts/poa.md b/docs/private-networks/concepts/poa.md index 40d07a75c53..b04dd1a82b8 100644 --- a/docs/private-networks/concepts/poa.md +++ b/docs/private-networks/concepts/poa.md @@ -41,6 +41,12 @@ To be Byzantine fault tolerant, QBFT and IBFT 2.0 require a minimum of four vali Clique can operate with a single validator but operating with a single validator offers no redundancy if the validator fails. +:::important Deprecation notice + +Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. + +::: + :::tip Byzantine fault tolerant is the ability to function correctly and reach consensus despite nodes failing or propagating incorrect information to peers. diff --git a/docs/private-networks/how-to/configure/consensus/clique.md b/docs/private-networks/how-to/configure/consensus/clique.md index d6d2cd4d56e..9782999de9e 100644 --- a/docs/private-networks/how-to/configure/consensus/clique.md +++ b/docs/private-networks/how-to/configure/consensus/clique.md @@ -21,6 +21,12 @@ Clique is not suitable for production environments. Use only in development envi ::: +:::important Deprecation notice + +Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. + +::: + In Clique networks, approved accounts, known as signers, validate transactions and blocks. Signers take turns to create the next block. Existing signers propose and vote to [add or remove signers](#add-and-remove-signers). You can [create a private network using Clique](../../../tutorials/clique.md). diff --git a/docs/private-networks/tutorials/clique.md b/docs/private-networks/tutorials/clique.md index 5a7efa38db3..5dbecba3273 100644 --- a/docs/private-networks/tutorials/clique.md +++ b/docs/private-networks/tutorials/clique.md @@ -9,10 +9,16 @@ tags: import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -# Create a private network using Clique +# Create a private network using Clique (Deprecated) A private network provides a configurable network for testing. This private network uses the [Clique (proof of authority) consensus protocol]. +:::important Deprecation notice + +Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. + +::: + :::danger The steps in this tutorial create an isolated, but not protected or secure, Ethereum private network. We recommend running the private network behind a properly configured firewall. From 89e1e19538e0993cd4a3245d2534d093919bad59 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Wed, 3 Dec 2025 17:37:08 +0000 Subject: [PATCH 2/6] amend to when pow consensus deprecated Signed-off-by: m4sterbunny --- docs/private-networks/concepts/poa.md | 2 +- docs/private-networks/how-to/configure/consensus/clique.md | 2 +- docs/private-networks/tutorials/clique.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/private-networks/concepts/poa.md b/docs/private-networks/concepts/poa.md index b04dd1a82b8..5b25a4f5c1a 100644 --- a/docs/private-networks/concepts/poa.md +++ b/docs/private-networks/concepts/poa.md @@ -43,7 +43,7 @@ Clique can operate with a single validator but operating with a single validator :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: diff --git a/docs/private-networks/how-to/configure/consensus/clique.md b/docs/private-networks/how-to/configure/consensus/clique.md index 9f981785a88..a597bd87078 100644 --- a/docs/private-networks/how-to/configure/consensus/clique.md +++ b/docs/private-networks/how-to/configure/consensus/clique.md @@ -23,7 +23,7 @@ Clique is not suitable for production environments. Use only in development envi :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: diff --git a/docs/private-networks/tutorials/clique.md b/docs/private-networks/tutorials/clique.md index 5dbecba3273..bcebbcd26d4 100644 --- a/docs/private-networks/tutorials/clique.md +++ b/docs/private-networks/tutorials/clique.md @@ -15,7 +15,7 @@ A private network provides a configurable network for testing. This private netw :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v24.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#24120) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: From 5589ac5b9fbcd00fb9d9a78022888e530e845547 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Thu, 4 Dec 2025 08:00:22 +0000 Subject: [PATCH 3/6] Update docs/private-networks/how-to/configure/consensus/clique.md Co-authored-by: Sally MacFarlane Signed-off-by: m4sterbunny --- docs/private-networks/how-to/configure/consensus/clique.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/private-networks/how-to/configure/consensus/clique.md b/docs/private-networks/how-to/configure/consensus/clique.md index a597bd87078..e06bc9031a1 100644 --- a/docs/private-networks/how-to/configure/consensus/clique.md +++ b/docs/private-networks/how-to/configure/consensus/clique.md @@ -23,7 +23,7 @@ Clique is not suitable for production environments. Use only in development envi :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: From 1ab5ed032cfdae8301bd5f037166ad4fdcb65f8b Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Thu, 4 Dec 2025 08:00:31 +0000 Subject: [PATCH 4/6] Update docs/private-networks/concepts/poa.md Co-authored-by: Sally MacFarlane Signed-off-by: m4sterbunny --- docs/private-networks/concepts/poa.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/private-networks/concepts/poa.md b/docs/private-networks/concepts/poa.md index 5b25a4f5c1a..933c707fbd7 100644 --- a/docs/private-networks/concepts/poa.md +++ b/docs/private-networks/concepts/poa.md @@ -43,7 +43,7 @@ Clique can operate with a single validator but operating with a single validator :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: From 1a142122b2b970e63275c92952d5e5e80f39f527 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Thu, 4 Dec 2025 08:00:41 +0000 Subject: [PATCH 5/6] Update docs/private-networks/tutorials/clique.md Co-authored-by: Sally MacFarlane Signed-off-by: m4sterbunny --- docs/private-networks/tutorials/clique.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/private-networks/tutorials/clique.md b/docs/private-networks/tutorials/clique.md index bcebbcd26d4..60878d95606 100644 --- a/docs/private-networks/tutorials/clique.md +++ b/docs/private-networks/tutorials/clique.md @@ -15,7 +15,7 @@ A private network provides a configurable network for testing. This private netw :::important Deprecation notice -Clique block production (mining/validating) is deprecated in [Besu v25.12.0](https://github.com/hyperledger/besu/blob/main/CHANGELOG.md#2510) and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. ::: From b0d8920d04ffd062b4a3d078f50488cd7e29ac73 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Fri, 5 Dec 2025 07:54:52 +0000 Subject: [PATCH 6/6] responds to review Signed-off-by: m4sterbunny --- docs/private-networks/concepts/poa.md | 2 +- docs/private-networks/how-to/configure/consensus/clique.md | 2 +- docs/private-networks/tutorials/clique.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/private-networks/concepts/poa.md b/docs/private-networks/concepts/poa.md index 933c707fbd7..818d8e4c5ba 100644 --- a/docs/private-networks/concepts/poa.md +++ b/docs/private-networks/concepts/poa.md @@ -43,7 +43,7 @@ Clique can operate with a single validator but operating with a single validator :::important Deprecation notice -Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t validate or create new Clique networks. ::: diff --git a/docs/private-networks/how-to/configure/consensus/clique.md b/docs/private-networks/how-to/configure/consensus/clique.md index e06bc9031a1..21822b26c72 100644 --- a/docs/private-networks/how-to/configure/consensus/clique.md +++ b/docs/private-networks/how-to/configure/consensus/clique.md @@ -23,7 +23,7 @@ Clique is not suitable for production environments. Use only in development envi :::important Deprecation notice -Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t validate or create new Clique networks. ::: diff --git a/docs/private-networks/tutorials/clique.md b/docs/private-networks/tutorials/clique.md index 60878d95606..97fd3e44be8 100644 --- a/docs/private-networks/tutorials/clique.md +++ b/docs/private-networks/tutorials/clique.md @@ -15,7 +15,7 @@ A private network provides a configurable network for testing. This private netw :::important Deprecation notice -Clique block production (mining/validating) is deprecated in Besu 25.12.0 and later. You will still be able to sync existing Clique networks. You will not be able to validate or create new Clique networks. +Clique block production (mining/validating) is deprecated from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t validate or create new Clique networks. :::