DEV Community

Anna Botsford
Anna Botsford

Posted on

Rebasing Token Balances Against Wallet History

If a token balance changes while your swap is pending or failed, check for a rebase before retrying. A rebase can change the number of tokens in your wallet without a transfer from another wallet.

A rebase changes balances across the token

A rebase is a token supply adjustment that changes holders’ displayed balances by a shared percentage. Some tokens expand supply; others contract it. The token’s rules determine when adjustments happen and how large they are.

For example, if you held 100 tokens before a 10% positive rebase, your balance might become 110. If every holder’s balance changes proportionally, your share of the total supply stays about the same. The unit price can also move, so a bigger token count does not by itself mean your holding is worth more.

Some contracts store a fixed internal balance and apply a shared multiplier when reporting each wallet’s current balance. That means the contract can update one shared value instead of writing a new balance for every holder. Ampleforth’s protocol documentation describes this kind of proportional supply adjustment.

Wallet history and balance answer different questions

Your wallet balance is the token contract’s current answer to “how many tokens does this address hold?” Wallet history records actions, such as transfers and swaps. A rebase can change the first without creating a normal transfer from another address.

The ERC-20 token standard defines common functions such as balanceOf, which reports an address’s balance, and totalSupply, which reports the supply. It does not require every token to record balance changes in the same way. A rebase may have its own event, or the contract may update balances without one transfer entry per holder.

So a transaction list that shows no incoming tokens does not prove that your balance display is wrong. Compare the same wallet’s balance at two specific blocks, which are numbered snapshots of the chain, and check the token contract’s rebase rules. A chart shows price over time; it does not, by itself, explain why your wallet’s token count changed.

A pending or failed swap does not explain every change

A pending swap has been sent but is not yet included in a confirmed block. Until it executes, it has not completed the token exchange. A rebase can still change your displayed balance while that transaction waits.

A failed swap was included in a block, but its contract actions were rolled back. The transaction may still consume a network fee, while a rebase that happened separately remains in effect. Check the transaction’s final status and block, then compare the token balance at that block with its current balance.

For example, Maya holds 100 tokens and submits a swap. It stays pending; meanwhile, a positive rebase changes her displayed balance to 105. The swap later fails. That failure does not undo the separate rebase, and the history may show a fee without a completed token transfer.

Compare the same wallet, token, and time

To trace the change, use the same wallet address and token contract throughout. A token’s name or ticker alone may not identify the contract, and a wallet may hold tokens on more than one network. On BNB Smart Chain, use records for that chain.

  • Find the swap’s final status and the block where it was included, if any.
  • Check the token balance before and after that block, if historical readings are available.
  • Look for a rebase event or a documented supply update around the time the balance changed.
  • Compare the percentage change in your balance with the token’s stated rebase method.

If the swap is still pending, check its status before sending another transaction. If it failed, confirm the wallet’s current balance and available network fee funds before retrying. Don’t assume the displayed token amount will stay fixed while a rebase can occur.

For BNB Smart Chain token charts and wallet tracking, poocoin.money is one service to consider. Keep a note of the balance and block number before you act; that makes later changes easier to explain. PooCoin is a charting and trading tool for exploring BSC token activity.

Top comments (0)