Reference
Errors
Every custom revert across the four contracts, what it means, and what to do about it.
Every name here is a custom error. Through the app they arrive as a sentence; through the SDK they arrive as an undecoded selector, because its trimmed ABIs carry no error entries — decode with the full ABI from the protocol repo to see the name.
RecurveVault
| Error | Meaning |
|---|---|
OnlyGovernor | Capital moves only through the governor. Also what everyone sees before setGovernor has run. |
OnlyDeployer | setGovernor and raiseDepositCap are for whoever deployed the vault. |
GovernorAlreadySet | The governor is set once. Also raised for a zero address. |
CapCannotDecrease | raiseDepositCap only goes up. The new cap must exceed the current one. |
FloatTooLow | The proposal moves more than the vault holds idle. |
RequestNotReady | The idle balance cannot cover the queued exit at today's price. It rises when the strategy returns assets, independently of settle. |
RequestAlreadyClaimed | Already withdrawn. |
NotRequestOwner | That queue position belongs to another address — the one that owned the shares, not the receiver. |
Also from the vault, inherited from OpenZeppelin: ERC4626ExceededMaxDeposit /
ERC4626ExceededMaxMint above the deposit cap, ERC4626ExceededMaxWithdraw /
ERC4626ExceededMaxRedeem, ERC20InsufficientBalance and
ERC20InsufficientAllowance, and a plain Panic(0x32) for a
claimRedeem on a request id that does not exist.
RecurveGovernor
| Error | Meaning |
|---|---|
OnlyAgent | Wrong key. Caller is not in the agent set; check isAgent. |
OnlyAgentAdmin | Only agentAdmin can add or remove agents or hand the role on. |
AlreadyAgent | addAgent on an address already in the set. |
NotAnAgent | removeAgent on an address that is not in the set. |
UnknownProposal | No proposal with that id — from veto and execute. settle on an unknown id says WrongState instead. |
WrongState | Proposal is not in the state that call needs: veto and execute need Pending, settle needs Executed. Read stateOf first. |
VetoWindowOpen | Too early to execute. executableAt says when. |
VetoWindowClosed | Too late to veto. |
AlreadyVetoed | One veto per address per proposal. |
NoVotingWeight | No shares at the snapshot, or never delegated. |
WatchersBlocked | Enough watchers blocked. The proposal stays Pending on chain forever and can never execute; propose again rather than retrying. |
ExecutionFailed | The target call reverted — on a strategy, usually a floor the market moved past. |
FeeTooHigh | Constructor rejects anything above 1500 bps. |
settle also surfaces the fee token's ERC20InsufficientAllowance or
ERC20InsufficientBalance when the calling agent has not approved the governor, or
does not hold, the fee.
WatcherRegistry
| Error | Meaning |
|---|---|
OnlyGovernor | convict is called by the registry's governor address, not by watchers. |
BelowMinStake | Stake under the minimum, the minimum was raised, or the stake was slashed. Stake again to re-activate. |
AlreadyVoted | Verdicts are final. |
AlreadyConvicted | A conviction cannot be replayed. |
NothingStaked | No stake to withdraw. |
UnstakeNotReady | Delay has not elapsed. |
NoPendingUnstake | No open request, or a conviction cleared it. |
ZeroAmount | stake(0), or requestUnstake for zero or for more than the stake. |
StakeTokenAlreadySet | The stake token is named once. setStakeToken cannot change it. |
ZeroToken | setStakeToken was given the zero address. |
Admin calls revert with OpenZeppelin's OwnableUnauthorizedAccount.
PortfolioStrategy
| Error | Meaning |
|---|---|
OnlyGovernor | Every call that moves tokens is governor-only, which means it has to be an executed proposal. |
TokenNotAllowed | Not in the basket fixed at construction. |
SlippageTooHigh | The floor is more than maxSlippageBps below the stated quote, or the quote is zero. At construction: a cap above 10%. |
WeightsMustSumToBps | setWeights must sum to exactly 10,000. |
WeightCountMismatch | One weight per token; at construction, one fee tier per token. |
NoTokens | An empty basket. |
DuplicateToken | The same token twice in the basket. |
A swap that fills below the floor reverts inside the router with Uniswap's
"Too little received", which the governor reports as
ExecutionFailed.