Items

An Item is where the metadata is defined, describing what is being created. After an Item is created, it can be awarded (minted) to a player by adding an Item Balance.

On the blockchain, an Item is similar to a token. Creating an Item in Stardust is like defining a token, and adding an Item Balance is minting the token to a given wallet (player).

Game Collection (FA) Item

• An FA item is the only item type that has a totalSupply on the Item rather than the Collection.

Create FA Item Example:

{
  "collectionId": "243b27a2-8ef0-4317-ba1f-0f48077ab851",
  "gameId": 123,
  "name": "Gold Coins",
  "description": "Gold coins can be used as a form of currency used to buy and trade goods on Astera",
  "image": "https://images.pexels.com/photos/106152/euro-coins-currency-money-106152.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=2",
  "blockchainId": 7,
  "publicMetadata": {},
  "totalSupply": 1000000
}

Standalone Asset (NFT) Item

• NFT Items can only have a totalSupply of 1 since every NFT item is unique.

{
  "collectionId": "79eccca1-1ff7-40cd-b596-938b07a69f8a",
  "gameId": 123,
  "name": "Shield",
  "description": "This item stops some damage",
  "image": "https://static6.depositphotos.com/1064044/547/i/450/depositphotos_5479649-stock-photo-old-shield.jpg",
  "blockchainId": 7,
  "totalSupply": "1",
  "publicMetadata": {}
}

Standalone Currency (FT) Item

• There is only one FT item per FT Collection.
• Once an FT Collection is made, an item does not need to be created.
• After creating an FT Collection, continue to creating an item balance.

Adding Item Balance

Once an item has been created, mint the item to a player by adding an Item Balance.

Add Item Balance Example:

{
  "itemId": "e876041c-a9f1-4715-98d0-5595d0ee00c5",
  "playerId": "622519f2-b638-4882-9f2e-44b9b3e109c3",
  "amount": "1"
}