Skip to main content

Country Tokens

Every country in GlobalPVP has its own ERC20 token. These tokens are the core game asset — they determine market cap rankings, voting power, and ultimately who wins.

Token Properties​

PropertyValue
StandardERC20
Total Supply1,000,000,000 (1 billion)
Decimals18
MintableNo (fixed supply)
BurnableNo
TransferableYes (standard ERC20 transfers)

Each country is identified by its ISO Alpha-2 code (e.g., US, GB, JP, BR). The token symbol matches the country code.

How Tokens Are Created​

When the game is initialized, each country token is deployed via a factory contract:

  1. Token Contract — A new CountryToken ERC20 is deployed with the full 1 billion supply
  2. Entire supply minted to NukeGame — The game contract receives all tokens
  3. Liquidity seeded — NukeGame distributes the tokens across 7 Uniswap V4 liquidity positions (the "staircase")
  4. Trading opens — Anyone can buy tokens with ETH through the swap router

No tokens are reserved for teams, airdrops, or pre-sales. 100% of the supply goes into Uniswap liquidity from day one.

The Staircase Liquidity Model​

Instead of placing all liquidity at a single price point, GlobalPVP distributes tokens across 7 price tiers (tick ranges). This creates a "staircase" bonding curve — deep liquidity at the bottom (45% of tokens in the lowest two tiers), thinning toward the top (only 12% in the highest two tiers).

The result: early buyers get favorable pricing, prices rise gradually under sustained demand, and explosive moves happen in the upper tiers during buyback events.

For a full deep dive into the bonding curve mechanics, comparisons to other models, and strategic implications, see The Bonding Curve.

Token Lifecycle​

Alive​

When a country is alive, its token:

  • Trades freely on Uniswap V4
  • Has active liquidity across all 7 positions
  • Contributes to market cap calculations
  • Can be used for voting (if that country wins the market cap race)

Nuked​

When a country is nuked:

  • All liquidity is removed from the pool
  • The nuked flag is set to true on the token contract
  • The swap router refuses buy/sell transactions
  • The token still exists and can be transferred, but has no market
  • Holders are left with worthless tokens unless they sold before the nuke
warning

Once a country is nuked, there is no way to recover its liquidity. The token is permanently dead. Always be aware of which countries are at risk.

Market Cap Calculation​

Market cap is derived from the Uniswap pool's current price:

Market Cap = Total Supply (1B) x Token Price in ETH

The token price is read from the pool's sqrtPriceX96 value. Since every country has the same total supply, market cap rankings are purely determined by price.

Country Images​

Each country can have a custom image set by players, displayed on the map and in country panels. There are two ways to upload an image:

Top Holder (Free)​

The #1 holder of a country's token can set or change the image for free. This is verified on-chain — the app checks the Ponder indexer's holder balances to confirm you hold the largest position.

To upload as the top holder:

  1. Navigate to the country panel
  2. Click the image upload icon
  3. Select an image (max 2MB, jpeg/png/gif/webp)
  4. Sign a session message with your wallet (no gas, just a signature)
  5. The image is uploaded and displayed immediately

Anyone Else (x402 Micropayment)​

If you're not the top holder, you can still set a country's image by paying a $0.001 micropayment via the x402 protocol. This is a machine-payment standard where your wallet signs an EIP-712 typed data message to authorize a tiny payment — no on-chain transaction needed.

The flow:

  1. Click upload on any country
  2. Select your image
  3. Your wallet prompts you to sign the x402 payment authorization
  4. The payment is settled and the image is uploaded

This creates a spam-resistant system where anyone can participate, but there's a small cost to prevent abuse. Top holders get free uploads as a perk of their position.

Image Rules​

  • Max size: 2MB
  • Formats: JPEG, PNG, GIF, WebP
  • Moderation: Images can be removed by admins if they violate community standards
  • Replacement: The latest upload always replaces the previous image

177 Countries​

The game includes 177 countries spanning every continent. Each starts at the same initial price, creating a level playing field. Market dynamics and player behavior determine which countries rise and which fall.