Distribute Rewards in a Morpho Vault V2
Set the distribution pace and send the vault's asset to a Morpho Vault V2 to distribute incentives to its users.
A donation means sending the vault's asset directly to the vault address without minting receipt tokens. It reaches existing users through the value of the vault receipt token, at a pace capped by maxRate.
See Donations and maxRate for the accrual mechanism.
Choose the pace
maxRate caps the vault's total growth before fees, including market interest and donations. It does not cap the donation alone.
The contract stores maxRate per second in WAD (1e18). Convert a yearly rate expressed as a decimal:
maxRate = yearlyRate * 1e18 / 31_536_000For a 10% annual percentage rate (APR), use yearlyRate = 0.10. Rounding down gives maxRate = 3_170_979_198.
The upper bound is MAX_MAX_RATE = 200e16 / 31_536_000, equivalent to 200% APR. With maxRate = 0, no growth accrues, including market interest. This growth is set aside, not lost: it stays in the vault's assets and can accrue once maxRate is raised again, capped by the new rate. Losses can still be realized.
maxRate caps vault growth since the last interest accrual. The part of a donation above the allowance built up since then is spread over time, but a small donation, or one sent after a long period without accrual, can be counted all at once. To keep that immediate part small, send the donation right after setMaxRate: the call accrues interest and resets the allowance.
Before you donate
- The configured performance fee applies to donated growth as it accrues. In
accrueInterestView(),interestis the positive difference between the new and previoustotalAssets. The management fee calculation is unchanged: it uses the newtotalAssetsand elapsed time, notinterest. - Donated tokens sit idle like any other idle asset. The Allocator can allocate them, and withdrawals can use them. Moving the tokens does not change
maxRateor bypass the growth cap. - Opportunistic deposits can dilute the donation received by existing users. Read the donation warning.
- Lowering
maxRatelater slows the remaining distribution from that point onward. - Test with a small amount first.
Using the Curator app
Set the rate from an Allocator account
Open the Curator app and select your Morpho Vault V2. On the vault overview, find Max Rate under Risk Parameters and click its edit icon.
Enter the rate as an APR percentage, then click Review and confirm the transaction from your Allocator account. For the 10% APR example, enter 10; the app converts it to the per-second rate.
The call accrues interest at the previous rate before applying the new maxRate.
Transfer the vault's asset
Send the vault's asset directly to the vault address from your wallet. The Curator app does not provide a donation transfer flow. For example, for a USDC vault, send USDC directly to the vault address.
Programmatically
Call setMaxRate from an Allocator account
Call setMaxRate(newMaxRate) directly on the vault from an Allocator account. This function is Allocator-only and is not timelocked.
The call accrues interest at the previous rate before applying the new maxRate.
Transfer the asset with ERC-20 transfer
Call the asset token's ERC-20 transfer(vaultAddress, amount) to send the donation directly to the vault address.
Merkl campaigns
Vault-level rewards can also be distributed through a Merkl campaign. See Creating a Program via Merkl.