배포한 NFT 컨트랙트를 통해 NFT를 민팅하기 위한 API입니다. 미리 생성한 Metadata ID를 입력하여 민팅합니다.
Callback으로 어떤 데이터를 받을 수 있나요?
콜백의 구현과 관련한 전반적인 사항은, 여기 여기를 참조해주세요.
NFT 민팅 API에서 콜백 URL을 포함하여 민팅을 요청한 경우, 콜백 메시지로 다음과 같은 항목이 포함됩니다.
- 민팅이 완료 된 token의 정보 (메타데이터를 포함)
{
"result": true,
"data": {
"token": {
"id": "5681808314427448086",
"currencyCode": "lvs3",
"tokenId": "100",
"issuedTo": "0x404c1543eb3b64fb6721fd933e7fe8be267bcf42",
"transactionHash": "0x1af1a07283c3626df2afbcce9ed4cfb9f978d2a18653a3b9950c353f4ea16120",
"transactionStatus": "DEPLOYED",
"currentOwner": "0x404c1543eb3b64fb6721fd933e7fe8be267bcf42",
"lastTransactionHash": "0x1af1a07283c3626df2afbcce9ed4cfb9f978d2a18653a3b9950c353f4ea16120",
"editionNo": "6",
"metadata": {
"id": "4683872034417772061",
"name": "Luniverse7",
"createdBy": "richard",
"createdDate": "2022-04-08",
"image": "https://nft-cdn.luniverse.dev/public/3be02fcc-5e93-4f55-80d1-d4ff36db39e7_2022-04-08T07:29:54.394Z.jpeg",
"imageHash": "36b348e21457af324a98ee57988be07580cad6b688fe4218d8b1ab7b76f74444",
"thumbnail": "https://nft-cdn.luniverse.dev/public/3be02fcc-5e93-4f55-80d1-d4ff36db39e7_2022-04-08T07:29:54.394Z.jpeg",
"description": "Luniverse7 description",
"properties": [],
"editionMax": "100",
"createdAt": "2022-04-08T07:30:31.094Z"
},
"contractName": "luniverse3",
"contractAddress": "0x1c6b56fb743b07dcafd5f23188a31422c1cefb13",
"tokenUri": "https://nft.luniverse.dev/nft/v1/metadata/luniverse/lvs3/100",
"createdBy": {
"accountId": "8301941016821731686",
"iamUserId": "8534000168011864333",
"account": {
"accountId": "8301941016821731686",
"email": "[email protected]",
"name": "richard",
"alias": null,
"createdAt": "2022-04-05T04:08:58.000Z",
"isEnabled": 1,
"isEmailVerified": true,
"info": {
"countryCode": null,
"phoneAreacode": null,
"phoneNumber": null,
"companyName": null,
"companyWebsite": null,
"isMarketingAgreed": 0
}
},
"iamUser": {
"iamUserId": "8534000168011864333",
"username": "6JBRyAzCu6k8TvyNxvsrihjwCTkZhZpREKCGvhs3MUdACA2yLYbMwfZqGRPF5dvm",
"description": "NFT API",
"type": "API-KEY",
"createdBy": {
"accountId": "8301941016821731686",
"iamUserId": null
},
"createdAt": "2022-04-05T04:36:09.000Z"
}
},
"createdAt": "2022-04-08T07:38:06.544Z",
"callbackUrl": "",
"callbackStatus": "NOT_APPLICABLE",
"callbackRetryCount": 0
}
}
};
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를 생성할 수 있습니다.
eidtionNo Field와 tokenId Field에 String으로 숫자를 입력하여 각각의 값을 지정할 수 있습니다. 이미 유저가 지정한 editionNo 혹은 tokenId와 같은 값을 가진 NFT가 발행되어 있을 경우, 에러가 반환됩니다.