Planets and staking
A planet is a record, a treasury and a DAO. Staking TLM to one is the act that makes it matter.
The contracts involved
| Contract | Role |
|---|---|
federation   | Users, avatars and terms acceptance. |
plnts.worlds | Planet records, map coordinates, stake totals. |
stake.worlds | Locks TLM against a planet and issues its voting token. |
token.worlds | The planet voting tokens — receipts for locked TLM. |
The federation account now exposes only four actions. Planet management, staking and claims all
moved to the contracts above. Older material describes them as Federation actions — see the
Federation reference page
for the full mapping of what moved where.
Staking, step by step
Staking is a two-step interaction, because the deposit arrives as a token transfer:
Both steps can be sent in one transaction, which is the recommended approach: if the stake fails, the transfer rolls back with it and the player is never left with an unallocated deposit.
Unstaking reverses it: the voting token is burned via token.worlds::burn and the underlying TLM
is released. stake.worlds::withdraw takes back
deposits that were transferred in but never staked.
The planet token is not a second currency
It is worth being explicit, because the two-token description misleads people: the planet token is a receipt for TLM you have locked behind that planet. It is minted only when TLM is locked, burned when that TLM is released, and its only real use is voting. TLM remains the only thing of value.
So one act has two effects:
| Effect | Consequence |
|---|---|
| Economic | Your TLM is locked behind the planet, raising its stake total and so its share of daily inflation. |
| Political | While it is locked, you hold voting weight in that planet's DAO. |
This coupling is intentional: the people who commit value to a planet are the people who govern it, and a vote costs you the liquidity of the TLM behind it. It also means vote weight can be computed from token balances — see DAO governance for how that is observed, and how a DAC can override the calculation.
Planet records
Planets are rows, created and maintained by administrative actions on the planets contract:
plnts.worlds::addplanet,
plnts.worlds::updateplanet,
plnts.worlds::removeplanet and
plnts.worlds::setmap.
The map is a coordinate-to-NFT mapping in
plnts.worlds::maps — land parcels are NFTs placed at
map positions, which is what ties the mining geography to the
NFT collection.
Users belong to the Federation
Player identity stays on the Federation contract:
federation::setavatar,
federation::settag and
federation::agreeterms. Terms acceptance is
recorded per user with the version and hash of the terms they agreed to, in
federation::userterms.