TypeScript SDK

​

Kurulum

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

​

Başlatma

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,    // SDK'nın başlangıç özellik-algılama API çağrısını atla
  blockhashCommitment: "confirmed",
});

​

Modül arayüzleri

raydium.cpmm       // CPMM havuzları: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // CLMM havuzları: createPool, openPositionFromBase, increasePositionFromBase,
                   //                 decreaseLiquidity, harvestAllRewards, swap, limit emirleri, ...
raydium.liquidity  // AMM v4 havuzları: 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, eğri kuralı ve platform yapılandırma oluşturucuları, ...
raydium.tradeV2    // Çok havuzlu yönlendirme: rota keşfi, hesaplama, rota yürütme
raydium.marketV2   // OpenBook market oluşturma (eski)
raydium.utils1216  // Tek seferlik tarihsel talep yardımcıları
raydium.token      // Token listesi + metadata: load(), getTokenInfo()
raydium.account    // Cüzdan token hesapları, ATA arama ve oluşturma
raydium.api        // REST istemcisi (fetchPoolById, getCpmmConfigs, fetchLaunchConfigs, ...)

​

İşlem oluşturucuları

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 — imzalayan ve gönderen bir kolaylık fonksiyonu. builder.execute ile eşdeğerdir.
• builder — tüm talimatlar ve imzalayanlar biriktirilmiş TxBuilder örneği. builder.build(), transaction alanı tek bir eski Transaction olan bir TxBuildData döndürür; builder.buildV0() ise tek bir VersionedTransaction içeren bir TxV0BuildData döndürür. Yalnızca buildMultiTx / buildMultiTxV0 bir dizi üretir.
• transaction — oluşturulmuş Transaction / VersionedTransaction.
• instructionTypes / signers — biriktirilmiş talimat etiketleri ve imzalayan kümesi.
• extInfo — ürüne özgü ekstralar. Örneğin cpmm.createPool, extInfo.address.{poolId, lpMint, vaultA, vaultB} döndürür; launchpad.createLaunchpad ise extInfo.address döndürür (bir LaunchpadPoolInfo artı poolId).

​

Neden asenkron oluşturucular?

​

CLMM modülü eklemeleri (en son sürüm)

• raydium.clmm.createCustomizablePool — collectFeeOn ve dynamicFeeConfig (yapılandırma hesabının PublicKey değeri) kabul eden createPool üst kümesi. Dinamik ücretleri etkinleştiren şey dynamicFeeConfig sağlamaktır; ayrı bir enableDynamicFee bayrağı ve dynamicFeeConfigId yoktur. Klasik createPool, varsayılan ücretli havuzlar için çalışmaya devam eder.
• raydium.clmm.openLimitOrder — tek tick’lik bir limit emri açar. poolInfo, baseIn (yön), orderTick, amount ve isteğe bağlı olarak tickArrayBitmap, noneIndex, ownerInfo alır. Tick’i nicelemek için dışa aktarılan getOrderTick({ baseIn, mintADecimal, mintBDecimal, tickSpacing, price }) yardımcısını kullanın.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — mevcut bir emrin doldurulmamış kısmını ayarlar. Her ikisi de { poolInfo, limitOrder, amount } alır; decreaseLimitOrder isteğe bağlı bir slippage ekler. Azaltma, tamamen doldurulmuş bir emirde InvalidOrderPhase ile geri döner.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — doldurulmuş çıktıyı sahibinin ATA’sına süpürür. settleLimitOrder yalnızca { limitOrder } alır — poolInfo almaz. Emrin sahibi veya programın limit_order_admin keeper’ı bunu çağırabilir.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — kirayı geri almak için tamamen kapatılmış emirleri kapatır.
• raydium.api.getClmmDynamicConfigs() — yeni /main/clmm-dynamic-config uç noktasına isabet eden REST yardımcısı. (Limit emri yapılandırma yardımcısı veya uç noktası yoktur: limit emirleri havuz başına bir yapılandırma hesabıyla değil, tick ile anahtarlanır.)

​

Yaygın tuzaklar

​

1. Küme uyuşmazlığı

​

2. ATA’ları önceden oluşturmayı unutmak

​

3. Eski poolInfo

​

4. Öncelik ücretleri

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 sınırı
    microLamports: 50_000,   // CU başına öncelik ücreti
  },
});

​

5. Slippage toleransı havuz türüyle eşleşmelidir

​

6. BN vs number

​

Sürüm oluşturma ilkesi

• @raydium-io/raydium-sdk-v2 Raydium’un koruduğu tek SDK’dır. Tüm belgeler, demolar ve entegrasyon rehberleri bunu hedefler.
• Eski bir v1 paketi (@raydium-io/raydium-sdk) tarihsel nedenlerle npm’de bulunur. Bakım CPMM ve LaunchLab sevk edildikten sonra sona erdi (v1 hiçbir zaman her ikisini de desteklemedi) ve 2024’ten sonra v1 sürümü yayınlanmamıştır. v1’i yaşam sonu olarak değerlendirin: yeni kod için kullanmayın ve kalan v1 entegrasyonlarını v2’ye geçirin.
• SDK v2 ön-1.0’dır. 0.x küçük sürümleri arasında kırıcı değişiklikler mümkündür; doğruladığınız sürümü sabitleyin ve yükseltirken GitHub sürüm notlarını kontrol edin.

​

Yükseltme

1. Her değiştirici çağrının dönüş türünü yeniden kontrol edin — şekil değişiklikleri (örn. extInfo) sık sık iniş yapar.
2. poolInfo getirme imzalarını yeniden oluşturun — bir alan yeniden adlandırılmış olabilir.
3. Slippage işlemenizi yeniden doğrulayın; SDK sürümler arasında otomatik sınırlı ve tercih edilen sınırlı davranışlar arasında kaymıştır.
4. raydium.tradeV2 (yönlendirme) kullanıyorsanız, rota şeklini yeniden doğrulayın — yüzeyin en kararsız kısmıdır. Arayüzün trade’den tradeV2’ye yeniden adlandırıldığını unutmayın; eski ad artık mevcut değildir.

​

Yardım almak

• GitHub sorunları — hatalar ve özellik istekleri için github.com/raydium-io/raydium-sdk-V2/issues adresinde dosya açın. Raydium ekibi aktif olarak izler.
• Discord — senkron yardım için discord.gg/raydium adresindeki #dev-support kanalı.
• Telegram — raydium.io adresinden bağlantılı geliştirici sohbeti (doğrulanmamış Telegram gruplarından kaçının).

​

İşaretçiler

• sdk-api/rest-api — SDK’nın HTTP tamamlayıcısı.
• sdk-api/trade-api — sunucu tarafından oluşturulan swap işlemleri.
• sdk-api/anchor-idl — program IDL’lerinden doğrudan istemcileri yeniden oluşturma.
• sdk-api/python-integration — solana-py aracılığıyla Python eşdeğeri.
• integration-guides/priority-fee-tuning — computeBudgetConfig boyutlandırma.

• Raydium SDK v2 kaynağı
• Raydium SDK sürüm notları.