THE WALL TEXT

DOCS. HOW THE OPEN CALL WORKS, NUMBER BY NUMBER.

01Overview

Memepass Pad launches pump.fun coins and adds one thing: a buy with a meme. You buy a coin through the pass and attach one picture. The picture hangs on today's wall, and you get a bonus in the coin's tokens from its bonus pool.

Your bought tokens and the bonus wait in the cloakroom (locked) for 24 h and until the day ends. A buy-and-dump earns nothing.

Holders vote with red dots: a red dot locks tokens on a meme until the close. At the close the coin's top meme goes on view (x3 bonus for its author), and the best meme of the whole pad wins the day's SOL prize.

COMPROMISE, IN PLAIN WORDS

  • The idea asked for votes by a balance snapshot. Pump coins keep no holder list, so a red dot locks tokens instead (a vote escrow). Weight = tokens locked. The same tokens cannot vote twice.
  • The bonus exists only for buys through Memepass. A plain pump.fun buy of the same coin is untouched and gets nothing.
  • The topic and content check is an AI check run by the pad's worker, off chain. The chain only checks that the worker signed the meme.

02A day

WhenWhat happensWho
during the dayPasses hang memes. Each pass: bought tokens + bonus into a Lock. Red dots lock tokens on memes.buyers, holders
day end (00:00 UTC)New passes count for the next day. Voting on the old day stays open for the tail (6 h).—
close = day end + tailsettle_coin_day: the coin's top meme (most tokens, ≥ 3 voters) gets its award. settle_day: the best meme of the pad (most SOL power) gets the prize.anyone (keeper)
after the closewithdraw_vote returns every red dot's tokens. release returns bought + bonus once max(unlock_at, day end) passed. claim_prize pays SOL; claim_top pays the x3 award after its own lock.anyone pushes, funds go only to the owner

This preview runs 10-minute days so you can watch closes. Mainnet: 24 h days, closing at 00:00 UTC.

03The pass, step by step

  1. Drop a picture on the pass. The site converts it to PNG in your browser.
  2. The worker checks it: the file, the topic (AI), the rules (block lists), duplicates by perceptual hash (pHash, Hamming distance ≤ 8 to any meme of the coin is refused; an exact pHash anywhere on the pad is refused on chain). It pins the PNG on IPFS and signs a 44-byte attestation: "memepass:v1:" || sha256(program || mint || buyer || sha256(png) || phash || cid || day || expiry || nonce), valid 10 minutes.
  3. You sign one transaction: the Ed25519 precompile with the attestation + buy_with_meme(day, sol_in, min_out, min_bonus, ...). The program buys on the pump curve (or PumpSwap after migration) and computes the bonus from the real buy.
  4. Bonus = min(10 % of the tokens bought, 2M tokens, 2 % of the pool, what is left of the coin's daily budget). The daily budget: all bonuses of a coin in one day take at most 25 % of (its pool + what it already gave that day), so many wallets cannot drain the pool in a day. Tokens + bonus go into your Lock.
  5. Guards: the site passes min_out (the quote minus 3 %) and min_bonus (80 % of the quoted bonus); if the price or the pool moved further before your transaction lands, it fails and nothing is spent.
Worked example: 0.10 SOL buys 3,000,000 tokens -> nominal bonus 300,000. Pool 50,000,000: 2 % cap = 1,000,000. Bonus = 300,000. Locked: 3,300,000 until the release time.

04Where the money goes

Every coin's creator is its Fees PDA. collect (anyone, the keeper runs it) takes pump's creator fees and splits them:

The pool SOL is spent only by refill: it buys the coin back into the bonus pool through a Buyer PDA, guarded by a median of 7 price observations over 15 min, a max 0.5 % of the venue's SOL depth, 25 % of the pool SOL per refill and an interval. Anyone can press it (the pool row on the home page has the button).

The prize pot of a day with no winner rolls into the carry. A winning day takes its pot + at most 1x its pot from the carry.

05Parameters

Read live from the program's Config. Each coin keeps a copy of the params it launched with.

Reading the chain…

06Program

Program id

AccountSeedsHolds
Config["config"]admin, treasury, guardian, attestor, params, day length, prize books
Prize PDA["prize"]all prize SOL
Coin["coin", mint]params copy, token books (pool, locked, votes, awards), SOL books
Fees PDA["fees", mint]pump creator; pool SOL, dev and treasury shares
Vault PDA["vault", mint]owns the token vault: pool + locked + votes + awards
Meme["meme", phash]author, day, CID, bought, bonus, votes, power, voters, award, prize (permanent: the gallery and the duplicate guard)
Lock["lock", mint, buyer, day]bought + bonus until release
Vote["vote", meme, voter]locked tokens until the close
CoinDay / GDay["cday", mint, day] / ["gday", day]the day's top meme / best meme and pot (closed at settlement)
InstructionWho

07Errors

08Verify on chain

  1. The program id above is the one every transaction of this site calls (see any tx in an explorer).
  2. Config: attestor is the meme worker's key; guardian can only switch meme buys off.
  3. Every coin's pump creator is its Fees PDA ["fees", mint]: open the bonding curve account of any coin and compare.
  4. For any coin: the vault token balance equals pool + locked + votes + awards in its Coin account.
  5. For any meme: its Meme account holds the CID of the exact picture shown here (open /ipfs/<cid>).
  6. Prize PDA lamports = rent floor + carry + open pots + booked prizes.
Reading the chain…

09Admin powers

THE ADMIN CAN

  • pause new launches and passes;
  • change the params of coins launched later (within the bounds in the table);
  • rotate the attestor and guardian keys, only through a 4-day timelock (the guardian can cancel a pending attestor rotation);
  • switch meme buys on and off (the guardian can only switch them off);
  • hide a meme (with the guardian): it stops taking votes and loses its award. The award stays in the pool / the carry.

THE ADMIN CANNOT

  • move any user's tokens or SOL: locks, votes, awards and prizes can only go to their owner;
  • spend the pool except by a guarded refill buy;
  • change the params of a coin that already launched;
  • close the program's accounts or take the prize pot.

10Risks

11FAQ

Why was my meme refused?
The pass prints the reason: too close to an existing meme (the distance is shown), off topic, blocked, or you already got today's bonus on this coin.
Can I sell right after a pass?
No. That is the point: the tokens and bonus from a pass sit in the cloakroom until the release time. Tokens you bought elsewhere are free.
Why can't I vote with my pass tokens?
They are locked in the cloakroom. A red dot locks tokens you hold in your wallet.
Who pays me out?
Nobody has to: release, withdraw and claims are permissionless pushes. The keeper sends them; the cloakroom row has a Claim button too.
Does the same picture work on two coins?
No. The Meme account is keyed by the picture's perceptual hash, pad-wide: a picture hangs once.