ERC-7529 DNS 도메인과 컨트랙트 연결 (Contract Discovery and eTLD+1 Association)
Draft · 이름·메타데이터 · 2023-09-30 작성
웹 도메인의 DNS TXT 레코드와 스마트 컨트랙트가 서로를 가리키게 해서 어떤 컨트랙트가 정말 그 도메인 주인의 것인지 웹에서 바로 확인할 수 있게 하는 표준입니다.
왜 필요한가
기업이 토큰이나 NFT 같은 디지털 자산을 발행해도, 사용자는 지금 지갑이 상호작용하는 컨트랙트가 정말 그 회사 것인지 확인할 방법이 마땅치 않습니다. 가짜 컨트랙트를 진짜 회사 것처럼 꾸미는 사칭이 가능하고 잘 알려진 회사 도메인에서 출발해 그 회사의 컨트랙트를 찾아가는 검색 수단도 없었습니다. 예전에는 웹 앱이 DNS 기록을 직접 읽을 수 없어서 중간 사업자를 거쳐야 했고 그 사업자가 응답을 조작할 수도 있었습니다. RFC 8484의 DNS over HTTPS(DoH)가 도입되면서 웹 앱이 변조에 강한 방식으로 DNS 기록을 직접 조회할 수 있게 되었고 이 표준은 그 위에서 TXT 레코드를 컨트랙트 주소의 포인터로 쓰는 간단한 방법을 정의합니다.
구현해야 하는 것
event AddDomain(string domain);: 컨트랙트에 eTLD+1 도메인이 추가될 때 선택적으로 발생하는 이벤트입니다.event RemoveDomain(string domain);: 컨트랙트와 도메인의 연결이 해제될 때 선택적으로 발생하는 이벤트입니다.function checkDomain(string calldata domain) external view returns (bool);: eTLD+1 도메인 문자열을 받아 이 컨트랙트와 연결되어 있으면 true를 반환하는 조회 함수입니다.function addDomain(string calldata domain) external;: 인증된 계정만 호출할 수 있는 함수로, 컨트랙트에 eTLD+1 도메인을 추가합니다.function removeDomain(string calldata domain) external;: 인증된 계정만 호출할 수 있는 함수로, 더 이상 연결하지 않을 eTLD+1 도메인을 제거합니다.
심층 설명
eTLD+1을 기준으로 삼는 이유
TLD는 .com처럼 URL의 마지막 점 뒤에 오는 최상위 도메인입니다. 그런데 .ac.uk처럼 최상위가 아닌 층위에서도 서로 다른 조직이 도메인을 등록할 수 있어서 이런 등록 가능한 층위를 eTLD(effective top-level domain)라고 부릅니다. eTLD+1은 eTLD에 바로 다음 이름 한 부분을 붙인 것으로, 같은 eTLD+1 아래의 도메인은 모두 같은 조직 소유가 보장됩니다. 예를 들어 myexample.com의 eTLD는 .com이고, sussex.ac.uk의 eTLD는 .ac.uk입니다. 그래서 이 표준은 컨트랙트를 하나의 사업자나 조직과 연결하는 단위로 eTLD+1을 사용합니다.
TXT 레코드 스키마
eTLD+1 소유자는 연결할 컨트랙트를 가리키는 TXT 레코드를 반드시 만들어야 합니다. HOST는 ERC-7529.<chain_id>._domaincontracts 형식이고 <chain_id>는 대상 네트워크 체인 아이디의 십진수 표기입니다(이더리움 메인넷 1, Sepolia 11155111). VALUE는 컨트랙트 주소를 쉼표로 나열합니다. EVM 주소 문자열은 42자여서 대부분의 DNS 사업자에서 레코드 하나에 수십 개 주소를 담을 수 있고 같은 호스트에 여러 TXT 레코드를 두면 한 번의 DoH 질의로 전부 받아올 수 있습니다. 주소는 ERC-1191 체크섬 형식을 쓰는 것이 권장되며 클라이언트가 RPC 호출 전에 주소와 대상 네트워크의 유효성을 점검할 수 있습니다.
컨트랙트 쪽 인터페이스
컨트랙트는 domains라는 멤버 변수 하나만 추가하면 됩니다. 연결된 eTLD+1 도메인 문자열의 keccak256 해시를 키로, 불리언을 값으로 갖는 매핑입니다. 외부 함수 addDomain과 removeDomain으로 쓰고 checkDomain으로 조회합니다. checkDomain은 eTLD+1 문자열을 받아 연결되어 있으면 true, 아니면 false를 반환합니다. 도메인이 추가되거나 제거될 때 AddDomain, RemoveDomain 이벤트를 낼 수 있는데(선택 사항), 클라이언트가 어떤 도메인이 연결됐는지 미리 모를 때 이벤트로 전체 목록을 알아내는 데 유용합니다. 이 ERC의 구현 자체는 어떤 컨트랙트든 선택적으로 할 수 있습니다.
클라이언트 검증 절차
클라이언트가 eTLD+1에서 호환 TXT 레코드를 발견하면, 나열된 각 컨트랙트 주소에 대해 RPC로 checkDomain에 그 eTLD+1 문자열을 넣어 true가 나오는지 확인해야 합니다. 반대로 이 ERC를 구현한 컨트랙트를 조사하는 경우에는 AddDomain과 RemoveDomain 이벤트를 훑어 현재 연결된 도메인을 계산하고 그 도메인들의 TXT 레코드를 가져와 연결을 검증해야 합니다. 이때 컨트랙트 주소가 해당 eTLD+1의 TXT 레코드 VALUE에 들어 있는지 반드시 확인해야 합니다. 즉 DNS에서 출발하든 컨트랙트에서 출발하든 양쪽 기록이 맞아야 통과합니다.
보안 모델: 두 독립 기록의 교차 확인
HOST 이름 규칙은 이메일 서명 표준인 DKIM의 명명 관례를 본떴고 ERC-7529를 앞에 붙여 다른 TXT 레코드와의 이름 충돌을 막습니다. 검증에서는 DNS와 블록체인이라는 독립된 두 정보원이 서로 일치하는지 교차 확인합니다. addDomain과 removeDomain이 제대로 인증되어 있다면 domains의 값은 컨트랙트 통제자만 쓸 수 있고 TXT 레코드의 주소는 eTLD+1 소유자만 넣을 수 있습니다. 두 값이 일치하려면 같은 조직이 두 자원을 모두 통제해야 하므로, 연결이 검증되면 그 컨트랙트는 도메인 주인의 것이라고 볼 수 있습니다.
참조 구현과 접근 제어
참조 구현에서 checkDomain은 keccak256(abi.encodePacked(domain))으로 해시를 만들어 domains 매핑을 조회합니다. addDomain은 같은 해시 키에 true를 쓰고 AddDomain 이벤트를 내며 removeDomain은 연결이 있는지 require로 확인한 뒤 false로 바꾸고 RemoveDomain 이벤트를 냅니다. 두 쓰기 함수에는 반드시 적절한 계정 인증을 붙여 승인된 사용자만 domains를 바꿀 수 있게 해야 합니다. 참조 구현은 OpenZeppelin 접근 제어 추상 클래스의 onlyRole 수식어로 DEFAULT_ADMIN_ROLE 계정에만 호출을 허용합니다.
제안 상태
이 ERC는 2023년 9월 30일에 만들어졌고 현재 상태가 Draft입니다. 아직 확정되지 않은 초안이므로 명세의 세부 내용이 바뀔 수 있습니다. ERC-1191을 전제 조건으로 참조합니다.
쓸 때 주의할 점
- DNS 자체에 대한 공격: 전통적인 DNS 시스템에 의존하므로 도메인 하이재킹 같은 DNS 대상 공격에 취약합니다.
- 쓰기 함수의 인증 책임: addDomain과 removeDomain의 인증은 컨트랙트 작성자의 책임입니다. 인증이 없으면 공격자가 자기 컨트랙트를 엉뚱한 도메인과 연결해 정상적인 도메인 연결 검증을 깨뜨릴 수 있습니다.
- 거짓 검증의 난이도: 공격자가 어떤 컨트랙트를 특정 도메인의 것처럼 거짓 검증시키려면 DNS 설정과 스마트 컨트랙트 양쪽을 모두 장악해야 합니다. 그 정도라면 해당 회사의 이메일 도메인까지 이미 침해되었을 가능성이 큽니다.