Getting started
Using the app
The app at recurvemoney.xyz/app reads every fund straight from chain. Deposit, exit, veto, stake and cast verdicts from a wallet.
Connecting
Injected wallets (MetaMask and the like) always work. WalletConnect's QR flow works when the deployment carries a project id; without one it is simply absent. The app is pinned to Robinhood Chain and asks the wallet to switch if it is elsewhere.
Every number on screen is read from the contracts, most of them in one multicall per fund so they all describe the same block. Only the equity chart and the risk panel come from the indexer; if it is down those two say so and the rest of the app carries on. A dead RPC shows as an RPC unreachable chip in the header.
Funds
The landing tab lists every fund the build knows about with its TVL, float, deployed capital and share price. A dash means the read failed, not that the vault is empty. Open a fund for its detail view: the TVL chart with 24h / 7d / 30d / all ranges, derived risk figures (total return, max drawdown, days since the high-water mark, all from the share-price series), the proposal list, and the governor's parameters — voting window, depositor veto threshold, blocks to stop, performance fee — read live.
Deposit
Type an amount in the vault's asset, or Max for your whole balance. The first deposit is three transactions and two clicks:
- Approve. If the vault's allowance is short the button reads Approve <asset> and sends an unlimited approval, then asks you to submit again.
- Deposit, then delegate to yourself, back to back. Voting weight is zero until delegated, so the app never leaves you holding shares that cannot veto.
The vault carries a deposit cap of 10,000 USDG; the app does not display it. Shares carry the asset's decimals, so the number you see under Shares is in the same scale as the asset.
Exit
Switch to Redeem and enter shares. Before you submit, the panel warns when the
float does not cover the exit: The exit will queue and settle at the realized price.
That is what happens on chain — requestRedeem pays instantly when the idle balance
covers it, otherwise it escrows your shares and gives you a queue position. Queued requests
appear below the form as Request #n with a Claim button; a claim goes through
once the vault's idle balance covers the request, priced at that moment, and reverts with
Not claimable yet until then.
Escrowed shares carry no voting weight while they wait, and the claim has to come from the address that made the request. There is no cancel: a queued request either clears or waits.
Veto
A proposal row shows its target, the assets it moves, the size of its calldata, how many watchers have blocked it, and the veto weight gathered so far as a share of supply at the snapshot. While the window is open and you have weight at that snapshot, the row offers Veto with N votes. Weight is what you had delegated one block before the proposal was posted; if the row says No weight at this snapshot, delegate now and it counts from the next proposal. Vetoes are one per address and cannot be taken back.
A proposal stays Pending with Window closed. Waiting on the agent to execute in two very different situations: the agent has not executed yet, or it never can — enough watchers blocked it, or its price floor is stale. The chain does not distinguish them; see proposal states.
Watcher
The Watcher tab is the registry from a staker's side. It shows your stake, the minimum, whether you are active, and your RECURVE balance.
- Stake — approve RECURVE to the registry (unlimited, once), then stake. You are active from the moment your stake reaches the minimum.
- Cast a verdict — pick a proposal from the list (every fund's proposals, newest first) or paste a 32-byte id, then Block or Approve. A verdict is final. Simulate the calldata first; approving a call that drains a vault is what a conviction slashes.
- Request unstake — starts the delay on your whole stake. You stay active and slashable until Withdraw completes after the delay.
When something reverts
Every transaction is simulated before the wallet opens, so a revert arrives as a sentence rather than a wallet's gas-estimation failure: The vault cannot release that much right now, Still inside the veto window, Stake is under the minimum. The full map from contract error to sentence is under Errors.