Godot Solana SDK

📌 Skill基础信息

Skill名称：godot-solana-sdk

简称：Godot Solana SDK

来源：社区第三方（Virus-Axel）

运行宿主：Claude-Code CLI

核心定位：为Godot 4游戏引擎提供完整的Solana区块链集成能力，使开发者能够在游戏中直接处理加密货币交易、NFT铸造和智能合约交互。

🧩 内部核心组成

核心能力模块

SolanaClient：底层RPC客户端，处理与Solana网络的HTTP/WebSocket通信
Transaction：交易构建、签名和发送的全流程管理
WalletAdapter：浏览器和移动端钱包集成（Phantom、Solflare、Backpack等）
各类Program节点：系统程序、代币程序、关联代币账户程序等标准协议实现
Metaplex扩展：Candy Machine v3、Token Metadata等NFT相关功能

核心资源类型

资源类型	功能描述
Pubkey	Solana公钥/地址的32字节表示
Keypair	ed25519密钥对，用于交易签名
Instruction	单条交易指令
AccountMeta	指令中的账户元数据

🛠 安装与启用方式

关键步骤：

通过Godot资源库安装：在编辑器中搜索"Solana"并安装到项目addons/目录
启用插件：Project → Project Settings → Plugins → 启用SolanaSDK
自动加载：SolanaService会自动添加为autoload单例
配置RPC集群：在SolanaService检查器中选择主网或开发网，或提供自定义RPC URL

前置依赖：

Godot 4.0或更高版本
有效的Solana RPC端点（默认使用公共端点，建议配置私有RPC如Helius）

📋 标准工作流

初始化配置：通过SolanaService单例设置网络集群和RPC端点
密钥管理：使用Keypair生成或导入钱包密钥（测试用生成密钥或导入外部钱包）
交易构建：

- 创建Transaction节点并添加到场景树

- 设置支付方(set_payer)

- 添加指令(add_instruction)

- 更新最新区块哈希(update_latest_blockhash)

签名发送：

- 本地签名(sign)或通过WalletAdapter触发钱包弹窗

- 发送交易(send)

状态监听：

- 等待交易响应(transaction_response_received)

- 监听确认状态(confirmed/finalized信号)

⚠️ 关键限制、缺陷、注意事项

安全警告：

主网使用尚未经过安全审计，存在资金被盗风险
生成的确定性钱包仅限测试使用，不适合生产环境

平台限制：

WalletAdapter主要针对Web/浏览器平台，桌面和移动端需要额外适配
iOS和Android平台需要特殊配置和权限处理

性能考虑：

RPC调用会产生网络延迟，不适合实时性要求极高的游戏场景
交易确认时间受Solana网络状态影响，需要设计适当的异步处理机制

开发限制：

仅支持Godot 4，不兼容Godot 3.x
需要一定的区块链开发知识，不适合完全新手

✅ 适用场景 & ❌ 不适合场景

适用场景：

Godot游戏内集成加密货币经济系统
区块链游戏(Web3游戏)开发
NFT收集和交易类游戏
需要链上数据验证的游戏应用
教育类区块链演示项目

不适合场景：

对交易确认时间有严格实时要求的游戏
高频率小额交易的应用场景
安全要求极高的金融应用
无区块链知识的传统游戏开发
Godot 3.x项目迁移

如何安装

skills install --user Virus-Axel/godot-solana-sdk

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

⚠️ 中风险：需留意隐私

本 Skill 涉及读取隐私 / 敏感信息（如密钥、环境变量、凭据）。安装前请确认其用途是否必要。

检测到隐私/敏感信息读取（预设模式 #12）

命中检测项

privacy_collect