Εγκατάσταση

Ξεκινήστε με το Solana Pay εγκαθιστώντας το JavaScript SDK και ρυθμίζοντας το περιβάλλον ανάπτυξής σας. Το SDK είναι ανεξάρτητο από το framework και λειτουργεί με οποιοδήποτε περιβάλλον JavaScript.

Απαιτήσεις Συστήματος

• Node.js: Έκδοση 20 ή νεότερη (απαιτείται για υποστήριξη crypto.subtle)
• Διαχειριστής Πακέτων: pnpm, npm, ή yarn
• TypeScript: Έκδοση 5+ (συνιστάται αλλά δεν είναι απαραίτητο)

Εγκατάσταση του Solana Pay SDK

Επιλέξτε τον προτιμώμενο διαχειριστή πακέτων σας:

# 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

Οι παρακάτω είναι εξαρτήσεις peer του @solana/pay και πρέπει να εγκατασταθούν μαζί με αυτό:

Προαιρετικές Εξαρτήσεις

Για τη δημιουργία και επικύρωση μεταφορών (μεταφορές SOL και SPL token), εγκαταστήστε επίσης:

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

Για τα client factories (createMerchantClient, createWalletClient), εγκαταστήστε επίσης τα plugins kit:

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

Διαμόρφωση TypeScript

Εάν χρησιμοποιείτε TypeScript, βεβαιωθείτε ότι το tsconfig.json σας περιλαμβάνει:

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

Ρύθμιση Περιβάλλοντος

Περιβάλλον Ανάπτυξης

Ρυθμίστε τις μεταβλητές περιβάλλοντος για την ανάπτυξη:

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

Περιβάλλον Παραγωγής

Για την παραγωγή, χρησιμοποιήστε τα endpoints του mainnet:

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

Επαλήθευση Εγκατάστασης

Δημιουργήστε ένα απλό test για να επαληθεύσετε ότι όλα λειτουργούν:

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

Εκτελέστε το test:

npx tsx test-installation.ts

Θα πρέπει να δείτε ένα έγκυρο Solana Pay URL στην κονσόλα.

Συνήθη Προβλήματα και Λύσεις

Σφάλματα Επίλυσης Module

Εάν δείτε σφάλματα όπως "Cannot resolve module '@solana/pay'":

1. Καθαρίστε την προσωρινή μνήμη του package manager:

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

2. Διαγράψτε το node_modules και επανεγκαταστήστε:

   rm -rf node_modules
   pnpm install

Σφάλματα TypeScript

Εάν αντιμετωπίσετε σφάλματα TypeScript:

1. Ενημερώστε στην τελευταία έκδοση TypeScript (5+)
2. Βεβαιωθείτε ότι το moduleResolution έχει οριστεί σε "bundler" ή "nodenext" στο tsconfig.json σας

Επόμενα Βήματα

Τώρα που έχετε εγκαταστήσει το Solana Pay, επιλέξτε τη διαδρομή ενσωμάτωσής σας:

• Αιτήματα Μεταφοράς - Απλά URL πληρωμών για βασικές μεταφορές
• Αιτήματα Συναλλαγών - Διαδραστικές ροές πληρωμών
• Ενσωμάτωση QR Code - Δημιουργήστε QR codes για πληρωμές μέσω κινητού

Εργαλεία Ανάπτυξης

Σκεφτείτε να εγκαταστήσετε αυτά τα χρήσιμα εργαλεία ανάπτυξης:

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

# Local validator for testing
solana-test-validator

Πόροι

• Αποθετήριο GitHub - Πηγαίος κώδικας και παραδείγματα
• Solana Cookbook - Συνταγές ανάπτυξης Solana