Add Disclaimer on clique being deprecated from v1.14 (#29878)

add a disclaimer on each clique mention saying it has been deprecated since version v1.14
pull/29920/head
stolab 4 months ago committed by GitHub
parent c6075018f1
commit 214f24be6b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 9
      docs/fundamentals/private-network.md
  2. 3
      docs/interacting-with-geth/rpc/ns-clique.md
  3. 3
      docs/tools/clef/clique-signing.md

@ -31,6 +31,10 @@ Geth's PoW algorithm, [Ethash](https://ethereum.org/en/developers/docs/consensus
#### Clique {#clique}
> ⚠
> **Since geth v1.14 clique has been deprecated**
Clique consensus is a PoA system where new blocks can be created by authorized 'signers' only. The clique consensus protocol is specified in [EIP-225](https://eips.ethereum.org/EIPS/eip-225). The initial set of authorized signers is configured in the genesis block. Signers can be authorized and de-authorized using a voting mechanism, thus allowing the set of signers to change while the blockchain operates. Clique can be configured to target any block time (within reasonable limits) since it isn't tied to the difficulty adjustment.
### Creating The Genesis Block {#creating-genesis-block}
@ -45,6 +49,9 @@ Every blockchain starts with a genesis block. When Geth is run with default sett
#### Clique Example {#clique-example}
> ⚠
> **Since geth v1.14 clique has been deprecated**
Below is an example of a `genesis.json` file for a PoA network. The `config` section ensures that all known protocol changes are available and configures the 'clique' engine to be used for consensus. Note that the initial signer set must be configured through the `extradata` field. This field is required for Clique to work.
The signer account keys can be generated using the [geth account](/docs/fundamentals/account-management) command (this command can be run multiple times to create more than one signer key).
@ -203,6 +210,8 @@ geth attach data2/geth.ipc --exec admin.peers
### Running A Signer (Clique) {#running-a-signer}
> :> [!WARNING] **Since geth v1.14 clique is not an option anymore**
To set up Geth for signing blocks in Clique, a signer account must be available. The account must already be available as a keyfile in the keystore. To use it for signing blocks, it must be unlocked. The following command, for address `0x7df9a875a174b3bc565e6424a0050ebc1b2d1d82` will prompt for the account password, then start signing blocks:
```sh

@ -3,6 +3,9 @@ title: clique Namespace
description: Documentation for the JSON-RPC API "clique" namespace
---
> ⚠
> **Since geth v1.14 clique has been deprecated**
The `clique` API provides access to the state of the clique consensus engine. This API can be used to manage signer votes and to check the health of a private network.
## clique_getSnapshot {#clique-getsnapshot}

@ -3,6 +3,9 @@ title: Clique signing
description: Instructions for setting up Clef to seal blocks on a Clique network
---
> ⚠
> **Since geth v1.14 clique has been deprecated**
Clique is a proof-of-authority system where new blocks can be created by authorized ‘signers’ only. The initial set of authorized signers is configured in the genesis block. Signers can be authorized and de-authorized using a voting mechanism, thus allowing the set of signers to change while the blockchain operates. Signing blocks in Clique networks classically uses the "unlock" feature of Geth so that each node is always ready to sign without requiring a user to manually provide authorization.
However, using the `--unlock` flag is generally a highly dangerous thing to do because it is indiscriminate, i.e. if an account is unlocked and an attacker obtains access to the RPC api, the attacker can sign anything without supplying a password.

Loading…
Cancel
Save