Function open_full_range_position_instructions

pub async fn open_full_range_position_instructions(
    rpc: &RpcClient,
    pool_address: Address,
    param: IncreaseLiquidityParam,
    config: OpenFullRangePositionConfig,
) -> Result<OpenPositionInstruction, Box<dyn Error>>
Expand description

Opens a full-range position in a liquidity pool.

This function creates a new position within the full price range for the specified pool, which is ideal for full-range liquidity provisioning, such as in Splash Pools.

§Arguments

  • rpc - A reference to the Solana RPC client.
  • pool_address - The public key of the liquidity pool.
  • param - Maximum amounts of token A and B to deposit.
  • config - The parameters to build the open full range position instruction.

§Returns

Returns a Result containing an OpenPositionInstruction on success, which includes:

  • position_mint - The mint address of the position NFT.
  • instructions - A vector of Instruction objects required for creating the position.
  • additional_signers - A vector of Keypair objects for additional transaction signers.
  • initialization_cost - The cost of initializing the position, in lamports.

§Errors

Returns an error if:

  • The funder account is invalid.
  • The pool or token mint accounts are not found or invalid.
  • Any RPC request fails.

§Example

use solana_client::rpc_client::RpcClient;
use solana_keypair::Keypair;
use solana_pubkey::Pubkey;
use orca_whirlpools::{
    open_full_range_position_instructions, IncreaseLiquidityParam,
    OpenFullRangePositionConfig, WhirlpoolDeployment
};
use std::str::FromStr;

let rpc = RpcClient::new("https://api.devnet.solana.com");

let whirlpool_pubkey = Pubkey::from_str("WHIRLPOOL_ADDRESS").unwrap();
let param = IncreaseLiquidityParam { token_max_a: 1_000_000, token_max_b: 1_000_000 };

let wallet = Keypair::new();

let config = OpenFullRangePositionConfig {
    slippage_tolerance_bps: Some(100),
    funder: Some(wallet.pubkey()),
    whirlpool_deployment: Some(WhirlpoolDeployment::devnet()),
};
let result = open_full_range_position_instructions(&rpc, whirlpool_pubkey, param, config).unwrap();

println!("Position Mint: {:?}", result.position_mint);
println!("Initialization Cost: {} lamports", result.initialization_cost);