Program reference — Comet Docs

Accounts

Account	One per	Holds
`Market`	Deployment	The lists of reserves and pools, and the protocol’s parameters
`Reserve`	Asset	The token vault, borrow and supply indexes, rate curve, collateral weights, backstop balance, oracle feed
`MarginAccount`	Account a wallet opens	Deposit shares and borrows per reserve
`Pool`	Pair and fee tier	Current price and tick, liquidity in range, fee growth, the price average
`TickArray`	Span of ticks in a pool	Liquidity and fee growth at each initialized tick
`Range`	Liquidity position	Owner account, ticks, liquidity, margin, debt per token
`Perp`	Perp position	Owner account, side, held shares, debt, entry price

Instructions

Accounts and Lend

Instruction	Arguments	Does
`create_account`	—	Opens a margin account for the signer
`deposit`	`amount`	Supplies tokens to a reserve
`withdraw`	`amount`	Withdraws a deposit, within the borrow limit
`borrow`	`amount`	Borrows from a reserve to the signer’s wallet
`repay`	`amount`	Repays a borrow

Pools

Instruction	Arguments	Does
`swap`	`amount_in, min_out, base_to_quote`	Swaps against a pool
`open_range`	`OpenRangeArgs`	Mints a range, with or without borrowed tokens
`collect_fees`	—	Moves a range’s fees into the account’s deposits
`close_range`	`fraction, min_base, min_quote`	Removes liquidity, repays debt, returns the rest

Perps

Instruction	Arguments	Does
`open_perp`	`OpenPerpArgs`	Opens a long or short
`close_perp`	`fraction, min_out`	Closes all or part of a position
`add_margin`	`amount`	Moves deposits into a range or perp
`remove_margin`	`amount`	Moves margin back, down to the opening requirement

Liquidation

Instruction	Arguments	Does
`liquidate_account`	`repay_amount`	Repays a borrow and receives collateral with the bonus
`liquidate_position`	—	Closes a range or perp at maintenance and pays the caller’s fee

Argument structs

open_perp

pub struct OpenPerpArgs {
    /// Long or Short.
    pub side: Side,
    /// Taken from the account's deposits, in the pool's quote token.
    pub margin: u64,
    /// Drawn from Lend: the quote token for a long, the base token for a short.
    pub borrow: u64,
    /// The least the opening swap must return.
    pub min_out: u64,
}

open_range

pub struct OpenRangeArgs {
    pub tick_lower: i32,
    pub tick_upper: i32,
    /// Margin taken from the account's deposits, per pool token.
    pub margin_base: u64,
    pub margin_quote: u64,
    /// Borrowed from Lend, per pool token. Zero for an unleveraged range.
    pub borrow_base: u64,
    pub borrow_quote: u64,
    /// The least liquidity the range must mint.
    pub min_liquidity: u128,
}

Units and precision

Value	Type	Unit
Token amounts	`u64`	The mint’s smallest unit
Rates and indexes	`u128`	Fixed point, 18 decimals
Pool price	`u128`	Square root of the price, Q64.64
Ticks	`i32`	Price = 1.0001^tick
Fractions (`close_perp`, `close_range`)	`u16`	Basis points; 10,000 closes the whole position

Interest inside instructions

Every instruction that reads a reserve first brings its indexes up to the current slot, so a transaction never needs a separate refresh step and always sees current debt.