Kurulum

Solana Pay ile JavaScript SDK'yı yükleyerek ve geliştirme ortamınızı kurarak başlayın. SDK, framework-agnostiktir ve herhangi bir JavaScript ortamıyla çalışır.

Sistem Gereksinimleri

Node.js: Sürüm 20 veya üzeri (Ed25519 crypto.subtle desteği için gereklidir)
Paket Yöneticisi: pnpm, npm veya yarn
TypeScript: Sürüm 5+ (önerilir ancak zorunlu değildir)

Solana Pay SDK Kurulumu

Tercih ettiğiniz paket yöneticisini seçin:

# Using pnpm (recommended)
pnpm add @solana/pay@beta @solana/kit

# Using npm
npm install @solana/pay@beta @solana/kit

# Using yarn
yarn add @solana/pay@beta @solana/kit

Eş Bağımlılıklar

Aşağıdakiler @solana/pay paketinin eş bağımlılıklarıdır ve onunla birlikte yüklenmelidir:

Paket	Sürüm
`@solana/kit`	`^6.5.0`

İsteğe Bağlı Bağımlılıklar

Transfer oluşturma ve doğrulama (SOL ve SPL token transferleri) için aşağıdakileri de yükleyin:

pnpm add @solana-program/system @solana-program/token @solana-program/token-2022 @solana-program/memo

İstemci fabrikaları (createMerchantClient, createWalletClient) için kit eklentilerini de yükleyin:

pnpm add @solana/kit-plugin-rpc @solana/kit-plugin-payer @solana/kit-plugin-instruction-plan

TypeScript Yapılandırması

TypeScript kullanıyorsanız, tsconfig.json dosyanızın şunları içerdiğinden emin olun:

{
  "compilerOptions": {
    "module": "ESNext",
    "target": "ES2022",
    "lib": ["ES2022", "DOM", "DOM.Iterable"],
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

Ortam Kurulumu

Geliştirme Ortamı

Geliştirme için ortam değişkenlerini ayarlayın:

# .env.local
SOLANA_RPC_URL=https://api.devnet.solana.com
SOLANA_NETWORK=devnet

Üretim Ortamı

Üretim için mainnet uç noktalarını kullanın:

# .env.production
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_NETWORK=mainnet-beta

Kurulumu Doğrulama

Her şeyin çalıştığını doğrulamak için basit bir test oluşturun:

// test-installation.ts
import { address } from "@solana/kit";
import { encodeURL } from "@solana/pay";

// Test creating a payment URL
const recipient = address("FvJ8k8HhXp4a3zQyFMZd4FvEqcYdYE7gSZWxrEBRfBsB");

const url = encodeURL({
  recipient,
  amount: 0.01,
  label: "Test Store",
  message: "Test payment"
});

console.log("Solana Pay URL:", url.toString());
// Output: solana:FvJ8k8Hh...?amount=0.01&label=Test%20Store&message=Test%20payment

Testi çalıştırın:

npx tsx test-installation.ts

Konsolda geçerli bir Solana Pay URL'si görmelisiniz.

Yaygın Sorunlar ve Çözümler

Modül Çözümleme Hataları

"'@solana/pay' modülü çözümlenemiyor" gibi hatalar görürseniz:

Paket yöneticinizin önbelleğini temizleyin:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

node_modules dosyasını silin ve yeniden yükleyin:
```
rm -rf node_modules
pnpm install
```

TypeScript Hataları

TypeScript hatalarıyla karşılaşırsanız:

En son TypeScript sürümüne (5+) güncelleyin
tsconfig.json dosyanızda moduleResolution ayarının "bundler" veya "nodenext" olarak ayarlandığından emin olun

Sonraki Adımlar

Artık Solana Pay'i yüklediğinize göre, entegrasyon yolunuzu seçin:

Transfer İstekleri - Temel transferler için basit ödeme URL'leri
İşlem İstekleri - Etkileşimli ödeme akışları
QR Kod Entegrasyonu - Mobil ödemeler için QR kodları oluşturma

Geliştirme Araçları

Bu yararlı geliştirme araçlarını yüklemeyi düşünün:

# Solana CLI (for testing and key generation)
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

# Local validator for testing
solana-test-validator

Kaynaklar

GitHub Deposu - Kaynak kodu ve örnekler
Solana Cookbook - Solana geliştirme tarifleri

İçindekiler