Add validators-early-attestations-enabled command line argument (Cons…

…ensys#298) * Add validators-early-attestations-enabled command line argument * Minor edits. Signed-off-by: bgravenorst <[email protected]> Co-authored-by: bgravenorst <[email protected]>
seroze · Aug 11, 2021 · e13a04b · e13a04b
1 parent 5190a17
commit e13a04b
Showing 1 changed file with 37 additions and 0 deletions.
diff --git a/docs/Reference/CLI/CLI-Syntax.md b/docs/Reference/CLI/CLI-Syntax.md
@@ -1462,6 +1462,43 @@ When specifying file names, Teku expects that the files exist.
 
     The path separator is operating system dependent, and should be `;` in Windows rather than `:`.
 
+### validators-early-attestations-enabled
+
+=== "Syntax"
+
+    ```bash
+    --validators-early-attestations-enabled[=<BOOLEAN>]
+    ```
+
+=== "Command Line"
+
+    ```bash
+    --validators-early-attestations-enabled=false
+    ```
+
+=== "Environment Variable"
+
+    ```bash
+    TEKU_VALIDATORS_EARLY_ATTESTATIONS_ENABLED=false
+    ```
+
+=== "Configuration File"
+
+    ```bash
+    validators-early-attestations-enabled: false
+    ```
+
+Specify whether to use Teku's built-in early attestation production, which creates an
+attestation as soon as a block is received. Defaults to `true`.
+
+Set this option to `false` if running a validator client connected to a load balanced beacon node
+(including most hosted beacon nodes such as [Infura]), and validator effectiveness is poor.
+
+!!! note
+
+    Delaying attestation production increases the chances of generating a correct
+    attestation when using a load balanced beacon node, but it increases the risk of inclusion delays.
+
 ### validators-external-signer-keystore
 
 === "Syntax"