> ## 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 API 和 SDK 的版本更新記錄

## 2026

### 2026-02-04

<Note>
  **SDK v0.2.6 / v0.1.3** - 多語言 SDK 同步更新
</Note>

**SDK 更新**

* TypeScript SDK v0.2.6
  * WebSocket 連線穩定性最佳化
  * 修復訂閱重連問題
* Python SDK v0.1.3
  * 非同步客戶端效能最佳化
  * 新增型別提示完善
* Go SDK v0.1.3
  * 錯誤處理改進
  * 記憶體使用最佳化
* Rust SDK v0.1.3
  * 首個穩定版本
  * 完整 API 覆蓋

***

### 2026-02-03

<Note>
  **SDK v0.2.0** - 多語言 SDK 正式釋出
</Note>

**重大更新**

* 🎉 Python SDK v0.1.0 正式釋出
* 🎉 Go SDK v0.1.0 正式釋出
* 🎉 Rust SDK v0.1.0 正式釋出
* TypeScript SDK 升級至 v0.2.x 系列

**新功能**

* 統一的多語言 SDK 架構
* 完整的 OpenAPI 客戶端支援
* WebSocket 實時資料訂閱

**SDK 版本**

| 語言         | 版本     | 狀態 |
| ---------- | ------ | -- |
| TypeScript | v0.2.4 | 穩定 |
| Python     | v0.1.1 | 穩定 |
| Go         | v0.1.1 | 穩定 |
| Rust       | v0.1.1 | 穩定 |

***

### 2026-01-29

**SDK 更新**

* TypeScript SDK v0.1.26
  * 新增 KYT API 完整支援
  * Webhook 端點管理 API

**改進**

* KYT 交易風險評估響應速度提升
* Webhook 簽名驗證文件更新

***

### 2026-01-20

**新功能**

* 新增代幣流動性快照 API (`/v1/token/{chain}/{address}/liquiditysnapshots`)
* 新增代幣交易者標籤 API (`/v1/token/{chain}/{address}/traders/tag`)

**SDK 更新**

* TypeScript SDK v0.1.22
  * 新增流動性快照方法
  * 型別定義最佳化

***

### 2026-01-15

**新功能**

* Webhook 系統正式釋出
  * 支援代幣建立通知 (`sol.token.created`)
  * 支援代幣畢業通知 (`sol.token.migrated`)
* 新增 Webhook 金鑰輪換 API

**SDK 更新**

* TypeScript SDK v0.1.20
  * 新增 Webhook 端點管理
  * 新增金鑰輪換方法

***

### 2026-01-04

<Note>
  **API v1.4.0** - 新年更新
</Note>

**新功能**

* 新增 KYA (Know Your Address) API
* 新增地址風險評估端點
* 支援批次地址查詢

**SDK 更新**

* TypeScript SDK v0.1.19
  * 完整 KYA API 支援
  * 批次查詢最佳化

**改進**

* API 響應時間平均降低 30%
* 錯誤資訊更加詳細

***

## 2025

### 2025-12-23

**改進**

* 最佳化 Solana 資料覆蓋範圍
* WebSocket 心跳機制最佳化
* 代幣後設資料快取策略改進

**SDK 更新**

* TypeScript SDK v0.1.15
  * WebSocket 重連邏輯最佳化
  * 新增心跳超時配置

***

### 2025-12-01

<Note>
  **API v1.3.0** - KYT 正式釋出
</Note>

**新功能**

* 🎉 KYT (Know Your Transaction) API 正式釋出
  * 交易風險評估
  * 資金來源追溯
  * 風險告警生成
* 新增代幣開發者資訊 API (`/v1/token/{chain}/dev/{devAddress}/tokens`)

**SDK 更新**

* TypeScript SDK v0.1.14
  * 完整 KYT API 支援
  * 新增風險評估方法

**改進**

* DEX 報價聚合支援更多協議
* 最佳化大額交易的路由演算法

***

### 2025-10-15

**新功能**

* 新增代幣安全檢查 API (`/v1/token/{chain}/{address}/security`)
* 新增代幣 mint/burn 歷史 API (`/v1/token/{chain}/{address}/mintandburn`)
* 支援代幣建立資訊查詢 (`/v1/token/{chain}/{address}/creation`)

**SDK 更新**

* TypeScript SDK v0.1.11
  * 新增安全檢查方法
  * 新增代幣歷史查詢

**改進**

* 價格資料延遲降低至 50ms 以內
* K 線資料增加更多時間週期支援

***

### 2025-09-27

<Note>
  **SDK v0.1.0** - TypeScript SDK 正式釋出
</Note>

**重大更新**

* 🎉 TypeScript SDK v0.1.0 正式釋出
* 完整的 REST API 客戶端
* WebSocket 實時資料訂閱支援

**功能特性**

* Token API 完整支援
* Wallet API 完整支援
* DEX API 完整支援
* Ranking API 完整支援
* WebSocket 訂閱方法

***

### 2025-09-18

**新功能**

* 新增錢包餘額更新歷史 API
* 新增錢包 PnL 計算 API
* 支援批次代幣查詢

**SDK 更新**

* TypeScript SDK v0.0.12
  * 新增錢包相關方法
  * 批次查詢支援

***

### 2025-09-08

**新功能**

* WebSocket 實時資料推送正式釋出
* 支援以下訂閱型別：
  * 代幣 K 線 (`dex-token-candles`)
  * 代幣統計 (`dex-token-stats`)
  * 代幣持有者 (`token-holders`)
  * 新代幣 (`dex-new-token`)
  * 錢包餘額 (`wallet-balance`)
  * 錢包交易 (`wallet-trade`)

**SDK 更新**

* TypeScript SDK v0.0.7
  * 新增 WebSocket 客戶端
  * 支援自動重連

***

### 2025-09-03

**新功能**

* DEX 報價和路由 API
* 代幣 K 線資料 API
* 代幣市場資料 API

**SDK 更新**

* TypeScript SDK v0.0.4
  * 新增 DEX 交易方法
  * 新增 K 線查詢

***

### 2025-09-01

<Note>
  **API v1.0.0** - ChainStream API 正式釋出
</Note>

**初始功能**

* 🎉 ChainStream API 正式釋出
* Solana 鏈完整支援
* 核心功能：
  * 代幣資訊和價格查詢
  * 代幣持有者分析
  * DEX 交易資料
  * 錢包餘額和統計
  * 排行榜 API

**SDK 更新**

* TypeScript SDK v0.0.2
  * 首個可用版本
  * 基礎 API 支援

***

### 2025-08-31

<Note>
  **TypeScript SDK v0.0.1** - 首次釋出
</Note>

* TypeScript SDK 首次釋出到 npm
* 包名：`@chainstream-io/sdk`

***

## SDK 版本概覽

### 當前最新版本

| SDK        | 版本     | 釋出日期       | 包管理器                                                                          |
| ---------- | ------ | ---------- | ----------------------------------------------------------------------------- |
| TypeScript | v0.2.6 | 2026-02-04 | [npm](https://www.npmjs.com/package/@chainstream-io/sdk)                      |
| Python     | v0.1.3 | 2026-02-04 | [PyPI](https://pypi.org/project/chainstream/)                                 |
| Go         | v0.1.3 | 2026-02-04 | [pkg.go.dev](https://pkg.go.dev/github.com/chainstream-io/chainstream-sdk/go) |
| Rust       | v0.1.3 | 2026-02-04 | [crates.io](https://crates.io/crates/chainstream)                             |

### TypeScript SDK 版本歷史

| 版本系列   | 版本範圍           | 釋出時間               | 說明           |
| ------ | -------------- | ------------------ | ------------ |
| v0.2.x | 0.2.1 - 0.2.6  | 2026-02            | 多語言 SDK 統一架構 |
| v0.1.x | 0.1.4 - 0.1.26 | 2025-09 \~ 2026-01 | 功能穩定版本       |
| v0.0.x | 0.0.1 - 0.0.12 | 2025-08 \~ 2025-09 | 早期測試版本       |

***

## 版本策略

### API 版本

* **主版本** (v1, v2)：包含破壞性變更
* **次版本** (v1.1, v1.2)：新功能，向後相容
* **補丁** (v1.1.1)：Bug 修復

### SDK 版本

SDK 遵循語義化版本 (SemVer)：

* **Major**：破壞性變更
* **Minor**：新功能
* **Patch**：Bug 修復

### 廢棄策略

* 廢棄的端點至少保留 6 個月
* 廢棄前會在響應頭中新增警告
* 重大變更會提前 30 天通知

***

## 訂閱更新

<CardGroup cols={2}>
  <Card title="郵件訂閱" icon="envelope" href="mailto:support@chainstream.io?subject=Subscribe Updates">
    訂閱版本更新通知
  </Card>

  <Card title="Discord" icon="discord" href="https://discord.gg/quhPXEkJ">
    加入社群獲取最新動態
  </Card>
</CardGroup>
