For the complete documentation index, see llms.txt. This page is also available as Markdown.

🚦Router settings (DEX Aggregator)

DeDust Router searches for the best available swap across DeDust pools and supported third-party liquidity sources on TON. It can split your input across several parallel routes and use intermediate tokens when a direct pool does not offer the best result.

To open Router settings, go to Swap and select the gear icon. After changing the settings, select Save.

Routes and steps

A route is a path that carries all or part of a swap. When several routes are used, Router splits the input amount and sends each part through a different path.

A step is one swap inside a route. For example, TOKEN A β†’ TON β†’ TOKEN B is one route with two steps.

By default, Router can use up to:

  • 4 routes;

  • 2 steps per route.

More routes and steps gives Router more possible paths to compare. It can improve the quote, but may also increase execution complexity and network fees.

Important: Transactions on TON are not atomic. In a multi-step route such as TOKEN A β†’ TOKEN B β†’ TOKEN C, the first swap can succeed while the second one fails. If that happens, TOKEN B remains in your wallet instead of the selected output token. You can then swap it separately or keep it.

Avoid pools with low TVL

Enable this option to exclude pools whose total value locked is below the selected threshold. A low-TVL pool may show an attractive quote but can be more sensitive to price movement and slippage.

The option is disabled by default; when enabled, the initial threshold is $10K.

Avoid highly volatile pools

Enable this option to exclude intermediate pools whose exchange rate changed by more than the selected percentage during the selected period.

Configure two values:

  • Volatility β€” the maximum difference between the pool's lowest and highest exchange rates during the period;

  • Period β€” how far back Router checks the pool's exchange rate.

The option is disabled by default; when enabled, it starts with 10% over 1 minute.

Minimal savings

Enable this option to use intermediate tokens or split the swap into several routes only when the estimated benefit is greater than the selected percentage. Otherwise, Router selects a single route.

Router accounts for the additional network fees of a multi-route swap. It proposes the more complex route only when its overall benefit covers the extra network fee and exceeds the selected Minimal savings threshold.

Third-party protocols

Router can include liquidity from other TON trading protocols in addition to DeDust pools. Each source can be enabled or disabled separately.

Currently supported DEX protocols:

  • STON.fi v1 β€” enabled by default;

  • STON.fi v2 β€” enabled by default;

  • TONCO β€” enabled by default.

Currently supported memepad sources:

  • Memes Lab β€” disabled by default;

  • Other memepads β€” disabled by default.

Memepad sources allow Router to trade supported tokens before they migrate to a DEX. They are disabled by default.

For Router v2 integration, see the technical documentation.

Last updated