@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.
@@ -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"}
@@ -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;
@@ -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";
@@ -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,GAChB,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"}
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,GAChB,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
+ {"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;AAI3F,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"}
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":"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"}
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.12.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,
@@ -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
+ }