User Flows

Step-by-step user flows for every major operation in the Fira protocol, with sequence diagrams, preconditions, views, and events.

These pages document the end-to-end transaction flows for each user-facing operation in the Fira protocol. Each flow includes a Mermaid sequence diagram, preconditions, relevant view functions, emitted events, and reward share formulas where applicable.

All user operations go through the FiraRouterV4 (except variable-rate lending, which interacts with the LendingMarket directly). Users must approve the relevant tokens to the router before calling.

Common parameter structs

Struct	Fields
MarketParams	loanToken, collateralToken, oracle, irm, ltv, lltv, whitelist
TokenInput	tokenIn, netTokenIn, tokenMintFw, firaSwap, swapData
TokenOutput	tokenOut, minTokenOut, tokenRedeemFw, firaSwap, swapData
LimitOrderData	Pricing limits for BT/FW market swap (interface compat, not used in current version)

Flows

• Borrow at Fixed Rate

• Repay Fixed-Rate Debt

• Variable-Rate Lending

• Repay Variable-Rate Debt

• FW Deposit & Redeem

• Provide Liquidity

• Remove Liquidity

• Trade BT & CT

• Pre/Post-Expiry Exits