@arca-network/sdk 1.8.0 → 1.10.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.
@@ -1 +1 @@
1
- {"version":3,"file":"operation-handle.js","sourceRoot":"","sources":["../src/operation-handle.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"operation-handle.js","sourceRoot":"","sources":["../src/operation-handle.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,99 @@
1
+ /**
2
+ * HL's oracle band on `HyperliquidVenueModule.recoveryClosePosition`, in basis
3
+ * points (`RECOVERY_CLOSE_PX_BAND_BPS`). One-sided: a SELL must be at or above
4
+ * `oracle × (1 - band)`, a BUY at or below `oracle × (1 + band)`. The far side
5
+ * is unbounded — selling above or buying below oracle only improves the close.
6
+ */
7
+ export declare const RECOVERY_CLOSE_PX_BAND_BPS = 200;
8
+ export interface RecoveryCloseOrderInput {
9
+ /** Limit price in human decimal USD, e.g. `"63512.4"`. */
10
+ limitPx: number | string;
11
+ /** Order size in human base-asset units, e.g. `"0.0123"`. */
12
+ size: number | string;
13
+ /** The market's `szDecimals`, from `getMarketMeta()` or HL's `meta.universe`. */
14
+ szDecimals: number;
15
+ /** `true` when closing a short (a BUY), `false` when closing a long (a SELL). */
16
+ isBuy: boolean;
17
+ /**
18
+ * The full open position size. When `size` rounds to exactly this, the order
19
+ * closes the position and HL waives its minimum notional; otherwise the
20
+ * minimum applies and a sub-minimum order is dropped without a trace. Omit
21
+ * only if you have independently established the order clears the minimum.
22
+ */
23
+ positionSize?: number | string;
24
+ /**
25
+ * The asset's oracle price, from the same precompile the contract reads
26
+ * (`perpAssetInfo` / `oraclePx`). Supplying it moves the band check off chain,
27
+ * where the failure is a thrown error instead of a reverted transaction during
28
+ * a liquidation race.
29
+ */
30
+ oraclePx?: number | string;
31
+ }
32
+ export interface RecoveryCloseOrder {
33
+ /** `limitPx` argument for `recoveryClosePosition` (human value × 10^8). */
34
+ limitPx: bigint;
35
+ /** `sz` argument for `recoveryClosePosition` (human value × 10^8). */
36
+ sz: bigint;
37
+ /** The rounded human price actually encoded — may differ from the input. */
38
+ limitPxDecimal: string;
39
+ /** The floored human size actually encoded — may differ from the input. */
40
+ sizeDecimal: string;
41
+ /** `sizeDecimal × limitPxDecimal`. */
42
+ notionalUsd: string;
43
+ /** Whether `sizeDecimal` closes the position exactly (so the notional minimum is waived). */
44
+ closesPosition: boolean;
45
+ }
46
+ /**
47
+ * Round a reduce-only close to Hyperliquid's tick/lot rules and encode it as
48
+ * the `limitPx` / `sz` arguments of `HyperliquidVenueModule.recoveryClosePosition`.
49
+ *
50
+ * **Why this exists.** `recoveryClosePosition` reaches HL through CoreWriter,
51
+ * which does not report venue-side rejection: an order violating HL's price,
52
+ * size, or notional rules produces a successful transaction and a
53
+ * `VaultRecoveryCloseEnqueued` event, and then nothing happens on L1. That
54
+ * failure lands during a liquidation race, under a recovery claim, and reports
55
+ * success — so the rounding is not a nicety, it is the difference between a
56
+ * close and a silent no-op. This function applies the rules HL actually
57
+ * enforces:
58
+ *
59
+ * - **Price**: at most {@link MAX_PRICE_SIG_FIGS} significant figures, then at
60
+ * most `6 - szDecimals` decimal places, rounding half-away-from-zero (the
61
+ * same order and direction as HL's own Python SDK, so a price this produces
62
+ * matches what every other correct client produces).
63
+ * - **Size**: floor-truncated to `szDecimals` decimal places. Floor, not round,
64
+ * because rounding up can exceed the position and HL rejects a reduce-only
65
+ * order that would increase exposure.
66
+ * - **Notional**: `size × price` must clear ${@link MIN_ORDER_NOTIONAL_USD}
67
+ * unless the order closes the position exactly, which is HL's documented
68
+ * exemption (a *partial* close below the minimum is not exempt). Pass
69
+ * `positionSize` so this can be decided rather than assumed; the result's
70
+ * `closesPosition` reports which branch applied, so a caller who wants to
71
+ * enforce the minimum unconditionally can still refuse.
72
+ * - **Oracle band**: when `oraclePx` is given, the contract's one-sided band is
73
+ * checked here, turning an on-chain revert into a local error.
74
+ *
75
+ * Anything that would be dropped or reverted throws. A returned value is an
76
+ * order HL will act on.
77
+ *
78
+ * The event is still not evidence of execution — CoreWriter is asynchronous and
79
+ * the order can rest unfilled. Confirm by polling the position (HL
80
+ * `clearinghouseState`, or the vault's `l1Position` read passthrough), never by
81
+ * observing the event.
82
+ *
83
+ * @example
84
+ * ```ts
85
+ * const { limitPx, sz } = encodeRecoveryCloseOrder({
86
+ * limitPx: oraclePx * 0.995, // sell a long slightly below oracle to cross
87
+ * size: positionSize,
88
+ * positionSize,
89
+ * szDecimals: market.szDecimals,
90
+ * isBuy: false,
91
+ * oraclePx,
92
+ * });
93
+ * // hlModule.recoveryClosePosition(arcaId, asset, false, limitPx, sz, 3) // 3 = IOC
94
+ * ```
95
+ */
96
+ export declare function encodeRecoveryCloseOrder(input: RecoveryCloseOrderInput): RecoveryCloseOrder;
1
97
  export interface GeneratedRecoveryKeyResult {
2
98
  mnemonic: string;
3
99
  address: string;
@@ -1 +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"}
1
+ {"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAkIA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAW9C,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CA2D3F;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,IAAI,0BAA0B,CA4BpE"}
package/dist/recovery.js CHANGED
@@ -1,5 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.RECOVERY_CLOSE_PX_BAND_BPS = void 0;
4
+ exports.encodeRecoveryCloseOrder = encodeRecoveryCloseOrder;
3
5
  exports.generateRecoveryKeyPair = generateRecoveryKeyPair;
4
6
  const bip39_1 = require("@scure/bip39");
5
7
  const english_js_1 = require("@scure/bip39/wordlists/english.js");
@@ -41,6 +43,190 @@ function privateKeyToAddress(privateKey) {
41
43
  uncompressed.fill(0);
42
44
  return address;
43
45
  }
46
+ const DECIMAL_RE = /^([+-]?)(\d+)(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/;
47
+ function parseDec(value, label) {
48
+ const raw = typeof value === 'number' ? (Number.isFinite(value) ? String(value) : '') : value.trim();
49
+ const match = DECIMAL_RE.exec(raw);
50
+ if (!match)
51
+ throw new Error(`${label}: not a finite decimal number (got ${JSON.stringify(value)})`);
52
+ const [, sign, int, frac = '', exp = '0'] = match;
53
+ let m = BigInt(int + frac);
54
+ if (sign === '-')
55
+ m = -m;
56
+ let s = frac.length - Number(exp);
57
+ if (s < 0) {
58
+ m *= 10n ** BigInt(-s);
59
+ s = 0;
60
+ }
61
+ return { m, s };
62
+ }
63
+ /** Re-scale to exactly `target` decimal places, rounding half-away-from-zero. */
64
+ function rescale({ m, s }, target) {
65
+ if (target === s)
66
+ return { m, s };
67
+ if (target > s)
68
+ return { m: m * 10n ** BigInt(target - s), s: target };
69
+ const div = 10n ** BigInt(s - target);
70
+ const neg = m < 0n;
71
+ const abs = neg ? -m : m;
72
+ let q = abs / div;
73
+ if ((abs % div) * 2n >= div)
74
+ q += 1n;
75
+ return { m: neg ? -q : q, s: target };
76
+ }
77
+ /** Count of significant digits — the digits of |m|, since BigInt has no leading zeros. */
78
+ function sigDigits(m) {
79
+ const abs = m < 0n ? -m : m;
80
+ return abs === 0n ? 0 : abs.toString().length;
81
+ }
82
+ function formatDec({ m, s }) {
83
+ const neg = m < 0n;
84
+ let digits = (neg ? -m : m).toString();
85
+ if (s > 0) {
86
+ digits = digits.padStart(s + 1, '0');
87
+ const int = digits.slice(0, digits.length - s);
88
+ const frac = digits.slice(digits.length - s).replace(/0+$/, '');
89
+ digits = frac ? `${int}.${frac}` : int;
90
+ }
91
+ return (neg ? '-' : '') + digits;
92
+ }
93
+ /** Exact ×10^8 CoreWriter wire value; throws rather than truncating. */
94
+ function toWire(d, label) {
95
+ const scaled = rescale(d, 8);
96
+ if (scaled.m < 0n)
97
+ throw new Error(`${label}: must be positive`);
98
+ if (rescale(scaled, d.s).m !== d.m) {
99
+ throw new Error(`${label}: needs more than 8 decimal places, which CoreWriter cannot encode`);
100
+ }
101
+ return scaled.m;
102
+ }
103
+ function mulDec(a, b) {
104
+ return { m: a.m * b.m, s: a.s + b.s };
105
+ }
106
+ function cmpDec(a, b) {
107
+ const s = Math.max(a.s, b.s);
108
+ const am = rescale(a, s).m;
109
+ const bm = rescale(b, s).m;
110
+ return am < bm ? -1 : am > bm ? 1 : 0;
111
+ }
112
+ // --- Sovereign reduce-only close encoding ---
113
+ /**
114
+ * HL's oracle band on `HyperliquidVenueModule.recoveryClosePosition`, in basis
115
+ * points (`RECOVERY_CLOSE_PX_BAND_BPS`). One-sided: a SELL must be at or above
116
+ * `oracle × (1 - band)`, a BUY at or below `oracle × (1 + band)`. The far side
117
+ * is unbounded — selling above or buying below oracle only improves the close.
118
+ */
119
+ exports.RECOVERY_CLOSE_PX_BAND_BPS = 200;
120
+ /** HL's minimum order notional. Exempt only for an order that closes a position exactly. */
121
+ const MIN_ORDER_NOTIONAL_USD = 10;
122
+ /** HL perp price rule: at most `MAX_PRICE_DECIMALS - szDecimals` decimal places. */
123
+ const MAX_PRICE_DECIMALS = 6;
124
+ /** HL perp price rule: at most this many significant figures (integers exempt). */
125
+ const MAX_PRICE_SIG_FIGS = 5;
126
+ /**
127
+ * Round a reduce-only close to Hyperliquid's tick/lot rules and encode it as
128
+ * the `limitPx` / `sz` arguments of `HyperliquidVenueModule.recoveryClosePosition`.
129
+ *
130
+ * **Why this exists.** `recoveryClosePosition` reaches HL through CoreWriter,
131
+ * which does not report venue-side rejection: an order violating HL's price,
132
+ * size, or notional rules produces a successful transaction and a
133
+ * `VaultRecoveryCloseEnqueued` event, and then nothing happens on L1. That
134
+ * failure lands during a liquidation race, under a recovery claim, and reports
135
+ * success — so the rounding is not a nicety, it is the difference between a
136
+ * close and a silent no-op. This function applies the rules HL actually
137
+ * enforces:
138
+ *
139
+ * - **Price**: at most {@link MAX_PRICE_SIG_FIGS} significant figures, then at
140
+ * most `6 - szDecimals` decimal places, rounding half-away-from-zero (the
141
+ * same order and direction as HL's own Python SDK, so a price this produces
142
+ * matches what every other correct client produces).
143
+ * - **Size**: floor-truncated to `szDecimals` decimal places. Floor, not round,
144
+ * because rounding up can exceed the position and HL rejects a reduce-only
145
+ * order that would increase exposure.
146
+ * - **Notional**: `size × price` must clear ${@link MIN_ORDER_NOTIONAL_USD}
147
+ * unless the order closes the position exactly, which is HL's documented
148
+ * exemption (a *partial* close below the minimum is not exempt). Pass
149
+ * `positionSize` so this can be decided rather than assumed; the result's
150
+ * `closesPosition` reports which branch applied, so a caller who wants to
151
+ * enforce the minimum unconditionally can still refuse.
152
+ * - **Oracle band**: when `oraclePx` is given, the contract's one-sided band is
153
+ * checked here, turning an on-chain revert into a local error.
154
+ *
155
+ * Anything that would be dropped or reverted throws. A returned value is an
156
+ * order HL will act on.
157
+ *
158
+ * The event is still not evidence of execution — CoreWriter is asynchronous and
159
+ * the order can rest unfilled. Confirm by polling the position (HL
160
+ * `clearinghouseState`, or the vault's `l1Position` read passthrough), never by
161
+ * observing the event.
162
+ *
163
+ * @example
164
+ * ```ts
165
+ * const { limitPx, sz } = encodeRecoveryCloseOrder({
166
+ * limitPx: oraclePx * 0.995, // sell a long slightly below oracle to cross
167
+ * size: positionSize,
168
+ * positionSize,
169
+ * szDecimals: market.szDecimals,
170
+ * isBuy: false,
171
+ * oraclePx,
172
+ * });
173
+ * // hlModule.recoveryClosePosition(arcaId, asset, false, limitPx, sz, 3) // 3 = IOC
174
+ * ```
175
+ */
176
+ function encodeRecoveryCloseOrder(input) {
177
+ const { szDecimals, isBuy } = input;
178
+ if (!Number.isInteger(szDecimals) || szDecimals < 0 || szDecimals > MAX_PRICE_DECIMALS) {
179
+ throw new Error(`szDecimals: expected an integer in [0, ${MAX_PRICE_DECIMALS}], got ${szDecimals}`);
180
+ }
181
+ // Price: significant figures first, then decimal places — HL's order, and the
182
+ // one that makes integer prices fall out correctly (an integer price is always
183
+ // a valid tick, and the decimal-place cap cannot reintroduce a fraction).
184
+ let px = parseDec(input.limitPx, 'limitPx');
185
+ if (px.m <= 0n)
186
+ throw new Error('limitPx: must be positive');
187
+ const excessSigFigs = sigDigits(px.m) - MAX_PRICE_SIG_FIGS;
188
+ if (excessSigFigs > 0)
189
+ px = rescale(px, px.s - excessSigFigs);
190
+ if (px.s > MAX_PRICE_DECIMALS - szDecimals)
191
+ px = rescale(px, MAX_PRICE_DECIMALS - szDecimals);
192
+ if (px.m <= 0n)
193
+ throw new Error('limitPx: rounded to zero at this market’s price precision');
194
+ // Size: floor, so a full-position close can never round into an increase.
195
+ const rawSize = parseDec(input.size, 'size');
196
+ if (rawSize.m <= 0n)
197
+ throw new Error('size: must be positive');
198
+ let size = rescale(rawSize, szDecimals);
199
+ if (cmpDec(size, rawSize) > 0)
200
+ size = { m: size.m - 1n, s: size.s };
201
+ if (size.m <= 0n) {
202
+ throw new Error(`size: ${formatDec(rawSize)} floors to zero at szDecimals=${szDecimals}; the position is below one lot and cannot be closed through this surface`);
203
+ }
204
+ const closesPosition = input.positionSize !== undefined && cmpDec(size, parseDec(input.positionSize, 'positionSize')) === 0;
205
+ const notional = mulDec(size, px);
206
+ if (!closesPosition && cmpDec(notional, { m: BigInt(MIN_ORDER_NOTIONAL_USD), s: 0 }) < 0) {
207
+ throw new Error(`notional ${formatDec(notional)} is below Hyperliquid's $${MIN_ORDER_NOTIONAL_USD} minimum and this order does not close the position exactly, so the venue would drop it silently — close the full position, or raise the size`);
208
+ }
209
+ if (input.oraclePx !== undefined) {
210
+ const oracle = parseDec(input.oraclePx, 'oraclePx');
211
+ if (oracle.m <= 0n)
212
+ throw new Error('oraclePx: must be positive');
213
+ const bps = BigInt(10_000 + (isBuy ? exports.RECOVERY_CLOSE_PX_BAND_BPS : -exports.RECOVERY_CLOSE_PX_BAND_BPS));
214
+ const bound = mulDec(oracle, { m: bps, s: 4 });
215
+ // The contract's band is one-sided: a BUY may not exceed the upper bound, a
216
+ // SELL may not fall below the lower one.
217
+ if (isBuy ? cmpDec(px, bound) > 0 : cmpDec(px, bound) < 0) {
218
+ throw new Error(`limitPx ${formatDec(px)} is outside the contract's ${exports.RECOVERY_CLOSE_PX_BAND_BPS}bp oracle band (${isBuy ? 'max' : 'min'} ${formatDec(bound)} against oracle ${formatDec(oracle)}); the transaction would revert`);
219
+ }
220
+ }
221
+ return {
222
+ limitPx: toWire(px, 'limitPx'),
223
+ sz: toWire(size, 'size'),
224
+ limitPxDecimal: formatDec(px),
225
+ sizeDecimal: formatDec(size),
226
+ notionalUsd: formatDec(notional),
227
+ closesPosition,
228
+ };
229
+ }
44
230
  /**
45
231
  * Generate a BIP-39 mnemonic and derive the Ethereum address at the standard
46
232
  * BIP-44 path (m/44'/60'/0'/0/0).
@@ -1 +1 @@
1
- {"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -2253,8 +2253,17 @@ export type LeverageType = 'cross' | 'isolated';
2253
2253
  * reduce-only closer can no longer reduce it.
2254
2254
  * - `liquidated` — the position (or account) was liquidated.
2255
2255
  * - `position_gone` — an unsized TP/SL fired but the position was already gone.
2256
+ * - `market_delisted` — the venue delisted the market, so the order's book no
2257
+ * longer exists and it could never fill.
2258
+ * - `insufficient_margin` — a resting limit order repeatedly reached its price
2259
+ * but the account could not afford the fill. Placing an order checks margin
2260
+ * but does not reserve it, so an order that was affordable when placed can
2261
+ * become unaffordable while it rests (a loss on another position, a fill
2262
+ * elsewhere, funding). A brief dip is tolerated; the venue only retires the
2263
+ * order once it has stayed unaffordable across repeated attempts over
2264
+ * several minutes. Free up margin before re-placing it.
2256
2265
  */
2257
- export type OrderCancelReason = 'user_requested' | 'sibling_filled' | 'position_closed' | 'position_flipped' | 'liquidated' | 'position_gone';
2266
+ export type OrderCancelReason = 'user_requested' | 'sibling_filled' | 'position_closed' | 'position_flipped' | 'liquidated' | 'position_gone' | 'market_delisted' | 'insufficient_margin';
2258
2267
  export interface SimPosition {
2259
2268
  id: SimPositionId;
2260
2269
  accountId: SimAccountId;
@@ -2306,6 +2315,16 @@ export interface SimPosition {
2306
2315
  cumulativeBuilderFee?: string | null;
2307
2316
  /** Present when computed fields (unrealizedPnl, positionValue, returnOnEquity) could not be calculated. */
2308
2317
  error?: string | null;
2318
+ /**
2319
+ * When the position's *current open lot* began — the same lot boundary the
2320
+ * `cumulative*` fields use. Survives increases, partial reduces, and
2321
+ * leverage / margin-mode changes; resets on a flip-through-zero and on a
2322
+ * reopen after a full close.
2323
+ *
2324
+ * Derived from the platform's own fill history rather than reported by the
2325
+ * venue, so it means the same thing on every exchange. Empty string when no
2326
+ * history exists to derive it from.
2327
+ */
2309
2328
  createdAt: string;
2310
2329
  updatedAt: string;
2311
2330
  }
@@ -2602,8 +2621,11 @@ export type OrderBreakdownAmountType = 'spend' | 'notional' | 'tokens';
2602
2621
  * cross-margin liquidation estimate. The estimate matches the formula the
2603
2622
  * sim-exchange backend uses at read time
2604
2623
  * (`marginAvailable = equity - maintenanceMargin`, then
2605
- * `liq = mid -/+ marginAvailable / size`), so the preview reflects the
2606
- * liquidation price the position will actually have once the order fills. */
2624
+ * `liq = mid -/+ marginAvailable / (size * (1 -/+ mmr))`), so the preview
2625
+ * reflects the liquidation price the position will actually have once the
2626
+ * order fills. The `(1 -/+ mmr)` term is maintenance relief: the position's
2627
+ * own requirement is a percentage of notional, so it moves with the mark and
2628
+ * equity closes on it at `size * (1 -/+ mmr)` per unit rather than `size`. */
2607
2629
  export interface OrderBreakdownAccountContext {
2608
2630
  /** Account equity in USD. From `ExchangeState.marginSummary.equity`. */
2609
2631
  equity: string;
@@ -2965,6 +2987,27 @@ export interface OIHistoryResponse {
2965
2987
  interval: string;
2966
2988
  bars: OIBar[];
2967
2989
  }
2990
+ /**
2991
+ * A single SETTLED funding-rate observation for a market. Unlike {@link OIBar}
2992
+ * / {@link Candle} this is not interval-bucketed — it is a raw event at the
2993
+ * venue's real settlement timestamp, so a market's true funding schedule is
2994
+ * preserved. Values are settled historical rates, never predicted (use the
2995
+ * ticker's `funding` + `nextFundingTime` for the current/predicted rate).
2996
+ */
2997
+ export interface FundingObservation {
2998
+ /** Settlement time as Unix epoch milliseconds (UTC). */
2999
+ t: number;
3000
+ /** Settled funding rate for the period (decimal string, e.g. "0.0000125"). */
3001
+ fundingRate: string;
3002
+ /** Premium component at settlement (decimal string). May be absent. */
3003
+ premium?: string;
3004
+ /** Data source (e.g. "hl"). Absent/empty for legacy rows. */
3005
+ s?: string;
3006
+ }
3007
+ export interface FundingHistoryResponse {
3008
+ market: string;
3009
+ funding: FundingObservation[];
3010
+ }
2968
3011
  /** Emitted by {@link OIWatchStream} on each live OI bar update. */
2969
3012
  export interface OIEvent {
2970
3013
  market: string;
@@ -3140,6 +3183,52 @@ export interface CustodyRealmHalt {
3140
3183
  type: CustodyRealmHaltType;
3141
3184
  expiresAt: string;
3142
3185
  }
3186
+ /**
3187
+ * A resolved custody implementation address and the version marker read off it.
3188
+ *
3189
+ * A proxy address is stable across upgrades and says nothing about the surface
3190
+ * it currently delegates to, so both halves are needed: the address identifies
3191
+ * *which* implementation, the marker identifies *what surface*.
3192
+ */
3193
+ export interface CustodyImplRef {
3194
+ /** The implementation address, resolved live from the chain. */
3195
+ address: string;
3196
+ /**
3197
+ * The version marker read off that implementation, or `null` when the read
3198
+ * failed. Never `0` for an unread marker — a client gating on
3199
+ * `version >= 5` must be able to tell "reports 4" from "could not read".
3200
+ */
3201
+ version: number | null;
3202
+ /**
3203
+ * Which getter `version` came from. `moduleVersion` and
3204
+ * `exchangeArcaVaultVersion` promise *surface* semantics (they bump on
3205
+ * meaningful public-surface changes, so gate feature checks on them);
3206
+ * `arcaKernelVersion` and `arcaCoordinatorVersion` promise *storage layout*
3207
+ * and will not move for a surface addition.
3208
+ */
3209
+ marker: string;
3210
+ }
3211
+ /**
3212
+ * The implementation set behind a realm's custody proxies. Assert compatibility
3213
+ * against this before moving money, rather than scanning runtime bytecode.
3214
+ *
3215
+ * Entries are omitted when the address cannot be resolved (a degraded RPC, or a
3216
+ * realm that predates the proxy), so treat a missing entry as "unknown", not as
3217
+ * "absent from the deployment".
3218
+ */
3219
+ export interface CustodyImplementations {
3220
+ kernel?: CustodyImplRef;
3221
+ coordinator?: CustodyImplRef;
3222
+ hlModule?: CustodyImplRef;
3223
+ simModule?: CustodyImplRef;
3224
+ /**
3225
+ * Resolved through the live chain path (`module.vaultBeacon()` →
3226
+ * `beacon.implementation()`), so it reflects the vault implementation the
3227
+ * module actually governs.
3228
+ */
3229
+ vault?: CustodyImplRef;
3230
+ vaultBeacon?: string;
3231
+ }
3143
3232
  export interface CustodyStatus {
3144
3233
  contractAddress: string;
3145
3234
  chainId: number;
@@ -3147,6 +3236,8 @@ export interface CustodyStatus {
3147
3236
  boundaries: CustodyBoundary[];
3148
3237
  exchangeArcas: CustodyExchangeArca[];
3149
3238
  realmHalt: CustodyRealmHalt | null;
3239
+ /** Omitted when no implementation could be resolved. */
3240
+ implementations?: CustodyImplementations;
3150
3241
  }
3151
3242
  export interface CustodyBoundaryListResponse {
3152
3243
  boundaries: CustodyBoundary[];