How do EIP numbers get assigned?

EIPs
1

I’ve read the the EIPs home page and EIP-1 but I’m still not 100% sure how EIP numbers get assigned.

EIP-1 says this:

Once the EIP is ready for the repository, the EIP editor will:

  • Assign an EIP number (generally the PR number, but the decision is with the editors)
  • …

So am I correct to assume that is up to the EIP editors, who oftentimes are different from the EIP authors, to assign a number to an EIP?

If yes, and they do not want to use the PR or the issue number, is it common practice to increment the number used in the last EIP, or do they sometimes skip some values for brevity reasons (e.g. EIP-5500 is easier to remember than EIP-5497)?

Here’s why I find this confusing. There currently exist two proposals in which the authors seem to have assigned whatever numbers they wanted:

This is in spite of the fact that the latest PR number on GitHub is 5045:

GitHub EIPs repo

My guess is that these proposals haven’t been vetted yet by EIPs editors - but I want to make sure that my guess is correct.

3 Likes
2

Your guess is correct. Unfortunately we don’t control what people claim their EIP numbers to be.

4 Likes
3

But the claimed EIP is over-written by the editors correct?

1 Like
4

As per the current process, an EIP number has to be assigned by EIP editor(s).

Usually it is the first Pull Request (or Issue, in some cases) for that proposal on EIP GitHub. We are strongly recommending discussion-to at FEM, hence authors are suggested to create a pull request with the proposal and most likely that pull request number is going to be the EIP number.

In rare cases where EIP editors observe one/many spam pull requests or issues in the repo followed by a proposal on an attractive number like EIP-5555, EIP editors veto and allocate another unused number.

Here’s why I find this confusing. There currently exist two proposals in which the authors seem to have assigned whatever numbers they wanted:

This is in spite of the fact that the latest PR number on GitHub is 5045:

I understand this can be confusing, looking at a discussion thread with already assigned number without the Draft in pull request.

We can not control what an author chooses to create a FEM thread for vetting the proposal, rest assured, at the time when added as a pull request Draft, chances are that EIP authors will allocate the EIP number which may be different than whatever shared earlier. As a team working on process improvement, we can educate people to follow good practices and self allocating an EIP number of own choice is certainly not a good one.

2 Likes
5

I propose EIP-10000: use clear descriptive titles in EIP proposals rather than numbers. e.g. this proposal could be EIP-Descriptive-EIPs

6

It is a very useful and educational thread on how EIP numbers get assigned. I have learned a lot.

1 Like