JavaScript'te Kripto İşlemi Gönderme: ChainGate ile Bitcoin, Ethereum, Litecoin, Dogecoin ve Daha Fazlası

1. Setup: ChainGate'i kurma ve başlatma

Paket yöneticini seç. SDK tek bir npm paketi olarak yayınlanıyor — bir kez kur, aynı import'tan Bitcoin, Ethereum ve gerisini gönderebilirsin, tipler dahil:

# pick your package manager
npm install chaingate
pnpm add chaingate
yarn add chaingate

Sonra ücretsiz API key'i ChainGate dashboard'undan al. Kayıt yaklaşık bir dakika sürer ve ücretsiz plan bir prototipi ürüne taşımak için yeter. Client'ı bu key ile bir kez başlat ve her zincir için tekrar kullan:

import { ChainGate } from 'chaingate';

const cg = new ChainGate({ apiKey: process.env.CHAINGATE_API_KEY });

Node.js'te de tarayıcıda da aynı kod. Paket Node 22+, modern tarayıcılar (Vite, Next.js, Webpack 5+) ve Bun'da kutudan çıkar çıkmaz çalışır, böylece sunucuda import ettiğin Node.js blockchain kütüphanesi, kullanıcının tarayıcısında da aynı şekilde çalışır. Buffer ve randomBytes gibi crypto primitive'leri SDK'nın içinde native olarak geliyor — polyfill'lemek için bir şey yok, yapılandıracak bir şey yok.

TypeScript tipleri pakette geliyor. @types/chaingate paketi yok çünkü ihtiyaç yok — her public class, method ve event kaynağında tam tipli.

2. Bitcoin, Litecoin, Dogecoin ve Bitcoin Cash gönderme

Bitcoin, Litecoin, Dogecoin ve Bitcoin Cash aynı muhasebe modelini paylaşır — UTXO'lar. Bir wallet'ın bakiyesi, adreslerine kilitli unspent transaction output'ların toplamıdır. Fon göndermek için wallet, miktarı karşılayacak kadar UTXO seçer; bunları input olarak tüketen yeni bir işlem oluşturur; alıcıya bir output yollar; kalanı kendisine change output olarak geri gönderir; kilobayt başına satoshi (ya da zincir karşılığı) cinsinden bir fee öder.

ChainGate her adımı — UTXO seçimi, change output, fee tier'ı ve imza — tek bir transfer() çağrısının arkasında halleder. Hedef adres ve miktar verirsin, broadcast'e hazır imzalı bir işlem alırsın.

Node.js veya tarayıcıda Bitcoin gönderme

Temel örnek. Wallet'ı Bitcoin ağına bağla, transfer'i oluştur, bir fee tier'ı seç ve broadcast et:

import { ChainGate, importWallet, NotEnoughFundsError } from 'chaingate';

const cg = new ChainGate({ apiKey: process.env.CHAINGATE_API_KEY });
const wallet = importWallet({ phrase: process.env.MNEMONIC });

const btc = cg.connect(cg.networks.bitcoin, wallet);
const amount = cg.networks.bitcoin.amount('0.001'); // 0.001 BTC

try {
  const tx = await btc.transfer(amount, 'bc1qRecipient...');
  tx.setFee(tx.recommendedFees().normal);

  const broadcast = await tx.signAndBroadcast();
  console.log('BTC txid:', broadcast.transactionId);
} catch (err) {
  if (err instanceof NotEnoughFundsError) {
    console.error('Not enough BTC for this transfer + fee');
  }
  throw err;
}

Geliştirmede testnet'i hedeflemek için cg.networks.bitcoin yerine cg.networks.bitcoinTestnet koy — kodun geri kalanı aynı kalır.

Node.js veya tarayıcıda Litecoin gönderme

Aynı kod, farklı ağ. Bitcoin snippet'ine göre diff tam anlamıyla bir tanımlayıcıdan ibaret:

const ltc = cg.connect(cg.networks.litecoin, wallet);
const amount = cg.networks.litecoin.amount('0.1'); // 0.1 LTC

const tx = await ltc.transfer(amount, 'ltc1qRecipient...');
tx.setFee(tx.recommendedFees().normal);
await tx.signAndBroadcast();

Litecoin varsayılanda ltc1q… SegWit adreslerini kullanır ve blokları her iki buçuk dakikada bir onaylar — Bitcoin'in yaklaşık dört katı hızda — bu yüzden settlement hızının güvenlik derinliğinden daha önemli olduğu düşük tutarlı ödemeler için popüler bir tercihtir.

Node.js veya tarayıcıda Dogecoin gönderme

Aynı diff, farklı zincir:

const doge = cg.connect(cg.networks.dogecoin, wallet);
const amount = cg.networks.dogecoin.amount('100'); // 100 DOGE

const tx = await doge.transfer(amount, 'DRecipientAddress...');
tx.setFee(tx.recommendedFees().normal);
await tx.signAndBroadcast();

Dogecoin'in JavaScript ekosistemi UTXO ailesinin geri kalanının gerisinde kaldı. bitcoinjs-lib'in popüler fork'larının çoğu yıllardır güncellenmiyor ve bakımı yapılan birkaç alternatif özel. ChainGate, bugün JavaScript'te üretim kalitesinde Dogecoin desteği sunan birkaç seçenekten biri.

Node.js veya tarayıcıda Bitcoin Cash gönderme

Bitcoin Cash varsayılan olarak CashAddr adreslerini kullanır ama SDK legacy formatını da kabul eder — ikisini de transfer() içine yapıştırabilirsin, ağ yine onaylayacaktır:

const bch = cg.connect(cg.networks.bitcoincash, wallet);
const amount = cg.networks.bitcoincash.amount('0.05'); // 0.05 BCH

// CashAddr or legacy — both work
const tx = await bch.transfer(amount, 'bitcoincash:qpRecipient...');
tx.setFee(tx.recommendedFees().normal);
await tx.signAndBroadcast();

Adres doğrulama çift yönlü: cg.networks.bitcoincash.isValidAddress() her iki format için de true döner, dolayısıyla göndermeden önce kullanıcı girdisini normalize etmen gerekmiyor.

Tarayıcıdan UTXO gönderme

Yukarıdaki dört UTXO snippet'i Vite, Next.js veya Webpack 5 bundle'ında değişiklik olmadan çalışır — aynı import client tarafında çalışır ve aynı wallet API ile konuşmadan yerel olarak imza atar.

Bir güvenlik notu: üretim private key'lerini doğrudan bir frontend'e yükleme. Ya imzalamayı sunucuda tut ve tarayıcıdan sadece broadcast'i çağır, ya da kullanıcının kontrolündeki wallet tarzı bir akış üzerinden anahtarı kullanıcıdan al.

3. Ethereum ve EVM zincirlerini gönderme

Ethereum'un hesap modeli farklı — UTXO yok, sadece bakiyeye ve monoton artan bir nonce'a sahip bir adres var. ChainGate bu farkı, Bitcoin'de kullandığın aynı transfer() çağrısının arkasında saklar. Farklar (nonce yönetimi, EIP-1559 base fee + tip, gas limit) senin için hesaplanır:

const eth = cg.connect(cg.networks.ethereum, wallet);
const amount = cg.networks.ethereum.amount('0.01'); // 0.01 ETH

const tx = await eth.transfer(amount, '0xRecipient...');
tx.setFee(tx.recommendedFees().normal);

const broadcast = await tx.signAndBroadcast();
console.log('ETH txHash:', broadcast.transactionId);

Avalanche'ı Node.js veya tarayıcıdan gönderme

Avalanche'ın C-Chain'i Ethereum'un yanında birinci sınıf ağ olarak bağlıdır — aynı çağrı şekli, aynı wallet, AVAX cinsinden tutarlar. Ethereum snippet'iyle aradaki diff tek bir tanımlayıcıdan ibaret:

const avax = cg.connect(cg.networks.avalanche, wallet);
const amount = cg.networks.avalanche.amount('1'); // 1 AVAX

const tx = await avax.transfer(amount, '0xRecipient...');
tx.setFee(tx.recommendedFees().normal);
await tx.signAndBroadcast();

C-Chain blokları yaklaşık iki saniyede sonlandırır ve Ethereum'la aynı EIP-1559 fee modelinde çalışır, dolayısıyla AVAX transferleri hızla yerine oturur ve recommendedFees() çıktısı aynı biçimdedir. Bu da Ethereum gas'inin kullanıcıyı fiyat olarak dışarıda bıraktığı yüksek hacimli ödemelerde Avalanche'ı popüler bir tercih yapar.

Aynı wallet, aynı SDK, her EVM zinciri. Hosted RPC URL'leri Polygon, Arbitrum, Base, BNB Chain ve Sonic'i kutudan çıkar çıkmaz kapsar; başka herhangi bir EVM ağı için — Optimism, Linea, Scroll, Gnosis, kendi node'un, bir testnet — JSON-RPC URL'sini doğrudan evmRpc()'ye geçir. Polygon'da POL göndermek tek satırlık bir diff:

const polygon = cg.networks.evmRpc({
  rpcUrl: cg.rpcUrls.polygon,
  chainId: 137,
  name: 'Polygon',
  symbol: 'POL',
});

const pol = cg.connect(polygon, wallet);
const amount = polygon.amount('5'); // 5 POL

const tx = await pol.transfer(amount, '0xRecipient...');
tx.setFee(tx.recommendedFees().normal);
await tx.signAndBroadcast();

Nonce yönetimi otomatik. SDK imzalamadan önce seçilen RPC'den son pending nonce'u okur, dolayısıyla kendin takip etmek zorunda değilsin. Fee yapımı destekleyen zincirlerde varsayılanda EIP-1559 (maxFeePerGas + maxPriorityFeePerGas) kullanır ve desteklemeyen zincirlerde legacy gas pricing'e döner.

evmRpc()'ye geçirdiğin chainId, RPC uç noktasının kendi bildirdiği değer olmalı; yoksa SDK yanlış ağ için imzalar. EVM chain ID listesi Polygon, Arbitrum, Base, Optimism ve 35 başka ağ ile testnet'in numarasını verir ve numarayı herhangi bir RPC URL'sinden doğrudan nasıl okuyacağını gösterir.

Düğüm bir broadcast'e "nonce too low", "replacement transaction underpriced" ya da "insufficient funds for gas * price + value" ile cevap verirse Ethereum işlem hataları rehberi her mesajın ne anlama geldiğini ve hangilerinin gas'a mal olduğunu açıklar.

Tarayıcı desteği UTXO zincirleriyle aynı. Bu kod tam olarak bir dApp'te 'Send' butonunun arkasına koyacağın kod.

4. Göndermeden önce fee tahmini

Broadcast'ten önce her zaman fee'yi göster. Kullanıcılar sürprizleri sevmez, sıkışan işlemler vakit harcar ve bir 'gözden geçir ve onayla' adımı tek vuruşluk bir UI akışını kullanıcının gerçekten güvendiği bir şeye dönüştürür.

ChainGate her zincirde aynı recommendedFees() methodunu sunar — dört tier (low, normal, high, maximum) ve her tier için gereken sayıları döndürür. Bitcoin'de feePerKbSat oranı ve satoshi cinsinden tahmini toplam alırsın; Ethereum ve diğer EVM zincirlerinde EIP-1559 maxFeePerGas ve maxPriorityFeePerGas'ı bigint wei değerleri olarak ve bir tahmini onay penceresi alırsın:

// Bitcoin — fee rate in sat/kB, plus the total estimated fee in satoshis
const btcTx = await btc.transfer(cg.networks.bitcoin.amount('0.01'), 'bc1q...');
const btcFees = btcTx.recommendedFees();

console.table({
  low:    { satPerKb: btcFees.low.feePerKbSat,    feeSat: btcFees.low.estimatedFeeSat,    enough: btcFees.low.enoughFunds },
  normal: { satPerKb: btcFees.normal.feePerKbSat, feeSat: btcFees.normal.estimatedFeeSat, enough: btcFees.normal.enoughFunds },
  high:   { satPerKb: btcFees.high.feePerKbSat,   feeSat: btcFees.high.estimatedFeeSat,   enough: btcFees.high.enoughFunds },
});

// Ethereum — EIP-1559 numbers in gwei
const ethTx = await eth.transfer(cg.networks.ethereum.amount('0.1'), '0x...');
const ethFees = ethTx.recommendedFees();
const toGwei = (wei) => Number(wei) / 1e9;

console.table({
  low:     { gwei: toGwei(ethFees.low.maxFeePerGas),     sec: ethFees.low.estimatedConfirmationSecs },
  normal:  { gwei: toGwei(ethFees.normal.maxFeePerGas),  sec: ethFees.normal.estimatedConfirmationSecs },
  high:    { gwei: toGwei(ethFees.high.maxFeePerGas),    sec: ethFees.high.estimatedConfirmationSecs },
  maximum: { gwei: toGwei(ethFees.maximum.maxFeePerGas), sec: ethFees.maximum.estimatedConfirmationSecs },
});

Üretimde işe yarayan pattern: işlemi oluştur, recommendedFees() çağır, dört tier'ı kullanıcıya göster, seçmesine izin ver ve sonra signAndBroadcast()'i çağır. İşlem nesnesi tahmin ile broadcast arasında bellekte kalır — yeniden inşa etmeye gerek yok.

5. Göndermeden önce bakiye kontrolü

Bakiye kontrolü her gönderim akışının en üstüne aittir. Yazım hatalarını yakalar, başarısız olacak bir işlem için boşa gas yakmayı engeller ve kullanıcıya doğrulayabileceği bir sayı verir. Her zincir aynı one-liner'ı sunar — bir adres geçir (ya da bağlı wallet'ı kullan) ve onaylanmış bakiyeyi, destekleyen zincirlerde de onaylanmamış kısmı al:

// Ethereum — confirmed balance + live USD price
const eth = cg.connect(cg.networks.ethereum, wallet);
const ethBalance = await eth.addressBalance();
const ethUsd = await ethBalance.confirmed.toCurrency('usd');
console.log(`${ethBalance.confirmed.base()} ETH ($${ethUsd})`);

// Bitcoin — confirmed and unconfirmed split
const btc = cg.connect(cg.networks.bitcoin, wallet);
const btcBalance = await btc.addressBalance();
console.log(`Confirmed:   ${btcBalance.confirmed.base()} BTC`);
console.log(`Unconfirmed: ${btcBalance.unconfirmed.base()} BTC`);

Fee tahmini ile birleştirildiğinde tam pre-flight üç çağrı — bakiye, fee, sonra gönder. Bunları bir kez bağla, uygulamandaki her gönderim akışı aynı pre-send doğrulamayı bedava alır; ister sunucuda Node.js'te ister tarayıcıda kripto bakiyesini kontrol et.

6. ChainGate ile bitcoinjs-lib, ethers ve diğer alternatifler

ChainGate kendinden önceki her low-level kütüphaneyi yerinden etmeye çalışmıyor. Her birinin net bir görevi var. Birden fazla zincirde işlem göndermen gerektiğinde trade-off'lar şöyle:

İşlem şekli üzerinde byte düzeyinde kontrol istediğinde ya da uygulaman tek bir zincirle konuşuyor ve bundle boyutu belirleyici faktörse bitcoinjs-lib veya ethers'la kal. Birden fazla zincirle aynı anda jonglörlük yapıyorsan, bir deadline'a karşı yarışıyorsan ya da blok zinciri başına uzmanlaşmayı kaldıramayacak küçük bir takım yönetiyorsan ChainGate'e geç.

7. Fiyatlandırma ve ücretsiz plan

Ücretsiz plan kasıtlı olarak cömert — ücretsiz dahil her plan, desteklediğimiz her zincir için SDK'nın tamamı ile geliyor: bakiyeler, asset listingleri, fee tahmini, imzalama ve broadcast. Bir prototipi yayına almak, kişisel bir projeyi sürdürmek ya da bir iç aracı üretime taşımak için yeter. Kayıtta kredi kartı istenmiyor.

Ücretli tier'lar rate limit'leri yükseltir, priority support ve burst kapasitesi ekler. Yükseltme dashboard içinde tek tıklık bir akıştır.

Güncel rakamlar ve yükseltme yolu için fiyatlandırma sayfasına bak.

8. Buradan nereye gidebilirsin

Modeli aldın: tek bir SDK, birden fazla zincir ve her birinde aynı beş satırlık şekil. Buradan sonra dokümantasyon yüzeyin geri kalanını kapsar — mesaj imzalama, ERC-20 transferleri, NFT hareketleri, decoded işlem geçmişi. GitHub'daki örnekler kopyalayabileceğin uçtan uca tarifler için iyi bir başlangıç noktası. Ve API dashboard'u bir key alıp bir şeyi yayına almak istediğinde tek tık uzaklıkta. Bir fee'nin arkasındaki mekaniğe daha derinden inmek istersen Ethereum gas üzerine olan tamamlayıcı rehber, recommendedFees() içindeki sayıların gerçekten nereden geldiğini açıyor. Buna ek olarak işlem hash'leri rehberi, signAndBroadcast()'ten dönen transactionId'nin her zincirde nasıl göründüğünü ve bir blok gezgininde nasıl sorgulanacağını anlatıyor.

Sıkça sorulan sorular