インストール

JavaScript SDKをインストールし、開発環境をセットアップして、Solana Payを始めましょう。このSDKはフレームワークに依存せず、あらゆるJavaScript環境で動作します。

システム要件

Node.js: バージョン20以上（Ed25519 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が表示されるはずです。

よくある問題と解決策

モジュール解決エラー

「Cannot resolve module '@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
トランザクションリクエスト - インタラクティブな支払いフロー
QRコード統合 - モバイル決済用のQRコード生成

開発ツール

以下の便利な開発ツールのインストールを検討してください：

# 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開発レシピ

目次