CLMM-Instruktionen

​

Instruktionsübersicht

​

CreatePool

sqrt_price_x64: u128           // Anfangspreis
open_time:      u64            // Swaps vor diesem Zeitpunkt werden abgelehnt

• token_mint_0 < token_mint_1 nach Byte-Reihenfolge.
• amm_config.disable_create_pool == false.
• Mints werden nicht durch die Token-2022-Extension-Allowlist abgelehnt.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (noch keine Positionen).
• pool_state.fee_on = FromInput (Legacy-Standard).
• pool_state.dynamic_fee_info ist auf null gesetzt (Dynamic Fee deaktiviert).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on wird auf die gewählte CollectFeeOn-Variante gesetzt.
• Wenn Dynamic Fee aktiviert wurde: pool_state.dynamic_fee_info wird aus der übergebenen DynamicFeeConfig initialisiert (fünf Kalibrierungsparameter werden kopiert; Zustandsfelder auf null gesetzt).
• Andernfalls: pool_state.dynamic_fee_info bleibt null (= Dynamic Fee für diesen Pool dauerhaft inaktiv).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // gewünschtes L (oder 0, um die untenstehenden Beträge zu verwenden)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // NFT-Metadaten schreiben (Metaplex)
base_flag: Option<bool>       // true = an amount0 anpassen; false = an amount1 anpassen

• tick_lower < tick_upper, beide Vielfache von pool.tick_spacing, innerhalb von [MIN_TICK, MAX_TICK].
• Erforderliche Tick-Arrays übergeben und initialisiert (oder in der Transaktion über InitTickArray-CPI erstellt).
• Nutzer verfügt über mindestens amount_0_max und amount_1_max in den Quell-ATAs.

• personal_position existiert, liquidity ist gesetzt, fee_growth_inside_last wurde gespeichert.
• Tick-Array-Einträge bei tick_lower und tick_upper aktualisiert (liquidity_gross += L, liquidity_net ± L, Fee-Growth-Snapshots gepflegt).
• pool_state.liquidity += L, sofern die Position im Bereich liegt (tick_lower ≤ tick_current < tick_upper).

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• Überträgt amount_0_actual / amount_1_actual vom Nutzer an die Vaults.
• Erhöht personal_position.liquidity und pool_state.liquidity (wenn im Bereich) sowie liquidity_gross / liquidity_net der Endpunkt-Ticks entsprechend.
• Sammelt ausstehende Gebühren und Rewards seit dem letzten Zugriff und schreibt sie in tokens_fees_owed_{0,1} / reward_amount_owed. Diese werden erst bei DecreaseLiquidity oder CollectReward ausgezahlt, nicht beim Erhöhen.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Berechnet (amount_0, amount_1) für das entfernte L auf Basis des aktuellen sqrt_price_x64.
• Rechnet seit dem letzten Zugriff aufgelaufene Gebühren/Rewards ab, genau wie bei IncreaseLiquidity.
• Überträgt amount_0 + fees_owed_0 und amount_1 + fees_owed_1 aus den Vaults an den Nutzer.
• Vermindert die Liquiditätszähler; wenn personal_position.liquidity == 0 nach der Reduktion, ist die Position für ClosePosition freigegeben.

​

ClosePosition

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Alle Reward-Zähler reward_amount_owed == 0.

• Verbrennt das NFT.
• Schließt den NFT-Mint-Account und den personal_position-Account; die Rent wird an den payer zurückerstattet.

​

SwapV2

amount: u64                  // Input, wenn is_base_input=true, sonst Output
other_amount_threshold: u64  // Mindest-Output oder maximaler Input
sqrt_price_limit_x64: u128   // harte Grenze; 0 ⇒ unbegrenzt
is_base_input: bool

• pool_state.status erlaubt Swaps.
• now >= open_time.
• sqrt_price_limit_x64 liegt für die gewählte Richtung auf der richtigen Seite von sqrt_price_x64.

1. Dynamic-Fee-Zuschlag — wenn pool.dynamic_fee_info ungleich null ist, aktualisiert das Programm den Volatilitätsakkumulator anhand der seit dem letzten Swap zurückgelegten Tick-Distanz (mit den Filter-/Decay-Regeln aus products/clmm/fees) und addiert eine dynamic_fee_component zur AmmConfig.trade_fee_rate. Die Gesamtgebühr ist auf 10 % begrenzt (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Limit-Order-Matching — wenn der Preispfad einen Tick mit offenen Limit Orders kreuzt, füllt das Programm zuerst die verfügbare Limit-Order-Liquidität an diesem Tick (FIFO nach order_phase) und fährt dann entlang der LP-Liquiditätskurve fort. Gefüllte Beträge aktualisieren tick.unfilled_ratio_x64 und tick.part_filled_orders_remaining für die spätere Abrechnung; die Orders selbst bleiben unverändert, bis der Inhaber SettleLimitOrder aufruft.
3. Einseitiges Fee-Routing — wenn pool.fee_on = Token0Only oder Token1Only, berechnet der Swap-Schritt denselben Input-Output-Handel; die Gebühr wird dann an die konfigurierte Seite weitergeleitet. Bei Richtungen, bei denen die konfigurierte Fee-Seite die Ausgabe ist, wird die Gebühr vom Swap-Output abgezogen (der Nutzer erhält out − fee); bei Richtungen, bei denen sie der Input ist, entspricht das Verhalten FromInput. Siehe is_fee_on_input(zero_for_one) und is_fee_on_token0(zero_for_one) auf PoolState.

​

OpenLimitOrder

nonce_index:    u8       // vom Nutzer gewählter Nonce-Account-Index (0..255 pro Wallet)
zero_for_one:   bool     // true: token0 gegen token1 verkaufen; false: token1 gegen token0
tick_index:     i32      // muss ein Vielfaches von pool.tick_spacing sein
amount:         u64      // Input-Token-Betrag

• tick_index % pool.tick_spacing == 0 und innerhalb von [MIN_TICK, MAX_TICK].
• tick_index liegt auf der richtigen Seite von pool.tick_current für die gewählte Richtung (token0 verkaufen → Tick muss oberhalb des aktuellen liegen, und umgekehrt). Eine Order an einem bereits überquerten Tick würde sofort gematcht und wird abgelehnt.
• pool_state.status erlaubt Limit-Order-Operationen (Bit 5).

• limit_order existiert und hat tick.order_phase sowie tick.unfilled_ratio_x64 zum Öffnungszeitpunkt gespeichert.
• tick.orders_amount += amount (in der aktuellen Kohorte).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent wird ausgelöst.

​

IncreaseLimitOrder

amount: u64    // zusätzlicher Input-Token-Betrag

• limit_order.owner == signer.
• Die Order befindet sich noch in derselben Kohorte (tick.order_phase == limit_order.order_phase). Hat die Kohorte bereits begonnen sich zu füllen, ist die Order teilweise abgerechnet — der Aufrufer sollte zunächst DecreaseLimitOrder oder SettleLimitOrder aufrufen, um den Status voranzubringen.

• Überträgt amount vom Inhaber-ATA an input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // zurückzuziehender Input-Token-Betrag (max = ungefüllter Rest)
amount_min: u64    // Slippage-Untergrenze für die Input-seitige Auszahlung

• Berechnet den gefüllten Betrag der Order aus dem unfilled_ratio_x64 der Kohorte seit der Öffnung neu.
• Sendet gefüllten Output an output_token_account.
• Sendet amount des ungefüllten Inputs zurück an input_token_account.
• Aktualisiert limit_order entsprechend. Ist der verbleibende ungefüllte Rest null, schließt das Programm den Account und erstattet die Rent an owner zurück.

​

SettleLimitOrder

• Berechnet den kumulativen geschuldeten Output anhand von (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• Überträgt die Differenz an output_token_account.
• Aktualisiert limit_order.settled_output.
• Schließt die Order nicht; sie bleibt für verbleibenden Input offen.

​

CloseLimitOrder

• Die Order hat einen ungefüllten Rest von null (entweder wurde amount == total_amount gefüllt und abgerechnet, oder der Inhaber hat die Order zuvor auf null reduziert und vergessen zu schließen).

• Schließt limit_order; Rent wird an limit_order.owner gesendet.

​

CreateDynamicFeeConfig (Admin)

index:                       u16
filter_period:               u16   // Sekunden; z. B. 30
decay_period:                u16   // Sekunden; z. B. 600. Muss > filter_period sein
reduction_factor:            u16   // 1..10_000; z. B. 5_000 = 50 % Retention pro Decay-Fenster
dynamic_fee_control:         u32   // 1..100_000; Verstärkung auf der Volatilitäts-zu-Gebühren-Kurve
max_volatility_accumulator:  u32   // Obergrenze

​

UpdateDynamicFeeConfig (Admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

• Weniger als 3 Streams derzeit am Pool aktiv.
• Der Funder hinterlegt im Rahmen dieser Instruktion total_emission = emissions_per_second × (end_time − open_time) Reward-Token im Vault.
• Reward-Mint gemäß operation_state auf der Whitelist.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Rechnet Reward-Wachstum ab (gleiche Logik wie bei Gebühren).
• Überträgt den geschuldeten Betrag an die Empfänger-ATA; reward_amount_owed[i] wird auf null gesetzt.

​

Zustandsänderungsmatrix

​

Weiterführende Ressourcen

• products/clmm/code-demos — ausführbare TypeScript-Beispiele.
• products/clmm/fees — Details zur Gebühren- und Reward-Akkumulation.
• reference/error-codes — vollständige CLMM-Anchor-Fehlertabelle.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2