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는 부여되지 않습니다.
editionNo와 tokenId는 무엇인가요?
editionNo는 메타데이터에서 지정할 수 있는 NFT edition에 대한 순서를 의미합니다. 단일 NFT 컨트랙트로 다른 종류의 메타데이터를 이용해 NFT를 민팅할 경우, tokenId는 민팅 순서에 따라 결정됩니다. 이러한 tokenId로는 동일한 edition 내에서의 순서를 나타내기 어렵기 때문에 editionNo라는 데이터를 이용하여 동일한 edition 간의 순서를 표현하고 있습니다. 이는 메타데이터 Field 중 maxMintLimit으로 해당 메타데이터를 이용해 최대 몇 개의 edition을 생성할 수 있는지 설정할 수 있습니다.
tokenId는 각 NFT마다 부여되는 고유한 식별자 값으로 해당 NFT 컨트랙트에서 민팅되는 순서로 결정됩니다. 최초로 민팅된 NFT의 tokenId는 1이며 이후 같은 컨트랙트에서 NFT를 민팅할 때 마다 1씩 증가하게 됩니다.
maxMintLimit을 지정한 후, 메타데이터를 업로드하면 editionNo 표기를 위해 자동으로 메타데이터의 name 뒤에 # editionNo / maxMintLimit(ex: NFT Name # 1/100) 값이 추가되어 저장됩니다. 이러한 값을 원하지 않는다면 메타데이터에서 maxMintLimit Field를 지우고 업로드하면 입력한 name 그대로 저장됩니다. maxMintLimit을 지정하지 않아도 tokenId를 지정하여 NFT를 생성할 수 있으며 tokenId 지정 생성은 NFT Minting API의 Body Params에서 설정할 수 있습니다.