By default, swap.coffee UI widget supports a full list of decentralized protocols and automatically evaluates them at runtime.

​
Default Behavior

If you do not provide any liquidity-related configuration, the widget enables all available sources:

['tonco', 'stonfi_v2', 'tonstakers', 'stonfi', 'dedust']

These are fully dynamic and toggleable by the user in the widget UI under expert settings.

​
Restricting Liquidity Sources

You can override this behavior by passing the liquiditySourcesList parameter.

liquiditySourcesList?: string[];
  • When this list is provided, only the specified sources are used, and the user cannot change or toggle them via the UI.

​
Example: Restrict to a Single Source

createSwapWidget("#test", {
  liquiditySourcesList: ["stonfi_v2"],
  otherConfig...
});

This limits swap routing strictly to STONFI_V2. All other sources like TONCO or Tonstakers are excluded from routing and hidden in the UI.

🚫 When liquiditySourcesList is set, the widget hides off settings for sources. Users will no longer be able to change liquidity source preferences inside the widget.