Launching Crowdfunding: from DAO upgrade to LP payout
End-to-end scenario: how a DAO prepares for crowdfunding, launches a campaign, and how contributors contribute and claim LP tokens.
This scenario walks a DAO through the full crowdfunding journey on XDAO TON — from the technical contract upgrade to the moment contributors hold LP tokens in their wallets. Each step below is either a proposal that GPs create and pass, or an action the contributor takes in their own wallet.
The app has a built-in step-by-step "Crowdfunding Setup Guide" (Create Proposal → Crowdfunding → Setup Guide) that shows the DAO's current status — Upgrade Required → Module Required → Ready — and creates the required proposals at the click of a button, in the same order described below.
Step 1. Enable crowdfunding support
Before a DAO can install crowdfunding modules, its contracts need a one-time upgrade via an Enable Crowdfunding Support proposal. This is a one-off upgrade — if the DAO has already gone through it (for example, for Distribution), you don't need to repeat it.
🔷 See Enable Crowdfunding Support.
Step 2. Install the Crowdfunding Module
The Install Crowdfunding Module proposal deploys the LP Manager in the DAO — a plugin that issues the LP token (jetton) and subsequently runs all campaigns: it accepts contributions, credits LP tokens to contributors, and processes refunds if a raise fails. The same proposal sets the LP token's name and symbol.
🔷 See Install Crowdfunding Module.
Accepting campaign funds also requires a separate Sub-Wallet (Create Sub-Wallet) — without one, the campaign creation form is locked. Installing the module is free: the platform fee (5% of the amount raised) is only deducted when a campaign completes successfully.
Step 3. Create a campaign
Once the DAO's status is Ready, launch the campaign itself with a Crowdfunding proposal: name and description, fundraising currency (TON or a jetton), LP token price, soft cap (the minimum goal below which the campaign is considered unsuccessful) and hard cap (the fundraising ceiling), per-wallet limits, timing, and, if needed, a whitelist restricting who can contribute to a specific list of addresses.
🔷 See Create Crowdfunding Campaign.
If the whitelist is enabled, addresses can be added to or removed from the list after the campaign launches via separate proposals — addresses that have already contributed cannot be removed.
GPs vote on each of the three proposals above; once general consensus is reached, the proposal executes on-chain and the DAO moves to the next step.
Step 4. Contributors contribute
While the campaign is active, any address (or a whitelisted address) opens it on the Crowdfunding tab, connects a wallet via TonConnect, and contributes TON or a jetton within the min/max per wallet. In return, once the campaign finishes, they're owed LP tokens proportional to their contribution amount.
🔷 See Contribute to Crowdfunding.
Step 5 (optional). Finish the campaign early
If the soft cap has already been reached and the end date is still far away, GPs can close the raise ahead of schedule with an Early Finish Crowdfunding proposal — for example, to put the raised funds to work sooner. If GPs take no action, the campaign finishes on its own: on the end date or once the hard cap is reached.
🔷 See Early Finish Crowdfunding.
Step 6. Campaign outcome
What happens next depends on whether the campaign reached its soft cap.
Campaign successful (soft cap reached). Any contributor can finalize it with the "Finish & Send Funds" button — the raised funds go to the DAO's Destination Sub-Wallet. After that, each contributor claims their LP tokens.
Campaign didn't reach soft cap. No LP tokens are issued — everyone who contributed funds claims a full refund of their contribution on their own.
If a Management Fee was set when the campaign was created, the DAO can claim it in LP tokens after a successful finish — see Claim DAO Management Fee.
That completes the crowdfunding cycle: the DAO received funding into a Sub-Wallet, and contributors hold LP tokens — their share entitling them to future payouts through Distribution.