user@avalanche:~$ cat ./docs/README.md

# how launchonavax works

// a stonkfun.xyz style fair launchpad, built natively for Avalanche.
// bridge in, launch a token, trade the curve, graduate to a DEX.

/* the full flow in 4 steps */

## overview

launchonavax lets anyone create a token on Avalanche C-Chain in one transaction. Every token starts on a bonding curve, so there is liquidity from the very first block. No presales, no team allocation, no manual liquidity setup.

+-------------+     +--------------+     +---------------+     +--------------+
|  1. BRIDGE  | --> |  2. LAUNCH   | --> |  3. BONDING   | --> | 4. GRADUATE  |
|  get AVAX   |     |  create coin |     |  CURVE trade  |     |  DEX listing |
+-------------+     +--------------+     +---------------+     +--------------+
   ETH / SOL          name, ticker,        price rises as        liquidity is
   CEX / card         image, socials       supply is bought      migrated + locked

/* step 01: get AVAX on C-Chain */

## bridge_to_avax

You need AVAX on the C-Chain to pay gas and buy tokens. Pick the route that matches where your funds are today:

  [ Ethereum ] ---(Core bridge)-----+
                                     |
  [ Solana   ] ---(Wormhole/Portal)--+--> [ Avalanche C-Chain ] --> launchonavax
                                     |
  [ Exchange ] ---(withdraw AVAX)----+

[ FROM ETHEREUM ]

Use the official Core bridge to move ETH, USDC or other supported assets to Avalanche, then swap for AVAX.

[ FROM SOLANA / STONKFUN.XYZ ]

Bridge SOL or USDC to Avalanche with a cross-chain bridge such as Wormhole (Portal), then swap to AVAX on C-Chain.

[ FROM AN EXCHANGE ]

Buy AVAX on a centralized exchange and withdraw it directly. Always choose the C-Chain network.

WARN: Only send AVAX on C-Chain. Funds sent on X-Chain or P-Chain will not appear in your EVM wallet.

/* step 02: create */

## launch_a_token

$ connect an EVM wallet (Core, MetaMask, Rabby)
$ click [ + launch_token ]
$ enter name, ticker, image, description and socials
$ optionally make the first buy to secure your own bag
$ confirm the transaction — your token is live and tradable

/* step 03: trade */

## bonding_curve

Tokens trade against a smart contract instead of an order book. Each buy increases the price along the curve and each sell decreases it. Because the contract is always the counterparty, you can buy or sell at any time without waiting for a match.

 price
   ^                                   * <- graduation
   |                              *  *
   |                         *  *
   |                   *  *
   |            *  *
   |     *  *
   | *  *
   +------------------------------------> supply sold
   0%               50%              100%

> the curve progress bar on each token card shows how close it is to graduating.

/* step 04: go to the DEX */

## graduation

When the curve reaches 100%, trading on the curve stops. The AVAX raised plus the remaining token supply are deposited as a liquidity pool on an Avalanche DEX, and the LP tokens are locked. From then on the token trades freely like any other ERC-20 on Avalanche.

[curve 100%] --> [create pool] --> [add AVAX + tokens] --> [lock LP] --> [DEX trading]

/* same idea, different chain */

## vs_stonkfun.xyz

feature	stonkfun.xyz	launchonavax
chain	Solana	Avalanche C-Chain
native gas	SOL	AVAX
token standard	SPL	ERC-20
wallets	Phantom, Solflare	Core, MetaMask, Rabby
launch model	bonding curve	bonding curve
after curve fills	migrates to Solana DEX	migrates to Avalanche DEX
evm compatible	no	yes

/* what it costs */

## fees

launch_fee ........... 0.00%
trading_fee .......... 1.00%  (on curve)
graduation_fee ....... paid from curve, not by holders
network_gas .......... paid in AVAX, usually a few cents

/* common questions */

## faq

> Do I need to code to launch?

No. Fill in a name, ticker, image and description, confirm the transaction in your wallet, and your token is live.

> Can the creator rug the liquidity?

Liquidity sits in the bonding curve contract while trading, and is migrated and locked automatically at graduation. The creator has no withdraw function.

> Is there a presale or team allocation?

No. Every token is a fair launch: everyone, including the creator, buys from the same curve at the same price rules.

> What wallet should I use?

Any EVM wallet that supports Avalanche C-Chain works — Core, MetaMask or Rabby are the most common.

> I came from stonkfun.xyz. What changes?

The flow is the same. You just need AVAX on C-Chain instead of SOL, and an EVM wallet instead of Phantom. See the bridge section above.

$ ready?

[ explore_tokens -> ]