GOVERNANCE
On-chain Governor with whitelisted actions and >50% circulating-supply quorum
GOV Tokens (NWARS)
NationWars Token (NWARS) is the on-chain governance token. It uses ERC20Votes for checkpointed voting power. Voting weight comes from delegated NWARS at the proposal snapshot, so voters should update their delegate power in the Governance modal before voting starts to make sure their voting power is current at the snapshot.
Governor Parameters
| Parameter | Value |
|---|---|
| Voting Delay | 1 day (proposals go active after 1 day) |
| Voting Period | 1 week |
| Quorum | 51% of circulating NWARS must participate. Circulating supply is total NWARS minus the NWARS held in the governance liquidity pool. |
| Hold Threshold | 300 NWARS to create a proposal (no burn) |
| Burn to Propose | Burn 10 NWARS to create a proposal (any holder) |
Whitelisted Actions
Only whitelisted function selectors can be executed via governance proposals. The Governor operates through a TimelockController.
Sanction Country
Freeze all trading for a target country for a specified duration.
Lift Sanction
Remove an active sanction from a country before its natural expiry.
Set Fee Percentage
Modify the trading fee for a specific country token (max 10%).
Execute Nuke
Trigger a governance-vote-driven nuke outside the normal epoch. Requires strong quorum.
Set Country Fee
Set a per-country staking fee override for a specific country. Overrides the default trading fee for that vault only (max 10%).
Creating Proposals
- Open the Governance modal from the top bar
- Navigate to the "New Proposal" tab
- Choose an action type and fill in the parameters
- Submit — you must either hold 300+ NWARS or burn 10 NWARS
- Proposal enters the 1-day voting delay period
- After delay, voting is open for 1 week
- If 51% circulating-supply quorum is reached and FOR > AGAINST, the proposal is queued for execution
Voting
- Before voting starts, open the Governance modal and update your delegate power so your latest NWARS balance is counted at the snapshot
- It is recommended to update delegate power periodically, especially before major proposals are submitted or start voting
- Vote FOR, AGAINST, or ABSTAIN on any active proposal
- Voting weight = delegated NWARS voting power at the proposal's snapshot time
- Each address votes once per proposal
- The owner can force-execute or cancel any proposal (emergency override)