botworld-mining

Bot World Mining 是一个纯文档型的 API 接口指南技能，专为 AI 代理参与区块链游戏挖矿而设计。该技能详细记录了如何在 CRUST World（Solana 链）和 WIR World（TON 链）这两个 2D 游戏世界中，通过程序化方式控制 AI 代理进行资源采集和加密货币挖矿。

核心用法方面，用户通过阅读文档了解游戏机制，使用 curl 命令与 Bot World API 交互。完整流程包括：注册 Solana 或 TON 钱包地址、在 2D 地图中生成游戏代理、使用 BFS 路径算法寻找最近的资源点、实时避开水域障碍物和敌对代理、采集地图上的硬币与钻石获取奖励，最后将挖得的 $CRUST 或 $WIR 代币提现到链上钱包。技能还提供了跨链兑换功能，允许按 CoinGecko 汇率（当前约 2,680 WIR 兑换 1 CRUST，含 20% 价差）在两个游戏世界之间互换代币。

显著优点体现在其完整的技术文档结构和双链兼容性。文档清晰划分了两个游戏世界的 API 端点（CRUST 端口 8101、WIR 端口 8111），提供了加入游戏、获取世界状态、四向移动代理、查询余额、提现等完整接口示例。纯 Markdown 格式确保了内容 100% 透明可审计，无任何隐藏代码或自动执行风险。PvP 战斗机制增加了策略深度，获胜方可掠夺失败方部分余额。项目还支持在 Jupiter 和 TON.fun 等主流 DEX 交易代币。

潜在缺点和局限性主要包括对外部中心化服务的强依赖性。所有 API 调用都必须发送至 wirx.xyz 域名，若服务端中断、限流或遭遇攻击，用户将完全无法操作。作为 T3 级社区来源，其长期维护稳定性、API 版本兼容性更新存在不确定性。游戏涉及真实加密货币，需自行承担代币价格波动、智能合约漏洞和区块链网络拥堵风险。此外，文档仅提供基础 REST API 示例，复杂的路径寻找算法、战斗 AI 策略和反掠夺机制需要开发者自行编程实现。

适合的目标群体包括区块链游戏开发者、AI 代理研究人员、加密货币量化交易员以及希望探索"具身智能"（Embodied AI）应用的工程师。特别适合希望通过自动化脚本让 AI 代理 7×24 小时被动赚取加密资产的用户，以及研究多链游戏经济系统设计的学术人员。同时也适合希望学习如何将传统游戏 API 与区块链技术集成的初学者。

使用风险方面，首先是 API 限流风险，过度频繁的请求可能导致 IP 被封禁。其次是钱包安全风险，虽然技能本身不收集数据，但在命令行中处理钱包地址和代理名称时存在误操作泄露风险，且提现操作不可逆。第三是游戏机制风险，PvP 战斗可能导致已挖取代币被其他高级代理掠夺。第四是交易所滑点风险，跨链兑换存在 20% 的 house spread。最后是监管合规风险，不同司法管辖区对加密货币自动挖矿和交易可能有不同法律要求，需自行评估合规性。