Installatie

Ga aan de slag met Solana Pay door de JavaScript SDK te installeren en uw ontwikkelomgeving in te stellen. De SDK is framework-agnostisch en werkt met elke JavaScript-omgeving.

Systeemvereisten

Node.js: Versie 20 of hoger (vereist voor Ed25519 crypto.subtle ondersteuning)
Pakketbeheerder: pnpm, npm of yarn
TypeScript: Versie 5+ (aanbevolen maar niet verplicht)

Installeer Solana Pay SDK

Kies uw voorkeurspakketbeheerder:

# 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 Dependencies

De volgende zijn peer dependencies van @solana/pay en moeten samen met het pakket worden geïnstalleerd:

Pakket	Versie
`@solana/kit`	`^6.5.0`

Optionele Dependencies

Voor het aanmaken en valideren van overdrachten (SOL en SPL token overdrachten), installeer ook:

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

Voor de client factories (createMerchantClient, createWalletClient), installeer ook de kit plugins:

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

TypeScript Configuratie

Als u TypeScript gebruikt, zorg ervoor dat uw tsconfig.json het volgende bevat:

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

Omgevingsconfiguratie

Ontwikkelomgeving

Stel omgevingsvariabelen in voor ontwikkeling:

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

Productieomgeving

Gebruik voor productie mainnet endpoints:

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

Installatie Verifiëren

Maak een eenvoudige test om te controleren of alles werkt:

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

Voer de test uit:

npx tsx test-installation.ts

Je zou een geldige Solana Pay URL in de console moeten zien.

Veelvoorkomende Problemen en Oplossingen

Module Resolution Fouten

Als je foutmeldingen ziet zoals "Cannot resolve module '@solana/pay'":

Wis de cache van je package manager:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Verwijder node_modules en installeer opnieuw:
```
rm -rf node_modules
pnpm install
```

TypeScript Fouten

Als je TypeScript fouten tegenkomt:

Update naar de nieuwste TypeScript versie (5+)
Zorg ervoor dat moduleResolution is ingesteld op "bundler" of "nodenext" in je tsconfig.json

Volgende Stappen

Nu je Solana Pay hebt geïnstalleerd, kies je integratiepad:

Transfer Requests - Eenvoudige betaal-URL's voor basistransfers
Transaction Requests - Interactieve betalingsprocessen
QR Code Integratie - Genereer QR-codes voor mobiele betalingen

Ontwikkeltools

Overweeg deze handige ontwikkeltools te installeren:

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

# Local validator for testing
solana-test-validator

Bronnen

GitHub Repository - Broncode en voorbeelden
Solana Cookbook - Solana ontwikkel recepten

Inhoudsopgave