Docs
Everything here describes what Spindle actually does. Network: Mainnet.
How Spindle works
A Spindle has a name, an asset (SOL or one classic SPL token) and 2 to 20 recipients (up to 16 for tokens), each with a weight in basis points (1% = 100) that add up to exactly 10,000. Recipients and weights are set once at creation and can never be edited.
When you create a Spindle, Spindle generates a brand-new Solana wallet just for it: its deposit address. You send revenue there from any wallet, app or exchange. Spindle's server holds that wallet's key, encrypted, and pays whatever arrives out to the recipients by their weights. Creating a Spindle is free and needs no transaction: you only sign a message to prove which wallet is the creator.
Payouts and rounding
A payout always sends the entire balance of the deposit wallet at that moment, in one transaction. Each share is floor(amount × weight ÷ 10,000); the few base units left by rounding go to the recipient with the largest weight (the first one on a tie), so the deposit wallet always ends at exactly zero.
- The server refuses to sign anything except transfers from this Spindle's deposit wallet to this Spindle's recipients.
- A payout is a single transaction: either every recipient is paid, or nothing moves.
- Only one payout per Spindle can run at a time, and each one pays the live balance, so nothing can be paid twice.
- A wallet that has never held SOL must receive at least about 0.00089 SOL (Solana's minimum). If a share would be smaller, the payout waits until more arrives.
Fees and costs
- Spindle fee: none.
- Creating a Spindle: free. No transaction.
- SOL payouts: the Solana network fee (a fraction of a cent) comes out of the balance before it is split.
- Token payouts: Spindle pays the network fee, and the one-time cost of opening a token account for a recipient who doesn't have one yet.
Supported assets
- Native SOL. SOL sent to a token Spindle is also paid out by the same weights.
- Classic SPL tokens, such as USDC. Tokens with a freeze authority are allowed, but their issuer could freeze the deposit wallet's token account.
- Token-2022 is not supported, and only the Spindle's own token is paid out. Don't send other tokens to a deposit address.
Automatic payouts
Spindle's worker checks every deposit wallet every few seconds and pays it out once the balance is worth it (0.01 SOL or 1 whole token by default), so fees don't eat small amounts. Anyone can also press Pay out now on a Spindle's page to pay any amount immediately; the money can still only go to its recipients. Failed attempts are retried with growing delays and shown on the Spindle's page.
The agent
The Spindle agent reads real data through a fixed set of tools and prepares drafts. It cannot create Spindles or move money: a new Spindle opens in the creation wizard for you to review, and a payout shows a card you must confirm. Addresses must come from what you typed; the server rejects drafts containing addresses that didn't. “My routes” needs a wallet sign-in (a signed message, not a transaction). Conversations stay in your browser tab.
Creator rewards
Claim your creator rewards as you normally would, then send them to your Spindle's deposit address. Because the deposit address is an ordinary wallet held by Spindle's server, don't set it as a launchpad recipient that must sign to claim: nobody will sign that claim for you. Use a wallet you control, claim, then send.
What you are trusting
- Spindle holds the deposit wallets. Money sits in a wallet whose key is on Spindle's server until it is paid out, usually within a minute.
- Recipients and weights can't be changed through the app or the API, by you or anyone.
- Wrong addresses are permanent. Check every recipient before creating; a mistyped address keeps receiving its share.
- Names, labels, deposit addresses and every payment are public on Solana. Unlisting only hides a Spindle from Explore.
Verify a payment
- Open the payout signature in Solana Explorer: it shows one transfer from the deposit wallet to each recipient.
- Open the deposit address to see every deposit and payout it has ever made.
- Recompute: share = floor(amount × weight ÷ 10,000), plus the rounding remainder for the largest weight.
Troubleshooting
- “Nothing to pay out”: it was already paid out, possibly automatically.
- A new wallet needs at least … lamports: a recipient's share is below Solana's minimum for a brand-new wallet. Wait for more to arrive, or send that wallet a little SOL first.
- Waiting for a while: the balance is below the automatic threshold, or a recent attempt failed and is waiting to retry. Press Pay out now, or check the reason on the Spindle's page.
- Spindle not found: you may be looking on a different network.