Docs

The town's rulebook.

Everything Padville does, in the order you'll meet it. For a shorter walk-through, see How it works.

What Padville is

Padville is a token launchpad drawn as a town. Every token launched here is a building. The building's height shows how full the token's bonding curve is, so you can read the whole market by looking at the skyline.

Under the town are three programs Padville did not write and does not control: Meteora's Dynamic Bonding Curve (launches and trading), Meteora DAMM v2 (the pool a token graduates into) and Jupiter Lock (vesting). Padville is the interface. It never holds your tokens or SOL.

There is no database of tokens. The town reads the list of pools from the chain each time, so what you see is what the chain says.

Devnet and Mainnet

The switch in the top left corner of the town chooses the network. Your choice is remembered, and you can put it in a link: /app?net=devnet or /app?net=mainnet.

DevnetMainnet
What it's forPracticeReal launches
SOLFree from the faucet, worth nothingReal
Launch, trade, lock, claimAll workAll work
Swaps through JupiterNo (Jupiter is mainnet only)Yes

Set your wallet to the same network as the town. A wallet on mainnet looking at the Devnet town will show the wrong balance and its transactions will fail.

There is also a demo town with made-up tokens. Nothing in it is on chain; it only shows what a busy town looks like.

Launching a token

Open the Launch Pad (the rocket, or press 1), or click any fenced lot marked free.

FieldRule
ImagePNG, JPEG, WebP or GIF, up to 2 MB. Square works best: it hangs on the building.
Name2 to 32 characters
Ticker2 to 10 letters or digits
ReservedThe name Padville and the ticker VILLE, and spellings that pass for them, belong to Padville's own wallet. Nobody else can launch with them, and a token that carries them from elsewhere gets no building.
Description, linksOptional. Links must start with https://
DistrictSets the fee rule and the graduation target. See below.
Dev buyOptional. At least 0.01 SOL, at most 10% of supply.

Every token has a supply of 1,000,000,000 with 6 decimals. The mint authority is removed when the token is created, so the supply can never grow.

A dev buy happens inside the transaction that creates the token. Nobody can buy before you, and it pays the fee the district settles on rather than the opening fee. If you tick Lock the dev buy, a second transaction moves those tokens into a lock for 1, 3, 6 or 12 months.

Under District you pick one that is already open, or choose Your own rules and set the fee and the market caps yourself. With your own rules, the launch opens a new district first: two transactions, which most wallets approve in one prompt. If a district with exactly those rules already exists, the launch goes there instead and no new one opens.

Cost: about 0.025 SOL for the pool's accounts and network fees, about 0.006 SOL more for a new district, and about 0.006 SOL more for a lock. Padville charges nothing to launch.

Districts and fees

A district is one Meteora DBC config key: a small account on chain that holds the rules for every pool created with it. The town has room for 16. City Hall lists them all with their rules. Anyone can open one, there or while launching a token.

What a district sets

Two things: how the trading fee falls after a token opens, and the two market caps. These are the starting points on offer:

PresetFeeMarket cap
StandardFee opens at 99%, falls to 2% in 30s30 → 420 SOL
Speed buildFee opens at 99%, falls to 2% in 30s30 → 200 SOL
FortressFee opens at 99%, falls to 1% in 120s, a step every 2s40 → 600 SOL

Any number can be changed, within these limits:

  • The fee opens at 0.25% to 99% and settles at 0.25% to 10%. A high opening fee makes sniping a launch expensive.
  • It falls for up to 5 minutes, in a straight line or fast at first, one step every 1 to 60 seconds. A fall of 0 seconds is a flat fee.
  • A token opens at 5 to 1,000 SOL market cap and graduates at 2 times that or more, up to 20,000 SOL.

Who gets the fee

Meteora's protocol takes 20% of every trading fee first. The remaining 80% is split 50/50 between the token's creator and Padville. A 1 SOL fee pays 0.2 SOL to Meteora, 0.4 SOL to the creator and 0.4 SOL to Padville. Only a district Padville itself opened can have another split; City Hall and the Launch Pad show it where it differs.

Graduation

A district sets the market cap a token opens at and the market cap at which its curve is full. With Standard's 30 and 420 SOL, about 89 SOL has to go into the curve to fill it. At that point the liquidity moves to a DAMM v2 pool with a 1% fee and is permanently locked, half for the creator and half for Padville. Both keep earning fees from it; neither can withdraw it.

None of a district's rules can be changed after it opens. It can only be closed to new launches, and reopened.

Opening your own district

Connect a wallet, open City Hall (press 5) and choose Open a new district. Pick a name, a building style, the fee and the two market caps. It takes one prompt: the transaction that creates the config key, about 0.006 SOL. Or let a launch open it: choose Your own rules at the Launch Pad.

  • Anyone can then launch in your district, under the rules you set.
  • Opening a district earns nothing by itself. Fees still go to each token's creator and to Padville.
  • One wallet can open 2 districts.
  • You can close your district to new launches and reopen it. Its buildings stay either way. Padville can close any district.

The permit

Until $VILLE is live on a network, opening a district there takes nothing more than the above. Once it is, it also takes a permit: 200,000 $VILLE locked for 30 days, or longer.

  • The permit is a lock on Jupiter Lock, made in City Hall as part of opening the district. It is your own $VILLE, locked to yourself, released all at once at the end. Nobody can cancel it.
  • The district takes launches for as long as the lock runs. When it ends you claim the $VILLE back in the Vault, and the district closes to new launches until you lock again. Its buildings stay and trade as before.
  • One lock holds one district open.
  • A district that opened before $VILLE was live needs no permit, and neither do Padville's own.

How buildings grow

A building's height comes from one number: how much of the graduation target is already in the curve.

Curve filledFloors
At launch2
10%4
25%8
50%15
75%22
99%28
Graduated36 to 48, with a spire

Buildings also shrink: selling takes SOL out of the curve. A graduated tower stays as it is. Each block has 4 lots, and a district takes the nearest free block when its last one fills, so older tokens stand closer to the centre. A building never moves once placed.

The shape, colour and roof of a building are worked out from the token's address, so it looks the same to everyone, every time.

Trading

Click a building to open it. Buy spends SOL, Sell spends the token. The panel shows what you receive, the least you'll accept after slippage (1%, 3% or 5%), and the fee at this second, which matters in districts where the fee is still falling.

A buy larger than what the curve has left fills the curve and returns the rest of your SOL. After graduation the token trades in its DAMM v2 pool: on Mainnet the Exchange routes that through Jupiter.

The Exchange (press 3) lists every town token in one place, and on Mainnet also swaps tokens from outside the town through Jupiter. Bridging from other chains opens an outside service in a new tab.

Locks and vesting

The Vault (press 2) makes locks on Jupiter Lock for any SPL token you hold.

  • All at once: everything unlocks on the end date.
  • A little every day: equal parts unlock daily until the end date.

You choose the amount, the length (from one day) and who receives the tokens. Locks made here can't be cancelled and the recipient can't be changed, by anyone. The Vault lists locks you made and locks that pay you; the recipient claims whatever has unlocked.

Claiming fees

The Treasury (press 4) shows the fees waiting for the connected wallet, token by token, in SOL. Claim whenever you like; there is no deadline and unclaimed fees stay yours. After a token graduates, a second line appears for fees from the locked pool position.

Editing the town

Edit town, at the top of the app, is where you rearrange what is yours. Pick something up, click a green lot, and save. Saving asks your wallet for a signature and costs nothing.

  • You can move the building of any token you created. Nobody else can, except Padville.
  • A green lot is free land: the open land around town, or a lot another building has left. A district's own free lots are not offered; those wait for the next launch.
  • Moving a building never shifts anyone else's. The lot it was given stays its own, and you can send it home again.
  • Where a token stands changes nothing about the token: not its price, its curve or its fees.

Decorations

The same panel sells decorations. Each one is paid for once, to Padville, in SOL or in $VILLE, and takes one free lot. Choose one, click the lot it should stand on, and pay. It is yours from then on: move it, or put it in storage and bring it back later.

DecorationSOL$VILLE
Garden0.031,200
Flag court0.052,000
Statue0.14,000
Fountain0.156,000
Balloon0.2510,000
Ferris wheel0.520,000

$VILLE is Padville's own token. Until it has launched, decorations are sold for SOL only. A decoration is not a token and can't be sold on; a payment is not refunded. The town shows up to 120 at a time.

Billboards

Six billboards stand on the riverside in front of the civic centre. Each shows one token's logo and ticker, on both faces, lit at night. Click a board in town to see what it shows and to rent it.

  • A rental lasts 7 days and is paid once, to Padville, in $VILLE. Boards can't be paid for in SOL.
  • Until $VILLE is live on a network, the boards there can't be rented.
  • Any token that has a building in town can go on a board. It does not have to be your own.
  • If the board is taken, your week starts when the rentals booked before yours have ended. Nobody is cut short.
  • A board can be booked up to 4 weeks ahead.
  • A rental can't be moved to another board or refunded.
Board$VILLE a week
Launch Pad West8,000
Launch Pad East8,000
Plaza West16,000
Plaza East16,000
Exchange West8,000
Exchange East8,000

Running City Hall

This part is for whoever operates a Padville site.

  • Each network has a platform wallet, set in the environment (NEXT_PUBLIC_PLATFORM_WALLET_DEVNET, NEXT_PUBLIC_PLATFORM_WALLET_MAINNET). Every district opened while it is set pays its platform fees to it, whoever opens the district. A district keeps paying that wallet even if the platform wallet is changed later. The platform wallet can also close any district, may open more than 2, and is the only one that can set a district's creator share to something other than 50%.
  • The list of districts is kept on the server. A new district needs no signature: the server reads its config key from the chain and lists it only if the key pays its platform fees to the platform wallet, holds exactly the rules in the record, and those rules are within the limits. The wallet the key names as its maker becomes the owner. A change is accepted only with the signature of the owner or the platform wallet.
  • A network with no platform wallet has no districts, and nothing can launch there.
  • Decorations are paid to the platform wallet. The server records one only after reading the payment from the chain: the right amount, to that wallet, with a memo naming the decoration. $VILLE is accepted once its mint is set (NEXT_PUBLIC_VILLE_MINT_DEVNET, NEXT_PUBLIC_VILLE_MINT_MAINNET); the prices are in src/config/decor.ts. The platform wallet can move any building or decoration.

Getting around

ToMouseTouch
MoveDragDrag
ZoomScroll, or the + and − buttonsPinch
TurnRight-drag, or the arrow buttonsTwo fingers
Open a civic buildingClick it, the bar at the bottom, or 1 to 5Tap it or the bar
Close a panelEscThe ✕

The slider under the stats moves the sun. If the town runs slowly, add ?q=low to the address; ?motion=reduce turns off traffic and camera flights.

Questions

Can a creator pull the liquidity?

No. Before graduation the SOL sits in the curve, where it can only be traded against. After graduation the pool position is locked permanently.

Can more tokens be minted?

No. The mint authority is removed at creation.

Why did my building get shorter?

Someone sold. Height follows the SOL in the curve.

My token isn't showing an image on its building.

The host of the image has to allow other sites to load it. Images uploaded through the Launch Pad do. Until one loads, the building shows the ticker.

I launched on Devnet. Where is it on Mainnet?

Nowhere. The two networks are separate chains.

Where does Padville post news?

On X, at @Padvilledotfun. Nobody from Padville will ask for your seed phrase.

Risks

  • Most new tokens lose most of their value. A tall building says people bought, not that the token is worth holding.
  • Padville does not vet tokens or their creators. Names, images and links are whatever the creator typed.
  • Padville is an interface to programs run by others. A fault in those programs, or in a wallet, is outside its control.
  • A lock or a district can't be undone. Check the numbers before you sign.
  • Nothing here is financial advice.

Try it on Devnet first.