giwagmi docs

giwagmi is a permissionless, native-ETH launchpad on GIWA Sepolia — an Ethereum L2 where the gas and quote asset is ETH. Anyone can fair-launch a token on a constant-product bonding curve priced entirely in native ETH. When the curve raises 3.6 ETH, the token auto-migrates to a real Uniswap V4 pool with permanently-locked liquidity and keeps trading there — with a 1% fee taken at the AMM itself, so creators keep earning forever.

Because the quote asset is ETH — the same asset that pays gas and sits in every wallet — a market cap in ETH is exactly the ETH it takes to own the float. Buying needs no approval: native ETH rides on the transaction itself.

The design closes the holes most launchpads leave open:

Trade a token

1. Connect a wallet (top-right). giwagmi runs on GIWA Sepolia — approve the network switch if prompted.
2. Open any token from the Board.
3. On Buy, enter an ETH amount (or tap a preset). On Sell, use the balance readout and the 25% / 50% / Max buttons.
4. Set slippage, review “You receive”, and confirm in your wallet.

Launch a token

1. Go to Create.
2. Fill in name, ticker, image, description, and socials. A live preview updates as you type.
3. Optionally make an atomic first buy, and optionally set a fee-recipient wallet.
4. Confirm. Your token deploys with its curve in one transaction and appears on the board within a few blocks.

Each token trades on a constant-product curve, x · y = k, with virtual reserves — priced in native ETH. Fixed supply is 1,000,000,000 units; 72% sells through the curve and 28% is reserved to seed DEX liquidity at graduation.

The final buy is partially filled so the raise target and the curve's token allocation are exhausted at the same instant — the curve can never oversell its 72% allocation, and graduation is deterministic.

When collected ETH reaches 3.6 ETH, graduation triggers automatically inside the same transaction as the final buy. The curve:

1. opens a Uniswap V4 pool (ETH/token, native ETH as currency0) at exactly the curve's closing price;
2. seeds a full-range position with 3.5 ETH + the reserved 28% and locks it permanently (no withdrawal path);
3. sends the 0.10 ETH treasury cut;
4. activates the shared fee hook and closes the curve — all further trading is on the open V4 market.

Graduated tokens trade in-app through giwagmi's own minimal V4 router; quotes come from an exact, tick-correct on-chain quoter (with a pool-state fallback). The 1% fee is taken by the hook on the swap output.

A flat 1% fee applies to every trade, split evenly: 0.5% to the creator and 0.5% to the protocol treasury. It is charged identically before and after graduation.

• Pre-graduation: the curve accrues fees; the creator/treasury claim them from the curve.
• Post-graduation: the V4 hook accrues fees per pool, per currency (ETH on sells, token on buys), claimed from the hook.

Creator earnings are surfaced on each creator's profile. Because the fee is charged on secondary DEX volume too, a creator keeps earning for the life of the token.

A token's creator and the protocol treasury each manage their own 0.5% stream from the profile page (owner-gated on-chain):

• Change the recipient — redirect where your fee stream is delivered (a redirect, not a transfer of authority; recoverable if a wallet is ever blocklisted).
• Claim — sweep accrued fees. Post-graduation, ETH and the token are two separate claims from the hook.

Fee reads use on-chain Multicall, so make sure your wallet is on GIWA Sepolia for the claimable balances and buttons to populate.

• Price chart — market-cap candles (1m / 5m / 1h) aggregated over the full trade history.
• Holders — an exact count and distribution derived from on-chain balances (indexed from Transfer events), correct before and after graduation.
• Recent trades — a live feed of buys/sells (and post-graduation swaps).
• Board — every token, filterable by stage, sortable, with live flashes on new buys and launches, paginated 15 per page.

• Fixed supply minted entirely to the curve — no mint authority after creation.
• Launch guard blocks non-curve transfers until graduation (anti pre-made-pool grief).
• Liquidity is permanently locked at graduation — it cannot be pulled.
• DEX wiring (poolManager, feeHook) is immutable — no setter, so no key can repoint new launches at a malicious venue.
• Reentrancy guards on state-changing entry points; slippage bounds on every trade.
• Curve math verified against a differential reference model and real Uniswap bytecode; fee accounting and solvency proven; validated with live canaries.

Native-ETH pricing means no wrapper or oracle sits between the trade and settlement.

Deployed on GIWA Sepolia (chain id 91342) and source-verified. The quote asset is native ETH (no token contract). Click any address to open it on the Blockscout explorer.

A public read API (the indexer) powers the app and is open for integrators and agents. Base URL is the indexer origin. All responses are JSON; an empty list is a valid answer and a failure is a real error (there is no fabricated data).

Where giwagmi is and where it's going.