Crosschain Swaps
In Nexus, users can do crosschain swaps (aka Swap Methods) which allows them to go from any token on any source chain(s), to any token on any destination chain.
Canonical assets like ETH, USDC and USDT are used to simplify the routing process for solvers and are used as the “interim” or “express” tokens, to make it cheaper for users.
Routing possibilities
Avail Nexus SDK automatically manages the entire transaction lifecycle. It analyses and suggests the optimal routing path to fulfill the user’s intent, resulting in an ‘any token in’, ‘any token out’ effect.
- Bridge → Destination Swap: A user sends a canonical asset like USDT from chain A, and gets a custom Asset like DEGEN on chain B.
- Source Swap → Bridge: A user sends a custom asset like OP from chain A, and gets a canonical asset like USDT on chain B.
- Source Swap → Bridge → Destination Swap: A user sends a custom asset like OP from chain A, and gets a custom asset like PEPE on chain B.
Exact In & Exact Out Swaps
There are essentially 2 types of Swap actions a user can do with Nexus. An ExactIn swap and an ExactOut swap.
Let’s dive into each one in detail.
ExactIn swap
The ExactIn swap method is for performing exact input swaps, which swaps a fixed amount of one or more tokens on N number of source chains for a maximum possible (variable) amount of another token on the destination chain.
User decides exactly which tokens and their amounts that they want to swap. The user decides the exact input amount for the swap. The output amount here may vary based on slippage, fees, etc.
This function uses the ExactInSwapInput struct and the swapWithExactIn function from the Swap Methods in the SDK.
ExactOut swap
The ExactOut swap method is for performing exact output swaps, which swap a minimum possible amount of one or more tokens on N source chains for a fixed amount of another token.
User decides the exact output amount amount they would like to receive at the end of the action. Nexus does the hard work of figuring out which tokens and balances it can use and executes the swap for the desired output amount.
This function uses the ExactOutSwapInput struct and the swapWithExactOut function from the Swap Methods in the SDK.