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 →
Dua program
| SPL Token | Token-2022 | |
|---|---|---|
| Program ID | TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA | TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb |
| Diluncurkan | 2020 | 2022 |
| Ukuran akun (token account) | 165 B | 165 B + ekstensi (variabel) |
| Ekstensi | Tidak | Ya — 17+ ekstensi resmi |
| Kompatibilitas warisan | Penuh | Opt-in per mint |
solana-program-library.
Mengapa dua program?
SPL Token dibekukan untuk kompatibilitas maju — bytecodenya secara efektif tidak dapat diubah, membuat garis dasar bersih untuk seluruh ekosistem. Seiring berkembangnya kasus penggunaan (stablecoin yang menginginkan biaya transfer, mint institusional yang membutuhkan otoritas pembekuan dengan nuansa, NFT yang membutuhkan pointer metadata), tim Solana memperkenalkan Token-2022 sebagai program terpisah yang dapat diperluas alih-alih memperbarui SPL Token. Ini menjaga integrasi yang sudah ada dan memungkinkan setiap mint untuk memilih tepat ekstensi yang dibutuhkannya. Token-2022 adalah superset ketat dalam fungsionalitas, bukan dalam ruang alamat: kedua program hidup berdampingan, dan mint pada alamat tertentu milik tepat satu dari keduanya.Struktur akun
Akun mint
Mendefinisikan identitas token. SPL Token mint (82 byte):Token account
Menyimpan saldo mint tertentu untuk pemilik tertentu. SPL Token account (165 byte):Ekstensi Token-2022
Ekstensi adalah fitur modular yang dapat dilampirkan ke mint atau akun. Setiap ekstensi adalah record TLV terpisah. Yang utama untuk Raydium:Transfer fee
Mint dapat mengenakan biaya persentase pada setiap transfer. Biaya masuk ke otoritas penarikan yang dikonfigurasi. Didukung oleh Raydium CPMM dan CLMM melaluiSwapV2 — program menghitung biaya saat menghitung nilai tukar, sehingga matematika pool tetap koheren.
Transfer hook
Mint menunjuk ke program yang runtime panggil pada setiap transfer. Program hook dapat menolak transfer atau melakukan efek samping (perbarui status kepatuhan, log, dll.). Raydium CPMM/CLMM memanggil hook melaluiSwapV2 — transaksi mencakup program hook dan akun tambahan apa pun yang dibutuhkannya.
Interest-bearing
Saldo on-chain mengumpulkan bunga pada tingkat yang dikonfigurasi. Hanya tampilan (saldo muncul lebih tinggi seiring waktu) daripada mint aktual; pasokan dasar tidak berubah.Mint close authority
Memungkinkan mint ditutup sekali pasokan mencapai nol.Permanent delegate
Dompet yang ditunjuk dapat mentransfer atau membakar token dari akun apa pun tanpa syarat. Raydium memblokir pembuatan pool untuk mint dengan ekstensi ini — tidak kompatibel dengan invarian bahwa cadangan pool tidak dapat disita.Non-transferable
Token tidak dapat dipindahkan dari akun tempat mereka dimint. Raydium memblokir pembuatan pool — aset yang tidak dapat diperdagangkan tidak bisa menjadi base atau quote dari pool LP.Default account state
Akun token baru untuk mint ini dibekukan secara default dan harus dicairkan oleh otoritas pembekuan. Dapat digunakan tetapi jarang.Confidential transfer
Saldo dan jumlah transfer dienkripsi. Raydium tidak mendukung mint transfer rahasia (matematika pool memerlukan saldo teks biasa).Metadata pointer + token metadata
Menggantikan metadata Metaplex untuk mint Token-2022. Didukung untuk daftar pool Raydium.Group / Member pointer
Mendeklarasikan mint sebagai bagian dari grup (misalnya, koleksi NFT). Informatif; Raydium menggunakannya untuk tampilan. Lihat halaman ekstensi Token-2022 resmi untuk daftar lengkap.Produk Raydium mana yang mendukung apa
| Produk | SPL Token | Token-2022 | Catatan |
|---|---|---|---|
| AMM v4 | Ya | Tidak | Integrasi OpenBook memerlukan SPL Token |
| CPMM | Ya | Ya | Memerlukan SwapV2 untuk pool Token-2022 |
| CLMM | Ya | Ya | Memerlukan SwapV2 untuk pool Token-2022 |
| Farm v6 | Ya | Ya | Didukung untuk mint stake dan reward |
| LaunchLab | Ya | Ya | Pool CPMM yang lulus mewarisi dukungan Token-2022 |
- Diblokir: non-transferable, permanent delegate, confidential transfer, default account state (dalam konfigurasi ditolak).
- Diizinkan dengan caveat (LP harus menerima risiko): transfer fee, transfer hook, freeze authority aktif.
- Sepenuhnya diizinkan: interest-bearing, metadata pointer, group pointer, mint close authority.
getPoolInfoFromRpc mencakup flag ekstensi mint — klien harus memeriksa sebelum LPing.
Standar token account
Associated Token Account (ATA)
Kedua program berbagi konvensi Associated Token Account: PDA yang berasal dari[owner, programId, mint] melalui Associated Token Program (ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL). Hampir setiap akun token pengguna di Solana adalah ATA.
Token account non-ATA
Dompet dapat memiliki beberapa akun token untuk mint tunggal; ATA hanya konvensi. Vault pool, misalnya, bukan ATA — mereka adalah PDA dari program pool, memegang cadangan pool.Mendeteksi program mana yang dimiliki mint
Setiap akun mint memiliki fieldowner yang menunjuk ke SPL Token atau Token-2022:
getPoolInfoFromRpc mengembalikan programId yang sesuai per token sehingga klien dapat membangun ATA yang benar.
Instruksi swap per program
CPMM dan CLMM Raydium masing-masing memiliki dua instruksi swap:| Instruksi | Mint yang didukung |
|---|---|
Swap / SwapBaseInput (warisan) | Hanya SPL Token |
SwapV2 / SwapBaseInputV2 | SPL Token dan Token-2022 |
SwapV2 memerlukan akun tambahan: akun mint untuk kedua sisi, program token untuk setiap sisi (karena mungkin berbeda), dan — untuk mint transfer-hook — program hook dan akun yang diperlukan.
Klien harus selalu menggunakan SwapV2 ketika minimal satu sisi adalah Token-2022; SwapV2 juga berfungsi untuk pool hanya SPL, tetapi Swap warisan lebih murah dalam komputasi.
SDK memilih varian yang benar secara otomatis.
Migrasi proyek SPL Token ke Token-2022
Token-2022 bukan pengganti plug-in pada level mint — mint pada alamat X adalah SPL atau Token-2022, dan itu tetap pada pembuatan. Untuk “migrasi” Anda harus:- Buat mint baru di bawah Token-2022 dengan ekstensi yang Anda inginkan.
- Sediakan mekanisme swap/wrap untuk pemilik mint SPL lama untuk menukar dengan yang baru.
- Perbarui semua pool LP, farm, dan integrasi untuk mereferensikan mint baru.
Contoh yang dikerjakan: membuat mint Token-2022 dengan transfer fee
Pertimbangan keamanan
Sebelum LPing ke atau swap melalui mint Token-2022:- Periksa
freeze_authority. Jika bukan null dan dipegang oleh pihak terpusat, mereka dapat membekukan ATA Anda (dan mungkin vault pool). - Periksa
transfer_hook. Program hook dapat memblokir transfer secara arbitrer — DYOR pada sumber hook. - Periksa
transfer_fee. Hitunglah biaya dalam output swap yang diharapkan. - Periksa
permanent_delegatedannon_transferable. Program Raydium menolak ini, tetapi verifikasi jika membangun integrasi khusus.
security/oracle-and-token-risks untuk kerangka penerimaan risiko lengkap.
Pointer
solana-fundamentals/account-model— model akun umum.reference/token-2022-support— spesifik Token-2022 untuk CPMM dan CLMM.security/oracle-and-token-risks— risiko dari ekstensi mint berbahaya.
- SPL Token docs.
- Token-2022 docs — daftar ekstensi lengkap.
- Associated Token Account.


