Installation

Beginnen Sie mit Solana Pay, indem Sie das JavaScript SDK installieren und Ihre Entwicklungsumgebung einrichten. Das SDK ist framework-agnostisch und funktioniert mit jeder JavaScript-Umgebung.

Systemanforderungen

Node.js: Version 20 oder höher (erforderlich für Ed25519 crypto.subtle Unterstützung)
Paketmanager: pnpm, npm oder yarn
TypeScript: Version 5+ (empfohlen, aber nicht erforderlich)

Solana Pay SDK installieren

Wählen Sie Ihren bevorzugten Paketmanager:

# 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

Peer-Abhängigkeiten

Die folgenden sind Peer-Abhängigkeiten von @solana/pay und müssen gleichzeitig installiert werden:

Paket	Version
`@solana/kit`	`^6.5.0`

Optionale Abhängigkeiten

Für die Erstellung und Validierung von Transfers (SOL- und SPL-Token-Transfers) installieren Sie außerdem:

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

Für die Client-Factories (createMerchantClient, createWalletClient) installieren Sie außerdem die Kit-Plugins:

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

TypeScript-Konfiguration

Wenn Sie TypeScript verwenden, stellen Sie sicher, dass Ihre tsconfig.json Folgendes enthält:

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

Umgebungs-Setup

Entwicklungsumgebung

Richten Sie Umgebungsvariablen für die Entwicklung ein:

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

Produktionsumgebung

Verwenden Sie für die Produktion Mainnet-Endpunkte:

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

Installation überprüfen

Erstellen Sie einen einfachen Test, um zu überprüfen, dass alles funktioniert:

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

Führen Sie den Test aus:

npx tsx test-installation.ts

Sie sollten eine gültige Solana Pay URL in der Konsole sehen.

Häufige Probleme und Lösungen

Fehler bei der Modulauflösung

Wenn Sie Fehler wie "Cannot resolve module '@solana/pay'" sehen:

Löschen Sie den Cache Ihres Paketmanagers:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Löschen Sie node_modules und installieren Sie neu:
```
rm -rf node_modules
pnpm install
```

TypeScript-Fehler

Wenn Sie auf TypeScript-Fehler stoßen:

Aktualisieren Sie auf die neueste TypeScript-Version (5+)
Stellen Sie sicher, dass moduleResolution in Ihrer tsconfig.json auf "bundler" oder "nodenext" gesetzt ist

Nächste Schritte

Nachdem Sie Solana Pay installiert haben, wählen Sie Ihren Integrationspfad:

Transfer Requests - Einfache Zahlungs-URLs für grundlegende Überweisungen
Transaction Requests - Interaktive Zahlungsabläufe
QR-Code-Integration - QR-Codes für mobile Zahlungen generieren

Entwicklungstools

Erwägen Sie die Installation dieser hilfreichen Entwicklungstools:

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

# Local validator for testing
solana-test-validator

Ressourcen

GitHub-Repository - Quellcode und Beispiele
Solana Cookbook - Solana-Entwicklungsanleitungen

Inhaltsverzeichnis