> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krokoswap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 协议概览

> Kroko DEX 的架构与设计

# 协议概览

Kroko DEX 是 Kasplex 区块链上的去中心化交易所，将两种经过验证的 AMM 模型 — \*\*V2（恒定乘积）\*\*和 **V3（集中流动性）** — 统一在一个路由层下。

## 架构

```mermaid theme={null}
flowchart TD
    A[用户钱包] --> B[Permit2]
    B --> C[Universal Router]
    C --> D[V2 Pool]
    C --> E[V3 Pool]
    F[Swap API] -.->|calldata| C

    style C fill:#00D1D9,color:#fff
    style F fill:#f5f5f5,stroke:#999,stroke-dasharray: 5 5
```

### 组件

| 组件                   | 角色                                              |
| -------------------- | ----------------------------------------------- |
| **V2 Pools**         | 恒定乘积 AMM（`x * y = k`）。简单、Gas 高效、全范围流动性。         |
| **V3 Pools**         | 集中流动性 AMM。LP 选择一个价格范围，提升资本效率。                   |
| **Universal Router** | 在单笔交易中跨 V2 和 V3 执行交易。支持多跳和拆分路由。                 |
| **Permit2**          | 代币授权管理器。用户将代币一次性授权给 Permit2，然后为特定花费者授予带过期时间的权限。 |
| **Swap API**         | 链下路由引擎，寻找最优路径并生成交易 calldata。                    |

## 交易流程

1. **授权** — 用户将代币授权给 Permit2 合约（每个代币一次性操作）
2. **许可** — 用户通过 Permit2 授予 Universal Router 权限（每个代币一次性操作）
3. **报价** — 前端向 Swap API 请求最优路由
4. **Calldata** — 前端向 Swap API 请求编码后的交易数据
5. **执行** — 用户将交易发送到 Universal Router

路由引擎自动选择最佳路径 — 单跳或多跳、V2 或 V3 或混合 — 基于可用流动性和价格影响。

## V2 与 V3 对比

| 特性    | V2          | V3                     |
| ----- | ----------- | ---------------------- |
| 流动性范围 | 全范围（0 到无穷大） | 自定义价格范围                |
| 费率    | 固定 0.3%     | 可选：0.01%、0.05%、0.3%、1% |
| LP 代币 | 同质化 ERC-20  | 非同质化 ERC-721 (NFT)     |
| 资本效率  | 较低          | 较高（窄范围最高可达 4000 倍）     |
| 复杂度   | 简单          | 高级                     |
| 最适合   | 稳定币对、被动 LP  | 追求更高收益的主动 LP           |

## 原生代币

Kasplex 的原生货币是 **KAS**（18 位小数）。由于 AMM 合约需要 ERC-20 代币，KAS 被包装为 **WKAS** 用于链上操作。Universal Router 自动处理包装和解包 — 用户直接与原生 KAS 交互。

详见[原生代币处理](/concepts/native-token)。