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:

1. Deploys trait storage with layer names.
2. Uploads every trait into its layer.
3. Freezes storage.
4. Deploys the renderer.
5. Registers the native soToken through the factory.

If an upload fails, no rule is registered. Fix the oversized or invalid file and redeploy.