Upload Guide
Use the launch wizard at app.mirage.garden/launch.
Prepare layers
Create one layer for each visual slot. Common examples:
| Layer | Example traits |
|---|---|
| Background | Green, Blue, Gold |
| Body | Slime, Stone, Chrome |
| Face | Smile, Sleepy, Laser |
| Accessory | Cap, Crown, None |
Every layer must have at least one trait before deployment.
Prepare files
Trait files should be compact PNG or SVG files under 50 KB each.
Use transparent backgrounds for upper layers when you want composition to show lower layers. Keep every file in the same artboard size, such as 1024 x 1024, so layers align cleanly.
Do not use IPFS, Arweave, CDN, or external HTTPS image links for native LOA/BOA art. The art is written into contract storage or rendered from on-chain data.
Filename weights
The wizard reads optional weights from filenames:
Trait Name#weight.png
Examples:
| Filename | Trait name | Weight |
|---|---|---|
Green#100.png | Green | 100 |
Gold#10.png | Gold | 10 |
Void.png | Void | 100 default |
You can edit names and weights in the wizard before deployment.
Deployment order
The deploy step:
- Deploys trait storage with layer names.
- Uploads every trait into its layer.
- Freezes storage.
- Deploys the renderer.
- Registers the native soToken through the factory.
If an upload fails, no rule is registered. Fix the oversized or invalid file and redeploy.