Using PIT

Getting started

You need a wallet on Robinhood Chain. There is no account and no sign-up. The site never holds your funds; every transaction is signed by your wallet.

1. Add Robinhood Chain to your wallet. Chain id 4663. RPC https://rpc.mainnet.chain.robinhood.com. Explorer https://robinhoodchain.blockscout.com. Gas is paid in ETH.
2. Get ETH or USDG on the chain. /bridge brings money in from another chain and lands it in your own wallet. USDG is the dollar quote asset; it has 6 decimals.
3. Press Connect in the header and pick your wallet.
4. Open /discover and pick a token, or /launch to make one.

The pages

Launch on the curve

A curve launch sells 80% of the supply along a bonding curve, a price line that rises as more is sold. When it sells out, the token graduates into a locked Uniswap v4 pool. It is the shape to pick when you want price discovery before a pool exists.

Step by step

1. Open /launch and choose the curve.
2. Enter the name, ticker, image, description and links. This is what the board and the token page show.
3. Pick a preset. The table below has the three.
4. Choose your fee split. Your 30 bps of every trade go through the fee router, and you fix at launch how they split between four legs: stakers (paid to the Vault), buyback, liquidity and creator. A stakers leg is refused until the house coin exists.
5. Optionally make a first buy in the launch transaction. For an ETH launch, any value you send above the launch fee is your first buy. For a USDG launch you set the amount. You can lock that first buy in the first-buy locker for 7, 30, 90 or 180 days. It earns nothing there, and it tells buyers you cannot sell it into them.
6. Confirm. You pay the launch fee of 0.002 ETH plus your first buy. The fee goes to the house.

The launch block belongs to you: only the creator can receive tokens in it. Trading opens the next block.

Presets

Every preset: supply 1,000,000,000; 80% on the curve; 20% reserved to seed the pool; trade fee 1%, of which 70 bps to the Bag and 30 bps to the creator. The factory requires at least 8,000 bps of the raise to go to liquidity. The start cap is the market cap at the first token sold; the graduation cap is the market cap when the curve sells out.

The copycat lock

A ticker (case does not matter) or an image already used by a launch that did 25 ETH, or 100,000 USDG, of volume in 24 hours is locked for 48 hours. The lock refreshes every hour while the volume holds. A launch that hits it reverts.

What happens next

1. Buyers pay the curve, sellers sell back to it. Every trade pays 1%. No penalties apply on the curve.
2. When the curve sells out it stops trading. Anyone, usually the keeper, calls finalize().
3. The token graduates. The raise, less the graduation fee, and the reserved 20% go into a full-range Uniswap v4 pool, priced at the ratio the raise came out at. The position stays in the graduator forever.
4. The graduation fee goes to the Bag: half to the house, a quarter to the Vault, a quarter as Confetti to the token's pot.
5. From now on the pool charges 1% plus its own 0.3% fee. Anyone can call collect: the token side is burned and the quote side goes to your fee split. Any jeet or whale tax you set at launch applies from here.

Launch a direct pool

A direct launch puts the whole supply into a Uniswap v4 pool in the launch transaction. The token trades from the first block. A hook on the pool takes the 1% fee, your own tax and any penalties you switch on. Every setting below is fixed at launch and cannot change.

Step by step

1. Open /launch and choose the direct pool.
2. Enter the name, ticker, image and description. Pick the quote asset: ETH or USDG.
3. Set your tax, 1% to 10% per side (100 to 1,000 bps). Buyers and sellers pay it on top of the 1%. Set the allocations for it: creator, buyback, dividends to holders, liquidity. They must add up to 100%.
4. Set the snipe tax. It starts at the rate you pick and decays quadratically to zero over up to 600 seconds. The app's default is 50% over 3 seconds. Your tax plus the snipe tax can never exceed 99%.
5. Set the opening window. For a number of blocks, up to 1,200 (about 2 minutes at 100 ms blocks), no wallet may hold more than your hold cap or buy more than your buy cap. The buy cap is at most 1.1x the hold cap. The default is 30 blocks. Selling is never capped.
6. Set the penalties: a jeet tax of up to 25% on sells within a window of up to 1 hour after the buy, and a whale tax of up to 25% on a sell that moves the price more than your tick limit, up to 2,000 ticks. Choose whether the holders' share of penalties goes to the token's pot or to the Vault.
7. Optionally switch on king of the hill: up to 50% of the holders' share of every penalty feeds a pot that the last crowned buyer wins 60 seconds after the last crown.
8. Optionally open a sniper auction for the first slot after your launch block: a window of up to 300 blocks in which nobody can buy and bids are taken instead.
9. Optionally set an initial buy. It goes straight through the PoolManager in the launch transaction.
10. Confirm. You pay the launch fee of 0.002 ETH plus your initial buy. The launch block is yours alone.

Where your tax goes

The 1% platform fee splits 30 bps to you and 70 bps to the Bag on every trade. Your own tax lands in the token's revenue splitter and is split by your allocations. Your creator leg waits for you to claim it on the token page or in your portfolio. The dividends leg pays holders through the pot. The buyback leg is spent by a shared module that buys the token and burns it. The liquidity leg is pushed into the locked position.

If you, or the wallet that receives your fees, sell into your own pool, every creator fee you have not claimed moves to the holders in the same transaction. That is the creator slash. Claim first, and do not sell into your own pool if you want to keep your fees.

The sniper auction, in practice

• Bids are in your quote asset. For ETH the minimum bid is the launch fee. Each bid must beat the last by 5%.
• A bidder who is outbid gets the money back at once. If the refund cannot be delivered, it is booked and taken with claimRefund.
• After the window, the winner alone can receive tokens from the pool for 20 blocks.
• Anyone can settle after the window. Half of the winning bid goes to your token's pot for the holders, half to the locker as liquidity.
• No bids: the pool opens after the window, as if there had been no auction.

How to trade

Open a token from the board. The token page shows the chart, the tape, the holders and the creator's terms. Buy and sell live on the same page. Every transaction is built by the site and signed by your wallet.

What a trade costs

• 1% of the trade, always. 30 bps go to the creator, 70 bps to the Bag.
• On a direct launch, the creator's tax on top: 1% to 10% per side, shown on the token page.
• On a graduated pool, the pool's own 0.3% fee on top.
• Penalties, when they apply and the creator set them: the snipe tax in the first seconds after a direct launch, the jeet tax on a sell soon after your buy, the whale tax on a sell that moves the price too far. Each is at most 25%, except the snipe tax, which starts where the creator set it and falls to zero.

Read the terms box on the token page before you buy. On a curve launch nothing but the 1% applies until graduation.

What you see on the tape

The tape lists every trade on the token: buy or sell, the wallet, the size in the quote asset, the tokens moved, the price and the time. Fees and penalties are taken inside the transaction, so the amount you paid is more than the pool received on a buy, and the amount you received is less than the pool paid on a sell. The Bag page has a second tape that lists every fee and penalty and where it went.

Things that can make a trade revert

• Buying in the launch block: it belongs to the creator.
• Buying during a sniper auction window, or in the 20 blocks after it if you are not the winner.
• Buying over the hold cap or the buy cap during the opening window. The hold cap applies to plain transfers too.
• Selling with an exact output amount on a graduated pool that has penalties. Sell with an exact input instead.
• The first sell of a token on a pool may need extra approvals before the swap. The site asks for them one at a time.

How you get paid as a holder

Every token has a pot. The pot pays the token's holders in proportion to what they hold. You do nothing to earn from it: holding is enough. Your claim grows as money arrives, and the token updates the pot on every balance move.

What fills the pot

• Confetti, the graduation bonus: a quarter of the graduation fee, paid the moment a curve token graduates. Whoever holds the token at that moment gets a share.
• 80% of every penalty paid on the token, unless the creator sent penalties to the Vault. With king of the hill on, part of that goes to the king pot instead.
• On a direct launch, the dividends leg of the creator's tax.
• On a direct launch with a sniper auction, half of the winning bid.
• Payday's slice for the ten newest launches: up to 10% of every hour's Payday.
• On a direct launch, the creator slash: the creator's unclaimed fees when the creator sells.

The 5-minute push

The keeper calls pushMany on every pot every 5 minutes. It pays every holder whose claim is above 0.0001 ETH (1e14 wei), straight to the wallet, and the keeper pays the gas. If your claim is below the floor it stays in the pot until it grows past it, or until you claim it yourself. Payouts land in /ledger and under "Paid to you" in /portfolio.

Claiming yourself

claim(account) is open to anyone, and it always pays the holder. The claim button on the token page and in your portfolio is the fallback for what is booked and not yet pushed. You pay the gas for that one.

Contracts never earn: the curve, the graduator, the pot, the first-buy locker, the staking contract, the PoolManager and the hook are excluded from the share.

Payday for traders

Payday pays traders every hour from 10 bps of every trade and 5% of every penalty. The hour's money is split by points. You do not claim it: the keeper sends it to your wallet.

The hourly payout

• An epoch is one hour. After it closes, the keeper (or the factory owner) calls pay for it, once per hour per asset.
• One payout covers at most 500 wallets and 10 pots.
• Up to 10% of the hour goes to the pots of the ten most recent launches. The holders of those tokens get it.
• The rest goes to wallets in proportion to their points for that hour.
• Anything not paid carries into the next hour. Claims under 1e13 wei are not paid.

Points

Points are computed off the chain by the API. They are not a token. They decide how an hour's Payday, and the season drop, split. Trading against your own launch does not score.

Rank is re-earned from rolling 30-day volume, not kept. /leaderboard shows the season's points and ranks.

The Vault for lockers

The house coin has not launched yet. Until the factory owner sets it in the Vault, nothing can be locked and the Vault pays nothing. Its share of every fee waits in the Bag and can be released to the Vault once the coin exists.

The Vault pays people who lock the house coin. It is on /lock. Rewards come in the assets the fees were paid in: ETH, USDG, up to 8 assets in total. A position is owed a list of assets, not one number.

Tiers

A lock longer than 365 days reverts. A lock between tiers gets the multiplier of the tier it reached. The multiplier is your weight when rewards are shared.

What pays in

• 30 bps of every trade on the site, through the Bag.
• A quarter of every graduation fee.
• Half of the house coin's own trade leg.
• The stakers leg of curve launches whose creator chose one.
• Penalties on tokens whose creator chose "penalties to vault".
• Confetti from a graduated launch with no pot.

Claim, unstake, demote

• claim(id) is open to anyone and always pays the position's owner, every asset at once. The keeper can push it for you.
• You can unstake only after your unlock time.
• demote(id) is open to anyone after unlock and resets a position to 1x. An expired lock does not keep its weight.
• Rewards that arrive while nothing is staked go to the first staker.

A creator's locked first buy is not in the Vault. It sits in the first-buy locker, earns nothing, and unlocks after 7, 30, 90 or 180 days.

Boosts

A boost puts a token in a paid slot on the board for one hour. There are 4 slots per hour. The price is 0.005 ETH by default; the factory owner can set it up to 0.05 ETH. You can buy a slot for the current hour or the next one. A token can hold one slot per hour. Every boost payment goes to the house.

Referrals

/refer gives you a link. A wallet that arrives through it is tied to you once it connects. From then on you earn 10% of that wallet's trading points, on top of theirs, for trades made after the two of you were tied. Referral points are not multiplied by rank.

Separately, the owner can set an on-chain referral cut for a token: a referrer address and a share of at most 5,000 bps of the Bag's share of that token's fees. It comes only from the protocol's side, never from the creator or the holders.

The season drop

At the end of a season, a share of what the protocol earned is dropped to every wallet that earned points, in proportion to points. Off the chain the pool is 30% of the season's protocol take. /airdrop shows the pool and your share.

1. The season closes and the leaderboard is frozen.
2. A Merkle tree is built with every wallet's amount.
3. The owner opens the season on the chain and funds it in the same transaction.
4. Claims are open for at least 30 days. Anyone can claim for anyone; the money always goes to the listed wallet.
5. After the deadline the owner can sweep what was not claimed back to the treasury. There is no rescue function before that.

No token is promised. The drop pays in the assets the protocol earned.

The Bag page

/bag shows what came into the Bag, per asset, and where it went: the house, the Vault, Payday, the burn clock and Confetti. It shows the shares held for the Vault and the burn while the house coin does not exist. It shows the Payday clock for the current hour, the burn clock, the boost slots, the contract addresses and the wall of shame: the wallets that paid penalties.

"Shown live" means this: every number is read from the Bag's own events on the chain by our indexer, and the page refetches the moment a new receipt lands. Nothing on it is typed in by hand. A figure the indexer cannot compute honestly, such as a dollar value for an asset with no price, is shown as a dash with the reason, never as a zero. The chain is authoritative if the page and the chain ever disagree.

Glossary

The Bag

The contract that receives the protocol's share of every fee and splits it by four fixed rules. No owner, no withdrawal.

The house

Our share. Paid out of the Bag by the rules; never a share of the creator's fees.

The house coin

The platform's own token. Not launched yet. The only coin the Vault stakes and the only coin the burn clock burns.

The token's pot

The contract that pays a token's holders in proportion to what they hold. A HoodPot on curve launches, the revenue splitter on direct launches.

Confetti

The graduation bonus: a quarter of the graduation fee, paid into the token's pot the moment it graduates.

Payday

The hourly payout to traders, split by points, with a slice for the pots of the ten newest launches.

The Vault

The staking contract for the house coin. Lock tiers from flexible (1x) to 180 days (2.5x). Rewards arrive in the assets the fees were paid in.

The burn clock

The contract that buys the house coin once an hour per asset and burns it.

The keeper

Our off-chain service. It pushes pot payouts every 5 minutes, calls Payday and the burn every hour, and pays the gas.

The curve

A bonding curve: a contract that sells a token at a price that rises as more is sold, then graduates into a pool when it sells out.

Direct pool

A launch whose whole supply goes straight into a Uniswap v4 pool, with a hook that takes the fee and the creator's terms on every swap.

The hook

The contract attached to a direct launch's pool. It applies the fee, the creator's tax and the penalties.

Graduation

The moment a curve sells out and its raise plus the reserved 20% of supply become locked liquidity in a pool.

The graduator

The contract that opens a graduated pool and keeps the position forever. It has no transfer and no decrease-liquidity function.

Preset

A fixed set of curve parameters: start cap, graduation cap, share of the raise that goes to liquidity, fees.

Quote asset

What a token is priced in and what fees are paid in: ETH or USDG.

bps

Basis points. 100 bps is 1%. 10,000 bps is 100%.

Creator tax

On a direct launch, an extra 1% to 10% per side chosen by the creator and split by his allocations.

Allocations

How the creator's tax splits: creator, buyback, dividends to holders, liquidity. They add up to 100%.

Snipe tax

A surcharge on buys in the first seconds after a direct launch. Decays quadratically to zero over up to 600 seconds.

Opening window

The first blocks of a direct launch, when no wallet may hold or buy more than the creator's caps. Up to 1,200 blocks.

Jeet tax

A charge of up to 25% on a sell made within the creator's window after the buy (at most 1 hour).

Whale tax

A charge of up to 25% on a sell that moves the price more than the creator's tick limit (at most 2,000 ticks).

Penalties to vault

A creator option that sends the holders' share of penalties to the Vault instead of the token's pot.

King of the hill

On a direct launch, a pot fed by penalties that goes to the last crowned buyer 60 seconds after the last crown.

The sniper auction

On a direct launch, an auction for the first slot after the creator's block. Half of the bid goes to the holders, half to liquidity.

The creator slash

On a direct launch, when the creator sells into his pool, his unclaimed fees move to the holders.

First-buy lock

A creator's own first buy held in HoodTokenLock for 7, 30, 90 or 180 days. It earns nothing.

Copycat lock

For 48 hours after a launch that did 25 ETH (or 100,000 USDG) of volume in a day, its ticker and image cannot be reused.

Boost

A paid slot on the board for one hour. 4 slots an hour, all proceeds to the house.

Points

An off-chain score computed by the API from trades, launches, locks and referrals. It splits Payday and the season drop.

Rank

A multiplier on your points, 1.5x to 5x, set by your 30-day volume.

Season drop

A Merkle-based airdrop of a share of what the protocol earned in a season, claimable for at least 30 days.

Epoch

One hour. Payday pays one epoch at a time.

FAQ

Do I need an account?

No. You need a wallet on Robinhood Chain with some ETH for gas. The site never holds your funds.

What does a trade cost?

1% of the trade, always: 30 bps to the creator and 70 bps to the Bag. On a direct launch the creator's tax of 1% to 10% per side comes on top. On a graduated pool the pool's own 0.3% comes on top. Penalties apply only in the cases the creator set.

When do I get paid as a holder?

Every 5 minutes, if your claim is above 0.0001 ETH. The keeper pushes it to your wallet and pays the gas. Below the floor, it waits or you claim it yourself.

Why did my buy revert?

The launch block belongs to the creator. A sniper auction window blocks buys, and only the winner can buy for 20 blocks after it. During the opening window a buy that takes you over the hold cap or the buy cap reverts. The copycat lock reverts a launch, not a buy.

Why was I charged more than 1%?

A direct launch has the creator's tax. A graduated pool has the 0.3% pool fee. A buy in the first seconds after a direct launch pays the snipe tax. A sell soon after a buy can pay the jeet tax. A sell that moves the price past the creator's tick limit can pay the whale tax. The token page lists every one the creator set.

Can the creator change the fees after launch?

No. Fees, taxes, allocations, penalties and options are fixed at launch. Nobody can change them, including us.

Can anyone take money out of the Bag?

No. The Bag has no owner and no withdrawal function. It only pays its four outlets by fixed rules. The house is paid by those rules like everyone else.

Where is the house coin?

It has not launched. The Vault and the burn clock wait for it. Their shares of every fee are held in the Bag and can be released once the coin exists. Nothing here promises it a date or a price.

Are points a token?

No. Points are a score computed off the chain by the API. They decide how Payday and the season drop split between wallets. They are not a balance owed to you.

What happens if the keeper stops?

Holders can claim from their pots themselves, and anyone can push for them. Curves can be finalized by anyone. Payday and the burn wait for the keeper or the factory owner; the money stays in place until then. Nothing moves to the wrong place.

API and events

The app reads from our indexer, an API that follows the chain and can be rebuilt from it. Nothing in it is authoritative over the contracts. Amounts are strings in the asset's smallest unit; price is quote wei per whole token. The full integration guide, with event signatures, topic hashes and custom errors, is docs/INTEGRATION.md in the repository. It predates the Bag, so the events of the Bag, Payday, the pots and the burn clock are not in it yet.

REST routes

Events the guide documents

Public RPC notes from the guide: eth_getLogs ranges above a few thousand blocks are refused, one request in flight at a time is the shape that works, there is no JSON-RPC batching, and historical state is pruned after about thirty minutes.