NATIONWARS

NATIONWARS

Docs

TOKENOMICS

Staking vaults, fees, and NWARS governance tokens

Country Vaults

Each nation has a staking vault identified by a ticker (e.g., $USA, $BRA, $JPN). Countries are created through the CountryFactory contract. Players deposit NWARS governance tokens into country vaults to build staking power and compete for influence.

Staking System

Players deposit NWARS tokens into country vaults via the CountryTrading contract. Staking power determines a country's ranking and influence in the game.

ParameterValue
Staking TokenNWARS (NationWars Token)
Deposit/WithdrawDeposit or withdraw NWARS from any country vault
Referral SystemOptional referrer address on deposit/withdraw
Trading Fee2.5% (governance-adjustable, max 10%)

Fees

  • Base staking fee: 2.5% (25/1000)
  • Referral reward: 10% of the fee goes to the referrer
  • Per-country fee overrides are possible via governance
  • Maximum fee cap: 10%

NWARS Governance Token

NationWars Token (NWARS) is the governance and staking token. It grants voting power in the on-chain Governor contract once delegated and is used to stake into country vaults. Key properties:

  • Used as voting weight in Governor proposals (standard ERC20Votes)
  • Voters should update delegate power in the Governance modal before voting starts, and periodically before major proposals, so checkpointed voting power stays current
  • Deposited into country vaults to build staking power
  • Two ways to create proposals: hold 300+ NWARS, or burn 10 NWARS
  • Voting period: 1 week, with 1-day voting delay
  • Quorum requirement: 51% of circulating NWARS, where circulating supply excludes NWARS held in the governance liquidity pool
  • Revival after nuke costs NWARS (burned)

Nuke Token Distribution

When a country is nuked, all staked NWARS is seized from its vault and redistributed:

  • 50% — Redistributed to the top country (nuke launcher)
  • 25% — Redistributed to a randomly selected country (Chainlink VRF)
  • 25% — Sent to the tax/treasury wallet