zhu1090093659/dsh-trading--packages-connector-ccxt15

@dsh-trading/connector-ccxt

基于 CCXT 的交易所连接器插件脚手架模板,提供市场数据服务、交易服务、三态闸门及 BYOK 凭证管理等 v2 插件骨架。

AI 分析

用于开发 CCXT 交易所连接器的脚手架模板。适合需要基于 CCXT 统一接口实现多交易所行情与交易对接的开发者,提供规范的插件骨架。

包名
@dsh-trading/connector-ccxt
版本
0.1.0
许可证
NOASSERTION
最近更新
2026年9月3日

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

@dsh-trading/connector-template

本包是脚手架源,不是可安装的连接器:不入任何 bundle 依赖,仅在 pnpm -r build/test 基线内保证可编译、冒烟测试绿。真实接入用生成器:

node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto

生成后按 docs/connector-playbook.md 的填写顺序 (src/rest.ts 头部清单 7 项)实现 TODO。每个 TODO 的参照段都在 connector-okx (packages/connector-okx/),它是本仓第一个真实 TradeService 连接器。

结构

  • src/rest.ts —— 错误载体(TradingServiceError)+ 通用请求管线(超时/错误映射/ 模拟盘头/注入 fetch)直接可用;签名与端点 TODO。
  • src/index.ts —— Config(enabled/env/dryRun/liveTrading + 三 ref 凭证组)、 闸门三态判定、凭证解析(BYOK + 环境变量回落)、MarketDataService/TradeService 骨架、 7 个市场前缀工具注册(duplicate-safe)、apply(enabled=false 静默退出)。
  • test/template.test.ts —— 结构冒烟 7 用例。

Token

ccxt(slug)/ CCXT(title)/ CCXT(ref 前缀)/ crypto(工具前缀)/ Crypto(服务键 infix)。token 未展开也可编译; 生成器保证全部替换。

注意(勿改的坑)

  • 服务类用 TS 编译期 private(禁 ECMAScript #,realm 代理会炸)。
  • 工具名 = 市场前缀 + 语义词(不带交易所名)——base 闸门正则只认市场前缀。
  • 行 id = dsh-trading--connector-,全仓唯一(insert-only 铁律 #1)。
  • 凭证只进 ref,绝不内置/落日志(铁律 #3/#5)。