Contract Map

Source tree

• Maia-DAO/raises/src/contracts

Core contracts

PutManager.sol

Primary orchestration contract for raise operations:

• CollateralCollateralThe asset an investor deposits into a raise (e.g., USDC, WETH). Each accepted collateral type runs in an isolated pool with independent reserve accounting. Active collateral is routed to the yield strategy and backs investor principal protection. whitelisting and caps
• Investor entry (invest)
• Exit paths (divestDivestContract function (divest / divestUnderlying) implementing exits via redeem. Returns collateral (or strategy position tokens) to the investor., divestUnderlying, withdrawFTWithdrawClaim project tokens and forfeit principal protection on the withdrawn amount. Implemented by withdrawFT. Requires transferable to be enabled. Released capital moves to capitalDivesting for buyback and burn.)
• Transferability toggle (enableTransferable)
• Capital release tracking (capitalDivestingCapital DivestingState variable (capitalDivesting[token]) tracking released collateral available for the project to pull for buyback and burn operations. Increases when investors withdraw FT.)

pFT.sol

pFTpFTERC-721 position token representing an investor's position. Stores collateral token, amounts, FT(fundraising token) allocation, and strike/oracle context. Transferable as a standard NFT. position token contract used by PutManager.

• Uses ERC-721 position tokens
• Stores per-position state (collateralCollateralThe asset an investor deposits into a raise (e.g., USDC, WETH). Each accepted collateral type runs in an isolated pool with independent reserve accounting. Active collateral is routed to the yield strategy and backs investor principal protection. token, amount, FTFT (Fundraising Token)The project's token being sold in a raise. Investors receive fundraising token allocation at deposit time, which they can later withdraw to claim the FT tokens. allocated, strikeStrikeOracle price at deposit time, scaled to 1e8 (Chainlink standard). Recorded during deposit-time conversion and used for exit calculations — the oracle is not consulted again at exit time., etc.)
• Supports partial divest and withdrawFT updates

ftYieldWrapper.sol

CollateralCollateralThe asset an investor deposits into a raise (e.g., USDC, WETH). Each accepted collateral type runs in an isolated pool with independent reserve accounting. Active collateral is routed to the yield strategy and backs investor principal protection. wrapper and strategy router:

• deposit and withdraw paths for put servicing
• Strategy list management
• YieldYieldReturns generated by the yield strategy on deposited collateral. Variable and not guaranteed. Distributed via the yield waterfall: platform fee (10%) to DAO, then net yield (90%) to the project. claiming hooks
• Circuit breakerCircuit BreakerVelocity control on outflows that limits how fast capital can leave through wrapper withdraw paths. Uses a dual-buffer model to protect against exploit-velocity drains while ensuring exits remain available over time. integration (checkAndRecordOutflow, recordInflow)

AaveStrategy.sol

Default strategy implementation:

• Supplies collateralCollateralThe asset an investor deposits into a raise (e.g., USDC, WETH). Each accepted collateral type runs in an isolated pool with independent reserve accounting. Active collateral is routed to the yield strategy and backs investor principal protection. to Aave V3
• Tracks principal via strategy share supply
• Exposes yield = valueOfCapital - totalSupply (simplified, see implementation for details)
• Supports optional withdrawUnderlying path for position-token exit

CircuitBreaker.sol

Dual-bufferDual-Buffer ModelThe circuit breaker's two-part rate limiter: a main replenishing buffer that caps total outflow within a time window, and an elastic buffer that tracks recent inflows and allows proportional additional outflow capacity. rate limiter for inflows/outflows:

• Main replenishing buffer
• Elastic buffer tracking recent inflows
• Protected-contract registry
• Owner-configurable windows and max draw rate

YieldClaimer.sol

YieldYieldReturns generated by the yield strategy on deposited collateral. Variable and not guaranteed. Distributed via the yield waterfall: platform fee (10%) to DAO, then net yield (90%) to the project. routing helper for fee splits and treasury flows.

FlyingTulipOracle.sol

Oracle adapter used for depositDepositThe action of investing collateral into a raise. Collateral is received by the raise contract, routed to the yield strategy, and a pFT position NFT is minted. At deposit time, a live oracle price feed determines USD notional for FT allocation via deposit-time conversion.-time pricing and ftPerUSD conversion.