LI.FI home pagelight logodark logo
  • Playground
  • Support
  • Get Started
  • Get Started
Home
Introduction
API Reference
SDK
Widget
Guides and FAQs
Changelog
Fees and Monetization
  • FAQs
Errors and Troubleshooting
  • Common issues
Integration Tips
  • API latency and optimization
  • Slippage and price impact
  • FAQs
Routing and Transaction Flow
  • Route availability
  • Token support and availability
Errors and Troubleshooting

Common issues

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'?

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 documentation

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?

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?

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?

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?

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?

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?

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?

PARTIAL is a final status. The full value was received, but in a different token than expected.

FAQsAPI latency and optimization
LI.FI home pagelight logodark logo
xgithubwebsite

Company

CareersBrand AssetsAbout

Tools

LI.FI Explorer

Legal

Privacy PolicyTerms of ServiceImprint
xgithubwebsite
Powered by Mintlify
Assistant
Responses are generated using AI and may contain mistakes.