uploadCollection.md

sidebar_position	3

Upload an NFT Collection

In addition to Single NFTs, NFT Toolbox also provides the functionality to upload entire NFT collections to chosen File Storage Platform.

In order to be uploaded, a Collection has to first be initialized in the Toolbox. Here is how to Initialize a Collection.

:::note The structure of the directory provided to initEthereumCollection or initSolanaCollection as parameter dir is restricted. It must contain two directories named assets and metadata. These are the directories that NFT Toolbox will upload to File Storage. The names of Asset and corresponding Metadata files must be the same. :::

NFT Collections are uploaded to File Storage using uploadEthereumCollection function for Ethereum & uploadSolanaCollection for Solana in the Toolbox. The uploadCollection function first uploads the assets directory to File Storage. Then each metadata file in the metadata folder is updated with the corresponding asset's URL. Finally the metadata directory is uploaded to File Storage and both Asset and Metadata CIDs are returned.

:::note The image field in Metadata is named and updated in accordance with the OpenSea Metadata Standards for Ethereum. Solana follows Metaplex standard for Solana collections. If a different format is required, it can be updated separately using the CIDs returned by the function. :::

For Ethereum

After Initializing Ethereum Collection and Initializing the File Storage,

const uploadEthereumCollectionExample = async function () {
	const { assetCID, metadataCID } = await nftToolbox.uploadEthereumCollectionNFT();
	console.log(assetCID, metadataCID);
};
uploadEthereumCollectionExample();

For Solana

After Initializing Solana Collection and Initializing the File Storage,

const uploadSolanaCollectionExample = async function () {
	const { assetCID, metadataCID } = await nftToolbox.uploadSolanaCollectionNFT();
	console.log(assetCID, metadataCID);
};
uploadSolanaCollectionExample();