These docs are for v2.0. Click to read the latest docs for v3.0.

Max Supply

Defining a max supply in your NFT template

Max Supply

When creating the NFT template you can add advanced parameters to the JSON configuration, such as defining a maximum supply of NFTs created from the template.

You can define a maximum supply by adding the optional field maxSupply to your NFT template configuration. Default it is set to unlimited.

📘

Please note that maxSupply is configured, stored, and track on-chain, meaning once set it can not be altered.

Data Structure

Signature:

"maxSupply" : integer

Example:

{
  "name" : "Chuck Darling",
  "description" : "Chuck is a Male Tall Chicken Who is the Leader of The Chicken Siblings. He is Cool, Daring and Wacky. He can be Selfish and Stubborn When it Comes To Challenges, But he is An True Softie when it Comes To His Siblings. In Rebel to the Beak, It revealed that He is Allergic to Monstonuts and In The Good, The Bad and The Clucky, It also Revealed that He Used to Be one Of the Scouts from Slurp,s Little Cowboys Scout Camp along With Finley, Ainta and Hugo. He is the youngest of the three.",
  "image": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
  "maxSupply" : "25",
  "externalUrl" : "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
  "animationUrls" : [
       {"type": "video", "value" : "http://img.arkane.network/chuck_trailer.mp4"},
       {"type": "audio", "value" : "http://img.arkane.network/chuck_soundtrack.mp3"}
  ],
  "attributes" : [
      {"type": "property", "name" : "Talent", "value": "Leadership"},
      {"type": "property", "name" : "Allergic", "value": "Monstonuts"},
      {"type": "property", "name" : "Hobby", "value": "Scouts"},
      {"type": "stat", "name" : "Cool", "value": "9", "maxValue": "10"},
      {"type": "stat", "name" : "Daring", "value": "8", "maxValue": "10"},
      {"type": "stat", "name" : "Noise", "value": "8", "maxValue": "10"},
      {"type": "stat", "name" : "Age", "value": "3"},
      {"type": "boost", "name" : "Crafting", "value": "+5"},
      {"type": "boost", "name" : "Leadership", "value": "+10"}
  ]
}

🚧

When minting a token, the amount + current supply is checked against maxSupply., The currentSupply is only updated at the moment a tx is successful and confirmed.

Meaning, it is possible to submit a transaction to create a certain amount of an NFT which would surpass the max supply, only to see the transaction fail on-chain.