LI.FI home pagelight logodark logo
  • Support
  • Get Started
  • Get Started
Overview
API Reference
JS/TS SDK
For Solvers
Swap/Bridge Widget
Widget Playground
Guides and FAQs
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
Routing and Transaction Flow

Route availability

What does the error message 'Return amount is not enough' mean?

This slippage error appears when the expected return amount is lower than the minimum accepted threshold. It often happens due to market volatility or low liquidity.

What should I do if I encounter the error 'Exchange rate has changed'?

This error indicates a price change between the quote and execution. To resolve it, increase the slippage tolerance. Be cautious—higher slippage can result in worse rates.If you’re using the SDK, implement acceptExchangeRateUpdateHook and return true to accept updated rates automatically. Refer to the SDK docs: acceptExchangeRateUpdateHook

Why do I see the error 'EVM contract destination addresses not currently supported by mayanWH and mayanMCTP'?

Some versions of Mayan (mayanWH and mayanMCTP) do not support smart contract addresses as destinations.

Why did my Mayan MCTP transfer take long and cost more?

Mayan MCTP uses CCTP, which has slower settlement times and higher gas costs on Ethereum. It is generally 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 usually means the fromAddress does not have enough funds to cover the transaction.

Why do I see the error 'Not an EVM Transaction' even though funds arrived?

This message appears when the transaction has not yet been indexed by LI.FI. Once it is indexed, the scanner will display its details.

What does error selector 0x963b34a5... mean in a failed swap?

This code likely represents a custom error from the DEX, such as MinimalOutputBalanceViolation. Most swap failures come from DEX-level checks. If not, LI.FI applies its own fallback checks. Error codes may vary by provider.

When is a failed transaction eligible for a refund, and can the status change afterward?

Refund policies depend on the bridge. Some bridges issue refunds automatically; others may leave transactions unresolved.

What does the NOT_PROCESSABLE_REFUND_NEEDED substatus mean?

This substatus usually comes from cBridge. It means the transfer could not be processed due to price, gas, or liquidity issues. LI.FI will then trigger a refund on the source chain.

What does the PARTIAL substatus mean in a transaction?

PARTIAL is a final status. The user receives the full value, but in a different token than expected.

Why don't I get quotes when bridging from a Solana wallet with no SOL?

LI.FI blocks quotes if the wallet has no SOL. This prevents failures from rent and gas fees. To fetch rates without requiring a funded wallet, use the /routes endpoint without specifying a wallet address.
FAQsToken support and availability
Assistant
Responses are generated using AI and may contain mistakes.
LI.FI home pagelight logodark logo
xgithubwebsite

Company

CareersBrand AssetsAbout

Tools

LI.FI Explorer

Legal

Privacy PolicyTerms of ServiceImprint
xgithubwebsite
Powered by Mintlify