@proof-labs/trading-sdk 7.2.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 (65) 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/bridge.d.ts +5 -8
  7. package/dist/bridge.d.ts.map +1 -1
  8. package/dist/bridge.js +5 -8
  9. package/dist/bridge.js.map +1 -1
  10. package/dist/client.d.ts +59 -55
  11. package/dist/client.d.ts.map +1 -1
  12. package/dist/client.js +252 -223
  13. package/dist/client.js.map +1 -1
  14. package/dist/codec-adapter.d.ts.map +1 -1
  15. package/dist/codec-adapter.js +13 -0
  16. package/dist/codec-adapter.js.map +1 -1
  17. package/dist/errors.d.ts +24 -0
  18. package/dist/errors.d.ts.map +1 -1
  19. package/dist/errors.js +77 -0
  20. package/dist/errors.js.map +1 -1
  21. package/dist/feed-types.d.ts +22 -0
  22. package/dist/feed-types.d.ts.map +1 -1
  23. package/dist/feed.d.ts +52 -0
  24. package/dist/feed.d.ts.map +1 -1
  25. package/dist/feed.js +342 -24
  26. package/dist/feed.js.map +1 -1
  27. package/dist/financial-state.d.ts +2 -1
  28. package/dist/financial-state.d.ts.map +1 -1
  29. package/dist/financial-state.js +19 -9
  30. package/dist/financial-state.js.map +1 -1
  31. package/dist/governance-query.d.ts.map +1 -1
  32. package/dist/governance-query.js +69 -0
  33. package/dist/governance-query.js.map +1 -1
  34. package/dist/http-transport.d.ts +56 -0
  35. package/dist/http-transport.d.ts.map +1 -0
  36. package/dist/http-transport.js +78 -0
  37. package/dist/http-transport.js.map +1 -0
  38. package/dist/index.d.ts +7 -3
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +5 -2
  41. package/dist/index.js.map +1 -1
  42. package/dist/insurance-funding.d.ts +6 -0
  43. package/dist/insurance-funding.d.ts.map +1 -0
  44. package/dist/insurance-funding.js +54 -0
  45. package/dist/insurance-funding.js.map +1 -0
  46. package/dist/liquidation-config.d.ts +11 -0
  47. package/dist/liquidation-config.d.ts.map +1 -0
  48. package/dist/liquidation-config.js +54 -0
  49. package/dist/liquidation-config.js.map +1 -0
  50. package/dist/liquidation-events.d.ts +135 -0
  51. package/dist/liquidation-events.d.ts.map +1 -0
  52. package/dist/liquidation-events.js +273 -0
  53. package/dist/liquidation-events.js.map +1 -0
  54. package/dist/market-snapshot.d.ts +2 -1
  55. package/dist/market-snapshot.d.ts.map +1 -1
  56. package/dist/market-snapshot.js +4 -2
  57. package/dist/market-snapshot.js.map +1 -1
  58. package/dist/types.d.ts +88 -13
  59. package/dist/types.d.ts.map +1 -1
  60. package/dist/wasm/proof_trading_sdk_wasm.d.ts +1 -1
  61. package/dist/wasm/proof_trading_sdk_wasm.js +1 -1
  62. package/dist/wasm/proof_trading_sdk_wasm_bg.wasm +0 -0
  63. package/dist/wasm-loader.d.ts +3 -3
  64. package/dist/wasm-loader.d.ts.map +1 -1
  65. package/package.json +1 -1
package/README.md CHANGED
@@ -210,10 +210,11 @@ class ExchangeClient {
210
210
  getBlock(height?: number): Promise<Record<string, unknown>>;
211
211
  getBlockResults(height: number): Promise<Record<string, unknown>>;
212
212
 
213
- // Streams (gateway-native; mirror the Python SDK)
214
- subscribeAccountEvents(owner: Uint8Array | string, onEvent: (e: Record<string, unknown>) => void, opts?: WsStreamOptions): () => void;
215
- subscribeOrderbookDeltas(market: number, onMessage: (m: Record<string, unknown>) => void, opts?: WsStreamOptions): () => void;
216
- orderbookSnapshot(market: number): Promise<Record<string, unknown>>;
213
+ // Streams (gateway-native)
214
+ subscribeAccount(onFrame: (f: AccountFrame) => void, opts?: { owner?: string; auth?: false; recover?: boolean; onRecovery?: (s: AccountRecoveryStatus) => void }): () => void;
215
+ subscribeOrderbook(market: number, onFrame: (f: OrderbookFrame) => void): () => void;
216
+ subscribeTrades(market: number, onFrame: (f: TradeFrame) => void): () => void;
217
+ orderbookSnapshot(market: number, timeoutMs?: number): Promise<OrderbookSnapshotFrame>;
217
218
  disconnect(): void;
218
219
  }
219
220
  ```
@@ -434,7 +435,7 @@ string—pass those strings and the cursor through unchanged.
434
435
  The `Action` type is a discriminated union. Every action is:
435
436
 
436
437
  ```typescript
437
- type Action = TraderAction | OperatorAction;
438
+ type Action = TraderAction | OperatorAction | GovernanceAction;
438
439
 
439
440
  type TraderAction =
440
441
  | { type: "PlaceOrder"; data: PlaceOrder }
@@ -460,6 +461,23 @@ operator-provisioned key. See [AGENTS.md](AGENTS.md) → "Operator actions" for
460
461
  usage (e.g. driving the BE-31 multi-source mark via `OracleUpdateComposite` +
461
462
  `UpdateMarketFees` `markSourceMode`).
462
463
 
464
+ #### Governance actions (admin multisig)
465
+
466
+ `GovernanceAction` covers the signer-registry multisig:
467
+
468
+ ```typescript
469
+ type GovernanceAction =
470
+ | { type: "ProposeAdminAction"; data: ProposeAdminAction }
471
+ | { type: "ApproveAdminAction"; data: ApproveAdminAction }
472
+ | { type: "RejectAdminAction"; data: RejectAdminAction }
473
+ | { type: "EmergencyAdminAction"; data: EmergencyAdminAction };
474
+ ```
475
+
476
+ `ProposeAdminAction` and `ApproveAdminAction` carry one `AdminAction` (create a
477
+ market, attach a conditional, schedule an upgrade, and the rest);
478
+ `EmergencyAdminAction` carries one single-signer `EmergencyAction`. Each is
479
+ refused unless the signer is in the current admin signer registry.
480
+
463
481
  ### Options
464
482
 
465
483
  ```typescript
@@ -530,28 +548,33 @@ code should read the structured `code` field: it is authoritative and needs no p
530
548
 
531
549
  ## WebSocket streams
532
550
 
533
- The SDK exposes the gateway's native multiplexed feed — the same two streams
534
- as the Python SDK. Each subscription opens its own connection, auto-reconnects
535
- with exponential backoff (500ms → 30s, ±25% jitter), and returns an
536
- unsubscribe function. `disconnect()` tears down every open stream.
551
+ The SDK exposes the gateway's native multiplexed feed on `/ws`. Account
552
+ events, trades and the orderbook are channels on that one shared connection
553
+ (`subscribeAccount`, `subscribeTrades`, `subscribeOrderbook`). The connection
554
+ auto-reconnects and re-subscribes; every subscription returns an unsubscribe
555
+ function, and `disconnect()` closes the feed.
537
556
 
538
557
  The WS base URL defaults to `gatewayUrl` with its scheme swapped to `ws`/`wss`.
539
558
  If your local stack serves WebSockets on a separate port, set `wsUrl`
540
559
  explicitly (e.g. `ws://localhost:9091`).
541
560
 
542
561
  ```typescript
543
- // Account events: snapshot frame, then incremental events. The SDK tracks
544
- // the highest event_id and replays via after_id on reconnect (no gaps).
545
- const unsub = client.subscribeAccountEvents(address, (event) => {
546
- console.log(event.event_type, event);
562
+ // Account events: a snapshot frame, then live event frames
563
+ // (`order_update`, `fill`, `position_update`, liquidation events, ...).
564
+ // Defaults to the connected signer's address; pass `owner` to watch another.
565
+ const unsub = client.subscribeAccount((frame) => {
566
+ if (frame.type === "snapshot") return;
567
+ console.log(frame.type, frame.eventType, frame.payload);
547
568
  });
548
569
 
549
- // L2 orderbook: first frame is a full `l2Book` snapshot, then deltas.
550
- const unsubBook = client.subscribeOrderbookDeltas(1, (msg) => {
551
- console.log(msg);
570
+ // Orderbook: a `snapshot` frame (`bids` / `asks` levels), then one `update`
571
+ // frame per changed level (a zero `totalQuantity` empties the level).
572
+ const unsubBook = client.subscribeOrderbook(1, (frame) => {
573
+ console.log(frame);
552
574
  });
553
575
 
554
- // One-shot snapshot (opens, reads the first l2Book frame, closes):
576
+ // One-shot snapshot over a connection of its own (never a cached book);
577
+ // rejects with FeedSubscriptionError when the gateway refuses the market:
555
578
  const book = await client.orderbookSnapshot(1);
556
579
 
557
580
  // later:
@@ -560,14 +583,37 @@ unsubBook();
560
583
  client.disconnect(); // closes everything
561
584
  ```
562
585
 
563
- `WsStreamOptions` (third arg) takes `onError?: (err) => void` and
564
- `reconnectBackoffMaxMs?: number`.
565
-
566
- **Auth.** Account streams require auth only when the gateway runs with
586
+ **Reconnect recovery.** A reconnect restores the account snapshot and, by
587
+ default, the account events missed while disconnected: the SDK reads
588
+ `/v1/history/account-events` back to the last event it delivered (or to the
589
+ previous snapshot's `height` when none was delivered), delivers the newer rows
590
+ in history order (marked `backfilled: true`), then the live frames that
591
+ arrived meanwhile, skipping any that history already delivered. It retries
592
+ while `/v1/history/status` shows history has not indexed up to the new
593
+ snapshot's `height`. Events are matched on `height` + `txHash` +
594
+ `eventIndex` + `eventType` + `txIndex`, a missing position matching any,
595
+ since history serves `tx_position` only when one block carries the same
596
+ transaction hash more than once. The settlement names
597
+ `conditional_settled` /
598
+ `conditional_voided` read as their canonical history names `condition_met` /
599
+ `condition_not_met`. A snapshot marked `snapshot: "resent"` (sent because
600
+ another listener joined) is not a reconnect. `onRecovery` reports each
601
+ reconnect's outcome once: `backfilled`, `unverified` (the snapshot carries no
602
+ `height`, so history's coverage cannot be checked), `unsupported` (a gateway
603
+ older than 7.9.0 sends no `txHash` / `eventIndex`; live delivery carries on),
604
+ `boundaryNotFound`, `historyBehind` or `failed`. Pass `recover: false` to turn
605
+ it off. Python's `AccountEventStream` does the same (`recover`,
606
+ `on_recovery`, `RecoveryStatus`); build it with
607
+ `client.account_event_stream(owner)` so its history reads use the gateway URL
608
+ even when `/ws` is on its own port.
609
+
610
+ **Auth.** Account subscriptions require auth only when the gateway runs with
567
611
  `--api-key`. Because a browser `WebSocket` cannot send the `X-Api-Key` header,
568
- the SDK uses the gateway's signed-query auth: with a private key loaded
569
- (`setPrivateKey`) it signs the stream-auth message and appends `public_key` /
570
- `signature` / `timestamp_ms` to the URL automatically. Against an
612
+ the SDK uses the gateway's signed subscription auth: with a private key or
613
+ external signer connected it signs the stream-auth message and adds
614
+ `public_key` / `signature` / `timestamp_ms` to the `accountEvents` subscribe
615
+ message automatically, re-signing on every reconnect. Pass `auth: false` for an
616
+ unsigned watch-only subscription. Against an
571
617
  unauthenticated gateway (e.g. devnet) the owner alone suffices.
572
618
 
573
619
  ## Wire Format
@@ -0,0 +1,117 @@
1
+ import type { AccountEventFrame, AccountFrame } from "./feed-types.js";
2
+ /**
3
+ * The position of one account event, shared by live `/ws` frames (gateway
4
+ * 7.9.0 and later) and `/v1/history/account-events` rows. A transaction hash
5
+ * can recur at different heights, and twice in one block, so all the fields
6
+ * together identify an event. A `txIndex` of `null` is a wildcard: history
7
+ * rows omit `tx_position` for normal blocks, where live frames still carry
8
+ * the real index.
9
+ */
10
+ export interface AccountEventKey {
11
+ height: number;
12
+ txHash: string;
13
+ eventIndex: number;
14
+ eventType: string;
15
+ txIndex: number | null;
16
+ }
17
+ /**
18
+ * What reconnect recovery did, reported once per reconnect.
19
+ *
20
+ * - `backfilled`: every history row after the last delivered event (or, when
21
+ * none was delivered, after the previous snapshot's height) was delivered,
22
+ * in history order, before live delivery resumed, and history had indexed
23
+ * up to the reconnect snapshot's height, so nothing in between is missing.
24
+ * - `unverified`: rows were backfilled as for `backfilled`, but the snapshot
25
+ * carries no `height` (an older gateway or node), so whether history had
26
+ * caught up cannot be checked. Events may be missing. When nothing was
27
+ * delivered before the outage and the previous snapshot had no height
28
+ * either, there is no boundary and nothing is backfilled.
29
+ * - `unsupported`: the live frames carry no history key (`txHash` /
30
+ * `eventIndex`), which means a gateway older than 7.9.0. Nothing was
31
+ * backfilled; events during the outage are not recovered.
32
+ * - `boundaryNotFound`: the last delivered event is not in the history
33
+ * window that was read. Only rows at a later height were delivered; events
34
+ * at the same height as the last delivered one may be missing.
35
+ * - `historyBehind`: history had not indexed up to the snapshot's height,
36
+ * even after waiting `maxAttempts` status reads. Events between the newest
37
+ * history row and the snapshot may be missing.
38
+ * - `failed`: a history read failed, or the gap held more rows than
39
+ * `maxPages` pages, so the boundary was never reached. Nothing was
40
+ * backfilled.
41
+ */
42
+ export type AccountRecoveryStatus = {
43
+ kind: "backfilled";
44
+ delivered: number;
45
+ } | {
46
+ kind: "unverified";
47
+ delivered: number;
48
+ } | {
49
+ kind: "unsupported";
50
+ } | {
51
+ kind: "boundaryNotFound";
52
+ delivered: number;
53
+ } | {
54
+ kind: "historyBehind";
55
+ delivered: number;
56
+ } | {
57
+ kind: "failed";
58
+ error: Error;
59
+ };
60
+ /** One `/v1/history/account-events` row, as the gateway returns it. */
61
+ export interface AccountHistoryRow {
62
+ event_id: number | string;
63
+ owner: string;
64
+ block_height: number;
65
+ tx_hash: string;
66
+ event_index: number;
67
+ event_type: string;
68
+ /** The transaction's position in its block. History serves it only when
69
+ * one block carries the same transaction hash more than once; it is
70
+ * absent otherwise. */
71
+ tx_position?: number;
72
+ payload: Record<string, unknown>;
73
+ }
74
+ /** One newest-first history page (`order=desc`). */
75
+ export interface AccountHistoryPage {
76
+ rows: AccountHistoryRow[];
77
+ nextCursor: string | null;
78
+ }
79
+ export interface AccountRecoveryOptions {
80
+ owner: string;
81
+ onFrame: (frame: AccountFrame) => void;
82
+ onRecovery?: (status: AccountRecoveryStatus) => void;
83
+ /** Read one newest-first page; `cursor` is the previous page's. */
84
+ fetchPage: (cursor: string | null, signal: AbortSignal) => Promise<AccountHistoryPage>;
85
+ /** The newest height history has fully indexed
86
+ * (`/v1/history/status` → `ingest.newest_height`). */
87
+ fetchIndexedHeight: (signal: AbortSignal) => Promise<number>;
88
+ /** Newest-first pages read before giving up on the boundary. */
89
+ maxPages?: number;
90
+ /** Status reads per reconnect, `retryDelayMs` apart, while history lags
91
+ * the snapshot; the default 30 waits out about 30 seconds of indexer lag. */
92
+ maxAttempts?: number;
93
+ retryDelayMs?: number;
94
+ }
95
+ /** The history key of a live frame, or null when the gateway sent none. */
96
+ export declare function liveKey(frame: AccountEventFrame): AccountEventKey | null;
97
+ /**
98
+ * Wrap an account listener so a reconnect backfills the events missed while
99
+ * disconnected.
100
+ *
101
+ * A snapshot after the first, other than one marked `snapshot: "resent"`
102
+ * (sent because another listener joined), marks a re-subscription. The
103
+ * snapshot is passed through at once: it is current state, not part of the
104
+ * event log. Until the backfill finishes, live events are buffered. The
105
+ * backfill waits while history has not indexed up to the new snapshot's
106
+ * height, reads history newest-first down to the last delivered event (or
107
+ * the previous snapshot's height when none was delivered), delivers the
108
+ * newer rows in history order, then flushes the buffer, dropping any live
109
+ * frame history already delivered. If the socket reconnects again during a
110
+ * backfill, only the frames before that snapshot are flushed; the next
111
+ * backfill starts from the last of them and the later frames stay buffered.
112
+ */
113
+ export declare function recoveringAccountHandler(opts: AccountRecoveryOptions): {
114
+ handle: (frame: AccountFrame) => void;
115
+ close: () => void;
116
+ };
117
+ //# sourceMappingURL=account-recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"account-recovery.d.ts","sourceRoot":"","sources":["../src/account-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EAEb,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAErC,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;4BAEwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,mEAAmE;IACnE,SAAS,EAAE,CACT,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC;2DACuD;IACvD,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;kFAC8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4CD,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI,CAcxE;AA4DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG;IACtE,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAmMA"}
@@ -0,0 +1,330 @@
1
+ /** Whether two keys denote the same event: the four identifying fields are
2
+ * equal and the positions agree, where `null` agrees with anything. */
3
+ function sameEvent(a, b) {
4
+ return (a.height === b.height &&
5
+ a.txHash === b.txHash &&
6
+ a.eventIndex === b.eventIndex &&
7
+ a.eventType === b.eventType &&
8
+ (a.txIndex === null || b.txIndex === null || a.txIndex === b.txIndex));
9
+ }
10
+ /** Bucket `key` into the map keyed by its four identifying fields, so
11
+ * `sameEvent` only has to be tried against keys they already match. */
12
+ function addEvent(keys, key) {
13
+ const id = keyId(key);
14
+ const bucket = keys.get(id);
15
+ if (bucket)
16
+ bucket.push(key);
17
+ else
18
+ keys.set(id, [key]);
19
+ }
20
+ /** Whether `keys` holds an event `sameEvent` to `key`. */
21
+ function hasEvent(keys, key) {
22
+ return keys.get(keyId(key))?.some((k) => sameEvent(k, key)) ?? false;
23
+ }
24
+ /** Live event family for a history row; mirrors api-gateway
25
+ * `account_ws_message_type`. */
26
+ function familyOf(eventType) {
27
+ switch (eventType) {
28
+ case "trade_executed":
29
+ return "fill";
30
+ case "order_placed":
31
+ case "order_cancelled":
32
+ case "order_amended":
33
+ case "market_order_processed":
34
+ return "order_update";
35
+ case "position_updated":
36
+ case "position_closed":
37
+ return "position_update";
38
+ case "funding_settled":
39
+ return "funding";
40
+ case "position_triggers_set":
41
+ case "position_triggers_cancelled":
42
+ case "position_triggers_invalidated":
43
+ case "position_trigger_activated":
44
+ case "position_trigger_executed":
45
+ case "position_trigger_deferred":
46
+ return "trigger_update";
47
+ case "margin_warning":
48
+ return "margin_update";
49
+ default:
50
+ return "account_event";
51
+ }
52
+ }
53
+ /** Settlement event names before the canonical vocabulary, mapped to the
54
+ * names history rows carry. A gateway that already sends the canonical
55
+ * names passes through unchanged. */
56
+ const LEGACY_EVENT_TYPES = {
57
+ conditional_settled: "condition_met",
58
+ conditional_voided: "condition_not_met",
59
+ };
60
+ function canonicalEventType(eventType) {
61
+ return LEGACY_EVENT_TYPES[eventType] ?? eventType;
62
+ }
63
+ /** The history key of a live frame, or null when the gateway sent none. */
64
+ export function liveKey(frame) {
65
+ if (typeof frame.txHash !== "string" ||
66
+ typeof frame.eventIndex !== "number" ||
67
+ typeof frame.height !== "number")
68
+ return null;
69
+ return {
70
+ height: frame.height,
71
+ txHash: frame.txHash,
72
+ eventIndex: frame.eventIndex,
73
+ eventType: canonicalEventType(frame.eventType),
74
+ txIndex: typeof frame.txIndex === "number" ? frame.txIndex : null,
75
+ };
76
+ }
77
+ function rowKey(row) {
78
+ return {
79
+ height: Number(row.block_height),
80
+ txHash: row.tx_hash,
81
+ eventIndex: Number(row.event_index),
82
+ eventType: canonicalEventType(row.event_type),
83
+ txIndex: typeof row.tx_position === "number" ? row.tx_position : null,
84
+ };
85
+ }
86
+ function keyId(k) {
87
+ return `${k.height}|${k.txHash}|${k.eventIndex}|${k.eventType}`;
88
+ }
89
+ function rowFrame(row) {
90
+ return {
91
+ channel: "accountEvents",
92
+ type: familyOf(row.event_type),
93
+ owner: row.owner,
94
+ eventType: row.event_type,
95
+ height: Number(row.block_height),
96
+ txHash: row.tx_hash,
97
+ txIndex: typeof row.tx_position === "number" ? row.tx_position : null,
98
+ eventIndex: Number(row.event_index),
99
+ payload: row.payload,
100
+ backfilled: true,
101
+ };
102
+ }
103
+ /** A pause that ends early, rejecting, when `signal` aborts. */
104
+ function abortableSleep(ms, signal) {
105
+ return new Promise((resolve, reject) => {
106
+ if (signal.aborted)
107
+ return reject(new Error("closed"));
108
+ const timer = setTimeout(() => {
109
+ signal.removeEventListener("abort", onAbort);
110
+ resolve();
111
+ }, ms);
112
+ const onAbort = () => {
113
+ clearTimeout(timer);
114
+ reject(new Error("closed"));
115
+ };
116
+ signal.addEventListener("abort", onAbort, { once: true });
117
+ });
118
+ }
119
+ const heightOf = (frame) => typeof frame.height === "number" ? frame.height : undefined;
120
+ /**
121
+ * Wrap an account listener so a reconnect backfills the events missed while
122
+ * disconnected.
123
+ *
124
+ * A snapshot after the first, other than one marked `snapshot: "resent"`
125
+ * (sent because another listener joined), marks a re-subscription. The
126
+ * snapshot is passed through at once: it is current state, not part of the
127
+ * event log. Until the backfill finishes, live events are buffered. The
128
+ * backfill waits while history has not indexed up to the new snapshot's
129
+ * height, reads history newest-first down to the last delivered event (or
130
+ * the previous snapshot's height when none was delivered), delivers the
131
+ * newer rows in history order, then flushes the buffer, dropping any live
132
+ * frame history already delivered. If the socket reconnects again during a
133
+ * backfill, only the frames before that snapshot are flushed; the next
134
+ * backfill starts from the last of them and the later frames stay buffered.
135
+ */
136
+ export function recoveringAccountHandler(opts) {
137
+ const maxPages = opts.maxPages ?? 10;
138
+ const maxAttempts = opts.maxAttempts ?? 30;
139
+ const retryDelayMs = opts.retryDelayMs ?? 1000;
140
+ const abort = new AbortController();
141
+ // `undefined`: nothing delivered yet. `null`: the last delivered frame had
142
+ // no history key, so there is no event boundary to recover from.
143
+ let last;
144
+ // Height of the latest snapshot that recovery has caught up to.
145
+ let snapshotHeight;
146
+ let seenSnapshot = false;
147
+ let recovering = false;
148
+ let closed = false;
149
+ let buffer = [];
150
+ // Events a backfill delivered, kept until a live frame passes the newest
151
+ // of their heights: a slow socket can still deliver one the indexer
152
+ // already served.
153
+ let recent = null;
154
+ const deliver = (frame, key) => {
155
+ if (closed)
156
+ return;
157
+ last = key;
158
+ opts.onFrame(frame);
159
+ };
160
+ /** Deliver a live frame unless a backfill already delivered it. */
161
+ const deliverLive = (frame) => {
162
+ const key = liveKey(frame);
163
+ if (key && recent) {
164
+ if (hasEvent(recent.keys, key) || key.height < recent.floor)
165
+ return;
166
+ if (key.height > recent.height)
167
+ recent = null;
168
+ }
169
+ deliver(frame, key);
170
+ };
171
+ const scan = async (boundary) => {
172
+ const newerFirst = [];
173
+ // A height boundary is exact: the snapshot holds everything up to it.
174
+ let found = boundary.key === null;
175
+ let reached = false;
176
+ let cursor = null;
177
+ for (let page = 0; page < maxPages && !reached; page++) {
178
+ const { rows, nextCursor } = await opts.fetchPage(cursor, abort.signal);
179
+ for (const row of rows) {
180
+ const key = rowKey(row);
181
+ if (boundary.key && sameEvent(key, boundary.key)) {
182
+ found = reached = true;
183
+ break;
184
+ }
185
+ if (boundary.key
186
+ ? key.height < boundary.height
187
+ : key.height <= boundary.height) {
188
+ reached = true;
189
+ break;
190
+ }
191
+ newerFirst.push(row);
192
+ }
193
+ if (!nextCursor)
194
+ break;
195
+ cursor = nextCursor;
196
+ if (page === maxPages - 1 && !reached)
197
+ throw new Error(`account history holds more than ${maxPages} pages after the recovery boundary`);
198
+ }
199
+ const rows = newerFirst.reverse();
200
+ return {
201
+ found,
202
+ rows: found || !boundary.key
203
+ ? rows
204
+ : rows.filter((r) => Number(r.block_height) > boundary.height),
205
+ };
206
+ };
207
+ const boundaryNow = () => {
208
+ if (last === null)
209
+ return { kind: "unsupported" };
210
+ if (last)
211
+ return { key: last, height: last.height };
212
+ if (snapshotHeight !== undefined)
213
+ return { key: null, height: snapshotHeight };
214
+ return { kind: "unverified", delivered: 0 };
215
+ };
216
+ const recover = async (snapshot) => {
217
+ const target = heightOf(snapshot);
218
+ const boundary = boundaryNow();
219
+ let status;
220
+ let delivered = new Map();
221
+ let floor = -1;
222
+ if ("kind" in boundary) {
223
+ status = boundary;
224
+ recent = null;
225
+ }
226
+ else {
227
+ try {
228
+ let indexed = target === undefined
229
+ ? -1
230
+ : await opts.fetchIndexedHeight(abort.signal);
231
+ for (let attempt = 1; target !== undefined && indexed < target && attempt < maxAttempts; attempt++) {
232
+ await abortableSleep(retryDelayMs, abort.signal);
233
+ indexed = await opts.fetchIndexedHeight(abort.signal);
234
+ }
235
+ const result = await scan(boundary);
236
+ if (closed)
237
+ return undefined;
238
+ if (boundary.key)
239
+ addEvent(delivered, boundary.key);
240
+ floor = boundary.key ? boundary.height : boundary.height + 1;
241
+ let newest = -1;
242
+ for (const row of result.rows) {
243
+ const key = rowKey(row);
244
+ addEvent(delivered, key);
245
+ newest = Math.max(newest, key.height);
246
+ deliver(rowFrame(row), key);
247
+ }
248
+ const count = result.rows.length;
249
+ status = !result.found
250
+ ? { kind: "boundaryNotFound", delivered: count }
251
+ : target === undefined
252
+ ? { kind: "unverified", delivered: count }
253
+ : indexed >= target
254
+ ? { kind: "backfilled", delivered: count }
255
+ : { kind: "historyBehind", delivered: count };
256
+ recent = { keys: delivered, height: newest, floor };
257
+ }
258
+ catch (err) {
259
+ if (closed)
260
+ return undefined;
261
+ status = {
262
+ kind: "failed",
263
+ error: err instanceof Error ? err : new Error(String(err)),
264
+ };
265
+ recent = null;
266
+ }
267
+ }
268
+ snapshotHeight = target;
269
+ // Flush up to the next reconnect snapshot; it starts the next backfill,
270
+ // from the last frame flushed here, and the frames after it stay buffered.
271
+ const cut = buffer.findIndex((b) => b.kind === "snapshot");
272
+ const now = cut < 0 ? buffer : buffer.slice(0, cut);
273
+ const next = cut < 0 ? undefined : buffer[cut].frame;
274
+ buffer = cut < 0 ? [] : buffer.slice(cut + 1);
275
+ for (const b of now)
276
+ if (b.kind === "event")
277
+ deliverLive(b.frame);
278
+ if (!closed)
279
+ opts.onRecovery?.(status);
280
+ return next;
281
+ };
282
+ const run = async (snapshot) => {
283
+ recovering = true;
284
+ let current = snapshot;
285
+ while (current && !closed)
286
+ current = await recover(current);
287
+ recovering = false;
288
+ };
289
+ const handle = (frame) => {
290
+ if (closed)
291
+ return;
292
+ if (frame.type === "snapshot") {
293
+ opts.onFrame(frame);
294
+ const snap = frame;
295
+ if (!seenSnapshot) {
296
+ seenSnapshot = true;
297
+ snapshotHeight = heightOf(snap);
298
+ return;
299
+ }
300
+ // A resend for another listener is not a reconnect.
301
+ if (snap.snapshot === "resent")
302
+ return;
303
+ if (recovering)
304
+ buffer.push({ kind: "snapshot", frame: snap });
305
+ else
306
+ void run(snap);
307
+ return;
308
+ }
309
+ // An error frame (a refused subscribe, a failed authentication) is no
310
+ // account event: it passes straight through and moves no boundary.
311
+ if (frame.type === "error") {
312
+ opts.onFrame(frame);
313
+ return;
314
+ }
315
+ const event = frame;
316
+ if (recovering)
317
+ buffer.push({ kind: "event", frame: event });
318
+ else
319
+ deliverLive(event);
320
+ };
321
+ return {
322
+ handle,
323
+ close: () => {
324
+ closed = true;
325
+ buffer = [];
326
+ abort.abort();
327
+ },
328
+ };
329
+ }
330
+ //# sourceMappingURL=account-recovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"account-recovery.js","sourceRoot":"","sources":["../src/account-recovery.ts"],"names":[],"mappings":"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"}
package/dist/bridge.d.ts CHANGED
@@ -1,13 +1,10 @@
1
1
  /**
2
- * Bridge custody: the canonical bridge-core v1 payload bytes the engine's
3
- * receipt path signs and verifies, exposed through the WASM core.
2
+ * Bridge custody: the canonical payload bytes the engine's receipt path
3
+ * signs and verifies, exposed through the WASM core.
4
4
  *
5
- * The byte layout is owned by Rust (`bridge-core` v1.0.0, the tag the
6
- * exchange engine's Cargo.lock resolves — the same dependency line
7
- * exchange-core carries). The exchange wire crate refuses a bridge-core
8
- * dependency by its hygiene gate, so the canonical bytes are reachable only
9
- * from the WASM core; calling it means the SDK signs exactly the bytes the
10
- * engine verifies, by construction — no parallel layout to drift. The
5
+ * The byte layout is owned by the wire contract's `bridge` module
6
+ * (`proof_wire::bridge`), the same definition the engine and the bridge program
7
+ * compile, so the SDK signs exactly the bytes the engine verifies. The
11
8
  * frozen vectors in `bridge.test.ts` pin the marshalling.
12
9
  *
13
10
  * The ed25519 quorum proof stays TypeScript-side (`signOperatorReceipt`):
@@ -1 +1 @@
1
- {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,YAAY,EAAE,UAAU,CAAC;IACzB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,UAAU,CAAC;IACvB,yCAAyC;IACzC,gBAAgB,EAAE,UAAU,CAAC;IAC7B,gDAAgD;IAChD,oBAAoB,EAAE,UAAU,CAAC;IACjC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,yBAAyB,GAC9B,UAAU,CAEZ;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,yBAAyB,GAC9B,UAAU,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,GAC/B,UAAU,CAEZ;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,yCAAyC;AACzC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC,EAChE,WAAW,EAAE,MAAM,GAClB,oBAAoB,CA2BtB"}
1
+ {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,YAAY,EAAE,UAAU,CAAC;IACzB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,UAAU,CAAC;IACvB,yCAAyC;IACzC,gBAAgB,EAAE,UAAU,CAAC;IAC7B,gDAAgD;IAChD,oBAAoB,EAAE,UAAU,CAAC;IACjC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,yBAAyB,GAC9B,UAAU,CAEZ;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,yBAAyB,GAC9B,UAAU,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,GAC/B,UAAU,CAEZ;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,yCAAyC;AACzC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC,EAChE,WAAW,EAAE,MAAM,GAClB,oBAAoB,CA2BtB"}