Clarify flickering upkeeps (#1889)

smartcontractkit · Apr 17, 2024 · 3d0fee4 · 3d0fee4
1 parent 454b4ce
commit 3d0fee4
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/src/content/chainlink-automation/concepts/best-practice.mdx b/src/content/chainlink-automation/concepts/best-practice.mdx
@@ -26,7 +26,9 @@ If your upkeep uses [StreamsLookup](/chainlink-automation/reference/automation-i
 
 ### Avoid "flickering" custom logic upkeeps
 
-The Automation DON will evaluate your upkeep regularly and will try to perform it when eligible. However, if the state on chain changes and makes your upkeep ineligible before execution happens, the upkeep might not get performed. For best results, ensure the `checkUpkeep` remains true until execution.
+The Automation DON evaluates your upkeep regularly. When your upkeep is eligible, the DON attempts to perform the upkeep. For best results, ensure that `checkUpkeep` remains true until execution.
+
+If the state of your upkeep "flickers" by rapidly alternating between true and false, then your upkeep is at risk of not being performed. "Flickering" upkeeps might cause unintended consequences because there is latency between observing the state of the chain, getting consensus (v2 and later) on what needs to happen, and confirming the transaction onchain.
 
 ### Always test your contracts