核心用法
Structs Diplomacy 是 Structs 游戏生态的权限管理中枢，提供对象级（object-level）与地址级（address-level）双重权限控制能力。核心操作包括三类权限变更模式：permission-grant-on-object 追加权限、permission-revoke-on-object 移除权限、permission-set-on-object 全量替换；地址级操作同理。多地址账户通过 address-register 实现地址与玩家绑定，需提交公钥证明与签名完成身份验证，支持 player-update-primary-address 切换主控地址。
显著优点
- 细粒度权限模型：支持按对象、按玩家、按地址三维授权，满足复杂协作场景
- 多地址账户体系：单个玩家可绑定多个地址，实现热冷钱包分离与权限隔离
- 加密证明机制：地址注册强制要求 pubkey + signature 双因素验证，防冒用
- 链上可查询性：所有权限关系可通过
permission-by-object/player实时审计 - 原子化操作：Set 模式确保权限状态一致性，避免增量累积导致的权限漂移
潜在缺点与局限性
- 无批量操作接口：单个对象/地址需逐条执行，大规模权限管理效率受限
- 证明生成门槛：地址注册需外部工具生成有效签名，增加新用户学习成本
- 权限继承不明：文档未说明对象间权限继承关系，复杂场景需人工梳理
- 撤销不可逆风险：
address-revoke直接切断地址关联，无冷却期或回收机制 - gas 成本敏感：
--gas auto配合 1.5 倍调整在链上拥堵时可能产生意外费用
适合人群
- 游戏公会/DAO 管理员：需将特定对象操作权下放给成员
- 多钱包用户：希望统一管理多个地址的游戏身份
- 开发者构建自动化工具：需程序化权限分配与地址注册
- 安全敏感型玩家：追求地址隔离与最小权限原则
常规风险
- 权限过度授予：Grant 的累加特性易导致权限膨胀，建议定期审计
permission-by-player - 证明私钥泄露：地址注册证明签名若被截获，攻击者可恶意绑定地址
- 主地址单点故障：primary address 变更后旧地址立即失效，需确保新地址可控
- 对象 ID 失效：操作前务必通过 query 确认对象存在，避免交易失败损失 gas