Contract Map

Source tree

• Maia-DAO/raises/src/contracts

PutManager

Central entry point, orchestrates all contract interactions

pFT

Mints positions

ftYieldWrapper

Routes capital

AaveStrategy

Deploys to Aave V3

CircuitBreaker

Rate limits outflows

YieldClaimer

Routes yield fees

FlyingTulipOracle

Deposit-time pricing

Core contracts

PutManager.sol

Entry-point 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 routes to the yield strategy and backs investor principal protection. whitelisting and caps
• Investor entry (invest)
• Exit paths (divestDivestContract function (divest / divestUnderlying) that implements 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 optional buyback and burn (if configured).)
• 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 (if enabled). 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 any 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 routes 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 routes 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, 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 keeping exits 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 routes 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 adds proportional 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, 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. The raise contract receives collateral, routes it to the yield strategy, and mints a pFT position NFT. A live oracle price feed determines USD notional for FT allocation via deposit-time conversion.-time pricing and ftPerUSD conversion.