Asennus

Aloita Solana Payn käyttö asentamalla JavaScript SDK ja määrittämällä kehitysympäristösi. SDK on kehysneutraali ja toimii missä tahansa JavaScript-ympäristössä.

Järjestelmävaatimukset

Node.js: Versio 20 tai uudempi (vaaditaan Ed25519 crypto.subtle -tukea varten)
Paketinhallinta: pnpm, npm tai yarn
TypeScript: Versio 5+ (suositeltu mutta ei pakollinen)

Asenna Solana Pay SDK

Valitse haluamasi paketinhallinta:

# 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

Vertaisriippuvuudet

Seuraavat ovat @solana/pay -riippuvuuksia ja ne on asennettava sen rinnalle:

Paketti	Versio
`@solana/kit`	`^6.5.0`

Valinnaiset riippuvuudet

Siirtojen luomista ja validointia varten (SOL- ja SPL-token-siirrot), asenna myös:

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

Asiakkaiden tehtaita varten (createMerchantClient, createWalletClient), asenna myös kit-laajennukset:

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

TypeScript-määritykset

Jos käytät TypeScriptiä, varmista että tsconfig.json sisältää:

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

Ympäristön määrittäminen

Kehitysympäristö

Määritä ympäristömuuttujat kehitystä varten:

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

Tuotantoympäristö

Tuotantoa varten käytä mainnet-päätepisteitä:

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

Vahvista asennus

Luo yksinkertainen testi varmistaaksesi, että kaikki toimii:

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

Suorita testi:

npx tsx test-installation.ts

Konsolissa pitäisi näkyä kelvollinen Solana Pay -URL.

Yleiset ongelmat ja ratkaisut

Moduulin selvitysvirheet

Jos näet virheitä kuten "Cannot resolve module '@solana/pay'":

Tyhjennä paketinhallinnan välimuisti:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Poista node_modules ja asenna uudelleen:
```
rm -rf node_modules
pnpm install
```

TypeScript-virheet

Jos kohtaat TypeScript-virheitä:

Päivitä uusimpaan TypeScript-versioon (5+)
Varmista, että moduleResolution on asetettu arvoon "bundler" tai "nodenext" tsconfig.json-tiedostossasi

Seuraavat vaiheet

Nyt kun sinulla on Solana Pay asennettuna, valitse integrointitapasi:

Siirtopyynnöt - Yksinkertaiset maksu-URL:t perussiirroille
Transaktiopyynnöt - Interaktiiviset maksuvirrat
QR-koodin integrointi - Luo QR-koodeja mobiilimaksuille

Kehitystyökalut

Harkitse näiden hyödyllisten kehitystyökalujen asentamista:

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

# Local validator for testing
solana-test-validator

Resurssit

GitHub-repositorio - Lähdekoodi ja esimerkit
Solana Cookbook - Solana-kehityksen reseptit

Sisällysluettelo