EIP-1 EIP의 목적과 지침 (EIP Purpose and Guidelines)

콜 결정 없음 · 기타 · 원문 상태 Living · 2015-10-27 작성

EIP가 무엇이고 어떻게 쓰고 어떤 절차로 표준이 되는지를 정하는 메타 문서입니다. 모든 이더리움 개선 제안의 규칙서 역할을 합니다.

왜 필요한가

이더리움은 특정 회사가 아니라 전 세계에 흩어진 개발자, 클라이언트 팀, 커뮤니티가 함께 바꿔 나가는 네트워크입니다. 누군가 새 기능을 제안하고 싶을 때 어디에 어떤 형식으로 내야 하는지, 누가 검토하는지, 언제 확정되는지가 정해져 있지 않으면 합의가 불가능합니다. EIP-1은 이 과정 전체를 정의합니다. 제안서를 EIP(Ethereum Improvement Proposal, 이더리움 개선 제안)라는 문서로 쓰게 하고, 버전 관리되는 저장소에 텍스트 파일로 보관해 수정 이력 자체가 제안의 역사 기록이 되게 합니다. 또 제안의 종류를 나누고 초안에서 최종 확정까지의 상태 흐름과 각 단계에서 필요한 요건을 정합니다. 구현자는 자신이 구현한 EIP 목록을 밝히는 것만으로 진행 상황을 알릴 수 있고, 사용자는 어떤 기능이 어느 단계에 있는지 추적할 수 있습니다.

무엇이 바뀌나

지금

EIP-1 이후

누구에게 영향이 있나

심층 설명

EIP의 세 가지 유형

Standards Track EIP는 대부분 또는 모든 이더리움 구현체에 영향을 주는 변경을 다루며 네 가지 카테고리로 나뉩니다. Core는 합의 포크가 필요한 개선과 코어 개발자 논의가 필요한 변경, Networking은 devp2p와 Light Ethereum Subprotocol 등 네트워크 프로토콜 개선, Interface는 메서드 이름이나 컨트랙트 ABI 같은 언어 수준 표준, ERC는 토큰 표준(ERC-20), 이름 레지스트리(ERC-137) 같은 애플리케이션 수준 표준입니다. Meta EIP는 이더리움을 둘러싼 절차를 다루며 프로토콜 자체가 아닌 영역에 적용되고 사용자가 보통 무시할 수 없습니다. Informational EIP는 설계 이슈나 일반 지침을 제공할 뿐 새 기능을 제안하지 않으며 커뮤니티 합의를 대표하지 않으므로 따르지 않아도 됩니다. 하나의 EIP는 하나의 핵심 제안만 담는 것이 권장되며 여러 클라이언트에 영향을 주거나 여러 앱이 쓸 표준을 정의하는 변경만 EIP가 필요합니다.

상태 흐름과 각 상태의 의미

Idea는 초안 이전 단계로 저장소에서 추적되지 않습니다. Draft는 처음으로 공식 추적되는 단계로, 형식을 갖추면 편집자가 저장소에 병합합니다. Review는 저자가 동료 검토를 요청한 상태입니다. Last Call은 Final 직전의 최종 검토 기간으로, 저자가 last-call-deadline(보통 14일 뒤)을 지정한 PR을 열며 규범적 변경이 필요해지면 Review로 되돌아갑니다. Final은 최종 표준으로 오류 수정과 비규범적 설명 추가만 허용되며 Last Call에서 Final로 바꾸는 PR은 상태 변경 외의 수정을 포함하지 않아야 합니다. Draft, Review, Last Call 상태에서 6개월 이상 활동이 없으면 Stagnant로 이동하고 저자나 편집자가 되살릴 수 있습니다. Withdrawn은 저자가 철회한 상태로 같은 번호로 되살릴 수 없습니다. Living은 계속 갱신되도록 설계되어 최종 확정에 이르지 않는 특수 상태로, EIP-1 자신이 대표 사례입니다.

성공적인 EIP의 필수 구성

프리앰블은 EIP 번호, 최대 44자의 제목, 최대 140자의 설명, 저자 정보를 담은 RFC 822 형식 헤더입니다. Abstract는 명세의 요지를 짧게 전달하는 기술 요약입니다. Motivation은 기존 프로토콜이 왜 부족한지 설명하며 동기가 자명하면 생략할 수 있습니다. Specification은 경쟁하는 상호운용 구현(besu, erigon, ethereumjs, go-ethereum, nethermind 등)이 가능할 만큼 상세해야 합니다. Rationale은 설계 결정의 이유와 검토한 대안, 논의에서 제기된 반론을 다룹니다. Backwards Compatibility는 하위 호환성이 깨지는 경우 필수입니다. Test Cases는 합의 변경에 영향을 주는 EIP에 필수입니다. Security Considerations는 모든 EIP에 필수이며 이 절이 없는 제출은 거절되고 검토자가 충분하다고 판단하지 않으면 Final로 갈 수 없습니다. 마지막으로 모든 EIP는 CC0으로 저작권을 포기해 퍼블릭 도메인에 두어야 합니다.

헤더 프리앰블 필드

헤더는 eip, title, description, author, discussions-to, status, last-call-deadline, type, category, created, requires, withdrawal-reason 순서로 적습니다. category는 Standards Track EIP에만 필요합니다. author에는 최소 한 명이 GitHub 사용자명을 포함해야 변경 요청 알림을 받고 승인·거절 권한을 가질 수 있습니다. discussions-to는 Ethereum Magicians 토픽이 선호되며 GitHub 풀 리퀘스트나 사라질 수 있는 URL은 쓸 수 없습니다. requires는 다른 EIP의 개념이나 기술 요소 없이는 이해하거나 구현할 수 없을 때 적는 의존성 필드로, 단순히 다른 EIP를 언급하는 것만으로는 의존성이 생기지 않습니다. 날짜는 ISO 8601(yyyy-mm-dd) 형식을 씁니다.

코어 EIP와 AllCoreDevs 콜

코어 EIP는 클라이언트 구현이 있어야 Final이 될 수 있으므로, 저자가 직접 구현을 제공하거나 클라이언트 팀을 설득해야 합니다. 구현자의 검토를 받는 가장 좋은 방법은 AllCoreDevs 콜에서 발표하는 것으로, AllCoreDevs 아젠다 GitHub 이슈에 EIP 링크를 댓글로 달아 요청합니다. 이 콜은 EIP의 기술적 장점 논의, 다른 클라이언트의 구현 의향 파악, 네트워크 업그레이드를 위한 구현 조율이라는 세 가지 기능을 합니다. 콜의 결과는 보통 어떤 EIP를 구현할지에 대한 느슨한 합의(rough consensus)로 이어지는데, 이는 EIP가 네트워크 분열을 일으킬 만큼 논쟁적이지 않고 기술적으로 건전하다는 가정 위에 서 있습니다. 원문은 이 절차가 기술 외적 쟁점을 다루도록 설계되지 않았는데도 그런 쟁점에 얽히는 경우가 많다는 점을 경고하며 저자가 Ethereum Magicians 스레드에 커뮤니티 논의를 최대한 모아 두기를 권합니다.

편집자의 역할과 외부 링크 규칙

편집자는 새 EIP가 기술적으로 말이 되고 완결성이 있는지, 제목이 내용을 정확히 담는지, 언어와 마크업과 코드 스타일이 맞는지 확인한 뒤 번호를 배정하고 병합합니다. 편집자는 EIP의 가치를 심사하지 않으며 행정과 편집만 담당합니다. 현재 편집자는 Matt Garnett, Sam Wilson, Zainan Victor Zhou, Gajinder Singh, Jochem Brouwer이고 편집자가 되려면 EIP-5069를 참고합니다. 외부 자료 링크는 사라지거나 바뀔 수 있어 원칙적으로 금지되며 실행 클라이언트 명세, 합의 계층 명세, W3C 권고안, IETF RFC 같은 정해진 예외만 특정 커밋이나 버전에 고정하는 조건으로 허용됩니다. 이 허용 절차는 EIP-5757이 규정합니다. 다른 EIP를 인용할 때는 ERC 카테고리면 ERC-X, 그 외에는 EIP-X로 표기하고 첫 인용 시 상대 경로 링크를 붙여야 합니다.

문서의 기원과 Living 상태

이 문서는 Amir Taaki가 쓴 비트코인의 BIP-0001에서 많은 부분을 가져왔고 BIP-0001은 다시 파이썬의 PEP-0001에서 파생됐습니다. 여러 곳에서 문구를 그대로 복사해 수정했습니다. PEP-0001의 저자들은 이더리움 개선 절차에서 사용되는 데 책임이 없으므로, 이더리움 관련 질문은 EIP 편집자에게 해야 합니다. EIP-1의 상태는 Living으로, 최종 확정에 이르지 않고 필요에 따라 계속 갱신되도록 설계된 문서입니다. 따라서 여기 정리한 절차와 편집자 명단도 앞으로 바뀔 수 있습니다.

EIP 원문 · ← EIPs