State and Interfaces

Important State Variables

Variable	Description
collateralSupply[token]	Active backing collateral supplyCollateral SupplyState variable (collateralSupply[token]) tracking active backing collateral per token type. Increases on deposit, decreases on redeem. per token type
capitalDivesting[token]	Released 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. available for project pull (capital divestingCapital DivestingState variable (capitalDivesting[token]) tracking released collateral available for the project to pull for buyback and burn operations. Increases when investors withdraw FT.)
ftOfferingSupply	FT available for saleftOfferingSupplyState variable tracking FT(fundraising token) available for sale to new investors. Decreases when investors withdraw FT. to new investors
ftAllocated	FT currently allocatedftAllocatedState variable tracking FT(fundraising token) currently allocated to active investor positions. Decreases on redeem and withdraw. to active positions

Terminology Mapping

Mechanism docs in this site follow 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. implementation terms:

Mechanism Term	Implementation Term
PositionpFTERC-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.	pFT ERC-721 NFT
RedeemRedeemExercise principal protection and exit to collateral. Implemented by the divest contract function. Always available, permissionless, and on-chain. / exercise PUT	divestDivestContract function (divest / divestUnderlying) implementing exits via redeem. Returns collateral (or strategy position tokens) to the investor. / divestUnderlying
WithdrawWithdrawClaim 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. / claim 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.	withdrawFT
Hold	No transaction (default state)
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. / invest	invest

Contract Interfaces

Key entry points are listed below. See Contract Map for full contract descriptions.

PutManager — Core Entry Points

• invest(token, amount) — 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. 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. and receive position
• divest(id, amount) — redeemDivestContract function (divest / divestUnderlying) implementing exits via redeem. Returns collateral (or strategy position tokens) to the investor. position for 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.
• divestUnderlying(id, amount) — redeemRedeemExercise principal protection and exit to collateral. Implemented by the divest contract function. Always available, permissionless, and on-chain. position for strategy tokens (e.g., aTokens)
• withdrawFT(id, amount) — claim FT tokensWithdrawClaim 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., forfeit protection
• enableTransferable() — enable exits via withdrawWithdrawClaim 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.

ftYieldWrapper — Strategy Interface

• deposit(amount) — route 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 strategy
• withdraw(amount) — withdrawWithdrawClaim 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. 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. from strategy
• claimYield() — trigger 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. distribution

CircuitBreaker — Rate Limiting

• checkAndRecordOutflow(amount) — verify and record outflow against limits
• recordInflow(amount) — record inflow for elastic buffer

Events

Event signatures are defined in each contract’s source. See Contract Map for contract locations.