Pump and Solana
Every PairStreet token is a Pump coin on Solana mainnet. Pump creates it, prices it on a bonding curve and graduates it to PumpSwap. PairStreet attaches the financial Pair: the instrument, the fee split that funds it, the accounting and the rewards.
Two layers
PairStreet separates token issuance from financial pairing. Token issuance is a solved problem on Solana, and Pump solves it well: a fair-launch bonding curve, a liquid market from the first block, migration to an AMM at completion, and a creator-fee stream paid on every trade. PairStreet uses all of it unchanged.
- →Token creation
- →Bonding-curve launch
- →The underlying token market (token/SOL)
- →Graduation to PumpSwap
- →Creator-fee stream and the fee-sharing program
- →Pair Instrument selection
- →Pair Market registry
- →Pair Vault
- →Pair Router
- →Provider abstraction
- →Settlement
- →Pair accounting
- →Reward allocation
- →Pair analytics
- →Creator-fee split policy
- →Eligibility
Figure summary: Pump: token creation, bonding-curve launch, the underlying token market, graduation to PumpSwap, the creator-fee stream and the fee-sharing program. PairStreet: Pair Instrument selection, Pair Market registry, Pair Vault, Pair Router, provider abstraction, settlement, Pair accounting, reward allocation, Pair analytics, creator-fee split policy and eligibility. Together: an internet asset plus a financial Pair.
Pump is the launch infrastructure. PairStreet is the financial pairing layer.
Is PairStreet just a Pump frontend?
No. A frontend submits the same transaction the venue’s own site would. PairStreet submits different transactions and maintains a system Pump has no concept of.
- ·Different launches. Every PairStreet launch creates a Pump fee-sharing config for the mint and writes a 50/50 creator and treasury split into it. That split funds the market’s Pair Vault reservePair Vault reserveThe 25% share of a Pair Market's creator fees earmarked for its Pair Vault. Held by the PairStreet treasury until the market's settlement route activates.. A launch from Pump’s site pays creator fees to the creator alone.
- ·A second object. Each launch registers a Pair MarketPair MarketThe canonical pairing of an internet asset with a financial Pair: TOKEN × PAIR INSTRUMENT, plus the Pair Vault, configuration and accounting that connect them. that binds the token to a Pair Instrument, with its own status, configuration, vault address and ledger. The token on Pump knows nothing about it.
- ·Systems Pump does not run. The Pair Router, the provider network, the settlement engine, the reward engine with Merkle roots, the Eligibility Engine and Pair analytics live entirely in PairStreet.
The boundary is deliberate. The token is an open Solana asset: it trades on Pump whether or not anyone opens pairstreet.xyz. The Pair layer sits behind a LaunchAdapter interface, so the venue underneath it is replaceable without touching Pair Markets, vaults or rewards. See LaunchAdapter.
Programs
PairStreet deploys no onchain program of its own today. It composes Pump’s programs, the Pump fees program and System Program transfers, built with the official @pump-fun/pump-sdk v2.0.0.
| Program | Address | Used for |
|---|---|---|
| Pump | 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P | Token creation, bonding-curve trades, creator-fee distribution |
| Pump fees | pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ | Fee-sharing config and shareholder split |
| PumpSwap AMM | pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA | The graduated market; creator fees accrued on the pool |
| System Program | 11111111111111111111111111111111 | The 0.5% PairStreet trading fee transfer |
Pump instructions PairStreet uses
| Instruction | Program | Transaction | Effect |
|---|---|---|---|
| create_v2 | Pump | Launch 1 | Creates the mint, its metadata and its bonding curve. PairStreet generates the mint keypair and pre-signs. |
| create_fee_sharing_config | Pump fees | Launch 1 | Creates the per-mint fee-sharing config. The bonding curve’s creator becomes the sharing-config PDA, so creator fees accrue to the config. |
| update_fee_shares | Pump fees | Launch 2, or Lock fee split | Writes the shareholders: creator 5,000 bps, PairStreet treasury 5,000 bps. Pump permits this once; the config is then locked (adminRevoked = true). |
| buy_v2 | Pump | Launch 3 and every buy | Buys tokens on the bonding curve with SOL, with slippage protection. |
| sell_v2 | Pump | Every sell | Sells tokens back to the bonding curve for SOL. |
| distribute_creator_fees | Pump | Distribute creator fees | Permissionless. Pays accrued creator fees to the config’s shareholders. For a graduated coin the SDK first adds PumpSwap’s transfer_creator_fees_to_pump. |
| transfer | System Program | Every PairStreet trade | Moves the 0.5% trading fee to the treasury in the same transaction as the trade. |
Figure summary: create_v2 and create_fee_sharing_config in the launch transaction; update_fee_shares in the split transaction; buy_v2 for the optional first buy and every buy; sell_v2 for every sell; distribute_creator_fees for permissionless creator-fee payouts; and a System Program transfer for the 0.5% trading fee.
The launch sequence
A launch is up to three transactions, signed together in a single wallet prompt (signAllTransactions) and sent in order. The split is forced by size: each fits Solana’s 1,232-byte transaction limit only on its own. The first is about 1,047 bytes.
- Step 01create_v2 + create_fee_sharing_configCreate the coin and its fee-sharing config
The server stores the image and immutable metadata JSON (served at /api/metadata/<id>), generates the mint keypair and pre-signs. The creator signs as fee payer.
- Step 02update_fee_sharesLock the creator-fee split
Creator 50%, treasury 50%. The treasury half is accounted as 25% protocol revenue and 25% Pair Vault reserve. After this transaction the split is permanent: no party, PairStreet included, can change it. Creator fees that accrue before it lands are paid to the creator.
- Step 03buy_v2 + transferOptional first buy
Priced on a fresh curve whose creator is the sharing config, with 5% slippage tolerance to absorb trades that land between the launch transactions, plus the 0.5% fee.
- Step 04POST /api/launch/confirmConfirm and register
The server fetches the signature on-chain, checks it succeeded and contains the mint and creator, checks the bonding curve exists, registers the Pair Market and reads the on-chain fee split. If the split transaction did not land, the market shows “Split pending” and the creator can lock it later from the market page with “Lock fee split”.
Launch was validated end to end against the real Pump programs cloned from mainnet onto a local validator. The resulting split, per mint, is what makes each market’s Pair Vault reserve attributable to that market. See Protocol Economics.
How the 0.5% fee is added
Every trade PairStreet builds carries a PairStreet fee of 0.5% (50 bps) of the SOL side, rounded down to the lamport. It is a System Program transfer to the treasury inside the trade transaction, so the trade and the fee land or fail together. Pump’s own protocol and creator fees are separate and embedded in Pump’s curve math.
sell for 2.400 SOL: fee = 2,400,000,000 × 50 / 10,000 = 12,000,000 lamports (0.012 SOL); trader receives 2.388 SOL
The treasury is 5XAwPtXHkA2F68tEj5ZAZePJfJWH4tzGkeQiqK5ggfRg. One guard applies: a transfer that would leave the treasury account below Solana’s rent-exempt minimum (890,880 lamports) would fail the whole transaction, so while the treasury is unfunded, a fee too small to fund it is skipped. The trade never fails because of the fee.
Graduation and PumpSwap
A Pump coin trades on its bonding curve until the curve’s token reserves are exhausted. The curve is then complete and the coin migrates to a PumpSwap pool. PairStreet reads the bonding-curve account directly for price, reserves, progress and completion.
Hover a state for its meaning.
Figure summary: Three graduation states. Bonding: trading on the Pump bonding curve. Graduating: bonding progress at or above 75%. Graduated: the curve is complete and the coin trades on PumpSwap.
- ·Trading. PairStreet’s trade panel builds bonding-curve trades. PumpSwap routing for graduated markets is In integration; graduated coins continue to trade on PumpSwap directly.
- ·Market data. After graduation, price, 24-hour volume and change come from DexScreener and candles from GeckoTerminal.
- ·Creator fees. The fee-sharing config belongs to the mint, so the split outlives the curve. The distribute path built by the SDK moves creator fees accrued on the PumpSwap pool back to Pump before paying the shareholders.
A normal Pump coin and a Pair Market
A Pump coin’s market is token/SOL. A PairStreet Pair Market has exactly the same market. What PairStreet adds sits next to it: the financial Pair, the fee split that funds it, and the Pair accounting layer that tracks it.
One market. The token's identity is its price against the base asset.
Same token market, plus a financial Pair fed by a configured share of the market's economics.
Figure summary: Left: a normal token, $TOKYO trading against SOL. Right: a Pair Market, the same $TOKYO and SOL market plus a configured Pair flow into Tokyo Residential, the Pair Instrument.
| Normal Pump coin | PairStreet Pair Market | |
|---|---|---|
| Token market | Token/SOL on the bonding curve, then PumpSwap | The same |
| Creator fees | Paid to the creator | Split on-chain and locked: 50% creator, 25% protocol, 25% Pair Vault reserve |
| Trading fee | Pump’s fees | Pump’s fees, plus 0.5% PairStreet fee on trades PairStreet builds |
| Financial Pair | None | A Pair Instrument chosen at launch, with a Pair Vault and a provider route |
| Accounting | None | Ledger rows for vault funding, settlements, purchases, epochs and claims |
| Holder rewards | None | Reward epochs paid in the Pair Asset, time-weighted, with a Merkle root |
| Access rules | None | The instrument’s eligibility rules govern launches and claims |