perp-cli 0.15.0 → 0.16.0

package/dist/exchanges/pacifica.d.ts

@@ -1,9 +1,13 @@
+import { type FundingHistoryRow } from "./interface.js";
 import { Keypair } from "@solana/web3.js";
 import { PacificaClient, type Network } from "../pacifica/index.js";
 import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangePublicTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
 import type { ResolvedSlippage } from "./slippage.js";
 import type { SolanaSigner } from "../signer/index.js";
 import type { AgentMeta } from "../settings.js";
+import type { PriceInfo } from "../pacifica/types/market.js";
+import type { Position } from "../pacifica/types/position.js";
+import type { AccountInfo } from "../pacifica/types/account.js";
 import type { TimeInForce as PacificaTif } from "../pacifica/types/order.js";
 import type { IocOutcome } from "./ioc-outcome.js";
 import { type BuilderApproval, type BuilderDecision, type BuilderFeeGate, type BuilderTarget } from "./builder-fee.js";
@@ -155,6 +159,20 @@ export interface PacificaAmendResult {
     notes: string[];
     venueRaw: unknown;
 }
+/** GET /trades answers the last 20 fills (40 taker + maker rows); no limit or cursor. */
+export declare const PACIFICA_TRADES_CAP = 20;
+/** GET /funding_rate/history `limit` maximum per request (docs; live 4001 → 4000). */
+export declare const PACIFICA_FUNDING_PAGE = 4000;
+/** GET /kline: "Max range: 4000 candles" per request (HTTP 400 beyond, live 2026-10-19). */
+export declare const PACIFICA_KLINE_MAX_BARS = 4000;
+/** Requests one funding / kline read may send (the venue meters reads by credits). */
+export declare const PACIFICA_MAX_PAGES = 10;
+/**
+ * GET /kline intervals (venue error text, live 2026-10-19: "Must be one of 1m, 3m, 5m, 15m, 30m,
+ * 1h, 2h, 4h, 8h, 12h, 1d, 1w, 1M"; each answered 200 with rows labelled `i` = the interval).
+ * The ms length sizes the 4000-bar request windows (1M: 31 days, the longest month).
+ */
+export declare const PACIFICA_KLINE_INTERVALS: Readonly<Record<string, number>>;
 /** Pacifica order_type of a stop / TP / SL order (stop_market, stop_limit, take_profit_*, stop_loss_*). */
 export declare function isPacificaStopType(type: string): boolean;
 /**
@@ -163,6 +181,27 @@ export declare function isPacificaStopType(type: string): boolean;
  * EXCHANGE_ERROR (never a guessed direction). Used by the public tape and the account fills.
  */
 export declare function pacificaFillSide(side: string, endpoint: string): "buy" | "sell";
+/** Pacifica balance with its extras (USDC balance / loan, pending interest, withdrawable). */
+export type PacificaBalance = ExchangeBalance & {
+    usdcBalance: string;
+    borrowedUsdc: string;
+    pendingInterest: string | null;
+    availableToWithdraw: string;
+};
+/**
+ * Balance of a Pacifica account from GET /account, its positions and /info/prices — the one
+ * implementation behind PacificaAdapter.getBalance() and the keyless `account balance --address`.
+ */
+export declare function pacificaBalanceOf(info: AccountInfo, positions: Position[], prices: PriceInfo[]): PacificaBalance;
+/**
+ * Open positions of one Pacifica account (`GET /positions?account=`), marked with `/info/prices`.
+ * The ONE mapper of the keyed `getPositions` and the public-address read: unresolved leverage is
+ * read from the account's `/account/settings` (public, by address), then the market max.
+ */
+export declare function pacificaPositionRows(positions: Position[], prices: PriceInfo[], deps: {
+    accountSettings: () => Promise<unknown>;
+    maxLeverage: () => Promise<Map<string, number | null>>;
+}): Promise<ExchangePosition[]>;
 export declare class PacificaAdapter implements ExchangeAdapter {
     readonly name = "pacifica";
     readonly chain = "solana";
@@ -186,6 +225,7 @@ export declare class PacificaAdapter implements ExchangeAdapter {
     private signMessage;
     private _marketsCache;
     private _marketsCacheTime;
+    private _infoCache;
     private static readonly CACHE_TTL;
     /** Venue network — part of every account cache key (the same key exists on mainnet and testnet). */
     private _network;
@@ -248,8 +288,37 @@ export declare class PacificaAdapter implements ExchangeAdapter {
      */
     builderApprovalOf(target: BuilderTarget): Promise<BuilderApproval>;
     get sdk(): PacificaClient;
+    /**
+     * The configured account for an account read (settings, TWAP orders, …): no Pacifica key
+     * configured → NO_SIGNER_AVAILABLE. A keyless adapter holds a generated throwaway keypair, whose
+     * empty account would otherwise read as "no settings / no orders".
+     */
+    accountForReads(): string;
     get signer(): (msg: Uint8Array) => Promise<Uint8Array>;
+    /** GET /info rows (every instrument type), one CACHE_TTL cache for symbol resolution and getMarkets. */
+    private infoRows;
     getMarkets(): Promise<ExchangeMarketInfo[]>;
+    /**
+     * The venue's own spelling of a perp market typed by the user. Pacifica's API is
+     * case-sensitive (kBONK / kPEPE / kSHIB: `KPEPE` answers `200 []` on /trades, /kline and
+     * /funding_rate/history and 400 "Book not found" on /book — live 2026-10-19), and the CLI
+     * upper-cases the argument. Matched against /info exactly first, then case-insensitively
+     * (a "-PERP" display suffix ignored), as `market info` does. A listed non-perp (spot SOL-USDC)
+     * is refused before any request: this adapter serves perps only (isPacificaPerpetual).
+     */
+    wireSymbol(symbol: string): Promise<string>;
+    /**
+     * wireSymbol for an order entry point (market / limit / stop / edit): a resolution failure is
+     * a definite "not sent" (orderNotSent re-types a read error), never a retryable code.
+     */
+    private orderSymbol;
+    /**
+     * The venue's spelling for a cancel / TP-SL on an existing order or position: resolved as in
+     * wireSymbol when /info lists it (any instrument type, case-insensitive); otherwise — not listed
+     * (a delisted market) or /info unreadable — sent as typed: a cancel must still reach the venue,
+     * whose own answer is final.
+     */
+    private listedSymbol;
     getOrderbook(symbol: string): Promise<{
         bids: [string, string][];
         asks: [string, string][];
@@ -395,12 +464,14 @@ export declare class PacificaAdapter implements ExchangeAdapter {
      * of both parties mapped through `side === "bid"` → all "sell". No de-duplication: two taker
      * rows with equal time / price / amount are two fills (one order filling two makers).
      */
-    getRecentTrades(symbol: string, _limit?: number): Promise<ExchangePublicTrade[]>;
-    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[]>;
+    /**
+     * GET /kline over [startTime, endTime]. The venue refuses a range over 4000 candles (HTTP 400
+     * "Time range too large … Max range: 4000 candles"), so a longer window is read in consecutive
+     * 4000-bar windows (at most PACIFICA_MAX_PAGES), merged by open time. Intervals outside
+     * PACIFICA_KLINE_INTERVALS are refused locally with INVALID_PARAMS (the venue: HTTP 400).
+     */
     getKlines(symbol: string, interval: string, startTime: number, endTime: number): Promise<ExchangeKline[]>;
     /**
      * Recent orders, newest first (GET /orders/history; PacificaClient.get already unwraps the