Skip to main content

Launchpad ITO

Available on the Launch page

Enable ITO mode from the /launch wizard. It is on by default for native LOA/BOA launches.

The Launchpad ITO (Initial Token Offering) is the recommended way to distribute a new soToken. Instead of minting a fixed supply to your wallet and handling liquidity yourself, buyers purchase tokens directly through an on-chain sale contract. Each buyer becomes the original minter in their objects' birth records.

How it works​

When ITO mode is enabled:

  1. You configure a sale: price, max supply, duration, and optional creator allocation.
  2. The factory deploys your token contract, renderer, and an on-chain sale contract in a single transaction.
  3. Buyers call the buy function on the sale contract. Tokens are minted to them on demand. If object capacity remains, their objects are born immediately with an ITO purchase birth path.
  4. Trading on Mirage is live from the moment the ITO launches. No liquidity pool is required.
  5. You withdraw ETH proceeds at any time via withdrawCreatorProceeds().

Tokens are mint-on-demand. Unsold supply is never created. There is nothing to burn or reclaim after the sale ends.

The token sale cap and the object cap are intentionally separate. A creator can sell far more token supply than the object layer can support, such as a large liquid token with only a few exclusive LOA objects for top holders. Once the object cap is reached, ITO buys can continue as token-only buys until the token sale cap is reached.

Sale modes​

Fixed price​

Every object-supporting token interval costs the same amount of ETH throughout the sale.

  • Simple to communicate to buyers
  • Requires setting a price you're comfortable with from the start

Bonding curve​

The price per object-supporting token interval increases linearly from a start price to an end price as supply sells out.

  • Early buyers get a lower price
  • Natural incentive to buy early
  • Requires setting a start price and end price. End price must be at least the start price.

Duration modes​

Cap limited​

The sale runs until the max supply is sold. No time limit.

Time limited​

The sale runs until a set end date or until the max supply is sold, whichever comes first. The end date must be in the future.

Creator allocation​

You can reserve tokens for yourself before the public sale opens.

  • Your allocation is minted to your wallet when the soToken deploys.
  • Auto-claim is off by default. If you leave it off, the allocation is token-only and you can claim later.
  • If auto-claim is enabled, the contract claims as many whole interval-backed objects as the allocation and remaining object cap allow.
  • Creator allocation does not count as "sold" in the sale stats. Any objects claimed from it still count toward the total object cap.

Fees​

  • Mirage protocol fee: 1% added on top of the quoted price. Buyers pay price + fee. You receive price intact.
  • Creation fee: the standard factory creation fee applies (same as non-ITO launches). Holders of qualifying tokens (CLKCAT, PixelCats, ClankerCats NFT) receive a discount or zero fee. Testnet is always free.

During the sale​

ActionWhoHow
Buy token intervalsBuyerBuy from the token's ITO page. If object capacity remains, the sale claims the matching object in the same transaction.
View price quoteAnyonequoteBuy(count) returns price, fee, and total due. Shown automatically on the token page.
Withdraw ETHCreatorClick "Withdraw proceeds" on the token page at any time, including during an active sale.
Finalize / closeAnyoneOnce the sale ends (cap hit or time expired), anyone can call close() to mark it closed and emit the final event.

After the sale​

Trading on Mirage is already live the moment the ITO deploys. Holders can list, buy, and transfer active objects without any additional setup.

Adding liquidity is optional. If you want your token traded on DEXes or other venues, you can seed a pool with a portion of your ETH proceeds. Be careful with token support inside pool contracts; object capacity can become locked where the tokens sit.

Validation rules​

The wizard enforces these before deploying:

  • Max tokens for sale must be greater than zero and divisible by the interval.
  • Max tokens for sale may exceed object support. That is valid and lets a project have scarce objects attached to a larger liquid token.
  • Initial supply is zero in ITO mode. The public sale mints sold tokens on demand; creator allocation is a separate optional mint.
  • Fixed price: price per object-supporting token interval must be greater than zero.
  • Bonding curve: start price must be greater than zero; end price must be greater than or equal to start price.
  • Time limited: end date must be in the future.

On-chain birth record​

Each object born through the ITO has:

birthPath = ITO purchase path
originalMinter = buyer's wallet address

This is visible on the token detail page and queryable via birthRecords(objectId) on the ledger contract.