how fee routing works
every coin on ruth is a pump.fun coin: same bonding curve, same trading, same graduation to pumpswap. what ruth adds is what happens to a coin's creator fees. each coin is treated as a radioactive sample, and read the way Ernest Rutherford and Frederick Soddy read thorium at McGill in Montreal, 1901 to 1903: buyers make atoms of it, sellers make them decay.
N = x / (x + y) rutherford's curve: the share of production (buys) 1 − N soddy's curve: the share of decay (sells) N = ½ radioactive equilibrium: production = decay
the physicist and the chemist found that a radioactive substance changes at a rate proportional to what is left of it, dN/dt = −λN, so it halves in a fixed time, its half-life; that the thorium X they pulled out of thorium died away while the thorium grew it back, two mirror curves that always added up to the whole; and that the atoms were turning into other elements. when Soddy said the word transmutation, Rutherford told him not to: they would have their heads off as alchemists. Rutherford got the 1908 nobel prize in chemistry for it (the quickest transformation he had seen, he said, was his own, from physicist to chemist); Soddy got his in 1921.
0 · whose fees
pump.fun pays a creator fee on every trade to the coin's creator. a coin launched on ruth sets that creator to a program address, ["creator", mint], so only the program can collect and move those fees. the launcher does not receive them. for every other pump.fun coin the page shows a simulation of the same rule on that coin's live trades, labelled "sim".
1 · observations
the program reads the coin's pump.fun curve. each time it is cranked, the change in the curve's virtual sol since the last crank is one observation: sol in is production (a buy), sol out is decay (a sell). ruth cranks inside every trade it sends, and a keeper cranks after trades made anywhere else, so one observation is about one trade. no trade, no observation.
2 · the window and the phase
the last 100 observations are split into 10 buckets of 10, aligned to the newest. time is counted in buckets, not seconds. per bucket, x is the sol of buys, y the sol of sells, and N = x / (x + y) the share of production. the phase reads the newest share and how it moved:
N = N[K−1] ΔN = N[K−1] − N[K−2] N > ½, ΔN ≥ 0 → growing → fees buy the coin back and burn it N > ½, ΔN < 0 → saturating → fees keep accumulating N < ½, ΔN ≤ 0 → decaying → fees move to the floor reserve N < ½, ΔN > 0 → recovering → fees keep accumulating N = ½ → equilibrium → fees keep accumulating fewer than 2 buckets → sealed (warmup) → fees keep accumulating
shares are integers in parts per million, the distance from ½ truncated toward zero, so equilibrium is the same on both sides. vaults under 0.001 sol wait for the next crank instead of paying for a tiny buyback.
3 · burn and floor
a burn is an ordinary pump.fun buy made by the program with the collected fees, followed by burning every token it bought: transmuted, gone for good. the floor reserve is a program-owned account, ["floor", mint], the lead at the end of the chain. the program has no instruction that moves lamports out of it: no withdraw, no close, no admin path, no redemption. the test suite proves this by scanning the source and the idl and by checking the balance never decreases across random crank sequences.
outstanding supply = total supply − total burned floor backing per token = floor reserve ÷ outstanding supply
floor backing per token can only rise. it is not a claim, not a promise and not a price support: the price can fall below it. nobody can withdraw the floor.
4 · the decay constant
when at least 3 buckets exist, the law of radioactive change is fitted to the distance from equilibrium, D = N − ½, by least squares: each bucket keeps a fraction 1 − λ of it. λ is the decay constant (positive when the imbalance died away over the window, negative when it grew) and t½ = ln 2 / −ln|1 − λ| the half-life it implies, in buckets. on each coin's page the two curves are drawn with the fitted relaxation ½ ± A·(1 − λ)^t over the window it came from, never beyond it.
λ = −Σ D_k·(D_{k+1} − D_k) / Σ D_k² k = 0 … K−2
N̄ = ½ + Σ D_k / K the window's mean shareλ and N̄ describe the recent past of one market, they are not used by the routing, and they forecast nothing. the program computes them in 128-bit integers; this app runs the same integer arithmetic, and its test suite replays 300 cases generated by the program's own tests. full spec in docs/MECHANISM.md.
5 · after graduation
when a coin completes its curve and moves to pumpswap, the curve stops changing: no new observations, no more buybacks on the curve. a decaying phase still moves collected fees to the floor.
the physics words are a way to read past trade flow, not a model of what comes next. nothing on this page is advice or a prediction. memecoins are highly speculative and most go to zero. paper mode is a simulation.