Skip to content
Documentation

GoDegen protocol docs

The product, the fee flow, the market data pipeline, and the rules that keep the launch pool transparent.

01

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.

Supply
1B fixed
Trading fee
1.30%
Pool
v4 locked

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.

02

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.
Canonical token URL
Every launch is reachable at /token/<contract-address>. If a short slug is used, it redirects to the contract address and keeps the query string, including referral codes.
03

Fees and rewards

Every trade pays a fixed 1.30% fee. The split is enforced by the contracts, not by a backend setting.

RecipientShareBps
Platform0.30%30
Creator0.25%25
Referrer0.20%20
Stakers, with referrer0.55%55
Stakers, without referrer0.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.

04

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.

Below $20k MC
1.00 Uxp / $1
$20k to $75k
0.50 Uxp / $1
$75k and above
0.25 Uxp / $1

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.

05

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.
06

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.

Bidding
12 hours
Live window
12 hours
Opening bid
$5 USDC
  • 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.
No user-controlled timer
The clock is global. A bid does not extend it. Every bid is on the tape instantly, and the last bid before 12:00 UTC owns the next 12-hour live window.
07

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.

  • Only the creator wallet can sign an update. The backend verifies the EIP-191 signature.
  • Each signature has a five minute timestamp window and a single-use nonce.
  • Adding a missing link is always allowed. Changing an existing link is limited to once every 30 days.
  • The launch form accepts handles, @handles, X or t.me links, domains, and full URLs, then normalizes them automatically.
08

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.

Chart intervals
1m, 5m, 15m, 1h, 4h, 1d
Realtime
1s and 1m bars
Price modes
USD, ETH, market cap
Pool scope
GoDegen pools only

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.

09

Architecture

Chain
Base, Uniswap v4
Indexer
HTTP backfill + WebSocket live
Hot state
In-memory cache
Durable state
Persistent
API
Stateless HTTP
Live transport
WebSockets

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.

Operational safety
One process holds the writer lease and runs the background services. Read replicas can serve API and WebSocket traffic without running a second indexer.
10

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.
11

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.

12

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.