Repository navigation
Polish the sample catalog for Devcon - #1
JamesCarnley wants to merge 16 commits into
Conversation
…tent
Ahead of the Devcon demo, an audit found public cards carrying internal
review notes ("FLAGGED FOR JAMES", "pending James's decision", "FLAG
(mild)"), wrong facts, and conversion junk.
- Facts: Algorand now credits Gilad, Hemo, Micali, Vlachos and Zeldovich
(SOSP 2017), with Chen & Micali as related work. Avalanche's titles
and authors match the two hosted 2020 PDFs. XRP's card says the paper
"argues" fault tolerance and notes the 2018 Chase & MacBrough analysis.
Dead source links replaced; sources named for Polygon and Polkadot.
- Litecoin, Dogecoin, TRON and BNB are now neutral, sourced explainer
cards (no whitepaper, or a link to the official one) instead of
placeholder or flagged notes.
- matic-whitepaper.md: anchors, empty headings, raw math and a broken
image removed; prose unchanged. cosmos-whitepaper.md: provenance
header only.
- Every card: title, facts list (project, paper, authors, year, source,
the file it describes), short summary. Licence lines dropped: the
owner hosts whitepapers without a licence field.
- manifest: public `flagged`/`link-only` tags removed; proof-of-stake
tagged consistently.
Each fact was checked against the hosted PDF, the upstream copy
(sha256-compared) or Wikipedia/Wikidata. `npm run validate` passes.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
The owner wants A Cypherpunk's Manifesto (Hughes, 1993) and The Crypto Anarchist Manifesto (May, 1988) on chain in full; they're foundational and widely republished. The repo had turned both into link-only records, while Sepolia still serves the full texts seeded in June. The full texts are restored byte-for-byte from that June seed, so the seeder only corrects their contentHash in place instead of publishing new copies. Manifest entries, README counts and the collection index are updated to match (5 hosted works, 16 link-only records). Also names the source of the Ocalan excerpt (The Sociology of Freedom, Volume 3); 2020 is the English edition's year. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
EIP/ERC cross-links (`./eip-N.md`) and the CC0 link (`../LICENSE.md`) only resolve inside the EIPs repo, so on EFS they were dead. They now point at eips.ethereum.org and creativecommons.org; the README notes the change. Text is otherwise verbatim. catalog.json and README byte totals match the edited datasets, and the catalog's licence posture records the owner's decisions. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 92da708516
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
The previous commit dropped each card's licence/distribution line along with the internal review wording. AGENTS.md says licence notes must not be removed (Codex review), and the owner's decision was only that a machine-readable licence field isn't required for documents. Every card now carries a one-line **Rights:** note in neutral wording: what the paper itself states, or that it states nothing. Earlier claims that couldn't be confirmed are kept but marked as unverified (Ethereum's CC BY, Filecoin's Creative Commons). Polkadot's Creative Commons statement was confirmed in the PDF text. Catalog byte totals updated. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Tested the way the explorer runs games (sandbox="allow-scripts" srcdoc iframe, headless Chrome): - pong.html only worked with a WebSocket server: paddles never moved offline. Replaced with Jake Gordon's Javascript Pong (MIT, revision ca32405), combined into one file with its images and sounds inlined. It plays the computer (skill adapts to the score), two players or a demo, by keyboard, mouse or touch, scales to its frame, and Esc no longer calls window.confirm (blocked in the sandbox). The MIT notice stays at the top of the file. Harness: no exceptions, no network requests, ball and paddles move, scoring works. - tiny-yurts.html threw a SecurityError reading localStorage at boot and showed a blank green field. A small script before the game now substitutes in-memory storage when Web Storage throws; the game code is unchanged. Harness: title screen loads with no errors, and Start opens a playable map. Manifest entries, README and catalog totals updated. `npm run validate` and `npm run test:games:fit` pass. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
The explorer shows a folder's README.md as its intro pane, but no
dataset README was in a manifest, so /games opened bare. The old README
was curator notes ("Monday seed", "ask us"), so it moves unchanged to
CURATION.md (not published), and a new README.md introduces the games
for visitors: where to start, controls, browse-by-tag links, why games
on EFS, and credits. Links are absolute, since the explorer renders
relative links as dead text.
Every game also gets a `title` and one-line `description`. Dante is
described neutrally (its theme couldn't be confirmed from the packed
code); the CC0 classics are credited to Steven Lambert (straker).
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Under the owner's rule that documents are hosted without a licence field, the shortest canonical texts move from link-only records to full text, each with an author/date line and its source: - Barlow, A Declaration of the Independence of Cyberspace (EFF) - The Mentor, The Conscience of a Hacker (Phrack issue 7) - Zimmermann, Why I Wrote PGP (author's site; 1999 revision) - Finney, Protecting Privacy with Electronic Cash (Extropy #10, checked against the scanned print; figures not reproduced, noted in the file) - Finney, The Beauty of ECash (his archived page) - May, Libertaria in Cyberspace (his 1993 repost of the 1992 essay) - New: Wei Dai, b-money (weidai.com), reference [1] of the Bitcoin whitepaper The six matching records are removed. README.md becomes a visitor Overview (published); curator notes move to CURATION.md. collection.md now lists 12 included and 10 linked works. Bookkeeping tags (record, about, index) are dropped, and every entry has contentType and source. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Shows images working on EFS, around archives that outlast their
medium. Licences and files come from the Wikimedia Commons API:
- Pale Blue Dot (Voyager 1, 1990), NASA, {{PD-USGov-NASA}}, unmodified
- Voyager Golden Record cover (1977), NASA, {{PD-USGov-NASA}}, Commons'
own 1920 px rendition instead of the 4 MB original (noted)
- Ethereum diamond icon, {{PD-textlogo}}, with a trademark note
Each image has an about-card, and the folder has a visitor README. The
image entries carry `license: LicenseRef-PublicDomain`, which the
seeder's media licence gate requires.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
An automated security review of the previous commits flagged two gaps: - /media had a manifest but no catalog.json entry, so the validator never checked it, while the seeder (which scans datasets/) would still publish it. media and history are now registered, and the validator fails when any datasets/<name>/manifest.json isn't in the catalog. - Newly hosted cypherpunk texts dropped the old fail-closed rights state. That was the owner's decision (2026-10-27: documents may be hosted when rights are unclear; media needs a real licence), but the repo still stated the old rule. AGENTS.md now records the policy, NOTICE.md's rights table matches it (incl. history and media), and the seven newly hosted texts carry an explicit `license: "NOASSERTION"`. Also counts a published README.md as a payload file (it was always skipped) and ignores CURATION.md. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
A new /history folder for the Devcon audience, 12 files: - Converted to markdown with provenance headers, author's text unchanged (word-diffed against the source embedded in each page): "Ethereum: Now Going Public" (Buterin, Jan 2014), "DApps: What Web 3.0 Looks Like" (Wood, Apr 2014), the Devcon 0 recap (Dec 2014), "Ethereum Launches" (Jul 2015), "CRITICAL UPDATE Re: DAO Vulnerability" (Jun 2016) and the Mainnet Merge announcement (2022). - EIP-779 (the DAO hard fork) and EIP-3675 (the Merge), verbatim CC0 at a pinned ethereum/EIPs commit. - EFS cards for the genesis block and the last proof-of-work block (15,537,393), with every field read by eth_getBlockByNumber from several mainnet RPCs; F2Pool's extraData decodes to 七彩神仙鱼. - timeline.md from the 2013 whitepaper to Fusaka, every fork date checked against ethereum.org and by RPC; README.md as the Overview. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Whitepapers: - Adds the Ethereum Yellow Paper (Shanghai version efc5f9a, 2025-02-04; CC BY-SA 4.0 per the repo LICENCE.md) with its card. - Every entry now has title, description, author, year and source. - README.md becomes the visitor Overview (published); curator notes move to CURATION.md; ADDRESSES.md is a neutral CID table (unpublished). Standards: - Adds EIP-1, EIP-7702, EIP-7594 (PeerDAS), ERC-4804 (web3:// URLs, which EFS uses) and ERC-137 (ENS), verbatim CC0 at pinned commits. - The 12 remaining `../assets/...` links and images now point at pinned absolute URLs (ERCs keep assets under assets/erc-N/), each checked to return 200; four reference-style eip links in EIP-712 converted. - Titles, descriptions and the `ethereum` tag on every entry; README as the visitor Overview, curator notes in CURATION.md. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Every tag becomes a permanent anchor under /tags on chain, so the bookkeeping tags `about`, `index` and `record` are dropped and `payments` is merged into `payment`. catalog.json and the README table now cover all six datasets with current counts and descriptions. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
A symlinked folder under datasets/ was skipped by the unregistered- manifest check (automated security review). The seeder skips symlinks too, so nothing unvalidated could be published, but the validator now fails loudly instead of skipping silently. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 89baf2dd01
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
The hosting policy records unclear rights as `license: "NOASSERTION"`, but history (and the older whitepapers) left those entries without a licence, so "approved, rights unknown" looked the same as missing metadata (Codex review). Every entry now has one: - third-party documents with no stated licence: NOASSERTION - EFS-authored cards, timelines and READMEs: CC0-1.0 - the Yellow Paper PDF: CC-BY-SA-4.0 (its repo LICENCE.md) - EIPs keep their explicit CC0-1.0 `npm run validate` now passes with no licence warnings. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
After the mouse moved over the game, the EFS input layer kept a pointer target on the paddle and steered toward it every frame, so the game's original Q/A and P/L keys were overridden: with the mouse at the paddle's centre, holding Q did nothing (Codex review). Pressing one of those keys now clears that paddle's pointer target, as W/S and the arrow keys already did. Verified in headless Chrome: mouse-steer the left paddle to mid-court, then hold Q for 0.7 s. Before: y 210 -> 210. After: y 210 -> 169. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 805eebb458
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
In two-player mode every W/S or arrow event re-synced both paddles, so player 2 tapping Up stopped player 1 while they held Q, and player 1 pressing W wiped player 2's mouse target (Codex review). Each key now updates only the paddle it belongs to: W/S the left paddle; the arrows the right paddle in two-player mode and the left paddle otherwise. Verified in headless Chrome, checking paddle state directly: - P1 holds Q, P2 taps Up: left paddle `up` 1 -> 0 before, 1 -> 1 after. - P2 steers with the mouse, P1 taps W: right paddle target cleared before, kept after. - The earlier fix still holds: Q takes over from the mouse. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Summary
Gets the sample catalog ready for the Devcon demo. It fixes what an audit found in public files, and applies the owner's content decisions (2026-10-27).
flaggedandlink-onlyare dropped.What publishing this does on Sepolia
A read-only dry run (seeder from efs-project/contracts#48 at
4715e34, curator0x11Cb…9912, this branch at92da708) gives:heals=29 writes=61 removals=0contentHashcorrected in place.Test plan
npm run validate: passes. The only warning is "40 file(s) missing machine-readable license" for whitepapers, which is expected under the no-licence-field decision.Agents involved
🤖 Generated with Claude Code