Skip to content

adds deprecation notices for clique #1889

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
m4sterbunny merged 7 commits into from
Dec 5, 2025
Merged

adds deprecation notices for clique #1889

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
719e518
adds deprecation notices for clique
m4sterbunny Dec 3, 2025
859745f
Merge branch 'main' into 1884-clique-mining
m4sterbunny Dec 3, 2025
89e1e19
amend to when pow consensus deprecated
m4sterbunny Dec 3, 2025
5589ac5
Update docs/private-networks/how-to/configure/consensus/clique.md
m4sterbunny Dec 4, 2025
1ab5ed0
Update docs/private-networks/concepts/poa.md
m4sterbunny Dec 4, 2025
1a14212
Update docs/private-networks/tutorials/clique.md
m4sterbunny Dec 4, 2025
b0d8920
responds to review
m4sterbunny Dec 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/private-networks/concepts/poa.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t 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.
Expand Down
6 changes: 6 additions & 0 deletions docs/private-networks/how-to/configure/consensus/clique.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t 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).

## Genesis file
Expand Down
8 changes: 7 additions & 1 deletion docs/private-networks/tutorials/clique.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 from Besu 25.12.0 onward. You can still sync existing Clique networks, but you can’t 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.
Expand Down
Loading