ERC-1062 ENS 리졸버에 IPFS 해시 저장하기 (Formalize IPFS hash into ENS(Ethereum Name Service) resolver)
Stagnant · 이름·메타데이터 · 2018-05-02 작성
IPFS에 저장된 파일의 해시를 ENS 이름(리졸버)에 등록해 사람이 읽기 쉬운 이름만으로 분산 저장된 콘텐츠에 접근할 수 있게 하는 표준입니다.
왜 필요한가
IPFS는 파일을 base58 형식의 멀티해시(multihash)로 식별하는 반면, 이더리움과 ENS 리졸버 컨트랙트는 바이너리 데이터를 hex로 다룹니다. 두 형식을 어떻게 서로 변환해 ENS 리졸버에 저장하고 꺼내 쓸지에 대한 공통 규칙이 없으면, 서비스마다 제각각 변환 방식을 만들게 되어 지갑이나 브라우저가 서로 다른 구현을 호환하지 못합니다. 그 결과 사용자는 ENS 이름 하나로 분산 저장된 웹사이트나 파일에 접근하지 못하고 매번 복잡하고 긴 IPFS 해시 문자열을 직접 다뤄야 합니다.
구현해야 하는 것
function setMultihash(bytes32 node, bytes hash) public only_owner(node);: 해당 ENS 노드의 소유자만 호출할 수 있으며 hex로 변환된 IPFS 해시를 그 노드에 저장합니다.function multihash(bytes32 node) public view returns (bytes);: 해당 ENS 노드에 저장되어 있는 IPFS 해시(hex 형식)를 조회해 반환합니다.
심층 설명
왜 바이너리 버퍼를 거쳐 변환하는가
IPFS는 파일 지문을 base58로 인코딩하지만 이더리움 API는 바이너리 데이터를 hex로 다룹니다. 두 인코딩을 직접 맞바꾸는 규칙이 없으므로, base58 문자열을 먼저 바이너리 버퍼로 디코딩하고 그 버퍼를 hex 문자열로 다시 인코딩해 컨트랙트에 저장합니다. 반대로 조회할 때는 저장된 hex를 버퍼로 디코딩한 뒤 base58 문자열로 인코딩해 원래의 IPFS 주소를 복원합니다. 바이너리 버퍼가 두 인코딩 사이를 잇는 중간 형식 역할을 합니다.
setMultihash 메서드
setMultihash(bytes32 node, bytes hash)는 ENS 노드와 hex로 변환된 IPFS 해시를 받아 저장합니다. only_owner(node) 제약이 걸려 있어 해당 ENS 노드의 소유자만 이 값을 설정할 수 있습니다. 호출 전에 base58 IPFS 해시를 hex 형식으로 변환해 두어야 합니다.
multihash 메서드
multihash(bytes32 node)는 view 함수로, 특정 ENS 노드에 저장된 IPFS 해시를 hex 형식(bytes)으로 그대로 반환합니다. 호출한 쪽에서 반환된 hex 값을 다시 base58 문자열로 변환해 실제 IPFS 리소스를 가져오는 데 사용합니다.
멀티해시 변환 구현 예시
원문은 base58과 hex 사이 변환을 위해 npm의 multihashes 라이브러리 사용을 제시합니다. toHex 함수는 multihash.fromB58String으로 base58 해시를 버퍼로 바꾼 뒤 multihash.toHexString으로 hex 문자열(앞에 '0x' 접두)을 만듭니다. toBase58 함수는 반대로 hex 문자열(0x 제거)을 multihash.fromHexString으로 버퍼로 바꾼 뒤 multihash.toB58String으로 base58 문자열을 복원합니다.
활용 사례: 브라우저 확장
원문은 이 표준의 구현 사례로 브라우저 확장을 제시합니다. 사용자는 확장을 설치한 뒤 DNS 주소를 입력하듯 ENS 이름을 브라우저에 입력하기만 하면 분산 저장된 리소스에 접근할 수 있습니다. 이를 통해 일반 사용자가 완전히 분산된 웹사이트를 쉽게 방문하지 못하는 문제를 해결하려 합니다. 원문은 Portal Network의 구현 저장소를 예시로 링크하고 있습니다.
제안 상태
이 ERC는 2018년 5월에 작성된 뒤 Stagnant(정지) 상태로, 표준화 절차가 더 진행되지 않고 멈춰 있는 제안입니다.