@arca-network/sdk 1.19.0 → 1.21.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.
- package/dist/arca.d.ts.map +1 -1
- package/dist/arca.js +12 -6
- package/dist/arca.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3
- package/dist/index.js.map +1 -1
- package/dist/ladder.d.ts +25 -1
- package/dist/ladder.d.ts.map +1 -1
- package/dist/ladder.js +29 -2
- package/dist/ladder.js.map +1 -1
- package/dist/ladder.test.js +27 -1
- package/dist/ladder.test.js.map +1 -1
- package/dist/revalue.d.ts +5 -0
- package/dist/revalue.d.ts.map +1 -1
- package/dist/revalue.js +27 -1
- package/dist/revalue.js.map +1 -1
- package/dist/types.d.ts +93 -9
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +6 -0
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
3
3
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
4
|
};
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.
|
|
7
|
-
exports.
|
|
8
|
-
exports.StepUpCancelledError = exports.StepUpRequiredError = exports.OperationStalledError = exports.OperationFailedError = exports.ExchangeProvisioningError = exports.ExchangeError = exports.InternalError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.ValidationError = void 0;
|
|
6
|
+
exports.signOperatorAction = exports.operatorActionDigest = exports.cosignDomainSeparator = exports.CosignActionV4 = exports.CosignAction = exports.RECOVERY_CLOSE_PX_BAND_BPS = exports.encodeRecoveryCloseOrder = exports.generateRecoveryKeyPair = exports.MIN_POINTS = exports.DEFAULT_POINTS = exports.ALL_RESOLUTIONS = exports.promotionTarget = exports.expectedPointCount = exports.boundaries = exports.alignUp = exports.alignDown = exports.retentionMs = exports.bucketMs = exports.pickResolutionFromIso = exports.pickResolution = exports.toTypedEvent = exports.Channel = exports.EventType = exports.WatchStreamReadyTimeoutError = exports.FundingWatchStream = exports.RealmFillWatchStream = exports.FillWatchStream = exports.TwapWatchStream = exports.TradeWatchStream = exports.ExchangeWatchStream = exports.CoverageTracker = exports.CandleChartStream = exports.OIWatchStream = exports.CandleWatchStream = exports.PriceWatchStream = exports.MaxOrderSizeWatchStream = exports.PnlChartStream = exports.EquityChartStream = exports.ProjectionWatchStream = exports.AggregationWatchStream = exports.ObjectsWatchStream = exports.ObjectWatchStream = exports.BalanceWatchStream = exports.OperationWatchStream = exports.OrderHandle = exports.OperationHandle = exports.WebSocketManager = exports.ArcaAdmin = exports.computeChartRange = exports.Arca = void 0;
|
|
7
|
+
exports.revalueProjectedValuation = exports.revalueExchangeState = exports.revalueAggregation = exports.revalueObject = exports.cosignVectors = exports.PERMIT_TYPEHASH_HEX = exports.BIND_BOUNDARY_TYPEHASH_HEX = exports.BIND_DESTINATION_TYPEHASH_HEX = exports.recoverPermitSigner = exports.recoverBindingSigner = exports.signPermit = exports.signBinding = exports.permitDigest = exports.bindingDigest = exports.permitTypedData = exports.bindingTypedData = exports.custodyKey = exports.recoverCosignerManageSigner = exports.signCosignerManage = exports.cosignerManageDigest = exports.cosignRegistryDomainSeparator = exports.CosignerManageAction = exports.encodeRegistryCosignBlob = exports.deviceSignerHash = exports.encodeP256Signature = exports.p256DeviceSigner = exports.p256DeviceKey = exports.verifierDeviceSigner = exports.addressDeviceSigner = exports.OPERATOR_ACTION_TYPEHASH_HEX = exports.signRaiseLien = exports.signAccountApproveBuilderFee = exports.signRotateSovereignKey = exports.signAccountMigrateParent = exports.signAccountAddAgent = exports.signReassignAccountBoundary = exports.signAllocateToVenue = exports.signCrossTransfer = exports.signWithdraw = exports.raiseLienParamsHash = exports.accountApproveBuilderFeeParamsHash = exports.rotateSovereignKeyParamsHash = exports.accountMigrateParentParamsHash = exports.accountAddAgentParamsHash = exports.reassignAccountBoundaryParamsHash = exports.allocateToVenueParamsHash = exports.crossTransferParamsHash = exports.withdrawParamsHashV5 = exports.withdrawParamsHash = exports.recoverOperatorActionSigner = void 0;
|
|
8
|
+
exports.StepUpCancelledError = exports.StepUpRequiredError = exports.OperationStalledError = exports.OperationFailedError = exports.ExchangeProvisioningError = exports.ExchangeError = exports.InternalError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.ValidationError = exports.ArcaError = void 0;
|
|
9
9
|
// Main SDK entry point
|
|
10
10
|
var arca_1 = require("./arca");
|
|
11
11
|
Object.defineProperty(exports, "Arca", { enumerable: true, get: function () { return arca_1.Arca; } });
|
|
@@ -54,6 +54,7 @@ Object.defineProperty(exports, "retentionMs", { enumerable: true, get: function
|
|
|
54
54
|
Object.defineProperty(exports, "alignDown", { enumerable: true, get: function () { return ladder_1.alignDown; } });
|
|
55
55
|
Object.defineProperty(exports, "alignUp", { enumerable: true, get: function () { return ladder_1.alignUp; } });
|
|
56
56
|
Object.defineProperty(exports, "boundaries", { enumerable: true, get: function () { return ladder_1.boundaries; } });
|
|
57
|
+
Object.defineProperty(exports, "expectedPointCount", { enumerable: true, get: function () { return ladder_1.expectedPointCount; } });
|
|
57
58
|
Object.defineProperty(exports, "promotionTarget", { enumerable: true, get: function () { return ladder_1.promotionTarget; } });
|
|
58
59
|
Object.defineProperty(exports, "ALL_RESOLUTIONS", { enumerable: true, get: function () { return ladder_1.ALL_RESOLUTIONS; } });
|
|
59
60
|
Object.defineProperty(exports, "DEFAULT_POINTS", { enumerable: true, get: function () { return ladder_1.DEFAULT_POINTS; } });
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,uBAAuB;AACvB,+BAAiD;AAAxC,4FAAA,IAAI,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAEhC,iCAAoC;AAA3B,kGAAA,SAAS,OAAA;AAClB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AAEzB,uDAAkE;AAAzD,mHAAA,eAAe,OAAA;AAAE,+GAAA,WAAW,OAAA;AACrC,qCAsBmB;AArBjB,+GAAA,oBAAoB,OAAA;AACpB,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,6GAAA,kBAAkB,OAAA;AAClB,iHAAA,sBAAsB,OAAA;AACtB,gHAAA,qBAAqB,OAAA;AACrB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,kHAAA,uBAAuB,OAAA;AACvB,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,wGAAA,aAAa,OAAA;AACb,4GAAA,iBAAiB,OAAA;AACjB,0GAAA,eAAe,OAAA;AACf,8GAAA,mBAAmB,OAAA;AACnB,2GAAA,gBAAgB,OAAA;AAChB,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,+GAAA,oBAAoB,OAAA;AACpB,6GAAA,kBAAkB,OAAA;AAClB,uHAAA,4BAA4B,OAAA;AAmU9B,wBAAwB;AACxB,iCAA2D;AAAlD,kGAAA,SAAS,OAAA;AAAE,gGAAA,OAAO,OAAA;AAAE,qGAAA,YAAY,OAAA;AAKzC,4DAA4D;AAC5D,2DAA2D;AAC3D,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/ladder.d.ts
CHANGED
|
@@ -31,8 +31,32 @@ export declare function pickResolution(rangeMs: number, targetPoints?: number):
|
|
|
31
31
|
export declare function alignDown(ts: number, r: Resolution): number;
|
|
32
32
|
/** Align ts up to the start-of-bucket boundary at-or-after t (UTC). */
|
|
33
33
|
export declare function alignUp(ts: number, r: Resolution): number;
|
|
34
|
-
/**
|
|
34
|
+
/**
|
|
35
|
+
* Enumerate the bucket timestamps the server will return for `[from, to]`.
|
|
36
|
+
*
|
|
37
|
+
* Both edges align DOWN, matching the backend's `projectToBuckets`
|
|
38
|
+
* (`startBucket = AlignDown(from)`, `endBucket = AlignDown(to)`), so the
|
|
39
|
+
* bucket *containing* `from` is included — a bucket is stamped with its
|
|
40
|
+
* start and covers `[ts, ts + bucket)`, so the one holding `from` is
|
|
41
|
+
* part of the requested window.
|
|
42
|
+
*
|
|
43
|
+
* This aligned the left edge UP until 2026-08-25, which under-counted by
|
|
44
|
+
* one for any `from` not exactly on a boundary — i.e. essentially every
|
|
45
|
+
* rolling window. `length` is therefore usable as the expected point
|
|
46
|
+
* count; equivalently `floor(to/b) - floor(from/b) + 1`.
|
|
47
|
+
*/
|
|
35
48
|
export declare function boundaries(from: number, to: number, r: Resolution): number[];
|
|
49
|
+
/**
|
|
50
|
+
* Expected number of points for a window at a given rung — the
|
|
51
|
+
* server-side count, without issuing the request.
|
|
52
|
+
*
|
|
53
|
+
* Use this instead of comparing array lengths when reconciling two
|
|
54
|
+
* sources for the same series. The ladder picks the finest rung whose
|
|
55
|
+
* bucket count fits the requested `points`, so asking for 180 points
|
|
56
|
+
* over 24h yields `15m` (~96), and a denser series is not a
|
|
57
|
+
* better-loaded one.
|
|
58
|
+
*/
|
|
59
|
+
export declare function expectedPointCount(from: number, to: number, r: Resolution): number;
|
|
36
60
|
/** Return the next-coarser rung above r, or null if r is the coarsest. */
|
|
37
61
|
export declare function promotionTarget(r: Resolution): Resolution | null;
|
|
38
62
|
/** Convenience: ladder selection from string ISO-8601 timestamps. */
|
package/dist/ladder.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ladder.d.ts","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1E,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,UAAU,CAQrD,CAAC;AAOF;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAiB9C;AAED;;6EAE6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CA0BjD;AAED,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAiB,GAAG,UAAU,CAUzF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAG3D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED
|
|
1
|
+
{"version":3,"file":"ladder.d.ts","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1E,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,UAAU,CAQrD,CAAC;AAOF;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAiB9C;AAED;;6EAE6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CA0BjD;AAED,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAiB,GAAG,UAAU,CAUzF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAG3D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAS5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAElF;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAIhE;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,SAAiB,GAC5B,UAAU,CAIZ"}
|
package/dist/ladder.js
CHANGED
|
@@ -19,6 +19,7 @@ exports.pickResolution = pickResolution;
|
|
|
19
19
|
exports.alignDown = alignDown;
|
|
20
20
|
exports.alignUp = alignUp;
|
|
21
21
|
exports.boundaries = boundaries;
|
|
22
|
+
exports.expectedPointCount = expectedPointCount;
|
|
22
23
|
exports.promotionTarget = promotionTarget;
|
|
23
24
|
exports.pickResolutionFromIso = pickResolutionFromIso;
|
|
24
25
|
exports.ALL_RESOLUTIONS = [
|
|
@@ -115,11 +116,24 @@ function alignUp(ts, r) {
|
|
|
115
116
|
const down = alignDown(ts, r);
|
|
116
117
|
return down === ts ? down : down + bucketMs(r);
|
|
117
118
|
}
|
|
118
|
-
/**
|
|
119
|
+
/**
|
|
120
|
+
* Enumerate the bucket timestamps the server will return for `[from, to]`.
|
|
121
|
+
*
|
|
122
|
+
* Both edges align DOWN, matching the backend's `projectToBuckets`
|
|
123
|
+
* (`startBucket = AlignDown(from)`, `endBucket = AlignDown(to)`), so the
|
|
124
|
+
* bucket *containing* `from` is included — a bucket is stamped with its
|
|
125
|
+
* start and covers `[ts, ts + bucket)`, so the one holding `from` is
|
|
126
|
+
* part of the requested window.
|
|
127
|
+
*
|
|
128
|
+
* This aligned the left edge UP until 2026-08-25, which under-counted by
|
|
129
|
+
* one for any `from` not exactly on a boundary — i.e. essentially every
|
|
130
|
+
* rolling window. `length` is therefore usable as the expected point
|
|
131
|
+
* count; equivalently `floor(to/b) - floor(from/b) + 1`.
|
|
132
|
+
*/
|
|
119
133
|
function boundaries(from, to, r) {
|
|
120
134
|
if (to <= from)
|
|
121
135
|
return [];
|
|
122
|
-
const start =
|
|
136
|
+
const start = alignDown(from, r);
|
|
123
137
|
const end = alignDown(to, r);
|
|
124
138
|
if (start > end)
|
|
125
139
|
return [];
|
|
@@ -129,6 +143,19 @@ function boundaries(from, to, r) {
|
|
|
129
143
|
out.push(cur);
|
|
130
144
|
return out;
|
|
131
145
|
}
|
|
146
|
+
/**
|
|
147
|
+
* Expected number of points for a window at a given rung — the
|
|
148
|
+
* server-side count, without issuing the request.
|
|
149
|
+
*
|
|
150
|
+
* Use this instead of comparing array lengths when reconciling two
|
|
151
|
+
* sources for the same series. The ladder picks the finest rung whose
|
|
152
|
+
* bucket count fits the requested `points`, so asking for 180 points
|
|
153
|
+
* over 24h yields `15m` (~96), and a denser series is not a
|
|
154
|
+
* better-loaded one.
|
|
155
|
+
*/
|
|
156
|
+
function expectedPointCount(from, to, r) {
|
|
157
|
+
return boundaries(from, to, r).length;
|
|
158
|
+
}
|
|
132
159
|
/** Return the next-coarser rung above r, or null if r is the coarsest. */
|
|
133
160
|
function promotionTarget(r) {
|
|
134
161
|
const idx = exports.ALL_RESOLUTIONS.indexOf(r);
|
package/dist/ladder.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ladder.js","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAqBH,4BAiBC;AAKD,kCA0BC;AAUD,wCAUC;AAGD,8BAGC;AAGD,0BAGC;
|
|
1
|
+
{"version":3,"file":"ladder.js","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"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"}
|
package/dist/ladder.test.js
CHANGED
|
@@ -49,11 +49,16 @@ const DAY = 24 * HOUR;
|
|
|
49
49
|
});
|
|
50
50
|
});
|
|
51
51
|
(0, vitest_1.describe)("ladder.boundaries", () => {
|
|
52
|
-
|
|
52
|
+
// Both edges align DOWN, matching the backend's projectToBuckets. An
|
|
53
|
+
// unaligned `from` must still yield the bucket that CONTAINS it —
|
|
54
|
+
// aligning the left edge up dropped that bucket and under-counted by
|
|
55
|
+
// one for every rolling window.
|
|
56
|
+
(0, vitest_1.it)("includes the bucket containing an unaligned from", () => {
|
|
53
57
|
const from = Date.parse("2026-04-26T17:23:14.000Z");
|
|
54
58
|
const to = from + 3 * HOUR;
|
|
55
59
|
const got = (0, ladder_1.boundaries)(from, to, "1h");
|
|
56
60
|
(0, vitest_1.expect)(got).toEqual([
|
|
61
|
+
Date.parse("2026-04-26T17:00:00.000Z"),
|
|
57
62
|
Date.parse("2026-04-26T18:00:00.000Z"),
|
|
58
63
|
Date.parse("2026-04-26T19:00:00.000Z"),
|
|
59
64
|
Date.parse("2026-04-26T20:00:00.000Z"),
|
|
@@ -64,6 +69,27 @@ const DAY = 24 * HOUR;
|
|
|
64
69
|
(0, vitest_1.expect)((0, ladder_1.boundaries)(t, t, "1h")).toEqual([]);
|
|
65
70
|
(0, vitest_1.expect)((0, ladder_1.boundaries)(t, t - HOUR, "1h")).toEqual([]);
|
|
66
71
|
});
|
|
72
|
+
(0, vitest_1.it)("matches the server's floor(to/b) - floor(from/b) + 1 count", () => {
|
|
73
|
+
const from = Date.parse("2026-04-26T17:23:14.000Z");
|
|
74
|
+
const to = from + 24 * HOUR;
|
|
75
|
+
for (const r of ["5m", "15m", "1h", "4h"]) {
|
|
76
|
+
const b = (0, ladder_1.bucketMs)(r);
|
|
77
|
+
const expected = Math.floor(to / b) - Math.floor(from / b) + 1;
|
|
78
|
+
(0, vitest_1.expect)((0, ladder_1.expectedPointCount)(from, to, r)).toBe(expected);
|
|
79
|
+
(0, vitest_1.expect)((0, ladder_1.boundaries)(from, to, r).length).toBe(expected);
|
|
80
|
+
}
|
|
81
|
+
});
|
|
82
|
+
(0, vitest_1.it)("a 24h window asking for 180 points is served at 15m, not 180 points", () => {
|
|
83
|
+
// The density trap Gobi hit: a client-side rebuild emitting exactly
|
|
84
|
+
// `points` samples always out-counts the server's ladder-quantized
|
|
85
|
+
// series, so "prefer whichever has more points" picks the fabricated
|
|
86
|
+
// one every time.
|
|
87
|
+
const from = Date.parse("2026-04-26T00:00:00.000Z");
|
|
88
|
+
const to = from + 24 * HOUR;
|
|
89
|
+
const r = (0, ladder_1.pickResolution)(to - from, 180);
|
|
90
|
+
(0, vitest_1.expect)(r).toBe("15m");
|
|
91
|
+
(0, vitest_1.expect)((0, ladder_1.expectedPointCount)(from, to, r)).toBe(97);
|
|
92
|
+
});
|
|
67
93
|
});
|
|
68
94
|
(0, vitest_1.describe)("ladder.alignment", () => {
|
|
69
95
|
(0, vitest_1.it)("alignDown truncates to bucket", () => {
|
package/dist/ladder.test.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ladder.test.js","sourceRoot":"","sources":["../src/ladder.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,
|
|
1
|
+
{"version":3,"file":"ladder.test.js","sourceRoot":"","sources":["../src/ladder.test.ts"],"names":[],"mappings":"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"}
|
package/dist/revalue.d.ts
CHANGED
|
@@ -3,6 +3,11 @@ type Mids = Record<string, string>;
|
|
|
3
3
|
/**
|
|
4
4
|
* Recompute all price-derived fields on an ObjectValuation using fresh mid prices.
|
|
5
5
|
* Static data (amounts, sizes, entry prices, paths) is preserved unchanged.
|
|
6
|
+
*
|
|
7
|
+
* Note `valueUsd` on a single object is NOT floored — Axiom 11 scopes the
|
|
8
|
+
* floor to aggregate equity, and a single object's true signed value is
|
|
9
|
+
* what operators need to diagnose a fault. The floor is applied where
|
|
10
|
+
* objects are summed (see `revalueAggregation`).
|
|
6
11
|
*/
|
|
7
12
|
export declare function revalueObject(obj: ObjectValuation, mids: Mids): ObjectValuation;
|
|
8
13
|
/**
|
package/dist/revalue.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"revalue.d.ts","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAA8C,aAAa,EAAiC,MAAM,SAAS,CAAC;AAE9K,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"revalue.d.ts","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAA8C,aAAa,EAAiC,MAAM,SAAS,CAAC;AAE9K,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8CnC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,GAAG,eAAe,CA0B/E;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAiB/F;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,CAmCpF"}
|
package/dist/revalue.js
CHANGED
|
@@ -29,9 +29,31 @@ function revalueReserved(r, mids) {
|
|
|
29
29
|
const price = Number(mid) || 1;
|
|
30
30
|
return { ...r, price: mid, valueUsd: String(amount * price) };
|
|
31
31
|
}
|
|
32
|
+
/**
|
|
33
|
+
* Axiom 11 aggregation floor: an observational (exchange) account
|
|
34
|
+
* contributes `max(0, value)` to aggregate equity.
|
|
35
|
+
*
|
|
36
|
+
* The server applies the same floor when it folds an aggregate, but the
|
|
37
|
+
* SDK recomputes exchange equity from cash plus position P&L on every
|
|
38
|
+
* mid tick — so without this the server's floor would be undone within
|
|
39
|
+
* about a second of arriving, on whichever tick came next.
|
|
40
|
+
*
|
|
41
|
+
* Exchange accounts are the one account class permitted to hold a
|
|
42
|
+
* negative balance: equity can legitimately go negative when unrealized
|
|
43
|
+
* loss exceeds margin, or while a liquidation fill is still in flight.
|
|
44
|
+
* The floor keeps that from surfacing as a negative aggregate.
|
|
45
|
+
*/
|
|
46
|
+
function floorAggregateContribution(value) {
|
|
47
|
+
return value < 0 ? 0 : value;
|
|
48
|
+
}
|
|
32
49
|
/**
|
|
33
50
|
* Recompute all price-derived fields on an ObjectValuation using fresh mid prices.
|
|
34
51
|
* Static data (amounts, sizes, entry prices, paths) is preserved unchanged.
|
|
52
|
+
*
|
|
53
|
+
* Note `valueUsd` on a single object is NOT floored — Axiom 11 scopes the
|
|
54
|
+
* floor to aggregate equity, and a single object's true signed value is
|
|
55
|
+
* what operators need to diagnose a fault. The floor is applied where
|
|
56
|
+
* objects are summed (see `revalueAggregation`).
|
|
35
57
|
*/
|
|
36
58
|
function revalueObject(obj, mids) {
|
|
37
59
|
if (obj.type === 'exchange') {
|
|
@@ -172,7 +194,11 @@ function revalueAggregation(agg, mids) {
|
|
|
172
194
|
}
|
|
173
195
|
return b;
|
|
174
196
|
});
|
|
175
|
-
|
|
197
|
+
// Axiom 11 aggregation floor. The server floors its own fold, but this
|
|
198
|
+
// function re-derives the total on every mid tick, so without the same
|
|
199
|
+
// floor here the server's value would be replaced by an unfloored one
|
|
200
|
+
// within about a second.
|
|
201
|
+
const totalEquity = floorAggregateContribution(newBreakdown.reduce((s, b) => s + (Number(b.valueUsd) || 0), 0));
|
|
176
202
|
return {
|
|
177
203
|
...agg,
|
|
178
204
|
totalEquityUsd: String(totalEquity),
|
package/dist/revalue.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"revalue.js","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"revalue.js","sourceRoot":"","sources":["../src/revalue.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -928,28 +928,38 @@ export interface PnlHistoryResponse {
|
|
|
928
928
|
prefix: string;
|
|
929
929
|
from: string;
|
|
930
930
|
to: string;
|
|
931
|
+
/** Number of points in `pnlPoints`. */
|
|
931
932
|
points: number;
|
|
933
|
+
/** Ladder rung the server actually served. */
|
|
932
934
|
resolution?: string;
|
|
935
|
+
/** Set only when the requested rung lacked coverage and the server
|
|
936
|
+
* promoted to a coarser one; this is the rung originally picked. */
|
|
933
937
|
resolutionRequested?: string;
|
|
938
|
+
/** Bucket width of `resolution`, in seconds. The grid is
|
|
939
|
+
* self-describing: point `i` covers `[ts, ts + bucketSeconds)`. */
|
|
940
|
+
bucketSeconds?: number;
|
|
934
941
|
serverNow?: string;
|
|
935
942
|
startingEquityUsd: string;
|
|
936
|
-
/** Timestamp of the first non-zero equity point (after leading-zero
|
|
937
|
-
* trimming). Use as `flowsSince` for the live watch to avoid
|
|
938
|
-
* double-counting flows already reflected in `startingEquityUsd`. */
|
|
939
|
-
effectiveFrom?: string;
|
|
940
943
|
pnlPoints: PnlPoint[];
|
|
941
944
|
externalFlows?: ExternalFlowEntry[];
|
|
942
945
|
midPrices?: Record<string, string>;
|
|
943
946
|
}
|
|
944
947
|
export interface PnlPoint {
|
|
945
948
|
timestamp: string;
|
|
949
|
+
/** Flow-adjusted P&L: external inflows/outflows removed, anchored at
|
|
950
|
+
* the first point. A deposit does not move this. */
|
|
946
951
|
pnlUsd: string;
|
|
952
|
+
/** Marked account value for this bucket, floored at zero — the same
|
|
953
|
+
* number `getEquityHistory` returns for the same bucket. Chart this
|
|
954
|
+
* (not `pnlUsd`) when you want "what is the account worth". */
|
|
947
955
|
equityUsd: string;
|
|
956
|
+
/** True signed value, present only when the zero floor clamped this
|
|
957
|
+
* point. `pnlUsd` is already derived from it. See
|
|
958
|
+
* {@link EquityPoint.unflooredEquityUsd}. */
|
|
959
|
+
unflooredEquityUsd?: string;
|
|
948
960
|
status?: ChartPointStatus;
|
|
949
961
|
cumInflowsUsd?: string;
|
|
950
962
|
cumOutflowsUsd?: string;
|
|
951
|
-
lastEventOpId?: string;
|
|
952
|
-
midSetId?: string;
|
|
953
963
|
/** Present when the chart is created with `anchor: 'equity'`.
|
|
954
964
|
* Equal to pnlUsd shifted so the live (rightmost) point equals current equity. */
|
|
955
965
|
valueUsd?: string;
|
|
@@ -958,21 +968,54 @@ export interface EquityHistoryResponse {
|
|
|
958
968
|
prefix: string;
|
|
959
969
|
from: string;
|
|
960
970
|
to: string;
|
|
971
|
+
/** Number of points in `equityPoints`. */
|
|
961
972
|
points: number;
|
|
973
|
+
/** Ladder rung the server actually served. The ladder picks the
|
|
974
|
+
* finest rung whose bucket count fits the requested `points`, so a
|
|
975
|
+
* 24h window at `points: 180` is served at `15m` (~96 points).
|
|
976
|
+
* Compare series by window and `resolution`, never by array length. */
|
|
962
977
|
resolution?: string;
|
|
978
|
+
/** Set only when the requested rung lacked coverage and the server
|
|
979
|
+
* promoted to a coarser one; this is the rung originally picked. */
|
|
963
980
|
resolutionRequested?: string;
|
|
981
|
+
/** Bucket width of `resolution`, in seconds. */
|
|
982
|
+
bucketSeconds?: number;
|
|
964
983
|
serverNow?: string;
|
|
965
984
|
equityPoints: EquityPoint[];
|
|
966
985
|
}
|
|
986
|
+
/**
|
|
987
|
+
* Provenance of a bucket's CASH side. This is not a marked/unmarked
|
|
988
|
+
* flag: every bucket is marked to that bucket's mids (see
|
|
989
|
+
* {@link EquityPoint.equityUsd}), so a `carried` point still changes
|
|
990
|
+
* value as the market moves.
|
|
991
|
+
*
|
|
992
|
+
* - `open` — the bucket contains the server's current instant; still filling.
|
|
993
|
+
* - `sealed` — boundary passed, ledger events applied, final.
|
|
994
|
+
* - `carried` — boundary passed, no ledger event landed, cash carried forward.
|
|
995
|
+
* - `incomplete` — an input was missing (no mid for a market, or the
|
|
996
|
+
* position overlay could not run). The value is provisional.
|
|
997
|
+
*/
|
|
967
998
|
export type ChartPointStatus = 'open' | 'sealed' | 'carried' | 'incomplete';
|
|
968
999
|
export interface EquityPoint {
|
|
969
1000
|
timestamp: string;
|
|
1001
|
+
/** Marked account value for this bucket: cash valued at the bucket's
|
|
1002
|
+
* own mids, plus unrealized P&L on every position open at that
|
|
1003
|
+
* bucket, valued at the same mids. Not settled-equity-carried-forward.
|
|
1004
|
+
*
|
|
1005
|
+
* Floored at zero. An exchange account is the one account class
|
|
1006
|
+
* permitted to hold a negative balance (unrealized loss exceeding
|
|
1007
|
+
* margin, or a liquidation fill still in flight), and a balance that
|
|
1008
|
+
* renders negative is worse than one that renders as zero. */
|
|
970
1009
|
equityUsd: string;
|
|
1010
|
+
/** True signed value, present ONLY when the zero floor clamped this
|
|
1011
|
+
* point — so its presence is also how you tell a floored point from a
|
|
1012
|
+
* genuinely-zero one. The floor never destroys the number: use this
|
|
1013
|
+
* to reconstruct the real change. `pnlUsd` on the P&L series is
|
|
1014
|
+
* already derived from it, so a real loss is never flattened. */
|
|
1015
|
+
unflooredEquityUsd?: string;
|
|
971
1016
|
status?: ChartPointStatus;
|
|
972
1017
|
cumInflowsUsd?: string;
|
|
973
1018
|
cumOutflowsUsd?: string;
|
|
974
|
-
lastEventOpId?: string;
|
|
975
|
-
midSetId?: string;
|
|
976
1019
|
}
|
|
977
1020
|
export interface ReconciliationState {
|
|
978
1021
|
id: ReconciliationId;
|
|
@@ -1537,6 +1580,8 @@ export declare const EventType: {
|
|
|
1537
1580
|
*/
|
|
1538
1581
|
readonly DepositDetected: "deposit.detected";
|
|
1539
1582
|
readonly ExchangeUpdated: "exchange.updated";
|
|
1583
|
+
readonly ExchangeProvisioned: "exchange.provisioned";
|
|
1584
|
+
readonly ExchangeReady: "exchange.ready";
|
|
1540
1585
|
/**
|
|
1541
1586
|
* Phase 1 of two-phase fill delivery: the instant, incomplete venue-level
|
|
1542
1587
|
* fill echo. `FillRecorded` (Phase 2) follows with the authoritative record;
|
|
@@ -1665,6 +1710,44 @@ export interface ExchangeUpdatedEvent extends BaseRealmEvent {
|
|
|
1665
1710
|
type: typeof EventType.ExchangeUpdated;
|
|
1666
1711
|
exchangeState: ExchangeState;
|
|
1667
1712
|
}
|
|
1713
|
+
/** What an exchange arca reports about its own provisioning. */
|
|
1714
|
+
export interface ExchangeProvisioningState {
|
|
1715
|
+
objectId: ObjectId;
|
|
1716
|
+
path?: string;
|
|
1717
|
+
/**
|
|
1718
|
+
* The boundary is cosign-armed, so the account exists but cannot trade until
|
|
1719
|
+
* the user co-signs the agent grant. Expect `exchange.ready` after they do.
|
|
1720
|
+
*/
|
|
1721
|
+
cosignRequired: boolean;
|
|
1722
|
+
/** The account can actually trade. Always true on `exchange.ready`. */
|
|
1723
|
+
tradable: boolean;
|
|
1724
|
+
/** The venue account address, once stamped. */
|
|
1725
|
+
accountAddress?: string;
|
|
1726
|
+
agentWalletId?: string;
|
|
1727
|
+
}
|
|
1728
|
+
/**
|
|
1729
|
+
* The exchange arca's venue account exists and its metadata is stamped, so it
|
|
1730
|
+
* stops answering 503 EXCHANGE_PROVISIONING.
|
|
1731
|
+
*
|
|
1732
|
+
* This does NOT mean it can trade. On a cosign-armed boundary the trading agent
|
|
1733
|
+
* still needs a user co-signature — `cosignRequired` says which case you are in,
|
|
1734
|
+
* and `exchange.ready` marks the account actually becoming tradable.
|
|
1735
|
+
*/
|
|
1736
|
+
export interface ExchangeProvisionedEvent extends BaseRealmEvent {
|
|
1737
|
+
type: typeof EventType.ExchangeProvisioned;
|
|
1738
|
+
exchange: ExchangeProvisioningState;
|
|
1739
|
+
}
|
|
1740
|
+
/**
|
|
1741
|
+
* The trading agent is registered on chain and the account can trade.
|
|
1742
|
+
*
|
|
1743
|
+
* On an unarmed boundary this follows `exchange.provisioned` immediately. On an
|
|
1744
|
+
* armed one it waits for the user's co-signed agent grant, which may be minutes
|
|
1745
|
+
* or days — so treat the gap as "waiting on the user", not as a stall.
|
|
1746
|
+
*/
|
|
1747
|
+
export interface ExchangeReadyEvent extends BaseRealmEvent {
|
|
1748
|
+
type: typeof EventType.ExchangeReady;
|
|
1749
|
+
exchange: ExchangeProvisioningState;
|
|
1750
|
+
}
|
|
1668
1751
|
export interface FillPreviewedEvent extends BaseRealmEvent {
|
|
1669
1752
|
type: typeof EventType.FillPreviewed;
|
|
1670
1753
|
fill: SimFill;
|
|
@@ -1873,7 +1956,7 @@ export interface AgentExecutionDoneEvent {
|
|
|
1873
1956
|
chatId: string;
|
|
1874
1957
|
}
|
|
1875
1958
|
export type AgentEvent = AgentTextEvent | AgentToolUseEvent | AgentPlanEvent | AgentConversationLogEvent | AgentDoneEvent | AgentStepUpdatedEvent | AgentExecutionDoneEvent;
|
|
1876
|
-
export type TypedRealmEvent = OperationCreatedEvent | OperationUpdatedEvent | EventCreatedEvent | ObjectCreatedEvent | ObjectUpdatedEvent | ObjectDeletedEvent | BalanceUpdatedEvent | ExchangeUpdatedEvent | FillPreviewedEvent | FillRecordedEvent | ExchangeFundingEvent | AggregationUpdatedEvent | ObjectValuationEvent | FrameEvent | MidsUpdatedEvent | CandleClosedEvent | CandleUpdatedEvent | OIUpdatedEvent | TradeExecutedEvent | RealmCreatedEvent | TwapStartedEvent | TwapProgressEvent | TwapCompletedEvent | TwapCancelledEvent | TwapFailedEvent;
|
|
1959
|
+
export type TypedRealmEvent = OperationCreatedEvent | OperationUpdatedEvent | EventCreatedEvent | ObjectCreatedEvent | ObjectUpdatedEvent | ObjectDeletedEvent | BalanceUpdatedEvent | ExchangeUpdatedEvent | ExchangeProvisionedEvent | ExchangeReadyEvent | FillPreviewedEvent | FillRecordedEvent | ExchangeFundingEvent | AggregationUpdatedEvent | ObjectValuationEvent | FrameEvent | MidsUpdatedEvent | CandleClosedEvent | CandleUpdatedEvent | OIUpdatedEvent | TradeExecutedEvent | RealmCreatedEvent | TwapStartedEvent | TwapProgressEvent | TwapCompletedEvent | TwapCancelledEvent | TwapFailedEvent;
|
|
1877
1960
|
/**
|
|
1878
1961
|
* Narrow a raw ``RealmEvent`` into a discriminated ``TypedRealmEvent``.
|
|
1879
1962
|
* Returns `undefined` if the event type is unrecognized or the payload
|
|
@@ -1893,6 +1976,7 @@ export interface RealmEvent {
|
|
|
1893
1976
|
object?: ArcaObject;
|
|
1894
1977
|
mids?: Record<string, string>;
|
|
1895
1978
|
exchangeState?: ExchangeState;
|
|
1979
|
+
exchange?: ExchangeProvisioningState;
|
|
1896
1980
|
valuation?: ObjectValuation;
|
|
1897
1981
|
balances?: ArcaBalance[];
|
|
1898
1982
|
heldOutbound?: ReservedBalance[];
|