diff --git a/docs/concepts/weak-subjectivity.md b/docs/concepts/weak-subjectivity.md index f0f96ed79..14df59156 100644 --- a/docs/concepts/weak-subjectivity.md +++ b/docs/concepts/weak-subjectivity.md @@ -35,8 +35,8 @@ Teku provides three methods to safely sync a node that is new to the network or 3. Use [`--ws-checkpoint`](../reference/cli/index.md#ws-checkpoint) to supply a weak subjectivity checkpoint by which a node can securely validate its view of the current state. -We recommend using `--checkpoint-sync-url` or `--initial-state`. -They provide the same security benefits as `--ws-checkpoint`, but sync faster. +We recommend using `--checkpoint-sync-url` on Mainnet. +It provides the same security benefits as `--ws-checkpoint`, but syncs faster. The only exception is when syncing an archive node, in which case, use `--ws-checkpoint`. :::tip @@ -52,7 +52,7 @@ up-to-date, the concerns associated with weak subjectivity are cleared. Originally, Teku's default behavior was to sync from any point in the chain without the weak subjectivity check, including syncing all the way from the genesis of the chain. -However, this is not considered safe. +However, this is considered unsafe. If you want to allow Teku to sync outside the weak subjectivity period, you can use the [`--ignore-weak-subjectivity-period-enabled`](../reference/cli/index.md#ignore-weak-subjectivity-period-enabled) diff --git a/docs/get-started/checkpoint-start.md b/docs/get-started/checkpoint-start.md index bacf607c3..ed05971c3 100644 --- a/docs/get-started/checkpoint-start.md +++ b/docs/get-started/checkpoint-start.md @@ -6,8 +6,8 @@ sidebar_position: 4 # Start Teku from a recent state -To get Teku up and running in only a few minutes, you can start Teku from a recent finalized -checkpoint state rather than syncing from genesis. +To get Teku up and running in only a few minutes, start Teku from a recent finalized checkpoint +state rather than syncing from genesis. Using a checkpoint state enables Teku to sync within the [weak subjectivity](../concepts/weak-subjectivity.md) period. diff --git a/docs/reference/cli/index.md b/docs/reference/cli/index.md index 3c1fa6c85..abd76862b 100644 --- a/docs/reference/cli/index.md +++ b/docs/reference/cli/index.md @@ -882,9 +882,10 @@ ignore-weak-subjectivity-period-enabled: true Ignores the [weak subjectivity](../../concepts/weak-subjectivity.md) period verification that Teku performs at startup. +The default is `false`. :::caution -Syncing outside the weak subjectivity period is not considered safe. +Syncing from outside the weak subjectivity period is considered unsafe. ::: ### logging