Commit 8d00a8e
docs(readme): add a Correctness section consolidating the data-correctness evidence
Speed and correctness are the two halves of the fork's claim; the README led
with Benchmarks but had no consolidated backing for the hero line's
"byte-identical to eth_getLogs". This adds one `## Correctness` section between
Benchmarks and Compatibility.
Thesis: the fork changes the transport (Portal, not per-chain JSON-RPC), not the
data — sync-store rows are byte-identical to stock Ponder over RPC. Then the
evidence layers, one canonical VALIDATION.md link per claim:
- byte-diff vs stock RPC (§3.2 F-full eth, §3.6 polygon, §3.7 bsc)
- whole-store count parity, 62/62 cells, 0 diffs (§5.7)
- third-party corroboration: Goldsky subgraphs + public archive nodes (§5.7)
- reorg & finality: finalized-only backfill + mutation-tested realtime (§5.8)
- crash/durability: chaos kill-loop byte-identical resume (§4, Layer C)
Honesty boundaries stated plainly (not hidden): residual diffs are upstream
dataset column gaps surfaced as honest NULL (§5.6), not fork data loss (the old
fabricated-[] defect is fixed, #32 closed); Portal-native /stream realtime is
experimental. Docs-only — cannot affect the fork seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>1 parent 5e5453f commit 8d00a8e
1 file changed
Lines changed: 16 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
67 | 67 | | |
68 | 68 | | |
69 | 69 | | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
70 | 86 | | |
71 | 87 | | |
72 | 88 | | |
| |||
0 commit comments