Skip to main content
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', 'coffee', 'colossus', 'torch_finance', 'moon', 'bidask']
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.
⌘I