The Ethereum Improvement Proposal repository http://eips.ethereum.org/
Go to file
jeffishjeff 485b14afc8 EIP 1203 (#1204) 2018-07-17 13:10:07 +02:00
EIPS EIP 1203 (#1204) 2018-07-17 13:10:07 +02:00
_data Add new two-week review process to EIPs (#1100) 2018-06-04 16:22:55 +01:00
_includes Add support for github usernames in author lines (#974) 2018-04-06 23:59:24 +02:00
_layouts Discussions-to is not necessarily an email address 2018-03-27 19:49:09 +01:00
assets Add EIP-1207 DAuth Access Delegation Standard (#1208) 2018-07-17 13:01:40 +02:00
.gitattributes [WIP] Add eth_signTypedData as a standard for machine-verifiable and human-readable typed data signing with Ethereum keys (#712) 2018-06-09 20:19:15 +01:00
.gitignore First attempt at an autogenerated jekyll listing of EIPs 2018-03-20 15:22:42 +00:00
.travis-ci.sh Cache external link checks (#1164) 2018-06-24 19:57:24 +01:00
.travis.yml Cache external link checks (#1164) 2018-06-24 19:57:24 +01:00
404.html First attempt at an autogenerated jekyll listing of EIPs 2018-03-20 15:22:42 +00:00
CNAME Create CNAME 2018-05-02 14:29:16 -04:00
Gemfile Update Gemfile 2018-06-07 12:46:13 +01:00
Gemfile.lock Update Gemfile.lock 2018-06-07 14:43:21 +01:00
ISSUE_TEMPLATE.md Updated templates 2017-02-01 19:12:07 -06:00
PULL_REQUEST_TEMPLATE.md Add autocommit bot and descriptions of it (#967) 2018-04-03 20:02:04 +01:00
README.md Show canonical URLs (#1192) 2018-07-05 13:07:29 +01:00
_config.yml Fix travis build script, and more typos identified by it 2018-03-23 16:56:22 +00:00
all.html Add 'all' page 2018-03-21 16:29:32 +00:00
core.html Add pages for each EIP type, improve listing tables with links 2018-03-21 15:55:18 +00:00
eip-X.md Add HTML comments and a link to more client implementations (#1021) 2018-04-24 11:29:44 +01:00
erc.html Add pages for each EIP type, improve listing tables with links 2018-03-21 15:55:18 +00:00
index.html Add new two-week review process to EIPs (#1100) 2018-06-04 16:22:55 +01:00
informational.html Fix title for informational EIPs listing page 2018-03-21 16:33:20 +00:00
interface.html Add pages for each EIP type, improve listing tables with links 2018-03-21 15:55:18 +00:00
last-call.xml Add new two-week review process to EIPs (#1100) 2018-06-04 16:22:55 +01:00
meta.html Add pages for each EIP type, improve listing tables with links 2018-03-21 15:55:18 +00:00
networking.html Add pages for each EIP type, improve listing tables with links 2018-03-21 15:55:18 +00:00

README.md

EIPs Gitter

Ethereum Improvement Proposals (EIPs) describe standards for the Ethereum platform, including core protocol specifications, client APIs, and contract standards.

A browsable version of all current and draft EIPs can be found on the official EIP site.

Contributing

  1. Review EIP-1.
  2. Fork the repository by clicking "Fork" in the top right.
  3. Add your EIP to your fork of the repository. There is a template EIP here.
  4. Submit a Pull Request to Ethereum's EIPs repository.

Your first PR should be a first draft of the final EIP. It must meet the formatting criteria enforced by the build (largely, correct metadata in the header). An editor will manually review the first PR for a new EIP and assign it a number before merging it. Make sure you include a discussions-to header with the URL to a discussion forum or open GitHub issue where people can discuss the EIP as a whole.

If your EIP requires images, the image files should be included in a subdirectory of the assets folder for that EIP as follow: assets/eip-X (for eip X). When linking to an image in the EIP, use relative links such as ../assets/eip-X/image.png.

Once your first PR is merged, we have a bot that helps out by automatically merging PRs to draft EIPs. For this to work, it has to be able to tell that you own the draft being edited. Make sure that the 'author' line of your EIP contains either your Github username or your email address inside . If you use your email address, that address must be the one publicly shown on your GitHub profile.

When you believe your EIP is mature and ready to progress past the draft phase, you should do one of two things:

  • For a Standards Track EIP of type Core, ask to have your issue added to the agenda of an upcoming All Core Devs meeting, where it can be discussed for inclusion in a future hard fork. If implementers agree to include it, the EIP editors will update the state of your EIP to 'Accepted'.
  • For all other EIPs, open a PR changing the state of your EIP to 'Final'. An editor will review your draft and ask if anyone objects to its being finalised. If the editor decides there is no rough consensus - for instance, because contributors point out significant issues with the EIP - they may close the PR and request that you fix the issues in the draft before trying again.

EIP Status Terms

  • Draft - an EIP that is open for consideration.
  • Accepted - an EIP that is planned for immediate adoption, i.e. expected to be included in the next hard fork (for Core/Consensus layer EIPs).
  • Final - an EIP that has been adopted in a previous hard fork (for Core/Consensus layer EIPs).
  • Deferred - an EIP that is not being considered for immediate adoption. May be reconsidered in the future for a subsequent hard fork.

Preferred Citation Format

The canonical URL for a EIP that has achieved draft status at any point is at https://eips.ethereum.org/. For example, the canonical URL for ERC-165 is https://eips.ethereum.org/EIPS/eip-165.