Tokens

Tokens are native ledger assets. The issuer creates supply; player wallets hold and transfer it according to the asset's immutable transfer policy.

Issue a token

const gems = await game.token.issue({
  name: 'Gems',
  symbol: 'GEM',
  decimals: 0,
  maxSupply: 1_000_000,
  transfer: 'open',
  swap: 'one-way',
  rate: 100,
})

Option	Meaning
name	Human-readable asset name.
symbol	Asset symbol. Combined with the issuer address to identify the token.
decimals	Display precision.
maxSupply	Optional cap on circulating supply.
transfer	'open', 'issuer-only', or 'none'; protocol-enforced and immutable.
swap	'two-way', 'one-way', or 'off'; an issuer promise recorded on-chain.
rate	Issuer-side configuration, not an on-chain market price.

Issuance burns Kei because every asset creates permanent ledger state. Ordinary token transactions remain feeless.

Issuer methods

await gems.mint(playerAddress, 500)
await gems.burn(500)
await gems.balanceOf(playerAddress)
await gems.supply()

Player methods

const gems = await kei.token('GEM', issuerAddress)

await gems.balance()
await gems.transfer(toAddress, 120)

transfer() has no from argument. The wallet that signs the transaction is the sender.

Identity and idempotency

Token identity includes the issuer. Do not treat the symbol alone as globally unique. Issuance is idempotent for the same issuer and symbol.