Skip to content

README.md

Latest commit

 

History

History
84 lines (54 loc) · 6.08 KB

README.md

File metadata and controls

84 lines (54 loc) · 6.08 KB
Raw

Proof Launch

Proof Launch

Shared token launches. Equal entry. Shared trading fees. A pre-launch commitment layer on top of Solana's leading launchpads — Pump.fun, Meteora DBC, and Raydium LaunchLab. Communities form before a token exists. A token can only launch once all its backer slots are claimed, and when they fill, the token's shared pool wallet executes ONE atomic create + first-buy on the creator's chosen launchpad. Every backer enters at the identical price. Dev holds zero. Trading-fee rebates route back to genesis backers proportional to slot share.

🌐 prooflaunch.fun · 𝕏 @ProofLaunch

How it works

  1. Submit. A creator submits a meme and sets 2–8 backer slots, each with a minimum SOL contribution. Submission costs 0.02 SOL (non-refundable, anti-spam tax). The platform provisions two keypairs per meme: a pool wallet (collects backers' SOL) and a sub-escrow wallet (becomes the coin's on-chain coin_creator, isolates the coin's future trading fees).

  2. Back. Backers claim slots first-come, first-served. Each backing transfers SOL directly into the meme's pool wallet on-chain. Backers can withdraw at any time during the backing phase (2% fee).

  3. Launch. When all slots fill, the creator clicks Launch. The pool wallet executes a single atomic create + first-buy transaction on the creator's chosen launchpad — Pump.fun's createV2 + buy, Meteora DBC's createPoolWithFirstBuy, or Raydium LaunchLab's createLaunchpad. All three converge on the same guarantees:

    • The token is created in the same block as the first buy → zero sniper gap.
    • The buy spends the entire pool balance → every backer enters at the same price.
    • The creator (sub-escrow) holds no tokens directly → dev allocation is 0%.
    • Every Proof Launch token's contract address ends in …pooL so anyone can verify on-chain that it's a real Proof launch.

  4. Distribute. Each backer's proportional share of the pool's tokens is automatically sent to their wallet in the same request as the launch. No claim button required.

Refund protection

Two automatic safety nets ensure backer SOL is never permanently stuck:

  • 3-day backing deadline. If slots don't fill within the creator's chosen window, every backer is automatically refunded 100% (no fee).
  • 24-hour launch window. Once funded, the creator has 24 hours to launch. If they don't, every backer is automatically refunded 100% (no fee). Closes the abandonment hole where a creator could leave backers waiting indefinitely.

Both refund paths run on the same hourly cron via the proven refundMemePool function — no support tickets, no human in the loop.

Trading fees

Each supported launchpad (Pump.fun, Meteora DBC, Raydium LaunchLab) routes a share of every trade on a launched token back to an on-chain creator vault keyed off the token. Because each Proof token has its own per-token sub-escrow registered as that creator, fees isolate exactly per token and are independently verifiable on-chain.

Hourly, a cron job:

  1. Calls collect_creator_fee on each coin's vault → drains to that coin's sub-escrow.
  2. Sweeps the sub-escrow → shared platform escrow.
  3. Splits 90% to backers (proportional to backing size) / 10% to the platform.
  4. Credits each backer's claimable_fees_sol in the database.

Backers claim their share with one click (per-meme or aggregate "Claim All") — payout is a single SOL transfer from escrow to the backer's wallet.

Stack

  • Frontend: Next.js (App Router) + React + TypeScript, hosted on Vercel
  • Wallet: Solana Wallet Adapter (Phantom, Solflare, …)
  • Database: Supabase (Postgres + RLS)
  • Chain: @solana/web3.js
  • Token launches:
  • Bundling: Jito (with RPC fallback) on the Pump.fun path
  • Security: First integrator project at 100% compliance with SOL-029/030/031 (simulate-before-send, adaptive priority fees, Jupiter quote freshness)

Multi-launchpad dispatcher: src/services/launch/ — each launchpad has its own adapter implementing the same launch(params) → LaunchOutcome shape, dispatched off memes.launch_platform. Fee collection + distribution: src/services/distribution.ts. Key encryption (AES-256-GCM) + signature verification: src/lib/crypto.ts.

Local development

npm install
cp .env.example .env.local
# Fill in .env.local with your Supabase, Solana RPC, and escrow wallet credentials
npm run dev

See .env.example for required environment variables. The repo intentionally ships no secrets — you must provision your own.

Database schema lives in supabase/migrations/. Apply them via the Supabase SQL editor in order.

Security

Backer funds are non-custodial in the sense that they sit in a per-token pool wallet (one wallet per token, not a global pot) until the token either launches or refunds. Pool wallets are controlled by the platform; their behavior is constrained to exactly two actions: launch (atomic create + first-buy on the chosen launchpad — Pump.fun, Meteora DBC, or Raydium LaunchLab) or refund (return SOL to original backers). No third action is possible from the API surface.

See SECURITY.md for responsible disclosure and audit status.

⚠️ Not formally audited by a third-party firm. Meme coins are highly speculative. Don't back more than you can afford to lose.

License

AGPL-3.0 — fork and modify freely, but if you run a modified version as a network service you must publish your source.