Star Atlas terms
Terms as this SDK uses them. Game vocabulary is checked against the game; Solana vocabulary is deliberately kept to the minimum you need.
SAGE — the part of Star Atlas where fleets fly, mine, craft, and trade. The SDK reads SAGE state.
C4 — the current generation of SAGE. Runs on its own program with its own account layouts; earlier generations are not compatible.
z.ink — the public test realm SAGE C4 runs on. A separate network from Solana mainnet.
Profile — a player’s on-chain identity. Created by the player, so there is no way to derive it from a wallet address; it has to be discovered or supplied.
Character — a profile’s presence inside SAGE. Owns fleets and accrues progress. One per profile.
Fleet — a group of ships travelling together. Ships move as fleets, never individually. A fleet has a state: docked, in transit, mining, and so on.
Starbase — a station where fleets dock, trade, and craft. Shared starbase data belongs to the world; a player’s own state at a starbase is separate.
Council Rank — a player’s account-wide progression level, raised through XP. Rising ranks unlock research, larger ships, additional fleets, and buildings.
XP — progression points earned per activity category (pilot, mining, crafting, combat, and so on). Levels are judged against the game’s thresholds, and research spends XP back out.
Research node — one unlockable in the research tree. It costs XP from specific categories, ATLAS, and sometimes resources; activating it grants its perk.
Perk — the permanent improvement a research node grants: a larger fleet limit, faster warp, cheaper crafting, and similar modifiers. Everything in effect for a character sums into one bundle of values.
Warp lane — a system-to-system link, and the third way a fleet travels (after subwarp and coordinate warp). Lanes define which systems neighbour each other, work only when both ends are held by the same faction, and charge an ATLAS toll keyed to the starbase level.
Claim stake — a deployable claim on a planet or other body: a hub to build extraction, processing, power, and storage infrastructure on, yielding resources over time.
Crafting hab — a player-owned production facility deployed at a starbase. Recipes run in it, and its buildings and modifiers set production speed and efficiency.
Recipe — the crafting rule: these inputs become that output, taking this long. Recipes are game data, the same for everyone.
Crafting process — one recipe executing in one crafting hab: a lifecycle with a start, a duration, and an end.
Rent — the ongoing cost of keeping a crafting hab or claim stake deployed. A balance that runs dry eventually means eviction.
ATLAS — the in-game currency used for rewards and market settlement.
Faction — one of the three allegiances: ONI, MUD, and Ustur. Affects standing, economics, and diplomacy.
Solana
Section titled “Solana”Account — a slot of on-chain storage with an address, an owning program, and raw bytes. Everything the SDK reads is an account.
Address — the identifier for an account. The SDK uses the Address type
from @solana/kit.
Program — deployed on-chain code. SAGE C4 is one program, and it owns the accounts the SDK reads.
RPC endpoint — a server that answers questions about the chain. You supply one; see setting up your RPC.
PDA — an address derived deterministically from known inputs rather than stored. When an account has one, it can be computed instead of searched for. Several SAGE account types do not have one, which is why some lookups need discovery.
Discriminator — the leading bytes identifying an account’s type. The SDK checks it before decoding, so a wrong account fails cleanly.