Organize Helpers and Handlers sections (#4819)

Author: jihoonsong

specs/_features/eip6800/p2p-interface.md

@@ -6,7 +6,7 @@
 
 - [Introduction](#introduction)
 - [Modification in EIP-6800](#modification-in-eip-6800)
-  - [Helper functions](#helper-functions)
+  - [Helpers](#helpers)
     - [Modified `compute_fork_version`](#modified-compute_fork_version)
 
 <!-- mdformat-toc end -->
@@ -21,7 +21,7 @@ specifications of previous upgrades, and assumes them as pre-requisite.
 
 ## Modification in EIP-6800
 
-### Helper functions
+### Helpers
 
 #### Modified `compute_fork_version`
 

specs/_features/eip6914/beacon-chain.md

@@ -7,7 +7,7 @@
 - [Introduction](#introduction)
 - [Preset](#preset)
   - [Time parameters](#time-parameters)
-- [Helper functions](#helper-functions)
+- [Helpers](#helpers)
   - [Predicates](#predicates)
     - [`is_reusable_validator`](#is_reusable_validator)
 - [Beacon chain state transition function](#beacon-chain-state-transition-function)
@@ -33,7 +33,7 @@ validator records. Refers to
 | ---------------------------- | -------------------------- | ------ | --------- |
 | `SAFE_EPOCHS_TO_REUSE_INDEX` | `uint64(2**16)` (= 65,536) | epochs | ~0.8 year |
 
-## Helper functions
+## Helpers
 
 ### Predicates
 

specs/_features/eip7805/beacon-chain.md

@@ -11,7 +11,7 @@
   - [New containers](#new-containers)
     - [`InclusionList`](#inclusionlist)
     - [`SignedInclusionList`](#signedinclusionlist)
-- [Helper functions](#helper-functions)
+- [Helpers](#helpers)
   - [Predicates](#predicates)
     - [New `is_valid_inclusion_list_signature`](#new-is_valid_inclusion_list_signature)
   - [Beacon State accessors](#beacon-state-accessors)
@@ -68,7 +68,7 @@ class SignedInclusionList(Container):
     signature: BLSSignature
 ```
 
-## Helper functions
+## Helpers
 
 ### Predicates
 

specs/_features/eip7805/fork-choice.md

@@ -16,14 +16,12 @@
   - [New `validate_inclusion_lists`](#new-validate_inclusion_lists)
   - [New `get_attester_head`](#new-get_attester_head)
   - [Modified `get_proposer_head`](#modified-get_proposer_head)
-- [Updated fork-choice helpers](#updated-fork-choice-helpers)
   - [Modified `update_proposer_boost_root`](#modified-update_proposer_boost_root)
-- [New fork-choice helpers](#new-fork-choice-helpers)
+  - [New `record_block_inclusion_list_satisfaction`](#new-record_block_inclusion_list_satisfaction)
   - [New `get_view_freeze_cutoff_ms`](#new-get_view_freeze_cutoff_ms)
   - [New `get_inclusion_list_submission_due_ms`](#new-get_inclusion_list_submission_due_ms)
   - [New `get_proposer_inclusion_list_cutoff_ms`](#new-get_proposer_inclusion_list_cutoff_ms)
-  - [New `record_block_inclusion_list_satisfaction`](#new-record_block_inclusion_list_satisfaction)
-- [Updated fork-choice handlers](#updated-fork-choice-handlers)
+- [Handlers](#handlers)
   - [New `on_inclusion_list`](#new-on_inclusion_list)
   - [Modified `on_block`](#modified-on_block)
 
@@ -264,8 +262,6 @@ def get_proposer_head(store: Store, head_root: Root, slot: Slot) -> Root:
         return head_root
 ```
 
-## Updated fork-choice helpers
-
 ### Modified `update_proposer_boost_root`
 
 ```python
@@ -289,7 +285,16 @@ def update_proposer_boost_root(store: Store, root: Root) -> None:
             store.proposer_boost_root = root
 ```
 
-## New fork-choice helpers
+### New `record_block_inclusion_list_satisfaction`
+
+```python
+def record_block_inclusion_list_satisfaction(store: Store, root: Root) -> None:
+    # Check if block satisfies the inclusion list constraints
+    # If not, add this block to the store as inclusion list constraints unsatisfied
+    is_inclusion_list_satisfied = validate_inclusion_lists(store, root, EXECUTION_ENGINE)
+    if not is_inclusion_list_satisfied:
+        store.unsatisfied_inclusion_list_blocks.add(root)
+```
 
 ### New `get_view_freeze_cutoff_ms`
 
@@ -312,18 +317,7 @@ def get_proposer_inclusion_list_cutoff_ms(epoch: Epoch) -> uint64:
     return get_slot_component_duration_ms(PROPOSER_INCLUSION_LIST_CUTOFF_BPS)
 ```
 
-### New `record_block_inclusion_list_satisfaction`
-
-```python
-def record_block_inclusion_list_satisfaction(store: Store, root: Root) -> None:
-    # Check if block satisfies the inclusion list constraints
-    # If not, add this block to the store as inclusion list constraints unsatisfied
-    is_inclusion_list_satisfied = validate_inclusion_lists(store, root, EXECUTION_ENGINE)
-    if not is_inclusion_list_satisfied:
-        store.unsatisfied_inclusion_list_blocks.add(root)
-```
-
-## Updated fork-choice handlers
+## Handlers
 
 ### New `on_inclusion_list`
 

specs/_features/eip7805/p2p-interface.md

@@ -6,9 +6,9 @@ EIP-7805.
 <!-- mdformat-toc start --slug=github --no-anchors --maxlevel=6 --minlevel=2 -->
 
 - [Modifications in EIP-7805](#modifications-in-eip-7805)
-  - [Helper functions](#helper-functions)
-    - [Modified `compute_fork_version`](#modified-compute_fork_version)
   - [Configuration](#configuration)
+  - [Helpers](#helpers)
+    - [Modified `compute_fork_version`](#modified-compute_fork_version)
   - [The gossip domain: gossipsub](#the-gossip-domain-gossipsub)
     - [Topics and messages](#topics-and-messages)
       - [Global topics](#global-topics)
@@ -21,7 +21,14 @@ EIP-7805.
 
 ## Modifications in EIP-7805
 
-### Helper functions
+### Configuration
+
+| Name                           | Value            | Description                                                |
+| ------------------------------ | ---------------- | ---------------------------------------------------------- |
+| `MAX_REQUEST_INCLUSION_LIST`   | `2**4` (= 16)    | Maximum number of inclusion list in a single request       |
+| `MAX_BYTES_PER_INCLUSION_LIST` | `2**13` (= 8192) | Maximum size of the inclusion list's transactions in bytes |
+
+### Helpers
 
 #### Modified `compute_fork_version`
 
@@ -47,13 +54,6 @@ def compute_fork_version(epoch: Epoch) -> Version:
     return GENESIS_FORK_VERSION
 ```
 
-### Configuration
-
-| Name                           | Value            | Description                                                |
-| ------------------------------ | ---------------- | ---------------------------------------------------------- |
-| `MAX_REQUEST_INCLUSION_LIST`   | `2**4` (= 16)    | Maximum number of inclusion list in a single request       |
-| `MAX_BYTES_PER_INCLUSION_LIST` | `2**13` (= 8192) | Maximum size of the inclusion list's transactions in bytes |
-
 ### The gossip domain: gossipsub
 
 #### Topics and messages

specs/_features/eip7928/p2p-interface.md

@@ -6,14 +6,14 @@ EIP-7928.
 <!-- mdformat-toc start --slug=github --no-anchors --maxlevel=6 --minlevel=2 -->
 
 - [Modifications in EIP-7928](#modifications-in-eip-7928)
-  - [Helper functions](#helper-functions)
+  - [Helpers](#helpers)
     - [Modified `compute_fork_version`](#modified-compute_fork_version)
 
 <!-- mdformat-toc end -->
 
 ## Modifications in EIP-7928
 
-### Helper functions
+### Helpers
 
 #### Modified `compute_fork_version`
 

specs/_features/eip8025/beacon-chain.md

@@ -17,7 +17,7 @@
     - [`ExecutionProof`](#executionproof)
     - [`SignedExecutionProof`](#signedexecutionproof)
   - [Extended Containers](#extended-containers)
-- [Helper functions](#helper-functions)
+- [Helpers](#helpers)
   - [Execution proof functions](#execution-proof-functions)
     - [`verify_execution_proof`](#verify_execution_proof)
     - [`verify_execution_proofs`](#verify_execution_proofs)
@@ -86,7 +86,7 @@ class SignedExecutionProof(Container):
 *Note*: `BeaconState` and `BeaconBlockBody` remain the same. No modifications
 are required for execution proofs since they are handled externally.
 
-## Helper functions
+## Helpers
 
 ### Execution proof functions
 

specs/_features/eip8025/zkevm.md

@@ -12,7 +12,7 @@
   - [`ZKEVMProof`](#zkevmproof)
   - [`PrivateInput`](#privateinput)
   - [`PublicInput`](#publicinput)
-- [Helper functions](#helper-functions)
+- [Helpers](#helpers)
   - [Preprocessing](#preprocessing)
     - [`generate_keys`](#generate_keys)
   - [Proof verification](#proof-verification)
@@ -96,7 +96,7 @@ class PublicInput(Container):
     parent_hash: Hash32
 ```
 
-## Helper functions
+## Helpers
 
 ### Preprocessing
 

specs/altair/beacon-chain.md

@@ -21,7 +21,7 @@
   - [New containers](#new-containers)
     - [`SyncAggregate`](#syncaggregate)
     - [`SyncCommittee`](#synccommittee)
-- [Helper functions](#helper-functions)
+- [Helpers](#helpers)
   - [Crypto](#crypto)
   - [Misc](#misc-1)
     - [`add_flag`](#add_flag)
@@ -209,7 +209,7 @@ class SyncCommittee(Container):
     aggregate_pubkey: BLSPubkey
 ```
 
-## Helper functions
+## Helpers
 
 ### Crypto
 

specs/altair/fork-choice.md

@@ -3,7 +3,7 @@
 <!-- mdformat-toc start --slug=github --no-anchors --maxlevel=6 --minlevel=2 -->
 
 - [Introduction](#introduction)
-- [New fork-choice helpers](#new-fork-choice-helpers)
+- [Helpers](#helpers)
   - [New `get_sync_message_due_ms`](#new-get_sync_message_due_ms)
   - [New `get_contribution_due_ms`](#new-get_contribution_due_ms)
 
@@ -16,7 +16,7 @@ This is the modification of the fork choice according to the Altair upgrade.
 Unless stated explicitly, all prior functionality from
 [Phase0](../phase0/fork-choice.md) is inherited.
 
-## New fork-choice helpers
+## Helpers
 
 ### New `get_sync_message_due_ms`