التثبيت

ابدأ مع Solana Pay من خلال تثبيت JavaScript SDK وإعداد بيئة التطوير الخاصة بك. SDK مستقل عن أطر العمل ويعمل مع أي بيئة JavaScript.

متطلبات النظام

• Node.js: الإصدار 20 أو أعلى (مطلوب لدعم crypto.subtle)
• مدير الحزم: pnpm أو npm أو yarn
• TypeScript: الإصدار 5+ (موصى به ولكنه غير مطلوب)

تثبيت Solana Pay SDK

اختر مدير الحزم المفضل لديك:

# 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

التبعيات النظيرة

التالي هي تبعيات نظيرة لـ @solana/pay ويجب تثبيتها معه:

التبعيات الاختيارية

لإنشاء والتحقق من عمليات التحويل (تحويلات SOL ورموز SPL)، قم أيضًا بتثبيت:

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

لمصانع العملاء (createMerchantClient، createWalletClient)، قم أيضًا بتثبيت إضافات المجموعة:

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

إعداد TypeScript

إذا كنت تستخدم TypeScript، تأكد من أن tsconfig.json يتضمن:

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

إعداد البيئة

بيئة التطوير

قم بإعداد متغيرات البيئة للتطوير:

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

بيئة الإنتاج

للإنتاج، استخدم نقاط نهاية mainnet:

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

التحقق من التثبيت

أنشئ اختباراً بسيطاً للتحقق من أن كل شيء يعمل:

// 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

قم بتشغيل الاختبار:

npx tsx test-installation.ts

يجب أن تشاهد عنوان URL صالحاً لـ سولانا Pay في وحدة التحكم.

المشاكل الشائعة والحلول

أخطاء تحليل الوحدات

إذا رأيت أخطاء مثل "Cannot resolve module '@solana/pay'":

1. امسح ذاكرة التخزين المؤقت لمدير الحزم:

   # pnpm
   pnpm store prune
   
   # npm
   npm cache clean --force
   
   # yarn
   yarn cache clean

2. احذف node_modules وأعد التثبيت:

   rm -rf node_modules
   pnpm install

أخطاء TypeScript

إذا واجهت أخطاء TypeScript:

1. قم بالتحديث إلى أحدث إصدار من TypeScript (5+)
2. تأكد من تعيين moduleResolution إلى "bundler" أو "nodenext" في ملف tsconfig.json الخاص بك

الخطوات التالية

الآن بعد أن قمت بتثبيت سولانا Pay، اختر مسار التكامل الخاص بك:

• طلبات التحويل - عناوين URL بسيطة للدفع للتحويلات الأساسية
• طلبات المعاملات - تدفقات دفع تفاعلية
• تكامل رمز QR - إنشاء رموز QR للمدفوعات عبر الهاتف المحمول

أدوات التطوير

فكر في تثبيت أدوات التطوير المفيدة التالية:

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

# Local validator for testing
solana-test-validator

الموارد

• مستودع GitHub - الكود المصدري والأمثلة
• كتاب طبخ سولانا - وصفات تطوير سولانا