🇰🇷 CIP-0068 (데이텀 메타데이터 표준)

[CryptoVeri]

CIP	제목	저자	주석-URI	단계	유형	생성	포스트 히스토리	라이선스
68	데이텀 메타데이터 표준	알레산드로 콘라드 alessandro.konrad@live.de, 토마스 벨레쿠프 thomas.vellekoop@iohk.io		제안	정보 제공	2022-07-13		CC-BY-4.0

개요

이 제안은 NFT뿐만 아니라 모든 자산 클래스에 대한 출력 데이텀을 사용하는 네이티브 자산에 대한 메타데이터 표준을 정의합니다.

동기

이 제안은 CIP-0025의 몇 가지 단점을 다룹니다.

• 프로그래밍 가능성의 부족;
• 메타데이터 업데이트/개선의 어려움;
• Plutus 밸리데이터 내에서 검사할 수 없는 메타데이터…

이러한 단점 외에도 CIP-0025는 몇 가지 설계상의 결함이 있습니다. CIP-0025를 모르는 사람들이나 다른 방식으로 민팅(minting)을 하려는 사람들, 또는 다른 메타데이터 형식/메커니즘을 사용하고자 하는 경우, 이 표준이 이미 대부분의 플랫폼에서 기본적으로 메타데이터를 해석하기 때문에 메타데이터 스푸핑(spoofing, 위장)에 대한 프로토콜을 열어놓게 됩니다. 이 표준은 프로토콜 레벨에서 강제로 적용되지 않으므로, 모두가 이를 인식하거나 규칙을 따르지 않을 가능성이 있습니다. 동시에, 모든 사람들이 CIP-0025의 규칙을 따르도록 강제한다면, 원장의 능력을 제한하고 제약을 가하게 됩니다.

이 표준은 이러한 문제들을 해결하고 NFT뿐만 아니라 그 이후 나타날 수 있는 모든 자산 클래스에 대한 많은 장점을 제공합니다. 또한, 이 CIP는 지갑과 같은 제3자가 해당 토큰의 종류를 쉽게 파악할 수 있는 방법을 소개할 것입니다.

명세

고려 사항

기본적인 아이디어는 두 개의 자산을 발행하는 것이며, 한 자산은 다른 자산을 참조합니다. 이 두 가지를 참조 NFT(reference NFT) 및 사용자 토큰(user token)이라고 합니다. 여기서 사용자 토큰은 전송 가능하고 모든 값을 나타내는 NFT, FT 또는 기타 자산 클래스일 수 있습니다. 따라서 사용자 토큰은 사용자의 지갑에 있는 실제 자산입니다.

사용자 토큰에 대한 메타데이터를 찾으려면 참조 NFT가 잠겨 있는 출력을 찾아야 합니다. 이것이 구체적으로 어떻게 이루어지는지는 아래에서 명확해질 것입니다. 또한 이 출력에는 메타데이터를 저장하는 데이텀이 포함되어 있습니다. 이 접근 방식의 장점은 자산 발행자가 참조 NFT가 있는 트랜잭션 출력을 잠그고 추가로 처리하는 방법을 결정할 수 있다는 것입니다. 발행자가 완전한 불변 메타데이터를 원하는 경우, 참조 NFT를 소비할 수 없는 스크립트(unspendable script)의 주소에서 잠글 수 있습니다. 마찬가지로, 발행자가 NFT/FT를 개선시키기를 원하거나 메타데이터를 업데이트하기 위한 메커니즘을 원하는 경우, 발행자가 결정하는 임의의 로직으로 참조 NFT를 스크립트 주소에서 잠글 수 있습니다.

마지막으로, 가장 중요한 것은 이 구성을 사용하면 참조 입력 CIP-0031을 사용하여 PlutusV2 스크립트에서 메타데이터를 사용할 수 있다는 것입니다. 이는 토큰 영역에서 더 큰 혁신을 촉진할 것입니다.

레이블

각 자산 이름에는 레이블이 접두어로 추가되어야 합니다. 이 레이블의 의도는 토큰의 목적을 식별하는 것입니다. 예를 들어 참조 NFT는 레이블 100으로 식별되므로 참조 NFT로 간주되는 모든 토큰은 16진수 000643b0로 자산 이름을 시작해야 합니다. 이것은 레이블 접두어의 형식을 지정하는 CIP-0067을 따릅니다.

자산 이름의 예:

asset_name_label	asset_name_content	resulting_label_hex	resulting_content_hex	resulting_asset_name_hex
100	GenToken	000643b0	47656e546f6b656e	000643b047656e546f6b656e
100	NeverGonna	000643b0	4e65766572476f6e6e61	000643b04e65766572476f6e6e61
222	GiveYouUp	000de140	47697665596f755570	000de14047697665596f755570

단순화를 위해, 이 문서에서는 레이블 (100) 또는 (<label>)을 사용할 것이지만, CIP-0067 명세를 따라야 함을 이해해주세요.

참조 NFT 레이블

이는 등록된 asset_name_label 값입니다.

asset_name_label	클래스	설명
100	NFT	데이텀이 포함된 스크립트에서 잠긴 참조 NFT

제약 및 조건

사용자 토큰과 참조 NFT 간 올바른 관계를 위해 몇 가지 조건이 충족되어야 합니다.

• 사용자 토큰과 참조 NFT는 동일한 정책 ID(policy ID) 아래에 있어야 합니다.
• 특정 사용자 토큰에 대해 정확히 하나의 참조 NFT가 존재해야 합니다.
• 사용자 토큰과 관련된 참조 NFT는 표준 네이밍 패턴을 따라야 합니다. 각각의 자산 이름은 해당 asset_name_label로 시작하고 자산 클래스가 정의한 패턴이 이어져야 합니다. (예: asset_name_label 222)

위의 내용에 대해 몇 가지 언급하자면 다음과 같습니다.

1. 사용자 토큰과 참조 NFT는 같은 트랜잭션에서 발행될 필요는 없습니다. 발행 순서도 중요하지 않습니다.
2. 동일한 참조 NFT를 참조하는 여러 사용자 토큰(여러 자산 이름 또는 수량이 1보다 큰 경우)이 존재할 수도 있습니다.

참조 NFT가 있는 출력의 데이텀에는 생성자 0의 첫 번째 필드에 메타데이터가 포함됩니다. 이 생성자(constructor)의 두 번째 필드에는 버전 번호가 있습니다. 세 번째 필드는 임의의 plutus 데이터가 허용됩니다. 이는 plutus 스크립트에 관련 데이터를 전달하는 데 유용할 수 있습니다.

big_int = int / big_uint / big_nint
big_uint = #6.2(bounded_bytes)
big_nint = #6.3(bounded_bytes)

metadata =
  { * metadata => metadata }
  / [ * metadata ]
  / big_int
  / bounded_bytes
  
version = int

; Custom user defined plutus data.
; Setting data is optional, but the field is required
; and needs to be at least Unit/Void: #6.121([])
extra = plutus_data

datum = #6.121([metadata, version, extra])

222 NFT 표준

이 CIP에서는 참조 NFT에 필요한 표준 외에 두 개의 특정 토큰 표준을 소개합니다. 여기서 가능성은 무한하며 FT, 다른 NFT, 반 대체 가능 토큰(semi fungible tokens) 등에 대한 더 많은 표준을 이 CIP 위에 구축할 수 있습니다. 첫 번째는 등록된 asset_name_label 접두어 값으로 시작하는 222 NFT 표준입니다.

asset_name_label	클래스	설명
222	NFT	CIP-0025 내부 구조를 활용하여 사용자 지갑에 보유된 NFT

클래스

user token은 NFT(대체 불가능한 토큰)를 나타냅니다 .

패턴

사용자 토큰과 참조 NFT는 asset_name_label prefix로 시작하는 동일한 이름을 가져야합니다.

예:
user token : (222)Test123
reference NFT :(100)Test123

메타데이터

이는 CIP-0025 구조를 따르는 메타데이터의 저수준 표현입니다. UTF-8 인코딩된 모든 키 및 값은 온체인 데이텀을 생성할 때 각각의 바이트 표현으로 변환해야 합니다.

files_details = 
  {
    ? name : bounded_bytes, ; UTF-8
    mediaType : bounded_bytes, ; UTF-8
    src : bounded_bytes ; UTF-8
    ; ... Additional properties are allowed
  }

metadata = 
  {
    name : bounded_bytes, ; UTF-8
    image : bounded_bytes, ; UTF-8
    ? mediaType : bounded_bytes, ; UTF-8
    ? description : bounded_bytes, ; UTF-8
    ? files : [* files_details]
    ; ... Additional properties are allowed
  }
  
; Custom user defined plutus data.
; Setting data is optional, but the field is required
; and needs to be at least Unit/Void: #6.121([])
extra = plutus_data

datum = #6.121([metadata, 1, extra]) ; version 1

JSON 형식의 데이텀 예:

{"constructor" : 0, "fields": [{"map": [{"k": "6E616D65", "v": "5370616365427564"}, {"k": "696D616765", "v": "697066733A2F2F74657374"}]}, {"int": 1}]}

제3자의 메타데이터 조회

제3자가 조회하려는 NFT가 d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(222)TestToken이라고 할때, 다음 단계를 따릅니다.

1. 사용자 토큰으로부터 참조 NFT를 구성합니다: d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(100)TestToken
2. 참조 NFT를 찾아서 이 NFT의 잠긴 출력을 찾습니다.
3. 출력에서 데이텀을 가져와서 생성자 0의 첫 번째 필드로 들어가서 메타데이터를 조회합니다.
4. JSON으로 변환하고 가능한 경우 모든 문자열 항목을 UTF-8로 인코딩합니다. 그렇지 않으면 16진수로 남겨둡니다.

Plutus 밸리데이터에서 메타데이터 조회

우리는 플루투스 밸리데이터 컨텍스트에서 NFT d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(222)TestToken의 메타데이터를 가져오고자 합니다. 이를 위해 다음과 같이 합니다.

1. 사용자 토큰에서 참조 NFT를 구성합니다. : d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(100)TestToken (오프체인)
2. 참조 NFT를 찾아 그 NFT의 잠긴 출력을 찾습니다. (오프체인)
3. 트랜잭션에서 해당 출력을 참조합니다. (오프체인)
4. 참조 NFT와 사용자 토큰의 정책 ID 및 자산 이름(단, asset_name_label 접두어 제외)이 일치하는지 확인하여 참조된 출력의 데이텀이 유효한지 검증합니다. (온체인)

333 NFT 표준

두 번째 소개된 표준은 asset_name_label 접두어 값으로 등록된 333 FT 표준입니다.

asset_name_label	클래스	설명
333	FT	카르다노 재단 오프체인 레지스트리 내부 구조를 활용한 사용자 지갑에 보유된 FT

클래스

user token은 FT(대체 가능 토큰)입니다.

패턴

사용자 토큰과 참조 NFT는 asset_name_label 접두어로 시작하는 동일한 이름을 가져야합니다.

예:
user token : (333)Test123
reference NFT :(100)Test123

메타데이터

이는 카르다노 재단 오프체인 메타데이터 레지스트리 구조를 엄격히 따르는 메타데이터의 저수준 표현입니다. 모든 UTF-8 인코딩 된 키와 값은 온체인 데이텀을 생성할 때 해당하는 바이트 표현으로 변환되어야 합니다.

; Explanation here: https://developers.cardano.org/docs/native-tokens/token-registry/cardano-token-registry/

metadata = 
  {
    name : bounded_bytes, ; UTF-8
    description : bounded_bytes, ; UTF-8
    ? ticker: bounded_bytes, ; UTF-8
    ? url: bounded_bytes, ; UTF-8
    ? logo: uri,
    ? decimals: int
    ; ... Additional properties are allowed
  }

; A URI as a UTF-8 encoded bytestring.
; The URI scheme must be one of `https`, `ipfs` or `data`
; Do not encode plain file payloads as URI.
; 'logo' does not follow the explanation of the token-registry, it needs to be a valid URI and not a plain bytestring.
; Only use the following media types: `image/png`, `image/jpeg`, `image/svg+xml`
uri = bounded_bytes

; Custom user defined plutus data.
; Setting data is optional, but the field is required
; and needs to be at least Unit/Void: #6.121([])
extra = plutus_data
  
datum = #6.121([metadata, 1, extra]) ; version 1

JSON 형식의 데이텀 예:

{"constructor" : 0, "fields": [{"map": [{"k": "6E616D65", "v": "5370616365427564"}, {"k": "6465736372697074696F6E", "v": "54686973206973206D79207465737420746F6B656E"}]}, {"int": 1}]}

제3자의 메타데이터 조회

제3자가 조회하려는 FT d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(333)TestToken에 대해, 다음과 같은 단계를 거쳐 조회할 수 있습니다.

1. 사용자 토큰에서 참조 NFT 구성합니다.: d5e6bf0500378d4f0da4e8dde6bec7621cd8cbf5cbb9b87013d4cc.(100)TestToken
2. 참조 NFT를 찾아 잠겨 있는 출력을 찾습니다.
3. 출력에서 데이텀을 가져오고 생성자 0의 첫 번째 필드로 들어가 메타데이터를 찾습니다.
4. JSON으로 변환하고 가능하면 모든 문자열 항목을 UTF-8로 인코딩합니다. 그렇지 않으면 16진수로 유지합니다.

Plutus 밸리데이터에서 메타데이터 조회

플루투스 밸리데이터 컨텍스트에서 FT d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(333)TestToken의 메타데이터를 가져 오려고 합니다. 이를 위해 다음을 수행합니다.

1. 사용자 토큰에서 참조 NFT를 구성합니다 : d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc.(100)TestToken (오프체인)
2. 참조 NFT를 찾아 잠겨 있는 출력을 찾습니다. (오프체인)
3. 트랜잭션에서 출력을 참조합니다. (오프체인)
4. 참조 NFT 및 사용자 토큰의 정책 ID와 asset_name_label 접두어가 없는 해당 자산 이름이 일치하는지 확인하여 참조된 출력의 데이텀이 유효한지 검증합니다. (온체인)

근거

참조 NFT와 사용자 토큰을 분리하지 않으면 모든 유연성을 잃게 되며, 사용자 토큰을 이동하는 것이 매우 번거로울 것입니다. 새로운 출력으로 사용자 토큰을 보내기 위해 매번 메타데이터를 추가해야하기 때문입니다. 따라서 메타데이터와 사용자 토큰을 분리하고 메타데이터를 다른 UTxO 안에 잠그면 사용자 토큰을 자유롭게 이동할 수 있습니다.

메타데이터가 포함된 올바른 UtxO를 참조하려면, 인증을 받아야 합니다. 그렇지 않으면 메타데이터 스푸핑 공격이 가능해집니다. 이를 달성하는 한 가지 방법은 UtxO에 NFT(참조 NFT)를 추가하는 것입니다. 이 NFT는 사용자 토큰과 동일한 정책 ID 아래에서 표준에 정의된 자산 이름 패턴을 따라야 합니다. 이렇게 하면 추가 데이터 없이 참조 NFT와 사용자 토큰 간에 안전한 링크를 생성할 수 있으며 이 오프체인 및 온체인을 활용할 수 있습니다.

링크에 대한 보안은 민팅 정책 자체에서 파생되므로, 이 CIP는 최대한 높은 유연성을 유지하기 위해 인터페이스만 정의하므로 올바른 제약 사항과 규칙을 가진 밸리데이터를 작성하는 것이 중요합니다.

하위 호환성

향후 변경 사항과 메타데이터 호환성을 유지하기 위해, 데이텀에 version 필드를 도입합니다.

활성 방안

• CIP-0067의 자산 이름 레이블에 대한 바이너리 인코딩에 동의.
• 지갑, 탐색기, 도구, 민팅 플랫폼 및 기타 제3자로부터 이 CIP에 대한 지원 받기.
• Lucid (오프체인), PlutusTx (온체인)를 활용한 최소한의 참조 구현: 구현
• 이 CIP를 사용하는 보다 실용적인 오픈소스 구현/프로젝트.

참조

• CIP-0025: CIPs/CIP-0025 at master · cardano-foundation/CIPs · GitHub
• CIP-0031: CIPs/CIP-0031 at master · cardano-foundation/CIPs · GitHub
• CIP-0067: CIPs/CIP-0067 at master · cardano-foundation/CIPs · GitHub

저작권

이 CIP는 CC-BY-4.0 라이선스에 따라 공개됩니다 .

---

* 원문: CIPs/CIP-0068 at master · cardano-foundation/CIPs · GitHub