ERC-7508 동적 온체인 토큰 속성 저장소 (Dynamic On-Chain Token Attributes Repository)

Draft · NFT·멀티토큰 · 2023-08-15 작성

ERC-721·ERC-1155 토큰의 속성을 모든 네트워크에서 같은 주소를 쓰는 공용 저장소 컨트랙트에 온체인으로 기록해 어떤 외부 컨트랙트든 그 속성을 조회하고 활용할 수 있게 합니다.

왜 필요한가

NFT는 흔히 이미지나 능력치 같은 속성을 오프체인 메타데이터 서버에 저장합니다. 이 방식에서는 서버가 내려가면 속성이 영원히 사라지고 다른 게임이나 서비스가 이 속성을 쓰려면 신뢰할 수 없는 외부 URL을 그대로 믿고 가져와야 합니다. 또한 토큰 컨트랙트마다 속성을 저장하는 방식이 제각각이라, 한 컬렉션의 캐릭터 능력치를 다른 컬렉션이나 게임에서 그대로 활용하기 어렵습니다. 토큰이 소유자의 행동에 따라 진화하거나 상태가 바뀌는 기능을 만들고 싶어도, 표준화된 온체인 저장소가 없으면 컬렉션마다 속성 관리와 접근 제어 코드를 처음부터 새로 만들어야 하고 이는 배포 비용과 컨트랙트 복잡도를 늘립니다.

심층 설명

접근 제어 구조(AccessType)

레포지토리는 속성 키마다 다섯 가지 접근 유형 중 하나를 지정할 수 있습니다. Owner는 컬렉션 소유자만, Collaborator는 지정된 협업자만, OwnerOrCollaborator는 둘 중 누구나, TokenOwner는 해당 토큰의 소유자만, SpecificAddress는 별도로 지정한 주소만 값을 바꿀 수 있습니다. registerAccessControl로 컬렉션을 등록한 뒤 manageAccessControl로 키별 유형을 정하고 manageCollaborators로 협업자 목록을 관리합니다.

속성 타입과 키-값 저장

속성은 address, bool, bytes, int256, string, uint256 여섯 가지 타입으로 나뉘며 각각 {key, value} 구조체로 표현됩니다. 어떤 타입이든 컬렉션 주소와 토큰 ID, 문자열 키를 기준으로 값 하나가 매핑되고 값이 바뀌면 해당 타입 전용 Updated 이벤트가 발생합니다.

단일·배치 조회 및 설정

각 타입마다 getX/setX로 토큰 하나의 속성 하나를 다루는 함수와, getXs/setXs로 여러 컬렉션·여러 토큰에 걸쳐 한 번에 처리하는 배치 함수가 모두 제공됩니다. collections와 tokenIds 배열은 모든 항목이 같은 컬렉션이나 같은 토큰이면 원소 하나만 넣어도 됩니다. getAttributes/setAttributes는 여섯 타입을 한 번의 호출로 모두 조회·설정합니다.

프리사인 서명을 통한 대리 설정

prepareMessageToPresignXAttribute 함수로 서명할 원본 메시지를 얻고 사용자가 이 메시지에 ECDSA로 서명하면 다른 주소가 presignedSetXAttribute(v, r, s 포함)를 호출해 대신 속성을 설정할 수 있습니다. 메시지는 DOMAIN_SEPARATOR, 메서드별 TYPEHASH, collection, tokenId, key, value, deadline을 keccak256으로 묶어 만들며 deadline이 지난 서명은 거부됩니다.

컬렉션 단위 속성과 스키마

개별 토큰이 아니라 컬렉션 전체가 공유하는 속성은 토큰 ID로 uint256의 최댓값을 사용해 조회·설정합니다. 컬렉션 소유자는 각 속성에 대해 name, description, type, display_name, display_type, decimals, min_value, max_value, conditional_value, modifiers, multi_storage 필드를 가진 스키마를 정의할 수 있으며 이 중 name과 type만 필수입니다.

가스 절감을 위한 문자열 인덱싱과 사전 결정 주소

문자열은 저장 비용이 크기 때문에, 레포지토리는 같은 문자열 키나 값을 처음 저장하는 사람만 전체 비용을 지불하고 이후 사용자는 그 문자열의 인덱스만 저장하도록 설계되었습니다. 이 절감 방식은 레포지토리 전체에 적용되어 한 컬렉션이 이미 등록한 문자열을 다른 컬렉션이 써도 다시 비용을 치르지 않습니다. 레포지토리 컨트랙트는 'ATTBTS'를 연상시키는 0xA77B75로 시작하는 주소로 모든 네트워크에 같게 배포되도록 설계되었으며 정확한 주소는 미정입니다.

표준 상태

이 제안은 Draft 상태로, 아직 확정되지 않았으며 세부 내용이 바뀌거나 진행이 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs