@lifi/perps-sdk 24.0.0 → 25.0.0

package/dist/esm/utils/warnOnce.js

@@ -27,27 +27,39 @@ export const createWarnOnce = () => {
     };
 };
 const MAX_VALUE_CHARS = 64;
+/**
+ * Cut venue text to a fixed length, so a warner key or message built from it
+ * stays small.
+ *
+ * @internal
+ */
+export const cutVenueText = (value) => {
+    const text = String(value);
+    return text.length > MAX_VALUE_CHARS
+        ? `${text.slice(0, MAX_VALUE_CHARS)}…`
+        : text;
+};
 /**
  * Describe a skipped venue row. The venue value is cut to a fixed length, so
  * a warner key built from the text stays small.
  *
  * @internal
  */
-export const skippedRowMessage = (source, row, field, value, expected) => {
-    const text = String(value);
-    const shown = text.length > MAX_VALUE_CHARS ? `${text.slice(0, MAX_VALUE_CHARS)}…` : text;
-    return `[${source}] skipping ${row} row: \`${field}\` is not a valid ${expected}: '${shown}'`;
+export const skippedRowMessage = (source, row, field, value, expected, marketId) => {
+    const market = marketId === undefined ? '' : ` on market '${marketId}'`;
+    return `[${source}] skipping ${row} row${market}: \`${field}\` is not a valid ${expected}: '${cutVenueText(value)}'`;
 };
 const warnSkippedRowOnce = createWarnOnce();
 /**
- * Warn once for each provider, row, field and expected kind that a provider
- * mapper skipped a venue row because a required field is not valid. The key
- * holds no venue value, so a second bad value for the same field stays silent.
+ * Warn once for each provider, row, field, expected kind and market that a
+ * provider mapper skipped a venue row because a required field is not valid.
+ * The key holds no venue value, so a second bad value for the same field on
+ * the same market stays silent.
  *
- * @param expected - What the field must be. Defaults to `'decimal'`.
+ * @param options.expected - What the field must be. Defaults to `'decimal'`.
  * @internal
  */
-export const warnSkippedVenueRow = (provider, row, field, value, expected = 'decimal') => {
-    warnSkippedRowOnce(`${provider}|${row}|${field}|${expected}`, skippedRowMessage(provider, row, field, value, expected));
+export const warnSkippedVenueRow = (provider, row, field, value, { marketId, expected = 'decimal', } = {}) => {
+    warnSkippedRowOnce(`${provider}|${row}|${field}|${expected}|${marketId ?? ''}`, skippedRowMessage(provider, row, field, value, expected, marketId));
 };
 //# sourceMappingURL=warnOnce.js.map

package/dist/esm/utils/warnOnce.js.map

@@ -1 +1 @@
-{"version":3,"file":"warnOnce.js","sourceRoot":"","sources":["../../../src/utils/warnOnce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA6C,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YACzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,EAAE,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,GAAW,EACX,KAAa,EACb,KAAc,EACd,QAAgB,EACR,EAAE;IACV,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7E,OAAO,IAAI,MAAM,cAAc,GAAG,WAAW,KAAK,qBAAqB,QAAQ,MAAM,KAAK,GAAG,CAAA;AAC/F,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAgB,EAChB,GAAW,EACX,KAAa,EACb,KAAc,EACd,QAAQ,GAAG,SAAS,EACd,EAAE;IACR,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,IAAI,KAAK,IAAI,QAAQ,EAAE,EACzC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CACzD,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"warnOnce.js","sourceRoot":"","sources":["../../../src/utils/warnOnce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA6C,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YACzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,EAAE,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAU,EAAE;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,OAAO,IAAI,CAAC,MAAM,GAAG,eAAe;QAClC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG;QACtC,CAAC,CAAC,IAAI,CAAA;AACV,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,GAAW,EACX,KAAa,EACb,KAAc,EACd,QAAgB,EAChB,QAAiB,EACT,EAAE;IACV,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,QAAQ,GAAG,CAAA;IACvE,OAAO,IAAI,MAAM,cAAc,GAAG,OAAO,MAAM,OAAO,KAAK,qBAAqB,QAAQ,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAA;AACtH,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAgB,EAChB,GAAW,EACX,KAAa,EACb,KAAc,EACd,EACE,QAAQ,EACR,QAAQ,GAAG,SAAS,MACwB,EAAE,EAC1C,EAAE;IACR,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,IAAI,KAAK,IAAI,QAAQ,IAAI,QAAQ,IAAI,EAAE,EAAE,EAC3D,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CACnE,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/version.d.ts

@@ -9,5 +9,5 @@ export declare const name = "@lifi/perps-sdk";
  *
  * @public
  */
-export declare const version = "24.0.0";
+export declare const version = "25.0.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/version.js

@@ -9,5 +9,5 @@ export const name = '@lifi/perps-sdk';
  *
  * @public
  */
-export const version = '24.0.0';
+export const version = '25.0.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/websocket/wsLog.d.ts

@@ -38,14 +38,14 @@ export declare const wsLog: {
     readonly unknownMarket: (provider: string, marketId: string) => void;
     /**
      * A frame row or order-book level with a required field that is not valid.
-     * Only that row is skipped. Logged once at `warn` for each provider, row and
-     * field; the key holds no venue value.
+     * Only that row is skipped. Logged once at `warn` for each provider, row,
+     * field and market; the key holds no venue value.
      */
-    readonly skippedRow: (provider: string, row: string, field: string, value: unknown) => void;
+    readonly skippedRow: (provider: string, row: string, field: string, value: unknown, marketId?: string) => void;
     /**
      * A frame row the mapper rejected for a reason other than one field, such as
      * a lifecycle state the SDK does not carry. Logged once at `warn` for each
-     * provider and row; the key holds no venue value.
+     * provider, row and reason; the reason is cut to a fixed length.
      */
     readonly droppedRow: (provider: string, row: string, reason: string) => void;
     /**

package/dist/esm/websocket/wsLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wsLog.d.ts","sourceRoot":"","sources":["../../../src/websocket/wsLog.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;IAChB;;;OAGG;sCACoB,MAAM,OAAO,MAAM,KAAG,IAAI;IAGjD;;;;OAIG;wCACsB,MAAM,SAAS,OAAO,KAAG,IAAI;IAGtD;;;;;OAKG;qCACmB,MAAM,WAAW,MAAM,KAAG,IAAI;IAGpD;;;;OAIG;0CACwB,MAAM,WAAW,MAAM,SAAS,OAAO,KAAG,IAAI;IAMzE;;;;OAIG;uCACqB,MAAM,YAAY,MAAM,KAAG,IAAI;IAKvD;;;;OAIG;oCAES,MAAM,OACX,MAAM,SACJ,MAAM,SACN,OAAO,KACb,IAAI;IAMP;;;;OAIG;oCACkB,MAAM,OAAO,MAAM,UAAU,MAAM,KAAG,IAAI;IAM/D;;;OAGG;8CAC4B,MAAM,SAAS,OAAO,KAAG,IAAI;IAG5D;;;OAGG;yCAES,MAAM,gBACF,MAAM,SACb,OAAO,KACb,IAAI;CAMC,CAAA"}
+{"version":3,"file":"wsLog.d.ts","sourceRoot":"","sources":["../../../src/websocket/wsLog.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;IAChB;;;OAGG;sCACoB,MAAM,OAAO,MAAM,KAAG,IAAI;IAGjD;;;;OAIG;wCACsB,MAAM,SAAS,OAAO,KAAG,IAAI;IAGtD;;;;;OAKG;qCACmB,MAAM,WAAW,MAAM,KAAG,IAAI;IAGpD;;;;OAIG;0CACwB,MAAM,WAAW,MAAM,SAAS,OAAO,KAAG,IAAI;IAMzE;;;;OAIG;uCACqB,MAAM,YAAY,MAAM,KAAG,IAAI;IAKvD;;;;OAIG;oCAES,MAAM,OACX,MAAM,SACJ,MAAM,SACN,OAAO,aACH,MAAM,KAChB,IAAI;IAaP;;;;OAIG;oCACkB,MAAM,OAAO,MAAM,UAAU,MAAM,KAAG,IAAI;IAO/D;;;OAGG;8CAC4B,MAAM,SAAS,OAAO,KAAG,IAAI;IAG5D;;;OAGG;yCAES,MAAM,gBACF,MAAM,SACb,OAAO,KACb,IAAI;CAMC,CAAA"}

package/dist/esm/websocket/wsLog.js

@@ -1,4 +1,4 @@
-import { createWarnOnce, skippedRowMessage } from '../utils/warnOnce.js';
+import { createWarnOnce, cutVenueText, skippedRowMessage, } from '../utils/warnOnce.js';
 const MAX_PAYLOAD_CHARS = 512;
 const truncate = (raw) => raw.length > MAX_PAYLOAD_CHARS
     ? `${raw.slice(0, MAX_PAYLOAD_CHARS)}…(${raw.length} chars)`
@@ -54,19 +54,20 @@ export const wsLog = {
     },
     /**
      * A frame row or order-book level with a required field that is not valid.
-     * Only that row is skipped. Logged once at `warn` for each provider, row and
-     * field; the key holds no venue value.
+     * Only that row is skipped. Logged once at `warn` for each provider, row,
+     * field and market; the key holds no venue value.
      */
-    skippedRow(provider, row, field, value) {
-        warnSkippedRowOnce(`${provider}|${row}|${field}`, skippedRowMessage(`${provider}:ws`, row, field, value, 'decimal'));
+    skippedRow(provider, row, field, value, marketId) {
+        warnSkippedRowOnce(`${provider}|${row}|${field}|${marketId ?? ''}`, skippedRowMessage(`${provider}:ws`, row, field, value, 'decimal', marketId));
     },
     /**
      * A frame row the mapper rejected for a reason other than one field, such as
      * a lifecycle state the SDK does not carry. Logged once at `warn` for each
-     * provider and row; the key holds no venue value.
+     * provider, row and reason; the reason is cut to a fixed length.
      */
     droppedRow(provider, row, reason) {
-        warnSkippedRowOnce(`${provider}|${row}|dropped`, `[${provider}:ws] skipping ${row} row: ${reason}`);
+        const shown = cutVenueText(reason);
+        warnSkippedRowOnce(`${provider}|${row}|dropped|${shown}`, `[${provider}:ws] skipping ${row} row: ${shown}`);
     },
     /**
      * A background market-registry refetch rejected. Unknown-market items keep

package/dist/esm/websocket/wsLog.js.map

@@ -1 +1 @@
-{"version":3,"file":"wsLog.js","sourceRoot":"","sources":["../../../src/websocket/wsLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExE,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CACvC,GAAG,CAAC,MAAM,GAAG,iBAAiB;IAC5B,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,KAAK,GAAG,CAAC,MAAM,SAAS;IAC5D,CAAC,CAAC,GAAG,CAAA;AAET,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;;OAGG;IACH,YAAY,CAAC,QAAgB,EAAE,GAAW;QACxC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,iCAAiC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5E,CAAC;IACD;;;;OAIG;IACH,cAAc,CAAC,QAAgB,EAAE,KAAc;QAC7C,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,4BAA4B,EAAE,KAAK,CAAC,CAAA;IAChE,CAAC;IACD;;;;;OAKG;IACH,WAAW,CAAC,QAAgB,EAAE,OAAe;QAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mBAAmB,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IACD;;;;OAIG;IACH,gBAAgB,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAc;QAChE,OAAO,CAAC,KAAK,CACX,IAAI,QAAQ,wCAAwC,OAAO,0DAA0D,EACrH,KAAK,CACN,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAC,QAAgB,EAAE,QAAgB;QAC9C,OAAO,CAAC,IAAI,CACV,IAAI,QAAQ,0CAA0C,QAAQ,GAAG,CAClE,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,UAAU,CACR,QAAgB,EAChB,GAAW,EACX,KAAa,EACb,KAAc;QAEd,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,IAAI,KAAK,EAAE,EAC7B,iBAAiB,CAAC,GAAG,QAAQ,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAClE,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,UAAU,CAAC,QAAgB,EAAE,GAAW,EAAE,MAAc;QACtD,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,UAAU,EAC5B,IAAI,QAAQ,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAClD,CAAA;IACH,CAAC;IACD;;;OAGG;IACH,oBAAoB,CAAC,QAAgB,EAAE,KAAc;QACnD,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,qCAAqC,EAAE,KAAK,CAAC,CAAA;IACxE,CAAC;IACD;;;OAGG;IACH,eAAe,CACb,QAAgB,EAChB,YAAoB,EACpB,KAAc;QAEd,OAAO,CAAC,KAAK,CACX,IAAI,QAAQ,+BAA+B,YAAY,WAAW,EAClE,KAAK,CACN,CAAA;IACH,CAAC;CACO,CAAA"}
+{"version":3,"file":"wsLog.js","sourceRoot":"","sources":["../../../src/websocket/wsLog.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CACvC,GAAG,CAAC,MAAM,GAAG,iBAAiB;IAC5B,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,KAAK,GAAG,CAAC,MAAM,SAAS;IAC5D,CAAC,CAAC,GAAG,CAAA;AAET,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;;OAGG;IACH,YAAY,CAAC,QAAgB,EAAE,GAAW;QACxC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,iCAAiC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5E,CAAC;IACD;;;;OAIG;IACH,cAAc,CAAC,QAAgB,EAAE,KAAc;QAC7C,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,4BAA4B,EAAE,KAAK,CAAC,CAAA;IAChE,CAAC;IACD;;;;;OAKG;IACH,WAAW,CAAC,QAAgB,EAAE,OAAe;QAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mBAAmB,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IACD;;;;OAIG;IACH,gBAAgB,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAc;QAChE,OAAO,CAAC,KAAK,CACX,IAAI,QAAQ,wCAAwC,OAAO,0DAA0D,EACrH,KAAK,CACN,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAC,QAAgB,EAAE,QAAgB;QAC9C,OAAO,CAAC,IAAI,CACV,IAAI,QAAQ,0CAA0C,QAAQ,GAAG,CAClE,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,UAAU,CACR,QAAgB,EAChB,GAAW,EACX,KAAa,EACb,KAAc,EACd,QAAiB;QAEjB,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,IAAI,KAAK,IAAI,QAAQ,IAAI,EAAE,EAAE,EAC/C,iBAAiB,CACf,GAAG,QAAQ,KAAK,EAChB,GAAG,EACH,KAAK,EACL,KAAK,EACL,SAAS,EACT,QAAQ,CACT,CACF,CAAA;IACH,CAAC;IACD;;;;OAIG;IACH,UAAU,CAAC,QAAgB,EAAE,GAAW,EAAE,MAAc;QACtD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;QAClC,kBAAkB,CAChB,GAAG,QAAQ,IAAI,GAAG,YAAY,KAAK,EAAE,EACrC,IAAI,QAAQ,iBAAiB,GAAG,SAAS,KAAK,EAAE,CACjD,CAAA;IACH,CAAC;IACD;;;OAGG;IACH,oBAAoB,CAAC,QAAgB,EAAE,KAAc;QACnD,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,qCAAqC,EAAE,KAAK,CAAC,CAAA;IACxE,CAAC;IACD;;;OAGG;IACH,eAAe,CACb,QAAgB,EAChB,YAAoB,EACpB,KAAc;QAEd,OAAO,CAAC,KAAK,CACX,IAAI,QAAQ,+BAA+B,YAAY,WAAW,EAClE,KAAK,CACN,CAAA;IACH,CAAC;CACO,CAAA"}

package/dist/esm/wire/orderAmounts.d.ts

@@ -1,4 +1,4 @@
-import type { DecimalString, Market } from '@lifi/perps-types';
+import { type DecimalString, type Market } from '@lifi/perps-types';
 import type { PerpsSDKClient } from '../types/provider.js';
 /** @public */
 export interface OrderAmountsInput {
@@ -30,12 +30,14 @@ export interface OrderAmounts {
  * `notional` is the snapped size × price, and a derived margin is
  * `notional ÷ leverage` in `DivBig` (40 places, half-up).
  *
- * @returns `null` when `amount` or `price` is not a positive
- *   {@link DecimalString}, when `leverage` is not a positive finite number, or
- *   when the snapped size is zero (below one lot).
- * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
- *   provider plugin.
+ * @throws {PerpsError} `ValidationError` that names `amount` or `price` when
+ *   it is not a positive decimal, or `leverage` when it is not a finite number
+ *   above zero. `ValidationError` with the lot size when the snapped size is
+ *   zero (below one lot). `SDKError` when `market.providerId` names no
+ *   registered provider plugin.
  * @public
  */
-export declare function calculateOrderAmounts(input: OrderAmountsInput): OrderAmounts | null;
+export declare function calculateOrderAmounts(input: OrderAmountsInput): OrderAmounts;
+/** @public */
+export declare const safeCalculateOrderAmounts: (input: OrderAmountsInput) => OrderAmounts | undefined;
 //# sourceMappingURL=orderAmounts.d.ts.map

package/dist/esm/wire/orderAmounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orderAmounts.d.ts","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,aAAa,CAAA;CACrB;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,aAAa,CAAA;IACrB,sEAAsE;IACtE,IAAI,EAAE,aAAa,CAAA;IACnB,qDAAqD;IACrD,QAAQ,EAAE,aAAa,CAAA;CACxB;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,YAAY,GAAG,IAAI,CAiCrB"}
+{"version":3,"file":"orderAmounts.d.ts","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EAEZ,MAAM,mBAAmB,CAAA;AAO1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAI1D,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,aAAa,CAAA;CACrB;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,aAAa,CAAA;IACrB,sEAAsE;IACtE,IAAI,EAAE,aAAa,CAAA;IACnB,qDAAqD;IACrD,QAAQ,EAAE,aAAa,CAAA;CACxB;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAkC5E;AAED,cAAc;AACd,eAAO,MAAM,yBAAyB,wDAGrC,CAAA"}

package/dist/esm/wire/orderAmounts.js

@@ -1,14 +1,19 @@
+import { PerpsErrorCode, } from '@lifi/perps-types';
 import { DivBig, TruncBig } from '../decimal/big.js';
 import { isDecimalStringZero } from '../decimal/compare.js';
 import { isDecimalString } from '../decimal/parse.js';
+import { invalidInput } from '../errors/invalidInput.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { createSafeFunction } from '../utils/createSafeFunction.js';
 import { snapOrderSize } from './snap.js';
-function positiveDecimal(value) {
-    if (!isDecimalString(value)) {
-        return null;
+function requirePositiveDecimal(value, parameter) {
+    const parsed = isDecimalString(value) ? new TruncBig(value) : undefined;
+    if (parsed === undefined || !parsed.gt(0)) {
+        throw invalidInput(parameter, `must be a positive decimal, got '${String(value)}'`);
     }
-    const parsed = new TruncBig(value);
-    return parsed.gt(0) ? parsed : null;
+    return parsed;
 }
+const lotSize = (market) => market.sizeIncrement ?? new TruncBig(`1e-${market.szDecimals}`).toFixed();
 /**
  * The three order-entry amounts, derived from whichever one the user typed.
  * Only `size` snaps, onto the market's venue lot grid, because an order sends
@@ -16,22 +21,19 @@ function positiveDecimal(value) {
  * `notional` is the snapped size × price, and a derived margin is
  * `notional ÷ leverage` in `DivBig` (40 places, half-up).
  *
- * @returns `null` when `amount` or `price` is not a positive
- *   {@link DecimalString}, when `leverage` is not a positive finite number, or
- *   when the snapped size is zero (below one lot).
- * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
- *   provider plugin.
+ * @throws {PerpsError} `ValidationError` that names `amount` or `price` when
+ *   it is not a positive decimal, or `leverage` when it is not a finite number
+ *   above zero. `ValidationError` with the lot size when the snapped size is
+ *   zero (below one lot). `SDKError` when `market.providerId` names no
+ *   registered provider plugin.
  * @public
  */
 export function calculateOrderAmounts(input) {
     const { sdk, market, held, leverage } = input;
-    const amount = positiveDecimal(input.amount);
-    const price = positiveDecimal(input.price);
-    if (amount === null ||
-        price === null ||
-        !Number.isFinite(leverage) ||
-        leverage <= 0) {
-        return null;
+    const amount = requirePositiveDecimal(input.amount, 'amount');
+    const price = requirePositiveDecimal(input.price, 'price');
+    if (!Number.isFinite(leverage) || leverage <= 0) {
+        throw invalidInput('leverage', `must be a finite number above zero, got ${leverage}`);
     }
     const requested = held === 'size'
         ? input.amount
@@ -40,7 +42,7 @@ export function calculateOrderAmounts(input) {
             : amount.times(leverage).div(price).toFixed();
     const size = snapOrderSize(sdk, market, requested);
     if (isDecimalStringZero(size)) {
-        return null;
+        throw new PerpsError(PerpsErrorCode.ValidationError, `The order size ${requested} is below the lot size ${lotSize(market)}.`);
     }
     const notional = new TruncBig(size).times(price);
     return {
@@ -51,4 +53,6 @@ export function calculateOrderAmounts(input) {
         notional: notional.toFixed(),
     };
 }
+/** @public */
+export const safeCalculateOrderAmounts = createSafeFunction('calculateOrderAmounts', calculateOrderAmounts);
 //# sourceMappingURL=orderAmounts.js.map

package/dist/esm/wire/orderAmounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"orderAmounts.js","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AA2BzC,SAAS,eAAe,CAAC,KAAoB;IAC3C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC1C,IACE,MAAM,KAAK,IAAI;QACf,KAAK,KAAK,IAAI;QACd,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,QAAQ,IAAI,CAAC,EACb,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,SAAS,GACb,IAAI,KAAK,MAAM;QACb,CAAC,CAAC,KAAK,CAAC,MAAM;QACd,CAAC,CAAC,IAAI,KAAK,UAAU;YACnB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;YAC7B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;IACnD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IAClD,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAChD,OAAO;QACL,MAAM,EACJ,IAAI,KAAK,QAAQ;YACf,CAAC,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;QAClD,IAAI;QACJ,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE;KAC7B,CAAA;AACH,CAAC"}
+{"version":3,"file":"orderAmounts.js","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"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"}

package/dist/esm/wire/refuel.d.ts

@@ -30,7 +30,7 @@ export interface RefuelAmountInput {
  *   when `recommendedAmount`, `recommendedUsd` or `priceUsd` is not greater
  *   than zero: a route with nothing to refuel, not a failure.
  * @throws {PerpsError} `ValidationError` when a base-unit field is not an
- *   integer string, a USD field is not a {@link DecimalString}, or `decimals`
+ *   integer string, a USD field does not match the decimal pattern, or `decimals`
  *   is not a non-negative integer.
  * @public
  */

package/dist/esm/wire/refuel.js

@@ -1,7 +1,7 @@
 import { PerpsErrorCode } from '@lifi/perps-types';
 import { DivBig } from '../decimal/big.js';
 import { BASE_UNITS_PATTERN } from '../decimal/convert.js';
-import { decimalStringToBig } from '../decimal/decimalStringToBig.js';
+import { decimalStringToDivBig } from '../decimal/decimalStringToBig.js';
 import { PerpsError } from '../errors/PerpsError.js';
 /**
  * Headroom, in percent, that {@link calculateRefuelAmount} adds over the gas
@@ -27,7 +27,7 @@ function requireBaseUnits(value, field) {
  *   when `recommendedAmount`, `recommendedUsd` or `priceUsd` is not greater
  *   than zero: a route with nothing to refuel, not a failure.
  * @throws {PerpsError} `ValidationError` when a base-unit field is not an
- *   integer string, a USD field is not a {@link DecimalString}, or `decimals`
+ *   integer string, a USD field does not match the decimal pattern, or `decimals`
  *   is not a non-negative integer.
  * @public
  */
@@ -38,8 +38,8 @@ export function calculateRefuelAmount(input) {
     }
     const recommended = requireBaseUnits(input.recommendedAmount, 'recommendedAmount');
     const balance = requireBaseUnits(input.nativeBalance, 'nativeBalance');
-    const recommendedUsd = decimalStringToBig(input.recommendedUsd);
-    const priceUsd = decimalStringToBig(input.priceUsd);
+    const recommendedUsd = decimalStringToDivBig(input.recommendedUsd);
+    const priceUsd = decimalStringToDivBig(input.priceUsd);
     const deficit = recommended.minus(balance);
     if (!recommended.gt(0) ||
         !recommendedUsd.gt(0) ||

package/dist/esm/wire/refuel.js.map

@@ -1 +1 @@
-{"version":3,"file":"refuel.js","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAgB3C,SAAS,gBAAgB,CAAC,KAAoB,EAAE,KAAa;IAC3D,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,aAAa,KAAK,QAAQ,KAAK,uCAAuC,CACvE,CAAA;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,6CAA6C,QAAQ,EAAE,CACxD,CAAA;IACH,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAClC,KAAK,CAAC,iBAAiB,EACvB,mBAAmB,CACpB,CAAA;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IACtE,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACnD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1C,IACE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EACd,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,cAAc;SAClB,KAAK,CAAC,OAAO,CAAC;SACd,KAAK,CAAC,GAAG,GAAG,yBAAyB,CAAC;SACtC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAC3C,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;SAC/B,OAAO,CAAC,QAAQ,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"refuel.js","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAgB3C,SAAS,gBAAgB,CAAC,KAAoB,EAAE,KAAa;IAC3D,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,aAAa,KAAK,QAAQ,KAAK,uCAAuC,CACvE,CAAA;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,6CAA6C,QAAQ,EAAE,CACxD,CAAA;IACH,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAClC,KAAK,CAAC,iBAAiB,EACvB,mBAAmB,CACpB,CAAA;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IACtE,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1C,IACE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EACd,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,cAAc;SAClB,KAAK,CAAC,OAAO,CAAC;SACd,KAAK,CAAC,GAAG,GAAG,yBAAyB,CAAC;SACtC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAC3C,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;SAC/B,OAAO,CAAC,QAAQ,CAAC,CAAA;AACtB,CAAC"}

package/dist/esm/wire/transferable.d.ts

@@ -7,8 +7,8 @@ import type { DecimalString } from '@lifi/perps-types';
  * @param venueFigure - The venue's free figure for the category, which can
  *   exceed `units` or fall below zero.
  * @param units - Units held in the category, the upper bound of the clamp.
- * @throws {PerpsError} `ValidationError` when either input is not a
- *   {@link DecimalString}, naming the field.
+ * @throws {PerpsError} `ValidationError` when either input does not match the
+ *   decimal pattern, naming the field.
  * @public
  */
 export declare function calculateTransferable(venueFigure: DecimalString, units: DecimalString): DecimalString;

package/dist/esm/wire/transferable.js

@@ -7,8 +7,8 @@ import { decimalStringToBig } from '../decimal/decimalStringToBig.js';
  * @param venueFigure - The venue's free figure for the category, which can
  *   exceed `units` or fall below zero.
  * @param units - Units held in the category, the upper bound of the clamp.
- * @throws {PerpsError} `ValidationError` when either input is not a
- *   {@link DecimalString}, naming the field.
+ * @throws {PerpsError} `ValidationError` when either input does not match the
+ *   decimal pattern, naming the field.
  * @public
  */
 export function calculateTransferable(venueFigure, units) {

package/dist/types/decimal/arithmetic.d.ts

@@ -1,8 +1,7 @@
 /**
- * Exact `a + b`. Each input may carry `$`, `%`, `,` or whitespace:
- * `addDecimalString('$4', '$6')` is `'10'`.
+ * Exact `a + b`.
  *
- * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when an input does not match the decimal pattern.
  * @public
  */
 export declare function addDecimalString(a: string, b: string): string;
@@ -12,10 +11,25 @@ export declare function addDecimalString(a: string, b: string): string;
  * @public
  */
 export declare const safeAddDecimalString: (a: string, b: string) => string | undefined;
+/**
+ * Exact sum of every value; `'0'` for an empty list.
+ *
+ * @throws {PerpsError} `ValidationError` when a value does not match the
+ *   decimal pattern.
+ * @public
+ */
+export declare function addDecimalStrings(values: readonly string[]): string;
+/**
+ * {@link addDecimalStrings}, or `undefined` with a warning when it throws.
+ * One bad value gives `undefined`, never a partial sum.
+ *
+ * @public
+ */
+export declare const safeAddDecimalStrings: (values: readonly string[]) => string | undefined;
 /**
  * Exact `a - b`.
  *
- * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when an input does not match the decimal pattern.
  * @public
  */
 export declare function subtractDecimalString(a: string, b: string): string;
@@ -28,7 +42,7 @@ export declare const safeSubtractDecimalString: (a: string, b: string) => string
 /**
  * Exact `a × b`.
  *
- * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when an input does not match the decimal pattern.
  * @public
  */
 export declare function multiplyDecimalString(a: string, b: string): string;
@@ -41,8 +55,8 @@ export declare const safeMultiplyDecimalString: (a: string, b: string) => string
 /**
  * `a ÷ b` to 40 decimal places, rounded half up.
  *
- * @throws {PerpsError} `ValidationError` when an input is not a decimal
- *   string or `b` is zero.
+ * @throws {PerpsError} `ValidationError` when an input does not match the
+ *   decimal pattern or `b` is zero.
  * @public
  */
 export declare function divideDecimalString(a: string, b: string): string;
@@ -56,8 +70,8 @@ export declare const safeDivideDecimalString: (a: string, b: string) => string |
  * `a ÷ b` to 40 decimal places, truncated toward zero, so a derived amount
  * never exceeds the exact quotient.
  *
- * @throws {PerpsError} `ValidationError` when an input is not a decimal
- *   string or `b` is zero.
+ * @throws {PerpsError} `ValidationError` when an input does not match the
+ *   decimal pattern or `b` is zero.
  * @public
  */
 export declare function divideDecimalStringRoundDown(a: string, b: string): string;
@@ -71,7 +85,7 @@ export declare const safeDivideDecimalStringRoundDown: (a: string, b: string) =>
 /**
  * Exact `|value|`.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when `value` does not match the decimal pattern.
  * @public
  */
 export declare function absDecimalString(value: string): string;

package/dist/types/decimal/arithmetic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arithmetic.d.ts","sourceRoot":"","sources":["../../../src/decimal/arithmetic.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,8CAGhC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8CAGrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8CAGrC,CAAA;AAaD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8CAGnC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,8CAG5C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,uCAGhC,CAAA"}
+{"version":3,"file":"arithmetic.d.ts","sourceRoot":"","sources":["../../../src/decimal/arithmetic.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,8CAGhC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,mDAGjC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8CAGrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8CAGrC,CAAA;AAaD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8CAGnC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,8CAG5C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,uCAGhC,CAAA"}

package/dist/types/decimal/compare.d.ts

@@ -3,7 +3,7 @@
  * gate can tell `'1.0000000000000001'` from `'1'`. The other relations follow
  * from it: `a <= b` is `!isDecimalStringGreaterThan(a, b)`.
  *
- * @throws {PerpsError} `ValidationError` when either operand is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when either operand does not match the decimal pattern.
  * @public
  */
 export declare function isDecimalStringGreaterThan(a: string, b: string): boolean;
@@ -18,7 +18,7 @@ export declare const safeIsDecimalStringGreaterThan: (a: string, b: string) => b
  * Exact `value == 0`, so a flat-position check never reads `'0.0'` as
  * non-zero.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when `value` does not match the decimal pattern.
  * @public
  */
 export declare function isDecimalStringZero(value: string): boolean;
@@ -32,7 +32,7 @@ export declare const safeIsDecimalStringZero: (value: string) => boolean | undef
  * Exact three-way compare for a sort: `-1` when `a < b`, `0` when equal, `1`
  * when `a > b`.
  *
- * @throws {PerpsError} `ValidationError` when either operand is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when either operand does not match the decimal pattern.
  * @public
  */
 export declare function compareDecimalStrings(a: string, b: string): -1 | 0 | 1;

package/dist/types/decimal/convert.d.ts

@@ -12,7 +12,7 @@ export type DecimalRounding = 'truncate' | 'round' | 'up';
  * The result has no trailing zeros: `roundDecimalString('1.50', 1, 'round')`
  * is `'1.5'`.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal string,
+ * @throws {PerpsError} `ValidationError` when `value` does not match the decimal pattern,
  *   or `decimals` is not a non-negative integer.
  * @public
  */
@@ -28,7 +28,7 @@ export declare const safeRoundDecimalString: (value: string, decimals: number, r
  * arithmetic: `'0.29'` at 2 decimals is 29, never 28. Off-grid input resolves
  * per `rounding`. No `$`, `%` or `,` is removed first.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal string,
+ * @throws {PerpsError} `ValidationError` when `value` does not match the decimal pattern,
  *   `decimals` is not a non-negative integer, or the result's magnitude
  *   exceeds `Number.MAX_SAFE_INTEGER`.
  * @public
@@ -58,28 +58,6 @@ export declare function scaledIntegerToDecimalString(amount: string, decimals: n
  * @public
  */
 export declare const safeScaledIntegerToDecimalString: (amount: string, decimals: number) => string | undefined;
-/**
- * Round `value` down to `decimals` and pad the result to exactly that many
- * decimal places. The padding is the point: this seeds a fixed-decimal input,
- * where `'500.00'` and `'500'` are two renderings of one amount and the field
- * wants the first. For a canonical wire amount with no trailing zeros, read
- * the amount off `calculateOrderAmounts` or a provider snap instead.
- *
- * Exact decimal arithmetic throughout, so there is no 2^53 ceiling and no
- * float artifact: `'0.01'` at 18 decimals gives
- * `'0.010000000000000000'`, which `Number#toFixed` cannot.
- *
- * @throws {PerpsError} `ValidationError` when `value` is not a
- *   decimal string, or `decimals` is not a non-negative integer.
- * @public
- */
-export declare function truncateDecimal(value: string, decimals: number): string;
-/**
- * {@link truncateDecimal}, or `undefined` with a warning when it throws.
- *
- * @public
- */
-export declare const safeTruncateDecimal: (value: string, decimals: number) => string | undefined;
 /**
  * Spell a `number` as a {@link DecimalString} in plain notation: `1e-7`
  * becomes `'0.0000001'`, never `'1e-7'`. The boundary helper for a venue or

package/dist/types/decimal/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/decimal/convert.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;AAQzD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAUR;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oFAGlC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAuBR;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,oFAG5C,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAY,CAAA;AAE3C;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAcR;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,0DAG5C,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUvE;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,yDAG/B,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,uCAGrC,CAAA"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/decimal/convert.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;AAQzD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAUR;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oFAGlC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAuBR;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,oFAG5C,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAY,CAAA;AAE3C;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAcR;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,0DAG5C,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,uCAGrC,CAAA"}

package/dist/types/decimal/decimalStringToBig.d.ts

@@ -1,11 +1,10 @@
 import Big from 'big.js';
 /**
- * Read a decimal string as a `Big`. Whitespace, `$`, `%` and `,` are removed
- * first, so `'$1,234.5'` reads as `1234.5`; the rest must match
- * `DECIMAL_PATTERN`, so an exponent form such as `'1e5'` is rejected.
+ * Read a decimal string as a `Big`. The string must match `DECIMAL_PATTERN`,
+ * so `'$1,234.5'`, `'0.05%'` and the exponent form `'1e5'` are rejected.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a string or the
- *   cleaned string is not a decimal string.
+ * @throws {PerpsError} `ValidationError` when `value` does not match the
+ *   decimal pattern.
  * @internal
  */
 export declare function decimalStringToBig(value: string): Big;

package/dist/types/decimal/decimalStringToBig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decimalStringToBig.d.ts","sourceRoot":"","sources":["../../../src/decimal/decimalStringToBig.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,QAAQ,CAAA;AAMxB;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAUrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAExD"}
+{"version":3,"file":"decimalStringToBig.d.ts","sourceRoot":"","sources":["../../../src/decimal/decimalStringToBig.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,QAAQ,CAAA;AAIxB;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAExD"}

package/dist/types/decimal/parse.d.ts

@@ -3,7 +3,7 @@
  * float holds about 15 significant digits, so the result can lose precision;
  * never use it for an amount sent to a venue.
  *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal string
+ * @throws {PerpsError} `ValidationError` when `value` does not match the decimal pattern
  *   or is too large for a finite float.
  * @public
  */
@@ -32,4 +32,11 @@ export declare function isDecimalString(value: unknown): value is string;
  * @public
  */
 export declare function unknownToDecimalString(value: unknown, field: string, tool: string): string;
+/**
+ * The safe pair of {@link unknownToDecimalString}: `undefined` and a warning
+ * in place of a throw.
+ *
+ * @public
+ */
+export declare const safeUnknownToDecimalString: (value: unknown, field: string, tool: string) => string | undefined;
 //# sourceMappingURL=parse.d.ts.map

package/dist/types/decimal/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/decimal/parse.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,uCAGrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAWR"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/decimal/parse.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,uCAGrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAWR;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qEAGtC,CAAA"}

package/dist/types/errors/invalidInput.d.ts

@@ -0,0 +1,4 @@
+import { PerpsError } from './PerpsError.js';
+/** A `ValidationError` that names the input parameter and the rule it breaks. */
+export declare function invalidInput(parameter: string, rule: string): PerpsError;
+//# sourceMappingURL=invalidInput.d.ts.map

package/dist/types/errors/invalidInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidInput.d.ts","sourceRoot":"","sources":["../../../src/errors/invalidInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAKxE"}

package/dist/types/index.d.ts

@@ -10,13 +10,13 @@ export * from '@lifi/perps-types';
 export { createPerpsClient, DEFAULT_API_URL, } from './client/createPerpsClient.js';
 export { PerpsClient } from './client/PerpsClient.js';
 export { requireProvider } from './client/requireProvider.js';
-export { absDecimalString, addDecimalString, divideDecimalString, divideDecimalStringRoundDown, multiplyDecimalString, safeAbsDecimalString, safeAddDecimalString, safeDivideDecimalString, safeDivideDecimalStringRoundDown, safeMultiplyDecimalString, safeSubtractDecimalString, subtractDecimalString, } from './decimal/arithmetic.js';
+export { absDecimalString, addDecimalString, addDecimalStrings, divideDecimalString, divideDecimalStringRoundDown, multiplyDecimalString, safeAbsDecimalString, safeAddDecimalString, safeAddDecimalStrings, safeDivideDecimalString, safeDivideDecimalStringRoundDown, safeMultiplyDecimalString, safeSubtractDecimalString, subtractDecimalString, } from './decimal/arithmetic.js';
 export { compareDecimalStrings, isDecimalStringGreaterThan, isDecimalStringZero, safeCompareDecimalStrings, safeIsDecimalStringGreaterThan, safeIsDecimalStringZero, } from './decimal/compare.js';
 export type { DecimalRounding } from './decimal/convert.js';
-export { decimalStringToScaledInteger, numberToDecimalString, roundDecimalString, safeDecimalStringToScaledInteger, safeNumberToDecimalString, safeRoundDecimalString, safeScaledIntegerToDecimalString, safeTruncateDecimal, scaledIntegerToDecimalString, truncateDecimal, } from './decimal/convert.js';
+export { decimalStringToScaledInteger, numberToDecimalString, roundDecimalString, safeDecimalStringToScaledInteger, safeNumberToDecimalString, safeRoundDecimalString, safeScaledIntegerToDecimalString, scaledIntegerToDecimalString, } from './decimal/convert.js';
 export type { FormatOptions, RoundingMode } from './decimal/format.js';
 export { formatCompactUsd, formatNumber, formatPrice, formatSignedPercent, formatSignedUsd, formatUsd, } from './decimal/format.js';
-export { decimalStringToNumber, isDecimalString, safeDecimalStringToNumber, unknownToDecimalString, } from './decimal/parse.js';
+export { decimalStringToNumber, isDecimalString, safeDecimalStringToNumber, safeUnknownToDecimalString, unknownToDecimalString, } from './decimal/parse.js';
 export { PerpsErrorMessage } from './errors/constants.js';
 export { PerpsError } from './errors/PerpsError.js';
 export { classifyFill, classifyFillFromPosition, FillClassification, } from './math/fills.js';
@@ -82,6 +82,7 @@ export type { DeclaredDepositAsset, DepositFlow, DepositFlowFirstDepositPipeline
 export type { ActionSignerContribution, LiquidationEstimateParams, PerpsProvider, PerpsProviderPlugin, PerpsSDKClient, ProviderAccountExistsParams, ProviderGetAccountParams, ProviderGetActivityParams, ProviderGetAvailableToTradeParams, ProviderGetDepositFlowParams, ProviderGetFillsParams, ProviderGetMarketSettingsParams, ProviderGetOrderParams, ProviderGetOrdersParams, ProviderGetPortfolioHistoryParams, ProviderGetPositionsParams, ProviderGetQuoteParams, ProviderGetWithdrawableBalancesParams, ProviderGetWithdrawalTypesParams, ProviderGetWithdrawFlowParams, QuoteListener, SignActionProgress, SignActionsContext, } from './types/provider.js';
 export type { ProviderWithdrawableBalance, WithdrawableBalance, WithdrawalSourceTypes, WithdrawalTypeOption, WithdrawFlow, WithdrawFlowReady, WithdrawFlowSetupRequired, } from './types/withdrawal.js';
 export { paginateActivity } from './utils/activityPaging.js';
+export { createSafeFunction } from './utils/createSafeFunction.js';
 export { ETHEREUM_NATIVE_GAS, ETHEREUM_USDC, HYPERLIQUID_USDC, LIGHTER_USDC, ROBINHOOD_NATIVE_GAS, ROBINHOOD_USDG, } from './utils/depositAssets.js';
 export { ExplorerChainId, explorerTxUrl, explorerTxUrlFromBase, } from './utils/explorer.js';
 export { ACTIVE_ORDER_STATUSES, isActiveOrderStatus, isRegularOrder, isStopLossOrder, isTakeProfitOrder, isTpSlOrder, isTriggerOrder, isTwapOrder, triggerConditionFor, } from './utils/orderClassification.js';
@@ -101,7 +102,7 @@ export type { EventForSubscription, SubscriptionListener, WsConnectionStatus, Ws
 export { WS_CHANNEL_TEARDOWN_LINGER_MS, WsProviderBase, } from './websocket/WsProviderBase.js';
 export { wsLog } from './websocket/wsLog.js';
 export type { OrderAmounts, OrderAmountsInput, } from './wire/orderAmounts.js';
-export { calculateOrderAmounts } from './wire/orderAmounts.js';
+export { calculateOrderAmounts, safeCalculateOrderAmounts, } from './wire/orderAmounts.js';
 export type { RefuelAmountInput } from './wire/refuel.js';
 export { calculateRefuelAmount, REFUEL_FEE_MARGIN_PERCENT, } from './wire/refuel.js';
 export { snapOrderPrice, snapOrderSize } from './wire/snap.js';