Pump Social Capital
Solana Backend-First Developer Documentation
1. Overview & MVP Goal
Pump Social Capital is a social capital market built on Solana. It enables users to create a market for creators, buy/sell Creator Keys, and perform price discovery on-chain while earning creator fees from trading activities.
"On-chain first. Backend fast. UI simple."
MVP Requirements
- Connect Solana wallet
- Create creator market
- Buy and Sell Creator Keys
- Bonding curve price discovery
- Real-time creator and protocol fees
2. Architecture
The platform uses a Solana-first architecture. The backend is fast but the Solana program is always the single source of truth for balances and final pricing.
3. Smart Contracts (Anchor)
The main program is `pump_social_capital`. It utilizes Program Account Ledgers instead of standard SPL tokens for efficiency.
Key PDAs
Protocol Config PDA ["protocol"]
Holds authority, treasury, and global fee BPS settings.
Creator Market PDA ["creator_market", creator_id]
Maintains supply, reserve lamports, total volume, and specific creator fee settings. Uses immutable X ID.
User Position PDA ["position", market, wallet]
Tracks exact key balances and PnL data per user per market without needing an SPL token mint.
4. Bonding Curve Math
Pricing is deterministic and calculated entirely on-chain using discrete quadratic pricing.
*The frontend and backend use this exact formula for quotes, but the smart contract acts as the final validator for slippage and bounds.
5. Buy & Sell Flows
Buy Flow
- Validate protocol and market active.
- Read current supply.
- Calculate exact curve cost.
- Calculate creator & protocol fees.
- Validate cost <= `max_sol_cost`.
- Transfer SOL, route fees to vaults.
- Increase user balance and market supply.
- Emit `KeysPurchased` event.
Sell Flow
- Validate key balance.
- Calculate return based on supply.
- Calculate fees.
- Validate net >= `min_sol_received`.
- Reduce supply and balance.
- Transfer SOL to seller.
- Emit `KeysSold` event.
6. Fee Architecture
Pump Social Capital separates accounting strictly. Reserve liquidity is never mixed with fees.
Bonding Curve Fees (Before Graduation)
While your token is on the bonding curve, every trade generates a flat 1.25% fee.
- Creator Fee: 0.30% - Routed to Creator Fee Vault PDA.
- Protocol Fee: 0.95% - Routed to Protocol Treasury PDA.
- Total Fee: 1.25%
PumpSwap Fees (Graduated Tokens)
Once graduated to PumpSwap, the creator fee scales dynamically with market cap.
| Market Cap (SOL) | Creator Fee | Protocol Fee | LP Fee | Total Fee |
|---|---|---|---|---|
| 0 – 420 | 0.300% | 0.930% | 0.020% | 1.250% |
| 420 – 1,470 | 0.950% | 0.050% | 0.200% | 1.200% |
| 1,470 – 2,460 | 0.900% | 0.050% | 0.200% | 1.150% |
| 2,460 – 3,440 | 0.850% | 0.050% | 0.200% | 1.100% |
| 3,440 – 4,420 | 0.800% | 0.050% | 0.200% | 1.050% |
| 4,420 – 9,820 | 0.750% | 0.050% | 0.200% | 1.000% |
| 9,820 – 14,740 | 0.700% | 0.050% | 0.200% | 0.950% |
| 14,740 – 19,650 | 0.650% | 0.050% | 0.200% | 0.900% |
| 19,650 – 24,560 | 0.600% | 0.050% | 0.200% | 0.850% |
| 24,560 – 29,470 | 0.550% | 0.050% | 0.200% | 0.800% |
| 29,470 – 34,380 | 0.500% | 0.050% | 0.200% | 0.750% |
| 34,380 – 39,300 | 0.450% | 0.050% | 0.200% | 0.700% |
| 39,300 – 44,210 | 0.400% | 0.050% | 0.200% | 0.650% |
| 44,210 – 49,120 | 0.350% | 0.050% | 0.200% | 0.600% |
| 49,120 – 54,030 | 0.300% | 0.050% | 0.200% | 0.550% |
| 54,030 – 58,940 | 0.275% | 0.050% | 0.200% | 0.525% |
| 58,940 – 63,860 | 0.250% | 0.050% | 0.200% | 0.500% |
| 63,860 – 68,770 | 0.225% | 0.050% | 0.200% | 0.475% |
| 68,770 – 73,681 | 0.200% | 0.050% | 0.200% | 0.450% |
| 73,681 – 78,590 | 0.175% | 0.050% | 0.200% | 0.425% |
| 78,590 – 83,500 | 0.150% | 0.050% | 0.200% | 0.400% |
| 83,500 – 88,400 | 0.125% | 0.050% | 0.200% | 0.375% |
| 88,400 – 93,330 | 0.100% | 0.050% | 0.200% | 0.350% |
| 93,330 – 98,240 | 0.075% | 0.050% | 0.200% | 0.325% |
| 98,240+ | 0.050% | 0.050% | 0.200% | 0.300% |
7. Backend & Realtime
The backend provides metadata, search, charts, and realtime feeds, but never acts as the authority for balances or prices.
- Stack: Node.js, Fastify, PostgreSQL (Drizzle), Redis, BullMQ.
- Indexing: Listens to Anchor events via Helius Webhooks. Validates signatures and decodes events to update Postgres.
- WebSockets: Pushes updates (trade, price_update, supply_update) to clients in under 2 seconds.