Comment on page
🪙
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
- 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.

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.

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: https://docs.opensea.io/docs/metadata-standards
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.
The URL must end with the token id. For example:
https://myserver.com/metadata/1
where 1
is the token id.A working example of a ERC721 metadata file can be found here:
https://gateway.pinata.cloud/ipfs/QmPtGwEGvVnq1wE9Drt3hQV6msAfRGtptvAMLiYQ7ZPLZE/1
There are two important parts of structuring metadata for ERC1155s:
1.) The URL must contain the
{id}
. For example:https://myserver.com/metadata/{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:
https://myurl.com/0000000000000000000000000000000000000000000000000000000000000001
where the long number at the end is the hex version.A working example of a ERC1155 metadata file can be found here:
https://gateway.pinata.cloud/ipfs/QmX3wqfVFkdBEc1rFLcRwjn6eixR8D5rBVjvnGttDiMbyh/0000000000000000000000000000000000000000000000000000000000000000
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 (https://ipfs.io/) 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.
The URL must end with the token id. For example:
ipfs://QmPtGwEGvVnq1wE9Drt3hQV6msAfRGtptvAMLiYQ7ZPLZE/1
where 1
is the token id.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!
Something not quite right, unclear or can't find what you are looking for? Please let us know at [email protected] and we will get back to you as soon as we can.
Last modified 7mo ago