You are reading the Teku development version documentation and some features may not be available in the stable release. You can switch to the stable version using the version box at the bottom of the screen.

Updated on February 16, 2022

# Weak subjectivity

The weak subjectivity period refers to how far behind the chain head a node can be before ⅓ of validators may have exited since the node was last in sync.

For example, if ⅓ of validators withdraw their stake and continue signing blocks and attestations, they can form a chain which conflicts with the finalised state. If your node is far enough behind the chain head not to be aware that they’ve withdrawn their funds, these validators can act dishonestly and continue feeding you blocks to lead you down the wrong chain.

Note

If a node is aware that a validator has withdrawn its funds, the node will reject the validator’s attestations.

Teku provides two methods to safely sync a node that is new to the network or has been offline for an extended period.

1. Use --initial-state to supply an SSZ encoded state file from which to sync.
2. Use --ws-checkpoint to supply a weak subjectivity checkpoint by which a node can securely validate its view of the current state.

We recommend using --inital-state. 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

Use the /eth/v2/debug/beacon/states/<state_id> API on an updated node to download a recent finalized state as an SSZ encoded state file.

Questions or feedback? You can discuss issues and obtain free support on Teku Discord channel.