Fee route planner

Accounts involved

Every program account has an address derived from fixed seeds (a PDAProgram derived address: an account address worked out from fixed words and keys. Only the program can sign for it; nobody holds a private key to it.), so the page finds it from the owner, the token and a policy number, and nobody can swap in a look-alike.

Each conversion also opens a temporary wrapped-SOLSOL held in a token account so a swap pool can trade it like any other token. Closing the account turns it back into plain SOL. account for the vault and closes it again in the same transaction, so SOL never sits outside the vault between trades.

Who can do what

• ActionWho signsRules the program enforces
• Create a policyAny wallet; it becomes the owner and names an operator1 to 6 distinct recipients totalling exactly 100%, never the vault itself. The program must have no upgrade authority. Conversion terms only for Pump (Token-2022) coins.
• Convert SOLThe owner or the named operatorNot paused or ended, before the end slot, at least the spacing after the last one, within the per-trade and lifetime limits, through the coin’s canonical PumpSwap pool, at or above the rate floor.
• Pay out tokensThe owner or the named operatorOnly to the fixed recipients’ own token accounts, each exactly what it is owed. Works while paused and after conversions end.
• Pause or resumeThe owner onlyStops or restarts conversions. Nothing else changes.
• End conversions and share SOLThe owner onlySends the vault’s SOL above its rent reserve to the same fixed recipients by share. Conversions stay off for good.
• Change recipients or limits, or withdraw elsewhereNobodyNo instruction edits a policy’s terms or sends tokens or SOL to anyone but its fixed recipients. The operator cannot pay itself.

An operatorThe one wallet a policy names, besides its owner, that may convert SOL and pay out. It cannot change recipients, limits or where money goes. is a convenience for running conversions and payouts, for example a scheduled service you trust. It cannot redirect money, but it can choose when to convert within your limits, so name one you trust.

The math, with a worked example

Token amounts on chain are whole units: 1 DEMO with 6 decimals is 1,000,000 units, and 1 SOL is 1,000,000,000 lamportsThe smallest unit of SOL. 1 SOL is 1,000,000,000 lamports, so the 0.000005 SOL network fee is 5,000 lamports..

1. The rate floorminimum tokens = SOL in lamports × minimum units per SOL × (10,000 − 100) ÷ 10¹³The slippageHow far a trade’s result may fall below the expected rate before it is refused. Here it is fixed at 1% below your minimum rate. allowance is fixed at 1%. If PumpSwap would return less, the trade and the whole transaction are refused.
2. Payouts are cumulativeowed = (tokens held + tokens already paid) × share ÷ 10,000 − already paid to this recipientRounded down. However often you pay out, everyone ends up with the same totals; the dust waits in the policy until it adds up.
3. Sharing SOL works the same wayowed = (vault SOL − 650,240 lamports reserve + SOL already shared) × share ÷ 10,000 − already sharedThe reserve keeps the vault account alive. The first time this runs, conversions end for good.

Example (the practice run’s defaults)

1. Create a policy: you 50%, Team 30%, Community 20%; up to 0.5 SOL per conversion, 1.5 SOL for life; at least 3,000,000 DEMO per SOL; 150 slots apart.Costs 0.00349504 SOL of rent plus the network fee.
2. 1.2 SOL of creator fees reach the vault. Convert 0.5 SOL.minimum = 0.5 SOL × 3,000,000 × 99% = 1,485,000 DEMOThe practice pool (85 SOL / 280,000,000 DEMO) returns 1,632,543.260992 DEMO. The vault keeps 0.70148844 SOL: 1.2 − 0.5, plus the temporary account’s rent that closes into it.
3. Convert again right away.Refused: the next conversion is allowed 150 slots (about a minute) later. After that, 0.5 SOL returns 1,613,588.343801 DEMO.
4. Pay out 3,246,131.604793 DEMO.You get 1,623,065.802396, Team 973,839.481437, Community 649,226.320958. 0.000002 DEMO of rounding waits for later.
5. Someone else buys with 40 SOL, then you try 0.2 SOL.minimum = 0.2 × 3,000,000 × 99% = 594,000 DEMOThe pool would now return less, so the trade is refused and nothing is spent.
6. End conversions and share the SOL.The vault holds 0.20297688 SOL; 0.20232664 SOL above the reserve is shared: you 0.10116332, Team 0.060697992, Community 0.040465328.

Run the same steps in the Practice tab: it uses the program’s rules and the page SDK’s floor and payout functions, so you will see these numbers. The practice pool and its 0.30% fee are examples; real prices and fees come from PumpSwap.

Costs

VEYDUCT feeThe asset router has no fee setting and VEYDUCT adds no site fee to policies.

None

Policy account rentSOL every Solana account must hold to exist, set by its size. It stays in the account; these programs have no instruction that closes one, so it is not refunded.560 bytes at mainnet rent of 5,080 lamports per byte plus 128 bytes per account. Paid once by the owner.

0.00349504 SOL

Each conversionA temporary wrapped-SOL account (165 bytes), paid by the signer. Its rent lands in the vault when it closes and is later shared out with the rest of the SOL.

0.00148844 SOL + network fee

First conversionOpens the policy’s token account (170 bytes for a Pump coin).

+ 0.00151384 SOL

First payout to each recipientOpens their token account (170 bytes), paid by the signer.

0.00151384 SOL each

Network feePer transaction, one signature.

0.000005 SOL

Policy rent is not refunded: the program has no instruction that closes a policy. PumpSwap charges its own trading fee inside each conversion; the rate floor already counts it, because it is checked on what actually arrives.

Timing and limits

• Spacing. After a conversion, the next one waits at least the set number of slots. Solana makes a slot roughly every 0.4 seconds, so 150 slots is about a minute.
• End slot. The page sets it to the current slot plus your conversion window (216,000 slots is about a day). After it, conversions stop; payouts and SOL sharing still work.
• Sequence numbers. Every conversion, payout and SOL share names the next sequence number, so an old or repeated transaction is refused.
• No lockup on payouts. Owed tokens can be paid out any time, also while paused or after conversions end.

Edge cases and what can go wrong

The planner and the policy

The planner works today without a wallet. It plans a two-layer route: up to eight conversions (SOL, your coin or other SPL tokens), each split across up to ten destinations, both layers totalling exactly 100%. It checks the token addresses against confirmed mainnet mint data and exports the terms as canonical JSON with a SHA-256 digest. Its export format reserves a fixed 1% service-fee line in the proposal; nothing is charged and nothing is deployed, signed or funded.

The routing policy is what runs on chain: one token per policy, up to six recipients, SOL into that token only. A planned route with several assets becomes several policies, one per token, each with its own vault and limits.

FAQ