Jupiter Perpetuals decoder

carbon-jupiter-perpetuals-decoder decodes the instructions, accounts and events of the Jupiter Perpetuals program (PERPHjGBqRHArX4DySjwM6UJHiR3sWAatqfdBS2qQJu): 59 instructions, 8 account types, 25 events. It is generated with Codama from the program's IDL; see decoders for how decoders plug into a pipeline.

Other perpetuals and derivatives decoders: Drift v2, Zeta Markets. To decode several in one pipeline, see perpetuals and derivatives 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 Jupiter Perpetuals transactions from the public RPC and prints every decoded AddCustody instruction. Add the dependencies:

cargo add carbon-core@2.0.0 carbon-jupiter-perpetuals-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_jupiter_perpetuals_decoder::{
        instructions::JupiterPerpetualsInstruction, JupiterPerpetualsDecoder, 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(JupiterPerpetualsDecoder, InstructionLogger)
        .build()?
        .run()
        .await
}

struct InstructionLogger;

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

RUST_LOG=info cargo run

Each AddCustody instruction prints one line with the transaction signature and the decoded AddCustody 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 JupiterPerpetualsInstruction::CpiEvent { data: CpiEvent::CreatePositionRequestEvent(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 Pool 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_jupiter_perpetuals_decoder::{
        accounts::JupiterPerpetualsAccount, JupiterPerpetualsDecoder, 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(JupiterPerpetualsDecoder, AccountLogger)
        .build()?
        .run()
        .await
}

struct AccountLogger;

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

RUST_LOG=info cargo run

Each update to a Pool 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 JupiterPerpetualsInstruction. Each is JupiterPerpetualsInstruction::<Variant> { program_id, data, accounts }, where data and accounts are the types listed under the variant, exported from carbon_jupiter_perpetuals_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 PERPHjGBqRHArX4DySjwM6UJHiR3sWAatqfdBS2qQJu.
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.

AddCustody#

Discriminator f7fe7e111a06d775 · data AddCustody · accounts AddCustodyInstructionAccounts.

Required accounts: 10; extras go to remaining.

Fields of AddCustodyInstructionAccounts, in account order:

AddLiquidity2#

Discriminator e4a24e1c46db7473 · data AddLiquidity2 · accounts AddLiquidity2InstructionAccounts.

Required accounts: 14; extras go to remaining.

Fields of AddLiquidity2InstructionAccounts, in account order:

AddPool#

Discriminator 73e6d4d3af3127a9 · data AddPool · accounts AddPoolInstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of AddPoolInstructionAccounts, in account order:

BorrowFromCustody#

Discriminator 99b741417121f92d · data BorrowFromCustody · accounts BorrowFromCustodyInstructionAccounts.

Required accounts: 12; extras go to remaining.

Fields of BorrowFromCustodyInstructionAccounts, in account order:

CloseBorrowPosition#

Discriminator cce291cde825038c · data CloseBorrowPosition · accounts CloseBorrowPositionInstructionAccounts.

Required accounts: 5; extras go to remaining.

Fields of CloseBorrowPositionInstructionAccounts, in account order:

ClosePositionRequest2#

Discriminator 7944a21cd82fc842 · data ClosePositionRequest2 · accounts ClosePositionRequest2InstructionAccounts.

No data fields.

Required accounts: 13; extras go to remaining.

Fields of ClosePositionRequest2InstructionAccounts, in account order:

ClosePositionRequest3#

Discriminator 7a822112d32ca13a · data ClosePositionRequest3 · accounts ClosePositionRequest3InstructionAccounts.

No data fields.

Required accounts: 14; extras go to remaining.

Fields of ClosePositionRequest3InstructionAccounts, in account order:

CreateAndDelegateStakeAccount#

Discriminator 62d17a1bde895e86 · data CreateAndDelegateStakeAccount · accounts CreateAndDelegateStakeAccountInstructionAccounts.

Required accounts: 18; extras go to remaining.

Fields of CreateAndDelegateStakeAccountInstructionAccounts, in account order:

CreateDecreasePositionMarketRequest#

Discriminator 4ac6c356c163014f · data CreateDecreasePositionMarketRequest · accounts CreateDecreasePositionMarketRequestInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of CreateDecreasePositionMarketRequestInstructionAccounts, in account order:

CreateDecreasePositionRequest2#

Discriminator 6940c952fa0e6d4d · data CreateDecreasePositionRequest2 · accounts CreateDecreasePositionRequest2InstructionAccounts.

Required accounts: 18; extras go to remaining.

Fields of CreateDecreasePositionRequest2InstructionAccounts, in account order:

CreateIncreasePositionMarketRequest#

Discriminator b855c71869ab9c38 · data CreateIncreasePositionMarketRequest · accounts CreateIncreasePositionMarketRequestInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of CreateIncreasePositionMarketRequestInstructionAccounts, in account order:

CreateTokenLedger#

Discriminator e8f2c5fdf08f8134 · data CreateTokenLedger · accounts CreateTokenLedgerInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of CreateTokenLedgerInstructionAccounts, in account order:

CreateTokenMetadata#

Discriminator dd50b02599bca044 · data CreateTokenMetadata · accounts CreateTokenMetadataInstructionAccounts.

Required accounts: 9; extras go to remaining.

Fields of CreateTokenMetadataInstructionAccounts, in account order:

DecreasePosition4#

Discriminator b9a172af609403aa · data DecreasePosition4 · accounts DecreasePosition4InstructionAccounts.

Required accounts: 18; extras go to remaining.

Fields of DecreasePosition4InstructionAccounts, in account order:

DecreasePositionWithInternalSwap#

Discriminator 8311996e77646126 · data DecreasePositionWithInternalSwap · accounts DecreasePositionWithInternalSwapInstructionAccounts.

Required accounts: 22; extras go to remaining.

Fields of DecreasePositionWithInternalSwapInstructionAccounts, in account order:

DecreasePositionWithTpsl#

Discriminator 6c12cbd1e36741a5 · data DecreasePositionWithTpsl · accounts DecreasePositionWithTpslInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of DecreasePositionWithTpslInstructionAccounts, in account order:

DecreasePositionWithTpslAndInternalSwap#

Discriminator 026fc8e723417beb · data DecreasePositionWithTpslAndInternalSwap · accounts DecreasePositionWithTpslAndInternalSwapInstructionAccounts.

Required accounts: 19; extras go to remaining.

Fields of DecreasePositionWithTpslAndInternalSwapInstructionAccounts, in account order:

DepositCollateralForBorrows#

Discriminator 1102c3be4c10ee4a · data DepositCollateralForBorrows · accounts DepositCollateralForBorrowsInstructionAccounts.

Required accounts: 13; extras go to remaining.

Fields of DepositCollateralForBorrowsInstructionAccounts, in account order:

GetAddLiquidityAmountAndFee2#

Discriminator 6d9d37a908510476 · data GetAddLiquidityAmountAndFee2 · accounts GetAddLiquidityAmountAndFee2InstructionAccounts.

Required accounts: 6; extras go to remaining.

Fields of GetAddLiquidityAmountAndFee2InstructionAccounts, in account order:

GetAssetsUnderManagement2#

Discriminator c1d20df971951d54 · data GetAssetsUnderManagement2 · accounts GetAssetsUnderManagement2InstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of GetAssetsUnderManagement2InstructionAccounts, in account order:

GetRemoveLiquidityAmountAndFee2#

Discriminator b73b486edff3968e · data GetRemoveLiquidityAmountAndFee2 · accounts GetRemoveLiquidityAmountAndFee2InstructionAccounts.

Required accounts: 6; extras go to remaining.

Fields of GetRemoveLiquidityAmountAndFee2InstructionAccounts, in account order:

IncreasePosition4#

Discriminator 439335172b391043 · data IncreasePosition4 · accounts IncreasePosition4InstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of IncreasePosition4InstructionAccounts, in account order:

IncreasePositionPreSwap#

Discriminator 1a88e1d916155314 · data IncreasePositionPreSwap · accounts IncreasePositionPreSwapInstructionAccounts.

Required accounts: 11; extras go to remaining.

Fields of IncreasePositionPreSwapInstructionAccounts, in account order:

IncreasePositionWithInternalSwap#

Discriminator 72376a8cc7dd2070 · data IncreasePositionWithInternalSwap · accounts IncreasePositionWithInternalSwapInstructionAccounts.

Required accounts: 20; extras go to remaining.

Fields of IncreasePositionWithInternalSwapInstructionAccounts, in account order:

Init#

Discriminator dc3bcfec6cfa2f64 · data Init · accounts InitInstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of InitInstructionAccounts, in account order:

InstantCreateLimitOrder#

Discriminator c225c37b287f7e9c · data InstantCreateLimitOrder · accounts InstantCreateLimitOrderInstructionAccounts.

Required accounts: 20; extras go to remaining.

Fields of InstantCreateLimitOrderInstructionAccounts, in account order:

InstantCreateTpsl#

Discriminator 7562427f1e3249b9 · data InstantCreateTpsl · accounts InstantCreateTpslInstructionAccounts.

Required accounts: 20; extras go to remaining.

Fields of InstantCreateTpslInstructionAccounts, in account order:

InstantDecreasePosition#

Discriminator 2e17f02c1e8a5e8c · data InstantDecreasePosition · accounts InstantDecreasePositionInstructionAccounts.

Required accounts: 22; extras go to remaining.

Fields of InstantDecreasePositionInstructionAccounts, in account order:

InstantDecreasePosition2#

Discriminator a2bfc83e8b3eb011 · data InstantDecreasePosition2 · accounts InstantDecreasePosition2InstructionAccounts.

Required accounts: 22; extras go to remaining.

Fields of InstantDecreasePosition2InstructionAccounts, in account order:

InstantIncreasePosition#

Discriminator a47e44b6dfa640b7 · data InstantIncreasePosition · accounts InstantIncreasePositionInstructionAccounts.

Required accounts: 20; extras go to remaining.

Fields of InstantIncreasePositionInstructionAccounts, in account order:

InstantIncreasePositionPreSwap#

Discriminator c52656a5c71726ea · data InstantIncreasePositionPreSwap · accounts InstantIncreasePositionPreSwapInstructionAccounts.

Required accounts: 16; extras go to remaining.

Fields of InstantIncreasePositionPreSwapInstructionAccounts, in account order:

InstantUpdateLimitOrder#

Discriminator 88f5e53a798d0ccf · data InstantUpdateLimitOrder · accounts InstantUpdateLimitOrderInstructionAccounts.

Required accounts: 10; extras go to remaining.

Fields of InstantUpdateLimitOrderInstructionAccounts, in account order:

InstantUpdateTpsl#

Discriminator 90e47225a5f26f65 · data InstantUpdateTpsl · accounts InstantUpdateTpslInstructionAccounts.

Required accounts: 12; extras go to remaining.

Fields of InstantUpdateTpslInstructionAccounts, in account order:

LiquidateBorrowPosition#

Discriminator ebc91185ea4854d2 · data LiquidateBorrowPosition · accounts LiquidateBorrowPositionInstructionAccounts.

Required accounts: 11; extras go to remaining.

Fields of LiquidateBorrowPositionInstructionAccounts, in account order:

LiquidateFullPosition4#

Discriminator 40b05833a8bc9caf · data LiquidateFullPosition4 · accounts LiquidateFullPosition4InstructionAccounts.

Required accounts: 13; extras go to remaining.

Fields of LiquidateFullPosition4InstructionAccounts, in account order:

OperatorSetCustodyConfig#

Discriminator a6895ccc91e018da · data OperatorSetCustodyConfig · accounts OperatorSetCustodyConfigInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of OperatorSetCustodyConfigInstructionAccounts, in account order:

OperatorSetPoolConfig#

Discriminator 4cc95012c75cf669 · data OperatorSetPoolConfig · accounts OperatorSetPoolConfigInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of OperatorSetPoolConfigInstructionAccounts, in account order:

PartialLiquidateBorrowPosition#

Discriminator faa60d4a61cc82d1 · data PartialLiquidateBorrowPosition · accounts PartialLiquidateBorrowPositionInstructionAccounts.

Required accounts: 11; extras go to remaining.

Fields of PartialLiquidateBorrowPositionInstructionAccounts, in account order:

ReallocCustody#

Discriminator 7b3a6d8b8507e1c8 · data ReallocCustody · accounts ReallocCustodyInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of ReallocCustodyInstructionAccounts, in account order:

ReallocPool#

Discriminator 728025a747e328b2 · data ReallocPool · accounts ReallocPoolInstructionAccounts.

No data fields.

Required accounts: 4; extras go to remaining.

Fields of ReallocPoolInstructionAccounts, in account order:

RedeemStake#

Discriminator b2cbfa698576ff45 · data RedeemStake · accounts RedeemStakeInstructionAccounts.

No data fields.

Required accounts: 6; extras go to remaining.

Fields of RedeemStakeInstructionAccounts, in account order:

RefreshAssetsUnderManagement#

Discriminator a200d737e10fb900 · data RefreshAssetsUnderManagement · accounts RefreshAssetsUnderManagementInstructionAccounts.

Required accounts: 4; extras go to remaining.

Fields of RefreshAssetsUnderManagementInstructionAccounts, in account order:

RemoveLiquidity2#

Discriminator e6d7527ff165e392 · data RemoveLiquidity2 · accounts RemoveLiquidity2InstructionAccounts.

Required accounts: 14; extras go to remaining.

Fields of RemoveLiquidity2InstructionAccounts, in account order:

RepayToCustody#

Discriminator d3dbb7def84a051a · data RepayToCustody · accounts RepayToCustodyInstructionAccounts.

Required accounts: 10; extras go to remaining.

Fields of RepayToCustodyInstructionAccounts, in account order:

SetCustodyConfig#

Discriminator 8561828fd7e524b0 · data SetCustodyConfig · accounts SetCustodyConfigInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of SetCustodyConfigInstructionAccounts, in account order:

SetMaxGlobalSizes#

Discriminator 5902d218a7e30dd6 · data SetMaxGlobalSizes · accounts SetMaxGlobalSizesInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of SetMaxGlobalSizesInstructionAccounts, in account order:

SetPerpetualsConfig#

Discriminator 504815bf1d792d6f · data SetPerpetualsConfig · accounts SetPerpetualsConfigInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of SetPerpetualsConfigInstructionAccounts, in account order:

SetPoolConfig#

Discriminator d857417d716eb978 · data SetPoolConfig · accounts SetPoolConfigInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of SetPoolConfigInstructionAccounts, in account order:

SetTestTime#

Discriminator f2e7b1fb7e919f68 · data SetTestTime · accounts SetTestTimeInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of SetTestTimeInstructionAccounts, in account order:

SetTokenLedger#

Discriminator e455b9704e4f4d02 · data SetTokenLedger · accounts SetTokenLedgerInstructionAccounts.

No data fields.

Required accounts: 3; extras go to remaining.

Fields of SetTokenLedgerInstructionAccounts, in account order:

Swap2#

Discriminator 414b3f4ceb5b5b88 · data Swap2 · accounts Swap2InstructionAccounts.

Required accounts: 17; extras go to remaining.

Fields of Swap2InstructionAccounts, in account order:

SwapWithTokenLedger#

Discriminator 8b8deec529d3ac13 · data SwapWithTokenLedger · accounts SwapWithTokenLedgerInstructionAccounts.

Required accounts: 17; extras go to remaining.

Fields of SwapWithTokenLedgerInstructionAccounts, in account order:

TestInit#

Discriminator 30335c7a51137029 · data TestInit · accounts TestInitInstructionAccounts.

Required accounts: 6; extras go to remaining.

Fields of TestInitInstructionAccounts, in account order:

TransferAdmin#

Discriminator 2af2426ae40a6f9c · data TransferAdmin · accounts TransferAdminInstructionAccounts.

Required accounts: 3; extras go to remaining.

Fields of TransferAdminInstructionAccounts, in account order:

Unstake#

Discriminator 5a5f6b2acd7c32e1 · data Unstake · accounts UnstakeInstructionAccounts.

No data fields.

Required accounts: 9; extras go to remaining.

Fields of UnstakeInstructionAccounts, in account order:

UpdateDecreasePositionRequest2#

Discriminator 90c8f9ff6cd9f974 · data UpdateDecreasePositionRequest2 · accounts UpdateDecreasePositionRequest2InstructionAccounts.

Required accounts: 8; extras go to remaining.

Fields of UpdateDecreasePositionRequest2InstructionAccounts, in account order:

WithdrawCollateralForBorrows#

Discriminator 75a03c52ede92eb6 · data WithdrawCollateralForBorrows · accounts WithdrawCollateralForBorrowsInstructionAccounts.

Required accounts: 12; extras go to remaining.

Fields of WithdrawCollateralForBorrowsInstructionAccounts, in account order:

WithdrawFees2#

Discriminator fc808f91e1dd9fcf · data WithdrawFees2 · accounts WithdrawFees2InstructionAccounts.

Required accounts: 10; extras go to remaining.

Fields of WithdrawFees2InstructionAccounts, in account order:

WithdrawStake#

Discriminator 9908168a69b05742 · data WithdrawStake · accounts WithdrawStakeInstructionAccounts.

No data fields.

Required accounts: 13; extras go to remaining.

Fields of WithdrawStakeInstructionAccounts, in account order:

CpiEvent#

Anchor self-CPI that carries one of the program's events. data is the CpiEvent enum.

Discriminator e445a52e51cb9a1d · data CpiEvent · accounts CpiEventInstructionAccounts.

Required accounts: 2; extras go to remaining.

Fields of CpiEventInstructionAccounts, in account order:

Accounts#

Variants of JupiterPerpetualsAccount. Each wraps a boxed struct from carbon_jupiter_perpetuals_decoder::accounts::<module>. decode_account only considers accounts owned by PROGRAM_ID and returns the first variant that matches.

BorrowPosition#

Discriminator f38c148b20f37237 · accounts::borrow_position::BorrowPosition.

Custody#

Discriminator 01b830515d833f91 · accounts::custody::Custody.

Perpetuals#

Discriminator 1ca762bf68526cc4 · accounts::perpetuals::Perpetuals.

Pool#

Discriminator f19a6d0411b16dbc · accounts::pool::Pool.