Installazione

Inizia a utilizzare Solana Pay installando l'SDK JavaScript e configurando il tuo ambiente di sviluppo. L'SDK è indipendente dal framework e funziona con qualsiasi ambiente JavaScript.

Requisiti di Sistema

• Node.js: Versione 20 o superiore (richiesto per il supporto crypto.subtle)
• Gestore di Pacchetti: pnpm, npm o yarn
• TypeScript: Versione 5+ (consigliato ma non obbligatorio)

Installa l'SDK di Solana Pay

Scegli il tuo gestore di pacchetti preferito:

# 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

Dipendenze Peer

Le seguenti sono dipendenze peer di @solana/pay e devono essere installate insieme ad esso:

Dipendenze Opzionali

Per la creazione e validazione dei trasferimenti (trasferimenti SOL e token SPL), installa anche:

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

Per le factory dei client (createMerchantClient, createWalletClient), installa anche i plugin del kit:

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

Configurazione TypeScript

Se utilizzi TypeScript, assicurati che il tuo tsconfig.json includa:

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

Configurazione dell'Ambiente

Ambiente di Sviluppo

Configura le variabili d'ambiente per lo sviluppo:

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

Ambiente di Produzione

Per la produzione, utilizza gli endpoint mainnet:

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

Verifica dell'installazione

Crea un semplice test per verificare che tutto funzioni:

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

Esegui il test:

npx tsx test-installation.ts

Dovresti vedere un URL Solana Pay valido nella console.

Problemi comuni e soluzioni

Errori di risoluzione dei moduli

Se visualizzi errori come "Cannot resolve module '@solana/pay'":

1. Svuota la cache del tuo gestore di pacchetti:

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

2. Elimina node_modules e reinstalla:

   rm -rf node_modules
   pnpm install

Errori TypeScript

Se riscontri errori TypeScript:

1. Aggiorna all'ultima versione di TypeScript (5+)
2. Assicurati che moduleResolution sia impostato su "bundler" o "nodenext" nel tuo tsconfig.json

Prossimi passi

Ora che hai installato Solana Pay, scegli il tuo percorso di integrazione:

• Richieste di trasferimento - URL di pagamento semplici per trasferimenti di base
• Richieste di transazione - Flussi di pagamento interattivi
• Integrazione con codici QR - Genera codici QR per pagamenti da mobile

Strumenti di sviluppo

Considera l'installazione di questi utili strumenti di sviluppo:

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

# Local validator for testing
solana-test-validator

Risorse

• Repository GitHub - Codice sorgente ed esempi
• Solana Cookbook - Guide pratiche per lo sviluppo su Solana