Skip to content

Polish the sample catalog for Devcon - #1

Open
JamesCarnley wants to merge 16 commits into
mainfrom
devcon/sample-content-polish
Open

JamesCarnley wants to merge 16 commits into
mainfrom
devcon/sample-content-polish

Conversation

@JamesCarnley

Copy link
Copy Markdown
Member

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).

  • Whitepapers:
    • Facts: Algorand's authors and Avalanche's paper titles are corrected.
    • Internal notes: "FLAGGED FOR JAMES"-style notes are removed from public cards.
    • Explainer cards: Litecoin, Dogecoin, TRON and BNB are now neutral, sourced explainers.
    • Conversion junk: cleaned out of the Matic whitepaper.
    • Consistency: every card has the same shape, and the public tags flagged and link-only are dropped.
    • Licences: no licence field is required for documents.
  • Cypherpunk: both founding manifestos (Hughes 1993, May 1988) are hosted in full again. They're byte-identical to what's live on Sepolia, so publishing only corrects their hash. The source of the Öcalan record is now named.
  • Standards: EIP cross-links and the CC0 link now point at eips.ethereum.org and creativecommons.org, so they work outside the EIPs repo.
  • Catalog: byte totals and licence posture updated.
  • Games: unchanged on purpose. All 15 stay, including Dante.

What publishing this does on Sepolia

A read-only dry run (seeder from efs-project/contracts#48 at 4715e34, curator 0x11Cb…9912, this branch at 92da708) gives:

heals=29 writes=61 removals=0

  • 29 heals: files with unchanged bytes (18 PDFs, the 2 manifestos, 9 games) get their old bare-keccak contentHash corrected in place.
  • 61 writes: 38 changed files (22 whitepaper cards, 10 EIPs, 6 games updated since June) and 23 new cypherpunk files.
  • Unpin list: 38 old IPFS CIDs, printed by the run, to unpin from the VPS node afterwards.

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.
  • Whitepaper facts checked against each hosted PDF's first page, sha256 against upstream copies, and Wikipedia/Wikidata.
  • Live read-only seeder plan, as above.

Agents involved

  • Content audit: two independent Claude Opus 5.5 subagents
  • Whitepaper polish: Claude Opus 5.5 subagent (fact-checked)
  • Manifestos, standards, catalog and review: Claude Opus 5.5
  • Orchestrator: James

🤖 Generated with Claude Code

JamesCarnley and others added 3 commits October 27, 2026 17:03
…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>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-12T21:46:27.950979Z 0817922 New commits
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread datasets/crypto-whitepapers/ethereum.md Resolved
JamesCarnley and others added 10 commits October 27, 2026 17:08
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>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread datasets/history/manifest.json Resolved
Comment thread datasets/web-games/pong.html Resolved
JamesCarnley and others added 2 commits November 12, 2026 15:38
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>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread datasets/web-games/pong.html Resolved
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant