@arca-network/sdk 1.1.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 (67) hide show
  1. package/LICENSE +91 -0
  2. package/README.md +65 -0
  3. package/dist/admin.d.ts +159 -0
  4. package/dist/admin.d.ts.map +1 -0
  5. package/dist/admin.js +399 -0
  6. package/dist/admin.js.map +1 -0
  7. package/dist/arca.d.ts +1343 -0
  8. package/dist/arca.d.ts.map +1 -0
  9. package/dist/arca.js +3454 -0
  10. package/dist/arca.js.map +1 -0
  11. package/dist/cache.d.ts +29 -0
  12. package/dist/cache.d.ts.map +1 -0
  13. package/dist/cache.js +74 -0
  14. package/dist/cache.js.map +1 -0
  15. package/dist/candle-cdn.d.ts +17 -0
  16. package/dist/candle-cdn.d.ts.map +1 -0
  17. package/dist/candle-cdn.js +138 -0
  18. package/dist/candle-cdn.js.map +1 -0
  19. package/dist/client.d.ts +98 -0
  20. package/dist/client.d.ts.map +1 -0
  21. package/dist/client.js +225 -0
  22. package/dist/client.js.map +1 -0
  23. package/dist/errors.d.ts +153 -0
  24. package/dist/errors.d.ts.map +1 -0
  25. package/dist/errors.js +243 -0
  26. package/dist/errors.js.map +1 -0
  27. package/dist/events.d.ts +2 -0
  28. package/dist/events.d.ts.map +1 -0
  29. package/dist/events.js +6 -0
  30. package/dist/events.js.map +1 -0
  31. package/dist/index.d.ts +21 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +71 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/ladder.d.ts +40 -0
  36. package/dist/ladder.d.ts.map +1 -0
  37. package/dist/ladder.js +145 -0
  38. package/dist/ladder.js.map +1 -0
  39. package/dist/ladder.test.d.ts +2 -0
  40. package/dist/ladder.test.d.ts.map +1 -0
  41. package/dist/ladder.test.js +112 -0
  42. package/dist/ladder.test.js.map +1 -0
  43. package/dist/operation-handle.d.ts +88 -0
  44. package/dist/operation-handle.d.ts.map +1 -0
  45. package/dist/operation-handle.js +262 -0
  46. package/dist/operation-handle.js.map +1 -0
  47. package/dist/recovery.d.ts +20 -0
  48. package/dist/recovery.d.ts.map +1 -0
  49. package/dist/recovery.js +91 -0
  50. package/dist/recovery.js.map +1 -0
  51. package/dist/revalue.d.ts +22 -0
  52. package/dist/revalue.d.ts.map +1 -0
  53. package/dist/revalue.js +153 -0
  54. package/dist/revalue.js.map +1 -0
  55. package/dist/streams.d.ts +661 -0
  56. package/dist/streams.d.ts.map +1 -0
  57. package/dist/streams.js +2272 -0
  58. package/dist/streams.js.map +1 -0
  59. package/dist/types.d.ts +2814 -0
  60. package/dist/types.d.ts.map +1 -0
  61. package/dist/types.js +118 -0
  62. package/dist/types.js.map +1 -0
  63. package/dist/websocket.d.ts +240 -0
  64. package/dist/websocket.d.ts.map +1 -0
  65. package/dist/websocket.js +1288 -0
  66. package/dist/websocket.js.map +1 -0
  67. package/package.json +48 -0
@@ -0,0 +1,262 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.OrderHandle = exports.OperationHandle = void 0;
4
+ /**
5
+ * A thenable handle returned synchronously from mutation methods.
6
+ *
7
+ * `await handle` waits for both HTTP submission AND operation settlement,
8
+ * resolving to the full response with `operation.state` updated to the
9
+ * terminal state.
10
+ *
11
+ * For finer control:
12
+ * - `handle.submitted` — access the HTTP response before settlement
13
+ * - `handle.wait({ timeout })` — explicit timeout
14
+ */
15
+ class OperationHandle {
16
+ /** Resolves when the HTTP call completes (before settlement). */
17
+ submitted;
18
+ /**
19
+ * Describes the predicted effects of this operation, available synchronously
20
+ * before the server responds. For transfers this includes predicted
21
+ * `departing`/`arriving` balance changes; for orders it includes the
22
+ * order intent.
23
+ */
24
+ predicted;
25
+ _waitFn;
26
+ _defaultCompleted = null;
27
+ constructor(httpCall, waitFn, predicted) {
28
+ this.submitted = httpCall;
29
+ this._waitFn = waitFn;
30
+ this.predicted = predicted;
31
+ }
32
+ _settle(timeoutMs) {
33
+ return this.submitted.then(response => {
34
+ if (!response.operation || response.operation.state !== 'pending')
35
+ return response;
36
+ return this._waitFn(response.operation.id, timeoutMs).then(completed => ({
37
+ ...response,
38
+ operation: completed,
39
+ }));
40
+ });
41
+ }
42
+ then(onfulfilled, onrejected) {
43
+ if (!this._defaultCompleted) {
44
+ this._defaultCompleted = this._settle();
45
+ }
46
+ return this._defaultCompleted.then(onfulfilled, onrejected);
47
+ }
48
+ /** Wait for settlement with an explicit timeout. */
49
+ wait(opts) {
50
+ if (!opts?.timeout) {
51
+ if (!this._defaultCompleted) {
52
+ this._defaultCompleted = this._settle();
53
+ }
54
+ return this._defaultCompleted;
55
+ }
56
+ return this._settle(opts.timeout);
57
+ }
58
+ }
59
+ exports.OperationHandle = OperationHandle;
60
+ /**
61
+ * Extended handle for order lifecycle.
62
+ *
63
+ * `await order` means "the order was placed" (operation completed).
64
+ * Fills and cancellation are separate lifecycle concerns accessible
65
+ * through `.filled()`, `.onFill()`, `.fills()`, and `.cancel()`.
66
+ */
67
+ class OrderHandle extends OperationHandle {
68
+ _objectId;
69
+ _placementPath;
70
+ _deps;
71
+ _orderId;
72
+ constructor(httpCall, waitFn, objectId, placementPath, deps) {
73
+ super(httpCall, waitFn);
74
+ this._objectId = objectId;
75
+ this._placementPath = placementPath;
76
+ this._deps = deps;
77
+ this._orderId = this.submitted.then(r => {
78
+ if (r.operation.outcome) {
79
+ try {
80
+ const parsed = JSON.parse(r.operation.outcome);
81
+ if (parsed.orderId)
82
+ return parsed.orderId;
83
+ }
84
+ catch { /* fall through */ }
85
+ }
86
+ return r.operation.id;
87
+ }, () => '');
88
+ // ^^ Swallow rejections on this derived chain to avoid unhandled-rejection
89
+ // warnings. Callers access the orderId through .filled()/.cancel() which
90
+ // await the parent handle and will surface the original error.
91
+ }
92
+ /**
93
+ * Wait for the order to be fully filled.
94
+ * Resolves with the order and all its fills.
95
+ * Rejects on timeout (limit orders may never fill).
96
+ */
97
+ async filled(opts) {
98
+ const settled = await this;
99
+ let orderId = await this._orderId;
100
+ if (settled.operation?.outcome) {
101
+ try {
102
+ const parsed = JSON.parse(settled.operation.outcome);
103
+ if (parsed.orderId)
104
+ orderId = parsed.orderId;
105
+ }
106
+ catch { /* use _orderId fallback */ }
107
+ }
108
+ const timeout = opts?.timeout ?? 30_000;
109
+ return new Promise((resolve, reject) => {
110
+ let settled = false;
111
+ const timer = setTimeout(() => {
112
+ cleanup();
113
+ reject(new Error(`Order fill timed out after ${timeout}ms`));
114
+ }, timeout);
115
+ const cleanup = () => {
116
+ settled = true;
117
+ clearTimeout(timer);
118
+ unsubscribe();
119
+ };
120
+ const checkOrder = async () => {
121
+ if (settled)
122
+ return;
123
+ try {
124
+ const result = await this._deps.getOrder(this._objectId, orderId);
125
+ if (result.order.status === 'FILLED' || result.order.status === 'CANCELLED' || result.order.status === 'FAILED') {
126
+ cleanup();
127
+ resolve(result);
128
+ }
129
+ }
130
+ catch { /* ignore fetch errors, will retry on next event */ }
131
+ };
132
+ const unsubscribe = this._deps.onFillEvent((event) => {
133
+ if (event.fill && event.fill.orderId === orderId) {
134
+ checkOrder();
135
+ }
136
+ else if (event.entityPath) {
137
+ checkOrder();
138
+ }
139
+ });
140
+ checkOrder();
141
+ });
142
+ }
143
+ /**
144
+ * Register a callback for each fill on this order.
145
+ * Returns an unsubscribe function.
146
+ */
147
+ onFill(callback) {
148
+ let active = true;
149
+ const unsubscribe = this._deps.onFillEvent((event) => {
150
+ if (!active)
151
+ return;
152
+ const fill = event.fill;
153
+ if (fill) {
154
+ this._orderId.then(orderId => {
155
+ if (fill.orderId === orderId)
156
+ callback(fill);
157
+ });
158
+ }
159
+ });
160
+ return () => {
161
+ active = false;
162
+ unsubscribe();
163
+ };
164
+ }
165
+ /**
166
+ * Async iterator that yields fills as they arrive.
167
+ * Terminates when the order is fully filled, cancelled, or timeout.
168
+ */
169
+ async *fills(opts) {
170
+ await this; // wait for placement
171
+ const orderId = await this._orderId;
172
+ const timeout = opts?.timeout ?? 300_000;
173
+ const deadline = Date.now() + timeout;
174
+ const seen = new Set();
175
+ // Yield any existing fills
176
+ try {
177
+ const initial = await this._deps.getOrder(this._objectId, orderId);
178
+ for (const fill of initial.fills) {
179
+ seen.add(fill.id);
180
+ yield fill;
181
+ }
182
+ if (initial.order.status === 'FILLED' || initial.order.status === 'CANCELLED' || initial.order.status === 'FAILED') {
183
+ return;
184
+ }
185
+ }
186
+ catch { /* continue to listen */ }
187
+ // Listen for new fills via WebSocket
188
+ while (Date.now() < deadline) {
189
+ const fill = await new Promise((resolve, reject) => {
190
+ const remaining = deadline - Date.now();
191
+ if (remaining <= 0) {
192
+ resolve(null);
193
+ return;
194
+ }
195
+ const timer = setTimeout(() => { cleanup(); resolve(null); }, remaining);
196
+ const cleanup = () => { clearTimeout(timer); unsub(); };
197
+ const unsub = this._deps.onFillEvent((event) => {
198
+ const f = event.fill;
199
+ if (f) {
200
+ this._orderId.then(oid => {
201
+ if (f.orderId === oid && !seen.has(f.id)) {
202
+ cleanup();
203
+ resolve(f);
204
+ }
205
+ });
206
+ }
207
+ });
208
+ });
209
+ if (!fill)
210
+ return; // timeout
211
+ seen.add(fill.id);
212
+ yield fill;
213
+ // Check if order is fully filled
214
+ try {
215
+ const current = await this._deps.getOrder(this._objectId, orderId);
216
+ if (current.order.status === 'FILLED' || current.order.status === 'CANCELLED' || current.order.status === 'FAILED') {
217
+ // Yield any fills we haven't seen
218
+ for (const f of current.fills) {
219
+ if (!seen.has(f.id)) {
220
+ seen.add(f.id);
221
+ yield f;
222
+ }
223
+ }
224
+ return;
225
+ }
226
+ }
227
+ catch { /* continue */ }
228
+ }
229
+ }
230
+ /**
231
+ * Get the platform-side fill record for this order, with P&L, fee breakdown,
232
+ * direction, and resulting position. Waits for the order to be filled first.
233
+ *
234
+ * Returns the first fill matching this order's operation, which includes
235
+ * `direction`, `realizedPnl`, `feeBreakdown`, `resultingPosition`, and `startPosition`.
236
+ */
237
+ async fillSummary(opts) {
238
+ const result = await this.filled(opts);
239
+ const opId = (await this.submitted).operation.id;
240
+ const fills = await this._deps.listFills(this._objectId);
241
+ return fills.fills.find(f => f.operationId === opId || f.orderId === result.order.id) ?? null;
242
+ }
243
+ /**
244
+ * Cancel the order. Auto-generates a cancel path from the placement path,
245
+ * or accepts an explicit path for idempotency control.
246
+ */
247
+ cancel(opts) {
248
+ const cancelPath = opts?.path ?? this._placementPath.replace('/op/order/', '/op/cancel/');
249
+ // Wrap in object so Promise.then doesn't unwrap the thenable OperationHandle
250
+ const handlePromise = this._orderId.then((orderId) => ({
251
+ h: this._deps.cancelOrder({
252
+ path: cancelPath,
253
+ objectId: this._objectId,
254
+ orderId,
255
+ }),
256
+ }));
257
+ const submitted = handlePromise.then(({ h }) => h.submitted).then((r) => r);
258
+ return new OperationHandle(submitted, (id, timeout) => handlePromise.then(({ h }) => h.wait({ timeout }).then((r) => r.operation)));
259
+ }
260
+ }
261
+ exports.OrderHandle = OrderHandle;
262
+ //# sourceMappingURL=operation-handle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-handle.js","sourceRoot":"","sources":["../src/operation-handle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ export interface GeneratedRecoveryKeyResult {
2
+ mnemonic: string;
3
+ address: string;
4
+ }
5
+ /**
6
+ * Generate a BIP-39 mnemonic and derive the Ethereum address at the standard
7
+ * BIP-44 path (m/44'/60'/0'/0/0).
8
+ *
9
+ * Entropy comes from the platform CSPRNG (`crypto.getRandomValues`), which
10
+ * `@scure/bip39` uses internally. All intermediate byte buffers (seed, private
11
+ * key) are zeroed after derivation.
12
+ *
13
+ * **Memory safety caveat**: JavaScript strings are immutable and
14
+ * garbage-collected — the returned `mnemonic` string cannot be reliably erased
15
+ * from memory. For environments that require guaranteed zeroization, generate
16
+ * the key in a native module or secure enclave and pass only the address to
17
+ * the SDK.
18
+ */
19
+ export declare function generateRecoveryKeyPair(): GeneratedRecoveryKeyResult;
20
+ //# sourceMappingURL=recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AA+CA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,IAAI,0BAA0B,CA4BpE"}
@@ -0,0 +1,91 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.generateRecoveryKeyPair = generateRecoveryKeyPair;
4
+ const bip39_1 = require("@scure/bip39");
5
+ const english_js_1 = require("@scure/bip39/wordlists/english.js");
6
+ const bip32_1 = require("@scure/bip32");
7
+ const sha3_js_1 = require("@noble/hashes/sha3.js");
8
+ const secp256k1_js_1 = require("@noble/curves/secp256k1.js");
9
+ const ETH_BIP44_PATH = "m/44'/60'/0'/0/0";
10
+ function bytesToHex(bytes) {
11
+ let hex = '';
12
+ for (let i = 0; i < bytes.length; i++) {
13
+ hex += bytes[i].toString(16).padStart(2, '0');
14
+ }
15
+ return hex;
16
+ }
17
+ /**
18
+ * EIP-55 mixed-case checksum encoding.
19
+ * Input: 40-char lowercase hex address (no 0x prefix).
20
+ */
21
+ function checksumAddress(addressHex) {
22
+ const hash = bytesToHex((0, sha3_js_1.keccak_256)(new TextEncoder().encode(addressHex)));
23
+ let result = '0x';
24
+ for (let i = 0; i < 40; i++) {
25
+ result += parseInt(hash[i], 16) >= 8
26
+ ? addressHex[i].toUpperCase()
27
+ : addressHex[i];
28
+ }
29
+ return result;
30
+ }
31
+ /**
32
+ * Derive an EIP-55 checksummed Ethereum address from a secp256k1 private key.
33
+ * Zeroes the intermediate public key and hash buffers before returning.
34
+ */
35
+ function privateKeyToAddress(privateKey) {
36
+ const uncompressed = secp256k1_js_1.secp256k1.getPublicKey(privateKey, false);
37
+ const pubKeyBody = uncompressed.subarray(1); // drop 0x04 prefix
38
+ const hash = (0, sha3_js_1.keccak_256)(pubKeyBody);
39
+ const address = checksumAddress(bytesToHex(hash.slice(-20)));
40
+ hash.fill(0);
41
+ uncompressed.fill(0);
42
+ return address;
43
+ }
44
+ /**
45
+ * Generate a BIP-39 mnemonic and derive the Ethereum address at the standard
46
+ * BIP-44 path (m/44'/60'/0'/0/0).
47
+ *
48
+ * Entropy comes from the platform CSPRNG (`crypto.getRandomValues`), which
49
+ * `@scure/bip39` uses internally. All intermediate byte buffers (seed, private
50
+ * key) are zeroed after derivation.
51
+ *
52
+ * **Memory safety caveat**: JavaScript strings are immutable and
53
+ * garbage-collected — the returned `mnemonic` string cannot be reliably erased
54
+ * from memory. For environments that require guaranteed zeroization, generate
55
+ * the key in a native module or secure enclave and pass only the address to
56
+ * the SDK.
57
+ */
58
+ function generateRecoveryKeyPair() {
59
+ const mnemonic = (0, bip39_1.generateMnemonic)(english_js_1.wordlist, 128);
60
+ let seed;
61
+ let masterKey;
62
+ let derivedKey;
63
+ try {
64
+ seed = (0, bip39_1.mnemonicToSeedSync)(mnemonic);
65
+ masterKey = bip32_1.HDKey.fromMasterSeed(seed);
66
+ derivedKey = masterKey.derive(ETH_BIP44_PATH);
67
+ const privateKey = derivedKey.privateKey;
68
+ if (!privateKey) {
69
+ throw new Error('Recovery key derivation failed: no private key produced');
70
+ }
71
+ try {
72
+ const address = privateKeyToAddress(privateKey);
73
+ return { mnemonic, address };
74
+ }
75
+ finally {
76
+ privateKey.fill(0);
77
+ }
78
+ }
79
+ finally {
80
+ seed?.fill(0);
81
+ try {
82
+ masterKey?.wipePrivateData();
83
+ }
84
+ catch { /* best-effort */ }
85
+ try {
86
+ derivedKey?.wipePrivateData();
87
+ }
88
+ catch { /* best-effort */ }
89
+ }
90
+ }
91
+ //# sourceMappingURL=recovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { ObjectValuation, PathAggregation, ExchangeState } from './types';
2
+ type Mids = Record<string, string>;
3
+ /**
4
+ * Recompute all price-derived fields on an ObjectValuation using fresh mid prices.
5
+ * Static data (amounts, sizes, entry prices, paths) is preserved unchanged.
6
+ */
7
+ export declare function revalueObject(obj: ObjectValuation, mids: Mids): ObjectValuation;
8
+ /**
9
+ * Recompute all price-derived fields on an ExchangeState using fresh mid prices.
10
+ * Position P&L, margin summary totals, and equity are updated.
11
+ * Structural data (orders, account, margins, intents) is preserved unchanged.
12
+ */
13
+ export declare function revalueExchangeState(state: ExchangeState, mids: Mids): ExchangeState;
14
+ /**
15
+ * Recompute price-derived fields on a PathAggregation using fresh mid prices.
16
+ * Spot entries: amount × newMid. Perp entries: derive net signed size from
17
+ * the existing snapshot and recompute unrealized P&L at the new mid.
18
+ * Exchange entries (USD cash) and departingUsd/arrivingUsd are not price-dependent.
19
+ */
20
+ export declare function revalueAggregation(agg: PathAggregation, mids: Mids): PathAggregation;
21
+ export {};
22
+ //# sourceMappingURL=revalue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revalue.d.ts","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAA8C,aAAa,EAAiC,MAAM,SAAS,CAAC;AAE1J,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA4BnC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,GAAG,eAAe,CA0B/E;AAqCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAYpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,GAAG,eAAe,CA6BpF"}
@@ -0,0 +1,153 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.revalueObject = revalueObject;
4
+ exports.revalueExchangeState = revalueExchangeState;
5
+ exports.revalueAggregation = revalueAggregation;
6
+ function revalueBalance(b, mids) {
7
+ const mid = mids[b.denomination] ?? '1';
8
+ const amount = Number(b.amount) || 0;
9
+ const price = Number(mid) || 1;
10
+ return { ...b, price: mid, valueUsd: String(amount * price) };
11
+ }
12
+ function revaluePosition(p, mids) {
13
+ const mid = mids[p.market];
14
+ if (!mid)
15
+ return p;
16
+ const markPrice = Number(mid);
17
+ if (!Number.isFinite(markPrice))
18
+ return p;
19
+ const size = Number(p.size) || 0;
20
+ const entry = Number(p.entryPrice) || 0;
21
+ const signedSize = p.side === 'short' ? -size : size;
22
+ const pnl = signedSize * (markPrice - entry);
23
+ return { ...p, markPrice: mid, unrealizedPnl: String(pnl), valueUsd: String(pnl) };
24
+ }
25
+ function revalueReserved(r, mids) {
26
+ const mid = mids[r.denomination] ?? '1';
27
+ const amount = Number(r.amount) || 0;
28
+ const price = Number(mid) || 1;
29
+ return { ...r, price: mid, valueUsd: String(amount * price) };
30
+ }
31
+ /**
32
+ * Recompute all price-derived fields on an ObjectValuation using fresh mid prices.
33
+ * Static data (amounts, sizes, entry prices, paths) is preserved unchanged.
34
+ */
35
+ function revalueObject(obj, mids) {
36
+ if (obj.type === 'exchange') {
37
+ const newPositions = obj.positions?.map(p => revaluePosition(p, mids)) ?? null;
38
+ const cashStr = obj.balances[0]?.amount ?? '0';
39
+ const cash = Number(cashStr) || 0;
40
+ const totalPnl = newPositions?.reduce((s, p) => s + (Number(p.unrealizedPnl) || 0), 0) ?? 0;
41
+ const equity = cash + totalPnl;
42
+ return {
43
+ ...obj,
44
+ valueUsd: String(equity),
45
+ positions: newPositions,
46
+ reservedBalances: obj.reservedBalances?.map(r => revalueReserved(r, mids)),
47
+ pendingInbound: obj.pendingInbound?.map(r => revalueReserved(r, mids)),
48
+ };
49
+ }
50
+ const newBalances = obj.balances.map(b => revalueBalance(b, mids));
51
+ const newReserved = obj.reservedBalances?.map(r => revalueReserved(r, mids));
52
+ const objValue = newBalances.reduce((s, b) => s + (Number(b.valueUsd) || 0), 0);
53
+ return {
54
+ ...obj,
55
+ valueUsd: String(objValue),
56
+ balances: newBalances,
57
+ reservedBalances: newReserved,
58
+ pendingInbound: obj.pendingInbound?.map(r => revalueReserved(r, mids)),
59
+ };
60
+ }
61
+ function revalueSimPosition(p, mids) {
62
+ const mid = mids[p.market];
63
+ if (!mid)
64
+ return p;
65
+ const markPrice = Number(mid);
66
+ if (!Number.isFinite(markPrice))
67
+ return p;
68
+ const size = Number(p.size) || 0;
69
+ const entry = Number(p.entryPrice) || 0;
70
+ const signedSize = p.side === 'short' ? -size : size;
71
+ const pnl = signedSize * (markPrice - entry);
72
+ const posValue = size * markPrice;
73
+ const margin = Number(p.marginUsed) || 0;
74
+ const roe = margin > 0 ? pnl / margin : 0;
75
+ return {
76
+ ...p,
77
+ unrealizedPnl: String(pnl),
78
+ positionValue: String(posValue),
79
+ returnOnEquity: String(roe),
80
+ error: undefined,
81
+ };
82
+ }
83
+ function revalueMarginSummary(summary, positions) {
84
+ const totalPnl = positions?.reduce((s, p) => s + (Number(p.unrealizedPnl) || 0), 0) ?? 0;
85
+ const totalRawUsd = Number(summary.totalRawUsd) || 0;
86
+ const equity = totalRawUsd > 0 ? totalRawUsd + totalPnl : Number(summary.equity) || 0;
87
+ const maintenance = Number(summary.maintenanceMarginRequired) || 0;
88
+ const withdrawable = Math.max(0, equity - maintenance);
89
+ return {
90
+ ...summary,
91
+ totalUnrealizedPnl: String(totalPnl),
92
+ equity: String(equity),
93
+ availableToWithdraw: String(withdrawable),
94
+ };
95
+ }
96
+ /**
97
+ * Recompute all price-derived fields on an ExchangeState using fresh mid prices.
98
+ * Position P&L, margin summary totals, and equity are updated.
99
+ * Structural data (orders, account, margins, intents) is preserved unchanged.
100
+ */
101
+ function revalueExchangeState(state, mids) {
102
+ const newPositions = state.positions?.map(p => revalueSimPosition(p, mids)) ?? null;
103
+ const newSummary = revalueMarginSummary(state.marginSummary, newPositions);
104
+ const newCross = state.crossMarginSummary
105
+ ? revalueMarginSummary(state.crossMarginSummary, newPositions)
106
+ : undefined;
107
+ return {
108
+ ...state,
109
+ positions: newPositions,
110
+ marginSummary: newSummary,
111
+ crossMarginSummary: newCross,
112
+ };
113
+ }
114
+ /**
115
+ * Recompute price-derived fields on a PathAggregation using fresh mid prices.
116
+ * Spot entries: amount × newMid. Perp entries: derive net signed size from
117
+ * the existing snapshot and recompute unrealized P&L at the new mid.
118
+ * Exchange entries (USD cash) and departingUsd/arrivingUsd are not price-dependent.
119
+ */
120
+ function revalueAggregation(agg, mids) {
121
+ const newBreakdown = agg.breakdown.map(b => {
122
+ if (b.category === 'spot') {
123
+ const mid = mids[b.asset];
124
+ if (!mid)
125
+ return b;
126
+ const amount = Number(b.amount) || 0;
127
+ const price = Number(mid) || 1;
128
+ return { ...b, price: mid, valueUsd: String(amount * price) };
129
+ }
130
+ if (b.category === 'perp') {
131
+ const mid = mids[b.asset];
132
+ if (!mid || !b.avgEntryPrice || !b.price)
133
+ return b;
134
+ const newMid = Number(mid);
135
+ const oldMid = Number(b.price);
136
+ if (!oldMid || !Number.isFinite(newMid))
137
+ return b;
138
+ const amount = Number(b.amount) || 0;
139
+ const entryNotional = Number(b.avgEntryPrice) * amount;
140
+ const netSignedSize = (Number(b.valueUsd) + entryNotional) / oldMid;
141
+ const newValue = newMid * netSignedSize - entryNotional;
142
+ return { ...b, price: mid, valueUsd: String(newValue) };
143
+ }
144
+ return b;
145
+ });
146
+ const totalEquity = newBreakdown.reduce((s, b) => s + (Number(b.valueUsd) || 0), 0);
147
+ return {
148
+ ...agg,
149
+ totalEquityUsd: String(totalEquity),
150
+ breakdown: newBreakdown,
151
+ };
152
+ }
153
+ //# sourceMappingURL=revalue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revalue.js","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":"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"}