perp-cli 0.9.8 → 0.12.0

package/dist/exchanges/aster.d.ts

@@ -1,17 +1,33 @@
 /**
- * Aster DEX adapter — Binance Futures API compatible REST wrapper.
+ * Aster DEX adapter — EIP-712 three-tier signer routing (v3.2).
+ *
+ * Signer priority:
+ *   Tier 1 — Agent OWS wallet  (registered + not expired + no --no-agent)
+ *   Tier 2 — OWS master wallet (--ows / owsActiveWallet)
+ *   Tier 3 — PK direct         (--private-key / PRIVATE_KEY / ASTER_PRIVATE_KEY)
+ *
+ * HMAC paths fully removed (see Step 3 plan — all Binance-compat HMAC code deleted).
+ *
  * 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 { EvmSigner } from "../signer/interface.js";
+import type { AgentMeta } from "../settings.js";
+import type { AgentSigningStrategy } from "../agent-wallet/signing-strategy.js";
 export declare class AsterAdapter implements ExchangeAdapter {
     readonly name = "aster";
     readonly chain = "bnb";
     readonly aliases: readonly ["ast"];
-    private _apiKey;
-    private _apiSecret;
     private _baseUrl;
     private _testnet;
+    private _agentMeta?;
+    private _agentSigner?;
+    private _masterSigner?;
+    private _pkSigner?;
+    private _useNoAgent;
+    /** PK held between ctor and init() since LocalEvmSigner.create() is async */
+    private _pendingPk?;
     private _marketsCache;
     private _marketsCacheTime;
     private _fundingHoursCache;
@@ -20,14 +36,20 @@ export declare class AsterAdapter implements ExchangeAdapter {
     private _ordersCache;
     private static readonly CACHE_TTL;
     private static readonly ACCOUNT_CACHE_TTL;
-    constructor(apiKey?: string, apiSecret?: string, testnet?: boolean);
+    private _nonceCounter;
+    constructor(privateKey?: string, testnet?: boolean);
+    init(): Promise<void>;
+    setAgent(meta: AgentMeta, strategy: AgentSigningStrategy): void;
+    setMasterSigner(signer: EvmSigner): void;
+    setPkSigner(signer: EvmSigner): void;
+    setNoAgent(noAgent: boolean): void;
     get isReadOnly(): boolean;
+    get activeSignerTier(): "agent" | "master" | "pk" | null;
     /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
     private _toApi;
     /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
     private _fromApi;
-    init(): Promise<void>;
-    /** Get funding interval for a symbol (lazy bootstrap — queries on first access, cached permanently). */
+    /** Get funding interval for a symbol (lazy bootstrap). */
     getFundingHours(symbol: string): Promise<number | undefined>;
     getMarkets(): Promise<ExchangeMarketInfo[]>;
     getOrderbook(symbol: string): Promise<{
@@ -66,11 +88,38 @@ export declare class AsterAdapter implements ExchangeAdapter {
         assetId?: number;
         routeType?: number;
     }): Promise<unknown>;
-    private _sign;
-    /** Handle 429 rate limit with retry */
+    private _resolveSigner;
+    private _nextNonce;
+    /**
+     * Build the canonical signed-request URL per Aster v3 spec.
+     *
+     * Reference: https://github.com/asterdex/api-docs (V3, EN, send_by_url).
+     * The Python reference adds keys to the dict in this exact order:
+     *   nonce, user, signer
+     * then URL-encodes the dict to form the EIP-712 `msg`. After signing,
+     * `&signature=` is appended to the same query string. Authority verification
+     * reconstructs `msg` from the URL query params minus `signature`, so the
+     * signed dict and the URL query string must be byte-identical except for
+     * the appended signature.
+     *
+     * `signatureChainId` is NOT a v3 parameter — it's an artifact of an older
+     * scheme; including it breaks signature verification on every call.
+     */
+    private _buildSignedQueryString;
+    /**
+     * Sign and POST to a path using EIP-712 Domain B.
+     */
+    private _signedPostEip712;
+    /**
+     * Sign and GET from a path using EIP-712 Domain B.
+     */
+    private _signedGetEip712;
+    /**
+     * Sign and DELETE from a path using EIP-712 Domain B.
+     */
+    private _signedDeleteEip712;
+    private _handleEip712Response;
+    /** Handle 429 rate limit with retry — used by GET/DELETE multi-attempt loops */
     private _handleResponse;
     private _publicGet;
-    private _signedGet;
-    private _signedPost;
-    private _signedDelete;
 }