Fehlercodes - Raydium Docs

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →

Maßgebliche Quelle. Die Tabellen unten werden aus der error.rs jedes Programms in den öffentlichen Raydium-Repositories regeneriert. Wenn ein Programm aktualisiert wird und eine neue Variante hinzugefügt wird, führen Sie die Extraktion erneut aus (Link am Ende jeder Tabelle) und hängen Sie die Tabelle an, anstatt sie umzuordnen – Anchor-Fehlercodes werden nach Quellreihenfolge zugewiesen, nicht nach Name, daher bricht eine Umordnung die Fehlerbehandlung von Integratoren.

Wie Anchor-Fehlercodes funktionieren

Anchor weist jeder Variante eines Programms ErrorCode-Enums einen numerischen Code ab 6000 zu. Eine fehlgeschlagene Transaktion zeigt:

Numerischer Fehlercode (z. B. 0x1771 = 6001) in den Transaktionsprotokollen.
Fehlername (z. B. InvalidOwner) aus der IDL.
#[msg(...)]-String, den Anchor in log_messages ausgegeben hat.

Integratoren sollten auf dem numerischen Code abgleichen, nicht auf der Nachrichtenzeichenkette (die Zeichenkette kann umformuliert werden, ohne eine Version zu erhöhen).

// Beispiel: Erkennen Sie den CPMM-Slippage-Fehler und zeigen Sie eine saubere UX-Nachricht an.
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("Price moved past your slippage tolerance. Increase slippage or retry.");
    return;
  }
  throw err;
}

CPMM (Standard AMM) Fehler

Programm-ID: siehe reference/program-addresses. Quelle: raydium-cp-swap/programs/cp-swap/src/error.rs.

Code	Variante	`#[msg]`-String	Typische Ursache	Empfohlene UX
6000	`NotApproved`	Not approved	Der Aufrufer ist nicht die konfigurierte Autorität für eine Admin-Anweisung.	„Nur der Pool-Admin kann diese Aktion ausführen.”
6001	`InvalidOwner`	Input account owner is not the program address	Ein übergebenes Konto gehört dem falschen Programm (oft ein falsches Token-Programm oder eine falsche Programm-PDA).	„Intern: Kontoinhaber-Nichtübereinstimmung – aktualisieren und erneut versuchen.”
6002	`EmptySupply`	Input token account empty	LP- oder Token-Kontoguthaben ist null bei einem Schritt, der einen positiven Betrag erfordert.	„Nichts zum Abheben.”
6003	`InvalidInput`	InvalidInput	Generisches schlechtes Argument (Betrag außerhalb des Bereichs, falsches Flag).	„Ungültige Eingabe – überprüfen Sie die Beträge und versuchen Sie es erneut.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	Das übergebene LP-Mint-Konto stimmt nicht mit `pool_state.lp_mint` überein.	„Intern: falsches LP-Mint – Pool-Daten aktualisieren.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	Der ausgeführte Preis ist schlechter als der `minAmountOut` / `maxAmountIn` des Benutzers.	„Der Preis hat Ihre Slippage-Toleranz überschritten. Erhöhen Sie den Slippage oder versuchen Sie es erneut.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	Einzahlungs-/Auszahlungsmathematik rundete eine Seite auf null (Position zu klein).	„Der Betrag liegt unter dem Minimum für diesen Pool.”
6007	`NotSupportMint`	Not support token_2022 mint extension	Der Pool ist auf eine Token-2022-Erweiterung gestoßen, die er nicht sicher verarbeiten kann (z. B. `TransferHook`, `DefaultAccountState=Frozen`).	„Dieses Token hat eine Erweiterung, die Raydium in CPMM nicht unterstützt.”
6008	`InvalidVault`	invaild vault	Das übergebene Vault-Konto stimmt nicht mit dem in `pool_state` aufgezeichneten überein.	„Intern: falscher Vault – aktualisieren und erneut versuchen.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	Bei der Pool-Initialisierung liegt die berechnete LP-Versorgung unter dem permanent gesperrten Betrag.	„Anfängliche Liquidität zu klein. Erhöhen Sie die Einzahlung.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Der beobachtete Post-Transfer-Betrag für ein Token-2022-Fee-Mint stimmte nicht mit der Vorberechnung überein.	„Token-Transfergebühr hat sich während der Transaktion geändert. Erneut versuchen.”
6011	`MathOverflow`	Math overflow	Eine Zwischenswap-/Einzahlungs-/Gebührenberechnung ist übergelaufen.	„Der Betrag ist zu groß für diesen Pool.”
6012	`InsufficientVault`	Insufficient vault	Das Pool-Vault-Guthaben ist zu niedrig, um die angeforderte Ausgabe zu decken.	„Nicht genug Liquidität im Pool für diese Größe.”
6013	`InvalidFeeModel`	Invalid fee model	Admin hat eine `AmmConfig`-Parameterkombination festgelegt, die On-Chain abgelehnt wird.	N/A – nur Admin-Pfad.
6014	`NoFeeCollect`	Fee is zero	Eine Protokoll-, Fonds- oder Creator-Fee-Sammelanweisung hat keine einzuziehenden Gebühren gefunden. Für `CollectCreatorFeePermissionless` waren beide Creator-Zähler null.	„Nichts zum Einziehen.” Behandeln Sie es als gutartiges Rennen und stoppen Sie.

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

CLMM Fehler

Programm-ID: siehe reference/program-addresses. Quelle: raydium-clmm/programs/amm/src/error.rs.

Code	Variante	`#[msg]`-String	Typische Ursache	Empfohlene UX
6000	`NotApproved`	Not approved	Der Aufrufer ist nicht der konfigurierte Admin für diese Anweisung; oder (Berechtigungsanweisungen) der Unterzeichner ist weder `admin` noch `permission_pda_admin`; oder (`OpenLimitOrder`) das Eingabe-/Ausgabe-Token-Konto ist gefroren oder der Pool hat Swap/Limit-Order deaktiviert; oder (`ClosePosition`, gefrorener Pfad) das bereitgestellte verbleibende Konto ist nicht `personal_position.pool_id`.	„Nur der Pool-Admin kann diese Aktion ausführen.” / „Dieses Token-Konto ist gefroren – tauen Sie es auf, bevor Sie die Bestellung aufgeben.” / „Intern: falsches Position-Pool-Konto.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	Admin hat einen nicht erkannten `param`-Wert an `update_amm_config` übergeben.	N/A – nur Admin-Pfad.
6002	`AccountLack`	Account lack	Erforderliches verbleibendes Konto fehlt in der Tx (typischerweise Tick-Array oder Oracle-Erweiterung); oder `ClosePosition` schließt eine gefrorene NFT ohne den Pool als erstes verbleibendes Konto.	„Intern: fehlendes Konto – Pool-Daten aktualisieren oder Position-Close-Builder aktualisieren.”
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	Versuch, eine Position zu schließen, die noch Liquidität, nicht eingezogene Gebühren oder nicht eingezogene Belohnungen hat.	„Ziehen Sie alle Liquidität ab und fordern Sie Gebühren/Belohnungen ein, bevor Sie die Position schließen.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` oder `tick_upper` liegt außerhalb von `[-443636, 443636]`.	„Preisbereich außerhalb der Grenzen für diesen Pool.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	„Der niedrigere Preis muss unter dem höheren Preis liegen.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Unterlauf des unteren Ticks.	„Unterer Preis zu niedrig.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Überlauf des oberen Ticks.	„Oberer Preis zu hoch.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	Der eingereichte Tick ist kein Vielfaches des `tick_spacing` des Pools.	„Preis auf das nächste gültige Inkrement ausrichten.”
6009	`InvalidTickArray`	Invalid tick array account	Falsche PDA für einen Tick-Array-Slot übergeben.	„Intern: falsches Tick-Array – Pool-Daten aktualisieren.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Off-by-One bei der Tick-Array-Indizierung.	„Intern: Tick-Array-Grenzfehler.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	Vom Aufrufer bereitgestelltes `sqrt_price_limit` außerhalb des gültigen Bereichs.	„Preislimit außerhalb des Bereichs.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	Der aktuelle Quadratwurzelpreis des Pools ist während des Swaps aus dem Bereich geraten.	„Swap erneut versuchen.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Interne Invariantenverletzung bei Liquiditätsabnahme.	„Intern: Liquiditätsabrechnungsfehler.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Interne Invariantenverletzung bei Liquiditätszunahme.	„Intern: Liquiditätsabrechnungsfehler.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Aufruf zur Liquiditätszunahme mit beiden `amount_0_max` und `amount_1_max` null.	„Geben Sie mindestens ein Token an.”
6016	`LiquidityInsufficient`	Liquidity insufficient	Die Position hat nicht genug Liquidität, um die Auszahlung zu erfüllen.	„Auszahlungsbetrag übersteigt die Position-Liquidität.”
6017	`PriceSlippageCheck`	Price slippage check	Der Ausführungspreis hat die Slippage-Schutzmaßnahme des Aufrufers nicht erfüllt.	„Der Preis hat Ihre Slippage-Toleranz überschritten. Erhöhen Sie den Slippage oder versuchen Sie es erneut.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: Ausgabebetrag unter `other_amount_threshold`.	„Slippage überschritten – Mindestausgabe nicht erreicht.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: Eingabebetrag über `other_amount_threshold`.	„Slippage überschritten – maximale Eingabe überschritten.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Null `amount` bei einer Swap-Anweisung.	„Geben Sie einen Betrag größer als null ein.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	Das Eingabe-Vault-Konto des Swaps stimmt nicht mit dem aufgezeichneten Vault des Pools überein.	„Intern: falscher Eingabe-Vault – Pool-Daten aktualisieren.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	Swap-Mathematik rundete auf null, typischerweise sehr kleine Staubmengen.	„Betrag zu klein zum Swappen in diesem Pool.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	Nicht genug Tick-Array-Restkonten für den Swap-Bereich bereitgestellt.	„Intern: unzureichende Tick-Arrays – Pool-Daten aktualisieren.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	Das erste übergebene Tick-Array-Konto deckt den aktuellen Tick nicht ab.	„Intern: falsches erstes Tick-Array – Pool-Daten aktualisieren.”
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` außerhalb von `[0, 2]`.	N/A – Admin-Pfad.
6026	`FullRewardInfo`	The init reward token reach to the max	Der Pool hat bereits das Maximum (3) Reward-Mints konfiguriert.	N/A – Admin-Pfad.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	Reward-Mint dupliziert einen vorhandenen.	N/A – Admin-Pfad.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	Vor Slot 2 muss das Reward-Mint einem der Pool-Vault-Mints entsprechen.	N/A – Admin-Pfad.
6029	`InvalidRewardInitParam`	Invalid reward init param	Schlechte Emissionsstart-/Endzeit oder Pro-Sekunde-Rate.	N/A – Admin-Pfad.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Falsche Anzahl von Restkonten, die an `CollectReward` übergeben wurden.	„Intern: falsche Kontoanzahl – aktualisieren und erneut versuchen.”
6031	`InvalidRewardPeriod`	Invalid reward period	Reward-Emissionsperiode ungültig (`end <= start`, null Dauer).	N/A – Admin-Pfad.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	Admin versuchte, Emissionen außerhalb des 72-Stunden-Fensters um Zyklus-Grenzen zu ändern.	N/A – Admin-Pfad.
6033	`UnInitializedRewardInfo`	uninitialized reward info	Reward-Slot nicht initialisiert, aber referenziert.	N/A – Admin-Pfad.
6034	`NotSupportMint`	Not support token_2022 mint extension	CLMM ist auf eine Token-2022-Erweiterung gestoßen, die es nicht verarbeiten kann.	„Dieses Token hat eine Erweiterung, die Raydium CLMM nicht unterstützt.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	Swap überschritt einen Tick-Bereich, der nicht von der Basis-Bitmap abgedeckt wird; Erweiterungs-Bitmap-Konto erforderlich.	„Intern: fehlende Tick-Array-Erweiterung – Pool-Daten aktualisieren.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	Es gibt nicht genug Liquidität in der Swap-Richtung.	„Unzureichende Liquidität für diese Swap-Größe.”
6037	`MaxTokenOverflow`	Max token overflow	Eingabe-/Ausgabebetrag überschritt u64.	„Der Betrag ist zu groß für diesen Pool.”
6038	`CalculateOverflow`	Calculate overflow	Gebühren-/Liquiditätsarithmetik-Überlauf.	„Der Betrag ist zu groß für diesen Pool.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Token-2022-Transfergebühr beobachteter Betrag stimmte nicht mit erwartet überein.	„Token-Transfergebühr hat sich während der Transaktion geändert. Erneut versuchen.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` aufgerufen für eine Bestellung, deren ungefüllter Teil null ist.	„Diese Limit-Bestellung ist bereits gefüllt – begleichen Sie, um die Ausgabe zu erhalten.”
6041	`InvalidOrderPhase`	Invalid order phase	Mutation einer Bestellung, deren FIFO-Kohorten-Phase nicht mehr mit der aktuellen Kohorten-Phase des Ticks übereinstimmt.	„Diese Aktion kann im aktuellen Zustand der Bestellung nicht ausgeführt werden.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Bestellungseingabe unter dem Pool-Minimum (oder null) bei Öffnung/Erhöhung/Verringerung.	„Bestellungsgröße liegt unter dem Pool-Minimum.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	Der `order_phase`-Zähler der Kohorte auf dem Tick ist gesättigt; weitere Bestellungen können nicht bei diesem Tick geöffnet werden, bis vorhandene Kohorten abgewickelt und überrollt werden.	„Zu viele aktive Bestellungen bei diesem Preis; versuchen Sie einen nahe gelegenen Tick oder warten Sie, bis Bestellungen abgewickelt werden.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` abgelehnt; oder `CreateCustomizablePool` aktivierte dynamische Gebühren ohne gültige Konfiguration.	N/A bei Admin-Pfad; „Dynamische Gebührenkonfiguration ungültig” bei Benutzer-Pfad.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	`CreateCustomizablePool` übergab einen `collect_fee_on`-Wert außerhalb von `{0, 1, 2}`.	„Intern: ungültiger Gebührenmodus.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	`CreateCustomizablePool` (oder ein anderer Pfad, der einen anpassbaren anfänglichen Quadratwurzelpreis akzeptiert) wurde mit `sqrt_price_x64 == 0` aufgerufen.	„Der anfängliche Preis muss größer als null sein.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Ein Liquiditätsbereitstellungs-Pfad wurde mit `liquidity == 0` und keinem kompensierenden Betrag aufgerufen.	„Der Liquiditätsbetrag muss größer als null sein.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	Ein Open-Position-by-Amount-Pfad berechnete `liquidity == 0` und der Aufrufer lieferte kein `base_flag`, um zu klären, welche Seite die Basis ist.	„Geben Sie entweder eine Liquidität ungleich null an oder geben Sie an, welches Token die Basis ist.”
6049	`MissingMintAccount`	Mint account is required but not provided	Ein Token-2022-bewusster Pfad wurde ohne das Eingabe-/Ausgabe-Mint-Konto aufgerufen, das zur Validierung von Erweiterungen und Transfergebühren erforderlich ist.	„Intern: fehlendes Mint-Konto – Pool-Daten aktualisieren.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	Dasselbe wie oben für das SPL-Token-2022-Programmkonto.	„Intern: fehlendes Token-2022-Programm – aktualisieren und erneut versuchen.”

Hinweis zur Umnummerierung. Das CLMM ErrorCode-Enum wurde in dieser Version umnummeriert: fünf Legacy-Varianten (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) und mehrere Tippfehler (Liquitity, enought, emissiones) wurden entfernt/behoben, und elf neue Varianten wurden angehängt. Da Anchor Fehler nach Quellreihenfolge nummeriert, hat sich jeder Code bei oder nach 6000 relativ zu Pre-Release-Builds verschoben. Clients, die numerische Codes gegen eine frühere Version hartcodiert haben, müssen neu zuordnen.

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

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

Diese Programme sind in ihren jeweiligen Kapiteln dokumentiert (siehe products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Da diese Programme eine Mischung aus Anchor- und Plain-Solana-Fehleroberflächen verwenden, befinden sich ihre Fehlertabellen neben der Anweisungsreferenz statt hier. Die folgenden Codes sind von diesen Kapiteln reserviert:

Programm	Code-Bereich (nur Anchor)	Referenz
AMM v4	Benutzerdefinierte u32-Codes, nicht Anchor-Stil	`products/amm-v4/instructions`
Farm v3 / v5	Benutzerdefinierte u32-Codes	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

Die LaunchLab-Version behält die Codes 6000–6021 unverändert. Sie entfernt die früheren Fehler für den globalen Plattformzugriff und weist 6022 dem neuen Validierungsfehler für das Allow-Konto zu:

Code	Name	Bedeutung
6018	`NotEnoughRemainingAccounts`	Ein erforderliches verbleibendes Konto fehlt. Dies umfasst ein erforderliches `PlatformAllowConfig` und den erweiterten CPMM-Migrationskontosatz.
6022	`InvalidPlatformAllowConfig`	Das bereitgestellte Allow-Konto codiert nicht das erwartete Plattform- und globale Konfigurationspaar.

Die alten Varianten PlatformGlobalAccessDenied (6022) und InvalidPlatformGlobalAccess (6023) werden entfernt. Dekodieren Sie 6022 nicht mit der vorherigen IDL.

Zuordnung von SDK-Fehlern zu Programmfehlern

Das offizielle TypeScript SDK umhüllt On-Chain-Fehler in SendTransactionError und für Anchor-Programme in 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 — inspect err.logs for the "custom program error: 0x..." line.
  }
}

Wenn Sie Anchor nicht auf der Client-Seite verwenden, analysieren Sie die Transaktionsprotokolle:

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

Das Muster Error Number: (\d+) ist über Anchor-Versionen stabil und sicher zum Abgleichen.

Regenerieren dieser Tabellen

Wenn ein Programm aktualisiert wird und einen neuen Fehler hinzufügt, extrahieren Sie erneut aus der Quelle:

# Clone and grep the error enum in order.
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
# Replace 6000+++ with monotonically-increasing 6000,6001,... Append new rows to the table above.

Aktualisieren Sie immer reference/changelog, wenn eine neue Variante hinzugefügt wird, damit Integratoren, die das SDK aktualisieren, ihre Fehlerbehandler aktualisieren. Quellen:

​Wie Anchor-Fehlercodes funktionieren

​CPMM (Standard AMM) Fehler

​CLMM Fehler

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

​Zuordnung von SDK-Fehlern zu Programmfehlern

​Regenerieren dieser Tabellen

Wie Anchor-Fehlercodes funktionieren

CPMM (Standard AMM) Fehler

CLMM Fehler

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

Zuordnung von SDK-Fehlern zu Programmfehlern

Regenerieren dieser Tabellen