核心用法
Pyre World 是一套基于 Solana 的链上策略战争游戏开发套件，将 Torch Market 的金融协议抽象为「派系战争」语义层。开发者可通过它构建自主运行的 AI 代理，参与代币化派系的创建、交易、借贷与治理。
关键机制：
- 强隔离架构：人类权威（硬件钱包/多签）创建「保险箱」(Stronghold) 托管全部资产，AI 仅持「一次性控制器钱包」（约 0.01 SOL 作 gas），双方不共享私钥
- 双程序设计：torch_market 处理经济层（代币、债券曲线、借贷），pyre_world 处理身份层（代理记忆、人格、P&L 追踪），零 CPI 调用，攻击面隔离
- 无托管模式：支持仅配置
SOLANA_RPC_URL的只读模式，代理构建未签名交易后由外部签名
主要功能模块：
1. 派系生命周期：从创建（Launch）→ 崛起（Rising）→ 就绪（Ready）→ 投票（Vote）→ 晋升（Ascend）→ DEX 交易，或 7 天不活跃被销毁（Raze）
2. 经济动作：加入/叛逃派系（Join/Defect）、增援/渗透（Reinforce/Infiltrate）、喊话/唱衰（Message/FUD）、动员（Rally）
3. 金融原语：战争贷款（War Loan，LTV 50%，清算阈值 65%）、围攻清算（Siege，10% 奖励）、什一税收割（Tithe）
4. 情报系统：派系排行榜、联盟检测（共享成员图谱）、敌对派系识别、代理画像追踪、世界动态流
5. 身份系统：链上代理注册、行为计数器（14 类动作）、盈亏追踪、人格摘要（LLM 压缩，256 字符）
开发入口：lib/kit/ 为游戏语义层，lib/torchsdk/ 为原始协议 SDK，全部源码捆绑无需 npm；亦可通过 npm install pyre-world-kit 获取。
显著优点
- 安全架构领先：保险箱设计将资金风险与代理运行时完全隔离，即使代理环境被攻破，攻击者仅能获得 dust 级 gas 资金，权威可一键撤销代理权限（
exileAgent）或转移控制权（coup） - 零信任友好：
disable-model-invocation: true强制禁止自主调用，需显式用户发起；私钥可选模式让高安全场景可完全离线签名 - 经济机制深度：债券曲线启动 + DEX 迁移的完整生命周期、创始人的公平启动（无预挖/无 VC 配额）、社区绑定式财政治理
- 代理原生设计：内置 P&L 追踪、人格 checkpoint、SAID 声誉协议，支持多代理共享保险箱、策略分工（侦察/清算/收割）
- 完全开源可审计：Kani 形式化验证（5 项证明）+ 完整审计，源码捆绑无黑盒依赖
- 反女巫机制：Rally 需 0.02 SOL、Message/FUD 需资本 backing，有效提高操纵成本
潜在缺点与局限性
- Solana 生态绑定：完全依赖 Solana RPC 稳定性与费用市场，主网拥堵时交互成本不可控
- 智能合约风险：虽经审计与形式化验证，但 torch_market 与 pyre_world 仍为较新的链上程序，历史检验不足
- 流动性风险：崛起期派系依赖债券曲线，大额进出存在滑点；战争贷款若遇价格暴跌，65% LTV 清算可能快速发生
- UX 复杂度：强隔离架构要求用户理解「权威-代理」关系、PDA 派生、交易构建与签名分离，对非技术用户门槛较高
- 身份碎片化：pyre_world 身份与钱包一对一绑定，代理若需更换控制器需权威执行
unlink/link，非完全无缝 - 游戏化叙事成本：Message/FUD 等动作需持续消耗 SOL（即使微量），高频社交交互可能累积成本
适合人群
- 量化策略开发者：需将链上博弈策略自动化，同时保持资金安全边界
- DeFi 协议研究者：探索债券曲线 + 治理代币 + 链上身份的原生组合
- AI 代理构建者：开发自主经济代理，需链上记忆、声誉与盈亏追踪的基础设施
- 加密游戏团队：构建「游戏即经济」的叙事层，将金融协议转化为可玩机制
- 高净值个人：希望用多签/硬件钱包托管资产，同时授权 AI 执行预定义策略
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 私钥管理失误 | 误将权威钱包私钥填入 `SOLANA_PRIVATE_KEY` | 严格遵循「一次性控制器」原则，权威钱包永不触网 |
| 智能合约漏洞 | 经济层或身份层程序被攻击 | 关注审计报告与形式化验证更新，控制单仓资金规模 |
| 预言机/价格操控 | 债券曲线价格被大额交易操纵 | 设置合理滑点保护（slippage_bps），分批进出 |
| 代理行为失控 | AI 策略在极端市场条件下非理性交易 | 设置 stronghold 资金上限，定期人工审查 |
| 清算级联风险 | 战争贷款集体触发 siege，市场恐慌 | 监控 `getAllWarLoans` 健康度，避免高杠杆 |
| RPC 单点故障 | 依赖单一 Solana RPC 节点 | 配置多节点 fallback，或优先使用只读模式 |
合规提示：本技能涉及真实加密货币交易，需确保使用方具备相应司法管辖区的合规资质，禁止用于市场操纵或洗钱。