ERC-6821 Web3 URL의 ENS 이름 지원 (Support ENS Name for Web3 URL)

Draft · 이름·메타데이터 · 2023-04-02 작성

web3:// 주소(ERC-4804)에서 ENS 이름을 썼을 때 그 이름을 실제 스마트 컨트랙트 주소로 바꾸는 표준 절차를 정합니다.

왜 필요한가

ERC-4804는 web3://로 시작하는 주소로 스마트 컨트랙트를 직접 호출하는 방식을 정의합니다. 이때 컨트랙트를 가리키는 방법은 두 가지인데, 0x로 시작하는 긴 16진수 주소를 쓰거나 이름 서비스(name service)에 등록된 이름을 쓰는 것입니다. 그런데 이름을 썼을 때 그 이름을 실제 컨트랙트 주소로 바꾸는 절차가 표준으로 정해져 있지 않으면, 구현체마다 서로 다른 방법으로 주소를 찾아 같은 주소라도 결과가 달라질 수 있고 이름이 가리키는 컨트랙트가 어느 체인에 있는지 알릴 방법도 없습니다. 이 표준은 이더리움 이름 서비스(ENS) 이름을 ERC-4804용 컨트랙트 주소로 바꾸는 순서를 단계별로 정해서 어떤 구현체가 처리하든 같은 이름이 같은 컨트랙트로 이어지게 합니다.

심층 설명

ERC-4804와의 관계

ERC-4804는 RFC 2396 형식의 web3:// URI로 스마트 컨트랙트를 호출하는 방법을 정의합니다. URI에는 컨트랙트를 주소로 적을 수도 있고 이름 서비스의 이름으로 적을 수도 있는데, 이름이 쓰였을 때는 그 이름에서 컨트랙트 주소를 알아내는 방법이 따로 필요합니다. 이 표준은 그 이름이 ENS 이름일 때의 매핑을 정의합니다. 머리말의 requires 항목대로 ERC-137, ERC-634, ERC-3770, ERC-4804를 전제로 합니다.

주소를 찾는 3단계 절차

web3:// URI에서 얻은 contractName과 chainid를 입력으로, 프로토콜은 다음 순서로 주소를 찾습니다. 1단계, chainid 체인의 ENS 리졸버에서 contentcontract 텍스트 레코드를 찾습니다. 그 체인에 ENS가 없거나 레코드가 올바른 ETH 주소가 아니면 오류를 반환합니다. 2단계, contentcontract 레코드가 없으면 ERC-137의 컨트랙트 주소 인터페이스로 이름을 풀어 얻은 주소를 씁니다. 3단계, 그렇게 얻은 주소가 제로 주소면 "address not found" 오류를 반환합니다. 즉 contentcontract 레코드가 있으면 그것이 우선이고 없을 때만 ENS의 일반 주소 해석으로 넘어갑니다.

contentcontract 레코드와 체인 오버라이드

contentcontract 텍스트 레코드에는 두 가지 형태의 값을 넣을 수 있습니다. 하나는 0x 접두사가 붙은 16진수 이더리움 주소이고 다른 하나는 ERC-3770 체인 지정 주소입니다. 값이 ERC-3770 체인 지정 주소이면 메시지를 호출할 chainid가 URI에 적힌 값 대신 그 주소에 지정된 chainid로 덮어써집니다. 이 방식으로 ENS 이름 하나가 다른 체인에 있는 컨트랙트를 가리키게 할 수 있습니다.

contenthash 대신 텍스트 레코드를 쓴 이유

ENS에는 콘텐츠를 가리키는 용도로 contenthash라는 레코드가 이미 있지만 이 표준은 ERC-3770 체인 지정 주소를 담은 contentcontract 텍스트 레코드를 씁니다. 텍스트 레코드는 사람이 읽을 수 있는 형태이기 때문인데, 이는 ERC-4804의 설계 원칙이기도 합니다. 또 텍스트 레코드를 쓰면 앞으로 유효 기간(TTL, time to live) 같은 필드를 추가할 여지도 생깁니다.

보안 고려 사항과 문서 상태

원문 Security Considerations 절은 발견된 보안 고려 사항이 없다고만 적고 있습니다. 한편 이 문서는 Draft 상태입니다. 아직 확정되지 않은 제안이므로 절차나 레코드 이름 같은 세부 내용이 앞으로 바뀔 수 있습니다.

ERC 원문 · ← ERCs