Install Mass Payout Plugin
The Mass Payout Plugin is a module that a DAO installs to distribute rewards to LP token holders and send payments to a list of addresses. Without the plugin installed, you can neither create distribution rounds nor withdraw funds from a distribution.
What the plugin provides:
- creating distribution rounds with Merkle proofs (Pull) — a gas-efficient claim for each holder;
- distributions in both TON and jettons (for example, USDT);
- sending payments to a ready-made list of addresses with fixed amounts (Push), with no claim required from recipients;
- a configurable claim window, set separately for each round.
Before installing the plugin, the DAO must have distribution support enabled — the same one-time DAO contract upgrade used for crowdfunding (the Enable Crowdfunding Support proposal). If this upgrade hasn't been done yet, the plugin installation form will show a warning instead of the form fields — see Enable Crowdfunding Support.
To install the Mass Payout Plugin:
Open your DAO and create a new proposal (Create Proposal).
Select the proposal type Install Mass Payout Plugin. If distribution support isn't enabled yet, instead of the installation form you'll see a warning and a button that immediately creates an Enable Crowdfunding Support proposal — pass and execute it first, then come back to install the plugin.
Review the proposal's name and description — they're generated automatically and can't be edited.
Specify the Voting Duration and click Create Proposal.
A DAO can install several instances of the Mass Payout Plugin. If there's more than one, you'll need to explicitly choose the plugin you want from a dropdown when creating a round, closing a round, or withdrawing funds.
GPs vote on the proposal. Once general consensus is reached, the Mass Payout Plugin is deployed in the DAO and becomes available under the Distributions tab and in the list of proposal types.
If the DAO already had a Mass Payout Plugin installed before the distribution-support upgrade, it may stop processing payouts and be marked as "out of service." In that case, install a new plugin following the steps above; if funds remain on the old plugin, contact XDAO support — they will be returned.
Once the plugin is installed, fund its balance via Send DAO Funds and create the first round — see Create Distribution Round or Push Rounds.