Docs

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_000

For 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(), interest is the positive difference between the new and previous totalAssets. The management fee calculation is unchanged: it uses the new totalAssets and elapsed time, not interest.
  • 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 maxRate or bypass the growth cap.
  • Opportunistic deposits can dilute the donation received by existing users. Read the donation warning.
  • Lowering maxRate later 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.