Errors and Troubleshooting
Common issues
What does the error message 'Return amount is not enough' mean?
What does the error message 'Return amount is not enough' mean?
This error indicates that the expected return amount is below the minimum accepted threshold.
It typically occurs due to market volatility or low liquidity.
What should I do if I encounter the error 'Exchange rate has changed'?
What should I do if I encounter the error 'Exchange rate has changed'?
This error occurs when the exchange rate changes between quoting and execution.
You can increase the slippage tolerance to reduce failures, but be aware that it may result in a worse rate.For SDK users, implement
acceptExchangeRateUpdateHook and return true to automatically accept updated rates.See SDK documentationI’m getting an error 'EVM contract destination addresses not currently supported by mayanWH and mayanMCTP'
I’m getting an error 'EVM contract destination addresses not currently supported by mayanWH and mayanMCTP'
This error means the bridge version you used—mayanWH or mayanMCTP—does not support smart contracts as destination addresses.
Why did my Mayan MCTP transfer take so long and cost so much?
Why did my Mayan MCTP transfer take so long and cost so much?
Mayan MCTP runs on CCTP, which is slower and incurs higher gas costs on Ethereum mainnet.
This method is typically used for large transfers when other bridges lack liquidity.
What does error code 1001: 'None of the available routes could successfully generate a tx' mean?
What does error code 1001: 'None of the available routes could successfully generate a tx' mean?
This error often means the
fromAddress does not have enough balance to cover the transaction.Why does my bridge show 'Not an EVM Transaction' error even though funds arrived?
Why does my bridge show 'Not an EVM Transaction' error even though funds arrived?
This error appears when the transaction has not yet been indexed by LI.FI.
Once it is indexed, the scanner will display the transaction details.
What does the error selector 0x963b34a5... mean in a failed swap?
What does the error selector 0x963b34a5... mean in a failed swap?
This is likely a custom error from the DEX, such as
MinimalOutputBalanceViolation.
Most swap errors originate at the DEX level. If not, LI.FI has fallback validation logic.
Error selectors vary depending on the DEX.When is a FAILED transaction eligible for a refund, and can its status change afterward?
When is a FAILED transaction eligible for a refund, and can its status change afterward?
Refund eligibility depends on the bridge or tool used.
Some bridges refund automatically after failure. Others may leave the transaction unresolved.
What does the NOT_PROCESSABLE_REFUND_NEEDED substatus mean?
What does the NOT_PROCESSABLE_REFUND_NEEDED substatus mean?
This substatus is triggered by cBridge.
It indicates the transfer could not be processed due to price, gas, or liquidity changes.
LI.FI then initiates a refund on the source chain.
What does the PARTIAL substatus mean in a transaction?
What does the PARTIAL substatus mean in a transaction?
PARTIAL is a final status. The full value was received, but in a different token than expected.