Repository navigation
README: lead with the problem and the business, in plainer words - #115
Merged
Merged
Conversation
Adds a headline-numbers strip, a plain 'The problem' section, a Business model section (Cloud tiers, why protocols pay, market size from docs/11), a plain-English summary of the checks with the full table collapsed, and a plain-English column for the guarantees. No numbers changed.
Replaces the README with a rewrite that keeps every number and caveat but leads with proof, and replaces the generated banner and the demo-video GIF with figures drawn from the repo's own data, light and dark: - Header: a hull in section, one compartment breached, the bulkhead holding. - Fig. 1: Drift modeled behind Bulkhead (reference/drift_model.py): half the vault in 12 minutes without it, 9 days with it. - Fig. 2: where Bulkhead sits; replaces the mermaid diagram. - Fig. 3: scenario S1 as a trace, animated at 4x, drawn from one run of cloud/e2e/run.sh on 17 Oct 2026 (times and signatures in s1-run.json). Also corrects "one every 800 ms": attack.mjs sends each payout 800 ms after the last one confirmed. docs/assets/src/render.sh rebuilds every figure. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
shuv-amp
added a commit
that referenced
this pull request
Oct 17, 2026
The README conflict is resolved to main's new layout with this branch's corrected counts: Kani 17/17 (14 Oct, 14 at full width), 133/133 program tests, 9 fuzz targets with the note on the unmeasured one, 33 differential commands, and tools/claims.py in the repository layout. Two rules now accept the new table rows, whose label is followed by a caption. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
shuv-amp
added a commit
that referenced
this pull request
Oct 17, 2026
Conflicts resolved: this branch's counts in docs/09 (136 program tests, Vault 91), main's tools/claims.py, and main's README with 136/136. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Oct 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes the README easier for judges, investors and protocol founders to read, without losing any of the technical detail.
attest), and the market size. Replaces the dense "Who pays" paragraph and keeps its caveats.No numbers, ids, hashes or commands changed. Every figure is taken from the current README or docs/11-BUSINESS.md.