Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
Bu sayfa yapay zekâ tarafından otomatik olarak çevrilmiştir. İngilizce sürüm esas alınır.İngilizce sürümü görüntüle →
Bu sayfa her hesabın düzenini ve rolünü açıklar. Seed’ler kanonik olup
reference/program-addresses sayfasında listelenmiştir. CLMM pool’u, CPMM pool’undan daha fazla hesap içerir; bunun nedeni likiditenin tick aralığı boyunca seyrek biçimde depolanmasıdır. Bu seyrekliği anlamak, sayfanın büyük bölümünü oluşturur.Hesap envanteri
Canlı bir CLMM pool’u aşağıdaki hesap aileleriyle tanımlanır. İki mint ve bunların vault’ları dışındaki tüm hesaplar CLMM programına aittir.| Hesap | Amaç | Pool başına adet |
|---|---|---|
AmmConfig | Ücret kademesi: işlem ücreti oranı, protokol payı, fon payı, varsayılan tick-spacing. Bu kademedeki tüm pool’larda ortaklaşa kullanılır. | 1 (paylaşımlı) |
PoolState | Mevcut sqrt_price_x64, mevcut tick, toplam likidite, ücret büyüme genelleri, ödül bilgisi, gözlem işaretçisi. | 1 |
TickArrayState | TICK_ARRAY_SIZE adet bitişik tick’ten oluşan bir blok. Yalnızca talep üzerine başlatılır. | 0 ≤ N ≤ aralık |
TickArrayBitmapExtension | PoolState içindeki satır içi bitmap’in ötesindeki tick array’lerin varlığını izleyen taşma bitmap’i. | 0 veya 1 |
PersonalPositionState | Her LP pozisyonu için bir tane. Aralığı, likiditeyi ve en son görülen ücret/ödül büyümesini depolar. Yetki = NFT sahibi. | Pozisyon başına 1 |
| Pozisyon NFT mint’i | Arzı 1 olan, PersonalPositionState ile ilişkilendirilmiş mint. Transferi, pozisyonu transfer eder. | Pozisyon başına 1 |
ObservationState | TWAP için fiyat gözlemlerinin halka arabelleği. | 1 |
token_0_vault, token_1_vault | Pool’un bakiyelerini tutan token hesapları. Pool yetkisi tarafından sahiplenilir. | 2 |
DynamicFeeConfig | Dinamik ücret mekanizması için yeniden kullanılabilir parametre seti. create_customizable_pool aracılığıyla oluşturulan pool’lar tercihli olarak dahil olabilir. Yönetici tarafından yönetilir. | paylaşımlı (indekse göre) |
LimitOrderState | Her açık limit emir için bir tane. Sahibi, tick’i, yönü, toplam tutarı ve kapatılmış çıktı anlık görüntüsünü kaydeder. | Emir başına 1 |
LimitOrderNonce | Benzersiz emir PDA’larını türeten (cüzdan, nonce_index) başına sayaç. | (cüzdan, indeks) başına 1 |
PoolState
Pool’un canlı durumu; her swap’ta ve her pozisyon değişikliğinde okunur.
sqrt_price_x64vetick_current, pool’un fiyat durumunu temsil eder. Her swap’ta birlikte güncellenir.tick_current,log_{1.0001}(price)ifadesinin tabanıdır.liquidity, aktif likiditeyi temsil eder; yani aralığıtick_current’ı içeren tüm pozisyonlarınLdeğerlerinin toplamıdır. Bir swap bir tick’i geçtiğinde ve bir pozisyon açıldığında/kapatıldığında/yeniden boyutlandırıldığında değişir.fee_growth_global_{0,1}_x64, tüm pool geçmişi boyunca likidite birimi başına kazanılan kümülatif ücretlerdir. Pozisyonlar, kendilerine ne kadar ücret düştüğünü hesaplamak için bunu okur.tick_spacing, başlatma sırasındaAmmConfig’e kilitlenir ve asla değişmez. Hangi tick indekslerinin pozisyon bitiş noktası olarak kullanılabileceğini belirler.tick_array_bitmap, spot fiyat etrafındaki yaygın kullanım aralığını kapsayan satır içi bir bitmap’tir. Pozisyonları çok uzağa ulaşan pool’larda taşma takibi, ayrı birTickArrayBitmapExtensionhesabında tutulur.fee_on, pool oluşturulurken sabitlenir.0(FromInput), klasik Uniswap-V3 davranışını yeniden üretir.1ve2, swap ücretini kitabın tek bir tarafına yönlendirir; ödünleşimler için bkz.products/clmm/fees.dynamic_fee_info, dinamik ücret farkı için volatilite durumunu taşır. Etkinleştirildiğinde, her swapAmmConfig.trade_fee_rate’in üzerine birdynamic_fee_componentyeniden hesaplar. Düzeni aşağıdakiDynamicFeeInfobaşlığında belgelenmiştir; dinamik ücretsiz pool’lar bu struct’ın tamamını sıfır olarak bırakır.
AmmConfig
GET https://api-v3.raydium.io/main/clmm-config):
| İndeks | trade_fee_rate | Tick spacing | Tipik kullanım |
|---|---|---|---|
| 0 | 100 (%0,01) | 1 | Stabil çiftler, USDC/USDT |
| 1 | 500 (%0,05) | 10 | Birbiriyle ilişkili blue-chip’ler |
| 2 | 2_500 (%0,25) | 60 | Standart çiftler |
| 3 | 10_000 (%1,00) | 120 | Volatil veya uzun kuyruklu tokenlar |
protocol_fee_rate ve fund_fee_rate, işlem ücretinin kesirlerini temsil eder; CPMM ile aynı konvansiyondur. Bkz. products/clmm/fees.
TickArrayState
CLMM, tick başına tek bir kayıt depolamaz; bu milyarlarca hesap anlamına gelirdi. Bunun yerine TICK_ARRAY_SIZE adet bitişik başlatılmış-ya-da-başlatılmamış tick’i (program sürümüne bağlı olarak tipik olarak 60 veya 88) tembel bir şekilde ilk kullanımda oluşturulan bir TickArrayState içinde gruplar.
order_phase, kohort kimliğidir. Bir kohort “tamamen doldurulmamış” durumundan “kısmen doldurulmuş” durumuna her geçtiğinde bir artar.orders_amount, mevcut (en yeni) kohortun giriş tokeni toplamıdır.part_filled_orders_remaining, devam eden swap’lar tarafından doldurulmakta olan bir önceki kohoru izler.unfilled_ratio_x64, kohort üzerinde taşınan bir Q64.64 çarpanıdır: bir swap kohortun %X’ini doldurduğunda oran(1 − X)ile çarpılır. Her açık emir, açılış anındaki kendi(order_phase, unfilled_ratio_x64)anlık görüntüsünü depolar; bu sayede kapatma hesabı anlık görüntülerin karşılaştırılmasına indirgenir.
- Bir pozisyon bitiş noktası tick’i t,
t % tick_spacing == 0koşulunu sağlamalıdır. Program, spacing dışındaki pozisyonları reddeder. - Tick’in array’i,
floor(t / (TICK_ARRAY_SIZE * tick_spacing)) * (TICK_ARRAY_SIZE * tick_spacing)konumunda yer alır. - Tick array tembel olarak başlatılır: başlatılmamış bir array’e ilk dokunan pozisyon veya swap onu oluşturur ve rent’i öder.
- Tick array program tarafından hiçbir zaman kapatılmaz. Bir kez tahsis edildikten sonra, içindeki her tick
liquidity_gross == 0’a dönsе bile pool’un ömrü boyunca varlığını sürdürür. Sonraki pozisyonlar ve swap’lar mevcut hesabı ek rent ödemeksizin yeniden kullanır. Tick array’ler içinClosePositionkaynaklı bir temizleme yolu yoktur.
TickArrayBitmapExtension
PoolState.tick_array_bitmap (satır içi) “spot fiyata yakın” aralığı kapsar — ±1.024 tick array. Bu aralığın dışında (aşırı tick değerleri için) program bir uzantı hesabı tutar:
(MIN_TICK, MAX_TICK)) için gereklidir; SDK bunu sizin adınıza çözer.
Pozisyonlar
Bir CLMM pozisyonu, bir mint ile birlikte üç hesaptan oluşan bir pakettir:Pozisyon NFT mint’i
Arzı 1 olan bir SPL Token mint’i. Mint’in adresi deterministik bir PDA’dır; sahibinin cüzdanındaki pozisyon NFT’si yalnızca o tek tokeni tutan bir ATA’dır. NFT’yi transfer etmek, pozisyonu el değiştirmenin yoludur — program yetkilendirmeyi durumda depolanan bir Pubkey’e değil, NFT’nin ATA bakiyesinin mevcut sahibine bağlar.PersonalPositionState
Her açık pozisyon için bir tane. NFT mint’iyle anahtarlanır.
ProtocolPositionState (kullanımdan kaldırıldı)
Eski CLMM sürümleri,
(pool, tick_lower, tick_upper) başına toplu muhasebe bilgilerini bir ProtocolPositionState PDA’sında saklıyordu. Yeni sürümler artık bu hesabı oluşturmuyor veya okumуyor. Yuva, ABI uyumluluğu için OpenPosition / IncreaseLiquidity / DecreaseLiquidity hesap listelerinde UncheckedAccount olarak görünmeye devam etmektedir; ancak program artık ona yazmamaktadır. Zincir üzerindeki mevcut hesaplar artık kullanılmayan kalıntılardır; yönetici, bunların rent’ini geri almak için CloseProtocolPosition’ı çağırabilir.Toplu aralık muhasebesi artık TickArrayState içindeki iki bitiş noktası tick’inden (liquidity_gross, liquidity_net ve tick başına fee_growth_outside_* / reward_growths_outside_x64) doğrudan türetilmektedir. fee_growth_inside = global − outside_lower − outside_upper formülü, toplu pozisyon hesabı olmadan çalışmaya devam etmektedir.Gözlem
(tick_cumulative[t1] − tick_cumulative[t0]) / (t1 − t0) ile hesaplar ve ardından price = 1.0001 ** tick uygular. Bkz. algorithms/clmm-math.
DynamicFeeConfig ve DynamicFeeInfo
Dinamik ücret parametreleri iki yerde bulunur. Yeniden kullanılabilir şablon olan DynamicFeeConfig, yönetici tarafından yönetilir ve dahil olan pool’larda paylaşılır. Pool başına çalışma zamanı durumu olan DynamicFeeInfo ise PoolState içine gömülüdür ve her swap tarafından güncellenir.
DynamicFeeConfig
["dynamic_fee_config", index.to_be_bytes()]. create_dynamic_fee_config (yönetici kısıtlı) aracılığıyla oluşturulur ve update_dynamic_fee_config ile değiştirilir. enable_dynamic_fee = true ile oluşturulan bir pool, oluşturulma anında yapılandırmanın beş kalibrasyon parametresini (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator) kendi DynamicFeeInfo’suna anlık görüntü olarak kaydeder; DynamicFeeConfig’te yapılan sonraki düzenlemeler mevcut pool’ları geriye dönük olarak etkilemez.
DynamicFeeInfo (PoolState içine gömülü)
DynamicFeeConfig’ten kopyalanan kalibrasyon değerleridir. Ücret matematiği ve bozunma kuralları products/clmm/math ve products/clmm/fees altında belgelenmiştir.
Formül tarafından kullanılan sabitler:
| Sabit | Değer | Anlam |
|---|---|---|
VOLATILITY_ACCUMULATOR_SCALE | 10_000 | Volatilite biriktiricisinin granülaritesi |
REDUCTION_FACTOR_DENOMINATOR | 10_000 | reduction_factor için payda |
DYNAMIC_FEE_CONTROL_DENOMINATOR | 100_000 | dynamic_fee_control için payda |
MAX_FEE_RATE_NUMERATOR | 100_000 | Elde edilen ücret oranına %10’luk sabit üst sınır |
LimitOrderState
Her açık limit emir için bir hesap.
- Açma — kullanıcı
open_limit_order’ı çağırır,total_amountkadar giriş tokenini yatırır ve emir birTickStatekohortuna bağlanır. - (isteğe bağlı) Artırma / Azaltma —
increase_limit_order,total_amount’a ekler;decrease_limit_order, doldurulmamış tokenleri (ve o noktaya kadar kapatılmış çıktıyı) iade eder. - Kapatma — kohort tamamen veya kısmen dolduğunda, sahip ya da operasyonel bekçi, çıktı tokenlerini sahibin ATA’sına göndermek için
settle_limit_order’ı çağırır. - Kapama —
unfilled_amount == 0olduğunda hesap kapatılabilir. Rent her zamanowner’a geri döner.
[owner.as_ref(), limit_order_nonce.key().as_ref(), limit_order_nonce.order_nonce.to_be_bytes().as_ref()]. Emir PDA’sı bu nedenle (owner, nonce_index, order_nonce) başına benzersizdir.
LimitOrderNonce
Tek bir kullanıcının PDA çakışması olmadan birden fazla paralel limit emir hattı yürütmesine olanak tanıyan (cüzdan, nonce_index) başına sayaç.
[user_wallet.as_ref(), &[nonce_index]]. Çoğu istemci nonce_index = 0 kullanır ve kardinaliteyi order_nonce’a bırakır.
Temel hesapların türetilmesi
reference/program-addresses sayfasıyla çapraz doğrulamanız önerilir.
Yaşam döngüsü hızlı başvurusu
| Olay | Oluşturulan hesaplar | Yok edilen hesaplar |
|---|---|---|
CreatePool | poolState, observation, token_0_vault, token_1_vault | — |
OpenPosition[WithToken22Nft] | NFT mint + ATA, personalPosition, muhtemelen yeni tickArrayState(ler), henüz mevcut değilse tickArrayBitmapExtension | — |
IncreaseLiquidity | Muhtemelen yeni tickArrayState(ler) | — |
DecreaseLiquidity | — | Muhtemelen tick girişlerini temizler (ancak tickArrayState kendisi kapatılmaz) |
ClosePosition | — | NFT mint, personalPosition |
SwapV2 | Muhtemelen yeni tickArrayState | — |
OpenLimitOrder | limitOrderState, muhtemelen limitOrderNonce (gerekirse başlatır), muhtemelen yeni tickArrayState | — |
IncreaseLimitOrder | — | — |
DecreaseLimitOrder | — | Emir tamamen tükenirse limitOrderState’i kapatır |
SettleLimitOrder | — | — |
CloseLimitOrder | — | limitOrderState (rent → owner) |
CreateDynamicFeeConfig | dynamicFeeConfig | — |
CreateCustomizablePool | poolState, observation, vault’lar — CreatePool ile aynı. enable_dynamic_fee = true ise dynamicFeeConfig’in anlık görüntüsünü alır. | — |
CollectRewards | — | — |
UpdateRewardInfos | — | — |
CloseProtocolPosition (yönetici) | — | Kullanımdan kalkmış protocolPositionState (rent → yönetici) |
TickArrayState hesapları program tarafından hiçbir zaman kapatılmaz — pool’un ömrü boyunca varlığını sürdürürler. Bir tick array başlatıldıktan sonra, içindeki her tick liquidity_gross == 0’a dönsе bile zincir üzerinde kalmaya devam eder. Mevcut bir tick array’i yeniden kullanmak ücretsizdir; yalnızca daha önce hiç başlatılmamış bir array’e ilk dokunan pozisyon rent’i öder.
Neyi nerede okuyacaksınız
- Tick matematiği ve aralık mekaniği:
products/clmm/ticks-and-positions. - Swap akışı ve ücret büyüme matematiği:
products/clmm/math. - Talimat hesap listeleri:
products/clmm/instructions. - Ücretler ve ödül tahakkuku:
products/clmm/fees. - Kanonik program kimliği ve seed’ler:
reference/program-addresses.


