Hop Docs
User Docs
User Docs
User Docs
  • Welcome
  • Basics
    • A Short Explainer
    • What is special about Hop?
    • How to bridge with Hop
    • How long does a transfer take?
    • Fees
    • Providing Liquidity & Rewards
    • Transfer failures
    • Manual Withdrawals
    • USDC.e Manual Withdrawals
    • FAQ
      • How to manually withdraw your tokens on the destination chain?
      • How to use Hop with a Gnosis Safe?
      • My funds are stuck on a Layer-2 network because I can't pay the gas needed for transactions
      • Can I access Hop Protocol through other interfaces than Hop.Exchange?
      • Why can I not access Hop.exchange?
      • Hop labels my transaction as completed but I can't "see" my tokens in Metamask
      • Do I need to pay transaction costs on the destination chain before I receive my tokens?
      • What are the fees for transfering tokens with Hop?
      • What is Hop Protocol?
      • How safe is Hop?
      • How long does a Hop transfer take?
      • I sent a token but it's not arriving at the destination
      • How do $OP on-boarding rewards work?
      • What do I need in order to provide liquidity on Hop?
      • Do I need to add Hop tokens and native tokens in equal weights?
      • How does a Hop token hold its peg with its native counterpart (e.g 1hUSDC = USDC)?
      • How do I get Hop tokens (hTokens)?
      • Can I buy hTokens on L2?
      • Why does my LP token balance show less than I deposited?
      • How does a rogue chain affect my LP position on another chain?
      • Who can become a Bonder?
      • What is a "Transfer bond"?
      • What is a "Transfer root"?
      • What does “The Bonder” do?
      • What happens if The Bonder bonds fraudulent transactions?
  • Governance
    • Into to Hop DAO
    • How to Vote
    • Becoming a Delegate
    • Liquidity mining
    • Token Distribution
    • Protocol Fees & Public Good Funding
    • Roadmap
    • Important Links
  • Stats
    • Links to Stats Dashboards
Powered by GitBook
On this page
  • 1. Receiving hTokens
  • 2. Tokens don't show up in wallet despite transfer being marked as successful
  1. Basics

Transfer failures

Last updated 2 years ago

Transfers can take up to 15-20mins depending on the route (see ). If you've waited this long but still think there's something wrong with your transfer it's likely one of these two reasons: 1) you received hTokens instead of native tokens and need to swap manually 2) the transfer actually arrived but your wallet doesn't show it

1. Receiving hTokens

In rare circumstances it can happen that the user receives hTokens instead of native tokens (e.g hUSDC instead of USDC) at the destination. This happens because the final "swap" at the destination times out after a set deadline, meaning the Hop token doesn't get converted in the AMM of the destination chain. In these instances the user needs to convert their Hop tokens manually in the "Convert" tab to get the native token.

Even more rarely, it can happen that there's no Bonder to "bond" your transfer and front the liquidity on the destination chain. This can can happen either because the Bonder is out of collateral (in which case you have to wait) or because of issues in the Bonder node infrastructure (in which case software needs to be rebooted or patched). If there is no Bonder liquidity at the destination chain there should be a warning in the Hop UI to let you know of the situation. If you still somehow send tokens while there is no Bonder liquidity your transaction will be pending until there is new Bonder liquidity.

2. Tokens don't show up in wallet despite transfer being marked as successful

Now that you know the token is there, let's import it manually into Metamask so that the interface shows it too. To do that go into the "Assets" tab and scroll to the bottom where you'll see a "Import tokens" link.

Often it turns out that these users had received their funds but the transfer was simply not displayed in the transaction list of Metamask or other wallet. This is because, unlike a standard peer-to-peer token transfer, tokens are disbursed by a smart contract and these are not indexed by Metamask. However, your balance is still credited (increased) by the amount of your transfer. We'll show you two things: 1) How to find out if the tokens have arrived using a block explorer 2) How to manually add a token to the Metamask user interface Metamask is just an interface that connects to the Blockchain for you. Sometimes this interface can be buggy and sometimes it doesn't automatically show specific tokens especially on Layer-2 chains. The best way to find out if your tokens have arrived is by going to a block explorer. The Blockchain is the single source of truth and a block explorer shows you all the data belonging to your account. For example if you want to see if your funds on have arrived on Optimism you would go to . Paste your wallet address in the big search bar of the home page of the block explorer site and you will see a new page showing data of your account. In the token dropdown you will see all the tokens that are held in your wallet. If you see your tokens there you can be assured that everything went well and that it's simply a matter of Metamask not showing your tokens.

You will then see a form which requires you to paste the address of the token you want to add. You can find the address of a token by typing it's ticker symbol (e.g "USDC) into the block explorer of the chain you are on ( e.g Optimistic Etherscan) or by looking it up on popular directories such as . NOTE: Tokens have different addresses on each chain they exist on ! E.g USDC address on Ethereum is different than USDC on Optimism! Once you paste the address the other fields like Token Symbol and Token Decimal will auto-populate. Click on "Add Custom Token" and you're done. Yo will now see your token in Metamask :-)

Optimistic Etherscan
Coingecko
Hop transfer times