Skip to main content
Merkle Street

Protocols, markets, policy, people

How to prepare a missing deposit asset

A missing deposit asset can mean an empty balance, hidden token, or unsupported route; identify which one before adding funds, approving a contract, or swapping.

Merkle Street Newsroom#1890a53 min read

Abstract cover artwork

Prepare a missing deposit asset by checking whether the token is absent from your balance, hidden by the interface, or unsupported by the deposit route. A deposit starts with a token on a specific network. The wallet reports its balance, the application checks whether it accepts that token, and a contract may then pull it after you approve the transaction. If the route crosses networks, a bridge or router handles the transfer and may exchange the token along the way. Each step depends on the right asset being available at the right point.

What does a missing deposit asset mean?

It usually means the deposit flow cannot see or use the token you intend to send. First check the selected network and wallet address. A token on one network does not count as the same deposit asset on another, even when both versions show the same symbol. Then compare the token’s contract address with the asset details shown by the deposit service.

If the address matches but the balance is zero, the wallet needs that token on the selected network. If the balance is present but the interface omits it, the issue may be token display or route support. Adding a token to a wallet’s display can reveal a balance; it does not create funds or make an unsupported token depositable.

How do you prepare the token for a deposit?

Prepare it by confirming the asset, network, balance, and route in that order. The symbol is a useful clue, but contract address and network are the stronger checks. For an integration, the application should map the user’s token to an accepted deposit asset before asking the wallet to sign anything. If that mapping uses a swap, the route determines which intermediate assets and contracts handle the exchange. For the route decision itself, see how to choose a Blackhole swap route. The deposit asset still needs to match what the chosen route accepts.

Use this short check before funding or signing:

  • Confirm the network selected in both wallet and deposit form.
  • Match the token’s contract address, not just its displayed name or symbol.
  • Check that the wallet holds the token and enough of the network’s native asset to pay transaction fees.
  • Confirm the deposit flow supports the token directly or specifies a conversion route.

If the token is unsupported but a route is offered, the router may swap it into an accepted asset before the deposit continues. That adds a price quote, possible slippage, and another contract interaction. A direct deposit is simpler when both routes are supported and the user already holds the required asset. In a Blackhole swap integration, treat route choice as part of the asset preparation step: the source token, destination token, and network must line up.

What should you check before approving a deposit?

Check the transaction details against the deposit you intend to make. Some tokens require an approval transaction before a contract can move them; the approval names the spender contract and token allowance. Review those details in the wallet, then review the follow-up deposit or swap transaction separately. A displayed token amount should also match the amount and destination shown by the deposit flow.

Think of the asset like a parcel with a destination label: the token is the parcel, the network is the delivery system, and the route is the address it can reach. A correct label on the wrong network still fails. If the balance, token identity, and supported route agree, proceed with the deposit. If any one differs, resolve that mismatch before sending funds.