Skip to main content

Instareveal

Instareveal is a service that Scatter provides. Currently this service is available exclusively for collections which launch with Scatter.

Instareveal works by not revealing NFT metadata onto IPFS until NFTs are minted.

If you wish to use Instareveal with your collection it is very important that you do not upload your assets to IPFS yourself. This is because IPFS works based on file hashes, and so if you upload to IPFS yourself another IPFS node will be able to serve your NFT's files.

Contact us on X / Discord / Telegram to use Instareveal.

Instareveal does not currently support _nsfw tags but will in the future.

Instareveal takes some time to process files to be ready. You should make sure you get us the files days in advance of your launch so that we can make sure it's good to go for your release.

Prepare Your Collection​

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

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.

Verify​

You can run this Python script next to your images and json folders to verify that they are proper and ready for Instareveal: https://github.com/Scatter-Partners/useful-scripts/blob/master/verify/verify_for_instareveal.py

The above script will perform a variety of tests and print out any issues. If you can satisfy that script your files will likely be ready to use with no issues.

Extra files such as _metadata.json must also be deleted safely from your JSON folder if that is generated. If you upload extra files it will cause errors after you upload. Instareveal currently expects exactly two folders images and json and each folder must have the same number of files in them starting from an index of 1 to your max supply.

Zip it​

If you do a normal upload to Pinata/Filebase you don't need to zip the files, but to prepare your collection for Instareveal, you need to have two folders zipped though. The two folders should be named images and json and both should be at the top level of the zip.

If you are on macOS you need to avoid including the system files (such as .DS_Store and __MACOSX folder) in the zip you are uploading by running this command in the folder of the images and json" folders:

zip -r yourcollectionname.zip . -x '**/.*' -x '**/__MACOSX'

Instareveal Key​

If you are given an Instareveal API key you will be uploading your collection's .zip file to Instareveal yourself. You will select the .zip and enter your API key exactly in the link provided to you in order to upload your .zip. Once your .zip has been uploaded let us know so we can prepare the final step.

Linking​

Your Instareveal setup must be linked to your collection so that as your NFTs are minted. You can deploy your collection while leaving your base URI field blank, and then update your base URI to one one we provide. Or you can have use do the Instareveal setup process first for you and give you a base URI you can set as you deploy your collection.

Revealing​

Our Instareveal service watches contracts for mints and reveals their tokens in order as mints accumulate. During periods of large amounts of mints this process may appear to be slow. You can tell your holders the reveal is in progress and they can expect their tokens to be revealed within some minutes.