mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2025-12-06 13:54:41 +08:00
* feat(trader): add LIGHTER DEX integration (initial implementation) Add pure Go implementation of LIGHTER DEX trader following NOFX architecture Features: - ✅ Account management with Ethereum wallet authentication - ✅ Order operations: market/limit orders, cancel, query - ✅ Position & balance queries - ✅ Zero-fee trading support (Standard accounts) - ✅ Up to 50x leverage for BTC/ETH Implementation: - Pure Go (no CGO dependencies) for easy deployment - Based on hyperliquid_trader.go architecture - Uses Ethereum ECDSA signatures (like Hyperliquid) - API base URL: https://mainnet.zklighter.elliot.ai Files: - lighter_trader.go: Core trader structure & auth - lighter_orders.go: Order management (create/cancel/query) - lighter_account.go: Balance & position queries Status: ⚠️ Partial implementation - ✅ Core structure complete - ⏸️ Auth token generation needs implementation - ⏸️ Transaction signing logic needs completion - ⏸️ Config integration pending Next steps: 1. Complete auth token generation 2. Add to config/exchange registry 3. Add frontend UI support 4. Create test suite 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> * feat: Add LIGHTER DEX integration (快速整合階段) ## 🚀 新增功能 - ✅ 添加 LIGHTER DEX 作為第四個支持的交易所 (Binance, Hyperliquid, Aster, LIGHTER) - ✅ 完整的數據庫配置支持(ExchangeConfig 新增 LighterWalletAddr, LighterPrivateKey 字段) - ✅ 交易所註冊與初始化(initDefaultData 註冊 "lighter") - ✅ TraderManager 集成(配置傳遞邏輯完成) - ✅ AutoTrader 支持(NewAutoTrader 添加 "lighter" case) ## 📝 實現細節 ### 後端整合 1. **數據庫層** (config/database.go): - ExchangeConfig 添加 LIGHTER 字段 - 創建表時添加 lighter_wallet_addr, lighter_private_key 欄位 - ALTER TABLE 語句用於向後兼容 - UpdateExchange/CreateExchange/GetExchanges 支持 LIGHTER - migrateExchangesTable 支持 LIGHTER 字段 2. **API 層** (api/server.go, api/utils.go): - UpdateExchangeConfigRequest 添加 LIGHTER 字段 - SanitizeExchangeConfigForLog 添加脫敏處理 3. **Trader 層** (trader/): - lighter_trader.go: 核心結構、認證、初始化 - lighter_account.go: 餘額、持倉、市場價格查詢 - lighter_orders.go: 訂單管理(創建、取消、查詢) - lighter_trading.go: 交易功能實現(開多/空、平倉、止損/盈) - 實現完整 Trader interface (13個方法) 4. **Manager 層** (manager/trader_manager.go): - addTraderFromDB 添加 LIGHTER 配置設置 - AutoTraderConfig 添加 LIGHTER 字段 ### 實現的功能(快速整合階段) ✅ 基礎交易功能 (OpenLong, OpenShort, CloseLong, CloseShort) ✅ 餘額查詢 (GetBalance, GetAccountBalance) ✅ 持倉查詢 (GetPositions, GetPosition) ✅ 訂單管理 (CreateOrder, CancelOrder, CancelAllOrders) ✅ 止損/止盈 (SetStopLoss, SetTakeProfit, CancelStopLossOrders) ✅ 市場數據 (GetMarketPrice) ✅ 格式化工具 (FormatQuantity) ## ⚠️ TODO(完整實現階段) - [ ] 完整認證令牌生成邏輯 (refreshAuthToken) - [ ] 完整交易簽名邏輯(參考 Python SDK) - [ ] 從 API 獲取幣種精度 - [ ] 區分止損/止盈訂單類型 - [ ] 前端 UI 支持 - [ ] 完整測試套件 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> * feat: 完整集成 LIGHTER DEX with SDK - 集成官方 lighter-go SDK (v0.0.0-20251104171447-78b9b55ebc48) - 集成 Poseidon2 Goldilocks 簽名庫 (poseidon_crypto v0.0.11) - 實現完整的 LighterTraderV2 使用官方 SDK - 實現 17 個 Trader 接口方法(賬戶、交易、訂單管理) - 支持雙密鑰系統(L1 錢包 + API Key) - V1/V2 自動切換機制(向後兼容) - 自動認證令牌管理(8小時有效期) - 添加完整集成文檔 LIGHTER_INTEGRATION.md 新增文件: - trader/lighter_trader_v2.go - V2 核心結構和初始化 - trader/lighter_trader_v2_account.go - 賬戶查詢方法 - trader/lighter_trader_v2_trading.go - 交易操作方法 - trader/lighter_trader_v2_orders.go - 訂單管理方法 - LIGHTER_INTEGRATION.md - 完整文檔 修改文件: - trader/auto_trader.go - 添加 LighterAPIKeyPrivateKey 配置 - config/database.go - 添加 API Key 字段支持 - go.mod, go.sum - 添加 SDK 依賴 🤖 Generated with Claude Code Co-Authored-By: tinkle-community <tinklefund@gmail.com> * feat(lighter): 實現完整 HTTP 調用與動態市場映射 ### 實現的功能 #### 1. submitOrder() - 真實訂單提交 - 使用 POST /api/v1/sendTx 提交已簽名訂單 - tx_type: 14 (CREATE_ORDER) - 價格保護機制 (price_protection) - 完整錯誤處理與響應解析 #### 2. GetActiveOrders() - 查詢活躍訂單 - GET /api/v1/accountActiveOrders - 使用認證令牌 (Authorization header) - 支持按市場索引過濾 #### 3. CancelOrder() - 真實取消訂單 - 使用 SDK 簽名 CancelOrderTxReq - POST /api/v1/sendTx with tx_type: 15 (CANCEL_ORDER) - 自動 nonce 管理 #### 4. getMarketIndex() - 動態市場映射 - 從 GET /api/v1/orderBooks 獲取市場列表 - 內存緩存 (marketIndexMap) 提高性能 - 回退到硬編碼映射(API 失敗時) - 線程安全 (sync.RWMutex) ### 技術實現 **數據結構**: - SendTxRequest/SendTxResponse - sendTx 請求響應 - MarketInfo - 市場信息緩存 **並發安全**: - marketMutex - 保護市場索引緩存 - 讀寫鎖優化性能 **錯誤處理**: - API 失敗回退機制 - 詳細日誌記錄 - HTTP 狀態碼驗證 ### 測試 ✅ 編譯通過 (CGO_ENABLED=1) ✅ 所有 Trader 接口方法實現完整 ✅ HTTP 調用格式符合 LIGHTER API 規範 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> * feat(lighter): 數據庫遷移與前端類型支持 ### 數據庫變更 #### 新增欄位 - `exchanges.lighter_api_key_private_key` TEXT DEFAULT '' - 支持 LIGHTER V2 的 40 字節 API Key 私鑰 #### 遷移腳本 - 📄 `migrations/002_add_lighter_api_key.sql` - 包含完整的驗證和統計查詢 - 向後兼容現有配置(默認為空,使用 V1) #### Schema 更新 - `config/database.go`: - 更新 CREATE TABLE 語句 - 更新 exchanges_new 表結構 - 新增 ALTER TABLE 遷移命令 ### 前端類型更新 #### types.ts - 新增 `Exchange` 接口字段: - `lighterWalletAddr?: string` - L1 錢包地址 - `lighterPrivateKey?: string` - L1 私鑰 - `lighterApiKeyPrivateKey?: string` - API Key 私鑰(⭐新增) ### 技術細節 **數據庫兼容性**: - 使用 ALTER TABLE ADD COLUMN IF NOT EXISTS - 默認值為空字符串 - 不影響現有數據 **類型安全**: - TypeScript 可選字段 - 與後端 ExchangeConfig 結構對齊 ### 下一步 ⏳ **待完成**: 1. ExchangeConfigModal 組件更新 2. API 調用參數傳遞 3. V1/V2 狀態顯示 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> * docs(lighter): 更新 LIGHTER_INTEGRATION.md 文檔狀態 * feat(lighter): 前端完整實現 - API Key 配置與 V1/V2 狀態 **英文**: - `lighterWalletAddress`, `lighterPrivateKey`, `lighterApiKeyPrivateKey` - `lighterWalletAddressDesc`, `lighterPrivateKeyDesc`, `lighterApiKeyPrivateKeyDesc` - `lighterApiKeyOptionalNote` - V1 模式提示 - `lighterV1Description`, `lighterV2Description` - 狀態說明 - `lighterPrivateKeyImported` - 導入成功提示 **中文(繁體)**: - 完整的中文翻譯對應 - 專業術語保留原文(L1、API Key、Poseidon2) **Exchange 接口**: - `lighterWalletAddr?: string` - `lighterPrivateKey?: string` - `lighterApiKeyPrivateKey?: string` **UpdateExchangeConfigRequest 接口**: - `lighter_wallet_addr?: string` - `lighter_private_key?: string` - `lighter_api_key_private_key?: string` **狀態管理**: - 添加 3 個 LIGHTER 狀態變量 - 更新 `secureInputTarget` 類型包含 'lighter' **表單字段**: - L1 錢包地址(必填,text input) - L1 私鑰(必填,password + 安全輸入) - API Key 私鑰(可選,password,40 字節) **V1/V2 狀態顯示**: - 動態背景顏色(V1: 橙色 #3F2E0F,V2: 綠色 #0F3F2E) - 圖標指示(V1: ⚠️,V2: ✅) - 狀態說明文字 **驗證邏輯**: - 必填字段:錢包地址 + L1 私鑰 - API Key 為可選字段 - 自動 V1/V2 檢測 **安全輸入**: - 支持通過 TwoStageKeyModal 安全導入私鑰 - 導入成功後顯示 toast 提示 **handleSaveExchange**: - 添加 3 個 LIGHTER 參數 - 更新交易所對象(新增/更新) - 構建 API 請求(snake_case 字段) **V1 模式(無 API Key)**: ``` ┌────────────────────────────────────────┐ │ ⚠️ LIGHTER V1 │ │ 基本模式 - 功能受限,僅用於測試框架 │ └────────────────────────────────────────┘ 背景: #3F2E0F (橙色調) 邊框: #F59E0B (橙色) ``` **V2 模式(有 API Key)**: ``` ┌────────────────────────────────────────┐ │ ✅ LIGHTER V2 │ │ 完整模式 - 支持 Poseidon2 簽名和真實交易 │ └────────────────────────────────────────┘ 背景: #0F3F2E (綠色調) 邊框: #10B981 (綠色) ``` 1. **類型安全** - 完整的 TypeScript 類型定義 - Props 接口正確對齊 - ✅ 無 LIGHTER 相關編譯錯誤 2. **用戶體驗** - 清晰的必填/可選字段區分 - 實時 V1/V2 狀態反饋 - 安全私鑰輸入支持 3. **向後兼容** - 不影響現有交易所配置 - 所有字段為可選(Optional) - API 請求格式統一 ✅ TypeScript 編譯通過(無 LIGHTER 錯誤) ✅ 類型定義完整且正確 ✅ 所有必需文件已更新 ✅ 與後端 API 格式對齊 Modified: - `web/src/i18n/translations.ts` - 中英文翻譯 - `web/src/types.ts` - 類型定義 - `web/src/components/traders/ExchangeConfigModal.tsx` - Modal 組件 - `web/src/hooks/useTraderActions.ts` - Actions hook 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> * test(lighter): 添加 V1 測試套件與修復 SafeFloat64 缺失 - 新增 trader/helpers.go: 添加 SafeFloat64/SafeString/SafeInt 輔助函數 - 新增 trader/lighter_trader_test.go: LIGHTER V1 測試套件 - ✅ 測試通過 (7/10): - NewTrader 驗證 (無效私鑰, 有效私鑰格式) - FormatQuantity - GetExchangeType - InvalidQuantity 驗證 - InvalidLeverage 驗證 - HelperFunctions (SafeFloat64) - ⚠️ 待改進 (3/10): - GetBalance (需要調整 mock 響應格式) - GetPositions (需要調整 mock 響應格式) - GetMarketPrice (需要調整 mock 響應格式) - 修復 Bug: lighter_account.go 和 lighter_trader_v2_account.go 中未定義的 SafeFloat64 - 測試框架: httptest.Server mock LIGHTER API - 安全: 使用固定測試私鑰 (不含真實資金) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: tinkle-community <tinklefund@gmail.com> --------- Co-authored-by: the-dev-z <the-dev-z@users.noreply.github.com> Co-authored-by: tinkle-community <tinklefund@gmail.com>
259 lines
6.9 KiB
Go
259 lines
6.9 KiB
Go
package trader
|
|
|
|
import (
|
|
"crypto/ecdsa"
|
|
"encoding/json"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"testing"
|
|
|
|
"github.com/ethereum/go-ethereum/crypto"
|
|
"github.com/stretchr/testify/assert"
|
|
)
|
|
|
|
// ============================================================
|
|
// LIGHTER V1 测试套件
|
|
// ============================================================
|
|
|
|
// TestLighterTrader_NewTrader 测试创建LIGHTER交易器
|
|
func TestLighterTrader_NewTrader(t *testing.T) {
|
|
t.Run("无效私钥", func(t *testing.T) {
|
|
trader, err := NewLighterTrader("invalid_key", "", true)
|
|
assert.Error(t, err)
|
|
assert.Nil(t, trader)
|
|
t.Logf("✅ Invalid private key correctly rejected")
|
|
})
|
|
|
|
t.Run("有效私钥格式验证", func(t *testing.T) {
|
|
// 只验证私钥解析,不调用真实 API
|
|
testL1Key := "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
|
|
privateKey, err := crypto.HexToECDSA(testL1Key)
|
|
assert.NoError(t, err)
|
|
assert.NotNil(t, privateKey)
|
|
|
|
walletAddr := crypto.PubkeyToAddress(*privateKey.Public().(*ecdsa.PublicKey)).Hex()
|
|
assert.NotEmpty(t, walletAddr)
|
|
t.Logf("✅ Valid private key format: wallet=%s", walletAddr)
|
|
})
|
|
}
|
|
|
|
// createMockLighterServer 创建 mock LIGHTER API 服务器
|
|
func createMockLighterServer() *httptest.Server {
|
|
return httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
path := r.URL.Path
|
|
var respBody interface{}
|
|
|
|
switch path {
|
|
// Mock GetBalance
|
|
case "/api/v1/account":
|
|
respBody = map[string]interface{}{
|
|
"totalBalance": "10000.00",
|
|
"availableBalance": "8000.00",
|
|
"marginUsed": "2000.00",
|
|
"unrealizedPnl": "100.50",
|
|
}
|
|
|
|
// Mock GetPositions
|
|
case "/api/v1/positions":
|
|
respBody = []map[string]interface{}{
|
|
{
|
|
"symbol": "BTC_USDT",
|
|
"side": "long",
|
|
"positionSize": "0.5",
|
|
"entryPrice": "50000.00",
|
|
"markPrice": "50500.00",
|
|
"unrealizedPnl": "250.00",
|
|
},
|
|
}
|
|
|
|
// Mock GetMarketPrice
|
|
case "/api/v1/ticker/price":
|
|
symbol := r.URL.Query().Get("symbol")
|
|
respBody = map[string]interface{}{
|
|
"symbol": symbol,
|
|
"last_price": "50000.00",
|
|
}
|
|
|
|
// Mock OrderBooks (for market index)
|
|
case "/api/v1/orderBooks":
|
|
respBody = map[string]interface{}{
|
|
"data": []map[string]interface{}{
|
|
{"symbol": "BTC_USDT", "marketIndex": 0},
|
|
{"symbol": "ETH_USDT", "marketIndex": 1},
|
|
},
|
|
}
|
|
|
|
// Mock SendTx (submit/cancel orders)
|
|
case "/api/v1/sendTx":
|
|
respBody = map[string]interface{}{
|
|
"success": true,
|
|
"data": map[string]interface{}{
|
|
"orderId": "12345",
|
|
"status": "success",
|
|
},
|
|
}
|
|
|
|
default:
|
|
w.WriteHeader(http.StatusNotFound)
|
|
json.NewEncoder(w).Encode(map[string]interface{}{
|
|
"error": "Unknown endpoint",
|
|
})
|
|
return
|
|
}
|
|
|
|
w.Header().Set("Content-Type", "application/json")
|
|
json.NewEncoder(w).Encode(respBody)
|
|
}))
|
|
}
|
|
|
|
// createMockLighterTrader 创建带 mock server 的 LIGHTER trader
|
|
func createMockLighterTrader(t *testing.T, mockServer *httptest.Server) *LighterTrader {
|
|
testL1Key := "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
|
|
privateKey, err := crypto.HexToECDSA(testL1Key)
|
|
assert.NoError(t, err)
|
|
|
|
trader := &LighterTrader{
|
|
privateKey: privateKey,
|
|
walletAddr: crypto.PubkeyToAddress(*privateKey.Public().(*ecdsa.PublicKey)).Hex(),
|
|
client: mockServer.Client(),
|
|
baseURL: mockServer.URL,
|
|
testnet: true,
|
|
authToken: "mock_auth_token",
|
|
symbolPrecision: make(map[string]SymbolPrecision),
|
|
}
|
|
|
|
return trader
|
|
}
|
|
|
|
// TestLighterTrader_GetBalance 测试获取余额
|
|
func TestLighterTrader_GetBalance(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
balance, err := trader.GetBalance()
|
|
|
|
assert.NoError(t, err)
|
|
assert.NotNil(t, balance)
|
|
t.Logf("✅ GetBalance: %+v", balance)
|
|
}
|
|
|
|
// TestLighterTrader_GetPositions 测试获取持仓
|
|
func TestLighterTrader_GetPositions(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
positions, err := trader.GetPositions()
|
|
|
|
assert.NoError(t, err)
|
|
assert.NotNil(t, positions)
|
|
t.Logf("✅ GetPositions: found %d positions", len(positions))
|
|
}
|
|
|
|
// TestLighterTrader_GetMarketPrice 测试获取市场价格
|
|
func TestLighterTrader_GetMarketPrice(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
price, err := trader.GetMarketPrice("BTC")
|
|
|
|
assert.NoError(t, err)
|
|
assert.Greater(t, price, 0.0)
|
|
t.Logf("✅ GetMarketPrice(BTC): %.2f", price)
|
|
}
|
|
|
|
// TestLighterTrader_FormatQuantity 测试格式化数量
|
|
func TestLighterTrader_FormatQuantity(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
result, err := trader.FormatQuantity("BTC", 0.123456)
|
|
|
|
assert.NoError(t, err)
|
|
assert.NotEmpty(t, result)
|
|
t.Logf("✅ FormatQuantity: %s", result)
|
|
}
|
|
|
|
// TestLighterTrader_GetExchangeType 测试获取交易所类型
|
|
func TestLighterTrader_GetExchangeType(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
exchangeType := trader.GetExchangeType()
|
|
|
|
assert.Equal(t, "lighter", exchangeType)
|
|
t.Logf("✅ GetExchangeType: %s", exchangeType)
|
|
}
|
|
|
|
// TestLighterTrader_InvalidQuantity 测试无效数量验证
|
|
func TestLighterTrader_InvalidQuantity(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
// 测试零数量
|
|
_, err := trader.OpenLong("BTC", 0, 10)
|
|
assert.Error(t, err)
|
|
|
|
// 测试负数量
|
|
_, err = trader.OpenLong("BTC", -0.1, 10)
|
|
assert.Error(t, err)
|
|
|
|
t.Logf("✅ Invalid quantity validation working")
|
|
}
|
|
|
|
// TestLighterTrader_InvalidLeverage 测试无效杠杆验证
|
|
func TestLighterTrader_InvalidLeverage(t *testing.T) {
|
|
mockServer := createMockLighterServer()
|
|
defer mockServer.Close()
|
|
|
|
trader := createMockLighterTrader(t, mockServer)
|
|
|
|
// 测试零杠杆
|
|
_, err := trader.OpenLong("BTC", 0.1, 0)
|
|
assert.Error(t, err)
|
|
|
|
// 测试负杠杆
|
|
_, err = trader.OpenLong("BTC", 0.1, -10)
|
|
assert.Error(t, err)
|
|
|
|
t.Logf("✅ Invalid leverage validation working")
|
|
}
|
|
|
|
// TestLighterTrader_HelperFunctions 测试辅助函数
|
|
func TestLighterTrader_HelperFunctions(t *testing.T) {
|
|
// 测试 SafeFloat64
|
|
data := map[string]interface{}{
|
|
"float_val": 123.45,
|
|
"string_val": "678.90",
|
|
"int_val": 42,
|
|
}
|
|
|
|
val, err := SafeFloat64(data, "float_val")
|
|
assert.NoError(t, err)
|
|
assert.Equal(t, 123.45, val)
|
|
|
|
val, err = SafeFloat64(data, "string_val")
|
|
assert.NoError(t, err)
|
|
assert.Equal(t, 678.90, val)
|
|
|
|
val, err = SafeFloat64(data, "int_val")
|
|
assert.NoError(t, err)
|
|
assert.Equal(t, 42.0, val)
|
|
|
|
_, err = SafeFloat64(data, "nonexistent")
|
|
assert.Error(t, err)
|
|
|
|
t.Logf("✅ Helper functions working correctly")
|
|
}
|