@imbingox/acex 0.3.1-beta.0 → 0.4.0-beta.10

package/README.md

@@ -2,7 +2,7 @@
 
 `acex` 是一个面向交易场景的 **状态型** 多交易所 SDK。调用方持有一个 `AcexClient`，通过统一的 `market` / `account` / `order` manager 读取最新快照、消费增量事件、执行下单撤单命令；SDK 内部负责本地缓存、ready barrier、websocket 生命周期和自动重连，调用方不需要自己处理。
 
-当前 MVP 落地 Binance（Spot + USDⓈ-M + COIN-M 行情，PAPI UM 私有链路）以及 Juplend（Jupiter Lend 只读借贷账户视图）。
+当前 MVP 落地 Binance（Spot + USDⓈ-M + COIN-M 行情，含 Binance TradFi Perps public market data；PAPI UM 私有链路）以及 Juplend（Jupiter Lend 只读借贷账户视图）。
 
 ## 安装
 
@@ -30,7 +30,7 @@ const book = client.market.getL1Book({
   symbol: "BTC/USDT:USDT",
 });
 const books = client.market.getL1Books("BTC/USDT:USDT");
-console.log(`bid=${book?.bidPrice.toFixed()} ask=${book?.askPrice.toFixed()}`);
+console.log(`bid=${book?.bidPrice} ask=${book?.askPrice}`);
 console.log(`venues=${books.length}`);
 console.log(`book freshness=${book?.status.freshness}`);
 
@@ -44,14 +44,14 @@ const funding = client.market.getFundingRate({
   symbol: "BTC/USDT:USDT",
 });
 const fundingRates = client.market.getFundingRates("BTC/USDT:USDT");
-console.log(`funding=${funding?.fundingRate.toFixed()}`);
+console.log(`funding=${funding?.fundingRate}`);
 console.log(`funding venues=${fundingRates.length}`);
 
 for await (const event of client.market.events.l1BookUpdates({
   venue: "binance",
   symbol: "BTC/USDT:USDT",
 })) {
-  console.log(event.snapshot.bidPrice.toFixed());
+  console.log(event.snapshot.bidPrice);
   break;
 }
 
@@ -60,13 +60,14 @@ await client.stop();
 
 ### 同一个 client 同时使用 Binance + Juplend
 
-`createClient({ account: { binance: { riskPollIntervalMs }, juplend: { pollIntervalMs, rpcUrl, jupApiKey } } })` 只是分别配置 Binance 风险/仓位校准间隔和 Juplend 账户 polling / RPC / Jup API，不代表这个 client 只能注册某个 venue。一个 `AcexClient` 可以同时注册 Binance 交易账户和 Juplend 借贷只读账户，用同一个 `AccountManager` 对比风险值。
+`createClient({ account: { binance: { riskPollIntervalMs, privateReconcileIntervalMs }, juplend: { pollIntervalMs, rpcUrl, jupApiKey } } })` 只是分别配置 Binance 风险/仓位校准、Binance private REST 对账和 Juplend 账户 polling / RPC / Jup API，不代表这个 client 只能注册某个 venue。一个 `AcexClient` 可以同时注册 Binance 交易账户和 Juplend 借贷只读账户，用同一个 `AccountManager` 对比风险值。`account.binance.privateReconcileIntervalMs` 省略时默认 60s，显式传 `0` 可关闭 private reconcile（详细行为见 [API 文档](docs/api.md#41-createclientoptions)）。
 
 ```ts
 const client = createClient({
   account: {
     binance: {
       riskPollIntervalMs: 5_000,
+      privateReconcileIntervalMs: 60_000, // 默认值；传 0 可关闭 private reconcile
     },
     juplend: {
       pollIntervalMs: 30_000,
@@ -113,11 +114,11 @@ const juplendRisk = client.account.getRiskSnapshot("jup-loop-a");
 const juplendBalances = client.account.getBalances("jup-loop-a");
 
 for (const balance of juplendBalances) {
-  console.log(balance.asset, balance.lending?.netAsset.toFixed());
+  console.log(balance.asset, balance.lending?.netAsset);
 }
 console.log({
-  binanceRiskRatio: binanceRisk?.riskRatio?.toFixed(),
-  juplendRiskRatio: juplendRisk?.riskRatio?.toFixed(),
+  binanceRiskRatio: binanceRisk?.riskRatio,
+  juplendRiskRatio: juplendRisk?.riskRatio,
 });
 
 await client.stop();
@@ -141,7 +142,7 @@ console.log(juplend.order.reason); // "read_only"
 const capabilities = client.listVenueCapabilities();
 ```
 
-价格、数量等输出字段统一是 `BigNumber`；`createOrder()` 的 `price` / `amount` 输入仍接受 decimal string。详见手册 [§3 核心概念](./docs/api.md#3-核心概念)。
+价格、数量等公共输出字段统一是 canonical decimal string（无科学计数法、不补尾零）；输入侧保持宽进严出，`createOrder()` 的 `price` / `amount` 是 decimal string，`DecimalInput` 仍接受 string / number / `BigNumber`。如需运算，使用 SDK re-export 的 `BigNumber`：`new BigNumber(field)`。详见手册 [§3 核心概念](./docs/api.md#3-核心概念)。
 
 ## 核心能力
 
@@ -160,7 +161,7 @@ const capabilities = client.listVenueCapabilities();
 - 运行时 market/order 能力只支持 `binance`；`okx` / `bybit` / `gate` 仅类型定义
 - 账户视图支持 Binance PAPI UM 与 Juplend 只读借贷账户
 - Juplend 只读，不支持订单和链上写操作；仓位数量来自 `@jup-ag/lend-read` 原生 position 数据
-- Funding Rate 仅支持 Binance 永续合约，来自 mark price websocket；不支持现货和交割合约
+- Funding Rate 仅支持 Binance 永续合约，来自 mark price websocket；支持 Binance TradFi Perps，不支持现货和交割合约
 - `createOrder()` 只支持 `limit` / `market`；条件单、改单、账户级全撤不支持
 - 双向持仓账户下单时必须显式传 `positionSide`
 - `CreateClientOptions` 中 `sandbox` / `logger` / `logLevel` 是预留位