​

Universal Router

​

Why a Universal Router?

• Unifies execution — One contract handles V2, V3, and mixed-protocol swaps
• Enables complex routes — Multi-hop swaps that cross between V2 and V3 pools
• Reduces gas — Batches operations in a single transaction
• Integrates Permit2 — Pulls tokens via Permit2 for streamlined approvals

​

How It Works

function execute(
    bytes calldata commands,
    bytes[] calldata inputs,
    uint256 deadline
) external payable;

• commands: A byte string where each byte is a command code (e.g., V2_SWAP_EXACT_IN, V3_SWAP_EXACT_IN, WRAP_ETH, UNWRAP_WETH, etc.)
• inputs: ABI-encoded parameters for each command
• deadline: Unix timestamp after which the transaction reverts

​

Typical Swap Flow

1. Swap API finds the optimal route
2. Swap API encodes the route as Universal Router commands
3. Frontend receives { to, data, value } from the API
4. User signs and sends the transaction
5. Universal Router executes the commands sequentially

const tx = await signer.sendTransaction({
  to: swapData.to,      // Universal Router address
  data: swapData.data,  // Encoded execute() calldata
  value: swapData.value // Native KAS amount (0 for ERC-20 to ERC-20)
});

​

Slippage Protection

​

Native KAS Handling

• Selling KAS: Wraps the KAS sent as msg.value into WKAS before the swap
• Buying KAS: Unwraps WKAS to KAS and sends it to the recipient after the swap