ERC-7280 NFT 메타데이터 링크드 데이터 확장 (NFT Metadata Extension like JSON-LD)
Draft · 이름·메타데이터 · 2023-07-04 작성
NFT 메타데이터에 linked_data 키를 추가해 JSON-LD(링크드 데이터) 같은 구조화된 의미 데이터를 연결할 수 있게 하는 표준입니다.
왜 필요한가
ERC-721, ERC-1155 같은 NFT 표준의 기존 메타데이터 형식은 제한적이어서 구조화되고 의미가 분명한 데이터를 담을 방법이 없습니다. 이 NFT가 어떤 영상이고 어떤 음악인지 기계가 이해할 수 있는 형태로 적을 자리가 없으니, 검색엔진이 NFT 내용을 제대로 읽거나 다른 애플리케이션이 NFT 메타데이터를 데이터 소스로 쓰기 어렵습니다. 웹에서는 이런 문제를 JSON-LD라는 형식으로 풀어 왔지만 NFT 메타데이터에는 이를 담는 표준 위치가 없었습니다. 이 제안은 메타데이터 JSON에 linked_data라는 키를 더해 외부 스키마와 데이터를 연결할 수 있게 해 NFT 메타데이터의 풍부함과 상호운용성을 높이려 합니다. 복잡한 메타데이터 구조가 외부 스키마와 데이터로 연결되면, 여러 애플리케이션에서 NFT의 맥락과 활용도가 좋아집니다.
심층 설명
linked_data 키의 구조
JSON-LD 기반 메타데이터는 메타데이터 JSON의 새 키인 linked_data 아래에 저장합니다. linked_data는 객체의 배열이고 각 객체는 schema와 data 두 키를 가집니다. schema는 연결된 데이터의 스키마를, data는 연결된 데이터 자체를 나타내며 둘 다 MUST이고 타입은 object입니다. 배열이므로 하나의 NFT가 여러 linked_data 객체를 가질 수 있습니다. 참조 구현 예시는 VideoObject, MusicRecording, GoogleTravelImpactModel 세 객체를 동시에 담습니다.
schema 객체의 필드
schema 객체는 세 필드를 가집니다. uri는 MUST이고 string 타입으로 스키마의 URI입니다. name은 MUST이고 string 타입으로 스키마의 이름입니다. description은 OPTIONAL이고 string 타입으로 스키마에 대한 설명입니다. 즉 모든 linked_data 항목은 자신이 따르는 스키마의 위치와 이름을 반드시 밝혀야 합니다.
data 객체의 필드
data 객체는 네 필드를 가집니다. uri는 MUST이고 string 타입으로 데이터의 URI입니다. lang은 OPTIONAL이며 en-US 같은 IETF 언어 태그로 데이터의 언어를 적습니다. name과 description은 모두 OPTIONAL인 string으로 데이터의 이름과 설명입니다. 데이터 본문을 메타데이터 안에 직접 담는 대신 URI로 연결하는 구조입니다.
적용 대상과 하위 호환성
이 제안은 ERC-721, ERC-1155, ERC-3525 등 대체 불가능 토큰의 메타데이터 형식을 확장하며 requires로 세 표준을 참조합니다. 확장은 기존 구현과 하위 호환됩니다. linked_data 키를 포함하지 않은 NFT는 이전과 똑같이 동작하고 NFT 메타데이터를 소비하는 기존 애플리케이션도 영향을 받지 않습니다. 하드포크 없이 메타데이터 JSON에 키 하나를 더하는 방식이기 때문입니다.
설계 의도: 검색 노출과 상호운용성
NFT를 위한 일반적인 웹페이지를 만들 때, 이 확장이 있으면 HTML 헤더 태그에 JSON-LD를 넣는 일이 훨씬 단순해집니다. linked_data 배열에서 JSON-LD 호환 값의 uri를 찾아 가져온 뒤 그 내용을 헤더에 삽입하면 됩니다. 이렇게 하면 NFT 발행자가 예를 들어 구글 검색 결과에 표시되는 모습을 제어할 수 있습니다. 더 일반적인 상호운용성 측면에서는, 어떤 스키마와 데이터든 포함할 수 있으므로 NFT 메타데이터가 어떤 애플리케이션의 데이터 소스로도 쓰일 수 있고 스키마가 있어 구현이 쉬워집니다.
참조 구현 예시가 보여 주는 활용
예시 메타데이터는 서로 다른 스키마를 가진 세 linked_data 객체를 담습니다. 첫째 VideoObject 데이터는 HTML 헤더의 JSON-LD로 쓰여 구글 검색 결과의 리치 스니펫을 만들 수 있습니다. 둘째 MusicRecording 데이터는 schema.org의 스키마를 기반으로 하지만 리치 스니펫은 만들지 못합니다. 셋째 GoogleTravelImpactModel 데이터는 구글 여행 영향 모델 전용 스키마입니다. 원문은 이처럼 어떤 스키마와 데이터든 이 표준으로 포함할 수 있다는 점을 강조합니다.
제안 상태
이 제안은 2023년 7월 4일에 만들어졌고 현재 상태는 Draft입니다. 아직 확정되지 않은 초안 단계이므로, 내용이 바뀌거나 진행이 멈출 수 있습니다. 구현 전에 최신 원문을 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 외부 소스 메타데이터의 안전한 처리: 원문은 이 확장이 NFT와 링크드 데이터에 이미 적용되는 것 외의 추가 보안 고려사항을 만들지 않는다고 밝힙니다. 다만 구현은 외부 소스에서 가져온 메타데이터를 안전하게 처리하고 검증하는 모범 사례를 따라야 합니다.