Retrospective LLM-Based Complexity Evaluations

EIP complexity assessment

EIP-8304: Trustless log and transaction index

Assessed in Hegotá. The score describes the EIP text available at the snapshot, not the EIP as it stands today.

ProspectiveHegotáSnapshot 2026-08-25PFI at snapshotLayers: execution
LLM Completescore 30
Human Available in open PRscore 26 · Checklist revision 2· ethspecs/pm #127

Evaluated on: · Spec revision: 2026-08-25 · ac450a4ab2 · Inclusion status at snapshot: PFI

Scope at the cutoff. Execution-layer assessment of the Draft EIP-8304 snapshot. The proposal derives SSZ/SHA2-256 index-table roots from every block's transactions, receipts, logs, and delayed parent block hash; periodically merges those tables across five levels; and writes the roots through a new stateful system contract. No consensus-layer behavior is scored.

30HighHigh
Evaluator
LLMChecklist v2
Confidence
Medium
Under-specified at assessment cutoff
Yes — 8 criteria affected
Plausible range
27–33 (High)
Snapshot
2026-08-25 · EIP revision ac450a4ab2 (2026-08-25)
Score bands · Checklist revision 2
  • Low <12
  • Medium 12–22
  • High ≥23

28 criteria scored 0–3 (4 in exceptional cases; cross-EIP interactions is uncapped); nominal maximum 84.

Complexity profile

Each segment is one criterion's contribution to the LLM total. Hover or focus a segment for its score and rationale.

Top complexity drivers

  1. New fork activation mechanism3
  2. Patterns affecting pre-existing tests3
  3. Performance risks3
  4. Edge/boundary conditions3

Under-specified at assessment cutoff: Yes

The EIP text available at the assessment cutoff left material behavior unresolved. The affected criteria and the plausible total range record that uncertainty.

Why: Material consensus parameters are absent. The SSZ List limit/fixed tree depth needed to derive roots is not stated; the index-contract address and most fields of its synthetic deployment are TBD; and the transition/testing interface and bounded asynchronous merge obligations are not specified. These are recorded once here rather than being multiplied across otherwise unrelated zero-score anchors.

Unresolved questions at the cutoff (5)
  • What fixed binary-tree depth or SSZ List limit applies to table roots, and what exact root is expected for an empty table?
  • What are INDEX_CONTRACT_ADDRESS, the synthetic transaction's v/r/s/hash and sender, and the exact fork-activation deployment procedure, including genesis activation?
  • What historical blocks or prior table artifacts must a one-block transition tool accept and return so delayed higher-level roots are reproducible?
  • What deterministic resource/deadline requirements govern asynchronous merges, reorg recovery, and the first post-sync block at every table-level boundary?
  • How does the gas-exempt root-update operation interact with any separate state-gas accounting applied to its storage creation and overwrites?
Notable ambiguities noted by the assessor (3)
  • `List[Hash32, entry_count]` uses the actual entry count where an SSZ list limit/root- defining constant is expected, while the prose separately says the tree has fixed depth.
  • Clients may directly write storage instead of executing the system call, but the equivalence requirements are stated only as a preference, not as explicit observable invariants.
  • The proposal says higher tables can be merged asynchronously while also making their roots mandatory at precise later blocks, without bounding intermediate work or retained artifacts.

Criterion breakdown

EIP-8304 Hegotá: LLM criterion scores and rationale
CriterionScoreWhy this scoreEvidence / uncertainty
New fork activation mechanismUnder-specified3Activation installs code and initializes an account nonce, an explicit irregular state modification at the fork boundary, and begins table scheduling from that boundary.
  • eip.md · Specification > Index contract > Deployment A synthetic deployment transaction is specified for the new system contract.
  • eip.md · Specification > EIP-161 handling The deployed account has code and nonce 1 and is exempt from empty-account cleanup.
  • eip.md · Specification > Block processing Tables are generated only when the EIP was active at the table's first block.
Confidence: High
Uncertainty: The exact address and signed deployment fields are TBD, so activation vectors cannot yet be finalized even though the required state modification is clear.
Patterns affecting pre-existing tests3Existing post-fork block tests across transactions, empty blocks, logs, state roots, block hashes, and periodic boundaries must incorporate the mandatory index transition. This is a major, diverse regression surface.
  • eip.md · Specification > Indexing rules Every transaction, every log address/topic, and a delayed parent block hash contribute entries to the index.
  • eip.md · Specification > Block processing Every active block generates a level-0 table and may generate delayed higher-level tables, with all resulting roots written to contract storage.
Confidence: High
Uncertainty: The package does not expose the existing test corpus, so the exact count of reworked vectors is unknown; the mandatory behavior itself spans diverse test categories.
Performance risksUnder-specified3Work scales with transaction and log content, interacts with receipt production, periodic multi-level merging, block deadlines, storage updates, and sync recovery. End-to-end and adversarial-content performance cannot be established by one isolated microbenchmark and can substantially affect validation behavior.
  • eip.md · Specification > Index tables Each block's transactions and every log address/topic produce variable-length entries that must be sorted, hashed, and Merkleized.
  • eip.md · Specification > Block processing Five levels are maintained, and higher-level table merges must finish by table-size-dependent delayed block-processing deadlines.
  • eip.md · Specification > Initializing after chain/state sync The worst first post-sync update requires data from 319 recent blocks.
Confidence: High
Uncertainty: The EIP asserts low single-block cost and asynchronous larger merges but gives no processing bounds, benchmark results, or maximum entry/tree size.
Edge/boundary conditionsUnder-specified3Genesis, activation, empty tables, level alignment, delayed availability, five table sizes, and 1,024-slot wraparound create multiple interacting boundary mechanisms. The schedule-by-level and overwrite combinations require an elevated case count.
  • eip.md · Specification > Indexing rules Block entries are delayed by one block, genesis has no block entry, and multi-block ranges use an offset block-hash interval.
  • eip.md · Specification > Block processing Five levels have alignment and activation conditions, while higher levels use table-size-dependent delays.
  • eip.md · Specification > Index contract > get Reads enforce calldata length, divisibility, initialization, validity, and ring-buffer overwrite conditions relative to the current block number.
Confidence: High
Uncertainty: The missing SSZ depth/list limit prevents the exact empty and maximum-table boundary vectors from being baselined.
Cross-EIP interactions3Coordinated vectors are required for EIPs 161, 1559, and 4788 around deployment and system-call semantics, and for EIPs 7708 and 8141 around newly generated logs and frame-receipt indexing. These span multiple strong interactions, but five identified EIPs do not trigger the rubric's first three-additional-EIP bonus.
  • eip.md · Front matter; Specification > Block processing; Specification > EIP-161 handling EIP-8304 requires 4788, reuses its system-operation convention, adopts 1559 burn exceptions, and applies 161 deployment-cleanup handling.
  • eip.md · Motivation > Synergy with ZKP batched pre-checks; Specification > Alternative index contracts The proposal identifies interactions with frame transactions and ETH-transfer logs.
  • supporting/eip-7708.md · Specification > ETH transfer logs EIP-7708 adds protocol-generated logs that become EIP-8304 index entries.
  • supporting/eip-8141.md · Specification > Receipt Encoding Frame receipts define transaction logs as concatenated per-frame logs for block bloom and log indexing, requiring coordinated entry extraction.
Confidence: High
Uncertainty: The precise fork combination is outside the package; the score uses only the explicit and supporting-document interactions sealed here.
Interacting EIPs: EIP-161, EIP-1559, EIP-4788, EIP-7708, EIP-8141
Unspecified behavior requiring cross-client consensusUnder-specified3Previously uncommitted transaction/log indexing becomes consensus-visible through contract storage and the block state root, yet root-defining SSZ parameters and activation deployment values are absent. Constructible blocks therefore lack a unique expected state until clients agree and the draft is amended.
  • eip.md · Specification > Parameters INDEX_CONTRACT_ADDRESS is TBD.
  • eip.md · Specification > Index tables > Table root hash calculation The text calls the tree fixed-depth but gives no depth or SSZ List limit, even though those parameters determine the root, including for empty tables.
  • eip.md · Specification > Index contract > Deployment The signature values, transaction hash, sender, and resulting contract address of the synthetic deployment are all TBD.
Confidence: High
Uncertainty: No package evidence establishes implementations, devnet baselines, or resolutions for these gaps; prohibited external history was not consulted.
Added system contractsUnder-specified2Exactly one new system contract is added, and it is stateful because mandatory block processing repeatedly writes its storage.
  • eip.md · Specification > Index contract A new index contract exposes get/set operations and stores root hashes in per-level ring-buffer slots.
  • eip.md · Specification > Block processing The protocol invokes the contract as SYSTEM_ADDRESS during block processing.
Confidence: High
Uncertainty: INDEX_CONTRACT_ADDRESS and the signed synthetic deployment transaction remain TBD, but the addition and statefulness are unambiguous.
Transition-tool interface changesUnder-specified2A single-block transition interface needs a new mechanism to supply or retain recent blocks and prior table material so it can derive periodic roots. That is more than one isolated scalar field, but the EIP does not prescribe the exact interface.
  • eip.md · Specification > Initializing after chain/state sync A client can require the latest 319 blocks to construct a highest-level root for the first validated block after sync.
  • eip.md · Specification > Block processing Higher-level outputs depend on delayed merging of earlier block ranges.
Confidence: Medium
Uncertainty: No transition-tool schema is included, so whether implementations use one history object, several fields, or externally prepared tables remains open.
New invariant on pre-existing tests2A broad category of post-fork tests gains a mechanically derived index-root and system-state expectation even when indexing is not the test's subject. The rule does not apply before activation, so the score stops below the every-vector anchor.
  • eip.md · Specification > Block processing Every active block commits generated table roots into index-contract storage.
  • eip.md · Specification > Index tables > Table root hash calculation Each expected root commits to the sorted encoded-entry list.
Confidence: High
Uncertainty: Test harnesses may assert this indirectly through the state root rather than as a dedicated field, but the new expected state is still mandatory.
New test-framework primitivesUnder-specified2Reusable index-table construction, merge, and delayed-schedule expectations are new primitives needed throughout this EIP's tests, rather than ordinary test functions using only scalar expectations.
  • eip.md · Specification > Index tables Tests must generate typed binary entries, sort them lexicographically, hash them, and construct fixed-depth SSZ-list roots.
  • eip.md · Specification > Block processing Tests must also schedule immediate and delayed roots across five levels.
Confidence: Medium
Uncertainty: The sealed package contains no test-framework inventory, so permanence or reuse outside this EIP cannot be established.
Security risksUnder-specified2Root correctness and update availability affect trustless proofs and consensus state, while hot storage creates a targeted resource-attack surface. The interactions are concentrated in index derivation and its system contract, so targeted review and fuzzing fit better than the broadest security anchor.
  • eip.md · Security Considerations The hot system-contract storage branches are identified as susceptible to branch-poisoning attempts intended to slow state-root updates.
  • eip.md · Abstract The stored roots are intended to authenticate trustless log and transaction lookups.
  • eip.md · Specification > Indexing rules Commitments combine block hashes, transaction hashes, and receipt logs.
Confidence: Medium
Uncertainty: Missing commitment parameters and deployment constants prevent complete proof- soundness and adversarial-storage analysis at this snapshot.
EVM Gas rule changes1The proposal applies the existing gas-exempt system-operation convention to a new mandatory call, updating an existing accounting path without changing opcode prices or introducing a new metering mechanism.
  • eip.md · Specification > Block processing Each root update is a 30,000,000-gas system call that must complete, is excluded from the block gas limit, and does not apply EIP-1559 burn semantics.
  • eip.md · Specification > Gas costs The proposal explicitly leaves LOG-operation gas costs unchanged.
Confidence: Medium
Uncertainty: The text is explicit about the system call and unchanged LOG costs, but does not separately classify this convention as an EVM gas-rule change.
Cryptography1The proposal introduces one commitment construction composed of established SHA2-256 hashing and SSZ Merkleization; it is well known rather than novel.
  • eip.md · Specification > Index tables > Table root hash calculation The root is the SSZ-list root of SHA2-256 hashes of the binary encoded entries.
Confidence: High
Uncertainty: The construction's missing fixed depth/list limit is a consensus-specification gap, but does not make the underlying cryptography novel.
Show 15 zero-score criteria
Zero-score criteria (Checklist revision 2)
CriterionScoreWhy this scoreEvidence / uncertainty
Added opcodes0No new opcode is defined.
  • eip.md · Specification > Index contract > Bytecode The supplied contract is composed of existing EVM instructions.
Uncertainty: Contract bytecode is new code, not a new opcode.
Modified opcodes0No existing opcode result or non-gas behavior is modified or deprecated.
  • eip.md · Specification > Gas costs Existing LOG operations retain their gas costs.
  • eip.md · Specification > Index contract > Bytecode Existing opcodes are used without changing their semantics.
Uncertainty: The index observes logs after execution but does not alter LOG semantics.
Added precompiles0No precompile is introduced.
  • eip.md · Specification > Index contract The new callable facility is explicitly an EVM system contract with bytecode and storage.
Uncertainty: The system contract must not be classified as a precompile.
Modified precompiles0No precompile logic or gas schedule is modified.
  • eip.md · Specification > Index contract All new callable behavior is implemented by the index contract.
Uncertainty: The proposal contains no precompile behavior.
Modified system contracts0Reusing SYSTEM_ADDRESS and the system-call convention does not modify the code, state, or behavior of the pre-existing beacon-roots system contract.
  • eip.md · Specification > Block processing The proposal reuses EIP-4788's calling convention at its own index-contract address.
  • supporting/eip-4788.md · Specification > Beacon roots contract EIP-4788's beacon-roots contract remains independently addressed and specified.
Uncertainty: No indirect behavioral change to a pre-existing system contract is specified.
State-access ordering within opcode execution0The new work is a block-level post-transaction operation; no opcode's internal state-access point or gas-charge ordering is changed.
  • eip.md · Specification > Block processing The new root-write call occurs after processing all transactions.
  • eip.md · Specification > Gas costs Existing LOG operations retain their gas cost.
Uncertainty: No opcode-internal ordering change is specified.
Blob gas accounting changes0No blob gas rule, charge, budget, or field is introduced or modified.
  • eip.md · Specification > Block processing The specified accounting exception concerns only the index-contract system call.
Uncertainty: The proposal contains no blob-gas behavior.
State gas accounting changes0The stateful contract adds storage writes but defines no new state-gas rate, charging site, budget, reservoir, or execution-gas spill rule.
  • eip.md · Specification > Index contract > set Root updates use ordinary storage writes in the index contract.
  • eip.md · Specification > Block processing The proposal specifies only the system call's execution-gas treatment.
Uncertainty: The draft does not state how its gas-exempt system operation relates to a separate state-gas regime; that omission is recorded as under-specification, not scored as an introduced mechanism.
New EVM gas refund0No gas-refund mechanism is added or changed.
  • eip.md · Specification > Gas costs The only gas-cost statement is that LOG costs need not increase.
Uncertainty: The proposal contains no refund behavior.
New transaction types0Indexing transactions does not introduce a transaction envelope or type.
  • eip.md · Specification > Indexing rules Existing transactions are indexed by their hashes and positions.
Uncertainty: The proposal applies uniformly to transactions already present in blocks.
New or modified transaction validity mechanisms0No existing transaction's validity rules or intrinsic gas calculation changes; the proposal derives a post-execution commitment from already processed transactions.
  • eip.md · Specification > Indexing rules Transaction hashes and receipt logs are consumed only after inclusion for index construction.
  • eip.md · Backwards Compatibility The incompatibility is described as a block-validation-rule change, not a transaction-validity change.
Uncertainty: Incorrect index processing can invalidate a block, but not an individual transaction.
New block / header fields0No block or header field is added; the new commitment is part of execution state.
  • eip.md · Abstract Roots are placed in system-contract storage and block-header bloom filters are unaffected.
Uncertainty: The block state root changes indirectly, but its header field and encoding do not.
Encoding changes (RLP/SSZ)0The proposal defines a new internal index-table encoding but does not change transaction, block, header, or Engine-interface encoding. The anchor's enumerated protocol encoding surfaces therefore remain unchanged.
  • eip.md · Abstract Roots are stored in contract state, and existing block-header bloom filters are unchanged.
  • eip.md · Specification > Index tables > Table root hash calculation SSZ is used for the new off-header index-table commitment itself.
Uncertainty: SSZ is newly used for table roots, but those tables are not transaction, block, or interface payloads under the rubric's stated scope.
Block syncing changes0Regeneration adds local post-sync work, but no block-RLP validation mechanism or sync-protocol encoding is introduced, which is the scope of this anchor.
  • eip.md · Specification > Initializing after chain/state sync The EIP explicitly says the sync protocol need not be extended; tables can be regenerated from recent blocks, with up to 319 blocks required.
Uncertainty: The 319-block retention/download requirement is a performance and initialization concern, not a scored RLP syncing change.
Engine API changes0No Engine API field, endpoint, or communication mechanism is specified.
  • eip.md · Specification > Block processing Root generation and the contract call are specified as execution-client block processing.
Uncertainty: The package does not prescribe any Engine API exposure for the generated roots.
Assessment provenance
Assessed EIP revision
ethereum/EIPs@ac450a4ab2 EIPS/eip-8304.md committed 2026-08-25 · information cutoff 2026-08-25T11:56:58Z
Current master · File history · blob 036b1a21f2 · sha256 f38a23beb31f
Rubric
Checklist revision 2 · ethspecs/pm@3d8c0128c5
Evaluator
gpt-5.6-sol at xhigh reasoning effort · isolation bubblewrap_one_eip_capsule_v1
Source record
Frozen research record research/tasks/08-hegota-prospective-complexity-assessment/outputs/assessments/hegota-pfi-2026-08-26/eip-8304.yaml · sha256 b84aa652b0ed
Supporting documents in the sealed package
supporting/eip-161.md, supporting/eip-1559.md, supporting/eip-4788.md, supporting/eip-7708.md, supporting/eip-8141.md

Evaluated on: Not recorded

26HighHigh
Evaluator
HumanChecklist v2
Confidence
Not recorded
Under-specified at assessment cutoff
Not recorded in the checklist
Checklist published
2026-08-24
Score bands · Checklist revision 2
  • Low <12
  • Medium 12–22
  • High ≥23

28 criteria scored 0–3 (4 in exceptional cases; cross-EIP interactions is uncapped); nominal maximum 84.

Complexity profile

Each segment is one criterion's contribution to the Human total. Hover or focus a segment for its score and rationale.

Top complexity drivers

  1. New fork activation mechanism3
  2. New invariant on pre-existing tests3
  3. New test-framework primitives3
  4. Performance risks3

Criterion breakdown

EIP-8304 Hegotá: Human criterion scores and rationale
CriterionScoreWhy this scoreNotes
New fork activation mechanism3Fork activation requires deploying/initializing the new system-contract account. In addition, a table is only generated when the EIP was already active at its `first_block`, so each table level starts appearing progressively after the fork. Explicit fork-boundary state-transition tests are required.
New invariant on pre-existing tests3Every post-fork block must generate and publish at least its single-block table root. Therefore, the expected post-state of every post-fork fixture depends on the index-contract update, regardless of the behavior the test was originally written to exercise.
New test-framework primitives3Permanent framework primitives are needed for entry extraction, canonical binary encoding, lexicographic sorting, SHA-256 hashing, SSZ merkleization, table merging, delayed publication, and ring-buffer addressing.
Performance risks3Every block must build, encode, sort, and hash all transaction and log entries, and merge the 4/16/64/256-block tables before their deadlines. The cost interacts with tx count, log count, topics, reorgs, disk layout, and sync state, and cannot be fully validated by isolated microbenchmarks alone.
Edge/boundary conditions3Covers the fork boundary, genesis, the parent-block hash offset, table alignment, five table sizes, delay deadlines, ring-buffer wraparound, invalid/zero table size, zero root, empty blocks, topic count, duplicate values, lexicographic byte ordering, reorgs, and sync initialization. A large combinatorial test set is required.
Added system contracts2One new stateful system contract is introduced. It receives a protocol-generated update every block and may receive multiple updates when several table levels become publishable at the same block.
Transition-tool interface changes2The transition tool needs a new index-table construction mechanism. A level-0 table can be derived from the current block and its receipts, but publishing delayed higher-level tables requires prior index entries, historical blocks, or equivalent persistent context that is not available in an ordinary single-block transition input.
Security risks2Incorrect entry generation, ordering, SSZ root, delay timing, or ring-buffer slot all produce a different state root and therefore consensus divergence.
Unspecified behavior requiring cross-client consensus2The EIP is still Draft with no client implementations and no devnet. `INDEX_CONTRACT_ADDRESS` and the synthetic deployment transaction are TBD, and the `List[Hash32, entry_count]` SSZ type admits more than one reading that yields different Merkle roots. These points are localized and need client agreement before vectors can be baselined; reorg handling is likewise left to clients.
Patterns affecting pre-existing tests1Every test executed under the new fork must account for the additional index-root state transition.
Cryptography1Adds SHA-256 entry hashing and SSZ merkleization, but both are mature mechanisms with abundant existing test resources.
Cross-EIP interactions1Explicitly depends on EIP-4788's system-call and deployment convention.
Show 16 zero-score criteria
Zero-score criteria (Checklist revision 2)
CriterionScoreWhy this scoreNotes
Added opcodes0No new opcodes.
Modified opcodes0LOG0–LOG4 and all other opcodes retain their existing execution semantics.
Added precompiles0No new precompiles.
Modified precompiles0No precompiles are modified.
Modified system contracts0No pre-existing system contract is modified.
EVM Gas rule changes0No opcode gas schedule or gas-calculation rule is modified.
State-access ordering within opcode execution0No changes to State-access ordering within opcode execution
Blob gas accounting changes0Blob gas is not involved.
State gas accounting changes0No state gas cost changes.
New EVM gas refund0Refunds are not involved.
New transaction types0No new transaction type.
New or modified transaction validity mechanisms0Transaction validity, intrinsic gas, and transaction encoding are all unchanged.
New block / header fields0No header field is added;
Encoding changes (RLP/SSZ)0The proposal defines an internal encoding for index entries and uses SSZ for table commitments, but it does not alter transaction, receipt, block, header, or protocol-interface encoding.
Block syncing changes0No block RLP validation rule or synchronization protocol is modified.
Engine API changes0No execution-payload field, Engine API endpoint changes.
Assessment provenance
Rubric
Checklist revision 2 · ethspecs/pm@3d8c0128c5
Evaluator
STEEL team · ethspecs/pm complexity_assessments
Source record
Open pull request #127: Add EIP-8304 complexity assessment · checklist at ec861017c0 · updated 2026-08-24
blob d4ccf1a464 · sha256 8a57b185f657
Research record
research/tasks/09-hegota-human-assessment-snapshot/outputs/assessments/eip-8304.yaml · sha256 6d8524db8af6

Both assessments applied Checklist revision 2 (28 criteria) to EIP-8304 in Hegotá. Δ is LLM minus Human.

Using the latest scored LLM evaluation for this checklist: 2026-08-26 · spec 2026-08-25 · ac450a4ab2. The Human and LLM assessments may use different spec revisions.

LLM30High
Human26High
Δ total+4Same tier
Criteria22/28agree exactly · 4 differ by 1 · 2 differ by 2+

Complexity profiles side by side

LLM
Human

Largest disagreements: Patterns affecting pre-existing tests (+2), Cross-EIP interactions (+2), EVM Gas rule changes (+1), New invariant on pre-existing tests (−1), New test-framework primitives (−1)

Per-criterion scores, Human versus LLM, ordered by the size of the difference
CriterionLLMHumanΔAgreementRationale from each source
Patterns affecting pre-existing tests31+2Differ by 2+
Show rationale

LLM Existing post-fork block tests across transactions, empty blocks, logs, state roots, block hashes, and periodic boundaries must incorporate the mandatory index transition. This is a major, diverse regression surface.

Human Every test executed under the new fork must account for the additional index-root state transition.

Cross-EIP interactions31+2Differ by 2+
Show rationale

LLM Coordinated vectors are required for EIPs 161, 1559, and 4788 around deployment and system-call semantics, and for EIPs 7708 and 8141 around newly generated logs and frame-receipt indexing. These span multiple strong interactions, but five identified EIPs do not trigger the rubric's first three-additional-EIP bonus.

Human Explicitly depends on EIP-4788's system-call and deployment convention.

EVM Gas rule changes10+1Differ by 1
Show rationale

LLM The proposal applies the existing gas-exempt system-operation convention to a new mandatory call, updating an existing accounting path without changing opcode prices or introducing a new metering mechanism.

Human No opcode gas schedule or gas-calculation rule is modified.

New invariant on pre-existing tests23−1Differ by 1
Show rationale

LLM A broad category of post-fork tests gains a mechanically derived index-root and system-state expectation even when indexing is not the test's subject. The rule does not apply before activation, so the score stops below the every-vector anchor.

Human Every post-fork block must generate and publish at least its single-block table root. Therefore, the expected post-state of every post-fork fixture depends on the index-contract update, regardless of the behavior the test was originally written to exercise.

New test-framework primitives23−1Differ by 1
Show rationale

LLM Reusable index-table construction, merge, and delayed-schedule expectations are new primitives needed throughout this EIP's tests, rather than ordinary test functions using only scalar expectations.

Human Permanent framework primitives are needed for entry extraction, canonical binary encoding, lexicographic sorting, SHA-256 hashing, SSZ merkleization, table merging, delayed publication, and ring-buffer addressing.

Unspecified behavior requiring cross-client consensus32+1Differ by 1
Show rationale

LLM Previously uncommitted transaction/log indexing becomes consensus-visible through contract storage and the block state root, yet root-defining SSZ parameters and activation deployment values are absent. Constructible blocks therefore lack a unique expected state until clients agree and the draft is amended.

Human The EIP is still Draft with no client implementations and no devnet. `INDEX_CONTRACT_ADDRESS` and the synthetic deployment transaction are TBD, and the `List[Hash32, entry_count]` SSZ type admits more than one reading that yields different Merkle roots. These points are localized and need client agreement before vectors can be baselined; reorg handling is likewise left to clients.

Added opcodes000Agree
Show rationale

LLM No new opcode is defined.

Human No new opcodes.

Modified opcodes000Agree
Show rationale

LLM No existing opcode result or non-gas behavior is modified or deprecated.

Human LOG0–LOG4 and all other opcodes retain their existing execution semantics.

Added precompiles000Agree
Show rationale

LLM No precompile is introduced.

Human No new precompiles.

Modified precompiles000Agree
Show rationale

LLM No precompile logic or gas schedule is modified.

Human No precompiles are modified.

Added system contracts220Agree
Show rationale

LLM Exactly one new system contract is added, and it is stateful because mandatory block processing repeatedly writes its storage.

Human One new stateful system contract is introduced. It receives a protocol-generated update every block and may receive multiple updates when several table levels become publishable at the same block.

Modified system contracts000Agree
Show rationale

LLM Reusing SYSTEM_ADDRESS and the system-call convention does not modify the code, state, or behavior of the pre-existing beacon-roots system contract.

Human No pre-existing system contract is modified.

State-access ordering within opcode execution000Agree
Show rationale

LLM The new work is a block-level post-transaction operation; no opcode's internal state-access point or gas-charge ordering is changed.

Human No changes to State-access ordering within opcode execution

Blob gas accounting changes000Agree
Show rationale

LLM No blob gas rule, charge, budget, or field is introduced or modified.

Human Blob gas is not involved.

State gas accounting changes000Agree
Show rationale

LLM The stateful contract adds storage writes but defines no new state-gas rate, charging site, budget, reservoir, or execution-gas spill rule.

Human No state gas cost changes.

New EVM gas refund000Agree
Show rationale

LLM No gas-refund mechanism is added or changed.

Human Refunds are not involved.

New transaction types000Agree
Show rationale

LLM Indexing transactions does not introduce a transaction envelope or type.

Human No new transaction type.

New or modified transaction validity mechanisms000Agree
Show rationale

LLM No existing transaction's validity rules or intrinsic gas calculation changes; the proposal derives a post-execution commitment from already processed transactions.

Human Transaction validity, intrinsic gas, and transaction encoding are all unchanged.

New block / header fields000Agree
Show rationale

LLM No block or header field is added; the new commitment is part of execution state.

Human No header field is added;

Encoding changes (RLP/SSZ)000Agree
Show rationale

LLM The proposal defines a new internal index-table encoding but does not change transaction, block, header, or Engine-interface encoding. The anchor's enumerated protocol encoding surfaces therefore remain unchanged.

Human The proposal defines an internal encoding for index entries and uses SSZ for table commitments, but it does not alter transaction, receipt, block, header, or protocol-interface encoding.

Block syncing changes000Agree
Show rationale

LLM Regeneration adds local post-sync work, but no block-RLP validation mechanism or sync-protocol encoding is introduced, which is the scope of this anchor.

Human No block RLP validation rule or synchronization protocol is modified.

New fork activation mechanism330Agree
Show rationale

LLM Activation installs code and initializes an account nonce, an explicit irregular state modification at the fork boundary, and begins table scheduling from that boundary.

Human Fork activation requires deploying/initializing the new system-contract account. In addition, a table is only generated when the EIP was already active at its `first_block`, so each table level starts appearing progressively after the fork. Explicit fork-boundary state-transition tests are required.

Engine API changes000Agree
Show rationale

LLM No Engine API field, endpoint, or communication mechanism is specified.

Human No execution-payload field, Engine API endpoint changes.

Transition-tool interface changes220Agree
Show rationale

LLM A single-block transition interface needs a new mechanism to supply or retain recent blocks and prior table material so it can derive periodic roots. That is more than one isolated scalar field, but the EIP does not prescribe the exact interface.

Human The transition tool needs a new index-table construction mechanism. A level-0 table can be derived from the current block and its receipts, but publishing delayed higher-level tables requires prior index entries, historical blocks, or equivalent persistent context that is not available in an ordinary single-block transition input.

Security risks220Agree
Show rationale

LLM Root correctness and update availability affect trustless proofs and consensus state, while hot storage creates a targeted resource-attack surface. The interactions are concentrated in index derivation and its system contract, so targeted review and fuzzing fit better than the broadest security anchor.

Human Incorrect entry generation, ordering, SSZ root, delay timing, or ring-buffer slot all produce a different state root and therefore consensus divergence.

Performance risks330Agree
Show rationale

LLM Work scales with transaction and log content, interacts with receipt production, periodic multi-level merging, block deadlines, storage updates, and sync recovery. End-to-end and adversarial-content performance cannot be established by one isolated microbenchmark and can substantially affect validation behavior.

Human Every block must build, encode, sort, and hash all transaction and log entries, and merge the 4/16/64/256-block tables before their deadlines. The cost interacts with tx count, log count, topics, reorgs, disk layout, and sync state, and cannot be fully validated by isolated microbenchmarks alone.

Edge/boundary conditions330Agree
Show rationale

LLM Genesis, activation, empty tables, level alignment, delayed availability, five table sizes, and 1,024-slot wraparound create multiple interacting boundary mechanisms. The schedule-by-level and overwrite combinations require an elevated case count.

Human Covers the fork boundary, genesis, the parent-block hash offset, table alignment, five table sizes, delay deadlines, ring-buffer wraparound, invalid/zero table size, zero root, empty blocks, topic count, duplicate values, lexicographic byte ordering, reorgs, and sync initialization. A large combinatorial test set is required.

Cryptography110Agree
Show rationale

LLM The proposal introduces one commitment construction composed of established SHA2-256 hashing and SSZ Merkleization; it is well known rather than novel.

Human Adds SHA-256 entry hashing and SSZ merkleization, but both are mature mechanisms with abundant existing test resources.

Criterion legend and glossary

Every stacked bar, comparison matrix, and criterion table on this site uses the same criterion colours, abbreviations, and order. Colour marks the criterion group; the abbreviation and name identify the criterion. Scores are 0–3 per criterion (4 is exceptional; cross-EIP interactions is uncapped).

EVM surface

Opcodes, precompiles, and system contracts that are added or modified.

  • Added opcodes
    Introduces new opcodes
    Score anchors
    0
    No new opcodes are introduced.
    1
    A new simple opcode is introduced (no data portion, no complex stack mechanics, and a constant gas cost).
    2
    Multiple new simple opcodes are introduced, or a single new complex opcode is introduced (has data portion, or complex stack mechanics, or a dynamic gas cost).
    3
    Multiple new opcodes are introduced, and at least one of them is complex (has data portion, or complex stack mechanics, or a dynamic gas cost).
    • Cryptography opcodes are not considered complex by default. Refer to the "Cryptography" section for a separate assessment.
  • Modified opcodes
    Modifies pre-existing opcodes
    Score anchors
    0
    No pre-existing opcode modifications are introduced.
    3
    At least one pre-existing opcode's behavior is modified (not including gas changes) or a pre-existing opcode is deprecated.
  • Added precompiles
    Introduces new precompiles
    Score anchors
    0
    No new precompiles are introduced.
    1
    A new simple precompile is introduced (constant input length, constant gas cost).
    2
    Multiple new simple precompiles are introduced, or a single new complex precompile is introduced (dynamic input length or dynamic gas cost).
    3
    Multiple new precompiles are introduced, and at least one of them is complex (dynamic input length or dynamic gas cost).
    • Cryptography precompiles are not considered complex by default. Refer to the "Cryptography" for a separate assessment.
  • Modified precompiles
    Modifies pre-existing precompiles logic or gas-accounting
    Score anchors
    0
    No pre-existing precompiles are modified.
    1
    At least one pre-existing precompile has its gas schedule modified.
    2
    Multiple pre-existing precompiles have their gas schedule modified, or a single pre-existing precompile has its behavior modified.
    3
    The behavior of multiple pre-existing precompiles, or a single complex pre-existing precompile modified.
  • Added system contracts
    Introduces new system contract, stateful or not
    Score anchors
    0
    No new system contracts are introduced.
    1
    A new system contract is introduced that is not stateful nor does it trigger a new system action (e.g. requests to the consensus layer).
    2
    Multiple new system contracts are introduced or a single new system contract that is either stateful or triggers a new system action (e.g. requests to the consensus layer).
    3
    Multiple new system contracts are introduced and at least one of them is either stateful or triggers a new system action (e.g. requests to the consensus layer).
  • Modified system contracts
    Modifies pre-existing system contracts
    Score anchors
    0
    No modifications to pre-existing system contracts are introduced, directly or indirectly.
    1
    Does not directly modify any system contract, but its behavior has minor indirect effects on one or more system contracts.
    2
    Does not directly modify any system contract, but its behavior has major indirect effects on one or more system contracts.
    3
    At least one pre-existing system contract code or state is modified, which would involve irregular state transition or a similarly complex transition methodology.

Gas and accounting

Execution, blob, and state gas rules, refunds, and where charges happen inside opcodes.

  • EVM Gas rule changes
    New EVM gas accounting rules
    Score anchors
    0
    No gas accounting changes.
    1
    Existing gas accounting mechanism is updated.
    2
    A new gas accounting mechanism is introduced but it does not affect existing mechanisms nor does it affect existing tests.
    3
    A new gas accounting mechanism is introduced and affects existing mechanisms which in turn affect existing tests.
  • State-access ordering within opcode execution · Checklist revision 2 only
    Changes *where inside an opcode's execution* state is accessed, or where gas is charged relative to that access. Because a state access is recorded in the block-level access list only if execution had enough gas to reach it, this ordering is consensus-critical: moving it changes the BAL at every gas boundary of every affected opcode.
    Score anchors
    0
    No change to where state is accessed, or to where gas is charged relative to a state access, within any opcode.
    1
    A single opcode's state-access or gas-charge ordering changes.
    2
    Multiple opcodes' ordering changes, or a new state-accessing operation is introduced whose position in the order must be settled.
    3
    The ordering rule changes for a whole class of state-accessing opcodes at once, or what counts as a recordable state access is redefined — requiring existing BAL vectors to be re-derived across opcodes and forks.
    • Distinct from "Modified opcodes", which asks whether an opcode's **result** changed. This row asks about the **path to the result**, which is observable even when the result is identical. An EIP can be 0 on that row and 3 on this one.
    • Score changes **to** the ordering. Do not score the fact that state accesses are observable — they always are.
    • Each boundary must be re-tested against every other dimension that can change the answer (cold/warm, static/non-static, delegated/direct, revert/success), so the case count grows multiplicatively rather than additively. Note this explicitly under Special Considerations.
  • Blob gas accounting changes
    New Blob gas accounting rules which potentially affect pre-existing tests
    Score anchors
    0
    No blob gas accounting changes.
    1
    Existing blob gas accounting mechanism is updated.
    2
    A new blob gas accounting mechanism is introduced but it does not affect existing mechanisms nor does it affect existing tests.
    3
    A new blob gas accounting mechanism is introduced and affects existing mechanisms which in turn affect existing tests.
  • State gas accounting changes · Checklist revision 2 only
    New state gas accounting rules. State gas is the cost of *writing* state, as opposed to accessing or executing it: `StateGasCosts`, `COST_PER_STATE_BYTE`, the block-level state gas budget, and the spill path into execution gas.
    Score anchors
    0
    No state gas accounting changes.
    1
    An existing state gas cost or `STATE_BYTES_PER_*` rate is adjusted.
    2
    A new state-gas-charging site is introduced, or the block-level state gas budget or reservoir allocation is modified.
    3
    A new state gas charging mechanism is introduced, or the spill interaction between state gas and execution gas is modified, affecting existing gas tests.
    • Harder to test than blob gas: the spill path means state gas cannot be metered independently of execution gas, and some costs (e.g. `NEW_ACCOUNT`) are state-dependent.
  • New EVM gas refund
    New gas-refund mechanism
    Score anchors
    0
    No new gas-refund mechanisms are introduced.
    1
    A new simple gas-refund mechanism is introduced that does not affect either existing tests or existing gas-refund mechanisms.
    2
    A new complex gas-refund mechanism is introduced or a simple mechanism that affects existing tests or existing gas-refund mechanisms.
    3
    A new complex gas-refund mechanism is introduced that affects existing tests or existing gas-refund mechanisms.

Blocks, transactions, and encoding

Transaction types and validity, block and header fields, encodings, syncing, and activation-time changes.

  • New transaction types
    Introduces a new transaction type
    Score anchors
    0
    No new transaction types are introduced.
    3
    A new transaction type is introduced.
  • New or modified transaction validity mechanisms
    Creates new or modifies pre-existing transaction types' validation mechanisms
    Score anchors
    0
    No changes are introduced to the validity rules of existing transaction types or to their intrinsic gas cost calculation.
    1
    Minor adjustments are introduced to validity rules or intrinsic gas cost calculation, but they do not significantly affect existing tests.
    2
    Changes to validity rules or intrinsic gas cost calculation affect existing tests, but require only limited updates to test cases and no redesign of the testing infrastructure.
    3
    Changes to validity rules or intrinsic gas cost calculation require extensive rework or redesign of the tests or testing infrastructure.
  • New block / header fields
    Introduces new block or block header fields
    Score anchors
    0
    No new block or header fields are introduced.
    3
    A new block or header field is introduced.
  • Encoding changes (RLP/SSZ)
    Introduces encoding changes at the transaction/block/interfaces level
    Score anchors
    0
    No encoding changes are introduced at the transaction, block, or interfaces levels.
    3
    An encoding change is introduced at transaction, block or interfaces level (e.g. RLP -> SSZ).
    • "Interfaces level" includes the Engine API. Score an Engine API encoding change (e.g. JSON -> SSZ) here.
  • Block syncing changes
    Modifies block RLP validation mechanisms that require test client syncing.
    Score anchors
    0
    No new RLP validation mechanism is introduced.
    1
    A single simple RLP validation mechanism is introduced.
    2
    Multiple simple RLP validation mechanisms are introduced or a single complex one.
    3
    Multiple RLP validation mechanisms are introduced and at least one of them is deemed complex.
  • New fork activation mechanism
    Modifies state, internal variables, or similar, at the fork activation block
    Score anchors
    0
    No state modifications, internal variables or similar are modified at the fork activation block.
    3
    Either a state modification or internal variables are modified at the fork activation block.
    • Initialization of new internal variable is not considered a modification.

Client interfaces

Engine API and transition-tool interface changes.

  • Engine API changes
    Introduces new fields to the Engine API directives
    Score anchors
    0
    No new fields or communication mechanisms are introduced to the Engine API.
    1
    A single new field is introduced in one of the Engine API endpoints.
    2
    Multiple fields are introduced to one or multiple Engine API end points, or a new Engine API end-point is introduced.
    3
    Multiple fields are introduced to one or multiple Engine API end points and a new Engine API end-point is introduced.
  • Engine API encoding changes · Checklist revision 1 only
    Engine API encoding changes (the revision-1 template defines no anchor text for this row).
  • Transition-tool interface changes
    Modifies or adds new fields to the transition tool interface.
    Score anchors
    0
    No modifications to the transition tool interface are required.
    1
    A single new field needs to be introduced to the transition tool interface.
    2
    Multiple new fields or a new mechanism has to be introduced to the transition tool interface.
    3
    Multiple new fields and a new mechanism has to be introduced to the transition tool interface.
    • Special consideration must be paid to this section if the EIP introduces a mechanism that requires the state transition tool to be aware whether the block it is processing is the fork-activation block.

Testing impact

Rework, new invariants, and new primitives required in the test framework.

  • Patterns affecting pre-existing tests
    Implements a new validation mechanism or rule that translates in reworking pre-existing tests
    Score anchors
    0
    No pre-existing tests are affected by this change.
    1
    Minor subset of existing tests are affected by this change.
    2
    Considerable subset of existing tests are affected by this change but involves only a contrived category of tests.
    3
    Major subset of existing tests are affected, including diverse category of tests (benchmarks, static, multiple forks, etc.).
  • New invariant on pre-existing tests · Checklist revision 2 only
    Tests that are **not about this EIP** must nonetheless assert something this EIP produces. Their logic does not change; they gain a new thing to check.
    Score anchors
    0
    Pre-existing tests assert nothing new.
    1
    A narrow, contrived category of pre-existing tests gains a new assertion.
    2
    A broad category gains a new assertion, applied mechanically.
    3
    Every test in the fork gains the assertion regardless of what it tests, and pre-fork vectors must be re-derived to satisfy it.
    • Paired with the row above, and easy to confuse with it. "Patterns affecting pre-existing tests" asks whether existing tests must be **reworked**; this row asks whether they must **additionally assert something new**. Score both — an EIP can be low on one and high on the other.
  • New test-framework primitives · Checklist revision 2 only
    Requires new abstractions in the test framework itself — expectation types, modifiers, helpers — beyond writing test functions with what already exists.
    Score anchors
    0
    Existing test primitives suffice.
    1
    Existing primitives need minor extension.
    2
    New expectation or modifier primitives are required, reusable within this EIP's own test suite.
    3
    New framework-level primitives are required that become a permanent part of the framework and are used by other EIPs' tests.

Risk and validation

Security, performance, boundary conditions, and cryptography that need validation.

  • Security risks
    Introduces or modifies mechanisms that could compromise the security of the chain, users, validators, or other stakeholders, if not implemented properly.
    Score anchors
    0
    No new mechanisms are introduced that could pose a security risk.
    1
    The introduced mechanisms are self-contained, can be validated in isolation, and do not alter existing invariants that could pose a security risk for any stakeholders.
    2
    The introduced mechanisms interact with a limited number of existing components, slightly altering their security assumptions and requiring a targeted security review or fuzzing.
    3
    The introduced mechanisms interact with multiple existing components, including critical ones, substantially altering their security assumptions and requiring an extensive security review and fuzzing.
  • Performance risks
    Introduces or modifies mechanisms and requires performance validation.
    Score anchors
    0
    No new mechanisms are introduced that require performance validation.
    1
    The introduced mechanisms can be benchmarked in isolation and do not affect existing performance behavior.
    2
    The introduced mechanisms cannot be fully benchmarked in isolation, but they only have a limited impact on the existing performance benchmarks.
    3
    The introduced mechanisms cannot be benchmarked in isolation and have a substantial impact on existing performance benchmarks or have complex interactions with existing mechanisms.
  • Edge/boundary conditions
    Feature contains edge/boundary conditions.
    Score anchors
    0
    No discernible edge cases or boundary conditions are introduced.
    1
    A single edge-case or boundary-condition prone mechanism is introduced.
    2
    Multiple edge-case or boundary-condition prone mechanisms are introduced, but none of them requires an elevated number of cases to test.
    3
    Multiple edge-case or boundary-condition prone mechanisms are introduced and at least one of them requires an elevated number of cases to test.
  • Cryptography
    Introduces new cryptography mechanisms or modifies existing functionality that involves cryptography
    Score anchors
    0
    No cryptography mechanisms are introduced.
    1
    A new cryptography mechanism is introduced but it is a well known mechanism that is known to have vast resources to aid on its testing.
    2
    Multiple new cryptography mechanisms are introduced that are well-known or a single but novel mechanism is introduced that is either untested or has limited resources.
    3
    Multiple new cryptography mechanisms are introduced and at least one of them is a novel mechanism.

Coordination

Cross-EIP interactions and behavior that clients must agree on before tests exist.

  • Cross-EIP interactions
    Introduces or modifies mechanisms that affect other EIPs in either the same or past forks.
    Score anchors
    0
    Fully self-contained EIP that does not depend on, modify, or conflict with any other EIP.
    1
    The EIP interacts with one or more other EIPs in a non-critical and limited way but can be tested independently for the most part.
    2
    The EIP depends on or modifies one or more other EIPs such that coordinated testing and consideration is required, but interactions are limited in scope and not complex.
    3
    The EIP has strong interdependencies with multiple EIPs, requiring extensive coordinated cross-EIP testing as well as potential re-design of existing test vectors.
    • +1 for every 3 additional interacting EIPs beyond the first 3, each of which requires its own coordinated test cases. List the EIPs in the rationale.
    • This row is intentionally uncapped, unlike every other anchor: each interacting EIP is another axis of the test matrix, so a ceiling would make a 12-EIP product indistinguishable from a 3-EIP one.
  • Unspecified behavior requiring cross-client consensus · Checklist revision 2 only
    The EIP text does not determine the answer for cases a test can construct. Clients must agree on a previously unspecified detail before tests can be baselined. The cost here is coordination and re-baselining, not test writing.
    Score anchors
    0
    The EIP text determines the answer for every case a test could construct.
    1
    A few details are unspecified but have an obvious intended reading.
    2
    Details require client agreement before tests can be written, but they are localized.
    3
    A previously unspecified *and previously unobservable* behavior becomes consensus-critical; expect tests to be re-baselined on each round of EIP amendment.
    • Score this from the EIP's state at assessment time: whether it has client implementations, whether it has been through a devnet, and how many open questions remain on its discussion thread.