PROTOCOL DOCUMENTATION · V1

NO FINE PRINT.
JUST THE MECHANICS.

FeelsGood is a permissionless token launcher and direct swap interface built around PEPE and Uniswap V3. Here is exactly what the system does.

00

OVERVIEW

Anyone can create a fixed-supply ERC-20 through FeelsGood. The launch transaction creates the token, opens its PEPE pool, deposits the full token supply into a single-sided Uniswap V3 position and sends the position NFT to a permanent locker.

THE SHORT VERSION1B tokens → PEPE pool → locked V3 NFT → open trading.
01

TOKEN LAUNCHES

Launches are permissionless and have no FeelsGood platform launch fee. Ethereum gas still applies. Every token follows the same immutable template:

  • 1,000,000,000 fixed tokens with 18 decimals.
  • 100% of supply enters initial liquidity.
  • 0% free allocation for the creator.
  • No owner, mint, tax, blacklist, pause or upgrade.
  • Name, ticker and IPFS metadata CID are permanent.
  • Duplicate names and tickers are allowed; verify the address.

Optional first buy

The creator may buy with PEPE during launch. It executes inside the same atomic transaction at the fresh pool’s deterministic V3 price. If any launch step or the first buy fails, everything reverts.

02

V3 LIQUIDITY

Each token receives one PEPE pool at the Uniswap V3 1% fee tier. Initial price is encoded at the nearest valid tick and the position starts entirely on the launched-token side. Token ordering determines the mirrored tick configuration: when the launched token is token0, the initial/lower tick is −1,000 and the upper tick is 887,200; when PEPE is token0, the lower tick is −887,200 and the initial/upper tick is 1,000. These are the full usable Uniswap V3 boundaries for the 200-tick spacing.

Initial tick−1,000 / +1,000
Launch price0.9048419419 PEPE
Range width888,200 ticks
Tick spacing200
Pool fee1.00%
PERMANENT MEANS PERMANENTThe locker cannot transfer the NFT, withdraw liquidity, rebalance, approve another operator or recover the position.
03

TRADING

The FeelsGood interface supports only direct PEPE ↔ launch-token routes through the official Uniswap V3 router. There are no token-to-token multihops and no additional platform swap fee.

Quotes come from the official QuoterV2. Price impact is displayed as information and does not block a transaction. The interface uses unlimited ERC-20 approvals for repeat swaps; users can revoke them at any time.

04

FEE DISTRIBUTION

Anyone may call the per-token claim function. The caller cannot redirect funds. Collected fees always follow these fixed rules:

V3 POSITION FEES
PEPE SIDE50% creator recipient50% immutable treasury
TOKEN SIDE100% sent to dead addressTotal supply does not decrease

The original creator may update their PEPE fee recipient. If a split contains an odd wei, the treasury receives the rounding remainder.

05

“MARKET CAP”

FeelsGood displays Market Cap as current token price multiplied by the fixed one-billion supply. At launch this is approximately 904,841,942 PEPE.

IT IS NOT MONEY RAISEDThis nominal valuation is not deposited capital, treasury assets, available exit liquidity or funds raised by the creator.
06

CONTRACTS

Use only addresses shown here and verified on Etherscan. FeelsGood contracts are immutable and non-upgradeable. The fixed admin at the treasury address cannot be transferred or renounced. Once one-time contract bindings are frozen, its only power is to pause or resume new launches; trading, swaps, claims and fee-recipient updates remain available while launches are paused.

FeelsGood Factory0xAe7964FB27a2005237580F8D879C848b2367D86f
V3 Launcher0x4DA25a0A02f1C5E8e8C526691bE0dF7b4EDacf42
Liquidity Locker0x561e26C57352A03CddAE6961650E02472c4c3e33
Fee Distributor0x6a60C00025cFEa7333b8b8090B959563B22f9d2A
PEPE0x6982508145454Ce325dDbE47a25d4ec3d2311933
Fixed admin / treasury0x834CB9aEa2d5e335940928445B235E2d7D8B57dD
Dead address0x000000000000000000000000000000000000dEaD

Official Uniswap V3 contracts

Factory0x1F98431c8aD98523631AE4a59f267346ea31F984
SwapRouter0xE592427A0AEce92De3Edee1F18E0157C05861564
Position Manager0xC36442b4a4522E871399CD717aBDD847Ab11FE88
QuoterV20x61fFE014bA17989E743c5F6cB21bF9697530B21e