Structs Economy

Procedure

1. 1. Assess position — Query player, reactor, provider, agreement state via structsd query structs player/reactor/provider/agreement [id].
2. Reactor staking — Stake Alpha Matter: structsd tx structs reactor-infuse [player-address] [reactor-address] [amount] TX_FLAGS. The amount must include the denomination, e.g. 60000000ualpha (not just 60000000). This automatically increases the player's capacity — no allocation setup needed. The reactor's commission rate determines the split: player receives power * (1 - commission), reactor keeps the rest. Unstake: reactor-defuse [reactor-id] (cooldown applies). Cancel cooldown: reactor-cancel-defusion [reactor-id]. Migrate: reactor-begin-migration [player-address] [source-validator-address] [dest-validator-address] [amount].
3. Generator infusion — structsd tx structs struct-generator-infuse [struct-id] [amount] TX_FLAGS. IRREVERSIBLE — Alpha cannot be recovered. Higher conversion rates than reactors (2-10x) but generator is vulnerable to raids.
4. Provider lifecycle — Create: provider-create [substation-id] [rate] [access-policy] [provider-penalty] [consumer-penalty] [cap-min] [cap-max] [dur-min] [dur-max] TX_FLAGS. Valid access-policy values: open-market (anyone can buy), guild-market (guild members with sufficient rank can buy -- managed via guild rank permissions on the provider), closed-market (only players with explicit PermProviderOpen on the provider). Update capacity/duration/access via provider-update-capacity-maximum, provider-update-duration-minimum, etc. Delete: provider-delete [provider-id]. Withdraw earnings: provider-withdraw-balance [provider-id]. To grant guild members access to a guild-market provider: permission-guild-rank-set [provider-id] [guild-id] 262144 [rank] (PermProviderOpen).
5. Agreements — Open: agreement-open [provider-id] [duration] [capacity] TX_FLAGS. Close: agreement-close [agreement-id]. Adjust: agreement-capacity-increase/decrease, agreement-duration-increase.
6. Allocations — Create: allocation-create [source-id] [power] --allocation-type static|dynamic|automated TX_FLAGS. The --controller flag accepts a PlayerId (e.g., 1-42). If omitted, the creating player is the default controller. Update: allocation-update [allocation-id] [new-power]. Delete: allocation-delete [allocation-id] — only the controlling player can delete an allocation. Transfer: allocation-transfer [allocation-id] [new-controller].

Allocation Type Comparison

Automated allocation limit: Only one automated allocation per source is allowed. Attempting to create a second from the same source will error. Use dynamic type if you need multiple allocations from one source.

Recommended for energy sales: Use automated allocations. When you infuse more alpha into a reactor, your capacity grows, and automated allocations proportionally increase energy flowing to your substations with no manual intervention.

1. 7. Token transfer — player-send [from-address] [to-address] [amount] TX_FLAGS.

Commands Reference

TX_FLAGS: INLINECODE53

Important: Entity IDs containing dashes (like 3-1, 4-5) are misinterpreted as flags by the CLI parser. Always place -- between flags and positional args: INLINECODE57

Verification

• - Reactor: structsd query structs reactor [id] — check infusedAmount, defusionCooldown.
• Provider: structsd query structs provider [id] — verify capacity, rate, active agreements.
• Agreement: structsd query structs agreement [id] — check status, capacity, duration.
• Allocation: structsd query structs allocation [id] — confirm power, source, destination.
• Player balance: structsd query structs player [id] — verify Alpha Matter after transfers.

Error Handling

• - Insufficient balance: Check player Alpha Matter before infuse/send. Refine ore first.
• Provider capacity exceeded: Query provider capacityMaximum; reduce agreement capacity or create new provider.
• Defusion cooldown: Use reactor-cancel-defusion to re-stake during cooldown, or wait.
• Generator infuse failed: Cannot undo. Verify struct is a generator type and amount is correct before submitting.

See Also

• - structs-energy skill — "I need more energy" decision tree and workflows
• knowledge/economy/energy-market — Provider/agreement flow, pricing
• knowledge/economy/guild-banking — Central Bank tokens
• knowledge/mechanics/resources — Alpha Matter, conversion rates
• knowledge/mechanics/power — Capacity, load, online status