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 →

Ringkasan satu paragraf

Stable AMM adalah varian dari AMM Raydium yang menggantikan rumus kurva dengan tabel pencarian yang sudah diisi sebelumnya. Daripada menggunakan x·y=k, pool menyimpan larik sparse dari titik (x, y, price) dan menggunakan pencarian biner + interpolasi linear untuk memberikan harga. Desain ini sangat baik untuk pasangan stablecoin dan aset lain dengan hubungan harga yang diketahui: swap antara token yang dipatok 1-ke-1 memiliki slippage mendekati nol. Seperti AMM v4, pool ini terikat pada pasar OpenBook dan mengirimkan limit order di sana. Likuiditas saat ini tipis; sebagian besar integrator mengakses pool Stable melalui program AMM Routing.

Mengapa tabel pencarian daripada xy=k

AMM constant-product mengalami slippage tinggi pada pasangan dengan band harga ketat. Swap USDC-USDT seharusnya hampir tidak ada biaya; pada pool constant-product, k=x·y memaksa pergerakan harga bahkan untuk volume kecil. Tabel pencarian memungkinkan admin pool untuk mengekspresikan hubungan harga sebenarnya:
  • Untuk stablecoin: padatkan tabel di sekitar 1:1 sehingga micro-swap menghasilkan ~0 slippage.
  • Untuk pasangan berjaminan: enkode rasio target dan biarkan grid membentuk permukaan biaya/insentif.
Tabel bersifat statis antara panggilan UpdateModelData (yang dikirim admin saat hubungan berubah), jadi biaya on-chain hanyalah pencarian interpolasi — jauh lebih murah daripada menghitung ulang rumus.

Cara kerjanya: akun model-data

Pool menyimpan akun ModelDataInfolarik 50.000 elemen dari struct DataElement. Setiap elemen menampung:
DataElement {
  x: u64,           // koordinat X tabel
  y: u64,           // koordinat Y tabel
  price: u64,       // harga di (x, y)
}
Hanya valid_data_count elemen pertama yang diisi; sisanya nol. Saat swap, program:
  1. Menghitung rasio dari reserve pool saat ini dan menggunakan pencarian biner untuk menemukan dua elemen tabel mana yang mengurung rasio tersebut.
  2. Interpolasi linear antara dua titik kurung untuk mendapatkan harga quote.
  3. Menerapkan biaya (sama 0,25% seperti AMM v4) dan mengembalikan hasilnya kepada pengguna.
Bidang multiplier pada tabel mempertimbangkan kemungkinan bahwa x dan y disimpan pada skala tereduksi (misalnya, 6 desimal daripada 18). Penemuan harga diskalakan ulang sesuai kebutuhan.

Perbandingan: Stable AMM vs. AMM v4 vs. CPMM

DimensiStable AMMAMM v4CPMM
KurvaTabel pencarian + interpolasiConstant product (xy=k)Constant product
Kasus penggunaan utamaStablecoin, pasangan terpatokPasangan umum, likuiditas dalam legacyPasangan umum, penerapan baru
Ketergantungan OpenBookYaYaTidak
Token-2022TidakTidakYa
Profil slippageMinimal di 1:1Tinggi pada rasio ketatSedang di seluruh rentang
Kurva yang dapat disesuaikan adminYa (UpdateModelData)Tidak (SetParams saja)Tidak
Ukuran tabel~50k elemen × 24 byteN/AN/A
Compute per swap~5k–15k CU (pencarian biner + interpolasi)~150k–200k CU~60k–100k CU
Jumlah akun per swap~17 (AMM + OpenBook)~18 (AMM + OpenBook)~11

Model mental

Pool Stable AMM adalah AMM tabel-pencarian-interpolasi yang vault-nya juga mengandalkan limit order OpenBook, seperti AMM v4. Perbedaan utama adalah kurva penemuan harga tidak hardcoded — ini adalah larik sparse yang dapat diisi dan diperbarui admin. Operasi serupa dengan AMM v4: swap langsung (pengguna ↔ pool), deposit / withdraw (operasi LP), crank (MonitorStep), dan upkeep admin (UpdateModelData, SetParams).

Kapan Stable AMM adalah pilihan yang tepat

  • Anda mengoperasikan stablecoin atau pasangan aset berkorelasi lainnya dan menginginkan penetapan harga yang ketat dan dapat diprediksi.
  • Anda memiliki pengetahuan mendalam tentang hubungan harga pasangan Anda dan ingin mengenkodenya langsung sebagai kurva.
  • Anda sudah memiliki integrasi untuk AMM v4 dan hanya memerlukan varian kurva berbeda.
Untuk pool tujuan umum yang baru tanpa persyaratan korelasi ketat, CPMM adalah default yang lebih sederhana dan lebih likuid.

Selanjutnya

  • Akun — referensi bidang AmmInfo, ModelDataInfo, DataElement.
  • Math — pencarian biner, interpolasi, dan penerapan biaya.
  • InstruksiInitModelData, UpdateModelData, swap dan instruksi LP.
  • Biaya — pembagian 0,25% (identik dengan AMM v4).
  • Demo kode — routing dan integrasi langsung.
Sumber: