The wallet shows a balance. The transaction fails with insufficient funds. Both are true at the same time.
★"Balance" and "spendable" are different numbers on Solana, and three separate mechanisms create the gap.★
The Error Is Not One Error
Transfer: insufficient lamports 5000000, need 5001000
Error: insufficient funds
insufficient funds for rent
custom program error: 0x1
They come from different layers and mean different things:
| Message | Layer | Means |
|---|---|---|
insufficient lamports X, need Y |
★System program★ | ★Exact numbers — read them★ |
insufficient funds for rent |
Runtime | ★Would drop below rent exemption★ |
Token program 0x1 |
SPL Token | Token balance, not SOL |
| Pre-flight rejection | RPC | Fee payer cannot cover the fee |
★The first one is the most useful error message in Solana development★ — it tells you exactly how short you are, and the difference between the two numbers usually identifies which mechanism is responsible.
Rent Exemption Is Locked, Not Spent
Every account must hold a minimum balance to exist. ★That minimum is not available to spend.★
const balance = await connection.getBalance(wallet);
const rentExempt = await connection.getMinimumBalanceForRentExemption(0);
// ★This is the real number.★
const spendable = balance - rentExempt - feeBuffer;
A wallet holding exactly what getMinimumBalanceForRentExemption returns has a balance and can spend nothing. Attempting to leave less than the minimum fails with insufficient funds for rent even when the arithmetic on the transfer itself works.
The lamports are recoverable — closing the account returns them — but not while the account is in use.
Fees Come From the Same Balance
The fee payer's account covers the base fee and any priority fee, and that is separate from whatever the transaction moves.
// ★Sending your entire balance always fails.★
SystemProgram.transfer({ fromPubkey: wallet, toPubkey: dest, lamports: balance });
// ★Leave room for the fee and the rent minimum.★
const fee = 5000 + priorityFeeLamports;
const sendable = balance - rentExempt - fee;
★The priority fee is the part people forget when computing this.★ Base fee is predictable; a derived priority fee is not, and during congestion it can be many times the base fee. A bot that reserves only for the base fee will fail exactly when fees spike — which is when it most wanted to transact.
If your balances are correct and transactions still miss, a free BoltTx key is one line to test the submission path.
Wrapped SOL Is a Separate Balance
The one that produces the most confusing version of this error:
const native = await connection.getBalance(wallet); // ★lamports★
const wsolAta = await getAssociatedTokenAddress(NATIVE_MINT, wallet);
const wrapped = await connection.getTokenAccountBalance(wsolAta); // ★token★
★These do not move together.★ A swap that spends wrapped SOL fails with insufficient funds while getBalance shows plenty, because the two balances are unrelated until you wrap or unwrap.
Wrapping is a transfer plus a sync:
const ixs = [
createAssociatedTokenAccountIdempotentInstruction(payer, ata, owner, NATIVE_MINT),
SystemProgram.transfer({ fromPubkey: owner, toPubkey: ata, lamports: amount }),
createSyncNativeInstruction(ata), // ★without this the token balance stays 0★
];
createSyncNativeInstruction is the step that gets missed. Transferring lamports to the account is not enough — the token balance field has to be updated to match, and without the sync the account holds lamports while reporting a zero token balance.
Token Accounts Need Rent Too
A swap that creates a destination token account needs SOL for that account's rent, on top of the trade amount:
const ataRent = await connection.getMinimumBalanceForRentExemption(165);
★A wallet with exactly enough SOL for the trade fails when the trade also has to create an account.★ For a bot trading new tokens, this happens on nearly every first purchase, and it is why "it works on tokens I already hold" is a common and misleading observation.
Checking Before You Build
async function canAfford(connection, wallet, amount, willCreateAta) {
const balance = await connection.getBalance(wallet);
const rentExempt = await connection.getMinimumBalanceForRentExemption(0);
const ataRent = willCreateAta
? await connection.getMinimumBalanceForRentExemption(165)
: 0;
const fees = 5000 + estimatedPriorityFee;
const required = amount + rentExempt + ataRent + fees;
return { ok: balance >= required, short: required - balance };
}
★Report the shortfall, not just a boolean.★ For a user-facing bot the difference between "insufficient funds" and "you need 0.003 more SOL to cover the token account" is the difference between a support ticket and a self-resolved problem.
This check is a courtesy, not a guarantee. The balance can change before the transaction lands, which is why the on-chain check is what actually protects you — the pre-check exists to produce a good error message, not to replace it.
What Landing Looks Like
Real transactions through our delivery nodes: median confirmation 336ms — under one slot.
★An insufficient-funds failure caught before submission costs nothing; one caught on chain costs a base fee.★ That makes the pre-check worth running even though it cannot be authoritative.
Where BoltTx Fits
We handle submission. Balance management stays entirely in your code.
Submissions route through our own delivery nodes in four regions with stake-weighted routing and no public mempool exposure, so a transaction is not observable in transit before it lands.
You sign locally. We never hold funds, never sign, and never modify transaction contents. ★The tip travels inside the transaction and is paid on chain from your own wallet, so it is part of the balance you need to reserve for★ — and it reverts with the transaction if it fails, because that is how Solana handles atomic transactions. You pay only on transactions that reach the chain.
Get a free API key. No monthly fee:
const connection = new Connection("https://la.bolttx.io/?api-key=YOUR_KEY");
FAQ
Why do I get insufficient funds when I have SOL? Because the rent-exempt minimum must remain in the account and fees come out of the same balance. Spendable is your balance minus rent exemption minus fees, not the number the wallet displays.
What is rent exemption on Solana? A minimum balance every account must hold to persist. It is locked rather than spent, and it is returned when the account is closed, but it is never available to transfer out while the account exists.
How do I calculate how much SOL I can actually send? Balance minus the rent-exempt minimum minus the base fee minus any priority fee. Sending the full balance always fails, since the fee has nowhere else to come from.
Why does my swap fail when getBalance shows enough? Most likely the swap spends wrapped SOL, which is a separate token account balance. Native SOL and wrapped SOL do not move together until you explicitly wrap or unwrap.
How do I wrap SOL correctly?
Create the associated token account for the native mint, transfer lamports into it, then call createSyncNativeInstruction. Without the sync the account holds lamports but reports a zero token balance.
Why is my wrapped SOL balance zero after transferring lamports? The sync instruction was missed. Transferring lamports does not update the token balance field, so the account must be synced for the balance to be visible to the token program.
Do I need extra SOL to buy a new token? Yes, for the associated token account's rent on top of the trade amount. This is why a purchase can fail for a new token while succeeding for one you already hold.
What does insufficient lamports X, need Y mean? Exactly what it says — you have X and the transaction requires Y. The difference between the two usually identifies which cost you forgot, typically rent or the priority fee.
Does the priority fee come out of my balance? Yes, from the fee payer's account alongside the base fee. Reserving only for the base fee means failing during congestion, which is when fees spike and when you most want to transact.
What is token program error 0x1? Insufficient token balance rather than insufficient SOL. It means the token account does not hold enough of that token, which is a different problem from lacking lamports.
How much should I keep as a fee buffer? Enough for several transactions at elevated priority fees, not just one at the base rate. A bot that reserves the minimum fails exactly when conditions are worst.
Can I recover the rent from a token account? Yes, by closing the account, which returns the rent-exempt lamports to the owner. A bot trading many tokens accumulates these accounts and can reclaim real capital by closing empty ones.
Why does the same trade work for one token and fail for another? Usually because one requires creating a token account and the other does not. The extra rent is the difference, and it appears on the first purchase of any new token.
Should I check the balance before sending? Yes, to produce a useful error message. It is not a guarantee, since the balance can change before landing — the on-chain check is what actually protects you.
How do I tell the user what went wrong? Report the shortfall amount, not just that funds were insufficient. Telling someone they need a specific additional amount resolves the problem without a support conversation.
Does a failed transaction still cost me SOL? If it landed and reverted, yes — the base fee was paid. If it was rejected before execution, no fee was charged, but the opportunity was still lost.