post https://api.luniverse.io/svc/v2/nft/metadata
NFT 민팅에 앞서 토큰을 정의하는 Metadata를 생성하기 위한 API입니다.
Request Body의 image와 media 둘 중 어떤 필드를 사용해야 하나요?
미디어가 이미지 형식인경우 image필드에, 비디오 형식인 경우 media에 미디어 ID를 입력하세요. 두 필드 중 최소 하나의 필드가 입력되어야 합니다. image, media 두 필드를 모두 입력하는 경우 image필드의 값이 우선 처리됩니다.
maxMintLimit과 editionNo
maxMintLimit을 입력할 경우 최대 민팅 개수가 입력한 값으로 제한되며 하나의 metadata에 대해 민팅된 토큰 순서대로 editionNo가 추가됩니다. 단, 민팅 시 editionNo를 직접 입력할 경우 민팅 순서와 상관없이 editonNo를 부여할 수 있으며 이 경우 다음과 같은 규칙이 적용됩니다.
- editonNo는 maxMintLimit보다 큰 값을 입력할 수 없습니다.
- 중복을 허용하지 않습니다. (이미 민팅에 사용한 editionNo로 다시 민팅을 요청할 수 없습니다.)
- 직접 입력한 editionNo로 발행된 NFT가 있을때 editionNo를 입력하지 않고 민팅을 요청하면 현재 발행된 NFT중 가장 높은 editionNo + 1의 값이 editionNo로 할당됩니다. 만약 해당 값이 maxMintLimit을 넘어가는 경우 사용되지 않은 가장 낮은 editionNo이 할당됩니다.
- maxMintLimit이 입력되지 않았다면 개수 제한 없이 민팅할 수 있으며 editionNo가 부여되지 않습니다. 따라서 editionNo를 직접 입력하여 민팅 하여도 editionNo는 부여되지 않습니다.
Metadata의 생명 주기에 대하여
Metadata의 필드들은 생성 이후 실제 토큰으로 민팅되기 이전까지 수정이 가능합니다 (maxMintLimit 필드 제외). 특정 Metadata에 대 하나 이상의 NFT가 민팅되는 경우 Freeze되어 수정이 불가합니다.