Token management

Smart Contract and Token metadata (JSON objects) can be hosted in various ways for your NFT Collection. Options include:

  • Hosted
    • Using HyperMint to host your Metadata
  • Self Hosted
    • Using your own server
    • Or using IPFS or similarly, Immutable storage


HyperMint uses Google Cloud Platform infrastructure provided solutions to manage your token metadata securely, globally, and at scale. If choosing to host token metadata with HyperMint, click the "Managed with HyperMint" radio button.

Choosing this option will allow you to create your tokens using the Token Creation wizard.

Here you will:

  • Upload media
  • Enter Token Name
  • Determine Token Price
  • Enter Token Supply
  • Set Max Tokens Per Transaction
  • Enter Token Description
  • Link your External URL

Optionally, you can also enter your metadata in JSON format using Advanced Details

You can create any number of tokens using this flow.

Self hosted

If you decide to self host token metadata, HyperMint requires that token metadata be hosted using a single root URL. For information about the required properties, click here.

Using your own server

Although HyperMint offers a hosted solution for metadata, it is not required. Any endpoint which can return a JSON object and images can be used.

For information about how metadata should be structured, please refer to this guide on OpenSea

If you chose the 'Self Hosted' option, please note that the URL structure differs based on the contract type being used. Refer to the below for the distinctions.

For ERC721 token metadata

The URL must end with the token id. For example: where 1 is the token id.

A working example of a ERC721 metadata file can be found here:

For ERC1155 token metadata

There are two important parts of structuring metadata for ERC1155s:

  1. The URL must contain the {id}. For example:{id} where {id} is actual token ID in hexadecimal form.
  2. ERC1155 uses a hexadecimal number instead of decimal for it's metadata. This means that token ID 1 would look for the url:
    where the long number at the end is the hex version.

A working example of a ERC1155 metadata file can be found here:

For more information, please reference the ERC-1155 metadata standard.

Using an external Web3 NFT storage solution

Immutable storage

This type of storage is considered "more crypto" than other forms of metadata storage for the simple fact that once the metadata has been uploaded, it cannot be changed.

Various solutions exist including IPFS which use peer-to-peer networking to distribute copies of the metadata and maintain their integrity.

To comply with HyperMint, metadata files must be stored in a directory with the convention of the file name being the token id as per the above contract types.

ERC721 token metadata on IPFS

The URL must end with the token id. For example:
ipfs://QmPtGwEGvVnq1wE9Drt3hQV6msAfRGtptvAMLiYQ7ZPLZE/1 where 1 is the token id.

ERC1155 token metadata on IPFS

The URL must contain {id}. For example:
ipfs://QmX3wqfVFkdBEc1rFLcRwjn6eixR8D5rBVjvnGttDiMbyh/{id} where {id} is actual token ID in hexadecimal form.

After determining where you will host your NFT Metadata, you can now complete creating your contract and proceed to filling out remaining details in your contract to launch your collection!

Once you've completed one of the two setups, the Token Management step is complete and you'll get the green check for confirmation. The final step in Collection Setup is setting up your Proceeds and Royalties.

What’s Next

Once your tokens are created, it's time to setup the Proceeds and Royalties