One person holds one city.

The two roles

Citizen and Ambassador are separate records on the same account. Buying a city does not make you a citizen of it, and being a citizen gives you no claim on the city. You can be one, the other, or both.

Joining a city

Joining is free and happens under My city → Cities. It needs three things: a signed-in account, a Solana address saved as your airdrop wallet, and either presence near the city or an invite. It is not a purchase.

• The distance rule. 400 km from the city's coordinates, measured at the moment you join. Location is checked on the server, not taken from the page.
• Invites beat distance. Opening a city's invite link lets you join from anywhere. The code is credited to whoever sent it, and a citizen's own link still credits the Ambassador of that city.
• The airdrop wallet is where the money goes. Weekly $GARLY is sent only to the address you type in Hall. Connecting Phantom does not change it and never receives anything — Phantom is a way to pay, never a payout destination.
• Moving cities has a cooldown. One move per 30 days. Ambassadors are paid on the people counted in their city, so without the cooldown a group could walk the same accounts around the map and be counted twice.
• Leaving burns your XP. Leaving from Hall asks twice, then resets every XP point on the account. It does not sell or release a city you own.

Buying a city

Open Find. Every city that is still open is listed with its price in $GARLY, and you can sort by it. Buying takes one payment from your own wallet, and the money lands in the vault — not in an NFT.

The title card

Every purchase runs through three marked steps — review, pay, voucher — and states plainly where the money goes before you sign anything.

The city belongs to the account that completed the buy, not to the wallet that paid. Sale proceeds and weekly $GARLY go to the airdrop wallet you typed in Hall.

Running your city

Owning is the start, not the result. Levels need people and time — both. Time alone would reward sitting on a city; people alone would let someone buy a burst of attention.

1. 01Scout0 citizens · day 0
2. 02Voice10 citizens · day 7
3. 03Guide50 citizens · day 30
4. 04Guardian200 citizens · day 90
5. 05Beacon1,000 citizens · day 180

Citizens count as active, not merely registered. Badges — Founder, First Ten, Landmark, Season, Year, Steady — record something that happened and are never taken away.

What each level unlocks in Hall

Every Ambassador can write the city's identity, post notices, see the roster and message a citizen from day one. The heavier tools arrive as the city grows.

Selling, releasing, and staying covered

• Listing puts the city on sale at its grown worth, never below the original ticket. The next buyer pays your airdrop wallet directly — that money does not pass through the vault. Unlisting cancels.
• Releasing hands the city back to the map for nothing.
• The city has to stay covered. A background sweep checks that each Ambassador still holds their city's cost in $GARLY. Once a wallet no longer covers it there is a 7-day grace period before the city is released — long enough to notice the email, short enough that a lapsed Ambassador cannot sit on a capital.

Missions and XP

Missions are the work the pool measures. A credit is one row — one account, one mission, one UTC day — and the same write moves your XP, so the app and your total can never disagree.

• Weekly missions pay +4 on top of the action's own value.
• The daily cap is 20 XP, rolling on UTC days, so a week of missions cannot be finished in one evening. A mission worth more than the room left today is paid down to the room, not refused.
• Cadences. Daily missions reshuffle each UTC day, weekly ones each Monday UTC, community ones are one-off.
• A burn resets the day too. After XP is burned by leaving a city, only credits written after the burn count against today's cap.

The XP ladder

The danger map

Red pins are the point of the city, not decoration. Mapping them and checking them is work the pool pays for, and confirmed pins raise what a city is worth.

• Votes are weighted. A citizen's vote counts 1; the Ambassador's counts 3, because they are accountable for their map.
• Confirmed at 3 weighted confirms, when confirms are at least denies. Challenged at 3 denies, when denies outweigh confirms.
• Denying needs a written reason of at least 16 characters. A single tap must not be able to erase a real risk.
• You can never confirm your own pin — though you may say it is no longer true.
• The reporter's name is never shown. The reason on a challenge is public; who mapped it is not.

The vault and the weekly payday

Cities are bought with $GARLY and that money funds one vault. Once a week the vault is scored, the list is frozen, and a payout file is exported for a human to send.

Who can see it

The vault address and balance sit at the top of both the Ambassador and My city pages, and only citizens and Ambassadors can see them. For anyone else the figure is not merely blurred on screen — the server never sends it. The balance is read from the chain behind a one-minute cache; if that read fails, the page falls back to the programme's own books and says so, rather than presenting a stale figure as live.

The weekly budget

budget = floor(vault × 5%)
         capped so that   vault − budget ≥ 50% of everything ever bought in

5% of the vault is drawn each week. The other number is an endowment lock: half of every ticket ever paid stays put, so Ambassadors who arrive later still have a pot to earn from.

How the budget is split

work   = active citizens + danger reporters
       + (your own week XP × 2) + citizens' week XP + invitees' week XP

tenure = min(3.0, 1 + 0.1 per full month held)   0 for the first 7 days

slice  = your weight ÷ every Ambassador's weight   weight = work × tenure

• The ticket price is not in the formula. Paying ten million for a capital earns nothing by itself.
• An idle city weighs nothing. Work of zero is a weight of zero, whatever was paid and however long it has been held.
• The first 7 days pay nothing, so buying just before a distribution and leaving afterwards is not free money.
• Your own XP counts double in your city's work, so growing the city pays you more than being one more citizen in it.
• Nothing is rounded away. Amounts are whole $GARLY and the undividable remainder is reported, not quietly dropped: paid out plus remainder equals the budget, exactly.

The citizens' share

An Ambassador may pass up to 50% of their weekly slice to the people doing the work. The default is zero, and it comes out of your slice — it is not extra vault money. Within the pot, each citizen's share is proportional to their week.

citizen work = their week mission XP
             + 1 if signed in this month
             + 1 if they mapped danger

Citizens with no airdrop wallet, and dust under 1 $GARLY, return to the Ambassador. From Guide upward you can also top up a separate citizen pot from your own pocket, which is split entirely among the same workers. Stipends land in a ledger a citizen claims from Hall, so a share does not have to wait for the weekly file.

What a city costs, and what it is worth

Pricing is pure arithmetic — no database, no network. The map can show a price before anyone connects a wallet, and the same city always prices identically.

• $GARLY has a 1 billion supply; all city titles together stay inside 900 million.
• Milan is the reference at 1,200,000 $GARLY, because people already use Garly there. Cities in countries with live usage are priced against Milan by population and importance, and the live-usage weights are frozen — a quiet day in the analytics window cannot move a price.
• Places with no live usage sit in a cheap band — about 24,000 for a standard 100,000-person city, capped at 33,000.
• Floor 5,000, ceiling 2,000,000, rounded to the nearest 1,000.

Worth is an appraisal, not a yield

lift  = min(2.5, active × 0.06
              + reporters × 0.04
              + confirmed pins × 0.03
              + days held × 0.0015)      days counted up to 90

worth = max(ticket, ticket × (1 + lift))

An idle city is worth what was paid for it. A sale lists at the grown worth, and the buyer pays the seller.

Around the app

One page, two roles, switched from the header. Each role has its own tab strip, and both show the vault, the XP island and the mission clocks above the tabs.