Skip to main content
Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →
Halaman ini menjelaskan tata letak dan peran setiap akun. Seed bersifat kanonik dan tercantum di reference/program-addresses. Pool CLMM lebih berat dalam hal akun dibanding pool CPMM karena likuiditas disimpan secara sparse di seluruh rentang tick; memahami sparsity ini adalah inti dari halaman ini.

Inventaris akun

Pool CLMM yang aktif dijelaskan oleh keluarga akun berikut. Semua dimiliki oleh program CLMM kecuali dua mint dan vault mereka.

PoolState

Status pool yang aktif, dibaca pada setiap swap dan setiap perubahan posisi.
Field yang benar-benar akan Anda sentuh:
  • sqrt_price_x64 dan tick_current adalah state harga pool. Keduanya diperbarui bersama pada setiap swap. tick_current adalah floor dari log_{1.0001}(price).
  • liquidity adalah likuiditas aktif — jumlah nilai L untuk semua posisi yang rentangnya berisi tick_current. Berubah setiap kali swap melintasi tick dan setiap kali posisi dibuka/ditutup/diubah ukurannya.
  • fee_growth_global_{0,1}_x64 adalah fee kumulatif yang diperoleh per unit likuiditas di seluruh riwayat pool. Posisi membaca ini untuk menghitung apa yang mereka terima.
  • tick_spacing terkunci ke AmmConfig saat inisialisasi dan tidak pernah berubah. Ini menentukan indeks tick mana yang diizinkan menjadi endpoint posisi.
  • tick_array_bitmap adalah bitmap inline yang mencakup rentang tick yang “dekat dengan spot” — ±1.024 tick array. Untuk pool yang posisinya menjangkau jauh, pelacakan overflow berada di akun TickArrayBitmapExtension terpisah.
  • fee_on ditetapkan saat pembuatan pool. 0 (FromInput) mereproduksi perilaku Uniswap-V3 klasik. 1 dan 2 mengarahkan biaya swap ke satu sisi buku — lihat products/clmm/fees untuk trade-off.
  • seed_index adalah [0, 0] untuk setiap pool yang dibuat melalui CreatePool / CreateCustomizablePool (satu pool kanonik per pasangan). Nilai non-zero berarti pool dibuat via CreatePermissionedPool dan index adalah bagian dari seed PDA pool, memungkinkan beberapa pool hidup berdampingan untuk (config, mint0, mint1) yang sama. Untuk menurunkan ulang alamat pool seperti itu Anda harus mengetahui seed_index-nya.
  • dynamic_fee_info membawa state volatilitas untuk surcharge dynamic-fee. Ketika diaktifkan, setiap swap menghitung ulang dynamic_fee_component di atas AmmConfig.trade_fee_rate. Tata letak didokumentasikan di bawah DynamicFeeInfo; pool tanpa dynamic fee membiarkan seluruh struct bernilai nol.

AmmConfig

Set tier biaya CLMM yang biasanya dipublikasikan (konfirmasi terhadap GET https://api-v3.raydium.io/main/clmm-config): protocol_fee_rate dan fund_fee_rate adalah fraksi dari biaya perdagangan; konvensi yang sama dengan CPMM. Lihat products/clmm/fees.

TickArrayState

CLMM tidak menyimpan satu record per tick. Itu akan menjadi miliaran akun. Sebaliknya, ia mengelompokkan TICK_ARRAY_SIZE tick yang berdekatan yang diinisialisasi atau tidak (biasanya 60 atau 88 tergantung versi program) ke dalam TickArrayState yang dibuat secara lazy saat pertama kali digunakan.
Empat field limit-order adalah nol pada tick apa pun yang tidak pernah digunakan untuk limit order. Ketika order dibuka pada tick, program melacaknya sebagai urutan cohort:
  • order_phase adalah id cohort. Ini bertambah setiap kali cohort bertransisi dari “semua unfilled” ke “partially filled.”
  • orders_amount adalah total input-token dari cohort saat ini (terbaru).
  • part_filled_orders_remaining melacak cohort sebelumnya yang saat ini sedang diisi oleh swap yang sedang berlangsung.
  • unfilled_ratio_x64 adalah pengali Q64.64 yang dibawa pada cohort: ketika swap mengisi X% dari cohort, rasio dikalikan dengan (1 − X). Setiap open order menyimpan snapshot (order_phase, unfilled_ratio_x64) sendiri saat waktu open, jadi settle math berkurang menjadi membandingkan snapshot.
Aturan:
  • Endpoint tick posisi t harus memenuhi t % tick_spacing == 0. Program menolak posisi off-spacing.
  • Array tick berada di floor(t / (TICK_ARRAY_SIZE * tick_spacing)) * (TICK_ARRAY_SIZE * tick_spacing).
  • Tick array diinisialisasi secara lazy: posisi pertama atau swap yang menyentuh array yang tidak diinisialisasi membuatnya, membayar rent.
  • Tick array tidak pernah ditutup oleh program. Setelah dialokasikan, ia bertahan untuk seumur hidup pool, bahkan setelah setiap tick di dalamnya kembali ke liquidity_gross == 0. Posisi dan swap berikutnya menggunakan kembali akun yang ada tanpa rent tambahan. Tidak ada jalur pembersihan yang didorong ClosePosition untuk tick array.

TickArrayBitmapExtension

PoolState.tick_array_bitmap (inline) mencakup rentang “dekat dengan spot” — ±1.024 tick array. Di luar rentang itu (untuk nilai tick ekstrem), program mempertahankan akun extension:
Jika rentang posisi Anda “normal”, Anda tidak pernah memikirkan akun extension. Posisi full-range (misalnya, (MIN_TICK, MAX_TICK)) memerlukan; SDK menyelesaikannya untuk Anda.

Posisi

Posisi CLMM adalah bundle dari tiga akun plus mint:

Position NFT mint

Mint SPL Token atau Token-2022 dengan supply 1. Position NFT di dompet pemilik adalah ATA yang menyimpan token tunggal itu. Program mengikat otorisasi ke pemegang saat ini dari saldo ATA NFT, bukan ke Pubkey yang disimpan dalam state. Mint NFT posisi baru menetapkan pool_state sebagai freeze authority mereka sebelum mencetak token tunggal dan menghapus mint authority. Menetapkan freeze authority tidak dengan sendirinya membekukan akun NFT. Akun tetap tidak dibekukan dan dapat ditransfer kecuali kedua kondisi berlaku: pemanggil menggunakan OpenPositionV2 atau OpenPositionWithToken22Nft, dan freeze authority dari setidaknya satu mint vault yang mendasar muncul di daftar restricted-issuer CLMM. Hanya kemudian CLMM membekukan akun NFT setelah mencetak. Ini tidak mengubah byte PersonalPositionState atau PoolState apa pun.

PersonalPositionState

Satu per posisi terbuka. Dikunci dari mint NFT.

ProtocolPositionState (deprecated)

Rilis CLMM yang lebih lama menyimpan bookkeeping agregat per-(pool, tick_lower, tick_upper) dalam PDA ProtocolPositionState. Rilis yang lebih baru tidak lagi membuat atau membaca akun ini. Slot masih muncul di daftar akun OpenPosition / IncreaseLiquidity / DecreaseLiquidity sebagai UncheckedAccount untuk kompatibilitas ABI, tetapi program tidak menulis ke dalamnya. Akun yang ada on-chain adalah vestigial; admin dapat memanggil CloseProtocolPosition untuk mengklaim kembali rent untuk mereka.Bookkeeping rentang agregat sekarang diturunkan langsung dari dua endpoint tick (liquidity_gross, liquidity_net, dan per-tick fee_growth_outside_* / reward_growths_outside_x64) di TickArrayState. Formula fee-growth-inside fee_growth_inside = global − outside_lower − outside_upper terus bekerja tanpa akun posisi agregat.

Observation

Buffer observasi CLMM menyimpan cumulative tick, bukan cumulative price. Konsumen eksternal menghitung geometric-mean price di atas interval dari (tick_cumulative[t1] − tick_cumulative[t0]) / (t1 − t0) dan kemudian price = 1.0001 ** tick. Lihat algorithms/clmm-math.

DynamicFeeConfig dan DynamicFeeInfo

Parameter dynamic fee berada di dua tempat. Template yang dapat digunakan kembali — DynamicFeeConfig — dikelola admin dan dibagikan di seluruh pool yang memilih untuk mengikuti. State runtime per-pool — DynamicFeeInfo — tertanam dalam PoolState dan diperbarui oleh setiap swap.

DynamicFeeConfig

Seed PDA: ["dynamic_fee_config", index.to_be_bytes()]. Dibuat via create_dynamic_fee_config (admin-gated) dan dimodifikasi via update_dynamic_fee_config. Pool yang dibuat dengan enable_dynamic_fee = true mengambil snapshot lima parameter kalibrasi config (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator) ke dalam DynamicFeeInfo sendiri saat waktu pembuatan; edit kemudian ke DynamicFeeConfig tidak secara retroaktif mempengaruhi pool yang ada.

DynamicFeeInfo (tertanam dalam PoolState)

Empat field bawah adalah state; lima field atas adalah kalibrasi yang disalin dari DynamicFeeConfig. Fee math dan decay rules didokumentasikan di bawah products/clmm/math dan products/clmm/fees. Konstanta yang digunakan oleh formula:

LimitOrderState

Satu akun per limit order yang terbuka.
Lifecycle:
  1. Open — user memanggil open_limit_order, menyetor total_amount dari input token, order terikat ke cohort TickState.
  2. (optional) Increase / Decreaseincrease_limit_order menambah total_amount; decrease_limit_order mengembalikan token unfilled (dan output yang sudah settled hingga saat itu).
  3. Settle — ketika cohort fully atau partially filled, owner atau operational keeper memanggil settle_limit_order untuk mendorong output token ke ATA pemilik.
  4. Close — setelah unfilled_amount == 0, akun dapat ditutup. Rent selalu kembali ke owner.
Seed PDA: [owner.as_ref(), limit_order_nonce.key().as_ref(), limit_order_nonce.order_nonce.to_be_bytes().as_ref()]. Order PDA oleh karena itu unik per (owner, nonce_index, order_nonce).

LimitOrderNonce

Per-(wallet, nonce_index) counter yang memungkinkan satu user menjalankan beberapa pipeline limit order paralel tanpa bertabrakan pada PDA.
Seed PDA: [user_wallet.as_ref(), &[nonce_index]]. Sebagian besar klien menggunakan nonce_index = 0 dan membiarkan order_nonce membawa cardinality.

Permission

Akun capability yang keberadaannya adalah grant: jika PDA Permission diturunkan untuk authority tertentu, authority itu dapat memanggil CreatePermissionedPool. Ia tidak menyimpan apa pun di luar authority yang dibuat untuknya.
Seed PDA: ["permission", authority.as_ref()]. Dibuat oleh admin via CreatePermissionPda dan dihancurkan via ClosePermissionPda (rent refund ke pemanggil). Kedua instruksi admin menerima baik program admin atau dedicated permission_pda_admin key. Menutup PDA mencabut grant — authority tidak lagi dapat membuat pool tambahan, tetapi pool yang sudah dibuat tidak terpengaruh.
String seed yang tepat harus selalu diperiksa ulang terhadap IDL on-chain dan reference/program-addresses.

Referensi cepat lifecycle

Akun TickArrayState tidak pernah ditutup oleh program — mereka bertahan untuk seumur hidup pool. Setelah tick array diinisialisasi, ia tetap on-chain bahkan ketika setiap tick di dalamnya kembali ke liquidity_gross == 0. Menggunakan kembali tick array yang ada adalah gratis; hanya posisi pertama yang menyentuh array yang tidak pernah diinisialisasi yang membayar rent-nya.

Apa yang dibaca di mana

Sumber: