Architecture

Voting and proposals

Any DAO action in XDAO TON — a fund transfer, a change to the GP roster, installing a plugin, launching a crowdfunding campaign — is carried out through a proposal: a member creates a proposal, GPs vote on it, and once general consensus is reached, it is executed on-chain.

How to create a proposal

Open your DAO and go to the Votes tab.

Click Create Proposal.

Select a proposal type from the list — the available types depend on the DAO's current state (for example, some crowdfunding proposal types only appear after the DAO upgrade — see Plugins and modules).

Fill in the form fields (recipient address, amount, name, description, etc. — the set of fields depends on the proposal type) and set the voting duration: 2, 3, 4 days, or a custom period.

Sign the proposal-creation transaction in your connected TON wallet (see TON wallets and TonConnect).

Once created, the proposal becomes visible to all GPs on the Votes tab. Each GP votes with weight proportional to the amount of GP in their wallet. When the share of "for" votes reaches the overall general consensus threshold, the proposal is automatically executed on-chain.

If the general consensus threshold isn't reached by the end of the voting period, the proposal is marked Rejected and is not executed.

Proposal statuses

  • Active — voting is in progress.
  • Executed — the general consensus threshold was reached, and the action was executed on-chain.
  • Rejected — the voting period ended without reaching the threshold.
  • Mine — a filter for proposals you personally created (not a separate execution status).

Overview of proposal types

Governance

ProposalWhat it does
Add GPIssues GP to a new or existing member.
Remove GPBurns the selected member's GP.
Transfer GP TokensTransfers GP between wallets within the DAO.
Change GP Transfer StatusEnables/disables direct GP token transfers.
Change General ConsensusChanges the DAO's voting threshold.
Redesign DAOChanges the DAO's name, logo, or token symbol.

Treasury and assets

ProposalWhat it does
Send DAO FundsSends TON or a jetton from the DAO balance to any address.
Send DAO NFTSends an NFT from the DAO balance to any address.
Swap DAO Funds (STON.fi)Swaps treasury assets via the STON.fi DEX.
Collect FeesCollects protocol fees from the fee contract (administrative function).
Custom ProposalAn arbitrary on-chain action on behalf of the DAO (administrative function).

Crowdfunding

ProposalWhat it does
Enable Crowdfunding SupportA one-time upgrade of the DAO contracts that unlocks access to the Crowdfunding Module.
Install Crowdfunding ModuleDeploys an LP Manager in the DAO.
Create Sub-WalletCreates a Sub-Wallet — a separate DAO wallet, for example to receive campaign funds.
CrowdfundingLaunches a new fundraising campaign.
Add to Whitelist / Remove from WhitelistAdds or removes addresses from the campaign whitelist.
Early Finish CrowdfundingEnds the campaign early and sends the funds raised to the target address.
Claim DAO Management FeeClaims the DAO's fee LP tokens after a campaign successfully completes.

Plugins and Mass Payouts

ProposalWhat it does
Install Mass Payout PluginInstalls the Mass Payout Plugin for LP holders.
Create Distribution RoundCreates a distribution round (Mode A: LP holder snapshot + claim via Merkle proof).
Close Distribution RoundCloses an active distribution round.
Withdraw Mass Payout FundsWithdraws remaining funds from the Mass Payout Plugin.

The full list of proposal types and available form fields depends on the DAO's status (regular DAO / DAO with crowdfunding enabled) and may expand as the product evolves.

On this page