Structs Guild
Important: Entity IDs containing dashes (like 3-1, 4-5) are misinterpreted as flags by the CLI parser. All transaction commands in this skill use -- before positional arguments to prevent this.
Procedure
- Discover guilds —
structsd query structs guild-allorstructsd query structs guild [id]. - Create guild — Requires associated reactor.
structsd tx structs guild-create TX_FLAGS -- [endpoint] [substation-id]. - Membership — Join:
structsd tx structs guild-membership-join -- [guild-id] [infusion-id,infusion-id2,...](use--player-id,--substation-idif needed). Proxy join:structsd tx structs guild-membership-join-proxy -- [guild-id] [player-id] [infusion-ids]. Invite flow:structsd tx structs guild-membership-invite -- [guild-id] [player-id]→ invitee runsstructsd tx structs guild-membership-invite-approve -- [guild-id]orstructsd tx structs guild-membership-invite-deny -- [guild-id]. Request flow:structsd tx structs guild-membership-request -- [guild-id]→ owner runsstructsd tx structs guild-membership-request-approve -- [guild-id] [player-id]orstructsd tx structs guild-membership-request-deny -- [guild-id] [player-id]. Kick:structsd tx structs guild-membership-kick -- [guild-id] [player-id]. - Settings — See Commands Reference:
guild-update-endpoint,guild-update-entry-substation-id,guild-update-join-infusion-minimum(and-minimum-by-invite,-minimum-by-request),guild-update-owner-id. All use--before positional args. - Central Bank — Mint:
structsd tx structs guild-bank-mint TX_FLAGS -- [alpha-amount] [token-amount](no guild-id — signer's guild is used implicitly; both amounts are raw integers). Redeem:structsd tx structs guild-bank-redeem -- [guild-id] [amount]. Confiscate and burn:structsd tx structs guild-bank-confiscate-and-burn -- [guild-id] [address] [amount].
Commands Reference
| Action | Command |
|---|---|
| Create | structsd tx structs guild-create -- [endpoint] [substation-id] |
| Join | structsd tx structs guild-membership-join -- [guild-id] [infusion-ids] |
| Join proxy | structsd tx structs guild-membership-join-proxy -- [guild-id] [player-id] [infusion-ids] |
| Invite | structsd tx structs guild-membership-invite -- [guild-id] [player-id] |
| Invite approve/deny | structsd tx structs guild-membership-invite-approve/deny -- [guild-id] |
| Invite revoke | structsd tx structs guild-membership-invite-revoke -- [guild-id] [player-id] |
| Request | structsd tx structs guild-membership-request -- [guild-id] |
| Request approve/deny | structsd tx structs guild-membership-request-approve/deny -- [guild-id] [player-id] |
| Request revoke | structsd tx structs guild-membership-request-revoke -- [guild-id] |
| Kick | structsd tx structs guild-membership-kick -- [guild-id] [player-id] |
| Update endpoint | structsd tx structs guild-update-endpoint -- [guild-id] [endpoint] |
| Update entry substation | structsd tx structs guild-update-entry-substation-id -- [guild-id] [substation-id] |
| Update infusion minimums | structsd tx structs guild-update-join-infusion-minimum/minimum-by-invite/minimum-by-request -- [guild-id] [value] |
| Update owner | structsd tx structs guild-update-owner-id -- [guild-id] [new-owner-player-id] |
| Bank mint | structsd tx structs guild-bank-mint -- [alpha-amount] [token-amount] (signer's guild, raw integers) |
| Bank redeem | structsd tx structs guild-bank-redeem -- [guild-id] [amount] |
| Bank confiscate | structsd tx structs guild-bank-confiscate-and-burn -- [guild-id] [address] [amount] |
TX_FLAGS: --from [key-name] --gas auto --gas-adjustment 1.5 -y
Verification
- Guild:
structsd query structs guild [id]— members, settings, owner. - Membership applications:
structsd query structs guild-membership-application-allor by ID. - Bank collateral:
structsd query structs guild-bank-collateral-address [guild-id]— verify reserves.
Error Handling
- Insufficient infusion: Guild may require minimum infusion to join. Query guild for
joinInfusionMinimum; meet requirement or get invite (bypass). - Already member: Cannot join twice. Check
guild-membership-applicationstatus. - Mint/redeem failed: Verify guild has sufficient Alpha Matter collateral for mint; sufficient tokens for redeem.
- Permission denied: Only guild owner (or delegated address) can update settings, approve requests, mint/redeem.
See Also
- knowledge/economy/guild-banking — Central Bank, collateral, token lifecycle
- knowledge/economy/energy-market — Provider guild access
- knowledge/lore/factions — Guild politics