Skip to main content
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üzeni ve rolünü açıklar. Seed’ler kanonik olup reference/program-addresses içinde listelenmiştir. CLMM havuzu, CPMM havuzundan daha fazla hesap gerektirir çünkü likidite tick aralığı boyunca seyrek şekilde depolanır; bu sayfanın büyük bölümü bu seyrekliği anlamakla ilgilidir.

Hesap envanteri

Canlı bir CLMM havuzu aşağıdaki hesap aileleri tarafından tanımlanır. CLMM programı tarafından sahip olunanlar hariç tümü, iki mint ve bunların vault’ları hariç.

PoolState

Havuzun canlı durumu, her swap ve her pozisyon değişikliğinde okunur.
Gerçekten dokunacağınız alanlar:
  • sqrt_price_x64 ve tick_current havuzun fiyat durumudur. Her swap’ta birlikte güncellenir. tick_current, log_{1.0001}(price) tabanıdır.
  • liquidity aktif likidite — aralığı tick_current içeren tüm pozisyonların L değ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 havuz geçmişi boyunca likidite birimi başına kazanılan kümülatif ücretlerdir. Pozisyonlar kendilerine ne borçlu olduğunu hesaplamak için bunu okur.
  • tick_spacing başlatmada AmmConfig ile kilitlenir ve asla değişmez. Hangi tick indekslerine pozisyon uç noktaları olarak izin verildiğini belirler.
  • tick_array_bitmap spot fiyatın etrafındaki “yakın” aralığı kapsayan satır içi bir bitmap’tir — ±1.024 tick dizisi. Bu aralığın dışında (aşırı tick değerleri için), program ayrı bir uzantı hesabı tutar.
  • fee_on havuz oluşturmada sabitlenir. 0 (FromInput) klasik Uniswap-V3 davranışını yeniden üretir. 1 ve 2 swap ücretini kitabın tek bir tarafına yönlendirir — ödünleşmeler için products/clmm/fees bölümüne bakın.
  • seed_index CreatePool / CreateCustomizablePool aracılığıyla oluşturulan her havuz için [0, 0] değeridir. Sıfır olmayan bir değer, havuzun CreatePermissionedPool aracılığıyla oluşturulduğu ve dizinin havuzun PDA seed’lerinin bir parçası olduğu anlamına gelir, aynı (config, mint0, mint1) için birkaç havuzun bir arada bulunmasını sağlar. Böyle bir havuzun adresini yeniden türetmek için seed_index değerini bilmeniz gerekir.
  • dynamic_fee_info dinamik ücret artışı için oynaklık durumunu taşır. Etkinleştirildiğinde, her swap AmmConfig.trade_fee_rate üzerine bir dynamic_fee_component yeniden hesaplar. Düzen DynamicFeeInfo altında belgelenmiştir; dinamik ücret olmayan havuzlar tüm yapıyı sıfır bırakır.

AmmConfig

Tipik yayınlanan CLMM ücret katmanları seti (GET https://api-v3.raydium.io/main/clmm-config ile doğrulayın): protocol_fee_rate ve fund_fee_rate işlem ücretinin kesintileridir; CPMM ile aynı kural. products/clmm/fees bölümüne bakın.

TickArrayState

CLMM tek bir tick başına bir kayıt depolamaz. Bu milyarlarca hesap olurdu. Bunun yerine TICK_ARRAY_SIZE bitişik başlatılmış-veya-değil tick’leri (program sürümüne bağlı olarak tipik olarak 60 veya 88) ilk kullanımda tembel olarak oluşturulan bir TickArrayState içine gruplandırır.
Dört limit emri alanı, hiçbir zaman limit emri taşımamış herhangi bir tick’te sıfırdır. Emirler bir tick’te açıldığında, program bunları bir dizi kohort olarak izler:
  • order_phase kohort kimliğidir. Bir kohort “tümü doldurulmamış” durumundan “kısmen doldurulmuş” durumuna geçtiğinde her seferinde artar.
  • orders_amount mevcut (en yeni) kohortin giriş-token toplamıdır.
  • part_filled_orders_remaining şu anda devam eden swap’lar tarafından doldurulmakta olan önceki kohortu izler.
  • unfilled_ratio_x64 kohort üzerinde taşınan bir Q64.64 çarpanıdır: bir swap kohortu X% doldurduğunda, oran (1 − X) ile çarpılır. Her açık emir açılış zamanında kendi (order_phase, unfilled_ratio_x64) anlık görüntüsünü depolar, bu nedenle kapatma matematiği anlık görüntüleri karşılaştırmaya indirgenir.
Kurallar:
  • Bir pozisyon uç noktası tick’i t t % tick_spacing == 0 koşulunu sağlamalıdır. Program aralık dışı pozisyonları reddeder.
  • Tick’in dizisi floor(t / (TICK_ARRAY_SIZE * tick_spacing)) * (TICK_ARRAY_SIZE * tick_spacing) konumunda bulunur.
  • Bir tick dizisi tembel olarak başlatılır: başlatılmamış bir diziyi dokunacak ilk pozisyon veya swap onu oluşturur ve kirayı öder.
  • Bir tick dizisi program tarafından asla kapatılmaz. Bir kez tahsis edildikten sonra, içindeki her tick liquidity_gross == 0 durumuna döndükten sonra bile havuzun ömrü boyunca devam eder. Sonraki pozisyonlar ve swap’lar mevcut hesabı ek kira ödemeden yeniden kullanır. Tick dizileri için ClosePosition tarafından yönlendirilen temizleme yolu yoktur.

TickArrayBitmapExtension

PoolState.tick_array_bitmap (satır içi) “spot’a yakın” aralığı kapsar — ±1.024 tick dizisi. Bu aralığın dışında (aşırı tick değerleri için), program bir uzantı hesabı tutar:
Pozisyonunuzun aralığı “normal” ise, uzantı hesabı hakkında hiç düşünmezsiniz. Tam aralık pozisyonları (örn. (MIN_TICK, MAX_TICK)) bunu gerektirir; SDK bunu sizin için çözer.

Pozisyonlar

Bir CLMM pozisyonu üç hesap artı bir mint’in bir paketidir:

Position NFT mint

Arz 1 olan SPL Token veya Token-2022 mint’i. Sahibinin cüzdanındaki pozisyon NFT’si o tek token’ı tutan bir ATA’dır. Program yetkilendirmeyi durumda depolanan bir Pubkey’e değil, NFT’nin ATA bakiyesinin mevcut sahibine anahtarlar. Yeni pozisyon NFT mint’leri, tek token’ı basıp mint yetkilisini kaldırmadan önce pool_state öğesini dondurma yetkilisi olarak ayarlar. Bir dondurma yetkilisi ayarlamak, NFT hesabını kendiliğinden dondurmaz. Hesap, her iki koşul da geçerli olmadığı sürece dondurulmamış ve aktarılabilir kalır: çağıran OpenPositionV2 veya OpenPositionWithToken22Nft kullanır ve en az bir temel vault mint’in dondurma yetkilisi CLMM’nin kısıtlı-yayıncı listesinde görünür. Yalnızca o zaman CLMM, basıldıktan sonra NFT hesabını dondurur. Bu, PersonalPositionState veya PoolState baytlarında hiçbir değişiklik yapmaz.

PersonalPositionState

Açık pozisyon başına bir tane. NFT mint’i kapalı anahtarlanmış.

ProtocolPositionState (kullanımdan kaldırıldı)

Eski CLMM sürümleri (havuz, tick_lower, tick_upper) başına toplam defter tutmayı bir ProtocolPositionState PDA’sında depoladı. Yeni sürümler artık bu hesabı oluşturmaz veya okumaz. Slot, ABI uyumluluğu için OpenPosition / IncreaseLiquidity / DecreaseLiquidity hesap listelerinde bir UncheckedAccount olarak görünmeye devam eder, ancak program buna yazmaz. Zincir üzerinde mevcut hesaplar kalıntıdır; yönetici kirayı geri almak için CloseProtocolPosition çağırabilir.Toplam aralık defter tutması artık doğrudan iki uç noktası tick’ten (liquidity_gross, liquidity_net ve tick başına fee_growth_outside_* / reward_growths_outside_x64) TickArrayState içinde türetilir. Ücret-büyüme-içi formülü fee_growth_inside = global − outside_lower − outside_upper toplam pozisyon hesabı olmadan çalışmaya devam eder.

Gözlem

CLMM’nin gözlem tamponu kümülatif fiyat değil kümülatif tick depolar. Harici tüketiciler (tick_cumulative[t1] − tick_cumulative[t0]) / (t1 − t0) aralığından geometrik-ortalama fiyatı hesaplar ve ardından price = 1.0001 ** tick hesaplar. algorithms/clmm-math bölümüne bakın.

DynamicFeeConfig ve DynamicFeeInfo

Dinamik ücret parametreleri iki yerde yaşar. Yeniden kullanılabilir şablon — DynamicFeeConfig — yönetici tarafından yönetilir ve katılan havuzlar arasında paylaşılır. Havuz başına çalışma zamanı durumu — DynamicFeeInfoPoolState içine gömülü ve her swap tarafından güncellenir.

DynamicFeeConfig

PDA seed’i: ["dynamic_fee_config", index.to_be_bytes()]. create_dynamic_fee_config (yönetici kapılı) aracılığıyla oluşturulur ve update_dynamic_fee_config aracılığıyla değiştirilir. enable_dynamic_fee = true ile oluşturulan bir havuz, yapılandırmanın beş kalibrasyon parametresini (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator) oluşturma zamanında kendi DynamicFeeInfo öğesine kaydeder; DynamicFeeConfig öğesine yapılan sonraki düzenlemeler mevcut havuzları geriye dönük olarak etkilemez.

DynamicFeeInfo (PoolState içine gömülü)

Alt dört alan durumdur; üst beş alan DynamicFeeConfig öğesinden 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:

LimitOrderState

Açık limit emri başına bir hesap.
Yaşam döngüsü:
  1. — kullanıcı open_limit_order çağırır, giriş token’ının total_amount öğesini yatırır, emir bir TickState kohortuna bağlanır.
  2. (isteğe bağlı) Artır / Azaltincrease_limit_order total_amount öğesine ekler; decrease_limit_order doldurulmamış token’ları (ve o noktaya kadar kapatılan herhangi bir çıktıyı) döndürür.
  3. Kapat — kohort tamamen veya kısmen doldurulduğunda, sahibi veya operasyonel bekçi çıktı token’larını sahibinin ATA’sına göndermek için settle_limit_order çağırır.
  4. Kapatunfilled_amount == 0 olduğunda, hesap kapatılabilir. Kira her zaman owner öğesine döner.
PDA seed’i: [owner.as_ref(), limit_order_nonce.key().as_ref(), limit_order_nonce.order_nonce.to_be_bytes().as_ref()]. Sipariş PDA’sı bu nedenle (owner, nonce_index, order_nonce) başına benzersizdir.

LimitOrderNonce

(cüzdan, nonce_index) başına sayaç, tek bir kullanıcının PDA’larda çarpışmadan limit emirlerinin birden fazla paralel boru hattını çalıştırmasını sağlar.
PDA seed’i: [user_wallet.as_ref(), &[nonce_index]]. Çoğu istemci nonce_index = 0 kullanır ve order_nonce öğesinin kardinaliteyi taşımasına izin verir.

Permission

Varlığı izin olan bir yetenek hesabı: belirli bir yetki için bir Permission PDA’sı türetilirse, bu yetki CreatePermissionedPool çağırabilir. Oluşturulduğu yetkilendirmenin ötesinde hiçbir şey depolamaz.
PDA seed’i: ["permission", authority.as_ref()]. Yönetici tarafından CreatePermissionPda aracılığıyla oluşturulur ve ClosePermissionPda aracılığıyla yıkılır (kira çağırana döner). Her iki yönetici talimatı da program admin veya özel bir permission_pda_admin anahtarını kabul eder. PDA’yı kapatmak izni iptal eder — yetki artık ek havuzlar oluşturamaz, ancak zaten oluşturduğu havuzlar etkilenmez.

Anahtar hesapları türetme

Tam seed dizgeleri her zaman zincir üzerindeki IDL ve reference/program-addresses ile çift kontrol edilmelidir.

Yaşam döngüsü hızlı referansı

TickArrayState hesapları program tarafından asla kapatılmaz — havuzun ömrü boyunca devam ederler. Bir tick dizisi başlatıldıktan sonra, içindeki her tick liquidity_gross == 0 durumuna döndükten sonra bile zincir üzerinde kalır. Mevcut bir tick dizisini yeniden kullanmak ücretsizdir; yalnızca hiçbir zaman başlatılmamış bir diziyi dokunacak ilk pozisyon kirayı öder.

Nerede ne okuyacağınız

Kaynaklar: