GoDegen protocol docs
The product, the fee flow, the market data pipeline, and the rules that keep the launch pool transparent.
Overview
GoDegen.fun is a memecoin launchpad on Base. A token launches with a fixed 1,000,000,000 supply and a permanent Uniswap v4 pool. There is no graduation, no migration, and no later liquidity unlock.
The terminal shows live price, market cap, 24h volume in USD, holders, Uxp rate, and a multi-timeframe chart. Token links use the contract address so a URL can never point at the wrong token.
Launch
A creator chooses one of $10,000, $20,000, $50,000 starting market caps and may add a dev buy. The full supply enters a single-sided v4 position. The ETH side of the pool is funded only by buyers.
- Launch protection is buy-only and decays over the first 45 seconds, capped at 200 blocks.
- The cumulative per-transaction buy cap is 2% during the protected window.
- The creator dev buy is atomic with launch and skips the launch surcharge; the normal 1.3% fee and 2% cap still apply.
- Sells are never capped or surcharged.
- The pool is open to standard routers and aggregators.
- A token logo is required. It is normalized, stored on Cloudflare R2 with an IPFS fallback, and referenced from the on-chain metadata.
- The first 100 unique wallets get one free launch. Later launches cost 0.001 ETH.
- Launches require a verified builder or creator. Builders add a short code to a public GitHub README; it is checked every 30 seconds for two minutes. Creators add a short code to their X bio; it is checked at 30 and 60 seconds. One repository or X profile launches one coin.
/token/<contract-address>. If a short slug is used, it redirects to the contract address and keeps the query string, including referral codes.Fees and rewards
Every trade pays a fixed 1.30% fee. The split is enforced by the contracts, not by a backend setting.
| Recipient | Share | Bps |
|---|---|---|
| Platform | 0.30% | 30 |
| Creator | 0.25% | 25 |
| Referrer | 0.20% | 20 |
| Stakers, with referrer | 0.55% | 55 |
| Stakers, without referrer | 0.75% | 75 |
External router trades pay the same fee through hook deltas and credit the fee split through the vault. The keeper funds the vault when the curve redeems the ERC-6909 claim.
Uxp
Uxp is soulbound. Trading mints Uxp to an unclaimed balance. A user claims Uxp to their wallet, then stakes it separately. Claiming and staking are intentionally separate steps.
Sells earn 0.25 Uxp per $1 after a five minute hold. Quick flips earn zero. A qualifying 50% loss after two minutes doubles the sell reward through Rekt Insurance.
Creators earn 25% and referrers earn 20% of trader Uxp. A token creator can also be a referrer. Self-referral is rejected.
Daily Uxp minting is capped at 20,000,000 per wallet per UTC day. There is no global cap. External attribution is forced to the transaction origin, so router data cannot rotate wallets. The owner can lower the cap, with an immutable hard ceiling of 100,000,000 per wallet.
Claimed and staked Uxp burn 10% per full UTC day after the first claim. A trade worth at least $10 on that UTC day lowers the burn to 5%. Unclaimed Uxp is never burned, and the next UTC midnight after the first claim is the first burn checkpoint.
“First claim” means the wallet's first-ever Uxp claim. It is a one-time switch that starts the burn. Later claims do not restart or reset the burn clock.
Referrals
Referrals are optional and bind once. A referrer earns 0.20% ETH and 20% of trader Uxp on every referred trade.
Every wallet receives a stable eight character referral code. The link format is short and shareable:
https://godegen.fun/?ref=YOURCODE
- Each code is unique, permanent, and tied to one wallet.
- The referral card shows the code, never the full referrer address.
- Connect a wallet to bind. You cannot use your own referral link.
- Referral rewards settle in ETH and Uxp on every referred trade.
Promo slots
Five promo slots run on a fixed UTC clock. Bidding is open from 00:00-12:00 UTC. Every bid goes on the tape instantly and is replaced by the next bid. The last bid at 12:00 owns the slot for the 12:00-24:00 UTC live window. Every slot resets at 00:00 UTC.
- Minimum raise is $1. Every bid goes on the tape instantly; the last bid at 12:00 UTC keeps it live for 12 hours.
- Bids are never refunded and go directly to the treasury.
- A wallet pays only the difference from its own previous total bid in the same UTC day and slot.
- Every contribution resets at 00:00 UTC.
- Live tape priority is 33%, 25%, 17%, 15%, and 10% for slots 1-5.
- Promo entries carry a megaphone mark; the free daily top 10 stays separate.
Market data
The browser never calls a chain RPC directly. The backend indexes platform events, writes durable history, keeps a hot cache, and streams live updates over WebSockets.
Every trade updates rollup candles. Higher timeframes read one row per bucket instead of scanning raw trades. The API also returns current price, market cap, 24h volume in USD, change, trade count, and holder ranking.
Architecture
The indexer processes events in chain order. The write queue coalesces state into idempotent transactions. Candle and global hourly aggregates use database triggers keyed by event identity, so a retry cannot double count volume.
Security
The protocol is non-custodial. The backend has no private keys and never asks for a seed phrase. On-chain actions are signed by the user's wallet.
- Creator social updates and referral binds require wallet signatures or on-chain transactions.
- All backend queries use positional parameters. Writes are idempotent and validated.
- Production database connections require TLS and scoped credentials.
- Rate limits apply to HTTP requests, WebSocket subscriptions, nonces, and creator edits.
For agents
Machine-readable resources are published for AI agents, researchers, and integrations. The public API is read-only for market data. Promo bids are on-chain USDC transactions, and creator social updates require wallet signatures.
- llms.txt is the concise site index.
- llms-full.txt is the complete product, API, and security reference.
- openapi.json describes the public HTTP API.
- tokenlist.json is the public token list.
- agent.md is a short entry point for agents.
FAQ
Is liquidity locked forever?+
Yes. The launch creates a permanent single-sided v4 position. There is no graduation, migration, or liquidity unlock.
Can a token URL change after launch?+
No. The canonical URL is the contract address. Slug URLs redirect to it.
Can the creator edit social links later?+
Yes. The creator wallet signs the update. Missing links can be added at any time. Existing link edits are limited to once every 30 days.
Why does the referral link need a connected wallet?+
The link is tied to the wallet that owns the referral code. Connect the wallet first, then copy the short link.
Does the watchlist follow my wallet?+
Yes. A connected wallet has its own watchlist. When no wallet is connected, the app keeps a device-local list.
Where can I verify the contracts?+
Use the addresses on the Contracts page and open them in the Base explorer. Only addresses published there should be used for trading or integration.
Social links
X, website, and Telegram links are optional at launch. If a creator forgets one, they can add it later from the token page with the creator wallet.