@pod-network/trade-sdk 0.12.0 → 0.13.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/codec/fixed.d.ts +2 -0
- package/dist/codec/fixed.d.ts.map +1 -1
- package/dist/codec/fixed.js +2 -0
- package/dist/codec/fixed.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/sync/order-preview.d.ts +23 -1
- package/dist/sync/order-preview.d.ts.map +1 -1
- package/dist/sync/order-preview.js +36 -1
- package/dist/sync/order-preview.js.map +1 -1
- package/package.json +1 -1
- package/src/codec/fixed.ts +3 -0
- package/src/index.ts +1 -0
- package/src/sync/order-preview.ts +56 -2
package/dist/codec/fixed.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
/** `Math.min` for bigints, which it rejects. */
|
|
2
|
+
export declare const min: (a: bigint, b: bigint) => bigint;
|
|
1
3
|
/** Decimal `*`: (a*b)/1e18 truncated toward zero. */
|
|
2
4
|
export declare function mul(a: bigint, b: bigint): bigint;
|
|
3
5
|
/** Decimal `/`: (a*1e18)/b truncated toward zero. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fixed.d.ts","sourceRoot":"","sources":["../../src/codec/fixed.ts"],"names":[],"mappings":"AAOA,qDAAqD;AACrD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,qDAAqD;AACrD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElD"}
|
|
1
|
+
{"version":3,"file":"fixed.d.ts","sourceRoot":"","sources":["../../src/codec/fixed.ts"],"names":[],"mappings":"AAOA,gDAAgD;AAChD,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,WAAoB,CAAC;AAE7D,qDAAqD;AACrD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,qDAAqD;AACrD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElD"}
|
package/dist/codec/fixed.js
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
// by the account-math replications so they all round identically.
|
|
3
3
|
import { WAD } from "./units.js";
|
|
4
4
|
const absB = (x) => (x < 0n ? -x : x);
|
|
5
|
+
/** `Math.min` for bigints, which it rejects. */
|
|
6
|
+
export const min = (a, b) => (a < b ? a : b);
|
|
5
7
|
/** Decimal `*`: (a*b)/1e18 truncated toward zero. */
|
|
6
8
|
export function mul(a, b) {
|
|
7
9
|
const n = a * b;
|
package/dist/codec/fixed.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fixed.js","sourceRoot":"","sources":["../../src/codec/fixed.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kEAAkE;AAElE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9C,qDAAqD;AACrD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAClB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACxD,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,gBAAgB;IACpD,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,MAAM,CAAC,WAAmB;IACxC,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}
|
|
1
|
+
{"version":3,"file":"fixed.js","sourceRoot":"","sources":["../../src/codec/fixed.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kEAAkE;AAElE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9C,gDAAgD;AAChD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,qDAAqD;AACrD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAClB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACxD,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,gBAAgB;IACpD,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,MAAM,CAAC,WAAmB;IACxC,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -9,7 +9,7 @@ export type { Resource, Snapshot, SnapshotStore } from "./stores/resource.js";
|
|
|
9
9
|
export { combineResources, derivedResource } from "./stores/resource.js";
|
|
10
10
|
export { enrichPositions } from "./sync/positions-live.js";
|
|
11
11
|
export { accountMetrics, type AccountMetrics, perpPositionTotals, type PerpPositionTotals, } from "./sync/account-metrics.js";
|
|
12
|
-
export { previewOrder, type OrderPreview, type OrderPreviewInput, closePreview, type ClosePreview, priceForReturn, type ReturnPriceInput, closestTriggers, } from "./sync/order-preview.js";
|
|
12
|
+
export { previewOrder, type OrderPreview, type OrderPreviewInput, closePreview, type ClosePreview, priceForReturn, type ReturnPriceInput, closestTriggers, estimateFill, type FillEstimate, } from "./sync/order-preview.js";
|
|
13
13
|
export type { SeriesResource } from "./sync/candles.js";
|
|
14
14
|
export { CandleSeries } from "./sync/candles.js";
|
|
15
15
|
export { OrderHistory } from "./sync/orders.js";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAC5E,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAChF,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EACV,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EACzE,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,cAAc,EAAE,KAAK,cAAc,EACnC,kBAAkB,EAAE,KAAK,kBAAkB,GAC5C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EACvD,YAAY,EAAE,KAAK,YAAY,EAC/B,cAAc,EAAE,KAAK,gBAAgB,EACrC,eAAe,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAC5E,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAChF,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EACV,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EACzE,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,cAAc,EAAE,KAAK,cAAc,EACnC,kBAAkB,EAAE,KAAK,kBAAkB,GAC5C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EACvD,YAAY,EAAE,KAAK,YAAY,EAC/B,cAAc,EAAE,KAAK,gBAAgB,EACrC,eAAe,EACf,YAAY,EAAE,KAAK,YAAY,GAChC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAClD,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,GAChG,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EACjF,GAAG,EAAE,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,GACvE,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAChE,eAAe,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,cAAc,GAC7E,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACxD,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAC7D,KAAK,YAAY,EAAE,KAAK,kBAAkB,GAC3C,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -6,7 +6,7 @@ export { PodWsClient, PodSubscriptionClosedError } from "./transport/ws.js";
|
|
|
6
6
|
export { combineResources, derivedResource } from "./stores/resource.js";
|
|
7
7
|
export { enrichPositions } from "./sync/positions-live.js";
|
|
8
8
|
export { accountMetrics, perpPositionTotals, } from "./sync/account-metrics.js";
|
|
9
|
-
export { previewOrder, closePreview, priceForReturn, closestTriggers, } from "./sync/order-preview.js";
|
|
9
|
+
export { previewOrder, closePreview, priceForReturn, closestTriggers, estimateFill, } from "./sync/order-preview.js";
|
|
10
10
|
export { CandleSeries } from "./sync/candles.js";
|
|
11
11
|
export { OrderHistory } from "./sync/orders.js";
|
|
12
12
|
export { ActivityHistory } from "./sync/activity.js";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMlE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAQ5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMlE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAQ5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,eAAe,EAAE,gBAAgB,EAAE,eAAe,GAEnD,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,oBAAoB;AACpB,cAAc,mBAAmB,CAAC;AAElC,gBAAgB;AAChB,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EACjF,GAAG,EAAE,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,GACvE,MAAM,uBAAuB,CAAC;AAE/B,2EAA2E;AAC3E,2DAA2D;AAC3D,OAAO,EACL,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAChE,eAAe,EAAE,mBAAmB,EAA0B,cAAc,GAC7E,MAAM,mBAAmB,CAAC;AAC3B,+CAA+C;AAC/C,OAAO,EACL,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,GAGzD,MAAM,sBAAsB,CAAC"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Market, PerpPosition, PositionsSnapshot, Trigger } from "../types/public.js";
|
|
1
|
+
import type { Market, Orderbook, PerpPosition, PositionsSnapshot, Trigger } from "../types/public.js";
|
|
2
2
|
export interface ReturnPriceInput {
|
|
3
3
|
entryPrice: bigint;
|
|
4
4
|
/** Position leverage (notional / initial margin). */
|
|
@@ -77,4 +77,26 @@ export declare function closePreview(position: PerpPosition, input: {
|
|
|
77
77
|
price: bigint;
|
|
78
78
|
feeRate?: bigint;
|
|
79
79
|
}): ClosePreview;
|
|
80
|
+
export interface FillEstimate {
|
|
81
|
+
/** Base size the book fills within `limit` (≤ `size`). */
|
|
82
|
+
filled: bigint;
|
|
83
|
+
/** The price the whole fill clears at were this the batch's only order;
|
|
84
|
+
* undefined when nothing fills. A batch clears every match at one price and
|
|
85
|
+
* a market order never sets it, so this is at least the last level reached —
|
|
86
|
+
* not an average across the levels. */
|
|
87
|
+
price?: bigint;
|
|
88
|
+
/** How much worse `price` is than the best level, in percent — the cost of
|
|
89
|
+
* the size alone, spread excluded. */
|
|
90
|
+
slippagePct?: number;
|
|
91
|
+
/** The walk ran off the last level given while still inside `limit`. On a
|
|
92
|
+
* depth-truncated book `filled` is then a floor, not an estimate. */
|
|
93
|
+
exhausted: boolean;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* What a taker order of `size` (base, magnitude) would fill against `book`:
|
|
97
|
+
* walks the opposite side best-first — asks for a long, bids for a short — and
|
|
98
|
+
* stops at `limit`, a market order's protective price. Grouped levels make the
|
|
99
|
+
* prices approximate to the grouping.
|
|
100
|
+
*/
|
|
101
|
+
export declare function estimateFill(book: Pick<Orderbook, "bids" | "asks">, side: "long" | "short", size: bigint, limit?: bigint): FillEstimate;
|
|
80
102
|
//# sourceMappingURL=order-preview.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"order-preview.d.ts","sourceRoot":"","sources":["../../src/sync/order-preview.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"order-preview.d.ts","sourceRoot":"","sources":["../../src/sync/order-preview.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItG,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,OAAO,EACtB,QAAQ,EAAE,OAAO,EAAE,GAClB;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAY9C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB;6EACyE;IACzE,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb;qFACiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB;8DAC0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA4DD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,YAAY,CAiCd;AAED,MAAM,WAAW,YAAY;IAC3B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,YAAY,CAWd;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf;;;2CAGuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;0CACsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;yEACqE;IACrE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,EACtC,IAAI,EAAE,MAAM,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,CAyBd"}
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
// max_notional = available_margin / initial_margin_rate (≈ available · max_leverage)
|
|
8
8
|
// implied_leverage = (Σ current perp notional + notional) / perps_equity
|
|
9
9
|
// liquidation = mark where equity falls to Σ maintenance margin (im/2)
|
|
10
|
-
import { div, imRate, mul } from "../codec/fixed.js";
|
|
10
|
+
import { div, imRate, min, mul } from "../codec/fixed.js";
|
|
11
11
|
import { alignSize, parseAmount, toNumber, WAD } from "../codec/units.js";
|
|
12
12
|
/**
|
|
13
13
|
* Mark price at which a perp position reaches `returnPct` return **on its
|
|
@@ -143,4 +143,39 @@ export function closePreview(position, input) {
|
|
|
143
143
|
fee: mul(notional, input.feeRate ?? 0n),
|
|
144
144
|
};
|
|
145
145
|
}
|
|
146
|
+
/**
|
|
147
|
+
* What a taker order of `size` (base, magnitude) would fill against `book`:
|
|
148
|
+
* walks the opposite side best-first — asks for a long, bids for a short — and
|
|
149
|
+
* stops at `limit`, a market order's protective price. Grouped levels make the
|
|
150
|
+
* prices approximate to the grouping.
|
|
151
|
+
*/
|
|
152
|
+
export function estimateFill(book, side, size, limit) {
|
|
153
|
+
const levels = side === "long" ? book.asks : book.bids;
|
|
154
|
+
const within = (p) => limit === undefined || (side === "long" ? p <= limit : p >= limit);
|
|
155
|
+
let filled = 0n;
|
|
156
|
+
let left = 0n; // volume the last level reached still holds
|
|
157
|
+
let i = 0;
|
|
158
|
+
for (; i < levels.length && filled < size; i++) {
|
|
159
|
+
const l = levels[i];
|
|
160
|
+
if (!within(l.price))
|
|
161
|
+
break;
|
|
162
|
+
const take = min(l.volume, size - filled);
|
|
163
|
+
filled += take;
|
|
164
|
+
left = l.volume - take;
|
|
165
|
+
}
|
|
166
|
+
const exhausted = filled < size && i === levels.length;
|
|
167
|
+
if (filled === 0n)
|
|
168
|
+
return { filled, exhausted };
|
|
169
|
+
// The clearing range runs from the last level matched to the first level left
|
|
170
|
+
// unmatched — that same level when only part of it was taken — and settles at
|
|
171
|
+
// its midpoint, never past the order's own limit (doc/protocol/orderbook.md, Clearing).
|
|
172
|
+
const last = levels[i - 1].price;
|
|
173
|
+
const unmatched = left > 0n ? last : levels[i]?.price;
|
|
174
|
+
let price = unmatched === undefined ? last : (last + unmatched) / 2n;
|
|
175
|
+
if (limit !== undefined && !within(price))
|
|
176
|
+
price = limit;
|
|
177
|
+
const best = levels[0].price;
|
|
178
|
+
const worse = side === "long" ? price - best : best - price;
|
|
179
|
+
return { filled, price, slippagePct: (Number(worse) / Number(best)) * 100, exhausted };
|
|
180
|
+
}
|
|
146
181
|
//# sourceMappingURL=order-preview.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"order-preview.js","sourceRoot":"","sources":["../../src/sync/order-preview.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,EAAE;AACF,4CAA4C;AAC5C,qFAAqF;AACrF,iFAAiF;AACjF,2FAA2F;AAC3F,2EAA2E;AAC3E,8EAA8E;AAG9E,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"order-preview.js","sourceRoot":"","sources":["../../src/sync/order-preview.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pod-network/trade-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"description": "Read/stream TypeScript SDK for the pod trading indexer: cacheable REST seeds + one multiplexed WebSocket, kept in memory. Framework-agnostic.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
package/src/codec/fixed.ts
CHANGED
|
@@ -5,6 +5,9 @@ import { WAD } from "./units.js";
|
|
|
5
5
|
|
|
6
6
|
const absB = (x: bigint) => (x < 0n ? -x : x);
|
|
7
7
|
|
|
8
|
+
/** `Math.min` for bigints, which it rejects. */
|
|
9
|
+
export const min = (a: bigint, b: bigint) => (a < b ? a : b);
|
|
10
|
+
|
|
8
11
|
/** Decimal `*`: (a*b)/1e18 truncated toward zero. */
|
|
9
12
|
export function mul(a: bigint, b: bigint): bigint {
|
|
10
13
|
const n = a * b;
|
package/src/index.ts
CHANGED
|
@@ -30,6 +30,7 @@ export {
|
|
|
30
30
|
closePreview, type ClosePreview,
|
|
31
31
|
priceForReturn, type ReturnPriceInput,
|
|
32
32
|
closestTriggers,
|
|
33
|
+
estimateFill, type FillEstimate,
|
|
33
34
|
} from "./sync/order-preview.js";
|
|
34
35
|
export type { SeriesResource } from "./sync/candles.js";
|
|
35
36
|
export { CandleSeries } from "./sync/candles.js";
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
// implied_leverage = (Σ current perp notional + notional) / perps_equity
|
|
9
9
|
// liquidation = mark where equity falls to Σ maintenance margin (im/2)
|
|
10
10
|
|
|
11
|
-
import type { Market, PerpPosition, PositionsSnapshot, Trigger } from "../types/public.js";
|
|
12
|
-
import { div, imRate, mul } from "../codec/fixed.js";
|
|
11
|
+
import type { Market, Orderbook, PerpPosition, PositionsSnapshot, Trigger } from "../types/public.js";
|
|
12
|
+
import { div, imRate, min, mul } from "../codec/fixed.js";
|
|
13
13
|
import { alignSize, parseAmount, toNumber, WAD } from "../codec/units.js";
|
|
14
14
|
|
|
15
15
|
export interface ReturnPriceInput {
|
|
@@ -220,3 +220,57 @@ export function closePreview(
|
|
|
220
220
|
fee: mul(notional, input.feeRate ?? 0n),
|
|
221
221
|
};
|
|
222
222
|
}
|
|
223
|
+
|
|
224
|
+
export interface FillEstimate {
|
|
225
|
+
/** Base size the book fills within `limit` (≤ `size`). */
|
|
226
|
+
filled: bigint;
|
|
227
|
+
/** The price the whole fill clears at were this the batch's only order;
|
|
228
|
+
* undefined when nothing fills. A batch clears every match at one price and
|
|
229
|
+
* a market order never sets it, so this is at least the last level reached —
|
|
230
|
+
* not an average across the levels. */
|
|
231
|
+
price?: bigint;
|
|
232
|
+
/** How much worse `price` is than the best level, in percent — the cost of
|
|
233
|
+
* the size alone, spread excluded. */
|
|
234
|
+
slippagePct?: number;
|
|
235
|
+
/** The walk ran off the last level given while still inside `limit`. On a
|
|
236
|
+
* depth-truncated book `filled` is then a floor, not an estimate. */
|
|
237
|
+
exhausted: boolean;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* What a taker order of `size` (base, magnitude) would fill against `book`:
|
|
242
|
+
* walks the opposite side best-first — asks for a long, bids for a short — and
|
|
243
|
+
* stops at `limit`, a market order's protective price. Grouped levels make the
|
|
244
|
+
* prices approximate to the grouping.
|
|
245
|
+
*/
|
|
246
|
+
export function estimateFill(
|
|
247
|
+
book: Pick<Orderbook, "bids" | "asks">,
|
|
248
|
+
side: "long" | "short",
|
|
249
|
+
size: bigint,
|
|
250
|
+
limit?: bigint,
|
|
251
|
+
): FillEstimate {
|
|
252
|
+
const levels = side === "long" ? book.asks : book.bids;
|
|
253
|
+
const within = (p: bigint) => limit === undefined || (side === "long" ? p <= limit : p >= limit);
|
|
254
|
+
let filled = 0n;
|
|
255
|
+
let left = 0n; // volume the last level reached still holds
|
|
256
|
+
let i = 0;
|
|
257
|
+
for (; i < levels.length && filled < size; i++) {
|
|
258
|
+
const l = levels[i]!;
|
|
259
|
+
if (!within(l.price)) break;
|
|
260
|
+
const take = min(l.volume, size - filled);
|
|
261
|
+
filled += take;
|
|
262
|
+
left = l.volume - take;
|
|
263
|
+
}
|
|
264
|
+
const exhausted = filled < size && i === levels.length;
|
|
265
|
+
if (filled === 0n) return { filled, exhausted };
|
|
266
|
+
// The clearing range runs from the last level matched to the first level left
|
|
267
|
+
// unmatched — that same level when only part of it was taken — and settles at
|
|
268
|
+
// its midpoint, never past the order's own limit (doc/protocol/orderbook.md, Clearing).
|
|
269
|
+
const last = levels[i - 1]!.price;
|
|
270
|
+
const unmatched = left > 0n ? last : levels[i]?.price;
|
|
271
|
+
let price = unmatched === undefined ? last : (last + unmatched) / 2n;
|
|
272
|
+
if (limit !== undefined && !within(price)) price = limit;
|
|
273
|
+
const best = levels[0]!.price;
|
|
274
|
+
const worse = side === "long" ? price - best : best - price;
|
|
275
|
+
return { filled, price, slippagePct: (Number(worse) / Number(best)) * 100, exhausted };
|
|
276
|
+
}
|