Kode kesalahan

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

Sumber kebenaran. Tabel di bawah ini dihasilkan ulang dari error.rs setiap program di repositori publik Raydium. Ketika program diperbarui dan varian baru ditambahkan, jalankan kembali ekstraksi (tautan di bagian bawah setiap tabel) dan tambahkan ke tabel daripada mengatur ulang — kode kesalahan Anchor ditugaskan berdasarkan urutan sumber, bukan nama, jadi mengatur ulang merusak penanganan kesalahan integrator.

Cara kerja kode kesalahan Anchor

Anchor menetapkan setiap varian enum ErrorCode program dengan kode numerik mulai dari 6000. Transaksi yang gagal menampilkan:

Kode kesalahan numerik (misalnya 0x1771 = 6001) dalam log transaksi.
Nama kesalahan (misalnya InvalidOwner) dari IDL.
String #[msg(...)] yang dipancarkan Anchor dalam log_messages.

Integrator harus mencocokkan kode numerik, bukan string pesan (string dapat diubah kata-katanya tanpa menaikkan versi).

// Contoh: deteksi kesalahan slippage CPMM dan tampilkan pesan UX yang bersih.
const CPMM_EXCEEDED_SLIPPAGE = 6005;

try {
  await sdk.cpmm.swap({ ... });
} catch (err: any) {
  const code = err?.error?.errorCode?.number ?? err?.code;
  if (code === CPMM_EXCEEDED_SLIPPAGE) {
    showToast("Harga bergerak melampaui toleransi slippage Anda. Tingkatkan slippage atau coba lagi.");
    return;
  }
  throw err;
}

Kesalahan CPMM (AMM Standar)

ID Program: lihat reference/program-addresses. Sumber: raydium-cp-swap/programs/cp-swap/src/error.rs.

Kode	Varian	String `#[msg]`	Penyebab umum	UX yang disarankan
6000	`NotApproved`	Not approved	Pemanggil bukan otoritas yang dikonfigurasi untuk instruksi admin.	”Hanya admin pool yang dapat melakukan tindakan ini.”
6001	`InvalidOwner`	Input account owner is not the program address	Akun yang diteruskan dimiliki oleh program yang salah (sering kali program token yang salah atau PDA program yang salah).	”Internal: ketidakcocokan pemilik akun — segarkan dan coba lagi.”
6002	`EmptySupply`	Input token account empty	Saldo akun LP atau token adalah nol pada langkah yang memerlukan jumlah positif.	”Tidak ada yang ditarik.”
6003	`InvalidInput`	InvalidInput	Argumen buruk generik (jumlah di luar jangkauan, flag salah).	”Input tidak valid — periksa jumlah dan coba lagi.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	Akun mint LP yang diteruskan tidak cocok dengan `pool_state.lp_mint`.	”Internal: mint LP salah — segarkan data pool.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	Harga yang dieksekusi lebih buruk daripada `minAmountOut` / `maxAmountIn` pengguna.	”Harga bergerak melampaui toleransi slippage Anda. Tingkatkan slippage atau coba lagi.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	Matematika deposit / penarikan membulatkan satu sisi menjadi nol (posisi terlalu kecil).	”Jumlah di bawah minimum untuk pool ini.”
6007	`NotSupportMint`	Not support token_2022 mint extension	Pool menemukan ekstensi Token-2022 yang tidak dapat ditangani dengan aman (misalnya `TransferHook`, `DefaultAccountState=Frozen`).	”Token ini memiliki ekstensi yang tidak didukung Raydium di CPMM.”
6008	`InvalidVault`	invaild vault	Akun vault yang diteruskan tidak cocok dengan yang tercatat dalam `pool_state`.	”Internal: vault salah — segarkan dan coba lagi.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	Saat inisialisasi pool, pasokan LP yang dihitung di bawah jumlah kunci permanen.	”Likuiditas awal terlalu kecil. Tingkatkan deposit.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Jumlah pasca-transfer yang diamati untuk mint fee Token-2022 tidak cocok dengan ekspektasi yang telah dihitung sebelumnya.	”Biaya transfer token berubah di tengah transaksi. Coba lagi.”
6011	`MathOverflow`	Math overflow	Perhitungan swap / deposit / fee perantara meluap.	”Jumlah terlalu besar untuk pool ini.”
6012	`InsufficientVault`	Insufficient vault	Saldo vault pool terlalu rendah untuk menutupi output yang diminta.	”Likuiditas tidak cukup di pool untuk ukuran ini.”
6013	`InvalidFeeModel`	Invalid fee model	Admin menetapkan kombinasi parameter `AmmConfig` yang ditolak on-chain.	N/A — jalur admin-only.
6014	`NoFeeCollect`	Fee is zero	Instruksi pengumpulan biaya protokol, dana, atau kreator tidak menemukan biaya yang dapat dikumpulkan. Untuk `CollectCreatorFeePermissionless`, kedua penghitung kreator adalah nol.	”Tidak ada yang dikumpulkan.” Perlakukan sebagai race yang jinak dan berhenti.

Sumber regenerasi: github.com/raydium-io/raydium-cp-swap — error.rs.

Kesalahan CLMM

ID Program: lihat reference/program-addresses. Sumber: raydium-clmm/programs/amm/src/error.rs.

Kode	Varian	String `#[msg]`	Penyebab umum	UX yang disarankan
6000	`NotApproved`	Not approved	Pemanggil bukan admin yang dikonfigurasi untuk instruksi ini; atau (instruksi izin) penandatangan bukan `admin` maupun `permission_pda_admin`; atau (`OpenLimitOrder`) akun token input/output beku atau pool memiliki swap / limit-order dinonaktifkan; atau (`ClosePosition`, jalur beku) akun sisa yang disediakan bukan `personal_position.pool_id`.	”Hanya admin pool yang dapat melakukan tindakan ini.” / “Akun token ini beku — cairkan sebelum menempatkan pesanan.” / “Internal: akun pool posisi salah.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	Admin melewatkan nilai `param` yang tidak dikenali ke `update_amm_config`.	N/A — jalur admin-only.
6002	`AccountLack`	Account lack	Akun sisa yang diperlukan hilang dari tx (biasanya tick-array atau ekstensi oracle); atau `ClosePosition` menutup NFT beku tanpa pool sebagai akun sisanya yang pertama.	”Internal: akun hilang — segarkan data pool atau perbarui pembangun penutupan posisi.”
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	Mencoba menutup posisi yang masih memiliki likuiditas, biaya yang tidak dikumpulkan, atau hadiah yang tidak dikumpulkan.	”Tarik semua likuiditas dan klaim biaya/hadiah sebelum menutup posisi.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` atau `tick_upper` berada di luar `[-443636, 443636]`.	”Rentang harga di luar batas untuk pool ini.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	”Harga lebih rendah harus di bawah harga lebih tinggi.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Underflow tick lebih rendah.	”Harga lebih rendah terlalu rendah.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Overflow tick lebih tinggi.	”Harga lebih tinggi terlalu tinggi.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	Tick yang dikirimkan bukan kelipatan `tick_spacing` pool.	”Snap harga ke kenaikan yang valid terdekat.”
6009	`InvalidTickArray`	Invalid tick array account	PDA salah diteruskan untuk slot tick-array.	”Internal: tick array salah — segarkan data pool.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Off-by-one dalam pengindeksan tick-array.	”Internal: kesalahan batas tick-array.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` yang disediakan pemanggil di luar jangkauan yang valid.	”Batas harga di luar jangkauan.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	Harga sqrt pool saat ini melayang keluar dari jangkauan di tengah-swap.	”Coba lagi swap.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Pelanggaran invarian internal pada penurunan likuiditas.	”Internal: kesalahan akuntansi likuiditas.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Pelanggaran invarian internal pada peningkatan likuiditas.	”Internal: kesalahan akuntansi likuiditas.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Panggilan peningkatan likuiditas dengan `amount_0_max` dan `amount_1_max` keduanya nol.	”Sediakan setidaknya satu token.”
6016	`LiquidityInsufficient`	Liquidity insufficient	Posisi tidak memiliki likuiditas yang cukup untuk memenuhi penarikan.	”Jumlah penarikan melebihi likuiditas posisi.”
6017	`PriceSlippageCheck`	Price slippage check	Harga eksekusi gagal dalam penjaga slippage pemanggil.	”Harga bergerak melampaui toleransi slippage Anda. Tingkatkan slippage atau coba lagi.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: jumlah keluar di bawah `other_amount_threshold`.	”Slippage terlampaui — output minimum tidak terpenuhi.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: jumlah masuk di atas `other_amount_threshold`.	”Slippage terlampaui — input maksimum terlampaui.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Nol `amount` pada instruksi swap.	”Masukkan jumlah lebih besar dari nol.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	Akun input-vault swap tidak cocok dengan vault yang tercatat pool.	”Internal: input vault salah — segarkan data pool.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	Matematika swap dibulatkan menjadi nol, biasanya debu yang sangat kecil.	”Jumlah terlalu kecil untuk ditukar di pool ini.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	Akun sisa tick-array tidak cukup disediakan untuk rentang swap.	”Internal: tick-array tidak cukup — segarkan data pool.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	Akun tick-array pertama yang diteruskan tidak mencakup tick saat ini.	”Internal: tick array pertama salah — segarkan data pool.”
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` di luar `[0, 2]`.	N/A — jalur admin.
6026	`FullRewardInfo`	The init reward token reach to the max	Pool sudah memiliki max (3) mint hadiah yang dikonfigurasi.	N/A — jalur admin.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	Mint hadiah menduplikasi yang sudah ada.	N/A — jalur admin.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	Pra-slot 2, mint hadiah harus sama dengan salah satu mint vault pool.	N/A — jalur admin.
6029	`InvalidRewardInitParam`	Invalid reward init param	Waktu mulai/akhir emisi atau tingkat per-detik yang buruk.	N/A — jalur admin.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Jumlah akun sisa yang salah diteruskan ke `CollectReward`.	”Internal: jumlah akun salah — segarkan dan coba lagi.”
6031	`InvalidRewardPeriod`	Invalid reward period	Periode emisi hadiah tidak valid (`end <= start`, durasi nol).	N/A — jalur admin.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	Admin mencoba memodifikasi emisi di luar jendela 72 jam di sekitar batas siklus.	N/A — jalur admin.
6033	`UnInitializedRewardInfo`	uninitialized reward info	Slot hadiah tidak diinisialisasi tetapi direferensikan.	N/A — jalur admin.
6034	`NotSupportMint`	Not support token_2022 mint extension	CLMM menemukan ekstensi Token-2022 yang tidak dapat ditangani.	”Token ini memiliki ekstensi yang tidak didukung Raydium CLMM.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	Swap melintasi rentang tick yang tidak tercakup oleh bitmap dasar; akun bitmap ekstensi diperlukan.	”Internal: ekstensi tick-array hilang — segarkan data pool.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	Likuiditas tidak cukup ada dalam arah swap.	”Likuiditas tidak cukup untuk ukuran swap ini.”
6037	`MaxTokenOverflow`	Max token overflow	Jumlah input/output melebihi u64.	”Jumlah terlalu besar untuk pool ini.”
6038	`CalculateOverflow`	Calculate overflow	Overflow aritmatika biaya / likuiditas.	”Jumlah terlalu besar untuk pool ini.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Jumlah yang diamati biaya transfer Token-2022 tidak cocok dengan yang diharapkan.	”Biaya transfer token berubah di tengah transaksi. Coba lagi.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` dipanggil pada pesanan yang porsi tidak terisinya adalah nol.	”Pesanan limit ini sudah terisi — selesaikan untuk menerima output.”
6041	`InvalidOrderPhase`	Invalid order phase	Mutasi pesanan yang fase kohort FIFO-nya tidak lagi cocok dengan kohort saat ini tick.	”Tidak dapat melakukan tindakan ini dalam status pesanan saat ini.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Input pesanan di bawah minimum pool (atau nol) pada waktu buka / naik / turun.	”Ukuran pesanan di bawah minimum pool.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	Penghitung `order_phase` kohort pada tick telah jenuh; pesanan lebih lanjut tidak dapat dibuka di tick itu sampai kohort yang ada menyelesaikan dan bergulir.	”Terlalu banyak pesanan aktif pada harga ini; coba tick terdekat atau tunggu pesanan untuk menyelesaikan.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` ditolak; atau `CreateCustomizablePool` mengaktifkan biaya dinamis tanpa konfigurasi yang valid.	N/A pada jalur admin; “Konfigurasi biaya dinamis tidak valid” pada jalur pengguna.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	`CreateCustomizablePool` melewatkan nilai `collect_fee_on` di luar `{0, 1, 2}`.	”Internal: mode biaya tidak valid.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	`CreateCustomizablePool` (atau jalur lain yang menerima harga sqrt awal yang dapat disesuaikan) dipanggil dengan `sqrt_price_x64 == 0`.	”Harga awal harus lebih besar dari nol.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Jalur penyediaan likuiditas dipanggil dengan `liquidity == 0` dan tidak ada jumlah kompensasi.	”Jumlah likuiditas harus lebih besar dari nol.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	Jalur buka-posisi-berdasarkan-jumlah menghitung `liquidity == 0` dan pemanggil tidak menyediakan `base_flag` untuk membedakan sisi mana yang merupakan basis.	”Sediakan likuiditas bukan nol atau tentukan token mana yang merupakan basis.”
6049	`MissingMintAccount`	Mint account is required but not provided	Jalur yang menyadari Token-2022 dipanggil tanpa akun mint input/output yang diperlukan untuk memvalidasi ekstensi dan biaya transfer.	”Internal: akun mint hilang — segarkan data pool.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	Sama seperti di atas untuk akun program SPL-Token-2022.	”Internal: program Token-2022 hilang — segarkan dan coba lagi.”

Catatan tentang penomoran ulang. Enum ErrorCode CLMM dinomori ulang dalam rilis ini: lima varian warisan (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) dan beberapa typo (Liquitity, enought, emissiones) dihapus/diperbaiki, dan sebelas varian baru ditambahkan. Karena Anchor menomori kesalahan berdasarkan urutan sumber, setiap kode pada atau setelah 6000 telah bergeser relatif terhadap build pra-rilis. Klien yang hard-code kode numerik terhadap versi sebelumnya perlu memetakan ulang.

Sumber regenerasi: github.com/raydium-io/raydium-clmm — error.rs.

Kesalahan AMM v4, Farm v3 / v5 / v6, LaunchLab

Program-program ini didokumentasikan dalam bab masing-masing (lihat products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Karena program-program tersebut menggunakan campuran permukaan kesalahan Anchor dan Solana biasa, tabel kesalahan mereka berada di sebelah referensi instruksi daripada di sini. Kode di bawah ini dicadangkan oleh bab-bab tersebut:

Program	Rentang kode (Anchor saja)	Referensi
AMM v4	Kode u32 khusus, bukan gaya Anchor	`products/amm-v4/instructions`
Farm v3 / v5	Kode u32 khusus	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

Rilis LaunchLab menjaga kode 6000–6021 tidak berubah. Ini menghapus kesalahan akses global platform sebelumnya dan menetapkan 6022 ke kesalahan validasi akun izin baru:

Kode	Nama	Arti
6018	`NotEnoughRemainingAccounts`	Akun sisa yang diperlukan hilang. Ini termasuk `PlatformAllowConfig` yang diperlukan dan set akun migrasi CPMM yang diperluas.
6022	`InvalidPlatformAllowConfig`	Akun izin yang disediakan tidak mengkodekan pasangan platform dan konfigurasi global yang diharapkan.

Varian PlatformGlobalAccessDenied (6022) dan InvalidPlatformGlobalAccess (6023) lama dihapus. Jangan dekode 6022 menggunakan IDL sebelumnya.

Memetakan kesalahan SDK ke kesalahan program

SDK TypeScript resmi membungkus kesalahan on-chain ke dalam SendTransactionError dan, untuk program Anchor, AnchorError:

import { AnchorError } from "@coral-xyz/anchor";

try {
  await sdk.cpmm.swap({ ... });
} catch (err) {
  if (err instanceof AnchorError) {
    console.log(err.error.errorCode.number, err.error.errorCode.code, err.error.errorMessage);
    // 6005 ExceededSlippage "Exceeds desired slippage limit"
  } else {
    // Raw SendTransactionError — periksa err.logs untuk baris "custom program error: 0x...".
  }
}

Jika Anda tidak menggunakan klien Anchor, analisis log transaksi:

Program <ProgramID> invoke [1]
Program log: AnchorError caused by account: pool_state. Error Code: ExceededSlippage. Error Number: 6005. Error Message: Exceeds desired slippage limit.

Pola Error Number: (\d+) stabil di seluruh versi Anchor dan aman untuk dicocokkan.

Meregenerasi tabel-tabel ini

Ketika program diperbarui dan menambahkan kesalahan baru, ekstrak ulang dari sumber:

# Clone dan grep enum kesalahan secara berurutan.
git clone --depth=1 https://github.com/raydium-io/raydium-cp-swap
awk '/#\[msg\(/{ gsub(/^[ \t]*#\[msg\("|"\)\][ \t]*/,""); m=$0; getline; gsub(/,/,""); gsub(/^[ \t]+/,""); print "6000+++\t" $0 "\t" m }' \
  raydium-cp-swap/programs/cp-swap/src/error.rs
# Ganti 6000+++ dengan 6000,6001,... yang meningkat secara monoton. Tambahkan baris baru ke tabel di atas.

Selalu perbarui reference/changelog ketika varian baru ditambahkan, sehingga integrator yang meningkatkan SDK tahu untuk menyegarkan penanganan kesalahan mereka. Sumber:

Reference

Resources

Cara kerja kode kesalahan Anchor

Kesalahan CPMM (AMM Standar)

Kesalahan CLMM

Kesalahan AMM v4, Farm v3 / v5 / v6, LaunchLab

Memetakan kesalahan SDK ke kesalahan program

Meregenerasi tabel-tabel ini

​Cara kerja kode kesalahan Anchor

​Kesalahan CPMM (AMM Standar)

​Kesalahan CLMM

​Kesalahan AMM v4, Farm v3 / v5 / v6, LaunchLab

​Memetakan kesalahan SDK ke kesalahan program

​Meregenerasi tabel-tabel ini

Cara kerja kode kesalahan Anchor

Kesalahan CPMM (AMM Standar)

Kesalahan CLMM

Kesalahan AMM v4, Farm v3 / v5 / v6, LaunchLab

Memetakan kesalahan SDK ke kesalahan program

Meregenerasi tabel-tabel ini