mcpField
S
solana-v1

solana-v1

github.com/blockmatic开发1221 次安装5 周前更新
代码仓库

关于 solana-v1

solana-v1 是用于使用 React 或 Next.js 开发 Solana dApp 界面的技能。它侧重钱包连接、地址验证和交易流程，并采用 Solana 专用库与模式。

主要功能

  1. 01React 和 Next.js 的 Solana dApp UI 模式
  2. 02使用 Wallet Standard 发现并连接钱包
  3. 03使用 PublicKey 验证地址
  4. 04构建、发送并确认交易
  5. 05Solana 客户端与 RPC 库使用指导

适用场景

  1. 01构建 Solana dApp 界面
  2. 02实现钱包连接与签名流程
  3. 03使用前验证地址
  4. 04创建交易提交与确认流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/blockmatic/basilic-skills --skill solana-v1

安装后在 Claude Code 中输入/solana-v1确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

frontend-framework-kit.md
kit-web3-interop.md
payments.md
resources.md
security.md

详细介绍

技能：solana

范围

  • 使用 framework-kit 开发 Solana dApp UI（React/Next.js）
  • 钱包连接和签名流程
  • 交易构建、发送和确认体验
  • 地址验证和交易模式

不涵盖：

  • 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+ 严格模式
  • 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
应当
  • 优先使用 @solana/kit 类型（Address、Signer），而不是 web3.js 类型
  • 优先使用 @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
  }
}

交互

  • 与 wagmi 技能互补，用于 EVM 前端开发
  • 专注于 Solana 特有的 dApp 开发模式

评论

支持 Markdown