Information for Integrators

Here you will find a brief onboarding guide to ensure the integration is as smooth as possible for your team and users

We're thrilled that you have chosen to integrate our widget and appreciate your trust in Squid 🦑

If you have any questions or concerns during the integration process, please don't hesitate to reach out to us on Discord.

Staying updated

If you have integrated the widget, please let us know so we can share the news with our community! To stay updated with any changes or new features, please follow us on Twitter or join our Discord.

User support

A full user guide can be found here which contains a step-by-step guide on how to do a swap and how to troubleshoot any errors or issues.

Once you have integrated the widget, we recommend you create a support channel in your own community for users to troubleshoot issues that users may encounter while using the widget.

If you our your users discover any persistent issues or errors while using the widget, please contact us on Discord.

Should you need to provide guidance on how to use the widget or troubleshoot technical issues, here are the most common user issues and how to resolve them:

The user is unable to initiate a swap

The most likely reason for is is that their balance is insufficient to complete the trade and cover any bridge or swap fees. The user should try a lower swap amount, or top up their account with more of the native gas token.

The swap is marked as complete, but the user does not see their tokens

If this happens, it's likely that the user has received axlUSDC on the destination chain unexpectedly. This can happen as a result of price volatility and low slippage, which causes the transaction to revert.

The user can complete their swap by swapping from axlUSDC to their desired token. Squid will support swaps on the same chain soon, but until then they can use a DEX on their destination chain to finish the transaction.

Transaction failed or could not initiate

If the initial swap on the source chain swap did not initiate, the user's tokens will still be in their wallet on the source chain, aside from a small amount that may have been spent on gas. They should return to the swap page and try again.

Transaction is paused

If gas prices rise and the transaction pauses as a result, the user can manually add gas to re-start the transaction by visiting the transaction's page in Axelarscan's UI.

Safety and security

The safety and security of users and their assets is of the utmost importance to us.

If a chain or token has downtime or is compromised, Squid will remove it from the chain and token lists as soon as we are notified, and the widget will update automatically to reflect this change.

If you ever encounter a security incident relating to the widget or one of Squid's supported chains, tokens or routes, please inform Squid immediately on Discord or Twitter.

Fees

Gas fees

Aside from standard gas fees paid via the user's wallet, token transfers across chains are charged a fixed network gas fee by Axelar. You will find all of Axelar’s fees here. If gas prices change and the users overpay, they will be refunded the difference.

Cross-chain gas fees are subtracted from the swap amount, which means they are included in the quoted exchange rate and estimated receive amount.

DEX fees

Squid does not charge any DEX fees, but swaps are routed through other DEXs, such as Uniswap, Curve and Osmosis, who do charge fees. These fees are included in the total amount out provided by the widget's quote.

Squid currently earns no revenue from swaps, but has fee contracts audited, and will introduce a small fee in the future.