Leveraging IPFS in Marmalade

Given the immutable characteristic of NFTs, the associated data's long-term accessibility and sustainability are critical aspects to consider. IPFS has emerged as a powerful tool to handle these requirements, and its importance is underscored in the context of Marmalade,

IPFS is a pioneering protocol designed to modernise the internet's foundational structures, augmenting its capacity for storing, addressing, and accessing data. This technology is central to our approach in dealing with NFT data, ensuring its perpetual availability and integrity and thereby strengthening the overall dependability of the NFTs hosted on Marmalade.

Our guide offers you an easy-to-follow examples for storing your NFT data on IPFS, aiming to make this process as effortless as possible. These best practices, which cater to both extensive asset collections and individual NFTs, are crafted to ensure your data's resilience and longevity in the IPFS ecosystem.

This guide provides our recommend approach to storing metadata and image assets on IPFS, leveraging hypothetical paths and CIDs. Our manual illustrates two distinctive storage scenarios and outlines the method for accessing stored data.

Your metadata files should adhere to our JSON schema. The schema provides a structure for your metadata, ensuring that necessary details are present and formatted correctly. This schema can be found within this readme.

In this schema, the image property should contain a link to the image on IPFS (as illustrated in the previous examples).

When creating a token in the ledger, you should use the create-token function. The link obtained from IPFS (.json) serves as the URI supplied to create a token within the ledger:

Please be reminded that these CIDs are hypothetical and should be tailored to match your specific use case and IPFS setup. A thorough understanding of the IPFS storage mechanism is crucial, and the steps should be adjusted as necessary.

By faithfully following these detailed steps, you can efficiently store metadata and image assets on IPFS, associate them with NFTs, and seamlessly retrieve them in your DApp or application.

Retrieving the URI for a specific token from the ledger is facilitated through a function called get-uri. This function requires a token ID as its argument and returns the associated URI.

When you call the get-uri function and pass in a token ID, it will access the tokens map, find the row corresponding to the provided token ID, and return the value stored in the 'uri field of that row. Essentially, it retrieves the URI that corresponds to the token ID you specified.

Thus, by utilising this get-uri function, you can efficiently retrieve the URI associated with any token stored within the ledger by simply providing its token ID.