Встановлення

Почніть роботу з 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 і повинні бути встановлені разом із ним:

Пакет	Версія
`@solana/kit`	`^6.5.0`

Опціональні залежності

Для створення та валідації переказів (переказів SOL та SPL токенів) також встановіть:

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

Для клієнтських фабрик (createMerchantClient, createWalletClient) також встановіть плагіни kit:

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 Solana Pay у консолі.

Поширені проблеми та рішення

Помилки розв'язання модулів

Якщо ви бачите помилки на кшталт "Cannot resolve module '@solana/pay'":

Очистіть кеш вашого менеджера пакетів:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Видаліть node_modules та перевстановіть:
```
rm -rf node_modules
pnpm install
```

Помилки TypeScript

Якщо ви стикаєтеся з помилками TypeScript:

Оновіть до останньої версії TypeScript (5+)
Переконайтеся, що moduleResolution встановлено на "bundler" або "nodenext" у вашому tsconfig.json

Наступні кроки

Тепер, коли ви встановили Solana 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 - Вихідний код та приклади
Solana Cookbook - Рецепти розробки Solana

Зміст