@lifi/perps-sdk 23.1.0 → 24.0.0

package/dist/types/types/withdrawal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../../../src/types/withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,KAAK,EACL,aAAa,EACb,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,eAAe,CAAA;IACtB,8EAA8E;IAC9E,SAAS,EAAE,aAAa,CAAA;IACxB;;;;OAIG;IACH,GAAG,EAAE,aAAa,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,eAAe,CAAA;IACtB,oDAAoD;IACpD,SAAS,EAAE,aAAa,CAAA;IACxB;;;;OAIG;IACH,GAAG,EAAE,aAAa,CAAA;IAClB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,CAAA;IACrB,qEAAqE;IACrE,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../../../src/types/withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,SAAS,EAAE,aAAa,CAAA;IACxB;;;;OAIG;IACH,GAAG,EAAE,aAAa,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAA;IAClB,oDAAoD;IACpD,SAAS,EAAE,aAAa,CAAA;IACxB;;;;OAIG;IACH,GAAG,EAAE,aAAa,CAAA;IAClB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAA;IACpB,qFAAqF;IACrF,GAAG,EAAE,aAAa,CAAA;IAClB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,CAAA;IACrB,qEAAqE;IACrE,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,yBAAyB,CAAA"}

package/dist/types/utils/createSafeFunction.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wrap a throwing function so that it gives `undefined` in place of a throw.
+ * The wrapper logs a warning with `name` and the error, which carries the
+ * stack trace.
+ *
+ * @internal
+ */
+export declare function createSafeFunction<Args extends unknown[], Result>(name: string, throwingFunction: (...args: Args) => Result): (...args: Args) => Result | undefined;
+//# sourceMappingURL=createSafeFunction.d.ts.map

package/dist/types/utils/createSafeFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSafeFunction.d.ts","sourceRoot":"","sources":["../../../src/utils/createSafeFunction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC/D,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GAC1C,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,SAAS,CASvC"}

package/dist/types/utils/timestampToIsoString.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Read a venue time (epoch milliseconds or a date string) as an ISO-8601
+ * string.
+ *
+ * @throws {PerpsError} `ValidationError` when `Date` cannot read `value`.
+ * @public
+ */
+export declare function timestampToIsoString(value: string | number): string;
+/**
+ * {@link timestampToIsoString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export declare const safeTimestampToIsoString: (value: string | number) => string | undefined;
+//# sourceMappingURL=timestampToIsoString.d.ts.map

package/dist/types/utils/timestampToIsoString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestampToIsoString.d.ts","sourceRoot":"","sources":["../../../src/utils/timestampToIsoString.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASnE;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gDAGpC,CAAA"}

package/dist/types/utils/warnOnce.d.ts

@@ -6,4 +6,20 @@
  * @internal
  */
 export declare const createWarnOnce: () => ((key: string, message: string) => void);
+/**
+ * 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 declare const skippedRowMessage: (source: string, row: string, field: string, value: unknown, expected: string) => string;
+/**
+ * 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.
+ *
+ * @param expected - What the field must be. Defaults to `'decimal'`.
+ * @internal
+ */
+export declare const warnSkippedVenueRow: (provider: string, row: string, field: string, value: unknown, expected?: string) => void;
 //# sourceMappingURL=warnOnce.d.ts.map

package/dist/types/utils/warnOnce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warnOnce.d.ts","sourceRoot":"","sources":["../../../src/utils/warnOnce.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAexE,CAAA"}
+{"version":3,"file":"warnOnce.d.ts","sourceRoot":"","sources":["../../../src/utils/warnOnce.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAexE,CAAA;AAID;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,KAAK,MAAM,EACX,OAAO,MAAM,EACb,OAAO,OAAO,EACd,UAAU,MAAM,KACf,MAKF,CAAA;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,OAAO,OAAO,EACd,iBAAoB,KACnB,IAKF,CAAA"}

package/dist/types/version.d.ts

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

package/dist/types/websocket/PerpsWsClient.d.ts

@@ -58,6 +58,7 @@ export declare class PerpsWsClient {
     private readonly options;
     private providers;
     private initPromises;
+    private discovery;
     private closed;
     constructor(client: PerpsSDKClient, options?: PerpsWsClientOptions);
     /**
@@ -122,5 +123,11 @@ export declare class PerpsWsClient {
     private assertOpen;
     private getOrCreateProvider;
     private initProvider;
+    /**
+     * Shares one in-flight `/providers` request between concurrent venue
+     * inits. The slot clears on settlement, so a later init fetches fresh
+     * metadata and a rejection is never cached.
+     */
+    private discoverProviders;
 }
 //# sourceMappingURL=PerpsWsClient.d.ts.map

package/dist/types/websocket/PerpsWsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsWsClient.d.ts","sourceRoot":"","sources":["../../../src/websocket/PerpsWsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,KAAK,EACV,oBAAoB,EAEpB,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAAA;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAChD;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKtE;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMlD;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,CAAC,SAAS,YAAY,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,EAClD,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC;IAOtB;;;;;;;;;;OAUG;IACG,cAAc,CAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;IAatB;;;;;;;OAOG;IACH,KAAK;IASL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,UAAU;YASJ,mBAAmB;YAqBnB,YAAY;CA0B3B"}
+{"version":3,"file":"PerpsWsClient.d.ts","sourceRoot":"","sources":["../../../src/websocket/PerpsWsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,KAAK,EACV,oBAAoB,EAEpB,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAAA;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAChD;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKtE;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMlD;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,CAAC,SAAS,YAAY,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,EAClD,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC;IAOtB;;;;;;;;;;OAUG;IACG,cAAc,CAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;IAatB;;;;;;;OAOG;IACH,KAAK;IASL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,UAAU;YASJ,mBAAmB;YAqBnB,YAAY;IA2B1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAY1B"}

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

@@ -36,6 +36,18 @@ export declare const wsLog: {
      * so logged at `warn`.
      */
     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.
+     */
+    readonly skippedRow: (provider: string, row: string, field: string, value: unknown) => 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.
+     */
+    readonly droppedRow: (provider: string, row: string, reason: string) => void;
     /**
      * A background market-registry refetch rejected. Unknown-market items keep
      * being skipped until the next cooldown-gated retry, so logged at `warn`.

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

@@ -1 +1 @@
-{"version":3,"file":"wsLog.d.ts","sourceRoot":"","sources":["../../../src/websocket/wsLog.ts"],"names":[],"mappings":"AAOA;;;;;;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;;;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":"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"}

package/dist/types/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;AAI9D,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,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"}

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

@@ -1,27 +1,37 @@
 import { type DecimalString } from '@lifi/perps-types';
+/**
+ * Headroom, in percent, that {@link calculateRefuelAmount} adds over the gas
+ * deficit to pay the refuel route's own swap and bridge fees.
+ *
+ * @public
+ */
+export declare const REFUEL_FEE_MARGIN_PERCENT = 20;
 /** @public */
 export interface RefuelAmountInput {
-    /** USD value of the gas the route recommends. */
-    gasUsd: DecimalString;
+    /** Native gas amount the LI.FI gas suggestion recommends, in base units. */
+    recommendedAmount: DecimalString;
+    /** USD value of `recommendedAmount`. */
+    recommendedUsd: DecimalString;
+    /** Native balance the wallet holds on the recommendation's chain, in base units. */
+    nativeBalance: DecimalString;
     /** USD price of one whole source token. */
     priceUsd: DecimalString;
     /** Decimals of the source token, which the result is spelled to exactly. */
     decimals: number;
 }
 /**
- * Source-token amount whose USD value covers `gasUsd`, rounded **up** onto
- * the token's decimal grid so a refuel never lands short of the
- * recommendation. The result keeps trailing zeros to `decimals`, so it seeds
- * an amount input at the token's own precision.
- *
- * The quotient does not terminate for most prices, which is why this is a
- * big.js primitive: an 18-decimal token needs a ceiling at 10^-18, far past
- * what a `number` can carry.
+ * Source-token amount that buys the native gas the wallet lacks: the part of
+ * the recommendation above `nativeBalance`, valued pro rata on
+ * `recommendedUsd`, plus {@link REFUEL_FEE_MARGIN_PERCENT}. Rounded **up**
+ * onto the token's decimal grid so a refuel never lands short, and spelled
+ * with trailing zeros to `decimals` to seed an amount input.
  *
- * @returns `undefined` when `gasUsd` or `priceUsd` is not greater than zero,
- *   which is a route with nothing to refuel rather than a failure.
- * @throws {PerpsError} `ValidationError` when `gasUsd` or `priceUsd` is not a
- *   {@link DecimalString}, or when `decimals` is not a non-negative integer.
+ * @returns `undefined` when the wallet already holds the recommendation, or
+ *   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`
+ *   is not a non-negative integer.
  * @public
  */
 export declare function calculateRefuelAmount(input: RefuelAmountInput): DecimalString | undefined;

package/dist/types/wire/refuel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refuel.d.ts","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAKtE,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,EAAE,aAAa,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,aAAa,GAAG,SAAS,CAiB3B"}
+{"version":3,"file":"refuel.d.ts","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAOtE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,iBAAiB,EAAE,aAAa,CAAA;IAChC,wCAAwC;IACxC,cAAc,EAAE,aAAa,CAAA;IAC7B,oFAAoF;IACpF,aAAa,EAAE,aAAa,CAAA;IAC5B,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;CACjB;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,aAAa,GAAG,SAAS,CA8B3B"}

package/dist/types/wire/withdraw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withdraw.d.ts","sourceRoot":"","sources":["../../../src/wire/withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CACP,mBAAmB,EACnB,WAAW,GAAG,eAAe,GAAG,eAAe,CAChD,GACA,aAAa,CASf"}
+{"version":3,"file":"withdraw.d.ts","sourceRoot":"","sources":["../../../src/wire/withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CACP,mBAAmB,EACnB,WAAW,GAAG,eAAe,GAAG,eAAe,CAChD,GACA,aAAa,CAOf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk",
-  "version": "23.1.0",
+  "version": "24.0.0",
   "description": "LI.FI Perps SDK for perpetuals trading",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -46,7 +46,7 @@
     "big.js": "^7.0.1",
     "partysocket": "^1.1.19",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^20.2.0"
+    "@lifi/perps-types": "^21.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/client/PerpsClient.ts

@@ -30,8 +30,9 @@ import {
   PerpsSigner,
   SigningMethod,
 } from '@lifi/perps-types'
-import Big from 'big.js'
 import type { Address } from 'viem'
+import { isDecimalStringGreaterThan } from '../decimal/compare.js'
+import { unknownToDecimalString } from '../decimal/parse.js'
 import { PerpsError } from '../errors/PerpsError.js'
 import { getAssetRegistry, toAssetDisplay } from '../registry/assetRegistry.js'
 import { getMarketRegistry } from '../registry/marketRegistry.js'
@@ -60,6 +61,7 @@ import type {
   GetPortfolioHistoryParams,
   GetSetupParams,
   GetWithdrawableBalancesParams,
+  GetWithdrawalTypesParams,
   GetWithdrawFlowParams,
   ModifyOrdersParams,
   PerpsClientOptions,
@@ -85,7 +87,11 @@ import type {
   SignActionProgress,
   SignActionsContext,
 } from '../types/provider.js'
-import type { WithdrawableBalance, WithdrawFlow } from '../types/withdrawal.js'
+import type {
+  WithdrawableBalance,
+  WithdrawalSourceTypes,
+  WithdrawFlow,
+} from '../types/withdrawal.js'
 import { isUserFacingSetupStep } from '../utils/setupActions.js'
 import { signTypedDataWithSigner } from '../utils/signTypedData.js'
 import {
@@ -219,7 +225,10 @@ function assertAllSucceeded(results: ActionResult[]): void {
 
 function isNonNegativeDecimal(value: string): boolean {
   try {
-    return new Big(value).gte(0)
+    return !isDecimalStringGreaterThan(
+      '0',
+      unknownToDecimalString(value, 'withdrawalFee', 'perps-sdk')
+    )
   } catch {
     return false
   }
@@ -838,8 +847,9 @@ export class PerpsClient {
   }
 
   /**
-   * The `(asset, route)` selections `params.address` can actually withdraw at
-   * `params.provider`. The venue owns how its balances split across routes;
+   * The `(asset, category)` selections `params.address` can actually withdraw
+   * at `params.provider`. The venue owns how its balances split across
+   * categories;
    * this join adds the core `/assets` metadata — precision, L1 identity and
    * the per-asset minimum — and drops every row the minimum rules out, plus
    * any row whose asset the provider's registry does not carry, since without
@@ -878,22 +888,31 @@ export class PerpsClient {
       }
       const minimum = asset.minWithdrawalAmount
       if (minimum !== undefined) {
-        let floor: Big
+        let floor: string
         try {
-          floor = new Big(minimum)
+          floor = unknownToDecimalString(
+            minimum,
+            'minWithdrawalAmount',
+            'perps-sdk'
+          )
         } catch {
           throw new PerpsError(
             PerpsErrorCode.SDKError,
             `Asset '${asset.id}' field \`minWithdrawalAmount\` is not a valid decimal.`
           )
         }
-        if (new Big(row.available).lt(floor)) {
+        if (isDecimalStringGreaterThan(floor, row.available)) {
           return []
         }
       }
       if (row.withdrawalFee === undefined) {
         return [
-          { asset, route: row.route, available: row.available, max: row.max },
+          {
+            asset,
+            categoryId: row.categoryId,
+            available: row.available,
+            max: row.max,
+          },
         ]
       }
       if (!isNonNegativeDecimal(row.withdrawalFee)) {
@@ -905,7 +924,7 @@ export class PerpsClient {
       return [
         {
           asset,
-          route: row.route,
+          categoryId: row.categoryId,
           available: row.available,
           max: row.max,
           withdrawalFee: row.withdrawalFee,
@@ -917,6 +936,25 @@ export class PerpsClient {
     })
   }
 
+  /**
+   * The withdrawal types `params.address` can choose per holding at
+   * `params.provider`, each with its cap and the `withdrawalOptions` to pass
+   * unchanged in `WithdrawalParams`.
+   *
+   * @returns `undefined` when the registered plugin declares no withdrawal
+   *   types read.
+   * @throws {PerpsError} When the provider plugin is not registered, or when
+   *   the plugin read fails.
+   * @public
+   */
+  async getWithdrawalTypes(
+    params: GetWithdrawalTypesParams,
+    options?: SDKRequestOptions
+  ): Promise<WithdrawalSourceTypes[] | undefined> {
+    const plugin = this.requireProvider(params.provider)
+    return plugin.getWithdrawalTypes?.({ address: params.address }, options)
+  }
+
   /**
    * The account's portfolio value and cumulative PnL over `params.range` at
    * `params.provider`, read directly from the venue.

package/src/decimal/arithmetic.ts

@@ -0,0 +1,144 @@
+import { PerpsErrorCode } from '@lifi/perps-types'
+import type Big from 'big.js'
+import { PerpsError } from '../errors/PerpsError.js'
+import { createSafeFunction } from '../utils/createSafeFunction.js'
+import { DivBig, TruncBig } from './big.js'
+import { bigToDecimalString, decimalStringToBig } from './decimalStringToBig.js'
+
+/**
+ * Exact `a + b`. Each input may carry `$`, `%`, `,` or whitespace:
+ * `addDecimalString('$4', '$6')` is `'10'`.
+ *
+ * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @public
+ */
+export function addDecimalString(a: string, b: string): string {
+  return bigToDecimalString(decimalStringToBig(a).plus(decimalStringToBig(b)))
+}
+
+/**
+ * {@link addDecimalString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeAddDecimalString = createSafeFunction(
+  'addDecimalString',
+  addDecimalString
+)
+
+/**
+ * Exact `a - b`.
+ *
+ * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @public
+ */
+export function subtractDecimalString(a: string, b: string): string {
+  return bigToDecimalString(decimalStringToBig(a).minus(decimalStringToBig(b)))
+}
+
+/**
+ * {@link subtractDecimalString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeSubtractDecimalString = createSafeFunction(
+  'subtractDecimalString',
+  subtractDecimalString
+)
+
+/**
+ * Exact `a × b`.
+ *
+ * @throws {PerpsError} `ValidationError` when an input is not a decimal string.
+ * @public
+ */
+export function multiplyDecimalString(a: string, b: string): string {
+  return bigToDecimalString(decimalStringToBig(a).times(decimalStringToBig(b)))
+}
+
+/**
+ * {@link multiplyDecimalString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeMultiplyDecimalString = createSafeFunction(
+  'multiplyDecimalString',
+  multiplyDecimalString
+)
+
+function requireNonZeroDivisor(divisor: string): Big {
+  const parsed = decimalStringToBig(divisor)
+  if (parsed.eq(0)) {
+    throw new PerpsError(
+      PerpsErrorCode.ValidationError,
+      `Division by zero: divisor '${divisor}'.`
+    )
+  }
+  return parsed
+}
+
+/**
+ * `a ÷ b` to 40 decimal places, rounded half up.
+ *
+ * @throws {PerpsError} `ValidationError` when an input is not a decimal
+ *   string or `b` is zero.
+ * @public
+ */
+export function divideDecimalString(a: string, b: string): string {
+  const divisor = requireNonZeroDivisor(b)
+  return bigToDecimalString(new DivBig(decimalStringToBig(a)).div(divisor))
+}
+
+/**
+ * {@link divideDecimalString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeDivideDecimalString = createSafeFunction(
+  'divideDecimalString',
+  divideDecimalString
+)
+
+/**
+ * `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.
+ * @public
+ */
+export function divideDecimalStringRoundDown(a: string, b: string): string {
+  const divisor = requireNonZeroDivisor(b)
+  return bigToDecimalString(new TruncBig(decimalStringToBig(a)).div(divisor))
+}
+
+/**
+ * {@link divideDecimalStringRoundDown}, or `undefined` with a warning when it
+ * throws.
+ *
+ * @public
+ */
+export const safeDivideDecimalStringRoundDown = createSafeFunction(
+  'divideDecimalStringRoundDown',
+  divideDecimalStringRoundDown
+)
+
+/**
+ * Exact `|value|`.
+ *
+ * @throws {PerpsError} `ValidationError` when `value` is not a decimal string.
+ * @public
+ */
+export function absDecimalString(value: string): string {
+  return bigToDecimalString(decimalStringToBig(value).abs())
+}
+
+/**
+ * {@link absDecimalString}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeAbsDecimalString = createSafeFunction(
+  'absDecimalString',
+  absDecimalString
+)

package/src/decimal/big.ts

@@ -14,8 +14,3 @@ DivBig.DP = 40
 export const TruncBig = Big()
 TruncBig.DP = 40
 TruncBig.RM = Big.roundDown
-
-/** True when every value is a finite number, so `new DivBig(value)` cannot throw. */
-export function areFinite(...values: number[]): boolean {
-  return values.every(Number.isFinite)
-}

package/src/decimal/compare.ts

@@ -1,17 +1,67 @@
-import type { DecimalString } from '@lifi/perps-types'
-import { requireDecimal } from './requireDecimal.js'
+import { createSafeFunction } from '../utils/createSafeFunction.js'
+import { decimalStringToBig } from './decimalStringToBig.js'
 
 /**
- * Exact `a > b` on two {@link DecimalString}s, with no float rounding, so a
- * funds gate can tell `'1.0000000000000001'` from `'1'`. The other relations
- * follow from it: `a <= b` is `!isDecimalStringGreaterThan(a, b)`.
+ * Exact `a > b` on two decimal strings, with no float rounding, so a funds
+ * 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.
  * @public
  */
-export function isDecimalStringGreaterThan(
-  a: DecimalString,
-  b: DecimalString
-): boolean {
-  return requireDecimal(a, 'a').gt(requireDecimal(b, 'b'))
+export function isDecimalStringGreaterThan(a: string, b: string): boolean {
+  return decimalStringToBig(a).gt(decimalStringToBig(b))
 }
+
+/**
+ * {@link isDecimalStringGreaterThan}, or `undefined` with a warning when it
+ * throws.
+ *
+ * @public
+ */
+export const safeIsDecimalStringGreaterThan = createSafeFunction(
+  'isDecimalStringGreaterThan',
+  isDecimalStringGreaterThan
+)
+
+/**
+ * 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.
+ * @public
+ */
+export function isDecimalStringZero(value: string): boolean {
+  return decimalStringToBig(value).eq(0)
+}
+
+/**
+ * {@link isDecimalStringZero}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeIsDecimalStringZero = createSafeFunction(
+  'isDecimalStringZero',
+  isDecimalStringZero
+)
+
+/**
+ * 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.
+ * @public
+ */
+export function compareDecimalStrings(a: string, b: string): -1 | 0 | 1 {
+  return decimalStringToBig(a).cmp(decimalStringToBig(b))
+}
+
+/**
+ * {@link compareDecimalStrings}, or `undefined` with a warning when it throws.
+ *
+ * @public
+ */
+export const safeCompareDecimalStrings = createSafeFunction(
+  'compareDecimalStrings',
+  compareDecimalStrings
+)