@gauntlet-xyz/sdk 2.0.0 → 2.3.0

package/dist/api/decimal.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts an API decimal string (human units, e.g. `"1250.5"`) into base-unit
+ * bigint at the given token decimals (e.g. `1250500000n` for 6 decimals).
+ *
+ * The conversion is exact: a value with more significant fractional digits
+ * than `decimals` throws `DecimalPrecisionError` rather than rounding.
+ * Hand-rolled instead of viem's `parseUnits`, which silently rounds excess
+ * precision (`parseUnits('1.0000005', 6)` → `1000001n`) — unacceptable for
+ * financial amounts.
+ */
+export declare function decimalToBigInt(value: string, decimals: number): bigint;
+/**
+ * Formats a base-unit bigint back into the API's human decimal-string
+ * representation (no trailing fractional zeros, no exponent notation).
+ */
+export declare function bigIntToDecimal(value: bigint, decimals: number): string;
+/** Vault shares are always reported in 18-decimal units by the Gaia API. */
+export declare const SHARE_DECIMALS = 18;
+/** Parses an API share amount (decimal string) into base-unit bigint (1e18). */
+export declare function sharesToBigInt(value: string): bigint;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/api/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/api/decimal.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,4EAA4E;AAC5E,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/api/decimal.js

@@ -0,0 +1,44 @@
+import { formatUnits } from 'viem';
+import { DecimalPrecisionError, InvalidDecimalError } from './errors';
+const DECIMAL_RE = /^(-?)(\d+)(?:\.(\d+))?$/;
+/**
+ * Converts an API decimal string (human units, e.g. `"1250.5"`) into base-unit
+ * bigint at the given token decimals (e.g. `1250500000n` for 6 decimals).
+ *
+ * The conversion is exact: a value with more significant fractional digits
+ * than `decimals` throws `DecimalPrecisionError` rather than rounding.
+ * Hand-rolled instead of viem's `parseUnits`, which silently rounds excess
+ * precision (`parseUnits('1.0000005', 6)` → `1000001n`) — unacceptable for
+ * financial amounts.
+ */
+export function decimalToBigInt(value, decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0) {
+        throw new InvalidDecimalError(`decimals=${decimals}`);
+    }
+    const match = DECIMAL_RE.exec(value);
+    if (!match)
+        throw new InvalidDecimalError(value);
+    const [, sign, whole, frac = ''] = match;
+    if (frac.length > decimals && !/^0*$/.test(frac.slice(decimals))) {
+        throw new DecimalPrecisionError(value, decimals);
+    }
+    const scaled = BigInt(whole + frac.slice(0, decimals).padEnd(decimals, '0'));
+    return sign === '-' ? -scaled : scaled;
+}
+/**
+ * Formats a base-unit bigint back into the API's human decimal-string
+ * representation (no trailing fractional zeros, no exponent notation).
+ */
+export function bigIntToDecimal(value, decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0) {
+        throw new InvalidDecimalError(`decimals=${decimals}`);
+    }
+    return formatUnits(value, decimals);
+}
+/** Vault shares are always reported in 18-decimal units by the Gaia API. */
+export const SHARE_DECIMALS = 18;
+/** Parses an API share amount (decimal string) into base-unit bigint (1e18). */
+export function sharesToBigInt(value) {
+    return decimalToBigInt(value, SHARE_DECIMALS);
+}
+//# sourceMappingURL=decimal.js.map

package/dist/api/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../src/api/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEtE,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,QAAgB;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACzC,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7E,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,QAAgB;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAChD,CAAC"}

package/dist/api/errors.d.ts

@@ -0,0 +1,32 @@
+import { GauntletSDKError } from '../errors';
+export declare class GauntletApiError extends GauntletSDKError {
+    readonly status: number;
+    readonly path: string;
+    /** Machine-readable code from the API error envelope (e.g. `NOT_FOUND`), when present. */
+    readonly code?: string;
+    constructor(params: {
+        status: number;
+        path: string;
+        message: string;
+        code?: string;
+    });
+}
+export declare class InvalidDecimalError extends GauntletSDKError {
+    readonly value: string;
+    constructor(value: string);
+}
+export declare class DecimalPrecisionError extends GauntletSDKError {
+    readonly value: string;
+    readonly decimals: number;
+    constructor(value: string, decimals: number);
+}
+export declare class InvalidCaipIdError extends GauntletSDKError {
+    readonly id: string;
+    constructor(id: string);
+}
+export declare class SettlementTimeoutError extends GauntletSDKError {
+    readonly requestHash: string;
+    readonly timeoutMs: number;
+    constructor(requestHash: string, timeoutMs: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CASrF;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM;CAK1B;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ5C;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,EAAE,EAAE,MAAM;CAKvB;AAED,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMnD"}

package/dist/api/errors.js

@@ -0,0 +1,41 @@
+import { GauntletSDKError } from '../errors';
+export class GauntletApiError extends GauntletSDKError {
+    constructor(params) {
+        super(`Gauntlet API request to "${params.path}" failed with ${params.status}: ${params.message}`);
+        this.name = 'GauntletApiError';
+        this.status = params.status;
+        this.path = params.path;
+        this.code = params.code;
+    }
+}
+export class InvalidDecimalError extends GauntletSDKError {
+    constructor(value) {
+        super(`Value "${value}" is not a valid decimal string`);
+        this.name = 'InvalidDecimalError';
+        this.value = value;
+    }
+}
+export class DecimalPrecisionError extends GauntletSDKError {
+    constructor(value, decimals) {
+        super(`Decimal "${value}" has more fractional digits than the token's ${decimals} decimals; converting would lose precision`);
+        this.name = 'DecimalPrecisionError';
+        this.value = value;
+        this.decimals = decimals;
+    }
+}
+export class InvalidCaipIdError extends GauntletSDKError {
+    constructor(id) {
+        super(`"${id}" is not a valid CAIP-10 vault id (expected "{chainId}:{address}")`);
+        this.name = 'InvalidCaipIdError';
+        this.id = id;
+    }
+}
+export class SettlementTimeoutError extends GauntletSDKError {
+    constructor(requestHash, timeoutMs) {
+        super(`Request "${requestHash}" did not settle within ${timeoutMs}ms`);
+        this.name = 'SettlementTimeoutError';
+        this.requestHash = requestHash;
+        this.timeoutMs = timeoutMs;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IAMpD,YAAY,MAAwE;QAClF,KAAK,CACH,4BAA4B,MAAM,CAAC,IAAI,iBAAiB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IAGvD,YAAY,KAAa;QACvB,KAAK,CAAC,UAAU,KAAK,iCAAiC,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IAIzD,YAAY,KAAa,EAAE,QAAgB;QACzC,KAAK,CACH,YAAY,KAAK,iDAAiD,QAAQ,4CAA4C,CACvH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IAGtD,YAAY,EAAU;QACpB,KAAK,CAAC,IAAI,EAAE,oEAAoE,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAI1D,YAAY,WAAmB,EAAE,SAAiB;QAChD,KAAK,CAAC,YAAY,WAAW,2BAA2B,SAAS,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}