Skip to content

EIP-1 and erc-template conformance for the core draft - #3

Open
rasca wants to merge 1 commit into
activation-not-beforefrom
eip1-formatting
Open

EIP-1 and erc-template conformance for the core draft#3
rasca wants to merge 1 commit into
activation-not-beforefrom
eip1-formatting

Conversation

@rasca

@rasca rasca commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Formatting-only pass bringing the core draft in line with EIP-1 and the official erc-template, verified this week against the live EIP-1 text, the erc-template, and the ethereum/ERCs CI configuration (eipw.toml). No design changes.

Stacked on #2 (activation-not-before) because it edits that branch's text; retarget to main after #2 merges.

What changed

  • Preamble frontmatter replaces the H1 title and pre-draft blockquote: title, description (one sentence, under 140 chars, no "standard", no number), author, status: Draft, type: Standards Track, category: ERC, created, requires: 165. Headers in EIP-1's mandated order.
  • ## Copyright added with the exact mandated wording (CC0, relative LICENSE link).
  • RFC boilerplate upgraded to the full RFC 2119 + RFC 8174 sentence from the template, linked to rfc-editor.org (an allowlisted origin).
  • RFC keywords confined to Specification per EIP-1's rule: Security Considerations now restates its guidance in lowercase prose (should / should not); every normative capital remains in the Specification section.
  • Template-only top-level sections: "Prior art" folded into Motivation/Rationale; "Possible future extensions" became a "Deferred extensions" Rationale bullet. Final order: Abstract, Motivation, Specification, Rationale, Security Considerations, Copyright.
  • Relative links in submission form: first mentions of ERC-165 and ERC-8033 link to ./eip-165.md / ./eip-8033.md (the form merged ERCs use; dead in this repo by deliberate choice). ERC-8033 gained a one-line characterization (multi-agent council oracles) instead of a bare URL.
  • Kleros prior art cited descriptively: "the Kleros arbitration standard (numbered 792 in the Kleros ecosystem; never merged into the official proposal repositories)". Rationale: the files exist in neither ethereum/EIPs nor ethereum/ERCs, docs.kleros.io links are barred by the CI link allowlist, the eipw markdown-link-first lint requires the first mention of any literal "ERC-N" string to be a link, and a precedent search found zero merged ERCs citing ERC-792 by number. The Kleros links stay in AGENTS.md's Prior literature and will go in the discussions-to forum post.
  • AGENTS.md: decision 26 records all of the above; the "prior-art links are inlined" convention is amended accordingly.

Deliberately not done here

  • No Solidity interface block (excluded from this PR's scope).
  • discussions-to is absent until the Ethereum Magicians thread exists.
  • Author is listed by email; swap in a GitHub handle before submission (the ERCs auto-merge bot matches it).
  • Abstract length untouched (template prefers a shorter paragraph; trimming risks touching ideas).
  • The EAS normative-dependency question stays parked (AGENTS.md "Things to look at"); naming EAS in prose without links matches merged-ERC precedent (7484, 7506, 8226, 8273, 8326).

🤖 Generated with Claude Code

Preamble frontmatter, Copyright (CC0), full RFC 2119+8174 boilerplate,
RFC keywords confined to the Specification section, template-only
top-level sections (Prior art folded into Motivation/Rationale, future
extensions into a Rationale bullet), submission-form relative links for
EIP/ERC mentions, and descriptive citation of the Kleros prior art
(numbers prefix-free: they exist in neither official repo and merged
ERCs never cite them by number). No design changes. Decision 26 in
AGENTS.md records the full rationale.

Co-Authored-By: Claude Fable 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