The End to End Guide For Minting a Single NFT on the AVN

This guide will walk you through successfully submitting a transaction on the AVN to mint an NFT and verify the state of the transaction.

The first thing we need to do is ensure that you have npm installed. You'll find instructions on how to do this here. You'll also find instructions on how to install the avn-api library. Once that'S done, the next step is to set up your Substrate uri (SURI) as an environmental variable here. Setting your environmental variable makes things easier going forward.

Note, all transactions on the AVN must be paid for using AVT, so going forward it's important for you to have some AVT in your account. There are multiple ways to purchase AVT and this page provides instructions on how to get some. Note, you'll need 1 AVT in your SURI account to use the API. The tokens need to be lifted (moved) to the Aventus Network, and there are also instructions for that too here.

Once you have some AVT in your account, of which you can check your account balance here, let's get to the exciting bit, minting an NFT by submitting a transaction to the AVN. For this guide, we'll show a simple transaction minting a single NFT.

important

This operation uses a relayer account that the sender authorizes to submit the transfer transaction. You can learn more about relayers HERE.

You can get the AVN_GATEWAY_URL and AVN_RELAYER here.

const AVN_API = require("avn-api");
const AVN_GATEWAY_URL = "<node_url>";
const API = new AVN_API(AVN_GATEWAY_URL);

const AVN_RELAYER = "5Fb...yTh"; 
const NFT_OWNER_ADDRESS = "bDB...9MH"; //Your address on the Aventus network
const EXTERNAL_REF = "https://5DA/gxV";
const T1_ADMIN_NAME = "0x1a2...b3c";
const ROYALTIES = [
    {
        recipient_t1_address: "0x1a2...c3b", //Tier 1 Blockchain address
        rate: {
            parts_per_million: 10000, // 1%
        }
    }
];

async function main() {
    await API.init();

    const result = await API.send.mintSingleNft(
        AVN_RELAYER,
        NFT_OWNER_ADDRESS,
        EXTERNAL_REF,
        ROYALTIES,
        T1_ADMIN_NAME
    );
    // Returns a request id
    console.log(result);
}

(async () => {
    await main();
})();

Expected Transaction Submission Output

f1710fe7-141f-43c1-b1bb-6ec33d9b3e9a

Congratulations! You've now successfully minted an NFT on the AVN.

State of the Transaction

To query the AVN on the state of the transaction:

let status = await api.poll.requestState(requestId);
console.log(status);

Expected State Output

{
    "txHash": "0x37b5aa6...ae1c773c0acbc63dc90",
    "status": "Processed",
    "blockNumber": "125412",
    "transactionIndex": "2"
}