KMS Bridge

KMS is the in-game currency you earn by selling resources at the Central Market. It is also a real token on Arbitrum One — meaning you can link a crypto wallet and move KMS between your game account and your wallet using the KMS Bridge.

This page explains the player-facing side: what KMS is, how to deposit and withdraw, and the process that governs the bridge.

What KMS Is

  • KMS is earned exclusively through the in-game market: you sell Metal, Carbon, or Hydrogen for KMS; you buy resources by spending KMS.
  • KMS is stored on your player account, not on any planet. It is never produced by mines and never appears as loot.
  • KMS is a high-precision token — the same fractional resolution as Ether. The game handles all arithmetic at full precision; the UI rounds for display.
  • The in-game KMS economy is a closed loop: the total amount in circulation is conserved. There is no automatic KMS income from buildings, time, or score.

Before you can deposit or withdraw, you must link a crypto wallet to your Kosmaris account. The link uses a one-time challenge: you sign a message in your wallet to prove ownership of the address. Once linked, your wallet address is associated with your account.

Changing your linked wallet triggers a multi-day timelock. Your existing wallet remains active during the wait; the new one takes over when the timelock expires. This delay protects you if your wallet is ever compromised — an attacker cannot silently redirect your withdrawals.

The wallet-link challenge expires after a short window. If it times out, start again.

Deposits (Wallet → Game)

To add KMS to your game balance, you deposit on-chain KMS into the bridge's stash contract on Arbitrum One:

  1. In the game UI, generate a deposit intent — a short-lived authorization token.
  2. Send your KMS to the stash contract on Arbitrum One (your wallet pays the gas).
  3. The bridge detects the on-chain transaction, confirms it, and credits your in-game KMS balance.

There is no bridge fee for deposits. Gas is paid by you in ETH on Arbitrum One. The deposit intent expires after a short window; if it expires before your transaction confirms, simply generate a new one and try again.

Withdrawals (Game → Wallet)

Withdrawals move in-game KMS to your linked wallet on Arbitrum One:

  1. In the game UI, request a withdrawal of any amount.
  2. Your in-game KMS balance is debited immediately and a voucher is created with a short validity window.
  3. Submit the voucher on-chain before it expires. Your wallet pays the Arbitrum gas.
  4. The stash contract releases the KMS to your linked wallet.

If the voucher expires before you submit it, your in-game balance is automatically restored shortly after. You can then request a new withdrawal.

There is no bridge fee for withdrawals — only the Arbitrum gas you pay yourself. There is no minimum or maximum withdrawal amount imposed by the bridge, though withdrawing tiny "dust" amounts costs more in gas than they are worth.

Only one withdrawal can be in flight at a time per account. Finish or let the current voucher expire before requesting another.

Token Supply

The KMS token has a fixed maximum supply of 1,000,000,000 (1 billion) KMS. This cap is permanent — no additional KMS can ever be minted beyond it. The total supply is set in the deployed smart contract and cannot be changed after deployment.

Security Notes

  • Never share the details of any signed voucher or challenge message outside of the game UI. These are cryptographic proofs that authorize on-chain actions.
  • The multi-day wallet-change delay exists specifically to block an attacker who gains access to your game account from redirecting your withdrawals before you can react.
  • If you suspect your account is compromised, contact support immediately — the bridge has an administrative pause mechanism for emergencies.

Cross-References