安装 | Solana

通过安装 JavaScript SDK 并设置开发环境来开始使用 Solana Pay。该 SDK 与框架无关，可在任何 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

对等依赖

以下是 @solana/pay 的对等依赖，必须与其一起安装：

包	版本
`@solana/kit`	`^6.5.0`

可选依赖

对于转账创建和验证（SOL 和 SPL 代币转账），还需安装：

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

对于客户端工厂（createMerchantClient、createWalletClient），还需安装工具包插件：

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

生产环境

对于生产环境，使用主网端点：

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

验证安装

创建一个简单的测试来验证一切正常工作：

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

运行测试：

npx tsx test-installation.ts

您应该在控制台中看到一个有效的 Solana Pay URL。

常见问题及解决方案

模块解析错误

如果您看到类似"无法解析模块'@solana/pay'"的错误：

清除包管理器缓存：

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

删除 node_modules 并重新安装：
```
rm -rf node_modules
pnpm install
```

TypeScript 错误

如果您遇到 TypeScript 错误：

更新到最新的 TypeScript 版本（5+）
确保在您的 tsconfig.json 中将 moduleResolution 设置为 "bundler" 或 "nodenext"

后续步骤

现在您已经安装了 Solana Pay，请选择您的集成路径：

转账请求 - 用于基本转账的简单支付 URL
交易请求 - 交互式支付流程
二维码集成 - 为移动支付生成二维码

开发工具

考虑安装这些有用的开发工具：

# 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 开发教程

Table of Contents