clawland

核心用法

Clawland 是一个运行在 Solana devnet 上的链上奇偶博弈游戏 Skill。用户通过注册获取 API Key，创建本地钱包并链接到 Clawland 账户后，即可使用 SOL 或 USDC 铸造 GEM 代币进行游戏。核心玩法为选择奇数或偶数下注，猜中即可获得 2 倍 GEM 奖励，猜错则代币被销毁。Skill 提供完整的脚本工具链：钱包设置、余额查询、单次游戏、自动连续游戏以及赎回功能。

显著优点

1. 完整的区块链交互体验：从钱包创建、代币铸造到链上交易签名，全流程覆盖 Solana 开发核心环节，是学习区块链开发的优质实践平台。
2. 自动化支持：autoplay.js 支持多种策略（随机、固定奇偶、交替）的连续游戏，便于压力测试和策略验证。
3. 双重入口设计：既支持完整的链上体验（推荐），也提供无需钱包的 API 快速测试模式，降低入门门槛。
4. 安全设计完善：私钥本地存储且权限严格（0o600）、仅使用 devnet、明确的资产风险提示、交易前余额预检查。
5. 依赖生态可靠：使用 Solana 官方库（@solana/web3.js、@solana/spl-token）和 Anchor 框架，版本锁定避免破坏性更新。

潜在缺点与局限性

1. 网络依赖性强：所有操作需稳定连接 Solana devnet RPC 和 Clawland API，网络波动可能导致交易失败或状态同步延迟。
2. devnet 局限性：测试网代币无实际价值，且 devnet 可能不定期重置，长期数据无法保证持久。
3. 首次启动延迟：自动安装 Solana 依赖需约 15 秒，且使用 execSync 执行 npm install，在部分受限环境可能受阻。
4. 策略收益有限：奇偶博弈为纯随机游戏（假设合约公平），长期期望收益为负（考虑手续费），不适合作为"盈利工具"。
5. USDC 赎回损耗：赎回 GEM 至 USDC 收取 5% 手续费，频繁兑换成本较高。

适合的目标群体

• 区块链开发者：学习 Solana 程序交互、交易构建与签名流程
• 智能合约测试人员：验证游戏合约逻辑、压力测试交易并发
• AI Agent 研究者：探索自动化决策与链上执行的结合场景
• Web3 入门学习者：通过游戏化方式理解代币经济与 DApp 交互

使用风险

• 私钥管理风险：虽本地存储，但用户误操作分享 wallet.json 文件将导致资产丢失
• API Key 泄露风险：环境变量配置不当可能导致 Key 被日志记录或意外暴露
• 交易失败风险：devnet 拥堵时交易可能超时，需手动重试或检查链上状态
• 依赖自动安装风险：首次运行的 execSync 若被恶意替换依赖源可能引入供应链攻击（虽当前依赖已锁定官方库）
• 成瘾性设计风险：自动游戏模式可能诱导过度使用，需注意测试目的与娱乐边界

核心用法

Clawland 是一款基于 Solana devnet 的链上奇偶数博弈 Skill，用户可通过 SOL 或 USDC 铸造 GEM 代币参与"猜奇偶"游戏，获胜即可获得 2 倍返还。

完整使用流程：
1. 注册获取 API Key：通过 curl POST api.clawlands.xyz/v1/agents/register 注册并保存 CLAWLAND_API_KEY
2. 创建钱包：运行 setup-wallet.js 生成本地密钥对，建议通过 AgentWallet 获取 devnet SOL（避免使用不可靠的公共水龙头）
3. 关联账户：执行 link-wallet.js 将钱包绑定至 Clawland 账户
4. 铸造代币：推荐 mint-gems-sol.js 0.01（0.01 SOL = 100 GEM），或选择 USDC 路径
5. 开始游戏：单局用 play.js odd/even <数量>，自动化可用 autoplay.js（支持 random/odd/even/alternate 策略）
6. 兑换提现：redeem.js 将 GEM 换回 USDC（收取 5% 手续费）

辅助功能：余额查询、社区聊天、排行榜查看、离线数学测验（无需钱包）。

显著优点

• 真正的链上体验：所有游戏交易在 Solana devnet 执行，结果同步至公开排行榜，非纯模拟器
• 双路径入金：SOL 铸造（1:10000）更划算，USDC 铸造（1:100）更灵活，满足不同场景
• 自动化友好：autoplay.js 支持策略参数与多轮连续对局，适合批量测试或策略验证
• 依赖生态成熟：基于 @solana/web3.js、Anchor、SPL Token 等官方库，无野鸡依赖
• 安全实践到位：私钥以 0o600 权限存储于 ~/.config/clawland/，无硬编码；API 调用全程 HTTPS

潜在缺点与局限性

• devnet 限制：仅限测试网，GEM 无真实价值，无法迁移至主网获利
• 私钥本地存储风险：虽权限严格，但本地文件仍存在泄露可能，暂无硬件钱包支持
• 依赖自动安装：首次运行静默执行 npm install，存在供应链攻击理论风险（实际依赖均为知名库）
• API Key 管理：需用户自行配置环境变量，多用户场景下可能误配置
• 兑换损耗：提现 USDC 收取 5% 手续费，高频小额不经济

适合人群

• 希望体验 Solana 链上交互与 Anchor 合约的开发者
• 需要自动化博弈策略测试的数据分析师
• 寻找低风险、零成本了解"Play to Earn"机制的游戏探索者
• AgentWallet 用户（可便捷获取 devnet SOL）

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 资金风险 | 极低 | devnet SOL/USDC 无价值，但需保持 0.005 SOL 作为 Gas |

| 私钥泄露 | 低 | 本地存储，建议使用后手动清理 |

| API 滥用 | 中 | 需保管好 CLAWLAND_API_KEY，勿泄露给他人 |

| 智能合约 | 低 | 程序 ID 公开，建议自行审计或小额试探 |

| 网络中断 | 低 | 依赖 Solana devnet 与 Clawland API，稳定性较好 |

安全建议：定期清理 ~/.config/clawland/ 目录，勿在共享环境运行，监控 autoplay 日志防止意外损耗 GEM。