TypeScript SDK

​

Installation

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token
# oder
pnpm add @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

​

Initialisierung

import { Raydium } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner      = Keypair.fromSecretKey(/* ... */);

const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",           // "mainnet" | "devnet"
  disableFeatureCheck: true,    // skip the SDK's startup feature-detect API call
  blockhashCommitment: "confirmed",
});

​

Die Modulfassaden

raydium.cpmm       // CPMM-Pools: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // CLMM-Pools: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, limit orders, ...
raydium.liquidity  // AMM v4-Pools: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create,
                   //                restartReward(s), addNewRewardToken(s)
raydium.launchpad  // LaunchLab: createLaunchpad, buyToken, buyTokenExactOut, sellToken,
                   //            claimCreatorFee, curve-rule and platform-config builders, ...
raydium.tradeV2    // Multi-Pool-Routing: Routen-Discovery, compute, Routen-Ausführung
raydium.marketV2   // OpenBook-Market-Erstellung (Legacy)
raydium.utils1216  // Einmalige Helfer für historische Claims
raydium.token      // Token-Liste + Metadaten: load(), getTokenInfo()
raydium.account    // Wallet-Token-Konten, ATA-Suche und -Erstellung
raydium.api        // Der REST-Client (fetchPoolById, getCpmmConfigs, fetchLaunchConfigs, ...)

​

Transaktions-Builder

import { Percent } from "@raydium-io/raydium-sdk-v2";

const { execute, builder, transaction, instructionTypes, signers, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    inputAmount,              // BN — one side, not a pair
    baseIn: true,
    slippage: new Percent(1, 100),   // a Percent, not a number
    txVersion: TxVersion.V0,
  });

• execute — eine Komfortfunktion, die signiert und sendet. Äquivalent zu builder.execute.
• builder — die TxBuilder-Instanz mit allen angesammelten Anweisungen und Unterzeichnern. builder.build() gibt ein TxBuildData zurück, dessen transaction eine einzelne Legacy-Transaction ist; builder.buildV0() gibt ein TxV0BuildData mit einer einzelnen VersionedTransaction zurück. Nur buildMultiTx / buildMultiTxV0 erzeugen ein Array.
• transaction — die gebaute Transaction / VersionedTransaction.
• instructionTypes / signers — die angesammelten Anweisungs-Labels und der Unterzeichner-Satz.
• extInfo — produktspezifische Extras. Beispielsweise gibt cpmm.createPool extInfo.address.{poolId, lpMint, vaultA, vaultB} zurück; launchpad.createLaunchpad gibt extInfo.address zurück (ein LaunchpadPoolInfo plus poolId).

​

Warum asynchrone Builder?

​

CLMM-Modul-Erweiterungen (neueste Version)

• raydium.clmm.createCustomizablePool — Obermenge von createPool, die collectFeeOn und dynamicFeeConfig (den PublicKey des Config-Kontos) akzeptiert. Das Übergeben von dynamicFeeConfig ist es, was dynamische Gebühren aktiviert; es gibt kein separates enableDynamicFee-Flag und kein dynamicFeeConfigId. Klassisches createPool funktioniert weiterhin für Pools mit Standardgebühren.
• raydium.clmm.openLimitOrder — öffnet eine Limit-Order mit einem einzelnen Tick. Nimmt poolInfo, baseIn (Richtung), orderTick, amount und optional tickArrayBitmap, noneIndex, ownerInfo. Verwenden Sie den exportierten Helfer getOrderTick({ baseIn, mintADecimal, mintBDecimal, tickSpacing, price }), um den Tick zu quantisieren.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — passen Sie den ungefüllten Teil einer bestehenden Order an. Beide nehmen { poolInfo, limitOrder, amount }; decreaseLimitOrder fügt ein optionales slippage hinzu. Das Verringern wird bei einer vollständig gefüllten Order mit InvalidOrderPhase zurückgewiesen.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — fegen Sie gefüllte Ausgaben zur ATA des Eigentümers. settleLimitOrder nimmt nur { limitOrder } — kein poolInfo. Entweder der Eigentümer der Order oder der limit_order_admin-Keeper des Programms können sie aufrufen.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — schließen Sie vollständig abgewickelte Orders, um Rent zurückzugewinnen.
• raydium.api.getClmmDynamicConfigs() — REST-Helfer, der den neuen /main/clmm-dynamic-config-Endpunkt trifft. (Es gibt keinen Limit-Order-Config-Helfer und keinen solchen Endpunkt: Limit-Orders werden über den Tick geschlüsselt, nicht über ein Config-Konto pro Pool.)

​

Häufige Fallstricke

​

1. Cluster-Mismatch

​

2. Vergessen, ATAs vorab zu erstellen

​

3. Veraltete poolInfo

​

4. Prioritätsgebühren

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  baseIn,                    // required: which side inputAmount is denominated in
  inputAmount: new BN(...),
  swapResult: ...,           // required: from CurveCalculator.swapBaseInput/Output
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // CU limit
    microLamports: 50_000,   // priority fee per CU
  },
});

​

5. Slippage-Toleranz muss dem Pool-Typ entsprechen

​

6. BN vs. number

​

Versionierungsrichtlinie

• @raydium-io/raydium-sdk-v2 ist das einzige SDK, das Raydium verwaltet. Alle Docs, Demos und Integrationsleitfäden zielen darauf ab.
• Ein älteres v1-Paket (@raydium-io/raydium-sdk) existiert auf npm aus historischen Gründen. Die Wartung endete, nachdem CPMM und LaunchLab ausgeliefert wurden (v1 erhielt niemals Unterstützung für eines davon), und es gab seit 2024 keine v1-Releases mehr. Behandeln Sie v1 als End-of-Life: Verwenden Sie es nicht für neuen Code und migrieren Sie alle verbleibenden v1-Integrationen zu v2.
• SDK v2 ist vor 1.0. Breaking Changes zwischen 0.x Minor-Releases sind möglich; fixieren Sie die Version, die Sie überprüft haben, und überprüfen Sie die GitHub-Release-Notizen beim Upgrade.

​

Upgrade

1. Überprüfen Sie erneut den Rückgabetyp jedes mutierenden Aufrufs — Formänderungen (z. B. extInfo) landen häufig.
2. Regenerieren Sie poolInfo-Abrufsignaturen — ein Feld könnte umbenannt worden sein.
3. Überprüfen Sie Ihre Slippage-Behandlung erneut; das SDK hat sich über Releases hinweg zwischen Auto-Bound- und Opt-In-Bound-Verhalten verschoben.
4. Wenn Sie raydium.tradeV2 (Routing) verwenden, überprüfen Sie die Route-Form erneut — es ist der instabilste Teil der Oberfläche. Beachten Sie, dass die Fassade von trade in tradeV2 umbenannt wurde; der alte Name existiert nicht mehr.

​

Hilfe erhalten

• GitHub Issues — reichen Sie ein bei github.com/raydium-io/raydium-sdk-V2/issues für Bugs und Feature-Anfragen. Das Raydium-Team überwacht aktiv.
• Discord — #dev-support-Kanal bei discord.gg/raydium für synchrone Hilfe.
• Telegram — Developer-Chat verlinkt von raydium.io (vermeiden Sie nicht verifizierte Telegram-Gruppen).

​

Verweise

• sdk-api/rest-api — das HTTP-Komplement zum SDK.
• sdk-api/trade-api — vom Server erstellte Swap-Transaktionen.
• sdk-api/anchor-idl — Regenerieren von Clients direkt aus Programm-IDLs.
• sdk-api/python-integration — Python-Äquivalent über solana-py.
• integration-guides/priority-fee-tuning — Dimensionierung von computeBudgetConfig.

• Raydium SDK v2 Quelle
• Raydium SDK Release Notes.