DOCS
Everything you need to build on, integrate, or trade TURF coins.
WHAT IS TURF?
TURF is a pump.fun-style launchpad for memecoins pegged to real-world locations on Integra Testnet. Anyone can launch a coin tied to a building, street, neighborhood, district, or landmark. Every coin has a fair-launch bonding curve that targets 420,000 IRL.
HOW IT WORKS
- Launch — Pick a place, set a symbol, pay the launch fee (0.02 IRL). The factory deploys a new ERC-20 with a bonding curve.
- Buy / Sell — Trade tokens on the bonding curve. Price increases with demand (constant-product formula). Earns XP.
- Curve Fills — When 420,000 IRL is deposited, liquidity auto-transfers to DEX. The coin graduates.
CHAIN
Network
Integra Testnet
Chain ID
26218
Native Token
IRL (18 decimals)
RPC
https://testnet.integralayer.com/evm
CONTRACTS
Two contracts power the protocol:
TurfFactory
0x0583a0C5e82A661C2B22E47F4a310480266c3FD3
Deploys coins, maintains registry, collects fees. Entry point for launching.
launch(symbol, placeName, lat, lng, category, description) payable → address
getAllCoins() → address[]
getCoinCount() → uint256
isTurfCoin(address) → bool
launchFee() → uint256
TurfBondingCurve
ERC-20 token with built-in constant-product bonding curve. One per location.
buy() payable — Buy tokens with IRL
sell(tokenAmount) — Sell tokens for IRL
getBuyPrice(irlAmount) → tokenAmount
getSellPrice(tokenAmount) → irlAmount
curveProgress() → uint256 (basis points)
currentPrice() → uint256
totalDeposited() → uint256
placeName(), lat(), lng(), category(), description(), creator()
BONDING CURVE
Total Supply
1,000,000,000 tokens
Curve Supply
800,000,000 (80%)
LP Reserve
200,000,000 (20%)
Virtual IRL
210,000
Target
420,000 IRL
Formula
K = VIRTUAL_IRL x CURVE_SUPPLY
The curve uses a constant-product (x*y=k) formula. As more IRL is deposited, the price increases exponentially. At 420,000 IRL, the curve fills and liquidity transfers to DEX.
XP SYSTEM
All user actions emit on-chain XP events. Points are non-transferable and tracked via the XP Leaderboard.
Launch a coin
+200 XP
Buy tokens
+75 XP
Sell tokens
+25 XP