# Lysa docs

> Lysa launches coins that bots can't grab in the first seconds, pays creators on every trade, and lets anyone trade any coin on Elysium with the facts in front of them.

The text of https://docs.lysa.fun, written by its build. Chain 99901 (Elysium). The agents' recipe is https://lysa.fun/agents.txt.

Docs · Elysium · chain 99901

# Launch on Elysium

Lysa launches coins that bots can't grab in the first seconds, pays creators on every trade, and lets anyone trade any coin on Elysium with the facts in front of them.

- Supply: 1B Every coin. No mint, no owner.
- Opens at: 42.27 HYPE Market cap where the pool opens.
- Trade fee: 1% 0.7% to the creator, 0.3% to the protocol.
- First 24 s: 5% · 5.5% Most a wallet may hold, and buy.
- Launch fee: 0 HYPE You pay gas, and your dev buy if you set one.

## Start here

**Launching should be safe, trading should be easy, and both should pay the people who do it.**

- Launch: One signature: the coin, its pool, the whole supply locked for good. Bots meet caps and a falling fee.
- Trade: Lysa's coins and the other pads' on one board, with dev sells, fees and the dev buy shown before you buy.
- Grow: Half of Lysa's revenue buys $LYSA back. Agents, hooks and more of Elysium come next.

| You are | Read first |
| --- | --- |
| A creator | Launch a coin · The first 24 seconds · Earn on every trade |
| A trader | Trade any coin · Risks |
| An agent's builder | Launch from an agent · Contracts |
| Thinking of $LYSA | How Lysa earns · $LYSA · What's next |

Every section opens short. Go deeper adds the detail, and For builders the calls and addresses. The switch in the menu opens them all at once.

## Launch a coin

**One signature makes the coin, opens its pool and locks the whole supply in for good.**

### One signature does three things

- Makes the token: 1B supply, no owner, no mint, no pause. Name, ticker, image and links live in the token.
- Opens its pool: HYPE against your coin on Uniswap V4, the whole supply in it, held by Lysa's hook for good.
- Buys your dev buy: If you set one, inside the same 5% cap as everyone. Above 5%, the launch reverts.

For the first 24 seconds no wallet can hold more than 5% of supply or have bought more than 5.5%. Nobody is exempt, you included.

On lysa.fun, press + Launch: an image, a name, a ticker, a dev buy if you want one. The rest is set to Lysa's defaults.

### Advanced settings

| Setting | Default | What you can set |
| --- | --- | --- |
| Sniper fee on buys | 10%, falling to 1% over 24 s | Start at 1–30%, over up to 15 minutes, or off |
| Sniper fee on sells | Off | Start at 1–30%, over up to 5 minutes |
| Creator tax | 0% | 0–10% on every trade, for good, all to your fee wallets |
| Fee wallets | Your wallet, all of the 0.7% | 1 to 5 wallets, with the shares you choose |

Everything is fixed in the launch second; nobody can change it later, you included. Lysa's defaults keep every fee at or under 10%, so a coin launched on them is not flagged by wallets and scanners. A setting that goes higher may be, and the form says so before you sign.

The dev buy pays the sniper fee like any buy, and of a 10% fee, 7% comes back to your own fee wallets. A 5% dev buy costs about 2.47 HYPE at the opening price on the defaults.

When it lands, your coin's page opens at lysa.fun/t/<CA> with a card to share. Post the CA: 0x… on its own line.

```
function launch(LaunchParams p) payable
    returns (address token, bytes32 poolId, uint256 devBuyOut)
# value = devBuyIn + launchFee(), exactly; launchFee() is 0 today
# fee wallets: 1 to 5, shares summing to exactly 7000 (the creator's 0.7%)
# lysa.fun's default sniper fee: buyFadeBps 900, buyFadeWindow 24
```

The whole call, its rules and a cast recipe are in lysa.fun/agents.txt.

## The first 24 seconds

**Bots buy in the first seconds. Lysa makes those seconds small and expensive.**

- 5% · 5.5%: Most a wallet may hold, and buy, in the first 24 seconds.
- 10% → 1%: The sniper fee on buys, falling a percent at a time.
- 0 exempt: No list, no exceptions. The creator's dev buy obeys the same cap.

### Buy fee, second by second

Lysa default · never flagged

Buys pay 10% in second 0, then one percent less every 2.7 s, and 1% from 24 s.

- One transaction may buy at most 5.5% from the pool in the window, however many swaps it bundles.
- In the launch transaction itself only the factory may trade, so the dev buy is all a creator gets there.
- The extra fee is split like the 1%: of a 10% fee, 7% goes to the creator's fee wallets and 3% to the protocol.
- The fee steps on the chain's clock, in seconds. An Elysium second holds about nine blocks, so counting blocks would be wrong.
- A bot spread across many wallets can still buy early. The caps make each wallet's share small and the fee makes the first seconds costly. See Snipers on Elysium.

```
# the fee at t seconds after launch, as Lysa's hook computes it
fee(t) = start − ⌊(start − 1%) · t / window⌋    # whole percents, while t < window
fee(t) = 1%                                    # from t = window on
# bounds: start ≤ 30%, buys' window ≤ 900 s, sells' ≤ 300 s; a fee with a 0 s window is refused
```

## Earn on every trade

**Creators earn 0.7% of every trade, in HYPE, for as long as the coin trades.**

Every trade of a Lysa coin 1% of the HYPE side 0.7% : The creator's fee wallets 0.3% : Protocol

| Fee | When | Where it goes |
| --- | --- | --- |
| Trade fee | 1%, every trade | 0.7% to the creator's fee wallets, 0.3% to the protocol |
| Sniper fee | Above the 1%, while it lasts | Split the same way: of a 10% fee, 7% and 3% |
| Creator tax | 0–10%, if set, for good | All to the creator's fee wallets |

Fees are taken from the HYPE side only, so you are paid in HYPE and no coin is ever sold to pay a fee.

### Getting paid

- Collect. Fees wait in the hook until someone collects them. Anyone can, for any coin.
- Claim. Each fee wallet claims its HYPE from the escrow. On lysa.fun: Claim on the coin's page, Claim all in Portfolio.

Shares never change. A fee wallet can move its own share to a new address in two steps, and nobody else can move it, Lysa included. A lost key leaves its fees unclaimed for good.

```
hook.collect(token)              # anyone; credits each fee wallet in the escrow
hook.collectMany(tokens)
escrow.claim()                   # a fee wallet takes all it holds, in HYPE
hook.splitOf(token)              # the fee wallets and their shares (7000 = all of the 0.7%)
```

## Trade any coin

**Every coin on Elysium, one board, and the facts before you buy.**

- 13,000+ coins: Lysa's and those of Kleos, Boxa, ElysiumPump and Ascend, on one board.
- 1 prompt: A buy is one prompt in your wallet. Swap trades HYPE for any coin lysa.fun lists.
- Signals: Dev sold, the dev buy, the fees: on the row, before you buy.

### Read a board row

The pad. Where the coin was launched. A Lysa coin has the caps, the sniper fee and locked liquidity; another pad's coin follows that pad's rules.

- A coin's page, lysa.fun/t/<CA>: its chart, its trades, a ticket to buy and sell, and Claim for its fee wallets.
- Routes. Lysa's coins and the native-HYPE V4 coins of Kleos, Boxa and ElysiumPump trade through lysa.fun's swap router; Ascend's through Ascend's own Universal Router.
- lysa.fun's fee is 0.2% of the HYPE side of each trade it sends. Another pad's coin also pays that pad's fee and its creator's tax, read from a live quote and shown on the ticket, in red above 10%.
- A sell is two prompts: a permit or an approval of exactly the amount, then the sale. lysa.fun never asks to approve more.
- Prices come from Lysa's own indexer, read from the chain, since no price site covers Elysium yet. HYPE's dollar price comes from Hyperliquid.

```
router.buy(venue, token, minOut, deadline) payable
router.sell(venue, token, amountIn, minOut, deadline)
router.quoteBuy(venue, token, hypeIn)      # an eth_call, from your own address
# venue 0: Lysa · 1 Kleos V4 · 2 Kleos V5 · 3 Boxa V4 · 4 Boxa Pairs · 5 ElysPump v2
```

## Portfolio and cards

**All you hold and earn on one page, and a card to show it.**

- Portfolio, lysa.fun/p/<address>, from the account menu: each coin's balance, profit at average cost and the fees you can claim.
- Claim all takes every coin's waiting fees in two prompts.
- Share cards are drawn in your browser, one per coin or for the whole portfolio.

```
GET https://lysa.fun/api/v1/wallet?addr=0x…   # holdings, trades, fee slots
```

## What never changes

**No upgrades. One switch, and it only stops new launches.**

### Lysa can

- Stop or restart new launches. One switch, at once both ways. New launches only.
- Change lysa.fun. Its pages and defaults; it can hide a coin's image or page, while the coin keeps trading on chain.
- Run or stop its servers. If they stop, coins, pools and fees keep working on chain.

### Lysa cannot

- Touch a launched coin. No owner, no mint, no pause.
- Remove liquidity. The hook has no way to take it out.
- Change a launch's terms. Fees, caps and shares are fixed for good.
- Move a creator's fee wallet, or exempt anyone from the caps.
- Switch on a pool fee or take what the escrow holds. Neither has an owner.

One Lysa key holds the switch and receives the protocol's 0.3%. The most anyone holding that key could do is stop new launches and take the protocol's future 0.3%. It cannot reach a coin, its pool or a creator's fees.

The protocol recipient pays only its owner, and anyone may call it to forward what it holds.

```
R=https://rpc.lysa.fun
# No owner on the PoolManager: no protocol fee can ever be switched on
cast call 0x21bF73ea677311ca25aD2935cA912b2A8D43DCd4 "owner()(address)" --rpc-url $R
# The one switch: are new launches on?
cast call 0x66820fAA4fFbbAdfb18CE7BE542D21B6ac069b4D "launchEnabled()(bool)" --rpc-url $R
# A coin's fees right now: buy, sell and tax, in basis points
cast call 0xd157Da542191c6769D00f01e86415A4B309aE8ec "feeBpsOf(address)(uint256,uint256,uint256)" <CA> --rpc-url $R
# A coin's fee wallets and their shares
cast call 0xd157Da542191c6769D00f01e86415A4B309aE8ec "splitOf(address)((address,uint16)[])" <CA> --rpc-url $R
```

## Contracts

**Seven contracts on chain 99901. None can be upgraded.**

Verification in progress Lysa verifies its source on Sourcify and Elysium's explorer as soon as they support chain 99901.

- Factory Owner: Lysa's key

0x66820fAA4fFbbAdfb18CE7BE542D21B6ac069b4D

Makes each coin, opens its pool, runs the dev buy. One power: the launch switch.

- Hook No owner

0xd157Da542191c6769D00f01e86415A4B309aE8ec

Holds every pool's position, charges the fees, enforces the caps.

- Fee escrow No owner

0x0e813a0b1Ee5857713a1a054fC809F155e096318

Holds collected fees until each fee wallet claims its own.

- PoolManager No owner

0x21bF73ea677311ca25aD2935cA912b2A8D43DCd4

Lysa's copy of Uniswap's v4-core v4.0.0, unchanged, until Uniswap's own V4 is on Elysium.

- Protocol recipient Owner: Lysa's key

0x7BB0a7CB9244130Bc66290010CfEFB357922808E

Receives the protocol's 0.3% and pays only its owner.

- Swap router No owner

0xef75c02F5Ec50217fb75905263fC6414a60d535A

lysa.fun's trades, with its 0.2%. Holds nothing.

- lysa.fun's fee wallet A wallet

0xA3873168a335996b6C2B65d54AdDc6414Dc75e4d

Receives the router's 0.2% and the bridge's 0.5%.

Every coin launched on this factory stays on it for good. When Uniswap's own V4 reaches Elysium, a new factory there takes new launches; coins already launched keep their pool, fees and terms.

The first swap router, 0x9D6f2977d85f1C8D40D8f94290D6ff6DBC73223E, has the same code for Lysa's coins only. It still works; lysa.fun uses the one above.

## Risks

**An early chain, memecoins and bots. Know what you're buying.**

- Most go to 0: Memecoins usually do. Buy only what you can lose.
- Early chain: Elysium runs before Kinetiq's official opening.
- Bots trade: The caps and the fee slow them. They don't stop them.
- Chain 99901. Kinetiq has not yet said in public that it is Elysium's mainnet. If the opening changes the chain, the addresses here change too, and this page will say so.
- Lysa's copy of Uniswap V4. Lysa's pools are not on Uniswap's own, and stay where they are for good.
- Lysa's servers can stop: the relay, its poster, the indexer, the image host. On chain nothing stops, and anyone can post a signed transaction through HyperEVM's Inbox.
- Elysium's bridge is run by others. A withdrawal waits about 5½ days, and a 4-of-11 Safe can upgrade it at once.
- Other pads' coins follow their own contracts. lysa.fun shows them and routes to them, nothing more.
- Copycat sites. Lysa lives at lysa.fun, bridge.lysa.fun, rpc.lysa.fun and img.lysa.fun. Lysa never asks for a seed phrase or a private key.

## How Lysa earns

**Lysa earns when people trade, and half of it buys $LYSA.**

- 0.3%: Of every trade of a Lysa coin, from any app or bot.
- 0.2%: Of every trade lysa.fun sends, whichever pad's coin.
- 50%: Of both buys $LYSA back on the market.
- 0.3%: Every Lysa coin's trades
- 0.2%: Every trade sent by lysa.fun

→

- Lysa's revenue: In HYPE, from trading

→

- 50%: Buys $LYSA back
- 50%: Stays with Lysa

### Try the numbers

| Source | Rate | Notes |
| --- | --- | --- |
| Lysa coins' trades | 0.3% | The protocol's part of the 1% fee, on every trade, whoever sends it |
| lysa.fun's trades | 0.2% | Any pad's coin, through lysa.fun's routers |
| The bridge | 0.5% | Deposits into Elysium, until Elysium's official bridge opens |
| Launches | 0 HYPE | No launch fee today |

The creators' 0.7% is theirs, never Lysa's. Half of the 0.3% and the 0.2% buys $LYSA back; the bridge's fee does not.

For scale: Pons, a launchpad on Robinhood Chain, another young Arbitrum Orbit chain, earned about $3.35M in the 30 days of its first version, measured on chain. That is another chain and another team, not a forecast for Lysa.

## $LYSA

**Lysa's own coin, launched on Lysa, on the same rules as everyone's.**

- 11-09: Launched on Lysa's own factory, with the same caps and fees as any coin.
- Buybacks: Half of Lysa's trading revenue buys $LYSA, in small slices, and keeps it.
- 5% shown: Lysa's dev buy sits in the treasury, in plain sight on chain.

### Buybacks: a slice, only under the target

Each day one slice is ready. It buys only while $LYSA is below its target; otherwise it waits and joins the next.

### The launch

- A fair launch on Lysa's factory on 11-09: the same 24-second caps, the same sniper fee rules, no special path.
- Lysa's dev buy of 5% goes to the treasury, shown, not locked. $LYSA's own 0.7% goes to Lysa.
- The name Lysa, the ticker $LYSA, the mascot's face as its image.

### The buybacks

- Equal slices on a published schedule, funded by half of the 0.3% and the 0.2%.
- A slice buys only while $LYSA trades below its target, proposed as its 7-day average. Above it, the slice waits.
- By hand from Lysa's wallet at first, then a contract anyone can trigger, with no keeper.
- What they buy stays in the treasury, not burned, and every buy is on chain.

### What ties $LYSA to Lysa

The more people launch and trade through Lysa, the more HYPE the buybacks spend on $LYSA. That is the whole link. It is not a promise of a price, of returns or of any payout.

The treasury holds Lysa's 5% and what the buybacks buy. Lysa may one day use part of it for the people who build on Lysa early: creators, traders, agents. Nothing like that is promised, and nothing has a date.

## Snipers on Elysium

**What bots did to the launches on Elysium, and what a falling fee changes.**

- 8 s: Four bots in, on each of two fresh launches with a dev buy.
- 35% → 5%: Launches a top bot hit in its first minute: no sniper fee, then a working one.
- −33%: What Lysa's default fee would have cut from the top 25 bots' profit.

### The first five minutes of a launch

- 0–8 s. The bots arrive. They pay 200–450 times a launch's gas to land in the next one to three HyperEVM blocks.
- 0–24 s. Lysa's shield: the caps, and a fee falling from 10% to 1%.
- About 3 min. The median bot sells, 165 s after it bought. When a creator sells, a holding bot follows within 30 s in about half the cases.

### When the first outsider buys

### Who gets sniped in the first minute

### Named formulas

The fade f(t) = s − ⌊(s − b) · t / W⌋

The fee at second t, from a start s down to the base b over a window W. Lysa's default: s 10%, b 1%, W 24 s. Run against the top 25 bots' trades, it takes 84.7 of their 254.3 HYPE profit and turns 208 of 825 winning trades into losses.

Snipe odds P = σ(−5.05 + 1.07·D₀.₁ + 0.59·D₀.₅ + 0.79·F − 0.30·log₂(1+L) + 0.68·log₂(1+A) + 0.76·H − 1.45·S)

D: a dev buy of at least 0.1 or 0.5 HYPE · F: a creator's first launch · L: their earlier launches · A: the launchpad version's age in hours · H: 12–23Z · S: a working sniper fee. n 1,762, McFadden R² 0.33, before each pad's own term.

The gas race land first ⇔ post within k = 1–3 blocks at r = 200–450× the launch's gas

Of 121 fast buys, none landed in the launch's own HyperEVM block. Bots paid a median 45 gwei against 0.10 for launches.

Bots pay creators creator's take = 0.7 · fee · V bots + tax · V bots

On Lysa, a bot buying in second 0 pays 10%, and 7% of its buy goes to the creator's fee wallets.

These are associations in public chain data, not causes. Read 10-27 → 11-02 on chain 99901.

## Launch from an agent

**An agent can launch and trade on Elysium with no node, no sign-up, and no key handed to anyone.**

- 0 infra: No node, no account, no API key. The agent signs where its key already is.
- 1 call: A launch is one call to Lysa's factory. A trade is one call to its router.
- Live today : agents.txt: the recipe any agent can follow now.
- 1 · Read: The terms and the board from lysa.fun, or a quote.
- 2 · Build: The transaction, simulated first, so it can't surprise anyone.
- 3 · Sign: Where the key is: the user's wallet or keystore. Never sent anywhere.
- 4 · Send: Through rpc.lysa.fun. It lands on Elysium in seconds.

| Tool | Status | What it does |
| --- | --- | --- |
| agents.txt | Live | The launch call, its rules and a cast recipe, checked against the live chain |
| Agent API | Building | Terms, image, launch, quote, buy, sell: each returns a ready, simulated transaction |
| Claude Code skill | Building | Launch and trade from a terminal, with the user's own keystore |
| lysa-mcp | Building | The same as an MCP server, for any client without a shell |
| Bankr | Next | A Lysa skill in Bankr's format, so its agents can launch on Elysium |

- Launch from a post. In March 2025 a post from Grok got Bankr to launch a coin, $DRB, on X. That is the kind of launch Lysa wants one call away on Elysium. Bankr's chains do not include Elysium yet.
- Safe by default. Lysa's tools will ask for a confirm on every send, with limits of 1 HYPE a transaction and 3 HYPE a day, and a dry run. Within them, an agent may launch on its own.
- Same rules as people. An agent's launch meets the same caps and the same bounds. It can't skip them.

| Read | At https://lysa.fun/api/v1 |
| --- | --- |
| Board | /board?pad=all|lysa|kleos|boxa|elysp|ascend&sort=new|hot|top|vol |
| Coin | /token?token=0x… |
| Trades | /trades?token=0x… |
| Candles | /candles?token=0x…&tf=1m |
| Wallet | /wallet?addr=0x… |
| HYPE in USD | /hype |

Public, rate-limited, for display. For anything that moves money, read the chain itself.

## What's next

**Lysa grows with Elysium: more ways to launch, more to trade, more for creators to build.**

Live

### Hooks

Lysa's hook: the sniper fee, the caps, the creator tax, up to five fee wallets. A fee wallet can be a contract, so a coin can pay a buyback, a vault or a cause with no new hook. New hooks land here as they ship.

Live

### Swap and the board

Every pad's coins in one place, traded in one prompt, with the dev's sells and the real fees on the row.

Building

### Agents

An API, a Claude Code skill and an MCP server, so any agent can launch and trade on Elysium.

Next

### The terminal

The board and coin pages are its first half. Next: every trade live, sharper filters, a buy in one tap.

Idea

### Liquidity from Base

An agent or app on Base pays USDC over x402, and Lysa buys the Elysium coin for it. New money reaches Elysium's coins with no bridge step.

Idea

### More than HYPE pairs

Tokenized stocks already reach Elysium. As Elysium adds assets, Lysa's pads and board follow them.

### Why Elysium

- Kinetiq describes Elysium as a token generation platform for Hyperliquid: a token starts in an Elysium pool and can grow to HyperCore's order books and a perp. Lysa wants to be that first step.
- Gas is HYPE, and Elysium settles to HyperEVM, so a coin launched here lives next to Hyperliquid's own users and money.
- A quarter of Elysium's sequencer fees go to builders on it, as reported.

Kinetiq's own docs could not be read directly; the points above are as others quote them.