Swap Node

Swap Node is a multi-chain token swap execution node that supports trading on Aptos and Flow EVM chains through Vault contracts.

---

Node Information

Property	Value
Node Type	swap_node
Display Name	Swap
Category	Instance (Trade Execution)
Icon	🔄 Swap Icon
Handle Color	Emerald (Green)
Version	0.0.2
Base Node Type	swap_node

---

Functionality

Swap Node executes token swap transactions on multiple blockchain networks. It supports both percentage-based and fixed-amount trading methods, with automatic slippage protection.

Main Uses:

• Execute token swap transactions

• Multi-chain trading (Aptos, Flow EVM)

• Automated portfolio rebalancing

• Trading strategy execution

Core Features:

• 🌐 Multi-Chain Support: Aptos and Flow EVM

• 🔄 Switch Amount Type: Support for both Number and Percentage modes

• 🛡️ Slippage Protection: Automatic price limit calculation

• 📋 Transaction Receipt: Complete transaction details

---

Key Parameters

amount_in_human_readable (Switch Type)

The amount field now supports Switch type, allowing users to toggle between Number and Percentage modes:

Data Structure:

{
  mode: "number" | "percentage",  // Mode: exact amount or percentage
  value: string                    // Value as string
}

Mode 1: Number (Exact Amount)

{
  "from_token": "USDT",
  "to_token": "APT",
  "amount_in_human_readable": {
    "mode": "number",
    "value": "100"
  }
}
// Meaning: Swap 100 USDT for APT

Mode 2: Percentage (Balance Percentage)

{
  "from_token": "USDT",
  "to_token": "APT",
  "amount_in_human_readable": {
    "mode": "percentage",
    "value": "50"
  }
}
// Meaning: Swap 50% of USDT balance for APT

Frontend UI:

• User first selects mode (Number or Percentage)

• Number mode: Shows numeric input field

• Percentage mode: Shows 0-100% slider + input field

---

Supported Chains

• Aptos: Native Aptos chain support

• Flow EVM: Flow EVM chain support

• More coming soon: Additional EVM-compatible chains planned

---

📖 Full Documentation

For detailed documentation including complete parameter descriptions, usage examples, and advanced features, please refer to:

• Chinese version - Complete documentation (~16,600 words)

• Frontend configuration: 1_weather_frontend/src/pages/flow/components/TFNode/instances/trade/SwapNode.tsx

• Backend implementation: 3_weather_cluster/tradingflow/station/nodes/swap_node.py

---

Maintained by: TradingFlow Development Team Version: 1.0.0