perp-cli 0.14.3 → 0.16.0

package/dist/exchanges/arcus/spot-chain.d.ts

@@ -1,5 +1,5 @@
 /**
- * Robinhood Chain reads/txs for Arcus spot (design §12.4 #7), over
+ * Robinhood Chain reads/txs for Arcus spot, over
  * `VenueNetworkConfig.rpcUrl` with ethers.
  *
  * Permit2 allowance logic ported from @arcus-xyz/arcus-spot-sdk@1.0.2

package/dist/exchanges/arcus/spot-chain.js

@@ -1,5 +1,5 @@
 /**
- * Robinhood Chain reads/txs for Arcus spot (design §12.4 #7), over
+ * Robinhood Chain reads/txs for Arcus spot, over
  * `VenueNetworkConfig.rpcUrl` with ethers.
  *
  * Permit2 allowance logic ported from @arcus-xyz/arcus-spot-sdk@1.0.2

package/dist/exchanges/arcus/spot-router.d.ts

@@ -1,5 +1,5 @@
 /**
- * Arcus Spot Router HTTP client + wire types (design §12, §12.4 #7).
+ * Arcus Spot Router HTTP client + wire types.
  *
  * Ported from @arcus-xyz/arcus-spot-sdk@1.0.2 (src/client.ts, src/types.ts,
  * src/chains.ts) — Copyright Arcus, licensed under the Apache License 2.0

package/dist/exchanges/arcus/spot-router.js

@@ -1,5 +1,5 @@
 /**
- * Arcus Spot Router HTTP client + wire types (design §12, §12.4 #7).
+ * Arcus Spot Router HTTP client + wire types.
  *
  * Ported from @arcus-xyz/arcus-spot-sdk@1.0.2 (src/client.ts, src/types.ts,
  * src/chains.ts) — Copyright Arcus, licensed under the Apache License 2.0
@@ -167,7 +167,7 @@ export class ArcusSpotRouter {
             sellAmount: p.sellAmount.toString(),
             taker: p.taker,
             slippageBps: String(p.slippageBps),
-            allowWrapped: "false", // §12.4 #7 — never accept a wrapped placeholder
+            allowWrapped: "false", // never accept a wrapped placeholder
         });
     }
     /** Single attempt — never retried (a resend could double-execute). Throws RouterHttpError / PerpError. */

package/dist/exchanges/arcus/spot.d.ts

@@ -1,6 +1,5 @@
 /**
- * Arcus spot = Stock Token swaps through the Arcus Spot Router (design §12,
- * §12.4 #5 #7). Not an exchange account: balances are the master wallet's
+ * Arcus spot = Stock Token swaps through the Arcus Spot Router. Not an exchange account: balances are the master wallet's
  * ERC-20 balances on Robinhood Chain, and every trade is an exact-input swap
  * settled on-chain (Permit2 `PermitWitnessTransferFrom` + `TakerIntent`).
  *
@@ -79,7 +78,7 @@ export declare class ArcusSpotAdapter implements SpotAdapter, SpotPricesCapable
      *   all-in buy price at that notional. The signed intent must then carry
      *   minBuyAmount ≥ size × (1 − slippageBps), else nothing is signed.
      * Both sides also require minBuyAmount ≥ quote.buyAmount × (1 − slippageBps).
-     * slippageBps = the caller's resolveSlippage() value (design §13.2); the router
+     * slippageBps = the caller's resolveSlippage() value; the router
      * takes an integer bound.
      */
     spotMarketOrder(symbol: string, side: "buy" | "sell", size: string, opts: {

package/dist/exchanges/arcus/spot.js

@@ -1,6 +1,5 @@
 /**
- * Arcus spot = Stock Token swaps through the Arcus Spot Router (design §12,
- * §12.4 #5 #7). Not an exchange account: balances are the master wallet's
+ * Arcus spot = Stock Token swaps through the Arcus Spot Router. Not an exchange account: balances are the master wallet's
  * ERC-20 balances on Robinhood Chain, and every trade is an exact-input swap
  * settled on-chain (Permit2 `PermitWitnessTransferFrom` + `TakerIntent`).
  *
@@ -335,7 +334,7 @@ export class ArcusSpotAdapter {
      *   all-in buy price at that notional. The signed intent must then carry
      *   minBuyAmount ≥ size × (1 − slippageBps), else nothing is signed.
      * Both sides also require minBuyAmount ≥ quote.buyAmount × (1 − slippageBps).
-     * slippageBps = the caller's resolveSlippage() value (design §13.2); the router
+     * slippageBps = the caller's resolveSlippage() value; the router
      * takes an integer bound.
      */
     async spotMarketOrder(symbol, side, size, opts) {

package/dist/exchanges/aster-spot.d.ts

@@ -1,5 +1,5 @@
 /**
- * Aster Spot Adapter (design §12, §12.4 #8).
+ * Aster Spot Adapter.
  *
  * Host `sapi.asterdex.com` (testnet `sapi.asterdex-testnet.com`), paths
  * `/api/v3/*`. Signing is the perp EIP-712 Domain B scheme, reused through
@@ -11,7 +11,7 @@
  * Venue rules enforced locally (official spot V3 docs):
  *  - TIF GTC | IOC | GTX (post-only). FOK is rejected by the venue (-1115).
  *  - LIMIT price must be on PRICE_FILTER.tickSize (never rounded).
- *  - Market orders are IOC LIMIT at a protection price (design §13.2): bookTicker
+ *  - Market orders are IOC LIMIT at a protection price: bookTicker
  *    mid ± slippage, aligned toward crossing on tickSize, inside PRICE_FILTER
  *    min/max and PERCENT_PRICE (venue native MARKET is never sent).
  *  - quantity on LOT_SIZE step, min, max (MARKET_LOT_SIZE only for native MARKET).
@@ -95,7 +95,7 @@ export declare class AsterSpotAdapter implements SpotAdapter, SpotTransferCapabl
     /** Effective minimum notional, or null when no filter applies. */
     private _minNotional;
     private _checkNotional;
-    /** §12.4 #8: gate only when the active signer is an agent lacking canSpotTrade. */
+    /** gate only when the active signer is an agent lacking canSpotTrade. */
     private _requireSpotPermission;
     private _signed;
     private _publicGet;

package/dist/exchanges/aster-spot.js

@@ -1,5 +1,5 @@
 /**
- * Aster Spot Adapter (design §12, §12.4 #8).
+ * Aster Spot Adapter.
  *
  * Host `sapi.asterdex.com` (testnet `sapi.asterdex-testnet.com`), paths
  * `/api/v3/*`. Signing is the perp EIP-712 Domain B scheme, reused through
@@ -11,7 +11,7 @@
  * Venue rules enforced locally (official spot V3 docs):
  *  - TIF GTC | IOC | GTX (post-only). FOK is rejected by the venue (-1115).
  *  - LIMIT price must be on PRICE_FILTER.tickSize (never rounded).
- *  - Market orders are IOC LIMIT at a protection price (design §13.2): bookTicker
+ *  - Market orders are IOC LIMIT at a protection price: bookTicker
  *    mid ± slippage, aligned toward crossing on tickSize, inside PRICE_FILTER
  *    min/max and PERCENT_PRICE (venue native MARKET is never sent).
  *  - quantity on LOT_SIZE step, min, max (MARKET_LOT_SIZE only for native MARKET).
@@ -24,7 +24,7 @@
 import { unsupported } from "./trading-v2.js";
 import { asterIocOutcome } from "./aster.js";
 import { PerpError, isTransportFailure, orderNotSent, orderOutcomeUnknown, sendFailure, unknownActionRemediation } from "../errors.js";
-import { alignProtectionPrice, exactUnits, floorSize, requireOnTick, requirePositive, slippagePrice, subDecimal } from "./precision.js";
+import { addDecimal, alignProtectionPrice, exactUnits, floorSize, requireOnTick, requirePositive, slippagePrice, subDecimal } from "./precision.js";
 /** Default quote for a bare base symbol (= venue spot quoteAssets[0]). */
 const DEFAULT_QUOTE = "USDT";
 const SPOT_REMEDIATION = "perp wallet agent rotate aster --can-spot";
@@ -41,9 +41,6 @@ function cmp(a, b) {
         return -1;
     return d === "0" ? 0 : 1;
 }
-function addDecimal(a, b) {
-    return subDecimal(a, b.startsWith("-") ? b.slice(1) : `-${b}`);
-}
 function isZero(v) {
     return cmp(v, "0") === 0;
 }
@@ -150,7 +147,7 @@ export class AsterSpotAdapter {
     }
     // ── Trading ──
     async spotMarketOrder(symbol, side, size, opts) {
-        // §13.2: IOC LIMIT at the protection price, never native MARKET (no price cap).
+        // IOC LIMIT at the protection price, never native MARKET (no price cap).
         // Pre-send (market, size, price, min notional, permission): a failure is a definite "not placed".
         let m;
         let qty;
@@ -246,7 +243,7 @@ export class AsterSpotAdapter {
     }
     async spotLimitOrder(symbol, side, price, size, opts) {
         const m = this._resolveTrading(symbol);
-        // Aster is a legacy family: limit orders keep the GTC default (design §10.7 #6).
+        // Aster is a legacy family: limit orders keep the GTC default.
         const tif = this._mapTif(opts?.tif === undefined ? "GTC" : opts.tif);
         const px = requireOnTick(price, m.tickSize);
         const qty = this._sizeFor(m, size, false);
@@ -517,7 +514,7 @@ export class AsterSpotAdapter {
             });
         }
     }
-    /** §12.4 #8: gate only when the active signer is an agent lacking canSpotTrade. */
+    /** gate only when the active signer is an agent lacking canSpotTrade. */
     _requireSpotPermission() {
         const meta = this._perp.activeAgentMeta();
         if (meta !== null && meta.permissions?.canSpotTrade !== true) {

package/dist/exchanges/aster-typed-data.d.ts

@@ -95,7 +95,7 @@ export interface DelAgentParams {
 /**
  * Build the EIP-712 typed-data payload for `DELETE /fapi/v3/agent`.
  *
- * OPEN ITEM (docs/TEST-PLAN.md "Aster DelAgent struct — mainnet verification"): the
+ * OPEN ITEM (Aster DelAgent struct — mainnet verification): the
  * public Aster V3 docs (asterdex/api-docs, futures api v3 + testnet, checked 2026-10-02)
  * document no agent-delete endpoint or DelAgent struct, and HypurrQuant_FE has no
  * revoke method. This field set mirrors the ApproveAgent terminal fields (AgentAddress,

package/dist/exchanges/aster-typed-data.js

@@ -99,7 +99,7 @@ export function buildApproveAgentTypedData(params) {
 /**
  * Build the EIP-712 typed-data payload for `DELETE /fapi/v3/agent`.
  *
- * OPEN ITEM (docs/TEST-PLAN.md "Aster DelAgent struct — mainnet verification"): the
+ * OPEN ITEM (Aster DelAgent struct — mainnet verification): the
  * public Aster V3 docs (asterdex/api-docs, futures api v3 + testnet, checked 2026-10-02)
  * document no agent-delete endpoint or DelAgent struct, and HypurrQuant_FE has no
  * revoke method. This field set mirrors the ApproveAgent terminal fields (AgentAddress,

package/dist/exchanges/aster.d.ts

@@ -18,7 +18,7 @@
  * Docs: https://docs.asterdex.com/product/aster-perpetuals/api/api-documentation
  * Base: https://fapi.asterdex.com
  */
-import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangePublicTrade, ExchangeFundingPayment, ExchangeKline, FundingHistoryRow } from "./interface.js";
 import type { ResolvedSlippage } from "./slippage.js";
 import type { EvmSigner } from "../signer/interface.js";
 import type { AgentMeta } from "../settings.js";
@@ -68,6 +68,11 @@ type ResolvedSigner = {
  * that the read refuses (EXCHANGE_ERROR) rather than returning a partial history.
  */
 export declare const ASTER_INCOME_MAX_PAGES = 60;
+/**
+ * Kline intervals verified live 2026-10-19 (/fapi/v3/klines BTCUSDT: each answers bars of that
+ * length; "7m" / "2d" → -1120 "Invalid interval."). Anything else is refused before a request.
+ */
+export declare const ASTER_KLINE_INTERVALS: ReadonlySet<string>;
 export declare class AsterAdapter implements ExchangeAdapter {
     readonly name = "aster";
     readonly chain = "bnb";
@@ -89,6 +94,8 @@ export declare class AsterAdapter implements ExchangeAdapter {
     /** API symbol → price filters; null = listed but PRICE_FILTER / PERCENT_PRICE unreadable. */
     private _priceFilters;
     private _priceFiltersLoadedAt;
+    /** The in-flight exchangeInfo load shared by concurrent first uses (_ensureDirectory). */
+    private _directoryLoad;
     private _accountCache;
     private _positionsCache;
     private _ordersCache;
@@ -135,7 +142,12 @@ export declare class AsterAdapter implements ExchangeAdapter {
      * agent. Throws exactly like signed calls when no signer is usable.
      */
     activeAgentMeta(): AgentMeta | null;
-    /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
+    /**
+     * CLI symbol → Aster API symbol through the LOADED market directory (exchangeInfo): the exact
+     * venue symbol first (BTCUSDT, BTCUSD1, BTCU — a non-USDT market's CLI symbol is its venue
+     * symbol, asterCliSymbol), then the USDT market of a base (ETH → ETHUSDT, USD1 → USD1USDT),
+     * else SYMBOL_NOT_FOUND — never a guessed suffix. Callers load the directory first (_apiSymbol).
+     */
     private _toApi;
     /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
     private _fromApi;
@@ -159,9 +171,21 @@ export declare class AsterAdapter implements ExchangeAdapter {
     /** Parse PRICE_FILTER + PERCENT_PRICE for every exchangeInfo symbol into the cache. */
     private _ingestPriceFilters;
     /** PRICE_FILTER / PERCENT_PRICE of an API symbol (exchangeInfo, cached CACHE_TTL). */
+    /** exchangeInfo symbols (the market directory) loaded / refreshed per CACHE_TTL. */
+    /**
+     * exchangeInfo symbols (the market directory), refreshed per CACHE_TTL. Concurrent first uses
+     * share ONE in-flight request; a failed load is not cached (the next call retries).
+     */
+    private _ensureDirectory;
+    /**
+     * CLI symbol → Aster API symbol, resolved through the market directory (_toApi), loaded on first
+     * use and cached CACHE_TTL — so the answer never depends on what was read before (a cold
+     * adapter resolves BTCU, USD1 → USD1USDT, an unknown symbol is SYMBOL_NOT_FOUND).
+     */
+    private _apiSymbol;
     private _symbolPriceFilters;
     /**
-     * Declared protection-price reference (§13.10 #5): the venue mark price from
+     * Declared protection-price reference: the venue mark price from
      * GET /fapi/v3/premiumIndex — the same price PERCENT_PRICE is evaluated against.
      * No runtime substitute (no mid / last fallback): unavailable → PRICE_STALE.
      */
@@ -190,12 +214,8 @@ export declare class AsterAdapter implements ExchangeAdapter {
         bids: [string, string][];
         asks: [string, string][];
     }>;
-    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
-    getFundingHistory(symbol: string, limit?: number): Promise<{
-        time: number;
-        rate: string;
-        price: string | null;
-    }[]>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangePublicTrade[]>;
+    getFundingHistory(symbol: string, limit?: number): Promise<FundingHistoryRow[]>;
     /**
      * Candles over [startTime, endTime]. GET /fapi/v3/klines returns at most 1500 bars per request
      * (1501 → -1130), so the range is read in pages that start after the last bar returned — a long
@@ -272,7 +292,7 @@ export declare class AsterAdapter implements ExchangeAdapter {
     /**
      * Native modify (PUT /fapi/v3/order, V3 futures docs "Modify Order"): LIMIT orders
      * only; TIF (incl. GTX) and reduceOnly stay on the order. `size` is the NEW UNFILLED
-     * quantity (§13.10 #10); the venue's `quantity` is the order total, so
+     * quantity; the venue's `quantity` is the order total, so
      * quantity = size + executedQty (read just before). A fill landing between the read
      * and the PUT can only shrink the remainder, never over-size it. A venue rejection
      * leaves the original order untouched (docs).