ERC-8127 사람이 읽는 토큰 식별자 (Human Readable Token Identifiers)

Draft · 이름·메타데이터 · 2026-01-14 작성

토큰을 별칭.토큰ID@레지스트리 형태의 문자열 하나로 식별하는 형식을 정합니다. 사람이 읽기 쉬운 별칭을 붙이면서도 토큰 ID와 레지스트리 주소로 전 세계에서 유일하게 토큰을 가리킬 수 있습니다.

왜 필요한가

NFT, 실물자산(RWA), 자율 에이전트처럼 토큰으로 발행되는 자산이 늘어나면서 이를 일관되게 가리키고 참조할 방법이 필요해졌습니다. 그런데 지금까지는 사람이 읽을 수 있는 별칭(alias)을 붙여 여러 레지스트리의 토큰을 식별하는 공통 형식이 없었습니다. 숫자로만 된 토큰 ID는 사람이 어떤 자산인지 알아보기 어렵습니다. 기존의 자산 식별 방식은 체인과 컨트랙트 정보가 문자열 앞부분을 차지해 사용자가 가장 궁금해하는 자산 ID가 읽기 어려운 끝부분으로 밀려납니다. 또 시스템은 별칭이 있는 토큰 여러 개를 다루면서도 온체인 등록에 묶인 전 세계적으로 유일한 식별자를 함께 제공해야 합니다. 이 표준은 선택적 별칭, 온체인 토큰 ID, 레지스트리 위치를 하나의 해석 가능한 문자열로 묶어 이 문제를 해결합니다.

심층 설명

토큰 식별자 형식

토큰 식별자는 [<alias>.]<token-id>@<registry> 구조의 문자열입니다. token-id와 registry는 완전한 식별자에 필수(REQUIRED)이고 alias는 선택입니다. 별칭은 대소문자를 구분하지 않고 처리하며 유효한 레이블이어야 합니다. 즉 소문자(a-z), 숫자(0-9), 하이픈(-)만 쓸 수 있고 하이픈으로 시작하거나 끝나면 안 됩니다. 사용성을 위해 별칭을 넣는 것이 권장(SHOULD)되지만 유일성은 토큰 ID가 보장하므로 서로 다른 토큰이 같은 별칭을 써도 됩니다. 전체 토큰 식별자는 토큰 ID, 레지스트리와 결합했을 때 유효한 URI를 이뤄야 합니다. 별칭은 레지스트리의 메타데이터 필드에서 가져올 수 있는데, 예를 들어 ERC-8004 같은 에이전트 레지스트리의 name 필드를 쓸 수 있습니다. 별칭은 식별에 꼭 필요하지 않으므로 클라이언트가 스스로 붙일 수도 있습니다.

token-id와 registry의 규칙

token-id는 ERC-721이나 ERC-6909 같은 온체인 레지스트리의 숫자 토큰 ID입니다. 토큰의 1차 식별자이며, 지정된 레지스트리에 실제로 존재하는 토큰에 대응하는 음이 아닌 정수여야 하고(MUST) 10진수 문자열로 표기합니다. registry는 토큰 레지스트리 컨트랙트의 ERC-7930 상호운용 주소로, 체인 ID와 컨트랙트 주소를 모두 담습니다. 소문자 16진수 문자열로 표기해야 합니다(MUST). 예: 0x00010000010114d8da6bf26964af9d7eed9e03e53415d37aa96045. 이 형식은 ERC-1155나 ERC-6909처럼 한 레지스트리 컨트랙트가 여러 토큰 ID를 발행하는 멀티토큰 레지스트리에서 특히 유용하며 클라이언트는 neo.145@... 같은 토큰별 별칭을 보여 줄 수 있습니다.

해석 규칙

시스템은 상황에 따라 식별자의 일부만으로도 토큰을 찾을 수 있습니다. 별칭이 모두 유일한 토큰 목록이라면 webdev처럼 별칭만으로 충분합니다. 토큰 수가 늘어나면 punk.2344, agent.235234처럼 별칭과 토큰 ID를 함께 요구할 수 있습니다. 토큰이 여러 레지스트리에 걸쳐 있으면 레지스트리 주소까지 포함한 전체 식별자가 유일한 토큰을 완전하게 지정합니다. 별칭 없이 35523423@0x0001... 같은 토큰 ID와 레지스트리 주소의 조합만으로도 토큰을 유일하게 식별하기에 충분합니다.

정규형

정규형은 [<alias>.]<token-id>@<registry>이며, token-id와 registry는 항상 있고 별칭은 있을 때 포함하며 전체를 소문자로 씁니다. 구현은 표시와 전송에 정규형을 쓰는 것이 좋습니다. 원문의 예시는 별칭이 있는 webdev.42@0x00010000010114d8da6bf26964af9d7eed9e03e53415d37aa96045와 별칭이 없는 42@0x00010000010114d8da6bf26964af9d7eed9e03e53415d37aa96045입니다.

CAIP-19와의 비교

이 형식은 식별자를 사람이 온전히 읽을 수 있는 부분(<alias>.<token-id>)과 불투명한 위치 부분(@<registry>)으로 의도적으로 나눕니다. 일반적인 NFT, RWA, 에이전트 레지스트리에서 토큰 ID는 해시가 아니라 단순한 10진수라서 별칭과 토큰 ID 모두 읽기 쉬운 상태로 남습니다. 반면 CAIP-19 방식은 체인과 컨트랙트 정보를 불투명한 접두사로 앞에 두고 자산 ID를 끝에 둡니다. 예를 들어 크립토키티 토큰은 eip155:1/erc721:0x06012c8cf97bead5deae237070f9587f8e7a266d/771769처럼 표기되어, 사용자가 가장 관심 있는 자산 ID가 대부분 불투명한 위치 문자열의 끝으로 밀립니다. 이 ERC는 별칭과 토큰 ID를 앞에 두고 체인·컨트랙트 정보는 registry 요소로 옮겨, 읽고 말하고 복사하기 쉬우면서도 레지스트리와 결합하면 전 세계에서 유일한 식별자가 되게 합니다. RWA 시스템에서는 registry 부분을 알려진 RWA 레지스트리 목록과 대조해 검증하고, silver-bullion-bar.58348729 같은 부분은 소유자가 알아보고 신경 쓰는 이름으로 남길 수 있습니다.

별칭, ERC-7930, @를 고른 이유

별칭은 토큰 ID가 보장하는 유일성 위에 의미를 더해 토큰을 참조하기 쉽게 합니다. 별칭은 이식성도 있어서 한 시스템이 자산에 붙인 별칭을 다른 시스템에 그 자산에 대한 의미 힌트로 전달해 유용하게 쓸 수 있습니다(예: support-agent.3453). 레지스트리 표기에 ERC-7930을 쓰는 이유는 체인에 구애받지 않는 주소 인코딩을 제공하고 비EVM 체인과의 미래 호환성이 있기 때문입니다. 체인 ID를 포함하는 자기 서술적 형식이어서 체인 ID와 주소를 따로 두지 않고 한 필드로 처리할 수 있습니다. 구분자 @는 '~에 있는(at)'이라는 뜻이 통하고(레지스트리에 있는 토큰), 이메일 주소로 익숙하며, URL에서 유효하고, 토큰 식별 부분과 위치를 명확히 나눕니다.

하위 호환성과 제안 상태

이 ERC는 별칭만으로 토큰을 식별하던 기존 시스템과 하위 호환됩니다. .이나 @가 없이 별칭만 있는 식별자는 별칭으로 토큰을 찾습니다. 별칭만으로 찾은 결과가 여러 개로 겹치면 구현은 경고해야 합니다. 기존 시스템은 토큰 ID와 레지스트리 주소를 포함한 전체 식별자를 점진적으로 도입할 수 있습니다. 한편 이 제안은 2026년 1월 14일에 만들어진 Draft(초안) 상태여서 내용이 바뀔 수 있다는 점을 염두에 두어야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs