Installation

Commencez avec Solana Pay en installant le SDK JavaScript et en configurant votre environnement de développement. Le SDK est indépendant de tout framework et fonctionne avec n'importe quel environnement JavaScript.

Configuration système requise

• Node.js : Version 20 ou supérieure (requise pour la prise en charge d'crypto.subtle)
• Gestionnaire de paquets : pnpm, npm ou yarn
• TypeScript : Version 5+ (recommandé mais non obligatoire)

Installer le SDK Solana Pay

Choisissez votre gestionnaire de paquets préféré :

# 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

Dépendances homologues

Les éléments suivants sont des dépendances homologues d'@solana/pay et doivent être installés avec celui-ci :

Dépendances facultatives

Pour la création et la validation de transferts (transferts SOL et jetons SPL), installez également :

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

Pour les factories de clients (createMerchantClient, createWalletClient), installez également les plugins du kit :

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

Configuration TypeScript

Si vous utilisez TypeScript, assurez-vous que votre tsconfig.json inclut :

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

Configuration de l'environnement

Environnement de développement

Configurez les variables d'environnement pour le développement :

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

Environnement de production

Pour la production, utilisez les points de terminaison du réseau principal :

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

Vérifier l'installation

Créez un test simple pour vérifier que tout fonctionne :

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

Exécutez le test :

npx tsx test-installation.ts

Vous devriez voir une URL Solana Pay valide dans la console.

Problèmes courants et solutions

Erreurs de résolution de module

Si vous rencontrez des erreurs du type « Cannot resolve module '@solana/pay' » :

1. Effacez le cache de votre gestionnaire de paquets :

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

2. Supprimez node_modules et réinstallez :

   rm -rf node_modules
   pnpm install

Erreurs TypeScript

Si vous rencontrez des erreurs TypeScript :

1. Mettez à jour vers la dernière version de TypeScript (5+)
2. Assurez-vous que moduleResolution est défini sur "bundler" ou "nodenext" dans votre tsconfig.json

Étapes suivantes

Maintenant que vous avez installé Solana Pay, choisissez votre parcours d'intégration :

• Demandes de transfert - URL de paiement simples pour les transferts de base
• Demandes de transaction - Flux de paiement interactifs
• Intégration de code QR - Générez des codes QR pour les paiements mobiles

Outils de développement

Envisagez d'installer ces outils de développement utiles :

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

# Local validator for testing
solana-test-validator

Ressources

• Dépôt GitHub - Code source et exemples
• Solana Cookbook - Recettes de développement Solana