ERC-7632 이름 붙은 토큰 인터페이스 (Interfaces for Named Token)
Draft · 이름·메타데이터 · 2024-02-08 작성
토큰에 문자열 이름(tokenName)을 붙이고 이름과 숫자 ID(tokenId)를 서로 변환할 수 있게 하는 인터페이스 표준입니다. 마켓플레이스, 지갑, 앱이 이름 있는 토큰을 같은 방식으로 다루게 합니다.
왜 필요한가
지금의 토큰 표준은 각 토큰을 uint256 타입의 숫자 ID(tokenId)로만 구별합니다. 그래서 이름이 있는 NFT라도 마켓플레이스, 탐색기(Explorer), 지갑, 디파이(DeFi), 디앱(dApp)이 그 이름을 표준적인 방법으로 읽거나 다룰 수 없습니다. 컨트랙트마다 이름을 저장하고 숫자 ID와 연결하는 방식이 제각각이면, 이름으로 토큰을 찾거나 이름을 입력받아 동작하는 기능을 여러 서비스가 공통으로 만들기 어렵습니다. 이 표준은 이름(tokenName)과 숫자 ID(tokenId)를 서로 변환하는 공통 인터페이스와 동작 규칙을 정해 이름이 붙은 토큰을 어떤 서비스든 같은 방식으로 표시하고 조작할 수 있게 합니다.
구현해야 하는 것
function idToName(uint256 _tokenId) external view returns (string);: 토큰의 숫자 ID(tokenId)를 받아 그 토큰의 이름(tokenName)을 돌려줍니다.function nameToId(string memory _tokenName) external returns (uint256);: 토큰 이름을 받아 그에 대응하는 숫자 ID를 돌려줍니다.newName(uint256 indexed tokenId, string tokenName): 새 이름이 도입될 때 내보내도록 권장되는 이벤트로, 어떤 ID에 어떤 이름이 붙었는지 알립니다.function isValidTokenName(string memory _tokenName) external view returns (string);: 주어진 토큰 이름이 유효한지 확인하는 확장 인터페이스의 함수입니다.function normalizeTokenName(string memory _tokenName) external view returns (string memory);: 토큰 이름을 정해진 기준 형태로 정규화해 돌려주는 확장 인터페이스의 함수입니다.
심층 설명
두 가지 준수 방식: 인터페이스 구현 또는 기본 매핑
준수 컨트랙트는 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항은 문장이 완결되지 않은 채 남아 있습니다.
쓸 때 주의할 점
- 이름과 ID의 고유성 가정: 이 제안은 tokenName과 tokenId가 모든 토큰에서 고유하다고 가정합니다. 이 가정이 깨지면 이름과 ID의 매핑이 성립하지 않습니다.
- 정규화되지 않은 이름의 혼동 위험: 이름이 정규화되지 않으면 서로 다른 두 이름이 비슷하게 보여 사용자에게 혼동을 줄 수 있습니다. 고유하지 않은 tokenName을 허용하는 경우 개발자는 IERC_NamedTokenExtension을 써서 정규화 메커니즘을 선언해야 합니다.