Funding Bands

Accounts involved

Each address is derived from fixed seeds (a PDAA program-derived address: an account address computed from fixed words and keys. Only the program can sign for it.), so the page and your operatorA wallet you may name to send sales for you. It can only sell inside your bands and receives nothing. find the same accounts, and nobody can swap in a look-alike.

Each sale also creates the vault’s wrapped-SOL account (165 bytes) and closes it in the same transaction: the sale’s SOL is unwrapped and paid straight out. The fee rate comes from the program’s settings account (seed "veyduct-fee-config"): 0.5% while it does not exist, only VEYDUCT’s fee wallet can change it, never above 1%, and each escrow keeps the rate it was created with.

Who can do what

• ActionWho signsRules the program enforces
• Plan bandsAnyone, no walletThe planner signs nothing. It checks ordering, the floor and that shares add up to exactly 100%.
• Create the escrowThe creator, holding the tokensThe exact inventory moves from your main token account into escrow. One to ten ordered bands, each with tokens; a cap above 0; an expiry in the future; at most 10% price movement. The coin is a Token-2022 coin with metadata only and no freeze authority, and the program must be immutable.
• Sell from a bandThe creator, or the operator you nameOnly after the coin graduated, only on its canonical PumpSwap pool, at most the cap, spaced by the minimum slots, before expiry, while the pool price is inside the band, with at least the band-floor minimum, and only if the price is still at or above the band’s floor afterwards.
• Reclaim unsold tokensThe creator onlyOnly after the expiry slot, only to the creator’s own token account, all at once. Afterwards nothing can be sold.
• Change bands, recipient or operator, or withdraw earlyNobodyThe escrow has no admin and no instruction for any of these.

The operator can only sell band slices inside your rules. Every lamport of a sale goes to the VEYDUCT fee and your fixed recipient; the operator receives nothing.

Band math, with a worked example

SOL amounts on chain are lamportsThe smallest unit of SOL. 1 SOL is 1,000,000,000 lamports.: 1 SOL is 1,000,000,000. A Pump coin has 6 decimals and a supply of 1,000,000,000 tokens.

You plan in USD market cap. The escrow stores each band as SOL price bounds: lamports per smallest token unit, × 10¹², fixed at the SOL/USD reference you enter.

1. Inventory per bandband tokens = reserved × share ÷ 100%, rounded downLeftover units go one each to the bands with the largest remainders, so the bands add up to exactly what you reserved.
2. USD to on-chain boundsbound = market cap ÷ SOL/USD ÷ supply × 10⁹ × 10¹²The lower bound rounds up and the upper bound rounds down, so no band gets wider.
3. Inside the bandlower × pool tokens ≤ pool SOL × 10¹² < upper × pool tokensPool SOL is the pool’s effective quote: its SOL plus its virtual quote reserve, without fees waiting to be swept.
4. Minimum SOL outminimum = tokens × lower ÷ 10¹² × (10,000 − movement) ÷ 10,000Checked on the sale’s SOL before the VEYDUCT fee.
5. Payoutfee = proceeds × 50 ÷ 10,000 (rounded down); recipient = the rest

Example

Reserve 30,000,000 DEMO in three bands at a $150 SOL reference: $90,000–$120,000 (40%), $120,000–$180,000 (35%) and $180,000–$270,000 (25%). A practice pool holds 200,000,000 DEMO and 100 SOL: a $75,000 market cap.

1. Bands12,000,000 · 10,500,000 · 7,500,000 DEMOBand 1 on chain: 600,000,000 to 800,000,000 ($90,000 ÷ $150 = 600 SOL, over 10¹⁵ units).
2. Selling now is refused.$75,000 is below band 1, so its tokens wait.
3. Buyers spend 25 SOL.The market cap rises to about $116,678: inside band 1.
4. Sell 2,000,000 DEMO from band 1, 1% movement allowed.minimum = 2,000,000,000,000 × 600,000,000 ÷ 10¹² × 0.99 = 1.188 SOLThe pool returns 1.518113857 SOL after Pump’s 1.2% pool fee at this market cap. VEYDUCT fee: 0.007590569 SOL; you receive 1.510523288 SOL, plus the wrapped-SOL account’s rent back. The market cap falls to about $113,824, still inside band 1.

Run the same steps in the practice run: it uses the page’s own plan model and the SDK’s bound, minimum and fee functions, so you will see these numbers. The pool there is a practice pool with Pump’s fee tiers captured from mainnet; a real pool’s output can differ by rounding.

Costs

VEYDUCT fee per saleVEYDUCT fee: 0.5% of each sale’s SOL proceeds · max 1% · set by VEYDUCT. The rate in force when you create the escrow is locked into it.

0.5%

VEYDUCT fee to create an escrowNo flat fee for Funding Bands.

None

Account rent for a new escrowEscrow (624 bytes), its token account (170) and PumpSwap’s volume account (137), at mainnet rent of 5,080 lamports per byte plus 128 bytes per account. Never closed, so not refunded.

≈ 0.0067 SOL

Pump pool fee per saleSet by Pump by market cap; 1.2% in the example.

Varies

Per sale, for whoever signsNetwork fee, plus 0.00148844 SOL for the wrapped-SOL account, which the sale pays on to the recipient.

≈ 0.0015 SOL

Network feePer transaction: create, each sale, reclaim.

0.000005 SOL

Timing and lockups

• Locked until expiry. Unsold tokens come back only after the expiry slot, and only to the creator. There is no early withdrawal.
• Spacing between sales. 150 slots by default, about a minute; the first sale needs no wait.
• Lifetime. 6,480,000 slots by default, about 30 days. Slots run about 0.4 seconds each, so clock time can drift.
• Nothing runs by itself. A sale happens only when you or your operator send one while the price is inside a band.
• Bounds are fixed in SOL. If SOL/USD moves after you create the escrow, the USD market caps the bands stand for move with it.

Edge cases and what can go wrong

Words used here

Market cap

Price per token × total supply, in USD. A Pump coin has 1 billion tokens, so a $90,000 market cap means $0.00009 per token.

Band

One market-cap range with its own share of the reserved tokens. Its tokens can sell only while the price is inside it.

Escrow

An account only the program controls. It holds the reserved tokens and the fixed terms; nobody can change them or take tokens out early.

Graduation floor

Your planning number for the market cap at graduation. Every band must start above it; the program checks real graduation itself.

SOL/USD reference price

The SOL price you plan with. It converts your USD bands into fixed SOL price bounds when the escrow is created.

Price movement allowed

How much less SOL than the band floor a sale may return. At most 10%; the page offers 0.5%, 1% or 3%.

Operator

A wallet you may name to send sales for you. It can only sell inside your bands and receives nothing.

PumpSwap

Pump’s own exchange. A coin moves there from its bonding curve when it graduates, and gets one canonical SOL pool.

Graduation

A Pump coin graduates when its bonding curve fills up. It then trades in a PumpSwap pool instead of on the curve.

Smallest units

Tokens are stored as whole numbers of their smallest unit. With 6 decimals, 1 token is 1,000,000 units.

Slot

Solana’s clock tick, about 0.4 seconds. The program counts time in slots, so minutes and days are close, not exact.

Lamport

The smallest unit of SOL. 1 SOL is 1,000,000,000 lamports.

PDA

A program-derived address: an account address computed from fixed words and keys. Only the program can sign for it.

FAQ