ERC-7828 상호운용 이름 (체인 지정 주소 표기) (Interoperable Names)
Review · 이름·메타데이터 · 2024-11-27 작성
주소@체인 형태로 어느 체인의 주소인지까지 사람이 읽을 수 있게 적는 표기법입니다. 체인 이름을 ENS(이더리움 네임 서비스)로 조회해 alice.eth@ethereum 같은 표기가 가능해집니다.
왜 필요한가
이더리움 생태계는 메인넷과 똑같은 주소 형식을 쓰는 레이어2(L2) 체인이 수백 개, 나아가 수천 개로 늘어나는 방향으로 가고 있습니다. 주소만 봐서는 어느 체인의 주소인지 알 수 없고 그 결과 자금을 엉뚱한 체인의 닿을 수 없는 주소로 보낼 위험이 생깁니다. 앞선 표준인 ERC-7930이 특정 체인 위의 주소를 담는 이진 형식을 정의했지만 컨트랙트 같은 저수준 용도에 맞춘 것이라 사람에게는 의미가 통하지 않습니다. 또 체인 이름과 식별자의 대응표는 EIP-155 이후 체인 밖의 중앙화된 목록으로 관리돼 왔는데, 늘어나는 체인 수를 따라가지 못하고 신뢰할 수 있는 중앙 관리자에 의존하며 이더리움 계열이 아닌 체인은 지원하지 못하는 한계가 있습니다. 이 표준은 사람이 읽기 쉬운 체인 지정 주소 형식과, 체인 운영자가 자기 체인 정보를 직접 등록하는 온체인 레지스트리를 정의해 이 문제를 풉니다.
구현해야 하는 것
data(bytes32 node, string key) -> bytes: ENSIP-24 임의 데이터 해석 인터페이스입니다. ethereum.on.eth 같은 라벨 노드에 대해 interoperable-address 키로 호출하면 그 체인의 ERC-7930 상호운용 주소를 돌려줍니다.text(bytes32 node, string key) -> string: ENSIP-5 텍스트 레코드 인터페이스입니다. reverse.on.eth 노드에 대해 chain-label: 뒤에 상호운용 주소를 붙인 키로 호출하면 그 체인의 정본 라벨을 돌려줍니다.
심층 설명
이름의 기본 구조
상호운용 이름은 <address>@<chain>#<checksum> 형식입니다. <address>에는 ERC-7930이 정의한 대상 주소(raw 주소)나 wallet.ensdao.eth 같은 ENS 이름이 들어갑니다. <chain>에는 eip155:1처럼 CAIP-350이 정의한 체인 식별자 문자열이나, on.eth의 하위 도메인으로 등록된 사람이 읽을 수 있는 라벨(ethereum, base 등)이 들어갑니다. <checksum>은 선택 항목으로 대문자 16진수 8자입니다. 같은 주소를 0xFe89...44b7@eip155:1#80B12379로도, 0xFe89...44b7@ethereum#80B12379로도 쓸 수 있고 비트코인 메인넷 주소도 @bip122:0000...1e93 또는 @bitcoin으로 표기할 수 있습니다.
체크섬 계산 규칙
체크섬은 정본 ERC-7930 상호운용 주소의 ChainType, ChainReferenceLength, ChainReference, AddressLength, Address 필드를 이어 붙인 데이터에 Keccak-256 해시를 적용한 뒤 앞 4바이트를 16진수 8자(RFC 4648 Base16)로 적은 값입니다. Version 필드는 해시 대상에 포함하면 안 됩니다. 이진 형식의 버전이 올라가도 같은 이름이 계속 유효하도록 하기 위해서입니다. raw 대상 주소를 쓸 때는 체크섬이 선택이지만 권장(RECOMMENDED)되며 홈오글리프나 스푸핑 공격을 줄이는 데 도움이 됩니다. 반대로 ENS 이름에는 붙이지 않는 것이 좋습니다(SHOULD NOT). ENS 이름은 리졸버 동작에 따라 시간이 지나며 다른 주소로 해석될 수 있어 예전 체크섬이 맞지 않게 될 수도 있기 때문입니다. 클라이언트는 체크섬을 포함하거나 생략해 표시할 수 있고 입력도 양쪽 모두 받을 수 있습니다.
체인 라벨 해석: on.eth 네임스페이스
<chain>에 콜론(:)이 없으면 on.eth ENS 네임스페이스 아래의 라벨로 해석합니다. on.eth의 리졸버는 ENSIP-24(임의 데이터 해석)를 반드시 구현해야 하며 interoperable-address 키로 해당 체인의 ERC-7930 상호운용 주소를 돌려줍니다. 예를 들어 ethereum.on.eth의 interoperable-address 레코드를 조회하면 이더리움 메인넷을 나타내는 0x00010000010100이 반환되어야 합니다. 리졸버는 op.on.eth와 optimism.on.eth처럼 여러 라벨이 같은 데이터를 가리키는 별칭을 둘 수 있지만 데이터의 정본 표현은 하나여야 합니다.
역방향 조회: reverse.on.eth
이진 체인 식별자에서 라벨을 찾는 역방향 조회도 정의되어 있습니다. on.eth 리졸버는 ENSIP-5(텍스트 레코드)를 반드시 구현해야 하고 reverse.on.eth 네임스페이스에 대해 chain-label: 뒤에 ERC-7930 상호운용 주소를 붙인 키의 텍스트 레코드를 지원합니다. 예를 들어 chain-label:0x00010000010100을 조회하면 ethereum이 반환되어야 합니다. op와 optimism처럼 여러 라벨이 0x00010000010a00을 가리키더라도, 역방향 조회는 항상 정본 라벨인 optimism 하나를 돌려줍니다. 리졸버가 2단계 도메인 on.eth에 설정되므로 ENSIP-10(와일드카드 해석)도 고려해야 합니다.
주소 해석과 정규화
<address>에 점(.)이 있으면 ENS 이름으로 간주합니다. ENS는 DNS와 통합되어 있어 전통적인 도메인 이름도 .eth 이름과 마찬가지로 쓸 수 있습니다. ENS 이름은 <chain>이 가리키는 대상 체인을 고려해 ENS 해석 규격에 따라 반드시 해석해야 하며 관련 규격은 ENSIP-9(멀티체인 주소 해석), ENSIP-10(와일드카드 해석), ENSIP-11(EVM 호환 체인 주소 해석)입니다. raw 대상 주소이거나 ENS 해석이 끝난 주소는 해당 체인의 CAIP-350 프로필 규칙에 따라 직렬화합니다. 대소문자 차이 같은 여러 유효한 텍스트 표현이 하나의 정본 이진 형식으로 모이게 하여 체크섬 계산과 데이터 무결성을 일관되게 지키기 위해서입니다. 구현은 상호운용 이름과 ERC-7930 이진 형식 사이의 상호 변환 가능성을 반드시 유지해야 합니다.
왜 ENS와 온체인 레지스트리인가
ENS는 이미 자리 잡은 블록체인 신원 기본 요소로, 사람이 읽을 수 있는 이름을 체인별 주소로 해석해 주며 사용자와 구현자 모두에게 익숙합니다. 유연성과 하위 호환성을 위해 raw 대상 주소도 <address> 자리에 그대로 쓸 수 있게 허용합니다. 체인 이름과 식별자의 대응을 온체인 레지스트리로 옮기면 체인 운영자가 자기 체인 데이터를 직접 소유하게 되어, 늘어나는 체인 수에 대응하지 못하고 중앙 관리자에 의존하며 비EVM 체인을 지원하지 못하던 기존 오프체인 중앙 목록의 한계를 줄일 수 있습니다.
제안 상태
이 제안은 아직 검토(Review) 단계입니다. 확정된 표준이 아니므로 형식이나 해석 규칙 같은 세부 내용이 앞으로 바뀔 수 있습니다. 또한 이 표준은 ERC-7930과 EIP-155를 전제로 하며 자체 버전 체계 없이 ERC-7930의 버전 규칙을 따르므로 구현자는 사용하는 ERC-7930 버전을 최신으로 유지해야 합니다.
쓸 때 주의할 점
- 이름 정규화와 스푸핑: 구현자는 ENSIP-1과 ENSIP-15에 정의된 ENS 이름 정규화 규격을 반드시 고려해 비슷하게 생긴 글자를 바꿔치기하는 홈오글리프 공격이나 스푸핑 공격을 막아야 합니다.
- 주소 포이즈닝: <address>에 raw 대상 주소를 쓸 때는 비슷한 주소를 거래 내역에 심어 놓는 주소 포이즈닝 공격에 사용자가 계속 주의해야 합니다.
- 리졸버 변경 위험: ENS 해석은 이름마다 설정된 리졸버 컨트랙트에 의존합니다. 리졸버는 시간이 지나며 바뀔 수 있고 와일드카드 리졸버(ENSIP-10)는 동적인 데이터를 돌려줄 수 있습니다.