Langsung ke konten utama

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.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

Model biaya

Stable AMM menggunakan struktur biaya yang sama dengan AMM v4. Setiap pool hanya memiliki satu tingkat biaya (ditetapkan saat inisialisasi); pool tidak dapat dikonfigurasi ulang ke tingkat yang lebih tinggi.
FieldDefaultMakna
swap_fee_numerator / swap_fee_denominator25 / 10_000Biaya perdagangan kotor: 0,25% dari volume input.
trade_fee_numerator / trade_fee_denominator25 / 10_000Sama 0,25%, digunakan oleh integrasi OpenBook untuk penentuan harga pesanan.
pnl_numerator / pnl_denominator12 / 100Bagian protokol dari biaya: 12% — yaitu, 0,25% × 12% = 0,03% dari volume.
min_separate_numerator / min_separate_denominator4 / 10_000Lantai pembulatan internal.
Tidak ada biaya dana dan biaya kreator — ini adalah inovasi pasca-AMM v4 (CPMM/CLMM). Stable AMM mendahului konvensi tersebut.

Cara pembagian dihitung

Pada setiap swap:
gross_fee = ceil(amount_in * (swap_fee_numerator / swap_fee_denominator))    // misalnya, 0,25% dari amount_in
pnl_portion = gross_fee * (pnl_numerator / pnl_denominator)                  // 12% dari gross_fee
lp_portion = gross_fee − pnl_portion                                          // 88% dari gross_fee
  • lp_portion tetap di vault, menaikkan k, dan menguntungkan LP saat penebusan.
  • pnl_portion menambah AmmInfo.out_put.need_take_pnl_coin atau need_take_pnl_pc (tergantung token input) dan disapu oleh WithdrawPnl.
Trik yang menjaga invarian sama seperti CPMM: jumlah PnL secara fisik berada di vault tetapi dikurangkan dari “cadangan efektif” yang digunakan dalam matematika kurva, sehingga menghapusnya tidak mengubah harga.

PnL dari OpenBook (sama seperti AMM v4)

Ketika pesanan limit pool di OpenBook terisi, dapat terjadi di sisi penerima dan memperoleh atau kehilangan spread pembuat pasar/penerima. Pengisian ini diselesaikan selama MonitorStep dan mengkredit/mendebit cadangan pool. Program melacaknya dalam penghitung out_put.total_pnl_{coin,pc} untuk analitik. PnL OpenBook ini berbeda dari biaya protokol 0,03%. Ini menaikkan cadangan pool dan menguntungkan LP dan protokol secara proporsional. Ketergantungan operasional pada OpenBook adalah alasan mengapa CPMM (independen dari buku pesanan) sekarang menjadi default untuk pool baru.

Pengumpulan

Multisig Raydium (atau siapa pun yang mengontrol amm_admin) memanggil WithdrawPnl untuk menyapu:
  1. Menyelesaikan pengisian OpenBook yang tertunda terlebih dahulu (melalui logika krank internal).
  2. Mentransfer need_take_pnl_coin dan need_take_pnl_pc dari vault ke akun yang ditunjuk admin.
  3. Mengosongkan penghitung.
Operasi ini tidak memindahkan kurva. LP tidak melihat perubahan harga.

Penebusan biaya LP

Tidak ada instruksi khusus “kumpulkan biaya”. Biaya LP terakumulasi di vault, menaikkan cadangan. LP merealisasikannya dengan membakar LP melalui Withdraw. Nilai token LP tumbuh seiring pertumbuhan cadangan.

Visualisasi: kemana volume $1.000 pergi

Pada USDC yang didominasi Swap senilai $1.000 terhadap pool Stable dengan parameter default:
Biaya perdagangan kotor (0,25%):     $2,50
  Bagian LP   (0,22%):               $2,20  → tetap di pool, menaikkan k
  Bagian PnL  (0,03%):               $0,30  → need_take_pnl_pc, disapu oleh WithdrawPnl
Pengguna menerima (minus kurva):     $997,50
Bandingkan dengan AMM v4 (identik) dan CPMM (tingkat 0,25%, tidak ada biaya kreator): CPMM memberikan LP $2,10, protokol $0,30, dana $0,10.

Tabel perbandingan

Stable AMMAMM v4CPMM index=0
Biaya perdagangan0,25%0,25%0,25%
LP0,22%0,22%0,21%
Protokol0,03%0,03%0,03%
DanaTidak adaTidak ada0,01%
KreatorTidak adaTidak ada0 secara default
Matriks lengkap: reference/fee-comparison.

Catatan integrator

  • Penawaran: Selalu baca AmmInfo dari chain; jangan hardcode biaya. Pada prinsipnya SetParams dapat mengubahnya, meskipun multisig belum mengubah default.
  • Kurva vs. biaya: Biaya 0,25% tidak bergantung pada apakah kurva adalah formula (x·y=k dalam AMM v4) atau tabel pencarian (Stable). Keduanya menerapkan 0,25% yang sama ke jumlah input.
  • Tidak ada reward: Pool Stable tidak mendukung emisi reward on-pool. Farm ekosistem (Farm v3/v5/v6) menangani staking di tempat lain.

Langkah berikutnya

Sumber:
  • raydium-stable/program/src/state.rs (struct Fees)
  • Kolom on-chain AmmInfo.fees di pool mainnet langsung