@proof-labs/trading-sdk 7.3.0 → 8.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +70 -24
  2. package/dist/account-recovery.d.ts +117 -0
  3. package/dist/account-recovery.d.ts.map +1 -0
  4. package/dist/account-recovery.js +330 -0
  5. package/dist/account-recovery.js.map +1 -0
  6. package/dist/client.d.ts +42 -54
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/client.js +138 -160
  9. package/dist/client.js.map +1 -1
  10. package/dist/codec-adapter.d.ts.map +1 -1
  11. package/dist/codec-adapter.js +13 -0
  12. package/dist/codec-adapter.js.map +1 -1
  13. package/dist/errors.d.ts +23 -1
  14. package/dist/errors.d.ts.map +1 -1
  15. package/dist/errors.js +73 -2
  16. package/dist/errors.js.map +1 -1
  17. package/dist/feed-types.d.ts +22 -0
  18. package/dist/feed-types.d.ts.map +1 -1
  19. package/dist/feed.d.ts +52 -0
  20. package/dist/feed.d.ts.map +1 -1
  21. package/dist/feed.js +342 -24
  22. package/dist/feed.js.map +1 -1
  23. package/dist/financial-state.d.ts.map +1 -1
  24. package/dist/financial-state.js +16 -4
  25. package/dist/financial-state.js.map +1 -1
  26. package/dist/governance-query.d.ts.map +1 -1
  27. package/dist/governance-query.js +69 -0
  28. package/dist/governance-query.js.map +1 -1
  29. package/dist/index.d.ts +6 -3
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +4 -2
  32. package/dist/index.js.map +1 -1
  33. package/dist/insurance-funding.d.ts +6 -0
  34. package/dist/insurance-funding.d.ts.map +1 -0
  35. package/dist/insurance-funding.js +54 -0
  36. package/dist/insurance-funding.js.map +1 -0
  37. package/dist/liquidation-config.d.ts +11 -0
  38. package/dist/liquidation-config.d.ts.map +1 -0
  39. package/dist/liquidation-config.js +54 -0
  40. package/dist/liquidation-config.js.map +1 -0
  41. package/dist/liquidation-events.d.ts +135 -0
  42. package/dist/liquidation-events.d.ts.map +1 -0
  43. package/dist/liquidation-events.js +273 -0
  44. package/dist/liquidation-events.js.map +1 -0
  45. package/dist/types.d.ts +88 -13
  46. package/dist/types.d.ts.map +1 -1
  47. package/dist/wasm/proof_trading_sdk_wasm_bg.wasm +0 -0
  48. package/package.json +1 -1
package/dist/client.d.ts CHANGED
@@ -1,8 +1,9 @@
1
1
  import { GatewayFeed, type GatewayFeedOptions, type AccountFeedAuth } from "./feed.js";
2
- import type { AccountFrame, OrderbookFrame, TradeFrame } from "./feed-types.js";
2
+ import type { AccountFrame, OrderbookFrame, OrderbookSnapshotFrame, TradeFrame } from "./feed-types.js";
3
3
  import { type PortfolioHistoryOptions, type PortfolioHistoryPage } from "./portfolio-history.js";
4
4
  import { type OraclePriceHistoryOptions, type OraclePriceHistoryPage } from "./oracle-price-history.js";
5
5
  import { GatewayReads, type GatewayFetch } from "./gateway-reads.js";
6
+ import { type AccountRecoveryStatus } from "./account-recovery.js";
6
7
  import { type AccountState } from "./account-state.js";
7
8
  import { type FinancialState, type FinancialStateSelection } from "./financial-state.js";
8
9
  import type { Action, TxResult, PlaceOrder, MarketOrder, AccountInfo, HistoryCashFlow, HistoryFillsPage, HistoryPositionSnapshot, HistoryPositionsPage, HistoryResolution, MarketConfig, OpenOrder, AdlQueueEntry, Orderbook, Ticker, WithdrawalRecord, AdminSignerRegistry, AuthoritiesSnapshot, ProposalPage, EventInfo, SetPositionTriggers, PositionTriggerInfo, TriggerStatus, PositionTriggerHistoryFilters, PositionTriggerHistoryPage, TriggerMarketHistoryFilters, TriggerMarketHistoryPage, TriggerMarketConfigInfo, NodeVersion, UpgradesInfo, AuthorizeWithdrawal, ConfirmWithdrawalReceipt, FailWithdrawalReceipt } from "./types.js";
@@ -45,8 +46,7 @@ export interface ExchangeClientOptions {
45
46
  */
46
47
  apiUrl?: string;
47
48
  /**
48
- * WebSocket base URL for the gateway streams (`/account-events`,
49
- * `/orderbook-deltas`). Defaults to `gatewayUrl` (or `rpcUrl` on the
49
+ * WebSocket base URL for the gateway's multiplexed `/ws` feed. Defaults to `gatewayUrl` (or `rpcUrl` on the
50
50
  * direct-node path) with the scheme swapped to `ws`/`wss`. The gateway
51
51
  * serves its feed on a dedicated listener; for a local stack whose WS
52
52
  * port differs from the HTTP port, set this explicitly
@@ -162,13 +162,17 @@ export declare class ExchangeClient {
162
162
  private externalSigner;
163
163
  private signerRevision;
164
164
  private gatewayFeed;
165
+ /** Dedicated feeds behind pending `orderbookSnapshot` calls, so
166
+ * `disconnect()` closes them too. */
167
+ private readonly snapshotFeeds;
168
+ /** Reconnect recoveries of live `subscribeAccount` calls, closed with the feed. */
169
+ private readonly accountRecoveries;
165
170
  private publicKey;
166
171
  private address;
167
172
  private addressHex;
168
173
  private lastTimestampNonce;
169
174
  /** Unsubscribe handles for every open WebSocket stream, so `disconnect()`
170
175
  * can tear them all down at once. */
171
- private activeStreams;
172
176
  /**
173
177
  * In-flight DeliverTx verification promises spawned by submitTx. Awaiting
174
178
  * this set lets callers serialize against block inclusion when they need to;
@@ -251,7 +255,8 @@ export declare class ExchangeClient {
251
255
  signTx(action: Action, opts?: {
252
256
  signal?: AbortSignal;
253
257
  }): Promise<Uint8Array>;
254
- /** Sign existing gateway account-events auth bytes; call again per reconnect.
258
+ /** Sign the gateway's account-stream auth bytes for an `accountEvents`
259
+ * subscription on `/ws`; call again per reconnect.
255
260
  * Direct owner keys only; no delegated-owner authorization is inferred.
256
261
  */
257
262
  accountAuth(owner?: string, afterId?: bigint): Promise<AccountFeedAuth>;
@@ -749,66 +754,49 @@ export declare class ExchangeClient {
749
754
  getBlock(height?: number): Promise<Record<string, unknown>>;
750
755
  getBlockResults(height: number): Promise<Record<string, unknown>>;
751
756
  /**
752
- * Subscribe to the account-events stream (`/account-events`). Mirrors the
753
- * Python SDK's `AccountEventStream`: the gateway sends an initial snapshot
754
- * frame followed by incremental event frames. The SDK tracks the highest
755
- * `event_id` seen and replays from it via `after_id` on reconnect, so no
756
- * events are dropped across a disconnect.
757
- *
758
- * Auth: account streams require auth only when the gateway runs with
759
- * `--api-key`. A browser `WebSocket` cannot send the `X-Api-Key` header, so
760
- * the SDK uses the gateway's signed-query auth instead — when a private key or external signer
761
- * is connected it signs the `ProofExchange-account-events-v1`
762
- * message and appends `public_key` / `signature` / `timestamp_ms`. Against
763
- * an unauthenticated gateway (e.g. devnet) the owner alone is enough.
764
- *
765
- * Returns an unsubscribe function; `disconnect()` closes all streams.
766
- */
767
- subscribeAccountEvents(owner: Uint8Array | string, onEvent: (event: Record<string, unknown>) => void, opts?: WsStreamOptions & {
768
- auth?: false;
769
- }): () => void;
770
- /**
771
- * Subscribe to the L2 orderbook delta stream for a market
772
- * (`/orderbook-deltas`). Mirrors the Python SDK's `OrderbookDeltaStream`:
773
- * the first frame is a full `l2Book` snapshot, then incremental deltas.
774
- * Returns an unsubscribe function.
775
- */
776
- subscribeOrderbookDeltas(market: number, onMessage: (msg: Record<string, unknown>) => void, opts?: WsStreamOptions): () => void;
777
- /**
778
- * One-shot L2 orderbook snapshot via a temporary delta-stream connection:
779
- * opens the stream, resolves the first `l2Book` snapshot frame, and closes.
780
- * Mirrors the Python SDK's `orderbook_snapshot`.
781
- */
782
- orderbookSnapshot(market: number): Promise<Record<string, unknown>>;
783
- /**
784
- * Internal: open one self-reconnecting WebSocket. `buildUrl` is re-invoked
785
- * on every (re)connect so per-connect state (fresh auth timestamp, current
786
- * `after_id`) is rebuilt each time. Reconnects with exponential backoff and
787
- * jitter. Returns an unsubscribe that stops reconnecting and closes the
788
- * socket.
757
+ * One-shot orderbook snapshot from the gateway's `/ws` feed, read over a
758
+ * connection of its own: it never answers from a book an existing
759
+ * `subscribeOrderbook` built, so a stalled shared socket cannot serve stale
760
+ * prices. Resolves the first `snapshot` frame and closes the connection.
761
+ * Rejects with {@link FeedSubscriptionError} when the gateway refuses the
762
+ * subscription, or when no snapshot arrives within `timeoutMs`.
789
763
  */
790
- private openStream;
764
+ orderbookSnapshot(market: number, timeoutMs?: number): Promise<OrderbookSnapshotFrame>;
765
+ /** A new `/ws` connection with this client's URL, auth and headers. */
766
+ private createFeed;
791
767
  /** Shared multiplexed /ws feed. Options apply on first creation only.
792
768
  * Reconnect restores snapshots, not missed events. Default auth reads the current signer.
793
769
  */
794
770
  feed(opts?: Partial<GatewayFeedOptions>): GatewayFeed;
795
- /** Account snapshot plus live stream, with auth renewed per reconnect. */
771
+ /**
772
+ * Account snapshot plus live stream, with auth renewed per reconnect.
773
+ *
774
+ * By default a reconnect recovers the events missed while disconnected:
775
+ * the SDK reads `/v1/history/account-events` back to the last delivered
776
+ * event (or the previous snapshot's `height`), retrying while
777
+ * `/v1/history/status` shows history behind the new snapshot's `height`,
778
+ * delivers the newer rows in order (marked `backfilled`), buffers live
779
+ * frames meanwhile and drops those a backfilled row already delivered,
780
+ * then resumes live delivery. `onRecovery` reports each reconnect's
781
+ * outcome once: `unverified` when the snapshot has no `height`,
782
+ * `unsupported` when the gateway predates 7.9.0 and sends no history key.
783
+ * `recover: false` turns recovery off.
784
+ */
796
785
  subscribeAccount(onFrame: (frame: AccountFrame) => void, opts?: {
797
786
  owner?: string;
798
787
  auth?: false;
788
+ recover?: boolean;
789
+ onRecovery?: (status: AccountRecoveryStatus) => void;
799
790
  }): () => void;
791
+ /** One newest-first `/v1/history/account-events` page for recovery. */
792
+ private accountHistoryPage;
793
+ /** The newest height history has indexed in full
794
+ * (`/v1/history/status` → `ingest.newest_height`). */
795
+ private historyIndexedHeight;
800
796
  subscribeOrderbook(market: number, onFrame: (frame: OrderbookFrame) => void): () => void;
801
797
  subscribeTrades(market: number, onFrame: (frame: TradeFrame) => void): () => void;
802
- /** Close every open WebSocket stream and stop their reconnect loops. */
798
+ /** Close the shared `/ws` feed, any pending `orderbookSnapshot` feed, any
799
+ * account backfill in progress, and stop their reconnect loops. */
803
800
  disconnect(): void;
804
801
  }
805
- /** Options common to the WebSocket stream subscriptions. */
806
- export interface WsStreamOptions {
807
- /** Called on connect/parse errors. The stream keeps reconnecting; use
808
- * this for logging or to surface terminal failures. */
809
- onError?: (err: unknown) => void;
810
- /** Max reconnect backoff in milliseconds (default 30000). Backoff starts
811
- * at 500ms and doubles with ±25% jitter up to this cap. */
812
- reconnectBackoffMaxMs?: number;
813
- }
814
802
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/client.js CHANGED
@@ -2,7 +2,8 @@ import { GatewayFeed, } from "./feed.js";
2
2
  import { portfolioHistorySearchParams, decodePortfolioHistoryPage, } from "./portfolio-history.js";
3
3
  import { queryOraclePriceHistoryPage, } from "./oracle-price-history.js";
4
4
  import { GatewayReads } from "./gateway-reads.js";
5
- import { GatewayHttpError } from "./errors.js";
5
+ import { recoveringAccountHandler, } from "./account-recovery.js";
6
+ import { FeedSubscriptionError, GatewayHttpError } from "./errors.js";
6
7
  import { decodeCashFlowEvents, decodeHistoryPositionsPage, historyOwner, historySearchParams, } from "./history.js";
7
8
  import { toWasmFields } from "./codec-adapter.js";
8
9
  import { signAndEncode, encodePayloadBytes, encodeSignedTx, rejectFloats, } from "./codec.js";
@@ -70,13 +71,17 @@ export class ExchangeClient {
70
71
  externalSigner = null;
71
72
  signerRevision = 0;
72
73
  gatewayFeed = null;
74
+ /** Dedicated feeds behind pending `orderbookSnapshot` calls, so
75
+ * `disconnect()` closes them too. */
76
+ snapshotFeeds = new Set();
77
+ /** Reconnect recoveries of live `subscribeAccount` calls, closed with the feed. */
78
+ accountRecoveries = new Set();
73
79
  publicKey = null;
74
80
  address = null;
75
81
  addressHex = null;
76
82
  lastTimestampNonce = 0n;
77
83
  /** Unsubscribe handles for every open WebSocket stream, so `disconnect()`
78
84
  * can tear them all down at once. */
79
- activeStreams = new Set();
80
85
  /**
81
86
  * In-flight DeliverTx verification promises spawned by submitTx. Awaiting
82
87
  * this set lets callers serialize against block inclusion when they need to;
@@ -111,10 +116,10 @@ export class ExchangeClient {
111
116
  this.apiUrl = stripTrailingSlash(opts.apiUrl ?? deriveNodeUrl(this.gatewayUrl, "8080"));
112
117
  this.apiKey = opts.apiKey ?? null;
113
118
  this.httpTransport = opts.httpTransport ?? defaultExchangeHttpTransport;
114
- // WebSocket base URL (no path). Per-stream methods append the channel
115
- // path (`/account-events`, `/orderbook-deltas`). Mirrors the Python SDK,
116
- // which derives the WS base by swapping the gateway URL's scheme. Local
117
- // stacks whose WS listener is on a different port must pass `wsUrl`.
119
+ // WebSocket base URL (no path); the feed appends `/ws`. Mirrors the
120
+ // Python SDK, which derives the WS base by swapping the gateway URL's
121
+ // scheme. Local stacks whose WS listener is on a different port must pass
122
+ // `wsUrl`.
118
123
  this.wsUrl = stripTrailingSlash(opts.wsUrl ??
119
124
  (this.useGateway ? this.gatewayUrl : this.rpcUrl).replace(/^http/, "ws"));
120
125
  // Bind chainId eagerly when supplied, else leave null. On the direct
@@ -283,7 +288,8 @@ export class ExchangeClient {
283
288
  }
284
289
  return encodeSignedTx(snapshot, seq, signer.publicKey, signature);
285
290
  }
286
- /** Sign existing gateway account-events auth bytes; call again per reconnect.
291
+ /** Sign the gateway's account-stream auth bytes for an `accountEvents`
292
+ * subscription on `/ws`; call again per reconnect.
287
293
  * Direct owner keys only; no delegated-owner authorization is inferred.
288
294
  */
289
295
  async accountAuth(owner = this.addressHex ?? "", afterId = 0n) {
@@ -1664,175 +1670,142 @@ export class ExchangeClient {
1664
1670
  return json.result;
1665
1671
  }
1666
1672
  // -----------------------------------------------------------------------
1667
- // WebSocket streams (gateway-native; mirror the Python SDK)
1673
+ // WebSocket streams (the gateway's multiplexed /ws feed)
1668
1674
  // -----------------------------------------------------------------------
1669
1675
  /**
1670
- * Subscribe to the account-events stream (`/account-events`). Mirrors the
1671
- * Python SDK's `AccountEventStream`: the gateway sends an initial snapshot
1672
- * frame followed by incremental event frames. The SDK tracks the highest
1673
- * `event_id` seen and replays from it via `after_id` on reconnect, so no
1674
- * events are dropped across a disconnect.
1675
- *
1676
- * Auth: account streams require auth only when the gateway runs with
1677
- * `--api-key`. A browser `WebSocket` cannot send the `X-Api-Key` header, so
1678
- * the SDK uses the gateway's signed-query auth instead — when a private key or external signer
1679
- * is connected it signs the `ProofExchange-account-events-v1`
1680
- * message and appends `public_key` / `signature` / `timestamp_ms`. Against
1681
- * an unauthenticated gateway (e.g. devnet) the owner alone is enough.
1682
- *
1683
- * Returns an unsubscribe function; `disconnect()` closes all streams.
1684
- */
1685
- subscribeAccountEvents(owner, onEvent, opts = {}) {
1686
- const ownerHex = (owner instanceof Uint8Array ? bytesToHex(owner) : owner.replace(/^0x/, "")).toLowerCase();
1687
- // Tracked across reconnects for gap recovery. Signed into the auth
1688
- // message too, so the value we send and the value we sign always match.
1689
- let afterId = 0n;
1690
- const buildUrl = async () => {
1691
- const params = new URLSearchParams({ owner: ownerHex });
1692
- if (afterId > 0n)
1693
- params.set("after_id", afterId.toString());
1694
- if (opts.auth !== false && (this.privateKey || this.externalSigner)) {
1695
- const auth = await this.accountAuth(ownerHex, afterId);
1696
- for (const [key, value] of Object.entries(auth))
1697
- params.set(key, String(value));
1698
- }
1699
- return `${this.wsUrl}/account-events?${params.toString()}`;
1700
- };
1701
- return this.openStream(buildUrl, (frame) => {
1702
- const id = frame.event_id;
1703
- if (typeof id === "number" || typeof id === "bigint") {
1704
- const big = BigInt(id);
1705
- if (big > afterId)
1706
- afterId = big;
1707
- }
1708
- onEvent(frame);
1709
- }, opts);
1710
- }
1711
- /**
1712
- * Subscribe to the L2 orderbook delta stream for a market
1713
- * (`/orderbook-deltas`). Mirrors the Python SDK's `OrderbookDeltaStream`:
1714
- * the first frame is a full `l2Book` snapshot, then incremental deltas.
1715
- * Returns an unsubscribe function.
1716
- */
1717
- subscribeOrderbookDeltas(market, onMessage, opts = {}) {
1718
- return this.openStream(async () => `${this.wsUrl}/orderbook-deltas?market=${market}`, onMessage, opts);
1719
- }
1720
- /**
1721
- * One-shot L2 orderbook snapshot via a temporary delta-stream connection:
1722
- * opens the stream, resolves the first `l2Book` snapshot frame, and closes.
1723
- * Mirrors the Python SDK's `orderbook_snapshot`.
1676
+ * One-shot orderbook snapshot from the gateway's `/ws` feed, read over a
1677
+ * connection of its own: it never answers from a book an existing
1678
+ * `subscribeOrderbook` built, so a stalled shared socket cannot serve stale
1679
+ * prices. Resolves the first `snapshot` frame and closes the connection.
1680
+ * Rejects with {@link FeedSubscriptionError} when the gateway refuses the
1681
+ * subscription, or when no snapshot arrives within `timeoutMs`.
1724
1682
  */
1725
- orderbookSnapshot(market) {
1683
+ orderbookSnapshot(market, timeoutMs = 10_000) {
1684
+ const feed = this.createFeed({ pingIntervalMs: 0 });
1685
+ this.snapshotFeeds.add(feed);
1726
1686
  return new Promise((resolve, reject) => {
1727
- const unsub = this.subscribeOrderbookDeltas(market, (msg) => {
1728
- if (msg.type === "l2Book") {
1729
- unsub();
1730
- resolve(msg);
1687
+ let settled = false;
1688
+ const finish = () => {
1689
+ settled = true;
1690
+ clearTimeout(timer);
1691
+ this.snapshotFeeds.delete(feed);
1692
+ feed.close();
1693
+ };
1694
+ const timer = setTimeout(() => {
1695
+ finish();
1696
+ reject(new FeedSubscriptionError("orderbook", `orderbook snapshot for market ${market} timed out after ${timeoutMs}ms`));
1697
+ }, timeoutMs);
1698
+ feed.subscribeOrderbook(market, (frame) => {
1699
+ if (settled)
1700
+ return;
1701
+ const raw = frame;
1702
+ if (raw.type === "error") {
1703
+ finish();
1704
+ reject(new FeedSubscriptionError("orderbook", raw.error, raw.code));
1705
+ }
1706
+ else if (raw.type === "snapshot") {
1707
+ finish();
1708
+ resolve(raw);
1731
1709
  }
1732
- }, {
1733
- onError: (err) => {
1734
- unsub();
1735
- reject(err instanceof Error ? err : new Error(String(err)));
1736
- },
1737
1710
  });
1738
1711
  });
1739
1712
  }
1740
- /**
1741
- * Internal: open one self-reconnecting WebSocket. `buildUrl` is re-invoked
1742
- * on every (re)connect so per-connect state (fresh auth timestamp, current
1743
- * `after_id`) is rebuilt each time. Reconnects with exponential backoff and
1744
- * jitter. Returns an unsubscribe that stops reconnecting and closes the
1745
- * socket.
1746
- */
1747
- openStream(buildUrl, onMessage, opts) {
1748
- const backoffCapMs = opts.reconnectBackoffMaxMs ?? 30_000;
1749
- let closed = false;
1750
- let ws = null;
1751
- let timer = null;
1752
- let backoff = 500;
1753
- const scheduleReconnect = () => {
1754
- if (closed)
1755
- return;
1756
- const jitter = backoff * (0.75 + Math.random() * 0.5);
1757
- timer = setTimeout(() => void connect(), jitter);
1758
- backoff = Math.min(backoff * 2, backoffCapMs);
1759
- };
1760
- const connect = async () => {
1761
- if (closed)
1762
- return;
1763
- let url;
1764
- try {
1765
- url = await buildUrl();
1766
- }
1767
- catch (err) {
1768
- opts.onError?.(err);
1769
- scheduleReconnect();
1770
- return;
1771
- }
1772
- if (closed)
1773
- return;
1774
- ws = new WebSocket(url);
1775
- ws.onopen = () => {
1776
- backoff = 500;
1777
- };
1778
- ws.onmessage = (ev) => {
1779
- try {
1780
- onMessage(JSON.parse(ev.data));
1781
- }
1782
- catch (err) {
1783
- opts.onError?.(err);
1784
- }
1785
- };
1786
- ws.onerror = (err) => {
1787
- opts.onError?.(err);
1788
- };
1789
- ws.onclose = () => {
1790
- ws = null;
1791
- if (!closed)
1792
- scheduleReconnect();
1793
- };
1794
- };
1795
- const unsubscribe = () => {
1796
- closed = true;
1797
- if (timer) {
1798
- clearTimeout(timer);
1799
- timer = null;
1800
- }
1801
- if (ws) {
1802
- ws.close();
1803
- ws = null;
1804
- }
1805
- this.activeStreams.delete(unsubscribe);
1806
- };
1807
- this.activeStreams.add(unsubscribe);
1808
- void connect();
1809
- return unsubscribe;
1713
+ /** A new `/ws` connection with this client's URL, auth and headers. */
1714
+ createFeed(opts = {}) {
1715
+ let base = this.wsUrl;
1716
+ if (!base && typeof globalThis.location !== "undefined")
1717
+ base = globalThis.location.origin.replace(/^http/, "ws");
1718
+ return new GatewayFeed({
1719
+ url: `${base}/ws`,
1720
+ accountAuth: async (owner) => this.privateKey || this.externalSigner ? this.accountAuth(owner) : {},
1721
+ headers: this.apiKey ? { "X-Api-Key": this.apiKey } : undefined,
1722
+ ...opts,
1723
+ });
1810
1724
  }
1811
1725
  /** Shared multiplexed /ws feed. Options apply on first creation only.
1812
1726
  * Reconnect restores snapshots, not missed events. Default auth reads the current signer.
1813
1727
  */
1814
1728
  feed(opts = {}) {
1815
- if (!this.gatewayFeed) {
1816
- let base = this.wsUrl;
1817
- if (!base && typeof globalThis.location !== "undefined")
1818
- base = globalThis.location.origin.replace(/^http/, "ws");
1819
- this.gatewayFeed = new GatewayFeed({
1820
- url: `${base}/ws`,
1821
- accountAuth: async (owner) => this.privateKey || this.externalSigner ? this.accountAuth(owner) : {},
1822
- headers: this.apiKey ? { "X-Api-Key": this.apiKey } : undefined,
1823
- ...opts,
1824
- });
1825
- }
1729
+ if (!this.gatewayFeed)
1730
+ this.gatewayFeed = this.createFeed(opts);
1826
1731
  return this.gatewayFeed;
1827
1732
  }
1828
- /** Account snapshot plus live stream, with auth renewed per reconnect. */
1733
+ /**
1734
+ * Account snapshot plus live stream, with auth renewed per reconnect.
1735
+ *
1736
+ * By default a reconnect recovers the events missed while disconnected:
1737
+ * the SDK reads `/v1/history/account-events` back to the last delivered
1738
+ * event (or the previous snapshot's `height`), retrying while
1739
+ * `/v1/history/status` shows history behind the new snapshot's `height`,
1740
+ * delivers the newer rows in order (marked `backfilled`), buffers live
1741
+ * frames meanwhile and drops those a backfilled row already delivered,
1742
+ * then resumes live delivery. `onRecovery` reports each reconnect's
1743
+ * outcome once: `unverified` when the snapshot has no `height`,
1744
+ * `unsupported` when the gateway predates 7.9.0 and sends no history key.
1745
+ * `recover: false` turns recovery off.
1746
+ */
1829
1747
  subscribeAccount(onFrame, opts = {}) {
1830
- const owner = opts.owner ?? this.addressHex;
1748
+ const owner = (opts.owner ?? this.addressHex)
1749
+ ?.replace(/^0x/i, "")
1750
+ .toLowerCase();
1831
1751
  if (!owner)
1832
1752
  throw new Error("No account owner available");
1833
- return this.feed().subscribeAccount(owner, onFrame, async (address) => opts.auth !== false && (this.privateKey || this.externalSigner)
1753
+ const auth = async (address) => opts.auth !== false && (this.privateKey || this.externalSigner)
1834
1754
  ? this.accountAuth(address)
1835
- : {});
1755
+ : {};
1756
+ if (opts.recover === false)
1757
+ return this.feed().subscribeAccount(owner, onFrame, auth);
1758
+ const recovery = recoveringAccountHandler({
1759
+ owner,
1760
+ onFrame,
1761
+ onRecovery: opts.onRecovery,
1762
+ fetchPage: (cursor, signal) => this.accountHistoryPage(owner, cursor, signal),
1763
+ fetchIndexedHeight: (signal) => this.historyIndexedHeight(signal),
1764
+ });
1765
+ const unsubscribe = this.feed().subscribeAccount(owner, recovery.handle, auth);
1766
+ this.accountRecoveries.add(recovery.close);
1767
+ return () => {
1768
+ this.accountRecoveries.delete(recovery.close);
1769
+ recovery.close();
1770
+ unsubscribe();
1771
+ };
1772
+ }
1773
+ /** One newest-first `/v1/history/account-events` page for recovery. */
1774
+ async accountHistoryPage(owner, cursor, signal) {
1775
+ const res = await this.reads().accountEvents({
1776
+ owner,
1777
+ order: "desc",
1778
+ limit: 500,
1779
+ ...(cursor ? { cursor } : {}),
1780
+ }, { signal });
1781
+ // Status before parse: a gateway error body need not be JSON, and a
1782
+ // SyntaxError from `res.json()` would bury the intended message.
1783
+ if (!res.ok) {
1784
+ let error;
1785
+ try {
1786
+ error = (await res.json()).error;
1787
+ }
1788
+ catch {
1789
+ error = undefined;
1790
+ }
1791
+ throw new Error(`account history read failed: ${error ?? `HTTP ${res.status}`}`);
1792
+ }
1793
+ const body = (await res.json());
1794
+ if (!Array.isArray(body.account_events))
1795
+ throw new Error(`account history read failed: ${body.error ?? `HTTP ${res.status}`}`);
1796
+ return { rows: body.account_events, nextCursor: body.next_cursor ?? null };
1797
+ }
1798
+ /** The newest height history has indexed in full
1799
+ * (`/v1/history/status` → `ingest.newest_height`). */
1800
+ async historyIndexedHeight(signal) {
1801
+ const res = await this.reads().historyStatus({ signal });
1802
+ if (!res.ok)
1803
+ throw new Error(`history status read failed: HTTP ${res.status}`);
1804
+ const body = (await res.json());
1805
+ const height = body.ingest?.newest_height;
1806
+ if (typeof height !== "number")
1807
+ throw new Error(`history status read failed: HTTP ${res.status}`);
1808
+ return height;
1836
1809
  }
1837
1810
  subscribeOrderbook(market, onFrame) {
1838
1811
  return this.feed().subscribeOrderbook(market, onFrame);
@@ -1840,11 +1813,16 @@ export class ExchangeClient {
1840
1813
  subscribeTrades(market, onFrame) {
1841
1814
  return this.feed().subscribeTrades(market, onFrame);
1842
1815
  }
1843
- /** Close every open WebSocket stream and stop their reconnect loops. */
1816
+ /** Close the shared `/ws` feed, any pending `orderbookSnapshot` feed, any
1817
+ * account backfill in progress, and stop their reconnect loops. */
1844
1818
  disconnect() {
1819
+ for (const close of this.accountRecoveries)
1820
+ close();
1821
+ this.accountRecoveries.clear();
1822
+ for (const feed of this.snapshotFeeds)
1823
+ feed.close();
1824
+ this.snapshotFeeds.clear();
1845
1825
  this.gatewayFeed?.close();
1846
- for (const unsub of [...this.activeStreams])
1847
- unsub();
1848
1826
  }
1849
1827
  }
1850
1828
  // ---------------------------------------------------------------------------