@dshtrading/connector-ccxt 0.5.0 → 0.6.1

package/README.md

@@ -7,7 +7,7 @@
 node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto
 ```
 
-生成后按 [docs/connector-playbook.md](../../docs/connector-playbook.md) 的填写顺序
+生成后按 [docs/guides/connector-playbook.md](../../docs/guides/connector-playbook.md) 的填写顺序
 （src/rest.ts 头部清单 7 项）实现 TODO。每个 TODO 的参照段都在 connector-okx
 （packages/connector-okx/），它是本仓第一个真实 TradeService 连接器。
 

package/lib/index.d.ts

@@ -25,7 +25,7 @@ declare class CcxtMarketDataService extends Service implements MarketDataService
 }
 declare class CcxtTradeService extends Service implements TradeService {
   private readonly client;
-  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
   private readonly config;
   constructor(ctx: Context, options: CcxtRestOptions & {
     config: Config;

package/lib/index.js

@@ -1,8 +1,13 @@
 import { CcxtRestClient, INTERVAL_VOCABULARY, SUPPORTED_EXCHANGES, TradingServiceError, normalizeSymbol } from "./rest.js";
+import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
+/**
+* @dshtrading/connector-ccxt
+* CCXT 跨所加密通用连接器插件（提供 tradingCryptoMarketData 与多所聚合工具）。
+*/
 const name = "dsh-trading-crypto-connector-ccxt";
 const Config = Schema.object({
 	enabled: Schema.boolean().default(true).description("是否激活 CCXT 连接器"),
@@ -37,7 +42,7 @@ var CcxtMarketDataService = class extends Service {
 };
 var CcxtTradeService = class extends Service {
 	client;
-	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
 	config;
 	constructor(ctx, options, serviceName = TRADING_CRYPTO_TRADE_KEY) {
 		super(ctx, serviceName);
@@ -49,7 +54,7 @@ var CcxtTradeService = class extends Service {
 	}
 	async placeOrder(order) {
 		const requestedDryRun = order.dryRun ?? true;
-		if (!requestedDryRun && !this.config.liveTrading) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `CCXT TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but liveTrading=false — enable liveTrading explicitly or keep dryRun=true for a simulated fill.`);
+		if (!requestedDryRun && !liveTradingEnabled(this.config.liveTrading)) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `CCXT TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but the signed live-trading authority does not grant real execution (see @dshtrading/authority) — keep dryRun=true for a simulated fill.`);
 		if (requestedDryRun || this.config.dryRun) return {
 			id: `dry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
 			symbol: order.symbol,
@@ -64,7 +69,7 @@ var CcxtTradeService = class extends Service {
 		return this.client.placeOrder(void 0, order);
 	}
 	async cancelOrder(orderId) {
-		if (!this.config.liveTrading || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "CCXT TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires liveTrading=true with dryRun=false.");
+		if (!liveTradingEnabled(this.config.liveTrading) || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "CCXT TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires a signed live-trading grant (see @dshtrading/authority) with dryRun=false.");
 		return this.client.cancelOrder(void 0, orderId);
 	}
 	async getPositions() {

package/lib/rest.d.ts

@@ -6,6 +6,13 @@ declare class TradingServiceError extends Error {
 }
 declare const INTERVAL_VOCABULARY: readonly ["1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"];
 declare const SUPPORTED_EXCHANGES: readonly ["binance", "okx", "bybit", "gateio", "kucoin", "kraken", "coinbase", "bitfinex", "htx"];
+/**
+ * 现货符号归一化（本轮 CCXT 面只做现货）。
+ *
+ * 入参带规范永续后缀 `-SWAP` 时**显式报 TRADING_UNSUPPORTED_SYMBOL**：此前实现会先剥掉
+ * 后缀、再拿同一个符号去打现货端点，等于把永续静默报成现货价（P3 硬不变量：任何路径
+ * 不得把 `-SWAP` 落到 spot 端点）。CCXT 的合约面不属本轮范围，要做得走单独的卡。
+ */
 declare function normalizeSymbol(raw: string): string;
 interface CcxtRestOptions {
   exchange?: string;

package/lib/rest.js

@@ -1,4 +1,9 @@
+import { instrumentFormOf } from "@dshtrading/api";
 //#region src/rest.ts
+/**
+* @dshtrading/connector-ccxt/rest
+* CCXT 跨所加密通用 REST 客户端。
+*/
 var TradingServiceError = class extends Error {
 	code;
 	constructor(code, message, cause) {
@@ -30,8 +35,17 @@ const SUPPORTED_EXCHANGES = [
 	"bitfinex",
 	"htx"
 ];
+/**
+* 现货符号归一化（本轮 CCXT 面只做现货）。
+*
+* 入参带规范永续后缀 `-SWAP` 时**显式报 TRADING_UNSUPPORTED_SYMBOL**：此前实现会先剥掉
+* 后缀、再拿同一个符号去打现货端点，等于把永续静默报成现货价（P3 硬不变量：任何路径
+* 不得把 `-SWAP` 落到 spot 端点）。CCXT 的合约面不属本轮范围，要做得走单独的卡。
+*/
 function normalizeSymbol(raw) {
-	const clean = raw.trim().toUpperCase().replace(/[-_]/g, "");
+	const upper = raw.trim().toUpperCase();
+	if (instrumentFormOf(upper) === "perp") throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `CCXT connector is spot-only: ${upper} is a perpetual (form=perp). Use a spot symbol such as ${upper.replace(/-SWAP$/, "")}, or a perpetual-capable connector (okx/bybit) for contract quotes.`);
+	const clean = upper.replace(/[-_]/g, "");
 	if (clean.includes("/")) return clean.replace("/", "");
 	return clean;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-ccxt",
   "description": "【模板】交易所连接器插件脚手架：CCXT（ccxt）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,7 +21,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.5.0"
+    "@dshtrading/authority": "^0.6.1",
+    "@dshtrading/api": "^0.6.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",