Instalacja

Rozpocznij pracę z Solana Pay, instalując SDK JavaScript i konfigurując środowisko programistyczne. SDK jest niezależne od frameworka i działa z każdym środowiskiem JavaScript.

Wymagania systemowe

• Node.js: Wersja 20 lub wyższa (wymagana do obsługi crypto.subtle)
• Menedżer pakietów: pnpm, npm lub yarn
• TypeScript: Wersja 5+ (zalecane, ale nieobowiązkowe)

Instalacja Solana Pay SDK

Wybierz preferowany menedżer pakietów:

# 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

Zależności równorzędne

Poniższe są zależnościami równorzędnymi @solana/pay i muszą zostać zainstalowane razem z nim:

Zależności opcjonalne

Do tworzenia i walidacji transferów (transfery SOL i tokenów SPL) zainstaluj również:

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

Do fabryk klientów (createMerchantClient, createWalletClient) zainstaluj również wtyczki kit:

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

Konfiguracja TypeScript

Jeśli używasz TypeScript, upewnij się, że Twój tsconfig.json zawiera:

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

Konfiguracja środowiska

Środowisko programistyczne

Skonfiguruj zmienne środowiskowe dla rozwoju:

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

Środowisko produkcyjne

W produkcji użyj punktów końcowych mainnet:

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

Weryfikacja instalacji

Utwórz prosty test, aby sprawdzić, czy wszystko działa:

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

Uruchom test:

npx tsx test-installation.ts

W konsoli powinieneś zobaczyć prawidłowy adres URL Solana Pay.

Typowe problemy i rozwiązania

Błędy rozwiązywania modułów

Jeśli widzisz błędy typu „Nie można rozwiązać modułu '@solana/pay'“:

1. Wyczyść pamięć podręczną menedżera pakietów:

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

2. Usuń node_modules i zainstaluj ponownie:

   rm -rf node_modules
   pnpm install

Błędy TypeScript

Jeśli napotkasz błędy TypeScript:

1. Zaktualizuj do najnowszej wersji TypeScript (5+)
2. Upewnij się, że moduleResolution jest ustawiony na "bundler" lub "nodenext" w Twoim tsconfig.json

Następne kroki

Teraz, gdy masz zainstalowany Solana Pay, wybierz ścieżkę integracji:

• Żądania przelewu - Proste adresy URL płatności dla podstawowych przelewów
• Żądania transakcji - Interaktywne procesy płatności
• Integracja kodu QR - Generuj kody QR do płatności mobilnych

Narzędzia deweloperskie

Rozważ zainstalowanie tych przydatnych narzędzi deweloperskich:

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

# Local validator for testing
solana-test-validator

Zasoby

• Repozytorium GitHub - Kod źródłowy i przykłady
• Solana Cookbook - Receptury programowania Solana