Skip to main content

Integrate with Mavis Launchpad

Overview​

The Mavis Launchpad (marketplace.skymavis.com/launchpad) is a platform within Mavis Market where users mint NFTs for the first time. Users can mint NFTs, take part in the project, and make payments with any token on Ronin.

The launchpad helps you, the creator, to introduce your collection to the community through features like customized launch stages and attractive landing pages.

The process to integrate your NFT project with Mavis Launchpad includes the following steps:

Integrate with the launchpad​

Step 1. Customize your launch​

A launch includes a series of launch stages, with one stage active at any given time. Each stage has the following details:

  • Stage name: The name of the stage.
  • Start time: The time when the stage begins.
  • End time: Time when the stage ends. If not specified, the stage continues indefinitely or until the stage supply sells out.
  • Stage type: The stage type, either Allowlist or Public.
  • Allowlist condition: The condition for stage participants. You can set one condition for each stage. For more information, see Stage conditions.
  • Per wallet mint: The total number of tokens that one wallet can buy at this stage.
  • Stage's supply: The total supply of the stage that must be equal to or less than the total launch supply.
  • Unit price (RON): The item price in RON. You can set it to 0 to show that the item is free of charge.

Stage conditions​

For each stage, you set one of the four conditions to determine who can mint in the stage:

  • No condition, or public: Anyone can take part in the stage, as long as the stage limit and the total mints per wallet permit. Public stages always occur at the end of a launch.
  • Allowlist condition: Addresses in an allowlist can mint at this stage. Compile the allowlist and upload it to the launchpad before the stage starts.
  • Token-gated condition: Users who hold a specific token can mint at this stage. Each required token allows the user to mint a specific number of NFTs.
  • Server-signed condition (coming soon): A backend server determines if the user can mint in the stage. You can use this condition for any restriction type. For example, in a free mint, you can add bot protection with a CAPTCHA.

⚠️ Cumulative mint​

A cumulative limit prevents individual users on the allowlist stage from over-purchasing throughout the entire allowlist period. If a user's eligible for more than one allowlist and token-gated stages, their limit accumulates from the previous stage. This means the user's limit doesn't reset or start anew in each stage. Instead, it carries over from one stage to the next.

For example, a user can mint three NFTs in the first stage, and they mint two. In the following stage, with a limit of four per user, the user can mint two more.

caution

The cumulative limit doesn't apply to public stages.

Step 2. Submit your launch information​

After understanding the capabilities of Mavis Launchpad and having designed your launch, submit the launch information to Sky Mavis:

  1. Make a copy of the Mavis Launchpad form.
  2. Fill out the collection and launch information. You can leave blank any information not applicable to your collection, such as a testnet or mainnet deployment.
  3. Send the form to your point of contact.

Step 3. Integrate your NFT smart contract with the launchpad​

To integrate with Mavis Launchpad, grant the minter role to the launchpad from your NFTs smart contract. During the minting process, the launchpad invokes the mint(to (address)) method in your smart contract to deliver the item to the user.

Grant the minter role to the launchpad​

  1. Visit app.roninchain.com and search for your deployed NFT contract.
  2. On the Contract tab, click Write Contract.
  3. Locate the grantRole method and fill in the following parameters:
  • Role: The role you want to grant. For Mavis Launchpad, specify 0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6 (the MINTER_ROLE as byte32).
  • Account: The address of Mavis Launchpad depending on the network you deploy to:
    • Ronin mainnet: 0xa8e9fdf57bbd991c3f494273198606632769db99
    • Saigon testnet: 0x9eaf882f8cdfef42a3c272365f9cd069a220ce7c
  1. Connect your Ronin Wallet with the administrator account and click Write.

Step 4. Create a landing page for your launch​

The landing page is the first thing users see when they visit your project. To make a good first impression, make sure your landing page is attractive and informative. Mavis Launchpad offers six different types of block layouts for the About page to choose from. You can add up to 10 blocks per page.

To create your own layout, follow these steps:

  1. Open the Mavis Launchpad Template Figma file.
  2. Click on an empty spot in the canvas to select any layers.
  3. Click the filename at the top of the page, then select Duplicate to drafts to create a copy.
  4. In your copy of the template, you can now add or remove the blocks to create your own layout.
  5. After you created the layout that fits your project, generate a shareable link to the Figma board.
  6. Paste the link in the 4. Collection about field of the form you submitted in Step 2.
Was this helpful?
Happy React is loading...