EIP-5757 외부 자료 승인 절차 (Process for Approving External Resources)

최종 확정 · 기타 · 원문 상태 Final · 2022-09-30 작성

EIP가 저장소 밖의 외부 자료를 링크할 때 허용되는 출처(오리진)의 요건 세 가지와, 새 출처를 승인하고 제거하는 절차를 정합니다.

왜 필요한가

EIP는 가끔 저장소 밖의 외부 자료를 링크합니다. 다른 표준 기구의 문서나 책, 논문 같은 것입니다. 그런데 외부 자료는 EIP 저장소가 통제할 수 없습니다. 자료의 특정 판을 집어낼 방법이 없으면 내용이 바뀌어도 추적하기 어렵고 표준이 가리키는 근거가 사실상 변할 수 있습니다. 또 표준을 구현하는 데 꼭 필요한 자료라면 구현자가 언제든 볼 수 있어야 하는데, 출처가 사라지거나 유료 장벽을 세우면 그 표준은 구현하기 어려워집니다. 이더리움 생태계는 개방성과 무료 접근 위에 서 있으므로 EIP 과정도 같은 원칙을 따라야 합니다. 이 EIP는 이런 문제를 막기 위해 링크해도 되는 출처, 즉 오리진(origin)이 갖춰야 할 요건 세 가지와 새 오리진을 승인하고 제거하는 절차를 정합니다.

무엇이 바뀌나

지금

EIP-5757 이후

누구에게 영향이 있나

심층 설명

세 가지 용어 정의

원문은 세 용어를 정의합니다. 링크(Link)는 다른 자료를 가리키는 모든 방법입니다. 마크다운 링크, 앵커 태그(<a>), 이미지, 책이나 저널 인용 등 현재 자료에 없는 내용을 참조하는 방식 전부가 해당합니다. 자료(Resource)는 내용을 담은 웹 페이지, 문서, 기사, 파일, 책 같은 매체입니다. 오리진(Origin)은 자료를 펴내거나 기록하는 주체로, 원문은 w3c 같은 표준 기구와 DOI(Digital Object Identifier System) 같은 문서 참조 체계를 예로 듭니다. MUST, SHOULD 같은 요구 수준 단어는 RFC 2119의 해석을 따릅니다.

오리진이 갖춰야 할 세 요건

허용되는 오리진은 세 요건을 지켜야 합니다. 첫째, 자료의 특정 개정판을 유일하게 식별하는 방법을 제공해야 합니다(MUST). git 커밋 해시, 버전 번호, 발행일이 그런 방법의 예로 제시됩니다. 둘째, 가용성의 검증된 이력이 있어야 합니다(MUST). 원문은 오리진이 10년 이상 존재하며 자료를 안정적으로 제공해 왔다면 이 요건을 충족하기에 충분하지만 반드시 그래야만 하는 것은 아니라고 적습니다. 셋째, 자료 접근에 요금을 부과해서는 안 됩니다(MUST NOT).

오리진 제거 규칙

승인된 오리진이 위 요건을 더는 충족하지 못하면 EIP-1에서 제거해야 합니다(MUST). 제거된 오리진이 나중에 요건을 다시 충족하면 승인 절차를 다시 밟아 재승인될 수 있습니다(MAY). 기존 링크의 처리는 EIP 상태에 따라 다릅니다. Final이나 Withdrawn처럼 확정된(Finalized) EIP는 해당 오리진으로 가는 링크를 제거하도록 고치지 않는 것이 좋습니다(SHOULD NOT). 반면 확정되지 않은 EIP는 상태를 바꾸기 전에 그 링크를 반드시 제거해야 합니다(MUST).

오리진 승인 절차

에디터가 어떤 오리진이 요건을 충족한다고 판단하면 EIP-1을 업데이트해야 합니다(MUST). 업데이트에는 세 가지가 들어갑니다. 허용된 오리진의 이름, 그 오리진의 자료를 참조할 때 허용되는 마크업과 요구되는 서식, 그리고 링크가 어떻게 보여야 하는지에 대한 완전히 렌더링된 예시입니다. 승인은 이름을 목록에 올리는 일에 더해 링크 작성 방식까지 함께 표준화하는 작업입니다.

세 요건의 설계 근거

고유 식별자: 자료의 한 버전을 유일하게 식별할 수 없으면 변경을 추적하는 일이 비현실적이 되고 불변성을 보장하기 어렵습니다. 가용성: 링크된 자료 없이도 표준을 구현할 수 있다면 그 자료는 불필요한 것이고 자료 없이는 구현할 수 없다면 그 자료는 구현자가 볼 수 있어야 합니다. 무료 접근: 이더리움 생태계는 개방성과 무료 접근 위에 세워졌고 EIP 과정도 그 원칙을 따라야 합니다.

문서 성격과 상태

이 EIP는 프로토콜 코드가 아니라 EIP 절차 자체를 다루는 메타(Meta) 유형이고 상태는 Final입니다. 내용이 확정되어 현재 EIP 편집 과정에 적용되는 규칙이라는 뜻입니다. EIP-1을 requires로 참조하며 승인된 오리진 목록과 링크 서식은 이 문서가 아니라 EIP-1에 기록되고 갱신됩니다. 저작권은 CC0으로 포기되었습니다.

EIP 원문 · ← EIPs