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

# chainstream-defi Skill

> 不可逆 DeFi 執行 — 兌換、Launchpad、交易廣播

<Warning>
  所有 DeFi 操作都是**真實且不可逆的**。此 Skill 在每次破壞性操作前都需要使用者明確確認，絕不自動執行交易。
</Warning>

## 概述

`chainstream-defi` skill 處理 Solana、BSC 和 Ethereum 上的鏈上 DeFi 執行，涵蓋 DEX 代幣兌換、Launchpad 發幣和已簽名交易廣播。

* **模式**：Process（破壞性，需要簽名）
* **CLI**：`npx @chainstream-io/cli`（主要執行路徑）
* **SDK**：`@chainstream-io/sdk` 配合 `WalletSigner`
* **MCP**：報價、兌換、建立工具均可用 — 但鏈上執行需要宿主側的錢包認證

## 錢包要求

DeFi 操作需要能夠簽名交易的錢包：

| 路徑                 | 簽名方式    | 配置                                        |
| ------------------ | ------- | ----------------------------------------- |
| CLI + TEE 錢包       | TEE 簽名  | `chainstream login`                       |
| CLI + 原始私鑰         | 本地簽名    | `chainstream wallet set-raw --chain base` |
| SDK + WalletSigner | 自定義簽名   | 實現 `signMessage` + `signTypedData`        |
| 僅 MCP              | **不支援** | MCP 無錢包 — 使用 CLI 或 SDK                    |
| 僅 API Key          | **不支援** | API Key 無法簽名 — 執行 `chainstream login`     |

## 四階段協議

每個破壞性 DeFi 操作都遵循嚴格的四階段協議：

```mermaid theme={null}
sequenceDiagram
  participant User as 使用者
  participant Agent as AI Agent
  participant CLI
  participant API as ChainStream API
  participant Chain as 區塊鏈

  Agent->>CLI: dex route
  CLI->>API: POST /v2/dex/{chain}/route
  API-->>CLI: 報價（價格、費用、路由）
  CLI-->>Agent: 報價詳情

  Agent->>User: "兌換 1 SOL 約得 X 代幣。手續費：Y。確認？"
  User-->>Agent: "確認"

  Agent->>CLI: dex swap --from wallet ...
  CLI->>API: POST /v2/dex/{chain}/swap
  API-->>CLI: 未簽名交易
  CLI->>Chain: 簽名 + 發送交易
  Chain-->>CLI: 交易雜湊
  CLI->>API: POST /v2/transaction/{chain}/send
  API-->>CLI: Job ID

  CLI->>API: 輪詢 Job 狀態
  API-->>CLI: { status: "completed", hash: "..." }
  CLI-->>Agent: 成功 + 瀏覽器連結
```

### 階段 1：報價

執行前先獲取價格報價。這是隻讀操作，安全無風險。

```bash theme={null}
chainstream dex route --chain sol --from <wallet> --input-token SOL --output-token <addr> --amount 1000000
```

### 階段 2：使用者確認

**強制步驟。** 向使用者展示報價摘要並等待明確批准：

* 輸入數量和代幣
* 預期輸出數量
* 價格影響和費用
* 滑點容差

### 階段 3：簽名併傳送

確認後執行兌換。CLI 透過配置的錢包處理簽名。

```bash theme={null}
chainstream dex swap --chain sol --from <wallet> --input-token SOL --output-token <addr> --amount 1000000
```

### 階段 4：輪詢 Job

CLI 自動輪詢 Job 直到完成，輸出交易雜湊和瀏覽器連結。

```bash theme={null}
# 手动轮询（如需要）
chainstream job status --id <job_id> --wait
```

## 支援的操作

### 代幣兌換

```bash theme={null}
# 先获取路由 + 未签名交易
chainstream dex route --chain sol --from <wallet> --input-token SOL --output-token <token> --amount 1000000

# 然后兑换（用户确认后）
chainstream dex swap --chain sol --from <wallet> --input-token SOL --output-token <token> --amount 1000000 --slippage 5
```

### 代幣建立（Launchpad）

```bash theme={null}
chainstream dex create --chain sol --name "My Token" --symbol MTK --uri <metadata_uri> --dex pumpfun
```

### Job 狀態

```bash theme={null}
chainstream job status --id <job_id> --wait --timeout 60000
```

## 區塊瀏覽器

交易成功後，CLI 輸出瀏覽器連結：

| 鏈        | 瀏覽器 URL                          |
| -------- | -------------------------------- |
| Solana   | `https://solscan.io/tx/{hash}`   |
| BSC      | `https://bscscan.com/tx/{hash}`  |
| Ethereum | `https://etherscan.io/tx/{hash}` |

## 幣種解析

常用代幣標識：

| 代幣           | Solana 地址                                      | EVM 地址                                       |
| ------------ | ---------------------------------------------- | -------------------------------------------- |
| SOL（原生）      | `So11111111111111111111111111111111111111112`  | —                                            |
| BNB（原生）      | —                                              | `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` |
| ETH（原生）      | —                                              | `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` |
| USDC（Solana） | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` | —                                            |
| USDC（Base）   | —                                              | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |

## 安全規則

<Warning>
  這些規則不可協商，由 Skill 強制執行。
</Warning>

| 規則                      | 原因                                          |
| ----------------------- | ------------------------------------------- |
| **不報價不兌換**              | 使用者必須在提交前看到價格                               |
| **不得假定使用者同意**           | 每次破壞性操作都需要明確的"確認"                           |
| **不得隱藏費用或價格影響**         | 成本完全透明                                      |
| **生產環境不得使用 `--yes` 標誌** | 跳過確認僅用於自動化測試                                |
| **始終驗證地址**              | Solana：base58，32-44 字元；EVM：`0x` + 40 位十六進位制 |
| **不得信任外部價格資料**          | 始終使用 ChainStream 的報價端點                      |

## 錯誤恢復

| 錯誤       | 恢復方式                                                                         |
| -------- | ---------------------------------------------------------------------------- |
| 滑點超限     | 增加 `--slippage` 或用新報價重試                                                      |
| 餘額不足     | 檢查 `wallet balance --chain <chain>`                                          |
| 交易回滾     | 在瀏覽器檢視回滾原因；不要自動重試                                                            |
| Job 超時   | 檢查 `job status --id <id>` — 可能仍在處理                                           |
| 402 需要付款 | CLI 透過 [x402 支付](/zh-Hant/docs/platform/billing-payments/x402-payments) 自動處理 |
| 簽名無效     | 使用 `chainstream login` 重新登入                                                  |

## 交易前先研究

執行 DeFi 操作前，始終使用 `chainstream-data` 進行研究：

```mermaid theme={null}
graph LR
  Research["chainstream-data"] --> Security["token security"]
  Security --> Quote["dex route"]
  Quote --> Confirm["使用者確認"]
  Confirm --> Swap["dex swap"]
  Swap --> Monitor["job status"]
```

## 相關文件

<CardGroup cols={2}>
  <Card title="chainstream-data" icon="magnifying-glass" href="/zh-Hant/docs/ai-agents/agent-skills/chainstream-data">
    交易前研究代幣
  </Card>

  <Card title="chainstream-graphql" icon="diagram-project" href="/zh-Hant/docs/ai-agents/agent-skills/chainstream-graphql">
    透過自定義 GraphQL 做深入分析
  </Card>

  <Card title="CLI 命令" icon="terminal" href="/zh-Hant/api-reference/cli-commands/overview">
    完整 CLI 命令參考
  </Card>
</CardGroup>