perp-cli 0.14.0 → 0.14.2

package/dist/exchanges/hyperliquid.js

@@ -1,7 +1,7 @@
 import { LocalEvmSigner } from "../signer/index.js";
 import { DEFINITE_ORDER_FAILURE_CODES, PerpError, classifyError, extractErrorMessage, orderNotSent, orderOutcomeUnknown, sendFailure } from "../errors.js";
 import { parseFiniteVenueNumber, venueRateField } from "../utils/numeric.js";
-import { alignProtectionPrice, floorSize, formatComputedPrice, slippagePrice } from "./precision.js";
+import { alignProtectionPrice, floorSize, formatComputedPrice, slippagePrice, subDecimal } from "./precision.js";
 import { unsupported } from "./trading-v2.js";
 import { buildHlUserSignedAction, hlUserSignedNonceField, signHlL1Action, signHlUserSignedAction } from "./hl-signing.js";
 import { HL_CLOID_RE } from "./venues/hyperliquid.js";
@@ -339,6 +339,29 @@ export function hlL1ActionRejection(type, e) {
         remediation: "The venue refused the whole request and executed nothing; fix the cause named in the venue message above before sending it again",
     });
 }
+/** POST /info userFunding page size (docs: at most 500 rows per response). */
+const HL_FUNDING_PAGE = 500;
+/** 7 days of hourly funding = 168 rows per coin; 20 pages = 10 000 rows (~60 coins). */
+const HL_FUNDING_MAX_PAGES = 20;
+/** A required field of an HL info row as a string; missing / empty → EXCHANGE_ERROR. */
+function hlField(row, key, endpoint) {
+    const v = row[key];
+    if ((typeof v === "string" && v !== "") || (typeof v === "number" && Number.isFinite(v)))
+        return String(v);
+    throw new PerpError("EXCHANGE_ERROR", `Hyperliquid ${endpoint} row without a readable ${key}: ${JSON.stringify(row).slice(0, 160)}`, { exchange: "hyperliquid" });
+}
+/** historicalOrders status precedence on equal statusTimestamp: open < triggered < any terminal status. */
+function hlStatusRank(status) {
+    return status === "open" ? 0 : status === "triggered" ? 1 : 2;
+}
+/** HL side "B" (bid) → buy, "A" (ask) → sell; anything else → EXCHANGE_ERROR. */
+function hlSide(v, endpoint) {
+    if (v === "B")
+        return "buy";
+    if (v === "A")
+        return "sell";
+    throw new PerpError("EXCHANGE_ERROR", `Hyperliquid ${endpoint} row with unknown side ${JSON.stringify(v)}`, { exchange: "hyperliquid" });
+}
 export class HyperliquidAdapter {
     name = "hyperliquid";
     chain = "evm";
@@ -1774,48 +1797,150 @@ export class HyperliquidAdapter {
             trades: Number(c.n ?? 0),
         }));
     }
+    /**
+     * Order history: POST /info {type:"historicalOrders"} ("Retrieve a user's historical orders",
+     * at most 2000 most recent; live 2026-10-13: newest first, each order listed once per status —
+     * e.g. "open" then "filled" — with equal statusTimestamp possible). One row per oid with its
+     * final status (latest statusTimestamp; on a tie a non-"open" status wins). Includes canceled /
+     * rejected orders (the previous userFills read showed fills only). Unreadable rows → EXCHANGE_ERROR.
+     * The info endpoint is account-wide; rows are scoped to this adapter (see _inHistoryScope).
+     */
     async getOrderHistory(limit = 30) {
         this.ensureAddress();
-        const fills = await this._infoPost({ type: "userFills", user: this._address });
-        return (fills ?? []).slice(0, limit).map((f) => ({
-            orderId: String(f.oid ?? ""),
-            symbol: this._displaySymbol(String(f.coin ?? "")),
-            side: String(f.side) === "B" ? "buy" : String(f.side) === "A" ? "sell" : String(f.side).toLowerCase(),
-            price: String(f.px ?? "0"),
-            size: String(f.sz ?? ""),
-            filled: String(f.sz ?? ""),
-            status: "filled",
-            type: String(f.dir ?? ""),
-            triggerPrice: null, // fills carry no trigger price
-        }));
+        const rows = await this._infoPost({ type: "historicalOrders", user: this._address });
+        if (!Array.isArray(rows)) {
+            throw new PerpError("EXCHANGE_ERROR", `Hyperliquid historicalOrders returned no list (${JSON.stringify(rows).slice(0, 120)})`, { exchange: "hyperliquid" });
+        }
+        await this._historyScopeReady();
+        const latest = new Map();
+        for (const row of rows) {
+            const o = row.order;
+            const at = Number(row.statusTimestamp);
+            if (o === undefined || o === null || typeof row.status !== "string" || !Number.isFinite(at) || (typeof o.oid !== "number" && typeof o.oid !== "string")) {
+                throw new PerpError("EXCHANGE_ERROR", `Hyperliquid historicalOrders row without order / oid / status / statusTimestamp: ${JSON.stringify(row).slice(0, 160)}`, { exchange: "hyperliquid" });
+            }
+            if (!this._inHistoryScope(hlField(o, "coin", "historicalOrders")))
+                continue;
+            const key = String(o.oid);
+            const prev = latest.get(key);
+            if (prev === undefined || at > prev.at || (at === prev.at && hlStatusRank(row.status) > hlStatusRank(prev.status))) {
+                latest.set(key, { at, status: row.status, o });
+            }
+        }
+        return [...latest.values()].sort((x, y) => y.at - x.at).slice(0, limit).map(({ status, o }) => {
+            const origSz = hlField(o, "origSz", "historicalOrders");
+            const remaining = hlField(o, "sz", "historicalOrders");
+            const triggerPx = Number(o.triggerPx);
+            return {
+                orderId: String(o.oid),
+                symbol: this._displaySymbol(hlField(o, "coin", "historicalOrders")),
+                side: hlSide(o.side, "historicalOrders"),
+                price: hlField(o, "limitPx", "historicalOrders"),
+                size: origSz,
+                filled: subDecimal(origSz, remaining),
+                status,
+                type: hlField(o, "orderType", "historicalOrders"),
+                triggerPrice: o.isTrigger === true && Number.isFinite(triggerPx) && triggerPx > 0 ? String(o.triggerPx) : null,
+            };
+        });
     }
+    /** Fills: POST /info {type:"userFills"} (at most 2000 most recent, newest first — live 2026-10-13). */
     async getTradeHistory(limit = 30) {
         this.ensureAddress();
         const fills = await this._infoPost({ type: "userFills", user: this._address });
-        return (fills ?? []).slice(0, limit).map((f) => ({
-            time: Number(f.time ?? 0),
-            symbol: this._displaySymbol(String(f.coin ?? "")),
-            side: String(f.side) === "B" ? "buy" : String(f.side) === "A" ? "sell" : String(f.side).toLowerCase(),
-            price: String(f.px ?? "0"),
-            size: String(f.sz ?? ""),
-            fee: String(f.fee ?? "0"),
-        }));
+        if (!Array.isArray(fills)) {
+            throw new PerpError("EXCHANGE_ERROR", `Hyperliquid userFills returned no list (${JSON.stringify(fills).slice(0, 120)})`, { exchange: "hyperliquid" });
+        }
+        await this._historyScopeReady();
+        return fills.filter((f) => this._inHistoryScope(hlField(f, "coin", "userFills"))).slice(0, limit).map((f) => {
+            const time = Number(hlField(f, "time", "userFills"));
+            if (!Number.isFinite(time))
+                throw new PerpError("EXCHANGE_ERROR", "Hyperliquid userFills row with a non-numeric time", { exchange: "hyperliquid" });
+            return {
+                time,
+                symbol: this._displaySymbol(hlField(f, "coin", "userFills")),
+                side: hlSide(f.side, "userFills"),
+                price: hlField(f, "px", "userFills"),
+                size: hlField(f, "sz", "userFills"),
+                fee: hlField(f, "fee", "userFills"),
+            };
+        });
     }
+    /**
+     * Funding payments in this adapter's scope (see _inHistoryScope), newest first, at most `limit`.
+     * Reads the last 24 h first and widens to 7 days only when that holds fewer than `limit` rows
+     * (POST /info userFunding weighs per row returned; bots poll it).
+     */
     async getFundingPayments(limit = 200) {
         this.ensureAddress();
-        // Direct API call — SDK's getUserFunding silently truncates results
-        const apiUrl = this._testnet ? "https://api.hyperliquid-testnet.xyz/info" : "https://api.hyperliquid.xyz/info";
-        const res = await fetch(apiUrl, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ type: "userFunding", user: this._address, startTime: Date.now() - 7 * 24 * 60 * 60 * 1000 }),
-        });
-        const data = await res.json();
-        return (data ?? []).slice(0, limit).map((h) => ({
-            time: h.time,
-            symbol: h.delta.coin + "-PERP",
-            payment: h.delta.usdc,
-        }));
+        await this._historyScopeReady();
+        const now = Date.now();
+        let rows = await this._fundingSince(now - 24 * 60 * 60 * 1000);
+        if (rows.length < limit)
+            rows = await this._fundingSince(now - 7 * 24 * 60 * 60 * 1000);
+        return rows.sort((a, b) => b.time - a.time).slice(0, limit);
+    }
+    /**
+     * Every userFunding row since `startTime`. The endpoint returns rows OLDEST first, at most 500
+     * per response (live 2026-10-13), and every coin of a funding hour shares one millisecond — so
+     * pages continue from the last row's time INCLUSIVE and rows are deduped by time + coin (funding
+     * rows carry a zero hash). A full page that adds nothing new, or more than HL_FUNDING_MAX_PAGES
+     * pages → EXCHANGE_ERROR (never a list with payments silently missing).
+     */
+    async _fundingSince(startTime) {
+        const out = [];
+        const seen = new Set();
+        let from = startTime;
+        for (let page = 0;; page++) {
+            if (page >= HL_FUNDING_MAX_PAGES) {
+                throw new PerpError("EXCHANGE_ERROR", `Hyperliquid funding history needs more than ${HL_FUNDING_MAX_PAGES} pages — the result would be incomplete`, { exchange: "hyperliquid" });
+            }
+            const rows = await this._infoPost({ type: "userFunding", user: this._address, startTime: from });
+            if (!Array.isArray(rows)) {
+                throw new PerpError("EXCHANGE_ERROR", `Hyperliquid userFunding returned no list (${JSON.stringify(rows).slice(0, 120)})`, { exchange: "hyperliquid" });
+            }
+            let last = -Infinity;
+            let fresh = 0;
+            for (const h of rows) {
+                const time = Number(h.time);
+                const delta = h.delta;
+                if (!Number.isFinite(time) || delta === undefined || delta === null || typeof delta.coin !== "string" || delta.coin === "" || typeof delta.usdc !== "string" || delta.usdc === "") {
+                    throw new PerpError("EXCHANGE_ERROR", `Hyperliquid userFunding row without time / delta.coin / delta.usdc: ${JSON.stringify(h).slice(0, 160)}`, { exchange: "hyperliquid" });
+                }
+                last = Math.max(last, time);
+                const key = `${time}|${delta.coin}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                fresh++;
+                if (this._inHistoryScope(delta.coin))
+                    out.push({ time, symbol: this._displaySymbol(delta.coin), payment: delta.usdc });
+            }
+            if (rows.length < HL_FUNDING_PAGE)
+                break;
+            if (fresh === 0) {
+                throw new PerpError("EXCHANGE_ERROR", `Hyperliquid returned ${HL_FUNDING_PAGE}+ funding rows at one millisecond (${last}) — paging cannot advance`, { exchange: "hyperliquid" });
+            }
+            from = last;
+        }
+        return out;
+    }
+    /** The asset map backs _displaySymbol / _inHistoryScope; load it before mapping history rows. */
+    async _historyScopeReady() {
+        if (this._assetMap.size === 0)
+            await this._loadAssetMap();
+        if (this._assetMapError)
+            throw this._assetMapError;
+    }
+    /**
+     * Whether an account-wide history row (historicalOrders / userFills / userFunding carry every
+     * dex, spot "@n" / "PAIR/USDC" and outcome "#n" coins) belongs to this adapter: a HIP-3 dex
+     * adapter keeps "<dex>:…" coins, the native adapter keeps native perp coins only.
+     */
+    _inHistoryScope(coin) {
+        if (this._dex)
+            return coin.startsWith(`${this._dex}:`);
+        return !/[:@#/]/.test(coin);
     }
     async getFundingHistory(symbol, limit = 10) {
         const now = Date.now();

package/dist/exchanges/lighter.d.ts

@@ -154,7 +154,7 @@ export declare function lighterTakerFilledBase(eventInfo: unknown, sentBaseAmoun
  * A required open-order row field as a string (Rule #2): missing / empty / non-finite numeric →
  * EXCHANGE_ERROR, never listed as price / size "0" or status "open".
  */
-export declare function lighterRowField(o: Record<string, unknown>, key: string, venue: string): string;
+export declare function lighterRowField(o: Record<string, unknown>, key: string, venue: string, what?: "open order" | "order history"): string;
 /** What identifies OUR accountOrders row besides the client order index: the market sent to and the send time. */
 export interface LighterRowMatch {
     marketIndex: number;

package/dist/exchanges/lighter.js

@@ -250,12 +250,12 @@ export function lighterTakerFilledBase(eventInfo, sentBaseAmount) {
  * A required open-order row field as a string (Rule #2): missing / empty / non-finite numeric →
  * EXCHANGE_ERROR, never listed as price / size "0" or status "open".
  */
-export function lighterRowField(o, key, venue) {
+export function lighterRowField(o, key, venue, what = "open order") {
     const v = o[key];
     if ((typeof v === "string" && v.trim() !== "") || (typeof v === "number" && Number.isFinite(v)))
         return String(v);
-    throw new PerpError("EXCHANGE_ERROR", `${venue} open order ${lighterOrderIdOf(o) || "(no id)"}: row has no ${key} (got ${JSON.stringify(v ?? null)})`, {
-        exchange: venue, remediation: `Retry: perp -e ${venue} account orders`,
+    throw new PerpError("EXCHANGE_ERROR", `${venue} ${what} ${lighterOrderIdOf(o) || "(no id)"}: row has no ${key} (got ${JSON.stringify(v ?? null)})`, {
+        exchange: venue, remediation: `Retry: perp -e ${venue} ${what === "open order" ? "account orders" : "account history"}`,
     });
 }
 /** `iocOutcomeOf` parser shared by LighterAdapter and LighterSpotAdapter. */
@@ -1438,7 +1438,7 @@ export class LighterAdapter {
                 size: lighterRowField(o, "initial_base_amount", this.name),
                 filled: lighterRowField(o, "filled_base_amount", this.name),
                 status: lighterRowField(o, "status", this.name),
-                type: String(o.type ?? "limit"),
+                type: lighterRowField(o, "type", this.name),
                 triggerPrice: Number(o.trigger_price) > 0 ? String(o.trigger_price) : null,
             };
         });
@@ -2097,15 +2097,17 @@ export class LighterAdapter {
         if (!this._address)
             throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const orders = await this.historyRows("/accountInactiveOrders", "orders", { market_type: "perp" }, limit, true);
+        // Every field is required: a missing price / size / status / type is an unreadable row, never "0" / "done" / "limit".
+        const req = (o, k) => lighterRowField(o, k, this.name, "order history");
         return orders.map((o) => ({
             orderId: lighterOrderIdOf(o),
             symbol: this.historySymbol(o.market_index, "order history", o),
             side: this.sideOfIsAsk(o.is_ask, "order history", o),
-            price: String(o.price ?? "0"),
-            size: String(o.initial_base_amount ?? o.base_amount ?? ""),
-            filled: String(o.filled_base_amount ?? "0"),
-            status: String(o.status ?? "done"),
-            type: String(o.type ?? "limit"),
+            price: req(o, "price"),
+            size: req(o, "initial_base_amount"),
+            filled: req(o, "filled_base_amount"),
+            status: req(o, "status"),
+            type: req(o, "type"),
             triggerPrice: Number(o.trigger_price) > 0 ? String(o.trigger_price) : null,
         }));
     }

package/dist/exchanges/ondo/adapter.d.ts

@@ -42,12 +42,6 @@ import type { VenueCreateContext, VenueDefinition } from "../venue.js";
 import type { AmendRequest, CancelResult, LeverageResult, Network, OrderRef, OrderRequest, OrderResult, VenueMarket } from "../venue-types.js";
 import { type BuilderFeeGate } from "../builder-fee.js";
 import { OndoClient } from "./client.js";
-interface OndoWithdrawal {
-    withdrawal_status: string;
-    withdrawal_id: string;
-    customer_withdrawal_id: string;
-    hash?: string;
-}
 export declare class OndoAdapter implements ExchangeAdapter, TradingV2 {
     readonly name: "ondo";
     readonly aliases: readonly ["ondo-perps"];
@@ -72,8 +66,6 @@ export declare class OndoAdapter implements ExchangeAdapter, TradingV2 {
     get restClient(): OndoClient;
     /** Account id from GET /v1/account — the `from.id`/`to.id` of withdrawals and spot↔perp transfers. */
     accountId(): Promise<string>;
-    /** Withdrawal address book (GET /v1/wallet/address_book) — withdrawals go only to these addresses. */
-    addressBook(): Promise<string[]>;
     private pairOf;
     /**
      * An order the venue returned as "pending" (not yet open / filled) is read back by id
@@ -152,15 +144,9 @@ export declare class OndoAdapter implements ExchangeAdapter, TradingV2 {
         triggerType?: "mark" | "last" | "mid";
     }): Promise<OrderResult>;
     /**
-     * Withdraw USDC from the perps (margin) wallet to an Ethereum address.
-     * Requires an API key with the `transfer` scope. The destination may need to
-     * be on the account's address book (venue error bad_withdrawal_address).
+     * Withdrawals are not available over the API (account owner, 2026-10-13): Ondo pays only
+     * address-book destinations and refuses API-key auth for adding one
+     * (`key_not_allowed_for_action`). Refused before any request — withdraw in the web app.
      */
-    withdraw(amount: string, destination: string, opts?: {
-        assetId?: number;
-        routeType?: number;
-    }): Promise<OndoWithdrawal & {
-        withdrawalFeeUSD: string;
-    }>;
+    withdraw(_amount: string, _destination: string): Promise<never>;
 }
-export {};

package/dist/exchanges/ondo/adapter.js

@@ -41,7 +41,6 @@ import { alignProtectionPrice, floorSize, formatComputedPrice, requireOnTick, sl
 import { unsupported, validateLegacyTif, validateOrderRequest } from "../trading-v2.js";
 import { networkConfig, requireCapabilities } from "../venue.js";
 import { parseOrderRef, toLegacyMarketInfo } from "../venue-types.js";
-import { ONDO_WITHDRAW_NETWORK } from "../venues/ondo.js";
 import { builderGateOf, builderRejectionOf, NO_BUILDER, requireFeeBps } from "../builder-fee.js";
 import { loadOndoCredentials, ONDO_APPROVE_REMEDIATION } from "./agent.js";
 import { OndoClient } from "./client.js";
@@ -217,10 +216,6 @@ export class OndoAdapter {
         const account = await this.client.get("/v1/account", null);
         return account.accountID;
     }
-    /** Withdrawal address book (GET /v1/wallet/address_book) — withdrawals go only to these addresses. */
-    async addressBook() {
-        return (await import("./funds.js")).ondoAddressBook(this.client);
-    }
     // ── Helpers ──
     async pairOf(symbol) {
         const market = ondoVenueSymbol(symbol);
@@ -806,30 +801,11 @@ export class OndoAdapter {
     }
     // ── Withdraw (capabilities.WithdrawCapable) ──
     /**
-     * Withdraw USDC from the perps (margin) wallet to an Ethereum address.
-     * Requires an API key with the `transfer` scope. The destination may need to
-     * be on the account's address book (venue error bad_withdrawal_address).
+     * Withdrawals are not available over the API (account owner, 2026-10-13): Ondo pays only
+     * address-book destinations and refuses API-key auth for adding one
+     * (`key_not_allowed_for_action`). Refused before any request — withdraw in the web app.
      */
-    async withdraw(amount, destination, opts) {
-        if (opts?.assetId !== undefined || opts?.routeType !== undefined) {
-            throw new PerpError("INVALID_PARAMS", "Ondo Perps withdraw takes no assetId/routeType (USDC on Ethereum only)");
-        }
-        if (!/^0x[0-9a-fA-F]{40}$/.test(destination)) {
-            throw new PerpError("INVALID_PARAMS", `Ondo Perps withdraw destination must be an Ethereum address (got "${destination}")`);
-        }
-        if (!/^\d+(\.\d+)?$/.test(amount) || !isPositive(amount)) {
-            throw new PerpError("INVALID_PARAMS", `Withdraw amount must be a positive decimal (got "${amount}")`);
-        }
-        // AccountInfo.withdrawalFeeUSD (required in the OpenAPI spec) is reported with the result.
-        const account = await this.client.get("/v1/account", null);
-        const res = await this.client.post("/v1/withdraw", {
-            customer_withdrawal_id: randomUUID(),
-            symbol: "USDC",
-            network: ONDO_WITHDRAW_NETWORK,
-            amount,
-            address: destination,
-            from: { id: account.accountID, wallet: "margin" },
-        });
-        return { ...res, withdrawalFeeUSD: account.withdrawalFeeUSD };
+    async withdraw(_amount, _destination) {
+        throw unsupported("Ondo Perps", "withdraw", "the Ondo Perps API does not allow withdrawals", "Withdraw from the Ondo Perps web app");
     }
 }

package/dist/exchanges/ondo/funds.d.ts

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps funding (mainnet only) + withdrawal address book.
+ * Ondo Perps funding (mainnet only). Withdrawals are web-app only (the API cannot withdraw).
  *
  * Deposit = a plain ERC-20 transfer of USDC to the account's own funding address
  * (docs.ondoperps.xyz/funding-ondo-perps, api-reference/integration_guide "Deposit USDC").
@@ -13,12 +13,7 @@
  *   - With a probe amount the transfer is two-step: probe → wait until GET /v1/wallet/deposits
  *     shows it confirmed → remainder. A probe that is not credited within the window stops the
  *     flow (ORDER_PENDING with the probe tx hash); the remainder is NOT sent.
- *
- * Address book: withdrawals go only to addresses on the account's address book. An address is
- * added by signing a SIWE challenge with the account's wallet
- * (POST /v1/auth/erc-4361/address_book/get_challenge → personal_sign → …/complete_challenge).
  */
-import { PerpError } from "../../errors.js";
 import { type TxSigner } from "../../evm-master-tx.js";
 import type { Network } from "../venue-types.js";
 import { type OndoDepositChain } from "../venues/ondo.js";
@@ -26,7 +21,6 @@ import { type OndoDepositChain } from "../venues/ondo.js";
 export interface OndoFundsClient {
     get<T>(path: string, query: null): Promise<T>;
     post<T>(path: string, body: unknown): Promise<T>;
-    postNoResult(path: string, body: unknown): Promise<void>;
 }
 export declare const ONDO_DEPOSIT_CREDIT_TIMEOUT_MS = 600000;
 export declare const ONDO_DEPOSIT_CREDIT_POLL_MS = 10000;
@@ -98,25 +92,3 @@ export interface OndoDepositResult {
  * remainder is never sent while the probe is uncredited (the ORDER_PENDING carries `sent`).
  */
 export declare function executeOndoDeposit(plan: OndoDepositPlan, sign: TxSigner, readDeposits: () => Promise<unknown>, timing: PollTiming): Promise<OndoDepositResult>;
-/** Withdrawal addresses on the account's address book (GET /v1/wallet/address_book). */
-export declare function ondoAddressBook(client: OndoFundsClient): Promise<string[]>;
-/** Refusal for a withdraw destination that is not on the address book (nothing was sent). */
-export declare function ondoAddressNotOnBook(destination: string, book: readonly string[]): PerpError;
-/** A challenge the master key will sign must be about this address book entry — never an arbitrary message. */
-export declare function assertOndoAddressBookChallenge(message: string, wallet: string, withdrawalAddress: string, restUrl: string): void;
-export interface OndoAddressBookAddResult {
-    address: string;
-    alreadyListed: boolean;
-    listed: boolean;
-    challengeId: string | null;
-}
-/**
- * Add the signing wallet's own address to the address book: get_challenge → personal_sign
- * (EIP-191) with the wallet → complete_challenge. Challenge chainId "1" (enum: 1 | 43114).
- */
-export declare function addOndoAddressBookEntry(client: OndoFundsClient, p: {
-    wallet: string;
-    restUrl: string;
-    label: string | null;
-    signMessage: (message: string) => Promise<string>;
-}): Promise<OndoAddressBookAddResult>;

package/dist/exchanges/ondo/funds.js

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps funding (mainnet only) + withdrawal address book.
+ * Ondo Perps funding (mainnet only). Withdrawals are web-app only (the API cannot withdraw).
  *
  * Deposit = a plain ERC-20 transfer of USDC to the account's own funding address
  * (docs.ondoperps.xyz/funding-ondo-perps, api-reference/integration_guide "Deposit USDC").
@@ -13,12 +13,8 @@
  *   - With a probe amount the transfer is two-step: probe → wait until GET /v1/wallet/deposits
  *     shows it confirmed → remainder. A probe that is not credited within the window stops the
  *     flow (ORDER_PENDING with the probe tx hash); the remainder is NOT sent.
- *
- * Address book: withdrawals go only to addresses on the account's address book. An address is
- * added by signing a SIWE challenge with the account's wallet
- * (POST /v1/auth/erc-4361/address_book/get_challenge → personal_sign → …/complete_challenge).
  */
-import { formatUnits, parseUnits, verifyMessage } from "ethers";
+import { formatUnits, parseUnits } from "ethers";
 import { PerpError } from "../../errors.js";
 import { ERC20, EVM_ADDRESS_RE, assertRpcChainId, erc20Balance, erc20Decimals, evmProvider, sameAddress, sendMasterTx, } from "../../evm-master-tx.js";
 import { unsupported } from "../trading-v2.js";
@@ -200,91 +196,3 @@ export async function executeOndoDeposit(plan, sign, readDeposits, timing) {
     }
     return { transfers, depositAddress: plan.depositAddress };
 }
-// ── Address book ──
-const ADDRESS_BOOK_UI = "add the address in the Ondo Perps web app (Withdraw → address book)";
-/** Withdrawal addresses on the account's address book (GET /v1/wallet/address_book). */
-export async function ondoAddressBook(client) {
-    const res = await client.get("/v1/wallet/address_book", null);
-    if (!Array.isArray(res.addressBook))
-        throw venueError("GET /v1/wallet/address_book returned no addressBook list");
-    return res.addressBook.map(e => {
-        if (typeof e?.withdrawalAddress !== "string")
-            throw venueError("address book entry has no withdrawalAddress");
-        return e.withdrawalAddress;
-    });
-}
-/** Refusal for a withdraw destination that is not on the address book (nothing was sent). */
-export function ondoAddressNotOnBook(destination, book) {
-    return new PerpError("INVALID_PARAMS", `${destination} is not on the Ondo Perps withdrawal address book (${book.length === 0 ? "the book is empty" : `listed: ${book.join(", ")}`}) — nothing was sent`, {
-        exchange: "ondo",
-        remediation: `Ondo only withdraws to address-book entries. An entry is added by signing a SIWE challenge with the account's wallet (api-reference/auth/get-siwe-address-book-challenge + complete). For the master wallet's own address run: perp funds address-book add ondo ${destination} — otherwise ${ADDRESS_BOOK_UI}`,
-    });
-}
-/** A challenge the master key will sign must be about this address book entry — never an arbitrary message. */
-export function assertOndoAddressBookChallenge(message, wallet, withdrawalAddress, restUrl) {
-    const refuse = (why) => {
-        throw new PerpError("POLICY_DENIED", `Ondo address-book challenge refused: ${why}. Nothing was signed.`, {
-            exchange: "ondo", challenge: message.slice(0, 600), remediation: `If this message is expected, ${ADDRESS_BOOK_UI}`,
-        });
-    };
-    if (!message.toLowerCase().includes(withdrawalAddress.toLowerCase()))
-        refuse(`the message does not name the withdrawal address ${withdrawalAddress}`);
-    // The endpoint is POST /v1/auth/erc-4361/address_book/get_challenge — "Get a Sign-In with Ethereum
-    // challenge for adding a withdrawal address" (Ondo REST spec). ERC-4361 shape:
-    // "<domain> wants you to sign in with your Ethereum account:\n<address>\n…". Any other message
-    // is refused: the master key never signs free-form text.
-    const siwe = /^(\S+) wants you to sign in with your Ethereum account:\n(0x[0-9a-fA-F]{40})\n/.exec(message);
-    if (siwe === null)
-        return refuse("the message is not a Sign-In with Ethereum (ERC-4361) message");
-    const venueHost = new URL(restUrl).hostname.split(".").slice(-2).join(".");
-    const domain = siwe[1].replace(/^[a-z]+:\/\//, "").split(":")[0];
-    if (domain !== venueHost && !domain.endsWith(`.${venueHost}`))
-        refuse(`its domain "${siwe[1]}" is not ${venueHost}`);
-    if (!sameAddress(siwe[2], wallet))
-        refuse(`it is addressed to ${siwe[2]}, not the signing wallet ${wallet}`);
-}
-/** A venue refusal of the SIWE address-book endpoints, re-raised with the web-app route. */
-function addressBookAuthError(e, step) {
-    if (!(e instanceof PerpError) || e.structured.code === "ORDER_PENDING")
-        return e;
-    return new PerpError(e.structured.code, `${e.message} — Ondo refused the address-book ${step} with API-key auth`, {
-        ...e.structured.details, exchange: "ondo",
-        remediation: `These endpoints may need a wallet (SIWE/JWT) session instead of an API key: ${ADDRESS_BOOK_UI}`,
-    });
-}
-/**
- * Add the signing wallet's own address to the address book: get_challenge → personal_sign
- * (EIP-191) with the wallet → complete_challenge. Challenge chainId "1" (enum: 1 | 43114).
- */
-export async function addOndoAddressBookEntry(client, p) {
-    const before = await ondoAddressBook(client);
-    if (before.some(a => sameAddress(a, p.wallet)))
-        return { address: p.wallet, alreadyListed: true, listed: true, challengeId: null };
-    let challenge;
-    try {
-        challenge = await client.post("/v1/auth/erc-4361/address_book/get_challenge", {
-            walletAddress: p.wallet, chainId: "1", withdrawalAddress: p.wallet,
-        });
-    }
-    catch (e) {
-        throw addressBookAuthError(e, "challenge");
-    }
-    if (typeof challenge.id !== "string" || typeof challenge.message !== "string" || challenge.message === "") {
-        throw venueError("address_book/get_challenge returned no id / message");
-    }
-    assertOndoAddressBookChallenge(challenge.message, p.wallet, p.wallet, p.restUrl);
-    const signature = await p.signMessage(challenge.message);
-    if (!sameAddress(verifyMessage(challenge.message, signature), p.wallet)) {
-        throw new PerpError("SIGNATURE_FAILED", `The address-book challenge signature does not recover to ${p.wallet} — nothing was submitted`, { exchange: "ondo" });
-    }
-    try {
-        await client.postNoResult("/v1/auth/erc-4361/address_book/complete_challenge", {
-            id: challenge.id, signature, ...(p.label !== null ? { addressLabel: p.label } : {}),
-        });
-    }
-    catch (e) {
-        throw addressBookAuthError(e, "completion");
-    }
-    const after = await ondoAddressBook(client);
-    return { address: p.wallet, alreadyListed: false, listed: after.some(a => sameAddress(a, p.wallet)), challengeId: challenge.id };
-}

package/dist/exchanges/pacifica.d.ts

@@ -375,7 +375,19 @@ export declare class PacificaAdapter implements ExchangeAdapter {
         price: string | null;
     }[]>;
     getKlines(symbol: string, interval: string, startTime: number, endTime: number): Promise<ExchangeKline[]>;
+    /**
+     * Recent orders, newest first (GET /orders/history; PacificaClient.get already unwraps the
+     * `{success, data}` envelope, so the list is the result itself). A non-list or a row without a
+     * readable field → EXCHANGE_ERROR, never an empty list or a placeholder value.
+     */
     getOrderHistory(limit?: number): Promise<ExchangeOrder[]>;
+    /**
+     * Recent fills, newest first (GET /trades/history; the client unwraps `{success, data}`).
+     * `side` is the position effect — open_long / close_short buy, open_short / close_long sell
+     * (live 2026-10-13: `"side":"close_short"` on a buy-to-close fill); bid / ask are accepted for
+     * rows that carry an order side. Anything else, a non-list or an unreadable field → EXCHANGE_ERROR.
+     */
     getTradeHistory(limit?: number): Promise<ExchangeTrade[]>;
+    /** Funding paid / received per position (GET /funding/history, `payout` signed). Strict like getTradeHistory. */
     getFundingPayments(limit?: number): Promise<ExchangeFundingPayment[]>;
 }