solana-v1

スキル：solana

対象範囲

• framework-kit を使用した Solana dApp UI の開発（React/Next.js）
• ウォレットの接続と署名フロー
• トランザクションの構築、送信、確認 UX
• アドレスの検証とトランザクションのパターン

対象外：

• EVM フロントエンドの開発（wagmi-v3 を参照）
• dApp UI を伴わない、アドレスのみのバックエンド検証（@solana/web3.js の PublicKey のみを使用する場合があります）
• 一般的なブロックチェーンの概念

前提条件

• UI 開発には @solana/client と @solana/react-hooks を使用します
• クライアント/RPC/トランザクションのコードには @solana/kit を使用します
• アドレスの検証には @solana/web3.js v1.x を使用します
• UI には React 18+ または Next.js 14+ を使用します
• TypeScript v5+ を strict モードで使用します
• Node.js 18+

原則

• React/Next.js UI には Solana Foundation の framework-kit（@solana/client + @solana/react-hooks）を使用します
• クライアント/RPC/トランザクションのコードには @solana/kit を使用します
• @solana/web3.js の PublicKey でアドレスを検証します（ウォレット UI を提供しないバックエンド専用ルートも含みます）
• ウォレットの検出と接続には Wallet Standard を使用します
• レガシー依存関係で必要な場合は、@solana/web3.js をアダプター境界内に隔離します

制約

必須

• 使用前に PublicKey.isOnCurve() でアドレスを検証します
• レガシーアダプター境界には @solana/web3-compat を使用します

推奨

• web3.js の型よりも @solana/kit の型（Address、Signer）を使用します
• 手書きの命令データよりも @solana-program/* の命令ビルダーを優先します
• ウォレットの検出と接続には Wallet Standard を使用します
• @solana/web3.js の型をアダプターモジュール内に留めます（アプリ全体に漏出させないでください）

避けること

• @solana/web3.js の型をアプリ全体に漏出させること
• 使用前のアドレス検証を省略すること

パターン

アドレス検証パターン

Solana アドレスは、使用前に必ず検証してください。

import { PublicKey } from '@solana/web3.js'

function validateSolanaAddress(address: string): boolean {
  try {
    const publicKey = new PublicKey(address)
    return PublicKey.isOnCurve(publicKey)
  } catch {
    return false
  }
}

関連スキル

• EVM フロントエンド開発では wagmi スキルを補完します
• Solana 固有の dApp 開発パターンに焦点を当てています