Create NFT Collection

To create a NFT collection, you must call create on dataset(Dataset.COLLECTION). In the body, you can specify the collection's name, the symbol, the base URI, and more. create takes an object of type Build5Request<CreateCollectionRequest> as parameter.

    const collection = await https(Build5.TEST)
      .project(projectAPIKey)
      .dataset(Dataset.COLLECTION)
      .create(<any>{
        address: address.bech32,
        signature: userSign.signature,
        publicKey: {
          hex: userSign.publicKey,
          network: Network.RMS,
        },
        body: {
          name: collectionName + ' collection',
          description: collectionName + ' collection description',
          availableFrom: dateNow,
          access: 0,
          category: 'COLLECTIBLE',
          bannerUrl:
            'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
          placeholderUrl:
            'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
          price: 10000000,
          royaltiesFee: 0,
          type: 0,
        },
      });

Space

If you want to add the collection to a space you can just specify it with the space property in the CreateCollectionRequest object.

Royalties Space

If you want to specify royality fees you can set the royaltiesFee property and specify a royalitySpace in the CreateCollectionRequest object.

Validated Address in Space

Make sure the royaltiesSpaceand space you specify have a validated address

After that, you should create a list of objects that describe the single NFTs, their name, description and image, price, and so on.

    const nftLists = [];
    for (let i = 0; i < 25; i++) {
      const nftName = Math.random()
        .toString(36)
        .substring(2, 5)
        .replace(/[0-9]/g, '')
        .toUpperCase();
      nftLists.push({
        availableFrom: dateNow,
        collection: collection.uid,
        description: nftName + ' description',
        media:
          'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
        name: nftName,
        price: 20000000,
      });
    }

As a last step, you can mint the batch of NFTs by calling createBatch on dataset(Dataset.NFT) and passing the list of NFTs in the body. createBatch takes an object of type Build5Request<NftCreateRequest[]> as parameter.

    const nfts = await https(Build5.TEST)
      .project(projectAPIKey)
      .dataset(Dataset.NFT)
      .createBatch({
        address: address.bech32,
        signature: userSign.signature,
        publicKey: {
          hex: userSign.publicKey,
          network: Network.RMS,
        },
        body: <any>nftLists,
      });

createBatch returns an oject of type Collection.

Full How-To Code

import { Dataset, Network } from '@build-5/interfaces';
import { Build5, SoonaverseApiKey, https } from '@build-5/sdk';
import { address } from '../../utils/secret';
import { walletSign } from '../../utils/utils';

async function main() {
  let userSign = await walletSign(address.bech32, address);
  try {
    const projectAPIKey = SoonaverseApiKey[Build5.TEST];

    console.log('Create NFT Collection under your project...');
    const collectionName = Math.random()
      .toString(36)
      .substring(2, 5)
      .replace(/[0-9]/g, '')
      .toUpperCase();
    const dateNow = Date.now();
    const collection = await https(Build5.TEST)
      .project(projectAPIKey)
      .dataset(Dataset.COLLECTION)
      .create(<any>{
        address: address.bech32,
        signature: userSign.signature,
        publicKey: {
          hex: userSign.publicKey,
          network: Network.RMS,
        },
        body: {
          name: collectionName + ' collection',
          description: collectionName + ' collection description',
          availableFrom: dateNow,
          access: 0,
          category: 'COLLECTIBLE',
          bannerUrl:
            'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
          placeholderUrl:
            'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
          price: 10000000,
          royaltiesFee: 0,
          type: 0,
        },
      });
    console.log('Collection: ' + collection.uid, collection);

    // Create 25 NFTs
    console.log('Create 25 NFTs under your collection...');
    const nftLists = [];
    for (let i = 0; i < 25; i++) {
      const nftName = Math.random()
        .toString(36)
        .substring(2, 5)
        .replace(/[0-9]/g, '')
        .toUpperCase();
      nftLists.push({
        availableFrom: dateNow,
        collection: collection.uid,
        description: nftName + ' description',
        media:
          'https://images-wen.soonaverse.com/0x551fd2c7c7bf356bac194587dab2fcd46420054b/rrvhjuksm4/fe1105c6-2a66-4496-96d1-ed1625293014.jpeg',
        name: nftName,
        price: 20000000,
      });
    }
    userSign = await walletSign(address.bech32, address);
    const nfts = await https(Build5.TEST)
      .project(projectAPIKey)
      .dataset(Dataset.NFT)
      .createBatch({
        address: address.bech32,
        signature: userSign.signature,
        publicKey: {
          hex: userSign.publicKey,
          network: Network.RMS,
        },
        body: <any>nftLists,
      });
    console.log('NFT ', nfts);
  } catch (error) {
    console.error('Error: ', error);
  }
}

main().then(() => process.exit());