Skip to content

Commit 49ef89f

Browse files
tcoratgerclaude
andauthored
docs: replace code identifiers with plain English in validator duties (leanEthereum#1088)
The attestation-target docstring and inline comment named the config constant in prose, and the block-production docstring named a struct field. Names rot; describe the concept instead. Replace these with "the justification lookback bound" and "the block-level proof carried by the signed block envelope". Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent b3f2691 commit 49ef89f

1 file changed

Lines changed: 3 additions & 3 deletions

File tree

src/lean_spec/spec/forks/lstar/validator_duties.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ def get_attestation_target(self, store: LstarStore) -> Checkpoint:
3030
The algorithm balances advancing the chain head against safety.
3131
3232
The walk starts at the head and goes backward.
33-
It takes up to JUSTIFICATION_LOOKBACK_SLOTS steps.
33+
It takes up to the justification lookback bound steps.
3434
It stops once both the lower-bound slot and the justifiability rules are satisfied.
3535
3636
The walk never crosses the finalized boundary.
@@ -39,7 +39,7 @@ def get_attestation_target(self, store: LstarStore) -> Checkpoint:
3939
# Start from current head
4040
target_block_root = store.head
4141

42-
# Walk back toward the safe target, up to JUSTIFICATION_LOOKBACK_SLOTS steps.
42+
# Walk back toward the safe target, up to the justification lookback bound steps.
4343
#
4444
# If the safe target is stale behind the finalized checkpoint, the finalized slot
4545
# becomes the lower bound.
@@ -123,7 +123,7 @@ def produce_block_with_signatures(
123123
Returns the per-attestation single-message aggregate proofs unmerged. The validator
124124
service signs the block root with the proposal key, wraps that into
125125
a singleton single-message aggregate, and merges all of them into the block-level
126-
multi-message aggregate proof carried by SignedBlock.proof.
126+
proof carried by the signed block envelope.
127127
128128
Raises:
129129
AssertionError: If validator is not the proposer for this slot,

0 commit comments

Comments
 (0)