Guild skill: join, ranks, Central Bank

A guild is your faction: it gives you a reactor to infuse, a substation to draw power from, a market to sell into, a token to mint, and allies (or moderators). For a new player, which guild you join is one of your most consequential early choices — it shapes your power source, your economy, and who has your back. This skill covers choosing/joining, running a guild, ranks/permissions, identity moderation, and the Central Bank.

Conventions (TX_FLAGS, -- rule, charge bar, one-tx-at-a-time) are in conventions.md.

When to use it

• New player deciding which guild to join (or whether to go solo).
• Creating or administering a guild.
• Managing members, ranks, or moderating member identity.
• Minting/redeeming guild tokens or managing Central Bank collateral.

Decisions

Choosing a guild (beginner) — evaluate candidates on:

• Reactor commission — lower = more capacity per gram you infuse (structsd query structs reactor [id]).
• Join requirements — joinInfusionMinimum you must meet (or get an invite to bypass).
• Activity & size — guild-all then inspect members; an active guild means a working market and defenders.
• Token economy — a guild whose token is actually used (providers priced in it) makes your earnings liquid.
• Politics — see knowledge/lore/factions and your standing-orders. Joining a guild at war inherits its enemies.

A guild is rarely a trap, but its moderators gain reach into your name/pfp while you're a member (see UGC below). If you dislike a policy, you can leave.

Creating a guild (advanced) is either the chain-global charter PoW (guild-create-compute, weeks for a lone miner) or a one-time reactor entitlement (guild-create without proof: bonded validator past ~30 days, PermReactorGuildCreate on the reactor). A founder who owns a guild must transfer it first. Founding leaves your current guild if you are only a member. Third-party solvers need guild-charter-consent. See hashing.md — Guild Charter.

Rank system

Numeric ranks, lower number = higher privilege:

A player can only modify members whose rank is strictly worse (higher number) than their own. Rank-permissions (granting a permission to everyone at/above a rank) are the scalable way to delegate — see structs-permissions.

Procedure

Join

1. Discover: structsd query structs guild-all, then guild [id] and reactor [id] for the candidates.
2. Meet the infusion minimum (or secure an invite). Join:

   structsd tx structs guild-membership-join TX_FLAGS -- [guild-id] [infusion-id,...]
   

   You get the default entry rank (101). Flows: invite (guild-membership-invite → invitee ...-invite-approve/-deny), request (guild-membership-request → owner ...-request-approve/-deny), proxy (a guild signs you in: guild-membership-join-proxy -- [address] [proof-pubkey] [proof-signature], with optional --substation-id, --player-name, --player-pfp, --player-pfp-client-render-attributes).

Administer

• Ranks: player-update-guild-rank TX_FLAGS -- [player-id] [rank] (needs PermAdmin or rank authority); guild-update-entry-rank TX_FLAGS -- [rank] (new rank ≥ your own).
• Membership: guild-membership-kick -- [player-id] (the guild is implicit in the target player); invite/request approve/deny/revoke as above.
• Settings: guild-update-endpoint, guild-update-entry-substation-id, guild-update-join-infusion-minimum (+ -by-invite/-by-request; unknown bypass-level values are denied), guild-update-owner-id (Tier 2 — transfers the guild). Invite/request approve and accept require a pending application — they do not create one.
• Founding: entitlement guild-create -- [reactor-id] [endpoint] [entry-substation-id] or charter guild-create-compute -D 3 (query guild-charter first). Third-party solver: guild-charter-consent then proof-path create.

UGC moderation

Structs has no global moderator — each guild sets its own name/pfp standards for member-owned objects, and the chain emits an audit event on every override. Grant moderation by rank (recommended) or per player:

# Members at rank 5 or better can moderate guild-mate UGC
structsd tx structs permission-guild-rank-set TX_FLAGS -- [guild-id] [guild-id] 16777216 5
# Or a single moderator on the guild object
structsd tx structs permission-grant-on-object TX_FLAGS -- [guild-id] [moderator-player-id] 16777216

Perform a moderation: player-update-name/player-update-pfp/planet-update-name/substation-update-name/substation-update-pfp TX_FLAGS -- [target-id] "value". When the actor isn't the owner, the chain emits ugc_moderated (actor, target, field, old/new) — audit it. Note pfpClientRenderAttributes is owner-only and not guild-moderatable. Full philosophy + validation: knowledge/mechanics/ugc-moderation.

Central Bank (mint / redeem / convert)

• Mint tokens against Alpha collateral: guild-bank-mint TX_FLAGS -- [alpha-amount] [token-amount] (signer's guild implicit; raw integers; ratio captured at action time). Guild-privileged.
• Redeem tokens for Alpha: guild-bank-redeem TX_FLAGS -- [amount]uguild.[guild-id] [min-amount-alpha] — coin string plus Alpha slippage floor. Payout is floor(amount * collateral / supply) but still rejected if that payout is below min-amount-alpha.
• Convert ualpha into an existing guild token at the live collateral ratio: guild-bank-convert TX_FLAGS -- [guild-id] [alpha-amount] [min-amount-token]. Needs PermTokenTransfer on the signer. Convert-in fee stays in collateral. min-amount-token is the slippage floor.
• Convert token → token: guild-bank-convert-token TX_FLAGS -- [amount]uguild.[source-id] [target-guild-id] [min-amount-token] — redeems the source then converts into the target in one tx; both guilds keep their fees.
• Confiscate & burn (Tier 2 act of war, audited forever): guild-bank-confiscate-and-burn TX_FLAGS -- [amount]uguild.[guild-id] [address] — token amount first, then the address it is taken from. The destination of a uguild.* send must be a registered player, the structs module, or an indexed provider pool — not IBC.

Mint/redeem are Tier 1 within your standing-order caps, Tier 2 above. Convert is the open market path. Economics: knowledge/economy/guild-banking.

Commands reference

TX_FLAGS per conventions.md. Requires structsd on PATH and a signing key.

Verification

• structsd query structs guild [id] — members, settings, owner.
• structsd query structs guild-charter — global charter anchor and difficulty.
• guild-membership-application-all — pending invites/requests.
• guild-bank-collateral-address [guild-id] — reserves.
• guild-rank-permission-by-object-and-guild [object-id] [guild-id] — rank-based access.

Errors

• Insufficient infusion — meet joinInfusionMinimum or get an invite (bypasses it).
• is_owner — you own a guild; transfer it before founding another.
• under_raid — not a guild error; see production.
• Already member — founding leaves your current guild if you are only a member; you cannot join twice.
• Invite/request approve with no pending application — membership approval requires an existing application.
• Mint/redeem/convert failed — insufficient Alpha/tokens, or min-amount-token slippage missed.
• recipient_not_eligible — uguild.* cannot go to IBC escrow or an unregistered address.
• Permission denied / rank too low — need PermAdmin or strictly-better rank; entry rank can't exceed your own.

See also

• knowledge/economy/guild-banking — Central Bank, collateral, token lifecycle
• knowledge/mechanics/permissions — 25-bit values, guild rank permissions
• knowledge/mechanics/ugc-moderation — name/pfp moderation & validation
• knowledge/lore/factions — guild politics
• playbooks/situations/guild-war — coordinated conflict; structs-permissions — delegating authority