Galaxy King Dog / Supporting design document

Galaxy King Dog — Whitepaper Implementation Lock v1.7

Locked date: 2025-12-17
Source: Galaxy King Dog Whitepaper v1.6 + v1.7 addendum. The addendum is authoritative where season/supply notes conflict.

v1.8 addendum (implemented). Two clarifications now reflect the built program — see WHITEPAPER.md:

  • Entry fee: targets $0.10 and is re-pegged weekly from a Pyth SOL/USD feed (permissionless crank). 270,000 lamports below is the bootstrap value / dust floor, not a fixed price; the 2/3 multisig may override but can never withdraw pool funds.
  • Trust model: the on-chain score is enforced by the verifier's ed25519 signature (Ed25519 precompile) over the ledger-accepted score, not by independent replay. Full bit-for-bit resimulation remains a future hardening (see the verifier-mode note below).

Implemented in repo

  • src/chain/gkd_whitepaper_spec.js is the canonical implementation constants file.
  • src/chain/chain_config.js reads the locked spec for token, creator wallet, season, split, fee, and pool context.
  • index.html loads the spec before chain config and chain client.
  • verifier/test_whitepaper_spec.js locks the constants with tests.

Locked chain constants

  • Token: $420POP
  • Decimals: 9
  • Devnet creator wallet: 8qCpYyRjdG8Y1jW5fu77XZ3qkWErgABhscEuuY4mRjnr
  • Mainnet creator wallet: unset until the audited mainnet deployment is initialized
  • Game Pool target: program-owned PDA, seed pool
  • Human emission ends at Season 32
  • Season 33 is Chaos
  • Chaos cap: 300,000 $420POP
  • Initial fee floor: 270,000 lamports

Locked proof-of-play fields

The browser run package and verifier already use schema 2 with:

  • player_pubkey
  • fee_lamports
  • entry_sig
  • entry_slot
  • final_score
  • season_id
  • replay_hash
  • version_hash
  • run_hash
  • checkpoint_chain_final
  • last_checkpoint

Verifier mode remains schema2_hash_checkpoint until full Phaser-identical strict resimulation is implemented.

Locked split rules

  • Creator payout auto-split: 49% creator wallet / 51% Charity Pool.
  • Charity Pool donation recycle: 20% back to Game Pool.
  • Farm season end: 70% retained / 20% season winner / 10% creator payout.
  • World record break: 70% retained / 20% record breaker / 10% creator payout, paid on every world-record break.
  • Human season end: 30% carried to Chaos / 40% Human Champion / 30% creator payout.
  • Chaos end: 67% Chaos Champion / 33% creator payout.

Locked governance

  • Charity vote only twice: end Human emission and end Chaos.
  • Eligibility: farmed at least one $420POP.
  • Quorum: 10,000 votes.
  • Duration: 99 days.
  • Tie: re-vote.
  • Failed quorum: funds remain in Charity Pool.
  • Chosen operator must be a whitelisted verified charity organization.

Locked NFT file names

  • baby_metatron.png
  • season_champion_metatron.png
  • record_breaker_metatron.png
  • human_metatron.png
  • final_galaxy_metatron_defender.png

Local check

Run:

cd "C:\Users\spirc\Desktop\dogww"
node verifier/test_whitepaper_spec.js
npm.cmd run test:verifier