// documentation
How RecoverSOL works
Every SPL token account locks a small amount of SOL as rent. When a token account is emptied or abandoned, that rent stays locked forever — unless you close the account. RecoverSOL scans your wallets, closes every empty account in bulk, and sends the reclaimed SOL to a destination of your choice.
§What it does
RecoverSOL is a bulk rent-reclamation tool for Solana traders and degens who accumulate hundreds of dead wallets. Paste private keys, pick a destination address, and the app closes every empty token account across every wallet you provide — batched, parallelised, and streamed live.
Typical users: traders with 50–500 burner wallets, farmers who ran a shotgun airdrop campaign, or anyone who aped into an SPL token and forgot about the rent.
§Why SOL rent?
Every account on Solana — including SPL token accounts — pays a rent-exempt deposit when created. For a token account this is 0.00203928 SOL (≈2 million lamports). That deposit is refundable: close the account and the SOL comes back to you.
A wallet that traded 50 different tokens over its lifetime has 50 token accounts worth ~0.1 SOL in reclaimable rent. Across 100 dead wallets, that’s 10 SOL quietly locked in the chain.
// the math
1 token account ≈ 0.00204 SOL
50 accounts per wallet ≈ 0.102 SOL
100 dead wallets ≈ 10.2 SOL locked
§How it works
- 1
Paste keys
Drop your private keys into the input field — Base58 or JSON array, one per line. Add a destination address (where recovered SOL lands). Keys never leave the input field until you confirm.
$ recoversol input --keys 52 - 2
Scan
We call Helius RPC on the server side, fetching all SPL Token and Token-2022 accounts for each wallet in parallel (5 wallets at a time). Empty accounts are flagged as closeable. Accounts with a non-zero balance are flagged with a warning — you can acknowledge and close them, or skip.
$ recoversol scan --parallel 5 - 3
Review
See a dry-run summary: exact SOL amount per wallet, fee breakdown (5% to treasury, 95% to you), unrecoverable accounts with reasons (frozen mint, foreign close authority, etc.). Exclude any wallet with a click.
$ recoversol review --dry-run - 4
Execute
Press Recover. We build close-account transactions in batches of 10 accounts per tx, sign them with your keys server-side, and submit through our treasury wallet which pays all network fees. Progress streams live via WebSocket. You get a permanent session URL you can bookmark and share.
$ recoversol execute --dest <addr>
§Security
The single biggest concern with a tool like this is key handling. Here’s what actually happens to your keys:
- →TLS in transit. Keys are only sent over HTTPS from your browser to our backend.
- →Encrypted at rest. If you save wallets to your vault, keys are encrypted with AES-256-GCM using a server-side master key before hitting Redis/Postgres. The encrypted bytes are unreadable to anyone without the master key.
- →Zeroed after signing. For anonymous sessions, the decoded private key lives in server memory only for the duration of the sweep and is wiped as soon as transactions are signed.
- →Destination bound. Each transaction is built to send recovered SOL to the destination you specify at the start. Our treasury can't reroute funds mid-flow.
- →SIWS auth. Signed sessions use domain-bound Sign-In With Solana messages; replay-prevented with single-use nonces stored in Redis.
Honest caveat
This tool requires trusting our server to not log or exfiltrate keys. That’s a real trust decision. Use burner wallets — not your main holdings — and consider transferring any valuable tokens out before sweeping. The 5% fee buys you the convenience; it doesn’t buy you a non-custodial guarantee.
§Fees
Simple split: 95% to you, 5% to us. We also pay every network fee (~0.000005 SOL per close tx) from our treasury so you never need to pre-fund anything.
| Gross recovered | 1.0000 SOL |
| Fee (5%) | -0.0500 SOL |
| Network fees | paid by recoversol |
| Net received | 0.9500 SOL |
No subscriptions, no minimum sizes, no per-transaction charges. The 5% is taken atomically in the same transaction as the close — you never need to trust us with an intermediate balance.
§FAQ
Do I need to connect a wallet?
For anonymous sweeps, no — just paste private keys. For the saved-wallet vault (so you don’t have to paste keys every time), you'll sign a one-time Sign-In With Solana message with a wallet you own. The SIWS signature only authenticates you to the app — it doesn't authorize any on-chain action.
What if I have a wallet with a valuable token in it?
The scan flags any token account with a non-zero balance. You review these individually — they're never closed automatically. If you do want to close a non-zero account, the token is burned as part of the close (that's how SPL works when the balance isn't zero). We show the fiat value of each balance via Jupiter so you don't accidentally burn something worth more than the rent.
What if a sweep fails mid-way?
Every session has a persistent URL. Partially completed sessions can be resumed — we track which batches committed and which didn't. The payout is atomic per batch: either you get your 95% or the batch rolls back and nothing moves. No split-state “some recovered, some lost” failures.
What’s the batch size?
25 wallets per batch, unlimited batches per session. Within a batch we fan out to 5 wallets concurrently (capped by RPC rate limits). A 100-wallet session runs ~4 batches, typically under a couple of minutes end-to-end.
Does this work on devnet / testnet?
No. RecoverSOL is mainnet-only. Devnet rent is worthless.
What tokens / programs are supported?
Both SPL Token (original program) and Token-2022 (new program with extensions). We skip accounts we can't close — for example, accounts owned by a PDA or where the close authority is a non-owner — and flag them in the summary.
Can I get a transaction receipt?
Yes. Every completed session page has a Download Receipt button that exports a CSV with per-wallet breakdown, tx signatures, SOL amounts, and timestamps. Also useful for tax accounting.