marginfi v2 decoder

carbon-marginfi-v2-decoder decodes the instructions, accounts and events of the marginfi v2 program (MFv2hWf31Z9kbCa1snEPYctwafyhdvnV7FZnsebVacA): 91 instructions, 15 account types, 30 events. It is generated with Codama from the program's IDL; see decoders for how decoders plug into a pipeline.

Other lending decoders: Jupiter Lend, Kamino Lending, Kamino Vault, Meteora Vault, Sharky. To decode several in one pipeline, see lending decoders.

The serde feature derives Serialize/Deserialize on every type, postgres adds tables and processors for Postgres, and graphql adds a schema for the GraphQL server.

Usage#

This program crawls recent marginfi v2 transactions from the public RPC and prints every decoded ConfigGroupFee instruction. Add the dependencies:

cargo add carbon-core@2.0.0 carbon-marginfi-v2-decoder@2.0.0 carbon-rpc-transaction-crawler-datasource@2.0.0 carbon-log-metrics@2.0.0 env_logger tokio --features tokio/full

use {
    carbon_core::{
        error::CarbonResult, instruction::InstructionProcessorInputType, pipeline::Pipeline,
        processor::Processor,
    },
    carbon_log_metrics::LogMetrics,
    carbon_marginfi_v2_decoder::{
        instructions::MarginfiV2Instruction, MarginfiV2Decoder, PROGRAM_ID,
    },
    carbon_rpc_transaction_crawler_datasource::{ConnectionConfig, Filters, RpcTransactionCrawler},
    std::sync::Arc,
};

#[tokio::main]
async fn main() -> CarbonResult<()> {
    env_logger::init();

    // Fetches the program's recent transactions over JSON-RPC, newest first.
    let datasource = RpcTransactionCrawler::new(
        "https://api.mainnet-beta.solana.com".to_string(),
        PROGRAM_ID,
        ConnectionConfig::default(),
        Filters::new(None, None, None),
        None,
    );

    Pipeline::builder()
        .datasource(datasource)
        .metrics(Arc::new(LogMetrics::new()))
        .instruction(MarginfiV2Decoder, InstructionLogger)
        .build()?
        .run()
        .await
}

struct InstructionLogger;

impl Processor<InstructionProcessorInputType<'_, MarginfiV2Instruction>> for InstructionLogger {
    async fn process(
        &mut self,
        input: &InstructionProcessorInputType<'_, MarginfiV2Instruction>,
    ) -> CarbonResult<()> {
        let signature = input.metadata.transaction_metadata.signature;
        if let MarginfiV2Instruction::ConfigGroupFee { data, accounts, .. } = input.decoded_instruction {
            println!("config_group_fee {signature}: {data:?} marginfi_group={}", accounts.marginfi_group);
        }
        Ok(())
    }
}

RUST_LOG=info cargo run

Each ConfigGroupFee instruction prints one line with the transaction signature and the decoded ConfigGroupFee data. The public endpoint rate-limits requests, so the first lines can take a while; use your own RPC URL for anything beyond a test. See stream with RPC for the crawler options.

Events published with Anchor's emit_cpi! arrive as the CpiEvent instruction. Match them with MarginfiV2Instruction::CpiEvent { data: CpiEvent::DeleverageEvent(event), .. } (import instructions::CpiEvent); see Events. If CpiEvent never arrives, the program logs its events with emit! instead: decode them with decode_log_events.

Decode accounts#

The transaction crawler emits transactions only. To decode accounts, use a datasource that emits account updates. This program subscribes to the program's accounts with programSubscribe on the public WebSocket endpoint and prints every decoded MarginfiAccount account as it changes. Add the datasource and the Solana RPC types it takes:

cargo add carbon-rpc-program-subscribe-datasource@2.0.0 solana-client@4.2.2

use {
    carbon_core::{
        account::AccountProcessorInputType, error::CarbonResult, pipeline::Pipeline,
        processor::Processor,
    },
    carbon_log_metrics::LogMetrics,
    carbon_marginfi_v2_decoder::{accounts::MarginfiV2Account, MarginfiV2Decoder, PROGRAM_ID},
    carbon_rpc_program_subscribe_datasource::{Filters, RpcProgramSubscribe},
    solana_client::rpc_config::{RpcAccountInfoConfig, RpcProgramAccountsConfig, UiAccountEncoding},
    std::sync::Arc,
};

#[tokio::main]
async fn main() -> CarbonResult<()> {
    env_logger::init();

    // Streams every change to an account owned by the program (programSubscribe).
    let config = RpcProgramAccountsConfig {
        account_config: RpcAccountInfoConfig {
            encoding: Some(UiAccountEncoding::Base64),
            ..Default::default()
        },
        ..Default::default()
    };
    let datasource = RpcProgramSubscribe::new(
        "wss://api.mainnet-beta.solana.com".to_string(),
        Filters::new(PROGRAM_ID, Some(config)),
    );

    Pipeline::builder()
        .datasource(datasource)
        .metrics(Arc::new(LogMetrics::new()))
        .account(MarginfiV2Decoder, AccountLogger)
        .build()?
        .run()
        .await
}

struct AccountLogger;

impl Processor<AccountProcessorInputType<'_, MarginfiV2Account>> for AccountLogger {
    async fn process(
        &mut self,
        input: &AccountProcessorInputType<'_, MarginfiV2Account>,
    ) -> CarbonResult<()> {
        if let MarginfiV2Account::MarginfiAccount(marginfi_account) = &input.decoded_account.data {
            println!("marginfi_account {}: {marginfi_account:?}", input.metadata.pubkey);
        }
        Ok(())
    }
}

RUST_LOG=info cargo run

Each update to a MarginfiAccount account prints its address and decoded fields; the program runs until you stop it. Cargo resolves solana-client to 4.2.2, the exact version the datasource pins, so both use the same RpcProgramAccountsConfig type. To load every existing account once instead of streaming changes, see load account state.

Instructions#

Variants of MarginfiV2Instruction. Each is MarginfiV2Instruction::<Variant> { program_id, data, accounts }, where data and accounts are the types listed under the variant, exported from carbon_marginfi_v2_decoder::instructions. Discriminators are the leading bytes of the instruction data, in hex.

How an instruction decodes. The decoder returns a variant only when all of these hold; otherwise the instruction is skipped and no processor is called:

1. The instruction's program ID is MFv2hWf31Z9kbCa1snEPYctwafyhdvnV7FZnsebVacA.
2. The data starts with the variant's discriminator, and the rest deserializes into its data type.
3. The instruction has at least as many accounts as the variant requires (the "Required accounts" count under each variant).

Accounts. They are matched by position, in the order listed. An account marked optional is None only when the instruction ends before it; Anchor programs pass the program ID as a placeholder for an omitted optional account, so check for Some(PROGRAM_ID) too. Accounts after the listed ones are in accounts.remaining as AccountMetas. The decoder doesn't record whether an account signed or was writable: read that from input.raw_instruction.accounts[i].is_signer and .is_writable, which follow the same order. It doesn't check signer, writable, owner or PDA constraints either; the program enforced those when the transaction executed, so a decoded instruction from a successful transaction already satisfied them.

ConfigGroupFee#

From the program's IDL:

(global fee admin only) Enable or disable program fees for any group. Does not require the group admin to sign: the global fee state admin can turn program fees on or off for any group

Discriminator e7cd42f2dc579126 · data ConfigGroupFee · accounts ConfigGroupFeeInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of ConfigGroupFeeInstructionAccounts, in account order:

ConfigureBankRateLimits#

From the program's IDL:

(admin or delegate_limit_admin) Configure bank-level rate limits for withdraw/borrow. Rate limits track net outflow in native tokens. Deposits offset withdraws. Set to 0 to disable. Hourly and daily windows are independent.

Discriminator af5455ddcedc6eae · data ConfigureBankRateLimits · accounts ConfigureBankRateLimitsInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of ConfigureBankRateLimitsInstructionAccounts, in account order:

ConfigureDeleverageWithdrawalLimit#

From the program's IDL:

(admin or delegate_limit_admin) Set the daily withdrawal limit for deleverages per group.

Discriminator 1c84cd9e434db13f · data ConfigureDeleverageWithdrawalLimit · accounts ConfigureDeleverageWithdrawalLimitInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of ConfigureDeleverageWithdrawalLimitInstructionAccounts, in account order:

ConfigureGroupRateLimits#

From the program's IDL:

(admin or delegate_limit_admin) Configure group-level rate limits for withdraw/borrow. Rate limits track aggregate net outflow in USD.
Example: $10M = 10_000_000. Set to 0 to disable.

Discriminator 6f2fd58e9e33e266 · data ConfigureGroupRateLimits · accounts ConfigureGroupRateLimitsInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of ConfigureGroupRateLimitsInstructionAccounts, in account order:

DriftDeposit#

From the program's IDL:

(user) Deposit into a Drift spot market through a marginfi account

• amount - in the underlying token (e.g., USDC), in native decimals

Discriminator fc3ffac96237820c · data DriftDeposit · accounts DriftDepositInstructionAccounts.

Required accounts: 17; extras go to remaining.

Fields of DriftDepositInstructionAccounts, in account order:

DriftHarvestReward#

From the program's IDL:

(permissionless) Harvest rewards from admin deposits in Drift spot markets.
Rewards are always sent to the global fee wallet's canonical ATA.
The harvest spot market must be different from the bank's main drift spot market.

Discriminator a7a1f0c28a3657bd · data DriftHarvestReward · accounts DriftHarvestRewardInstructionAccounts.

No data fields.

Required accounts: 14; extras go to remaining.

Fields of DriftHarvestRewardInstructionAccounts, in account order:

DriftInitUser#

From the program's IDL:

(permissionless) Initialize a Drift user and user stats for a marginfi bank
Creates user with sub_account_id = 0 and empty name
Requires a minimum deposit to ensure the account remains active

• amount - minimum deposit amount (at least 10 units) in native decimals

Discriminator 1d12ecbe1dfe72a9 · data DriftInitUser · accounts DriftInitUserInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of DriftInitUserInstructionAccounts, in account order:

DriftWithdraw#

From the program's IDL:

(user) Withdraw from a Drift spot market through a marginfi account

• amount - in the underlying token (e.g., USDC), in native decimals
• withdraw_all - if true, withdraws entire position

Discriminator 563bba7bb7b5ea89 · data DriftWithdraw · accounts DriftWithdrawInstructionAccounts.

Required accounts: 24; extras go to remaining.

Fields of DriftWithdrawInstructionAccounts, in account order:

EditGlobalFeeState#

From the program's IDL:

(global fee admin only) Adjust fees, admin, or the destination wallet

Discriminator 343e23815d45a5ca · data EditGlobalFeeState · accounts EditGlobalFeeStateInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of EditGlobalFeeStateInstructionAccounts, in account order:

EditStakedSettings#

From the program's IDL:

(admin only) Edit the staked collateral settings for the group.

Discriminator 0b6cd757f00942f1 · data EditStakedSettings · accounts EditStakedSettingsInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of EditStakedSettingsInstructionAccounts, in account order:

EndDeleverage#

From the program's IDL:

(risk_admin only) End forced deleverage. Validates health did not worsen.

Discriminator 720efa8ffc68d6d1 · data EndDeleverage · accounts EndDeleverageInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of EndDeleverageInstructionAccounts, in account order:

EndLiquidation#

From the program's IDL:

(liquidation_receiver, set in start_liquidation) End receivership liquidation. Validates health improved and seized assets are within fee limits. Charges a flat SOL fee.

Discriminator 6e0bf436e5b516b8 · data EndLiquidation · accounts EndLiquidationInstructionAccounts.

No data fields.

Required accounts: 6; extras go to remaining.

Fields of EndLiquidationInstructionAccounts, in account order:

InitBankMetadata#

From the program's IDL:

(permissionless) pay the rent to open a bank's metadata.

Discriminator 5eef328889ccfed5 · data InitBankMetadata · accounts InitBankMetadataInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of InitBankMetadataInstructionAccounts, in account order:

InitGlobalFeeState#

From the program's IDL:

(Runs once per program) Configures the fee state account, where the global admin sets fees that are assessed to the protocol

Discriminator 5230f73bdc6de72c · data InitGlobalFeeState · accounts InitGlobalFeeStateInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of InitGlobalFeeStateInstructionAccounts, in account order:

InitStakedSettings#

From the program's IDL:

(group admin only) Init the Staked Settings account, which is used to create staked collateral banks, and must run before any staked collateral bank can be created with add_pool_permissionless. Running this ix effectively opts the group into the staked collateral feature.

Discriminator 3423952c45564550 · data InitStakedSettings · accounts InitStakedSettingsInstructionAccounts.

Required accounts: 5; extras go to remaining.

Fields of InitStakedSettingsInstructionAccounts, in account order:

JuplendDeposit#

From the program's IDL:

(user) Deposit into a JupLend lending pool through a marginfi account.

• amount - in the underlying token (e.g., USDC), in native decimals

Discriminator 720bda51b7a58fff · data JuplendDeposit · accounts JuplendDepositInstructionAccounts.

Required accounts: 23; extras go to remaining.

Fields of JuplendDepositInstructionAccounts, in account order:

JuplendInitPosition#

From the program's IDL:

(permissionless) Initialize the bank-level JupLend position.
This creates the bank's fToken ATA (owned by the bank liquidity vault authority) and performs a nominal seed deposit into JupLend, then flips the bank from Paused to Operational.

Discriminator b0ff976a05cf4ad7 · data JuplendInitPosition · accounts JuplendInitPositionInstructionAccounts.

Required accounts: 21; extras go to remaining.

Fields of JuplendInitPositionInstructionAccounts, in account order:

JuplendWithdraw#

From the program's IDL:

(user) Withdraw from a JupLend lending pool through a marginfi account.

• amount - in the underlying token (e.g., USDC), in native decimals

Discriminator f5a4fdca354dfbdd · data JuplendWithdraw · accounts JuplendWithdrawInstructionAccounts.

Required accounts: 24; extras go to remaining.

Fields of JuplendWithdrawInstructionAccounts, in account order:

KaminoDeposit#

From the program's IDL:

(user) Deposit into a Kamino pool through a marginfi account

• amount - in the liquidity token (e.g. if there is a Kamino USDC bank, pass the amount of

USDC desired), in native decimals.

Discriminator ed08bcbb73633155 · data KaminoDeposit · accounts KaminoDepositInstructionAccounts.

Required accounts: 22; extras go to remaining.

Fields of KaminoDepositInstructionAccounts, in account order:

KaminoHarvestReward#

From the program's IDL:

(permissionless) Harvest the specified reward index from the Kamino Farm attached to this bank. Rewards are always sent to the global fee wallet's canonical ATA.

• reward_index — index of the reward token in the Kamino Farm's reward list

Discriminator a3caf88d6a147405 · data KaminoHarvestReward · accounts KaminoHarvestRewardInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of KaminoHarvestRewardInstructionAccounts, in account order:

KaminoInitObligation#

From the program's IDL:

(permissionless) Initialize a Kamino obligation for a marginfi bank

• amount - In token, in native decimals. Must be >10 (i.e. 10 lamports, not 10 tokens). Lost

forever. Generally, try to make this the equivalent of around $1, in case
Kamino ever rounds small balances down to zero.

Discriminator fdb1a0e1469cd96d · data KaminoInitObligation · accounts KaminoInitObligationInstructionAccounts.

Required accounts: 27; extras go to remaining.

Fields of KaminoInitObligationInstructionAccounts, in account order:

KaminoWithdraw#

From the program's IDL:

(user) Withdraw from a Kamino pool through a marginfi account

• amount - in the collateral token (NOT liquidity token), in native decimals. Must convert

from collateral to liquidity token amounts using the current exchange rate.

• withdraw_all - if true, withdraw the entire mrgn balance (Note: due to rounding down, a

deposit and withdraw back to back may result in several lamports less)

Discriminator c765292dd562e0c8 · data KaminoWithdraw · accounts KaminoWithdrawInstructionAccounts.

Required accounts: 22; extras go to remaining.

Fields of KaminoWithdrawInstructionAccounts, in account order:

LendingAccountBorrow#

From the program's IDL:

(account authority) Borrow assets from a bank. Accrues interest, records liability, applies origination fee, transfers tokens, and runs a health check.

Discriminator 047e74353005d41f · data LendingAccountBorrow · accounts LendingAccountBorrowInstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of LendingAccountBorrowInstructionAccounts, in account order:

LendingAccountClearEmissions#

From the program's IDL:

(permissionless) Zero out emissions_outstanding on a balance after emissions are disabled on the bank.

Discriminator ef04dd622da7c9f4 · data LendingAccountClearEmissions · accounts LendingAccountClearEmissionsInstructionAccounts.

No data fields.

Required accounts: 2; extras go to remaining.

Fields of LendingAccountClearEmissionsInstructionAccounts, in account order:

LendingAccountCloseBalance#

From the program's IDL:

(account authority) Close a balance position with dust-level amounts.

Discriminator f5362904f3ca1f11 · data LendingAccountCloseBalance · accounts LendingAccountCloseBalanceInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of LendingAccountCloseBalanceInstructionAccounts, in account order:

LendingAccountDeposit#

From the program's IDL:

(account authority) Deposit assets into a bank. Accrues interest, records deposit, and transfers tokens from the signer's token account to the bank's liquidity vault.

Discriminator ab5eeb675240d48c · data LendingAccountDeposit · accounts LendingAccountDepositInstructionAccounts.

Required accounts: 7; extras go to remaining.

Fields of LendingAccountDepositInstructionAccounts, in account order:

LendingAccountEndFlashloan#

From the program's IDL:

(account authority) End a flash loan and run the health check.

Discriminator 697cc96a9902089c · data LendingAccountEndFlashloan · accounts LendingAccountEndFlashloanInstructionAccounts.

No data fields.

Required accounts: 2; extras go to remaining.

Fields of LendingAccountEndFlashloanInstructionAccounts, in account order:

LendingAccountLiquidate#

From the program's IDL:

(permissionless) Liquidate a lending account balance of an unhealthy marginfi account. The liquidator takes on the liability and receives discounted collateral (2.5% liquidator fee + 2.5% insurance fee).

• asset_amount - amount of collateral to liquidate
• liquidatee_accounts - number of remaining accounts for the liquidatee
• liquidator_accounts - number of remaining accounts for the liquidator

Discriminator d6a997d5fba756db · data LendingAccountLiquidate · accounts LendingAccountLiquidateInstructionAccounts.

Required accounts: 10; extras go to remaining.

Fields of LendingAccountLiquidateInstructionAccounts, in account order:

LendingAccountPulseHealth#

From the program's IDL:

(Permissionless) Refresh the internal risk engine health cache. Useful for liquidators and other consumers that want to see the internal risk state of a user account. This cache is read-only and serves no purpose except being populated by this ix.

• remaining accounts expected in the same order as borrow, etc. I.e., for each balance the

user has, pass bank and oracle: <bank1, oracle1, bank2, oracle2>

Discriminator ba347561224a27fd · data LendingAccountPulseHealth · accounts LendingAccountPulseHealthInstructionAccounts.

No data fields.

Required accounts: 1; extras go to remaining.

Fields of LendingAccountPulseHealthInstructionAccounts, in account order:

LendingAccountRepay#

From the program's IDL:

(account authority, or any signer during receivership) Repay borrowed assets. Accrues interest, records repayment, and transfers tokens to the bank's liquidity vault.

Discriminator 4fd1acb1de33ad97 · data LendingAccountRepay · accounts LendingAccountRepayInstructionAccounts.

Required accounts: 7; extras go to remaining.

Fields of LendingAccountRepayInstructionAccounts, in account order:

LendingAccountStartFlashloan#

From the program's IDL:

(account authority) Start a flash loan. Must have a corresponding end_flashloan ix in the same tx. Health checks are skipped until the flash loan ends.

Discriminator 0e8321dc51bab46b · data LendingAccountStartFlashloan · accounts LendingAccountStartFlashloanInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingAccountStartFlashloanInstructionAccounts, in account order:

LendingAccountWithdraw#

From the program's IDL:

(account authority, or any signer during receivership) Withdraw assets from a bank. Accrues interest, records withdrawal, transfers tokens, and runs a health check (skipped during receivership).

Discriminator 24484a13d2d2c0c0 · data LendingAccountWithdraw · accounts LendingAccountWithdrawInstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of LendingAccountWithdrawInstructionAccounts, in account order:

LendingPoolAccrueBankInterest#

From the program's IDL:

(permissionless) Accrue interest on a bank, updating share values and collecting fees.

Discriminator 6cc91e572f4161bc · data LendingPoolAccrueBankInterest · accounts LendingPoolAccrueBankInterestInstructionAccounts.

No data fields.

Required accounts: 2; extras go to remaining.

Fields of LendingPoolAccrueBankInterestInstructionAccounts, in account order:

LendingPoolAddBank#

From the program's IDL:

(admin only) Add a new bank to the lending pool

Discriminator d744484ed0da67b6 · data LendingPoolAddBank · accounts LendingPoolAddBankInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of LendingPoolAddBankInstructionAccounts, in account order:

LendingPoolAddBankDrift#

From the program's IDL:

(group admin only) Add a Drift bank to the group.

Discriminator 3e3f31304c376c9b · data LendingPoolAddBankDrift · accounts LendingPoolAddBankDriftInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of LendingPoolAddBankDriftInstructionAccounts, in account order:

LendingPoolAddBankJuplend#

From the program's IDL:

(admin) Add a JupLend bank to the marginfi group.
Remaining accounts (for oracle validation): 0. underlying oracle feed (pyth push or switchboard pull)

1. JupLend Lending state

Discriminator 12d0755a356fc329 · data LendingPoolAddBankJuplend · accounts LendingPoolAddBankJuplendInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of LendingPoolAddBankJuplendInstructionAccounts, in account order:

LendingPoolAddBankKamino#

From the program's IDL:

(group admin only) Add a Kamino bank to the group. Pass the oracle and reserve in remaining accounts 0 and 1 respectively.

Discriminator 763510f3fff595f1 · data LendingPoolAddBankKamino · accounts LendingPoolAddBankKaminoInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of LendingPoolAddBankKaminoInstructionAccounts, in account order:

LendingPoolAddBankPermissionless#

From the program's IDL:

(permissionless) Add a staked collateral bank. Requires a valid SPL single-pool LST mint.

Discriminator 7fbb7922bba7ee66 · data LendingPoolAddBankPermissionless · accounts LendingPoolAddBankPermissionlessInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of LendingPoolAddBankPermissionlessInstructionAccounts, in account order:

LendingPoolAddBankSolend#

From the program's IDL:

(admin) Add a Solend bank to the marginfi group

Discriminator 51e9cbc72fe20044 · data LendingPoolAddBankSolend · accounts LendingPoolAddBankSolendInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of LendingPoolAddBankSolendInstructionAccounts, in account order:

LendingPoolAddBankWithSeed#

From the program's IDL:

(admin only) A copy of lending_pool_add_bank with an additional bank seed.
This seed is used to create a PDA for the bank's signature.
lending_pool_add_bank is preserved for backwards compatibility.

Discriminator 4cd3d5ab754e9e4c · data LendingPoolAddBankWithSeed · accounts LendingPoolAddBankWithSeedInstructionAccounts.

Required accounts: 15; extras go to remaining.

Fields of LendingPoolAddBankWithSeedInstructionAccounts, in account order:

LendingPoolCloneBank#

From the program's IDL:

(admin only) Staging or localnet only, panics on mainnet
This instruction is used to clone a bank to a new PDA.

Discriminator d65d11ecb1e44e11 · data LendingPoolCloneBank · accounts LendingPoolCloneBankInstructionAccounts.

Required accounts: 14; extras go to remaining.

Fields of LendingPoolCloneBankInstructionAccounts, in account order:

LendingPoolCloneEmode#

From the program's IDL:

(admin or emode_admin) Copies emode settings from one bank to another.
Useful when applying emode settings from e.g. one LST to another.

Discriminator 92a75e6ab8ca0f0a · data LendingPoolCloneEmode · accounts LendingPoolCloneEmodeInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of LendingPoolCloneEmodeInstructionAccounts, in account order:

LendingPoolCloseBank#

From the program's IDL:

(admin only) Close a bank. Requires CLOSE_ENABLED_FLAG and zero positions/shares.

Discriminator 16730782e355002f · data LendingPoolCloseBank · accounts LendingPoolCloseBankInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolCloseBankInstructionAccounts, in account order:

LendingPoolCollectBankFees#

From the program's IDL:

(permissionless) Transfer accrued fees from the liquidity vault to insurance/fee/program vaults.

Discriminator c905d774e65c4b96 · data LendingPoolCollectBankFees · accounts LendingPoolCollectBankFeesInstructionAccounts.

No data fields.

Required accounts: 9; extras go to remaining.

Fields of LendingPoolCollectBankFeesInstructionAccounts, in account order:

LendingPoolConfigureBank#

From the program's IDL:

(admin only) Configure bank parameters. If the bank has FREEZE_SETTINGS, only deposit/borrow limits are updated and all other config changes are silently ignored.

Discriminator 79ad9c285d9438ed · data LendingPoolConfigureBank · accounts LendingPoolConfigureBankInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolConfigureBankInstructionAccounts, in account order:

LendingPoolConfigureBankEmode#

From the program's IDL:

(emode_admin only)

Discriminator 11af5b39ef563147 · data LendingPoolConfigureBankEmode · accounts LendingPoolConfigureBankEmodeInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolConfigureBankEmodeInstructionAccounts, in account order:

LendingPoolConfigureBankInterestOnly#

From the program's IDL:

(delegate_curve_admin only) Update interest rate config. Does nothing if bank has FREEZE_SETTINGS.

Discriminator f56b532667dba3f1 · data LendingPoolConfigureBankInterestOnly · accounts LendingPoolConfigureBankInterestOnlyInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolConfigureBankInterestOnlyInstructionAccounts, in account order:

LendingPoolConfigureBankLimitsOnly#

From the program's IDL:

(delegate_limit_admin only) Update deposit/borrow/init limits only.

Discriminator 9dc4ddc8ca3e5415 · data LendingPoolConfigureBankLimitsOnly · accounts LendingPoolConfigureBankLimitsOnlyInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolConfigureBankLimitsOnlyInstructionAccounts, in account order:

LendingPoolConfigureBankOracle#

From the program's IDL:

(admin only)

Discriminator d152ffab7c154751 · data LendingPoolConfigureBankOracle · accounts LendingPoolConfigureBankOracleInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolConfigureBankOracleInstructionAccounts, in account order:

LendingPoolForceTokenlessRepayComplete#

From the program's IDL:

(risk_admin only) - Signals all of a bank's liability have been deleveraged.
Used if a bank still has liability dust after the risk admin has completed deleveraging all debts. The risk admin is trusted not to execute this until all non-dust debts have been deleveraged.

Discriminator 0fcb93e8c70ee725 · data LendingPoolForceTokenlessRepayComplete · accounts LendingPoolForceTokenlessRepayCompleteInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolForceTokenlessRepayCompleteInstructionAccounts, in account order:

LendingPoolHandleBankruptcy#

From the program's IDL:

(risk_admin or admin, unless PERMISSIONLESS_BAD_DEBT_SETTLEMENT_FLAG is set on the bank) Handle bad debt of a bankrupt marginfi account for a given bank. Covers bad debt from the insurance fund and socializes any remainder among depositors.

Discriminator a20b388b5a8046ad · data LendingPoolHandleBankruptcy · accounts LendingPoolHandleBankruptcyInstructionAccounts.

No data fields.

Required accounts: 8; extras go to remaining.

Fields of LendingPoolHandleBankruptcyInstructionAccounts, in account order:

LendingPoolPulseBankPriceCache#

From the program's IDL:

(Permissionless) Refresh the cached oracle price for a bank.

Discriminator c013c98769cb20de · data LendingPoolPulseBankPriceCache · accounts LendingPoolPulseBankPriceCacheInstructionAccounts.

No data fields.

Required accounts: 2; extras go to remaining.

Fields of LendingPoolPulseBankPriceCacheInstructionAccounts, in account order:

LendingPoolReclaimEmissionsVault#

From the program's IDL:

(permissionless) Reclaim all remaining tokens from the emissions vault to the global fee wallet ATA, and disable emissions on the bank.

Discriminator ce43bae1291e5fd8 · data LendingPoolReclaimEmissionsVault · accounts LendingPoolReclaimEmissionsVaultInstructionAccounts.

No data fields.

Required accounts: 8; extras go to remaining.

Fields of LendingPoolReclaimEmissionsVaultInstructionAccounts, in account order:

LendingPoolSetFixedOraclePrice#

From the program's IDL:

(admin only)

Discriminator 1c7e7f7f3c25d37d · data LendingPoolSetFixedOraclePrice · accounts LendingPoolSetFixedOraclePriceInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of LendingPoolSetFixedOraclePriceInstructionAccounts, in account order:

LendingPoolUpdateFeesDestinationAccount#

From the program's IDL:

(admin only) Set the destination wallet for permissionless fee withdrawals.

Discriminator 660479f3ed6e5f0d · data LendingPoolUpdateFeesDestinationAccount · accounts LendingPoolUpdateFeesDestinationAccountInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of LendingPoolUpdateFeesDestinationAccountInstructionAccounts, in account order:

LendingPoolWithdrawFees#

From the program's IDL:

(admin only) Withdraw collected group fees from the fee vault.

Discriminator 5c8cd7feaa0053ae · data LendingPoolWithdrawFees · accounts LendingPoolWithdrawFeesInstructionAccounts.

Required accounts: 7; extras go to remaining.

Fields of LendingPoolWithdrawFeesInstructionAccounts, in account order:

LendingPoolWithdrawFeesPermissionless#

From the program's IDL:

(permissionless) Withdraw group fees to the pre-configured fees_destination_account.

Discriminator 39f501d082129171 · data LendingPoolWithdrawFeesPermissionless · accounts LendingPoolWithdrawFeesPermissionlessInstructionAccounts.

Required accounts: 6; extras go to remaining.

Fields of LendingPoolWithdrawFeesPermissionlessInstructionAccounts, in account order:

LendingPoolWithdrawInsurance#

From the program's IDL:

(admin only) Withdraw from the insurance vault.

Discriminator 6c3c3cf6684f9ff3 · data LendingPoolWithdrawInsurance · accounts LendingPoolWithdrawInsuranceInstructionAccounts.

Required accounts: 7; extras go to remaining.

Fields of LendingPoolWithdrawInsuranceInstructionAccounts, in account order:

MarginfiAccountClose#

From the program's IDL:

(account authority) Close a marginfi account. Requires all balances to be empty and no active flags (disabled, flashloan, receivership).

Discriminator badd5d223261c2f1 · data MarginfiAccountClose · accounts MarginfiAccountCloseInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of MarginfiAccountCloseInstructionAccounts, in account order:

MarginfiAccountCloseOrder#

From the program's IDL:

(user) Close an existing Order, returning rent to the user

Discriminator d4df4fb6acb7cded · data MarginfiAccountCloseOrder · accounts MarginfiAccountCloseOrderInstructionAccounts.

No data fields.

Required accounts: 5; extras go to remaining.

Fields of MarginfiAccountCloseOrderInstructionAccounts, in account order:

MarginfiAccountEndExecuteOrder#

From the program's IDL:

(permissionless keeper) End Order execution

• Closes the Order (keeper keeps the rent)
• Closes the borrow position involved in the Order, the lending position remains open
• User health must be "unchanged" (within Order requirements i.e. minus slippage). Keeper

may keep any slippage in excess of what was needed to complete the Order as profit.

• StartExecuteOrder must appear earlier in the tx
• Must appear last in the tx
• CPI is forbidden
• Returns rent for ephemeral accounts created during StartExecuteOrder

Discriminator 732a145d7954b253 · data MarginfiAccountEndExecuteOrder · accounts MarginfiAccountEndExecuteOrderInstructionAccounts.

No data fields.

Required accounts: 7; extras go to remaining.

Fields of MarginfiAccountEndExecuteOrderInstructionAccounts, in account order:

MarginfiAccountInitialize#

From the program's IDL:

Initialize a marginfi account for a given group. The account is a fresh keypair, and must sign. If you are a CPI caller, consider using marginfi_account_initialize_pda instead, or create the account manually and use transfer_to_new_account to gift it to the owner you wish.

Discriminator 2b4e3dff9434f99a · data MarginfiAccountInitialize · accounts MarginfiAccountInitializeInstructionAccounts.

No data fields.

Required accounts: 5; extras go to remaining.

Fields of MarginfiAccountInitializeInstructionAccounts, in account order:

MarginfiAccountInitializePda#

From the program's IDL:

The same as marginfi_account_initialize, except the created marginfi account uses a PDA (Program Derived Address) seeds:

• marginfi_group
• authority: The account authority (owner)
• account_index: A u16 value to allow multiple accounts per authority
• third_party_id: Optional u16 for third-party tagging. Seeds <
  PDA_FREE_THRESHOLD can be

used freely. For a dedicated seed used by just your program (via CPI), contact us.

Discriminator 57b15b50da77f51f · data MarginfiAccountInitializePda · accounts MarginfiAccountInitializePdaInstructionAccounts.

Required accounts: 6; extras go to remaining.

Fields of MarginfiAccountInitializePdaInstructionAccounts, in account order:

MarginfiAccountInitLiqRecord#

From the program's IDL:

(permissionless) Initialize a liquidation record PDA for a marginfi account.
The fee_payer pays rent; the record is required for receivership liquidation.

Discriminator ecd5ee7e93fba408 · data MarginfiAccountInitLiqRecord · accounts MarginfiAccountInitLiqRecordInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of MarginfiAccountInitLiqRecordInstructionAccounts, in account order:

MarginfiAccountKeeperCloseOrder#

From the program's IDL:

(permissionless keeper) Close an existing Order after the user account was closed, or it no longer has the associated positions, or the user has executed marginfi_account_set_keeper_close_flags. Keeper keeps the rent.

Discriminator 8072472ec247ba6a · data MarginfiAccountKeeperCloseOrder · accounts MarginfiAccountKeeperCloseOrderInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of MarginfiAccountKeeperCloseOrderInstructionAccounts, in account order:

MarginfiAccountPlaceOrder#

From the program's IDL:

(user) Create a new Order.

• bank_keys - Currently only two keys: the lending position and borrowing position in the

users's Balances for which the order is being placed

• trigger - the type of order (stop loss, take profit, or both), and the threshold at which

to trigger the order, in dollars

Discriminator f4704b8a8f6c07ba · data MarginfiAccountPlaceOrder · accounts MarginfiAccountPlaceOrderInstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of MarginfiAccountPlaceOrderInstructionAccounts, in account order:

MarginfiAccountSetFreeze#

From the program's IDL:

(admin only) Freeze or unfreeze a marginfi account. Frozen accounts can only be operated on by the group admin.

Discriminator c7b3e71e8af76ee3 · data MarginfiAccountSetFreeze · accounts MarginfiAccountSetFreezeInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of MarginfiAccountSetFreezeInstructionAccounts, in account order:

MarginfiAccountSetKeeperCloseFlags#

From the program's IDL:

(user) Purge flags from some balances, enabling a Keeper to call marginfi_account_keeper_close_order on associated Orders. Typically, use marginfi_account_close_order instead if trying to close an Order.

Discriminator 52a3a5ded4ff21d2 · data MarginfiAccountSetKeeperCloseFlags · accounts MarginfiAccountSetKeeperCloseFlagsInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of MarginfiAccountSetKeeperCloseFlagsInstructionAccounts, in account order:

MarginfiAccountStartExecuteOrder#

From the program's IDL:

(permissionless keeper) Begin Order execution

• Enables the Keeper to withdraw/repay associated positions until the end of the tx
• Only one StartExecuteOrder is allowed per tx
• Must appear before EndExecuteOrder in the tx, and before any instructions except certain

allowed ones (compute budget, kamino refresh, etc)

• EndExecuteOrder must also appear in the tx
• CPI is forbidden
• Costs a small amount of rent, which is returned at the end of the tx, make sure you have

enough SOL to start the tx.

Discriminator 01468c86b71dd0e0 · data MarginfiAccountStartExecuteOrder · accounts MarginfiAccountStartExecuteOrderInstructionAccounts.

No data fields.

Required accounts: 8; extras go to remaining.

Fields of MarginfiAccountStartExecuteOrderInstructionAccounts, in account order:

MarginfiAccountUpdateEmissionsDestinationAccount#

From the program's IDL:

(account authority) Set the wallet whose canonical ATA will receive off-chain emissions.

Discriminator 49b9a2c96f1874b9 · data MarginfiAccountUpdateEmissionsDestinationAccount · accounts MarginfiAccountUpdateEmissionsDestinationAccountInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of MarginfiAccountUpdateEmissionsDestinationAccountInstructionAccounts, in account order:

MarginfiGroupConfigure#

From the program's IDL:

(admin only) Configure group admin keys and emode leverage caps. All admin keys must be provided on every call. Emode leverage caps are set if provided, otherwise the existing (non-zero) values are kept. Pass Some(value) to update, None to leave unchanged.

Discriminator 3ec7514e210dec3d · data MarginfiGroupConfigure · accounts MarginfiGroupConfigureInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of MarginfiGroupConfigureInstructionAccounts, in account order: