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.
- Connect your wallet by visiting the auth page.
- 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.
- Pick a template from the list.
- 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
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
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
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
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
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.
| Path | Purpose |
|---|---|
| / | The home page displays contract cards for each deployable template. |
| /chat | The chat page hosts the AI agent for natural-language deployment. |
| /dashboard | The dashboard lists your deployed items. |
| /templates/launchpad | Opens the Launchpad template form. |
| /templates/kpi-rewarder | Opens the KPI Rewarder template form. |
| /templates/bounty-rewarder | Opens the Bounty Rewarder template form. |
| /templates/staking | Opens the Staking template form. |
| /templates/uniswap-v4-hook | Opens 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.
| Tool | Purpose |
|---|---|
| create_bonding_curve_launchpad | Deploys a bonding curve launchpad for token launches with dynamic pricing. |
| create_kpi_rewarder | Deploys a KPI Rewarder workflow for milestone-based rewards. |
| create_bounty_workflow | Deploys a Bounty workflow for on-chain task bounties. |
| create_staking_workflow | Deploys a Staking workflow for token staking and rewards. |
| create_hook_clmm_workflow | Deploys an Uniswap V4 Hook CLMM workflow. |
| get_launchpad_info | Fetches the current state of a launchpad. |
| get_collateral_balance | Checks 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