How Groopy works

Overview

A launch on Groopy has four steps, and every one of them is an on-chain action by the Groopy program on Solana:

1. Set up the launch. The organizer picks the token’s name, symbol and metadata, the launch type, where fee rewards go, and the funding terms. Their own contribution is paid right away and takes slot 1.
2. Invite the group. One room link goes into the chat. Each friend picks an open slot and funds it, up to the per-wallet limit.
3. Approve and launch. The organizer approves each wallet. Once approved funding reaches the target, launch creates the coin on Pump.fun and spends the whole raise on the first buy, in the same transaction.
4. Claim your share. Every approved wallet claims its allocation, plus fee rewards as the coin trades.

Groopy never holds your keys. Contributions sit in the room’s own program account until launch or refund, and every move is a transaction you sign in your own wallet.

Rooms

A room is one planned launch. It stores the token details, the launch type, the funding terms and a slot for every wallet that joins. The organizer chooses the terms when creating it, and they are locked from then on, so everyone who joins sees the same deal:

• Raise target. How much SOL the group is raising. Launch becomes possible once approved contributions reach it.
• Maximum wallet. The largest share of the raise any one wallet can put in, so no single wallet dominates the group.
• Wallet capacity. How many slots the room has, up to 100.
• Unlock. Whether allocations are claimable at once or vest linearly over a chosen period.
• Fee rewards. Whether the room’s share of trading fees goes to every contributor or to the organizer alone.

Rooms are either public or private. A private room is joined through its invite link; a public room is listed on Explore and anyone can fund a slot. See public and private rooms.

Funding and approval

Joining a room means picking an open slot and sending SOL into the room, from 0.05 SOL up to the wallet limit. Until the organizer approves the wallet, the contributor can add to it, reduce it, or withdraw it entirely.

The organizer reviews every funded wallet. Approving locks the contribution in; rejecting refunds it and reopens the slot. The organizer can also pause funding, or replace the invite link if it leaked. In public rooms the approval queue flags wallets that have not linked an X account.

Launch needs two things at once: approved contributions at or above the target, and every funded wallet approved or rejected. Then the organizer presses launch.

Launch types

Pump.fun launch (live)

In one transaction the room creates the coin on Pump.fun, as its creator, and spends every approved lamport on the opening buy. Because creation and the group’s buy happen together, nobody can buy between them: the group is first on the curve by construction.

Contributors then claim the tokens the group bought, pro rata by contribution. The room, as the coin’s creator, earns Pump.fun’s creator fee on every trade while the coin is on the bonding curve. Raises are capped at 60 SOL on mainnet so the buy fits on the curve.

OG Launch on Meteora (live)

The room mints a 1B supply token with its metadata, revokes mint authority, and in the launch transaction seeds a full-range Meteora DAMM v2 pool with every approved SOL plus the public supply. The position is locked forever, so the liquidity can never be pulled. The pool charges a 1% swap fee in SOL, which is the room’s fee reward, split the same way as Pump.fun creator fees. There is no bonding curve and no cap on the raise beyond the protocol maximum.

Groopy Launch (coming soon)

Half the public supply goes to a 30-minute descending auction. The price halves every 3 minutes down to a floor, and every buyer pays one clearing price. Settling opens the Meteora pool at that price with the group’s SOL, the auction proceeds and the unsold supply. Built and unit-tested; it opens once its end-to-end run on devnet is in.

StonkFun (coming soon)

Pair your coin with a stock, a currency or any token, through Raydium LaunchLab.

Allocations and vesting

Your allocation is your share of what the group bought, by contribution: put in 10% of the raise, claim 10% of the tokens. Allocations are pulled, not pushed, so each wallet claims from the room page whenever it likes; one Solana transaction cannot pay a hundred wallets at once.

If the organizer chose a lockup, allocations vest linearly over that period from the moment the launch settles. The room page shows how much has unlocked, and you can claim the unlocked part at any time. The options run from an hour to a year; public rooms default to three months, private rooms to none.

Fee rewards

The room is the coin’s creator, so it earns Pump.fun’s creator fee on every trade, in SOL. Anyone can collect the fees into the room. Of what comes in, 30% supports Groopy and 70% is the room’s reward pool, paid out one of two ways, chosen by the organizer at creation:

• Contributors. Every contributor earns their allocation share of the pool, claimable from the room page.
• Organizer. The organizer receives the whole pool.

That continues after a coin graduates to PumpSwap, and the same Collect button picks those fees up. Meteora launches earn the pool’s 1% swap fee instead, split the same way.

Refunds

A room has 24 hours from creation to launch. If it has not launched by then, anyone can mark it expired. The organizer can also cancel at any point before launch. In both cases every contributor reclaims their full contribution from the room page, and rejected wallets are refunded when they are rejected.

Public and private rooms

The organizer picks one when creating the room, and it cannot change later.

• Private, suggested for memes among friends. Joining needs the invite link, and the room stays off every list while it is raising. Once the coin launches it appears on Explore like any other, but who contributed is shown only to the group and its organizer. Only a hash of the invite code is stored on chain; on-chain data is public, so private means invite-only with a hidden roster, not secret.
• Public, suggested for projects and companies. Listed on Explore, and anyone can fund a slot without a link. The organizer still approves every wallet, and the organizer and every joiner must link an X account first.

A private room that never launches is counted in profiles and analytics but not named. Once launched, its coin is listed everywhere; its contributors are not.

Telegram

The Groopy bot runs a launch from inside a Telegram group:

• /launch starts a room for the chat.
• /link posts an existing room into the chat, after the organizer confirms with their wallet.
• /stats shows how the chat’s rooms did.

The bot posts updates as they happen: contributions with the percentage funded, approvals, a reminder while wallets wait for approval, fully funded, launched and claims open, unlock milestones, cancelled or expired. Inside the Mini App, members can sign once to show their Telegram name instead of their wallet address.

Profiles and X

Every wallet has a profile at /u/<wallet>: its holdings from group launches with price, value and the gain or loss against what it put in, a portfolio value chart, the rooms it organized and joined, and fees claimed.

Wallets get a generated name from their address, like FuzzyCloudFox, so the same wallet reads the same everywhere. From your own profile you can pick a name of your own by signing a short message with your wallet; nothing goes on chain. A linked X account shows on the profile with its picture, and is used as the name when no custom name is set.

Linking X means signing in with X and then signing a message with your wallet to tie the two together. Public rooms require it for the organizer and every joiner.

Analytics

Analytics shows platform-wide activity without connecting a wallet: SOL raised, launches, fees and Groopy revenue by period, a daily chart, the week’s launching, top coins by market cap, where the fees went, graduations, and all-time facts. Public and private rooms count in every total; only public launches are listed by name. Market caps come from each coin’s Pump.fun bonding curve at the time of the read.

Limits

Protocol limits live in an on-chain config that Groopy can update; the figures above are the current defaults.

FAQ

Does Groopy hold my SOL?

No. Contributions sit in the room’s program account on Solana until launch or refund, and only your wallet can move them.

Can someone snipe the coin before the group?

No. The coin is created and the group’s buy is made in the same transaction, so there is no moment in between for anyone else to buy.

What if the room never launches?

After 24 hours anyone can mark it expired, and every contributor reclaims their full contribution.

Can I change my contribution?

Yes, until the organizer approves you. After that it is locked in for the launch.

Do I need an X account?

Only for public rooms. Private rooms among friends need nothing but a wallet.

Which wallets work?

Phantom, Solflare, Backpack and other Solana wallets. On a phone, open the room link inside the wallet app’s browser.