Reserve

The Reserve account represents a lending pool for a specific asset (e.g., SOL, USDC). It tracks liquidity, collateral, interest rates, fees, and configuration parameters.

version

u64

Program version number

last_update

LastUpdate

Last update tracking slot, staleness, and price status flags

Show LastUpdate fields

slot

u64

Solana slot when the reserve was last updated

stale

Boolean flag indicating if the reserve data is stale

price_status

Bitflags for price validation status (loaded, age checked, TWAP checked, etc.)

lending_market

Pubkey

Parent lending market account this reserve belongs to

farm_collateral

Pubkey

Optional farm account for collateral token staking rewards

farm_debt

Pubkey

Optional farm account for debt token staking rewards

liquidity

ReserveLiquidity

Liquidity state tracking available and borrowed amounts

Show ReserveLiquidity fields

mint_pubkey

Pubkey

SPL Token mint for the reserve liquidity

supply_vault

Pubkey

Token account holding available liquidity

fee_vault

Pubkey

Token account for protocol fees

total_available_amount

u64

Total liquidity available for borrowing (excluding borrowed amounts)

borrowed_amount_sf

u128

Total borrowed amount in scaled fraction format

market_price_sf

u128

Current market price in scaled fraction format (quote currency per token)

market_price_last_updated_ts

u64

Unix timestamp when the market price was last updated

mint_decimals

u64

Decimal precision of the liquidity mint

deposit_limit_crossed_timestamp

u64

Timestamp when deposit limit was first crossed (0 if not crossed)

borrow_limit_crossed_timestamp

u64

Timestamp when borrow limit was first crossed (0 if not crossed)

cumulative_borrow_rate_bsf

BigFractionBytes

Cumulative borrow rate multiplier in big fraction format

accumulated_protocol_fees_sf

u128

Accumulated protocol fees in scaled fraction format

accumulated_referrer_fees_sf

u128

Accumulated referrer fees in scaled fraction format

pending_referrer_fees_sf

u128

Pending referrer fees not yet claimed

absolute_referral_rate_sf

u128

Current absolute referral rate in scaled fraction format

token_program

Pubkey

SPL Token program (Token or Token-2022)

collateral

ReserveCollateral

Collateral token state (cTokens representing deposits)

Show ReserveCollateral fields

mint_pubkey

Pubkey

Collateral token mint (cToken mint)

mint_total_supply

u64

Total supply of collateral tokens minted

supply_vault

Pubkey

Vault holding collateral tokens

config

ReserveConfig

Reserve configuration parameters

Show ReserveConfig fields

status

Reserve status: Active (0), Obsolete (1), or Hidden (2)

host_fixed_interest_rate_bps

u16

Fixed interest rate charged to host in basis points

min_deleveraging_bonus_bps

u16

Minimum bonus for deleveraging operations in basis points

block_ctoken_usage

Boolean flag blocking collateral token usage when set

protocol_order_execution_fee_pct

Protocol fee percentage for order execution

protocol_take_rate_pct

Percentage of interest taken by protocol

protocol_liquidation_fee_pct

Protocol fee percentage on liquidations

loan_to_value_pct

Maximum loan-to-value ratio percentage (e.g., 75 = 75%)

liquidation_threshold_pct

LTV percentage at which position becomes liquidatable

min_liquidation_bonus_bps

u16

Minimum liquidation bonus in basis points

max_liquidation_bonus_bps

u16

Maximum liquidation bonus in basis points

bad_debt_liquidation_bonus_bps

u16

Liquidation bonus for bad debt in basis points

deleveraging_margin_call_period_secs

u64

Grace period in seconds before autodeleverage can execute

deleveraging_threshold_decrease_bps_per_day

u64

Rate at which deleveraging threshold decreases per day in basis points

fees

ReserveFees

Fee configuration

Show ReserveFees fields

origination_fee_sf

u64

Borrow origination fee in scaled fraction format

flash_loan_fee_sf

u64

Flash loan fee in scaled fraction format (u64::MAX = disabled)

borrow_rate_curve

BorrowRateCurve

Interest rate curve defining rates based on utilization

borrow_factor_pct

u64

Borrow weight multiplier percentage (100 = 1x, 200 = 2x)

deposit_limit

u64

Maximum deposit amount allowed in liquidity tokens

borrow_limit

u64

Maximum borrow amount allowed in liquidity tokens

token_info

TokenInfo

Oracle and token metadata configuration

deposit_withdrawal_cap

WithdrawalCaps

Rate limits for deposits and withdrawals

debt_withdrawal_cap

WithdrawalCaps

Rate limits for debt operations

elevation_groups

[u8; 20]

Array of elevation group IDs this reserve belongs to

disable_usage_as_coll_outside_emode

Boolean flag preventing use as collateral outside elevation mode

utilization_limit_block_borrowing_above_pct

Utilization percentage above which new borrows are blocked

autodeleverage_enabled

Boolean flag enabling autodeleverage for this reserve

proposer_authority_locked

Boolean flag locking proposer authority changes

borrow_limit_outside_elevation_group

u64

Borrow limit for borrows outside any elevation group

borrow_limit_against_this_collateral_in_elevation_group

[u64; 32]

Per-elevation-group borrow limits when using this as collateral

deleveraging_bonus_increase_bps_per_day

u64

Rate at which deleveraging bonus increases per day in basis points

debt_maturity_timestamp

u64

Unix timestamp when debt matures (0 = no maturity)

debt_term_seconds

u64

Term length in seconds for debt (0 = no term limit)

borrowed_amount_outside_elevation_group

u64

Total borrowed against this reserve outside elevation groups

borrowed_amounts_against_this_reserve_in_elevation_groups

[u64; 32]

Per-elevation-group borrowed amounts against this reserve

withdraw_queue

WithdrawQueue

Withdrawal queue state for managing delayed withdrawals

Show WithdrawQueue fields

queued_collateral_amount

u64

Total collateral amount in the withdrawal queue

next_issued_ticket_sequence_number

u64

Next sequence number to issue for new withdrawal tickets

next_withdrawable_ticket_sequence_number

u64

Next sequence number that can be withdrawn

Key Concepts

Utilization Rate

The utilization rate is calculated as: borrowed_amount / total_supply

Collateral Exchange Rate

The exchange rate between collateral tokens (cTokens) and liquidity tokens changes over time as interest accrues.

Interest Accrual

Interest is compounded continuously based on the borrow rate curve and current utilization.

Account Size

The Reserve account has a fixed size defined by RESERVE_SIZE constant (approximately 3KB).

BorrowRateCurve: Defines interest rates at different utilization points
TokenInfo: Oracle configuration and price feed settings
WithdrawalCaps: Time-based rate limiting configuration

Instructions

State Accounts

Error Codes

Reserve

Reserve

Key Concepts

Utilization Rate

Collateral Exchange Rate

Interest Accrual

Account Size

Build docs developers (and LLMs) love

Instructions

State Accounts

Error Codes

​Reserve

​Key Concepts

​Utilization Rate

​Collateral Exchange Rate

​Interest Accrual

​Account Size

​Related Types

Build docs developers (and LLMs) love

Reserve

Key Concepts

Utilization Rate

Collateral Exchange Rate

Interest Accrual

Account Size

Related Types