메타데이터 규격

Metadata API를 이용하기 전에 각 플랫폼에 따라 어떤 프로퍼티를 추가할 수 있는지 확인하는 것이 좋습니다. 플랫폼마다 반영되는 프로퍼티가 다르므로 메타데이터 규격에 맞지 않는 프로퍼티를 추가할 필요가 없습니다.

이 예제에서는 Metadata API를 이용할 때 참고할 메타데이터 규격과 업로드한 메타데이터(Metadata)가 각 플랫폼에서 어떻게 보이는지 설명하겠습니다.

OpenSea

프로퍼티 종류

OpenSea에서 지원하는 프로퍼티 설명은 다음과 같습니다.

• name: 아이템 이름입니다.

• description: 아이템 설명입니다.

• image: 아이템에 사용할 이미지 URL 주소입니다.

• image_data: raw SVG 이미지 데이터입니다. (image 필드 없을 때만 사용)

• attributes: 발행할 아이템 속성값들이 담긴 object 배열입니다.

• external_url: 플랫폼 외부로 연결되는 URL 주소입니다.

• animation_url: 아이템에 사용할 동영상 URL 주소입니다. 지원하는 파일 확장자는 .mp4입니다.

• background_color: OpenSea에서 토큰의 배경색입니다. 16진수 6자리 문자열(six-character hexadecimal)로 표시합니다.

• youtube_url: 유튜브 비디오 주소입니다.

OpenSea 메타데이터 기준에 관한 자세한 내용 Metadata Standard에서 확인하세요.

구조와 예시

OpenSea에서 지원하는 프로퍼티 종류에 맞춰 다음과 같은 메타데이터를 작성할 수 있습니다. 아래 예시에서는 animation_url과 youtube_url 없이 image만 포함했습니다.

{
  "metadata": {
    "name": "KAS logo",
    "description": "KAS logo metadata with image only",
    "image": "https://metadata-store.klaytnapi.com/6e9599eb-f980-1c07-f3e5-8a1381034661/68ed90c3-09cd-2065-efe2-bea4888207d8.png",
    "background_color": "#000000",
    "external_url": "https://www.klaytnapi.com/ko/landing/main",
    "animation_url": "",
    "youtube_url" : "",

     "attributes": [
      {
        "trait_type": "작가명",
        "value": "Sunny"
      },
      {
        "trait_type": "출생 연도",
        "value": "비공개"
      },
      {
        "trait_type": "작가 이력",
        "value": "취미 작가입니다. "
      },
      {
        "trait_type": "작가 인사말",
        "value": "KAS의 로고입니다!!"
      }
    ]
  }
}

위의 메타데이터 예시로 만든 토큰을 발행했을 때 OpenSea에서 실제로 어떻게 보이는지 확인해보겠습니다. 메타데이터에 포함된 image 파일이 아래와 같이 대표 이미지로 나타나는 것을 알 수 있습니다.

만약 animation URL이 들어갈 경우 animation이 대표 이미지가 됩니다. youtube URL이 들어갈 경우에는 대표 이미지를 눌러보면 해당 유튜브 URL이 재생됩니다.

OpenSea에서의 메타데이터 예시

위와 같이 메타데이터의 특정 필드가 각 위치에 표시됩니다. attributes 배열에 담긴 속성값은 Properties 아래에서 확인해 보세요.