Mosaic Configurator Docs

Mosaic Configurator deploys pre-audited DeFi modules—launchpads, reward systems, bounties, staking—in minutes. For founders, AI agents, and builders. Read the Mosaic litepaper

Getting Started

This section walks you through the steps to deploy your first template.

  1. Connect your wallet by visiting the auth page.
  2. Choose the AI agent or the library: use Chat for natural-language deployment, or the Home page contract cards to fill out the template forms directly.
  3. Pick a template from the list.
  4. Configure the required inputs and deploy.

Watch: Deploy via Template Forms

Templates

The following templates are pre-audited DeFi modules you can deploy. Each template has specific required inputs and optional configuration; required inputs are documented in detail below.

Launchpad

The launchpad template provides a bonding curve token launch with dynamic pricing. The price rises as more tokens are bought, with no fixed ICO structure.

Required inputs

  • Token Name: The display name of the ERC-20 token created for the launchpad.
  • Token Symbol: The ticker symbol shown for the token (e.g. MYTKN).
  • Token Max Supply: The maximum number of tokens that can exist. Enter in token units, not wei.
  • Initial Issuance Supply: The amount of tokens initially placed on the bonding curve. Enter in token units.
  • Initial Collateral Supply: The amount of collateral (e.g. ETH) initially paired with the curve. Enter in token units.
  • Threshold: The target raise amount in collateral; the curve matures when this is reached. Enter in token units.
  • Vault Allocation (bps): The share of proceeds allocated to the vault in basis points (1 bps = 0.01%). Maximum is 10,000 (100%).

Use cases:

  • New token launch
  • Community tokens
  • Fair-launch memecoins
  • Prediction market tokens
Create Launchpad →

KPI Rewarder

The KPI rewarder allows the payment or distribution of staking rewards once predefined conditions are met. Outcomes are verified trustlessly via the UMA Optimistic Oracle.

Required inputs

  • Staking Token Address: The ERC-20 token that users will stake. Ensure that the token is valid on the selected network.
  • Reward Token Address: The token used to distribute rewards when KPIs are met. Ensure that the token is valid on the selected network.
  • Oracle Currency Address: The token used for UMA Oracle bonds (typically WETH). Asserters must deposit this to submit KPI claims. Ensure that the token is valid on the selected network.
  • Default Bond (in tokens): The bond amount required to submit KPI assertions. Disputed assertions can lose this bond.
  • Assertion Liveness (seconds): The time window during which assertions can be disputed (e.g. 21600 for 6 hours). After this period, assertions finalize.

Use cases:

  • Team performance bonuses
  • Milestone-based incentives
  • Community goal rewards
  • Retroactive funding
Create KPI Rewarder →

Bounty Rewarder

The bounty rewarder enables on-chain bounties with automatic payouts. You define tasks, fund escrow, and rewards are paid when tasks are resolved as complete.

Required inputs

  • Payment Token Address: The ERC-20 token used to pay bounties (e.g. USDC). Ensure that the token is valid on the selected network.

Use cases:

  • Bug bounties
  • Task completion rewards
  • Contributor payouts
  • Hackathon prizes
Create Bounty →

Staking

The staking template enables token staking with continuous, configurable rewards. Users stake one token and earn another over time.

Required inputs

  • Staking Token Address: The ERC-20 token that users will stake. Ensure that the token is valid on the selected network.
  • Reward Token Address: The token used to distribute rewards to stakers. Ensure that the token is valid on the selected network.

Use cases:

  • Liquidity mining
  • Governance staking
  • Yield farming
  • Token distribution
Create Staking →

Uniswap V4 Hook CLMM

The Uniswap V4 Hook CLMM template integrates a bonding curve workflow with Uniswap V4 through custom hooks, enabling custom AMM logic on top of Uniswap.

Required inputs

  • Curve Token Address: The token distributed during the bonding curve phase. Ensure that the token is valid on the selected network.
  • Collateral Token Address: The token users pay to buy curve tokens (e.g. USDC, WETH). Ensure that the token is valid on the selected network.
  • Advanced parameters (optional): Max Supply, Gamma, Slug Range Width, Slugs Ahead, Protocol Fee (bps), Target Graduation Price, and Starting Tick have defaults; adjust them to change curve shape and graduation behavior.

Use cases:

  • DEX-integrated launchpad
  • Custom liquidity curves on Uniswap
  • Trading-pair launchpads
Create Hook CLMM →

AI Agent

The AI agent enables you to deploy templates through natural language. This section describes how the agent works and what you need to configure.

The chat agent uses Coinbase AgentKit to execute transactions on your behalf. You can ask it to create a Launchpad, KPI Rewarder, Bounty, Staking, or Hook CLMM workflow. You must add the agent as a signer to your Privy wallet before it can submit transactions.

Watch: Deploy via AI Agent

Routes

The application exposes several routes. The table below lists each path and its purpose.

PathPurpose
/The home page displays contract cards for each deployable template.
/chatThe chat page hosts the AI agent for natural-language deployment.
/dashboardThe dashboard lists your deployed items.
/templates/launchpadOpens the Launchpad template form.
/templates/kpi-rewarderOpens the KPI Rewarder template form.
/templates/bounty-rewarderOpens the Bounty Rewarder template form.
/templates/stakingOpens the Staking template form.
/templates/uniswap-v4-hookOpens the Uniswap V4 Hook CLMM template form.
/projects/<type>/<address>The project explorer for a deployed item (Read, Write, and Info views).

Agent Tools

The AI agent uses the following tools to interact with the configurator. These correspond to the templates and read operations available in the app.

ToolPurpose
create_bonding_curve_launchpadDeploys a bonding curve launchpad for token launches with dynamic pricing.
create_kpi_rewarderDeploys a KPI Rewarder workflow for milestone-based rewards.
create_bounty_workflowDeploys a Bounty workflow for on-chain task bounties.
create_staking_workflowDeploys a Staking workflow for token staking and rewards.
create_hook_clmm_workflowDeploys an Uniswap V4 Hook CLMM workflow.
get_launchpad_infoFetches the current state of a launchpad.
get_collateral_balanceChecks a user's collateral balance.

Terminology

This section defines key identifiers used when referring to templates and deployed items in the app.

TemplateId values: launchpad, kpi-rewarder, bounty-rewarder, staking, uniswap-v4-hook

DeployedItem.type values: Launchpad, KPI Rewarder, Bounty Rewarder, Staking, Uniswap V4 Hook CLMM