ERC-1577 ENS 콘텐츠해시 필드 (contenthash field for ENS)

Stagnant · 이름·메타데이터 · 2018-11-13 작성

ENS 이름 하나로 IPFS, Swarm 같은 분산 저장소의 콘텐츠를 가리킬 수 있도록 contenthash 필드를 ENS 리졸버에 추가하는 표준입니다.

왜 필요한가

Metamask, Status 같은 애플리케이션들이 ENS 이름을 IPFS나 Swarm에 저장된 콘텐츠로 연결해 보여주려 했지만, 분산 저장 시스템마다 콘텐츠를 저장하고 주소를 매기는 방식이 서로 달랐습니다. 기존의 content, multihash 필드만으로는 이 값이 어떤 프로토콜의 주소인지 애플리케이션이 확실히 알 방법이 없었고, 도메인 소유자도 자신이 등록한 값이 어떻게 해석될지 보장할 수 없었습니다. 표준화된 필드가 없으면 각 앱이 저마다 다른 추측 방식으로 값을 해석해야 하고, 새로운 저장 프로토콜이 추가될 때마다 호환성 문제가 반복됩니다.

심층 설명

contenthash 필드와 인터페이스 선언

contenthash라는 새 필드가 ENS 리졸버에 도입됩니다. 이 필드를 지원하는 리졸버는 supportsInterface 함수가 인자 0xbc1c58d1로 호출될 때 반드시 true를 반환해야 합니다(MUST). 이를 통해 애플리케이션은 해당 리졸버가 contenthash를 지원하는지 사전에 확인할 수 있습니다.

multicodec 기반 인코딩 구조

contenthash가 반환하는 값은 기계가 읽을 수 있는 multicodec 형식으로 표현되어야 합니다(MUST). 형식은 <protoCode uvarint><value []byte>로, 앞쪽에 가변 길이 정수(uvarint)로 프로토콜 코드를 적고 뒤에 실제 값 바이트를 붙입니다. protoCode와 그 의미는 multiformats/multicodec 저장소에 정의되어 있습니다. 애플리케이션은 이 protoCode를 보고 어떤 종류의 주소가 인코딩되어 있는지 판단해, 지원하는 경우 해당 프로토콜 방식으로 해석해야 합니다(MUST).

IPFS와 Swarm 콘텐츠의 CID 인코딩

protoCode가 0xe3(IPFS)나 0xe4(Swarm)인 값은 베이스 접두사가 없는 v1 CID로 인코딩됩니다. 구조는 <protoCode uvarint><cid-version><multicodec-content-type><multihash-content-address>입니다. 예시로 IPFS는 CID 버전 1(0x01), 콘텐츠 타입 dag-pb(0x70), 해시 함수 sha2-256(0x12), 해시 길이 32바이트(0x20)와 해시값을 이어 붙여 0xe3010170122029f2... 형태의 바이너리가 되고 텍스트로는 ipfs://Qm...으로 표현됩니다. Swarm은 콘텐츠 타입 swarm-manifest(0xfa), 해시 함수 keccak256(0x1b)을 사용해 0xe40101fa011b20... 형태가 되며 텍스트로는 bzz://...로 표현됩니다.

content, multihash 폐지와 그레이스 기간

기존의 content, multihash 필드는 폐지됩니다. 다만 이미 content 필드에 IPFS나 Swarm 해시를 등록해 둔 이름 보유자들이 업데이트할 시간을 주기 위해 그레이스 기간을 반드시 두어야 합니다(MUST). 리졸버가 multihash 인터페이스를 지원하지 않으면 content 인터페이스를 지원하는지 확인해야 하고, 지원한다면 그 값을 맥락에 맞게 해석해야 합니다(SHOULD). 이 조건은 최소 2019년 3월 31일까지 유지되어야 합니다(MUST).

구현체

contenthash를 지원하는 새 리졸버(PublicResolver.sol)가 개발되어 메인넷 주소 0xd3ddccdd3b25a8a7423b5bee360a42146eb4baf3, Ropsten 주소 0xde469c7106a9fbc3fb98912bb00be983a89bddca에 배포되었습니다. contenthash 값을 인코딩·디코딩하는 JavaScript, Python 라이브러리도 별도로 존재합니다.

제안 상태

이 ERC는 Stagnant 상태로, 활발한 논의 없이 멈춘 제안입니다.

ERC 원문 · ← ERCs