ERC-7632 이름 붙은 토큰 인터페이스 (Interfaces for Named Token)

Draft · 이름·메타데이터 · 2024-02-08 작성

토큰에 문자열 이름(tokenName)을 붙이고 이름과 숫자 ID(tokenId)를 서로 변환할 수 있게 하는 인터페이스 표준입니다. 마켓플레이스, 지갑, 앱이 이름 있는 토큰을 같은 방식으로 다루게 합니다.

왜 필요한가

지금의 토큰 표준은 각 토큰을 uint256 타입의 숫자 ID(tokenId)로만 구별합니다. 그래서 이름이 있는 NFT라도 마켓플레이스, 탐색기(Explorer), 지갑, 디파이(DeFi), 디앱(dApp)이 그 이름을 표준적인 방법으로 읽거나 다룰 수 없습니다. 컨트랙트마다 이름을 저장하고 숫자 ID와 연결하는 방식이 제각각이면, 이름으로 토큰을 찾거나 이름을 입력받아 동작하는 기능을 여러 서비스가 공통으로 만들기 어렵습니다. 이 표준은 이름(tokenName)과 숫자 ID(tokenId)를 서로 변환하는 공통 인터페이스와 동작 규칙을 정해 이름이 붙은 토큰을 어떤 서비스든 같은 방식으로 표시하고 조작할 수 있게 합니다.

구현해야 하는 것

심층 설명

두 가지 준수 방식: 인터페이스 구현 또는 기본 매핑

준수 컨트랙트는 tokenName과, tokenName과 tokenId 사이의 매핑을 반드시 지원해야 합니다(MUST). 방법은 두 가지입니다. 1a는 IERC_NamedTokenCore 인터페이스를 구현하는 것으로, idToName(uint256 _tokenId)이 이름을, nameToId(string memory _tokenName)이 ID를 돌려줍니다. 모든 준수 컨트랙트에 이 방식이 권장됩니다(RECOMMENDED). 1b는 IERC_NamedTokenCore를 구현하지 않는 경우로, 기본 매핑 규칙 uint256 tokenId = uint256(keccak256(tokenName))을 따를 수 있습니다(MAY). Rationale은 편의를 위해 기본 매핑을 허용하되, 유연성을 위해 컨트랙트가 자체 매핑 방식을 구현하는 것도 허용한다고 설명합니다.

양방향 단일 매핑 규칙과 newName 이벤트

IERC_NamedTokenCore를 구현하는 경우 tokenId와 tokenName은 양방향 단일 매핑이어야 합니다(MUST). 즉 tokenId가 존재하면 tokenName도 존재해야 하고 그 반대도 성립해야 하며 tokenId = nameToId(idToName(tokenId))와 tokenName = idToName(nameToId(tokenName))이 항상 참이어야 합니다. 또 새 이름이 도입될 때는 newName(uint256 indexed tokenId, string tokenName) 이벤트를 내보내는 것이 권장됩니다(RECOMMENDED).

ByName 대응 메서드

준수 컨트랙트에서 tokenId를 쓰는 모든 메서드는, 이름이 ByName으로 끝나는 대응 메서드를 두는 것이 권장됩니다(RECOMMENDED). 대응 메서드는 uint256 tokenId 타입의 모든 파라미터를 string memory tokenName으로 바꾼 것이며 그 동작은 원래 메서드와 반드시 일치해야 합니다(MUST). 이렇게 하면 숫자 ID 대신 이름을 직접 넣어 같은 기능을 쓸 수 있습니다.

확장 인터페이스 IERC_NamedTokenExtension

준수 컨트랙트는 추가로 IERC_NamedTokenExtension 인터페이스를 구현할 수 있습니다(MAY). isValidTokenName(string memory _tokenName)은 이름의 유효성을 확인하고 normalizeTokenName(string memory _tokenName)은 이름을 정규화한 결과를 돌려줍니다. Security Considerations는 고유하지 않은 tokenName을 허용하는 경우 개발자가 이 확장 인터페이스를 써서 정규화 메커니즘을 선언해야 한다고 적고 있습니다.

기존 토큰 표준과의 호환성

이 제안은 uint256 tokenId를 고유 식별자로 쓰는 기존 토큰 컨트랙트와 완전히 하위 호환됩니다. 기존 ID 체계를 바꾸지 않고 이름 기능을 얹는 구조이기 때문입니다. 머리말의 requires 항목에 따라 ERC-165(인터페이스 감지 표준)가 필요합니다.

초안(Draft) 단계의 제안

이 제안은 아직 초안(Draft) 상태입니다. 논의 과정에서 인터페이스와 규칙이 바뀔 수 있고 최종 표준으로 확정된 것이 아니라는 점을 감안해야 합니다. 실제로 원문의 Rationale 2항은 문장이 완결되지 않은 채 남아 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs