2
Something generated
Generated collections stay on your Pinata until someone mints. The how-to on the files step shows the folder we can read. Nothing is inscribed until a buyer mints.
DiggyI am right here with you. Nothing goes on chain until someone mints, and your draft stays with your wallet, so you can close the tab and come back.
1 Say hi to your wallet
DiggyYour wallet gets the spotlight. It signs each step, gets paid for every mint, and I keep your draft safe under it.
2 Name your collection
DiggyMake it sound like you. Emoji and accents are welcome. I will write the link for you, plain letters, numbers and dashes.
3 Your Pinata folder
How to set up Pinata
Pinata holds the layer pictures until someone mints. We read them through our gateway. You never send a Pinata password or API key.
- Make a free Pinata account at pinata.cloud. The free plan is enough to start. A long mint may want a paid plan so the files stay up.
- Build one folder on your computer. One subfolder per layer, bottom layer first. PNGs only, every file the same width and height, transparent where the layer should show through.
my-collection/ 1_Background/ Orange.png Blue#20.png 2_Body/ Shiba.png 3_Hat/ Cap.png1_Backgroundbecomes the trait Background and is drawn first. The file name is the trait.Blue#20.pngis Blue, and it shows up more often. A plain name has weight 1. Up to 20 layers, 100 pictures in a layer. - Upload the folder in Pinata: Add, then Folder. Set it to Public.
- Copy the folder CID (it starts with
bafy,bafk, orQm) or the Pinata gateway link. The link needs/ipfs/and the CID in it. That is what this launchpad reads. - Name, price and royalty stay in this guide. Do not put a royalties file in the folder. Those become the collection record when you sign.
- When a buyer mints, we fetch only the layers for that piece, flatten them into one image, and inscribe that image on Dogecoin. The inscription does not point back at Pinata. After one confirmation we delete our copy.
- Leave the layers up until the mint is finished. One picture is reused by many pieces, so deleting it after a single mint would break the ones still waiting. When the last piece is minted, delete the folder.
DiggyYour layers live on your Pinata, not on our disk. Open How to set up Pinata and follow it, then paste the folder CID. Nothing is inscribed until someone mints, and a picture has to stay up until the last piece that uses it is minted.
4 Names and traits
DiggyTraits come from the layer folders on Pinata. A file named Blue.png inside 1_Background is the trait Background, value Blue. The table is there if a piece needs a different name.
Metadata format
DiggyIf you already have metadata from another Doginals tool, try it as it is. I map the common shapes and tell you what I changed.
A JSON list, one entry per file, saved as UTF-8. id is the file name, like 1.png.
[
{
"id": "1.png",
"meta": {
"name": "My Collection #1",
"attributes": [
{
"trait_type": "Background",
"value": "Orange"
},
{
"trait_type": "Eyes",
"value": "Happy"
}
]
}
},
{
"id": "2.png",
"meta": {
"name": "My Collection #2",
"attributes": [
{
"trait_type": "Background",
"value": "Blue"
},
{
"trait_type": "Eyes",
"value": "Sleepy"
}
]
}
}
]
- id: the file name.
1also finds1.pngor001.png. - meta.name: the piece name, up to 80 characters. Emoji are fine. Left empty, it becomes “Collection #n”.
- meta.attributes: up to 20 traits, each
{"trait_type": "...", "value": "..."}. Trait names up to 40 characters, values up to 80.
You can wrap the list so the collection name, description and royalty fill in for you. roy is a whole percent from 0 to 100. pay_to is the Dogecoin address that receives it.
{
"collection": {
"name": "My Collection",
"description": "Optional",
"roy": 5,
"pay_to": "D…"
},
"items": [
{
"id": "1.png",
"meta": {
"name": "My Collection #1",
"attributes": [
{
"trait_type": "Background",
"value": "Orange"
},
{
"trait_type": "Eyes",
"value": "Happy"
}
]
}
}
]
}
I also accept file, filename, image, traits, properties, and a list wrapped as items.
Fill them in by hand
Bulk fill
5 Price and royalty
DiggyYou keep the whole mint price. That part is yours. Buyers add a 1% fee on top. A royalty is your cut of every resale on any marketplace that reads the on-chain record. It costs about 1 DOGE to inscribe that record.
6 Check and sign
DiggyLook at this. Everything in one place. I hold the sign button until nothing is blocking. Warnings are worth a glance, not a stop.
DiggyYou did it. After you sign, you land on your launch page. Inscribe the collection record there if you set a royalty, then open the launch. Once it opens, the folder is locked: buyers are promised exactly the collection you signed. We fetch a piece from your Pinata only when someone mints it, and after one confirmation we delete our copy. After that it is read from the chain.