This is a very simple example how to mint an NFT with NMKR Studio on the Aptos blockchain. You can find more samples in the corresponding folders.
First create an Account with NMKR Studio and create an API Key.
Second, Login and buy some Mint Coupons. Since your Aptos NFT needs a collection, you have to fill up your account with at least one mint coupon.
The API Addresses for NMKR Studio are:
- Testnet: https://studio-api.preprod.nmkr.io
- Mainnet: https://studio-api.nmkr.io
Upload a Collection Image to IPFS or any other Decentral Filesystem
Create an Aptos only Project:
curl --request POST \
--url https://<apiaddress>/v2/CreateProject \
--header 'Content-Type: application/json' \
--header 'authorization: <apikey>' \
--data '{
"projectname":"TestProjectAptos",
"description":"This is the description of the Aptos Project",
"aptoscollectionname":"TestCollectionAptos",
"aptoscollectionimageurl":"https://c-ipfs-gw.nmkr.io/ipfs/QmXHBX67PrmXabzJ66VxLQKt25kaeeoJBdC3ytbSaTPFuQ",
"aptoscollectionimagemimetype":"image/jpeg",
"payoutwalletaddressaptos":"0x76b98eb82b78134fb039dc22bde0f189c9e77ca4d6175f14627f0ae5163db49e",
"maxNftSupply":1,
"addressExpiretime":60,
"enableaptos":true,
"enablecardano":false,
"enablesolana":false
}
'The AptosCollectionName is required, because the collection is the main object for the NFTs. The AptosCollectionImage is the image of the collection. The PayoutWalletAddressAptos is the address where the payments for the NFTs will be sent (the sellers wallet).
The MaxNftSupply must be 1, otherwise the Project is no NFT, but a Fungible Token project. At the moment we do not support FT Projects in the Aptos Blockchain.
The AddressExpireTime is the time in minutes, how long the payment address is valid.
If you want to enable the Aptos Blockchain, set the EnableAptos to true. If you want to enable the Cardano Blockchain, set the EnableCardano to true. If you want to enable the Solana Blockchain, set the EnableSolana to true.
You will receive an JSON Result (or an errormessage) with some information:
{
"projectId": 0,
"metadata": null,
"policyId": null,
"policyScript": null,
"policyExpiration": null,
"uid": "89b066c3-67ae-40b2-acc9-93cfb8fc8689",
"metadataTemplateAptos": null,
"metadataTemplateSolana": "{\r\n \"name\": \"<asset_name>\",\r\n \"image\": \"https://c-ipfs-gw.nmkr.io/ipfs/<ipfs_link>\",\r\n \"properties\": {\r\n \"files\": [\r\n {\r\n \"type\": \"<mime_type>\",\r\n \"uri\": \"https://c-ipfs-gw.nmkr.io/ipfs/<ipfs_link>\"\r\n }\r\n ]\r\n },\r\n \"description\": \"<project_description>\",\r\n \"attributes\": [\r\n {\r\n \"trait_type\": \"description\",\r\n \"value\": \"<project_description>\"\r\n }\r\n ]\r\n}"
}Notice the UID, because this is necessary to upload the NFT into the project. If you want to have different metadata, you can have a look into the samples for traits and fixed fields in the metadata.
Now you can add some NFTs to your project with the following call:
curl --request POST \
--url https://<apiaddress>/v2/UploadNft/<projectuid> \
--header 'Content-Type: application/json' \
--header 'authorization: <apikey>' \
--data '{
"tokenname": "Nft1",
"displayname": "Nft #1",
"description": "This is the first NFT in the new collection",
"previewImageNft": {
"mimetype": "image/jpeg",
"fileFromsUrl": "https://picsum.photos/640/480"
}
}'After that, you receive an JSON Result (or an error)
{
"nftId": 2511295,
"nftUid": "9ee88c31-1ae2-41e1-99b3-4fc19f83c8d8",
"ipfsHashMainnft": "QmVuXZVkpKsH9oQrdEQ4wzCzHq5hJMEdDskxYAaiuAe6FB",
"ipfsHashSubfiles": [],
"metadata": null,
"assetId": "565f3a76a2bffab0dcb5745e4a8409275dd9203c2e68bf0b6e72fdf44e667434",
"metadataAptos": "{\r\n \"name\": \"Nft1\",\r\n \"image\": \"https://c-ipfs-gw.nmkr.io/ipfs/QmVuXZVkpKsH9oQrdEQ4wzCzHq5hJMEdDskxYAaiuAe6FB\",\r\n \"properties\": {\r\n \"files\": [\r\n {\r\n \"type\": \"image/jpeg\",\r\n \"uri\": \"https://c-ipfs-gw.nmkr.io/ipfs/QmVuXZVkpKsH9oQrdEQ4wzCzHq5hJMEdDskxYAaiuAe6FB\"\r\n }\r\n ]\r\n },\r\n \"description\": \"This is the description of the Aptos Project\",\r\n \"attributes\": [\r\n {\r\n \"trait_type\": \"description\",\r\n \"value\": \"This is the description of the Aptos Project\"\r\n }\r\n ]\r\n}",
"metadataSolana": null
} curl --request GET \
--url 'https://<apiaddress>/v2/GetPaymentAddressForRandomNftSale/<projectuid>/<countnft>/<priceinoctas>?blockchain=Aptos' \
--header 'authorization: <apikey>'
As we have not stored a price list, we have to enter the number of NFTs and the price manually when calling the function. If a price list is stored in the project, these parameters are not required.
If no error occurs, you will receive an JSON like this:
{
"paymentAddress": "0xb6aa8844961de0e7416008288eb9ac4bea207d99f54a048d3ecf5ee526e0f13c",
"paymentAddressId": 87769,
"expires": "2025-03-21T14:33:18.9652512+00:00",
"adaToSend": null,
"solToSend": null,
"aptToSend": "1",
"debug": "",
"priceInEur": 5.06,
"priceInUsd": 5.47,
"priceInJpy": 816.5,
"priceInBtc": 0,
"effectivedate": "2025-03-21T13:33:19.2424227+00:00",
"priceInLovelace": 0,
"additionalPriceInTokens": null,
"sendbackToUser": 0,
"revervationtype": "random",
"currency": "APT",
"priceInLamport": 0,
"priceInOcta": 100000000
}Here you find an aptos payment address (paymentAddress) where the buyer has to send 1 APT. The payment address is valid until the date in expires. The price is also shown in EUR, USD, JPY and BTC.
After the buyer has made the payment, the NFT will be minted and transferred to the buyer.
When the buyer sends a wrong amount, the Amount will be transferred back to the buyer.
If the address is expired, the buyer has to request a new address. If he made a payment to an expired address, the amount will be transferred back to the buyer.\
You can check the state of the address with the following call:
curl --request GET \
--url https://<apiaddress>/v2/CheckAddress/<projectuid>/<addresstocheck> \
--header 'authorization: <apikey>'You will receive an JSON like this:
{
"state": "active",
"lovelace": 0,
"receivedAptosOctas": 0,
"receivedSolanaLamports": 0,
"receivedCardanoLovelace": 0,
"coin": "APT",
"hasToPay": 100000000,
"additionalPriceInTokens": [],
"payDateTime": null,
"expiresDateTime": "2025-03-21T14:33:19",
"transaction": null,
"senderAddress": null,
"reservedNft": [
{
"id": 136851,
"uid": "23713f14-590c-4fdf-a509-bc97302a524e",
"name": null,
"displayname": null,
"detaildata": null,
"ipfsLink": null,
"gatewayLink": null,
"state": null,
"minted": false,
"policyId": null,
"assetId": null,
"assetname": null,
"fingerprint": null,
"initialMintTxHash": null,
"series": null,
"tokenamount": 1,
"price": null,
"selldate": null,
"paymentGatewayLinkForSpecificSale": null,
"priceSolana": null,
"priceAptos": null
}
],
"rejectReason": null,
"rejectParameter": null,
"stakeReward": null,
"discount": null,
"customProperty": null,
"tokenReward": null,
"countNftsOrTokens": 1,
"reservationType": "random"
}The most important information is the state. If the state is "active", the buyer has to send the amount of APT to the address. If the state is "paid", the NFT is minted and transferred to the buyer. If the state is "expired", the buyer has to request a new address. If the state is "rejected", the buyer had send a wrong amount or the saleconditions are not met. In this case, the amount will be transferred back to the buyer.