For the complete documentation index, see llms.txt. This page is also available as Markdown.

Contract Deployments

Mainnet contract addresses, market configurations, oracle pipelines, router facets, and key roles for the Fira Protocol deployment.

Network: Ethereum Mainnet Initial Deployment: March 13–15, 2026 Bond Token Expiries: May 7, 2026 · May 27, 2026


External tokens

Token
Symbol
Decimals
Address

USDC

USDC

6

Wrapped stETH

wstETH

18

Coinbase Wrapped BTC

cbBTC

8

PT Ethena USDe 7MAY2026

PT-USDe

18

PT Ethena sUSDe 7MAY2026

PT-sUSDe

18

PT Paxos USDG 27MAY2026

PT-USDG

18

PT Apyx apxUSD 18JUN2026

PT-apxUSD

18

Fira tokens

Token
Symbol
Decimals
Address

Fira Wrapped USDC

FW-USDC

18

Bond Token

BT

6

Coupon Token

CT

6

Markov USDC Prime (SisuVault)

mkUSDC

18

May 27, 2026 Expiry

Token
Symbol
Decimals
Address

Bond Token (27MAY)

BT

6

Coupon Token (27MAY)

CT

6

June 18, 2026 Expiry

Token
Symbol
Decimals
Address

Bond Token (18JUN)

BT

6

Coupon Token (18JUN)

CT

6

BT and CT are minted/burned in pairs via the YieldContractFactory. Multiple expiry series can coexist.

Core protocol contracts

Contract
Address
Description

FiraRouterV4

Main entry point for all user operations

USDCFW (FW)

Wrapped Standardized Yield token for USDC

SisuVault

ERC-4626 vault aggregating yield across markets

LiquidityInjector

Sole BT supplier to fixed-rate markets

RehypothecationModule

Controls phi ratios for rebalancing

YieldContractFactory

Deploys BT/CT pairs

FiraMarketFactory

Deploys AMM markets

BCLpOracle

Oracle for BC/LP pricing

AdaptiveCurveIrm

Interest rate model for variable-rate markets

FIRA Yield Treasury

Fee recipient

Lending markets

Contract
Address
Description

VariableLendingMarket

Variable-rate lending (wstETH, cbBTC collateral)

FiraLendingMarket

Fixed-rate lending (PT collateral, BT loan token)

AMM markets

FiraMarket — May 7, 2026

Field
Value

FiraMarket

BT

FW

Expiry

May 7, 2026 (1778112000)

scalarRoot

102406700000000000000

initialAnchor

1008276800000000000

lnFeeRateRoot

2996000000000000

FiraMarket — May 27, 2026

Field
Value

FiraMarket

BT

FW

Expiry

May 27, 2026

FiraMarket — June 18, 2026

Field
Value

FiraMarket

BT

FW

Expiry

June 18, 2026

Variable-rate markets

wstETH / USDC

Field
Value

Lending Market

Market ID

0xB3152AC00687CC9502B78AB452956F85CC89AC210DEEFDA5DBFF09F7F167B544

Loan Token

Collateral Token

Oracle

0x48F7E36EB6B826B2dF4B2E630B62Cd25e89E40e2 (Morpho wstETH/USDC)

IRM

0x73C288826347af3718e6F09c2A24AaFDA77684cD (AdaptiveCurveIrm)

LTV

87%

LLTV

89%

Whitelist

None (permissionless)

cbBTC / USDC

Field
Value

Lending Market

Market ID

0x39D3BDD30BF4BCF4A4D3547F2484ABE1E30A2DCD41ED83788B40E2720357AB76

Loan Token

Collateral Token

Oracle

0x698253A24CC4926090f841B38D31d6342A00a82C (ChainlinkOracleV2 cbBTC/USDC)

IRM

0x73C288826347af3718e6F09c2A24AaFDA77684cD (AdaptiveCurveIrm)

LTV

88%

LLTV

90%

Whitelist

None (permissionless)

Fixed-rate markets

All fixed-rate markets use the FiraLendingMarket at 0x280ddD897F39C33fEf1CbF863B386Cb9a8e53a0e. BT is the loan token. Only the LiquidityInjector can supply BT (whitelist-gated).

PT-USDG / BT (May 27 Expiry)

Field
Value

Loan Token

BT 27MAY (0x88dd7069cb9d8b7cc6eebd23b82ed1e9a75d9734)

Collateral Token

Oracle

0x90d0d6fdf9fe93777085e8b4baf3aab4285bac6b (FiraSolvencyOracle)

IRM

0x0000000000000000000000000000000000000000 (none — fixed rate)

LTV

94%

LLTV

94.75%

Whitelist

0x2104f638a839Ca7260180d9Ee7f4865C92Df4cE5 (LiquidityInjector)

Maturity Grace Period

86400 (24h)

Liquidation Incentive

1%

PT-USDe / BT

Field
Value

Loan Token

Collateral Token

Oracle

0xeB30b33A1aC175e0305853636D0eF3898eb530f3 (FiraSolvencyOracle)

IRM

0x0000000000000000000000000000000000000000 (none — fixed rate)

LTV

89%

LLTV

90%

Whitelist

0x2104f638a839Ca7260180d9Ee7f4865C92Df4cE5 (LiquidityInjector)

Maturity Grace Period

86400 (24h)

Liquidation Incentive

3.1%

BT Liquidity

350 BT supplied by LI

PT-sUSDe / BT

Field
Value

Loan Token

Collateral Token

PT-sUSDe (0x3de0ff76E8b528C092d47b9DaC775931cef80F49)

Oracle

0xB9bAA3D58E1431776218F39919fd21AeD3e69aBb (FiraSolvencyOracle)

IRM

0x0000000000000000000000000000000000000000 (none — fixed rate)

LTV

89%

LLTV

90%

Whitelist

0x2104f638a839Ca7260180d9Ee7f4865C92Df4cE5 (LiquidityInjector)

Maturity Grace Period

86400 (24h)

Liquidation Incentive

3.1%

BT Liquidity

350 BT supplied by LI

PT-apxUSD / BT (June 18 Expiry)

Market ID

Field
Value

Loan Token

BT 18JUN (0x33fd40eD7744c961b61a086A87F83787bd9606eE)

Collateral Token

PT-apxUSD (0x92a6a01b07984de46c24e8eba248449beb8b1dcb)

Oracle

0x5ccdbef28bc15d306ddb949f6b43bb0e3002cea6 (FiraSolvencyOracle)

IRM

0x0000000000000000000000000000000000000000 (none — fixed rate)

LTV

88% (sentinel 0: maxLTV == LLTV)

LLTV

88%

Whitelist

0x2104f638a839Ca7260180d9Ee7f4865C92Df4cE5 (LiquidityInjector)

Maturity Grace Period

86400 (24h)

Liquidation Incentive

3.73%

Oracle pipeline

Variable-rate oracles

Market
Oracle
Type

wstETH/USDC

Morpho v1 oracle (pre-deployed, reused)

cbBTC/USDC

ChainlinkOracleV2 (BTC/USD + USDC/USD feeds)

Fixed-rate oracle pipeline (May 7 Expiry)

PT-USDe and PT-sUSDe markets use a 3-layer oracle stack:

Layer
PT-USDe
PT-sUSDe

AaveToChainlinkAdapter

ChainlinkOracleV2

FiraSolvencyOracle

Fixed-rate oracle pipeline (May 27 Expiry — PT-USDG)

The PT-USDG market uses a MetaOracleDeviationTimelock with primary/backup oracle redundancy:

Layer
Address
Description

MetaOracleDeviationTimelock

Deviation threshold: 0.5%

Primary Oracle

1:1 USDG peg + Pendle TWAP

Backup Oracle

Chainlink USDG/USD + Pendle TWAP

FiraSolvencyOracle

Final solvency check

Fixed-rate oracle pipeline (June 18 Expiry — PT-apxUSD)

The PT-apxUSD market reuses the Morpho-listed MorphoChainlinkOracleV2 directly. Two BASE feeds (Pendle PT-apxUSD TWAP × Apyx Capped CR) are combined and divided by the USDC/USD QUOTE feed:

Layer
Address
Description

MorphoChainlinkOracleV2

Reused from Morpho listing

BASE_FEED_1 (Pendle PT TWAP)

PT-apxUSD TWAP feed

BASE_FEED_2 (Apyx CR)

Apyx Capped CR feed

QUOTE_FEED_1 (Chainlink)

USDC/USD

FiraSolvencyOracle

Final solvency check

Feed
Address

BTC/USD

USDC/USD

Router facets

The FiraRouterV4 uses a facet-based (diamond-like) architecture. All user-facing calls go through the Router, which delegates to the appropriate facet.

Facet
Address
Functions

ActionSwapBTV3

BT swaps

ActionSwapCTV3

CT swaps

ActionAddRemoveLiqV3

Liquidity add/remove

ActionCallbackV3

Internal swap callbacks

ActionSimple

Simple token transfers

ActionMiscV3

FW/BC minting, simulate

ActionBorrow

Borrow/repay

ActionStorageV4

Router admin

Factory contracts

Contract
Address

ChainlinkOracleV2Factory

SisuVaultFactory

YieldContractFactory

FiraMarketFactory

Key roles

Role
Address

SisuVault Curator

0xc02B0D1ca7B986E63cf1599F9c32e8A96c2D4Cff (Markov Labs)

SisuVault Allocator

0x4E700A14868620a9Bba0669721F1945c410c7571 (Markov Labs)

FIRA Yield Treasury

Deployer EOA

Last updated