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 →
Raydium telah berjalan selama lima tahun. Beberapa programnya sudah generasi ketiga atau keempat. Halaman ini memberikan pandangan operasional: “program versi mana yang harus saya gunakan, apa status yang lebih lama, dan bagaimana cara pindah dari A ke B jika saya menjalankan versi lama saat ini?”

​
Status sekilas

ProgramSaat IniSudah UsangPenerapan BaruInstans yang Ada
AMM v4v4 (satu generasi)TidakTidak disarankan tetapi diterimaBeroperasi penuh
CPMMv1—Rekomendasi defaultBeroperasi penuh
CLMMv1—Direkomendasikan untuk LP dengan jangkauanBeroperasi penuh
Farmv6v3, v5Hanya v6v3 + v5 dalam tahap penutupan (sebagian besar baca-saja)
LaunchLabv1—Direkomendasikan untuk peluncuran baruBeroperasi penuh
Pengambilan alih yang paling penting dari tabel ini: AMM v4 tidak sudah usang, dan CPMM adalah default baru — tetapi mereka ada berdampingan dengan sengaja. Pool AMM v4 memiliki tahun sejarah perdagangan dan tidak dipaksa untuk bermigrasi. Pilihan program mana untuk meluncurkan pool baru adalah rekomendasi, bukan kendala.

​
AMM v4 — status dan trajektori

AMM v4 adalah desain pool asli Raydium: penetapan harga produk-konstan (x · y = k). Diluncurkan sebagai AMM hibrida dengan integrasi orderbook OpenBook (dulunya Serum) yang mencerminkan sebagian kurva sebagai pesanan batas di pasar terikat. Integrasi OpenBook telah dinonaktifkan sejak saat itu — pool tidak lagi berbagi likuiditas ke OpenBook dan semua swap dieksekusi murni melawan kurva melalui entrypoint swap V2. AMM v4 saat ini, dalam praktiknya, adalah AMM produk-konstan murni dengan akun OpenBook dipertahankan sebagai state inert.

​
Apa yang dibekukan

  • Tidak ada tingkat biaya baru. Struktur biaya AMM v4 per-pool dan diatur saat penerapan. Pool baru menerima tingkat biaya perdagangan yang sama (~0,25%), ~12% untuk protokol.
  • Tidak ada pekerjaan fitur baru. Tim belum menambahkan instruksi baru ke AMM v4 sejak CPMM menjadi default baru. Program ini dalam mode pemeliharaan — hanya perbaikan bug, tidak ada perluasan cakupan.
  • Tidak ada dukungan Token-2022. AMM v4 ditulis sebelum Token-2022 ada dan integrasi tidak pernah diperbarui. Mint Token-2022 harus menggunakan CPMM (atau CLMM, jika sesuai).
  • Integrasi OpenBook dinonaktifkan. Setiap pool AMM v4 masih terikat ke akun pasar OpenBook yang sesuai di chain, tetapi pool tidak lagi mengirim atau mempertahankan pesanan di pasar itu. Pemadaman OpenBook tidak lagi memengaruhi swap AMM v4.

​
Apa yang masih berfungsi

  • Pool yang ada melakukan perdagangan secara normal. Tidak ada migrasi state yang dipaksa; pool v4 yang dibuat pada 2021 masih merupakan venue aktif untuk banyak pasangan volume tinggi pada 2026.
  • LP dapat menyetorkan, menarik, dan memanen reward farm seperti biasa. Migrasi ke CPMM bersifat opt-in.
  • Aggregator masih merutingnya. Jupiter dan API Trade Raydium keduanya mengindeks pool v4 sebagai venue tingkat pertama.

​
Kapan harus menggunakan AMM v4

Jujur saja: jarang. Kasus di mana v4 adalah jawaban yang lebih baik sangat terbatas:
  • Pasangan sudah memiliki pool v4 yang dalam dan diperdagangkan dengan baik dan Anda ingin menambah likuiditas ke kedalaman yang ada daripada memisahkan pasar.
(Perutean terintegrasi OpenBook tidak lagi menjadi alasan untuk memilih AMM v4 — integrasi itu mati.) Dalam setiap kasus lain, luncurkan pool baru di CPMM. Lihat user-flows/choosing-a-pool-type untuk pohon keputusan lengkap.

​
CPMM — kurva adopsi dan migrasi v4 → CPMM

CPMM (constant-product market maker, nama internal raydium-cp-swap) disebarkan pada 2024 sebagai penulisan ruang bersih yang dimaksudkan menjadi default pool produk-konstan baru. Strukturnya paling sederhana dari program Raydium: x · y = k murni, tidak ada orderbook, dukungan Token-2022 asli, jejak transaksi lebih kecil.

​
Apa yang CPMM dapat atas AMM v4

  • Ekonomi LP lebih baik secara default. AmmConfig default CPMM merutekan 100% dari biaya perdagangan ke LP (dengan biaya protokol dapat diaktifkan per-tier). AMM v4 mengkode ~12% untuk protokol.
  • Biaya pembuatan pool lebih rendah. Tidak perlu pasar OpenBook. Pembuatan adalah satu transaksi, ~0,15 SOL sewa vs ~0,6 SOL untuk v4.
  • Token-2022. Mint biaya transfer, mint transfer-hook (dengan peringatan), transfer rahasia — semua didukung di CPMM, tidak ada di v4.
  • Permukaan integrator lebih bersih. CPMM memiliki crate yang diterbitkan ramah-Anchor-CPI (raydium-cp-swap), daftar akun lebih sederhana, dan IDL stabil. AMM v4 mengirimkan IDL tetapi tidak pernah memiliki crate CPI Rust yang dirawat.
  • Daftar akun lebih kecil per swap. ~10 akun vs ~17 untuk v4 (yang membawa akun pasar OpenBook bahkan ketika tidak mengenainya).

​
Kapan migrasi layak

Untuk pool yang secara aktif diperdagangkan, peningkatan biaya LP saja biasanya membenarkan migrasi dalam beberapa bulan. Aritmatikanya: pool yang menghasilkan 0,25% × $X volume harian memberikan 0,03% untuk protokol pada v4 (12% yang hilang). Pada CPMM itu kembali ke LP. Selama setahun, itu bertambah dengan bermakna. Untuk pool volume rendah, migrasi lebih tentang memproof masa depan — default yang lebih baik, dukungan Token-2022 jika Anda membutuhkannya, integrasi yang lebih mudah.

​
Bagaimana migrasi bekerja

Tidak ada peningkatan di tempat. Migrasi adalah urutan buat-pool-baru, keringkan-pool-lama, isi-ulang-pool-baru. Langkah demi langkah lengkapnya ada di user-flows/migrate-amm-v4-to-cpmm; bentuk tingkat tinggi:
  1. Buat pool CPMM baru untuk pasangan yang sama, pada tingkat biaya yang sama yang ingin Anda pertahankan.
  2. Koordinasikan LP: umumkan jendela di mana pool lama dikosongkan dan pool baru ditanam.
  3. Setiap LP menarik dari pool v4 dan menyetor ke pool CPMM baru.
  4. (Opsional) Atur farm di sisi CPMM untuk menarik LP yang diberi insentif ke pool baru.
  5. Tonton volume bermigrasi karena aggregator menimbang ulang ke arah pool yang lebih dalam.
Chain sendiri tidak memberlakukan salah satunya — API Raydium dan frontend cukup menyukai pool mana pun yang lebih dalam, dan aggregator merutekan melalui mana pun yang paling murah untuk pengguna.

​
CLMM — program tunggal, stabil di seluruh versi

CLMM ada di versi program pertamanya. Tidak ada v2 — perbaikan telah dikirimkan sebagai peningkatan di tempat ke ID program yang sama (di belakang multisig terkunci 24j), bukan sebagai generasi baru. Itu berarti ada tidak ada cerita migrasi CLMM: posisi yang ada tetap berada di mana mereka berada, dan perilaku program mungkin berubah secara halus ketika peningkatan dikirimkan, tetapi tata letak akun dan PDA stabil. Apa yang telah berubah di seluruh peningkatan CLMM:
  • Instruksi SwapV2 ditambahkan untuk mendukung matematika biaya transfer Token-2022 dengan benar. Swap lama masih dapat dipanggil; integrasi baru harus menargetkan SwapV2.
  • Ekstensi aliran reward — jumlah slot RewardInfo dinaikkan (3 asli → masih 3 saat ini, tetapi pola reservasi diperketat). Tidak ada migrasi data yang diperlukan.
  • Kompresi tick-array — optimasi internal untuk mengurangi CU pada swap-crossing-many-ticks. Tidak terlihat secara eksternal.
IDL hidup di repositori raydium-idl yang didedikasikan (lihat sdk-api/anchor-idl). Jika Anda menjalankan SDK yang lebih lama terhadap program saat ini, kasus terburuk adalah kehilangan instruksi baru.

​
Farm v3 → v5 → v6

Dari semua program Raydium, Farm memiliki riwayat versi paling eksplisit dan satu-satunya jalur migrasi paksa. Tiga generasi adalah program terpisah dengan ID program terpisah dan tata letak state terpisah.

​
Generasi

VersiDirilisStatusFitur Kunci
v32021Tahap penutupan. Farm yang ada berjalan; tidak ada farm baru diterima.Aliran reward tunggal. Emisi berbasis slot.
v5Okt 2022Tahap penutupan. Farm yang ada berjalan; tidak ada farm baru diterima.Hingga 2 aliran reward. Emisi berbasis slot. Integer per_second.
v62024Saat Ini. Semua farm baru.Hingga 5 aliran reward. Emisi jam dinding. Q64.64 fixed-point per_second. Staking Token-2022 + dukungan reward.

​
Mengapa tiga generasi ada

  • v3 → v5: diperlukan beberapa aliran reward bersamaan (misalnya, farm dual-insentif). Desain single-stream v3 tidak dapat mendukungnya tanpa redesain.
  • v5 → v6: tingkat emisi integer u64 v5 membatasi laju minimum yang dapat diekspresikan menjadi “1 unit token per detik.” Untuk mint 9-desimal, itu 1 lamport/detik — jauh terlalu kasar untuk program emisi rendah. Tingkat fraksional Q64.64 v6 memperbaiki ini. v6 juga mengangkat pembaruan berbasis slot ke jam dinding, dan menambahkan dukungan Token-2022.

​
Apa yang tetap sama di seluruh generasi

  • Pola akuntansi “setorkan LP, akumulasi penghitung per-share, klaim pada penarikan” identik di seluruh v3/v5/v6. Matematikanya tidak berubah; hanya presisi penghitung laju dan jumlah aliran yang didukung.
  • UserStake (v3/v5) dan UserLedger (v6) secara konseptual adalah catatan yang sama, dengan tata letak berbeda. SDK menormalisasi keduanya.

​
Jalur migrasi

Tidak ada migrasi di tempat antara versi farm. Untuk pindah dari v3/v5 ke v6:
  1. Tunggu emisi farm yang ada berakhir (atau jalankan ke bawah).
  2. Staker menarik dan mengklaim reward tertunda di farm lama.
  3. Operator farm membuat farm v6 baru terhadap mint staking yang sama.
  4. Staker mengingat ke farm baru.
Realitas on-chain adalah dua akun farm yang tidak terkait. Pengguna dengan stake di keduanya memiliki dua UserLedger (v6) / UserStake (v5) catatan.

​
Apa arti “tahap penutupan” untuk v3 dan v5

  • Program v3 dan v5 masih disebarkan dan dapat dipanggil. Farm yang ada masih dapat mendistribusikan reward tertunda dan menerima penarikan.
  • UI Raydium masih menampilkan farm v3 dan v5 dengan reward aktif; setelah end_time farm v3/v5 berlalu, UI menyembunyikannya dari “aktif” tetapi tetap dapat diklaim.
  • Tim tidak akan membuat farm v3/v5 baru. Pembantu SDK untuk “buat farm” merutekan hanya ke v6.
  • v3 dan v5 menerima peningkatan keamanan tetapi bukan pekerjaan fitur. Jika bug kritis ditemukan, itu diperbaiki; jika fitur bisa berguna, itu ditambahkan ke v6 sebagai gantinya.
Detail lengkap per versi ada di products/farm-staking/accounts dan products/farm-staking/instructions.

​
LaunchLab — program tunggal, config yang berkembang

LaunchLab ada di versi program pertamanya. Seperti CLMM, perbaikan dikirimkan sebagai peningkatan di tempat di belakang timelock 24j — bukan sebagai generasi baru. Apa yang telah berkembang melalui peningkatan:
  • Slot biaya kreator. Ditambahkan sehingga peluncuran dapat merutekan sebagian dari biaya perdagangan CPMM pasca-kelulusan ke kreator asli. Lihat products/launchlab/creator-fees.
  • Kemampuan konfigurasi formula kurva. Awalnya hardcoded kuadratik; sekarang LaunchConfig memilih dari set kecil bentuk kurva.
Peluncuran LaunchLab yang ada tidak dipengaruhi oleh peningkatan — setelah peluncuran diinisialisasi, parameternya dibekukan sampai kelulusan.

​
Kompatibilitas versi lintas program

Beberapa catatan kompatibilitas lintas produk yang secara rutin ditemui integrator:
  • CLMM SwapV2 tidak sama dengan instruksi Swap. Jika klien Anda berbicara hanya Swap, itu akan secara diam-diam menyalahani biaya transfer Token-2022 — matematikanya salah dengan jumlah biaya. Perbarui ke SwapV2.
  • Staking Farm v6 dengan posisi CLMM tidak didukung dengan cara LP-token staking. Posisi CLMM adalah NFT, bukan token LP yang dapat dipertukarkan. CLMM memiliki mekanisme reward asli sendiri sebagai gantinya — lihat products/clmm/fees.
  • Pool CPMM didukung oleh mint Token-2022 bekerja di farm hanya pada Farm v6. v3 dan v5 menolak mint staking Token-2022.
  • Pool AMM v4 tidak pernah memiliki mint LP Token-2022. Jika Anda melihatnya, itu palsu — AMM v4 tidak mendukung kombinasi itu.

​
Di mana membaca lebih lanjut

Sumber:
  • Halaman bab per produk yang dikutip di atas.
  • Raydium SDK v2 — logika pengiriman yang mengetahui versi mengonfirmasi program mana yang dimiliki pool tertentu.
  • reference/program-addresses — ID kanonik per versi.