Skip to main content

Filebase for IPFS

Minting on Scatter is as easy as pie and we continuously strive to make it even easier!

A relatively new option for your IPFS Upload is Filebase, and in this guide we will discuss the steps necessary for minting using Filebase as an IPFS Upload Solution.

More in-depth product information can be obtained at their website https://filebase.com/

Requirements​

Images​

The images for your collection must be numbered in the order you want them to appear/mint, each file name should be the corresponding number (e.g. first image is 1.png, second is 2.png, and so on). Please make sure they are numbered correctly 1.png, 2.png, 3.png and don't have custom names like image_1.png, image_2.png, image_3.png. Scatter's index starts at 1 and not 0 - numbering it as 0 will result in it not being "read". We support many media formats, such as PNG, JPG, GLB, VRM, MP4 and MP3.

  • Put them all in images folder (doesn't need to zip it)

Metadata​

For each image file there needs to be a corresponding metadata / JSON file. Please make sure they're numbered correctly (as mentioned with images) and make sure JSON files have no file extensions - they should be named 1, 2, 3 and not 1.json, 2.json, 3.json. We have a variety of scripts and webtools available that you could use.

Step 1 - Contract Creation​

Follow the easy steps as outlined under Step 1 of The Ultimate Creator Guide

Step 2 - Content Pinning Using Filebase​

Create Filebase account.

Upload images and get images CID:

  • Click on the top right highlighted Upload button and select folder upload
  • Select the folder with your images in it
  • Once uploaded you will receive a unique CID of images folder as highlighted at the bottom left. Copy and paste this CID and make sure you save it.

filebase1

Generate or edit metadata:

  • Once you've uploaded your images, you will have the images CID necessary for creating the JSON files. Each JSON file must have an image link that points to an actual image stored on IPFS (it looks like "image": "ipfs://CID/1.png"). For more about metadata please read this or remember as discussed earlier, our easy webtools https://webtools.scatter.art/.
  • If you already have your metadata generated before, you should edit it with the given images CID, so image links are correct. To update image links use https://webtools.scatter.art/update-image-fields/.

Upload metadata and get metadata CID:

  • Click again on the top right highlighted Upload button and select folder upload
  • Select the folder with your completed JSON files in it
  • Once uploaded you will receive a unique CID of metadata folder as highlighted at the bottom left. Copy and paste this CID and make sure you save it.
  • This second CID will be used to set your base URI in your contract.

filebase2

Please note - if you have a large collection, uploading it all as a folder can time out depending on the size. I.e. if you're attempting to upload a 20Gb folder your internet connection can drop for a second and sever that upload connection. Filebase uploads in parallel to help with that via multi part uploads, but in certain cases that can time out. Most of your normal sized collections should be able to upload as folder with no issue, but if you run into like 20k item collections, their bucket CIDs may be a better route:

  • Make sure you choose the IPFS option when creating a bucket
  • Users can upload files individually one at a time into a Filebase bucket. There's no need to batch-upload all files simultaneously.
  • Once all desired files are uploaded, users can select the Generate Bucket CID option. This action instantly generates an IPFS folder CID that mirrors the file structure and layout of the Filebase bucket.
  • You can also easily modify files - if you need to change or remove files, simply delete the unwanted files from the bucket and select Generate Bucket CID again. A new folder CID is created instantly, without the need to re-upload the remaining files.

Step 3 - Collection Editing​

Follow the easy steps as outlined under Step 3 of The Ultimate Creator Guide

Step 4 - Your Collection is Live!​

Follow the easy steps as outlined under Step 4 of The Ultimate Creator Guide