Using IPFS
You need at least three files to upload to the marketplace for each design.
- PNG/JPG image - acts as the thumbnail
- GLB file - A 3D viewer that rotates and gives greater detail of the design
- STL file - one of more files that are the files a 3D printer operator needs to print the design
The PNG/JPG should be close to 500px X 500px in size. you can use any screen copying or built in image generator.
The GLB file can be directly generated from most organic modeling or CAD software.
If generating from organic modeling software, make sure your vector resolution is as low as possible while still maintaining detail. This keeps the file size small for faster uploading and processing time on the website.
The website includes a link to a GLB generator for STL files.
STL files can be exported from most CAD and organic modelling software.
- Our recommended software for dimensional CAD is Fusion 360. They have a free hobbyist license https://www.autodesk.com/products/fusion-360/personal
- Our recommended software for organic modelling is Blender https://www.blender.org/
Both of these programs have some of the largest online communities with countless tutorials and video's to get started learning.
Adosia aims to be as decentralized as possible. For this reason files linked to the marketplace are uploaded to IPFS (Inter Planetary File system) for storage. There are a number of ways to do this, and for a hobbyist, there are plenty of free options.
For this tutorial we will be using Pinata, a popular IPFS Gateway and pinning platform that makes it simple for anyone to upload their own files. \
Head to Pinata and click "Start Building in the top right to create a free account.
Once logged in Click on "Add Files" in the top right to start the upload process.
You can upload files single at a time, or as a folder. For this tutorial we will upload all the files needed for the marketplace individually.
Select the File you intend to upload.
Wait for the file to upload
Note: IPFS uploads can be slow. Best to be patient.
Once uploading is complete we can see the file in our list of uploaded files. Note the "Content Identifier (CID) in red.
This is the string of text we need to input into the Adosia Market upload form for each file detailed in the next section.
At this point the upload to IPFS is complete.
Click on "Start Selling" on the website header
Select the desired category of the object you are uploading
Enter a name for your design
Enter the IPFS CID's for your design files generated in the previous section
NOTE: the quantity information you need to enter in the STL form input.
Read all directions carefully
Each file starts with "ipfs://" followed by the CID generated by uploading to IPFS in the previous section.
Select if the design is free or a purchased design
If a paid design is selected, please enter the price you as the designer want, in ADA, to receive if your design gets ordered to be printed.
Select "Upload New Design" to submit your form.
NOTE: This is an area that needs thorough testing. When files are uploaded to IPFS, they have to "populate" or spread out on the network.
if you get errors at while submitting saying "The IPFS file is invalid", you may have to wait up to a few hours and try again. We're not sure on the exact amount of time it takes for files to spread across the IPFS network for adosia to see them as valid.
This is an example of the error you might get.