Troubleshooting Errors

Sometimes you may find yourself facing a problem that doesn't have a clear solution. These troubleshooting tips may help you solve problems you run into.

Issues on the Exchange

INSUFFICIENT_OUTPUT_AMOUNT

The transaction cannot succeed due to error: HopiumRouter: INSUFFICIENT_OUTPUT_AMOUNT. This is probably an issue with one of the tokens you are swapping.

the transaction cannot succeed due to error: execution reverted: Hopiumrouter: insufficient_output_amount.

You're trying to swap tokens, but your slippage tolerance is too low or liquidity is too low.

Solution

1. Refresh your page and try again later.

2. Try trading a smaller amount at one time.

3. Increase your slippage tolerance:

   1. Tap the settings icon on the liquidity page.

   2. Increase your slippage tolerance a little and try again.

4. Lastly, try inputting an amount with fewer decimal places.

Reason

This usually happens when trading tokens with low liquidity.

That means there isn't enough of one of the tokens you're trying to swap in the Liquidity Pool: it's probably a small-cap token that few people are trading.

However, there's also the chance that you're trying to trade a scam token which cannot be sold. In this case, Hopium isn't able to block a token or return funds.

INSUFFICIENT_A_AMOUNT or INSUFFICIENT_B_AMOUNT

Fail with error 'HopiumRouter: INSUFFICIENT_A_AMOUNT' or Fail with error 'HopiumRouter: INSUFFICIENT_B_AMOUNT'

You're trying to add/remove liquidity from a liquidity pool (LP), but there isn't enough of one of the two tokens in the pair.

Solution

Refresh your page and try again, or try again later.

Still doesn't work?

1. Tap the settings icon on the liquidity page.

2. Increase your slippage tolerance a little and try again.

Reason

The error is caused by trying to add or remove liquidity for a liquidity pool (LP) with an insufficient amount of token A or token B (one of the tokens in the pair).

It might be the case that prices are updating too fast when and your slippage tolerance is too low.

Solution for nerds

OK, so you're really determined to fix this. We really don't recommend doing this unless you know what you're doing.

There currently isn't a simple way to solve this issue from the Hopium website: you'll need to interact with the contract directly. You can add liquidity directly via the Router contract, while setting amount A Min to a small amount, then withdrawing all liquidity.

Approve the LP contract

Head to the contract of the LP token you're trying to approve. For example, here's the TokenA/WGdcc pair:

1. Select Write Contract, then Connect to Web3 and connect your wallet.

2. In section "1. approve", approve the LP token for the router by entering

   1. spender (address): enter the contract address of the LP token you're trying to interact with

   2. value (uint256): -1

Query "balanceOf"

1. Switch to Read Contract.

2. In 5. balanceOf, input your wallet address and hit Query.

3. Keep track of the number that's exported. It shows your balance within the LP in the uint256 format, which you'll need in the next step.

Add or Remove Liquidity

Head to the router contract

1. Select Write Contract and Connect to Web3 as above.

2. Find addLiquidity or removeLiquidity (whichever one you're trying to do)

3. Enter the token addresses of both of the tokens in the LP.

4. In liquidity (uint256), enter the uint256 number which you got from "balanceOf" above.

5. Set a low amountAMin or amountBMin: try 1 for both.

6. Add your wallet address in to (address).

7. Deadline must be an epoch time greater than the time the tx is executed.

This can cause very high slippage, and can cause the user to lose some funds if frontrun

HopiumRouter: EXPIRED

The transaction cannot succeed due to error: HopiumRouter: EXPIRED. This is probably an issue with one of the tokens you are swapping.

Try again, but confirm (sign and broadcast) the transaction as soon as you generate it.

This happened because you started making a transaction, but you didn't sign and broadcast it until it was past the deadline. That means you didn't hit "Confirm" quickly enough.

Hopium: K

The transaction cannot succeed due to error: Hopium: K. This is probably an issue with one of the tokens you are swapping.

Try modifying the amount on “To” field. Therefore putting "(estimated)" symbol on “From”. Then initiate the swap immediately.

This usually happen when you are trying to swap a token with its own fee.

Hopium: TRANSFER_FAILED

The transaction cannot succeed due to error: execution reverted: Hopium: TRANSFER_FAILED.

Make sure you have 30% more tokens in your wallet than you intend to trade, or try to trade a lower amount. If you want to sell the maximum possible, try 70% or 69% instead of 100%. Caused by the design of Restorative Rebase tokens like coinA or CoinB. Understand how restorative rebase tokens work.

Another possible cause of this issue is the malicious token issuer just suspended the trading for their token. Or they made selling action only possible for selected wallet addresses. Please always do your own research to avoid any potential fraud. If the token you are trying to swap but failed with this error code is coming from an airdrop, that is most likely a scam. Please do not perform any token approval or follow any links, your fund may be at risk if you try to do so.

Transaction cannot succeed

Try trading a smaller amount, or increase slippage tolerance via the settings icon and try again. This is caused by low liquidity.

Price Impact too High

Try trading a smaller amount, or increase slippage tolerance via the settings icon and try again. This is caused by low liquidity.

estimateGas failed

This transaction would fail. Please contact support

Solution

If you got this error while removing liquidity from a BNB pair:

Please select "Receive WBNB" and retry.

If you got this error while trying to swap:

Please contact the project team of the token you're trying to swap. **** This issue must be resolved by the project team.

Reason

This issue (while swapping) is caused by tokens which have hard-coded the Hopium router into their contract.

While this practice is ill-advised at best, the reason for these projects having done this appears to be due to their tokenomics, in which each purchase sends a % of the token to LPs.

The projects affected will likely not work with the router: they will most likely need to create new versions of their tokens pointing to our new router address, and migrate any existing token holders to their new token.

We recommend that any projects which created such tokens should also make efforts to prevent their users from adding them to LP.

Execution reverted: TransferHelper: TRANSFER_FROM_FAILED.

The transaction cannot succeed due to error: execution reverted: TransferHelper: TRANSFER_FROM_FAILED.

When trying to swap tokens, the transaction fails and this error message is displayed. This error has been reported across platforms.

Solution

1. Check to make sure you have sufficient funds available.

2. Ensure you have given the contract allowance to spend the amount of funds you're attempting to trade with.

Reason

This error happens when trading tokens with insufficient allowance, or when a wallet has insufficient funds. If you're trading tokens with Restorative Rebase like tau assets coinA or coinB, make sure you understand how they work first with this guide to Rebase tokens.