Structs 经济体系

安全性

有关信任合约，请参阅 SAFETY.md。本技能中涉及的关键操作如下：

• reactor-infuse（一级操作）—— “您的 alpha 将锁定至 reactor。手续费率在注入时刻即永久确定。” 请展示验证器地址、手续费率及 ualpha 数量。
• struct-generator-infuse（二级操作 — 不可逆）—— “湮灭。证明一旦上链，物质即刻消失。详见 structs-building 文档。”
• reactor-defuse（二级操作 — 冷却锁定期）—— “启动冷却倒计时。等待期间，您的 alpha 既不在 reactor 中，也不在您的钱包内。仅可通过 reactor-cancel-defusion 干净取消。”
• reactor-begin-migration（二级操作）—— “在验证器之间迁移质押资产。请务必核对目标验证器地址 — 本系统不提供‘撤销迁移’命令。”
• player-send 向已有交易历史的接收方转账（一级操作）/ 向新地址转账（二级操作）—— “代币将从您的地址转出。目标地址若存在拼写错误，后果不可逆。”
• provider-delete、allocation-delete（二级操作 — 级联效应）—— “供电立即中断。关联的 substation 可能离线；其所属 player 也可能离线。” 详见 structs-power。

操作流程

1. 评估当前状态 —— 使用以下命令查询 player、reactor、provider 和 agreement 状态：structsd query structs player/reactor/provider/agreement [id]。
2. Reactor 质押 —— 质押 Alpha Matter：structsd tx structs reactor-infuse [player-address] [reactor-address] [amount] TX_FLAGS。其中 amount 必须包含单位标识，例如 60000000ualpha（不可仅写 60000000）。该操作 将自动提升 player 的容量上限 —— 无需额外配置 allocation。reactor 的手续费率决定收益分配：player 获得 power * (1 - commission)，其余归 reactor 所有。撤回质押：reactor-defuse [reactor-id]（适用冷却期）。取消冷却：reactor-cancel-defusion [reactor-id]。迁移质押：reactor-begin-migration [player-address] [source-validator-address] [dest-validator-address] [amount]。
3. Generator 注入 —— structsd tx structs struct-generator-infuse [struct-id] [amount] TX_FLAGS。不可逆操作 —— Alpha 无法回收。相比 reactor 具有更高转化率（2–10 倍），但 generator 易受 raid 攻击。
4. Provider 生命周期管理 —— 创建：provider-create [substation-id] [rate] [access-policy] [provider-penalty] [consumer-penalty] [cap-min] [cap-max] [dur-min] [dur-max] TX_FLAGS。合法的 access-policy 值包括：open-market（任何人可购买）、guild-market（需满足对应 guild rank 权限的公会成员方可购买 —— 权限由 provider 上的 guild rank 设置管理）、closed-market（仅对 provider 显式授予 PermProviderOpen 权限的 player 可购买）。通过 provider-update-capacity-maximum、provider-update-duration-minimum 等命令更新容量/持续时间/访问策略。删除：provider-delete [provider-id]。提现收益：provider-withdraw-balance [provider-id]。为公会成员开通 guild-market provider 访问权限：permission-guild-rank-set [provider-id] [guild-id] 262144 [rank]（即 PermProviderOpen）。
5. Agreement 管理 —— 开启：agreement-open [provider-id] [duration] [capacity] TX_FLAGS。关闭：agreement-close [agreement-id]。调整：agreement-capacity-increase/decrease、agreement-duration-increase 等。
6. Allocation 管理 —— 创建：allocation-create [source-id] [power] --allocation-type static|dynamic|automated TX_FLAGS。其中 --controller 参数接受一个 PlayerId（例如 1-42）。若省略此参数，则默认以创建者 player 为 controller。更新：allocation-update [allocation-id] [new-power]。删除：allocation-delete [allocation-id] —— 仅 controller 所属 player 可执行删除操作。转移 controller：allocation-transfer [allocation-id] [new-controller]。

Allocation 类型对比

Automated allocation 数量限制：每个 source 最多只能拥有一个 automated allocation。尝试从同一 source 创建第二个将报错。如需单 source 多 allocation，请改用 dynamic 类型。

能源销售推荐方案：使用 automated allocation。当您向 reactor 注入更多 alpha 时，您的容量随之增长，automated allocation 将自动按比例增加流向各 substation 的能源，全程无需人工干预。

7. 代币转账 —— player-send [from-address] [to-address] [amount] TX_FLAGS。

命令参考表

TX_FLAGS（交互式 — CLI 将提示您确认）：--from [key-name] --gas auto --gas-adjustment 1.5

TX_FLAGS_APPROVED（仅在 commander 批准后可用；禁用交互提示）：在 TX_FLAGS 基础上追加 -y。详见 SAFETY.md 中 “-y 规则” 部分。本技能中所有命令均为一级或二级操作，默认应使用交互模式。

前置依赖：确保 structsd 已加入系统 PATH，并已配置签名密钥。

重要提示：含短横线的实体 ID（如 3-1、4-5）会被 CLI 解析器误判为命令行标志。请始终在标志与位置参数之间插入 --：例如 structsd tx structs command TX_FLAGS -- [entity-id] [other-args]。

状态验证

• Reactor：structsd query structs reactor [id] —— 检查 infusedAmount 与 defusionCooldown 字段。
• Provider：structsd query structs provider [id] —— 核验容量、费率及活跃 agreement 数量。
• Agreement：structsd query structs agreement [id] —— 检查状态、容量与持续时间。
• Allocation：structsd query structs allocation [id] —— 确认功率值、source 与 destination。
• Player 余额：structsd query structs player [id] —— 在转账后验证 Alpha Matter 余额。

错误处理

• 余额不足：执行 infuse 或 send 前，请先检查 player 的 Alpha Matter 余额；必要时请先精炼矿石。
• Provider 容量超限：查询 provider 的 capacityMaximum；降低 agreement 容量，或新建 provider。
• Defusion 冷却中：可在冷却期内使用 reactor-cancel-defusion 重新质押，或选择等待冷却结束。
• Generator 注入失败：操作不可逆。提交前请确认结构体确为 generator 类型，且金额输入正确。

参阅

• structs-energy 技能 —— “我需要更多能源” 决策树与工作流
• knowledge/economy/energy-market —— Provider/agreement 流程与定价机制
• knowledge/economy/guild-banking —— 中央银行代币
• knowledge/mechanics/resources —— Alpha Matter 与转化率
• knowledge/mechanics/power —— 容量、负载与在线状态