@hyperlane-xyz/utils 0.0.0-beta-20251201221151

package/dist/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../src/async.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,SAAoB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,SAAS,qBAUjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC5B,QAAQ,SAAI,EACZ,WAAW,SAAK,cAqBjB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,SAAM,EACb,WAAW,GAAE,MAAM,GAAG,SAAqB,cAgB5C;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACtC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,EAAE,EACP,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd"}

package/dist/async.js

@@ -0,0 +1,146 @@
+import { rootLogger } from './logging.js';
+import { assert } from './validation.js';
+/**
+ * Return a promise that resolves in ms milliseconds.
+ * @param ms Time to wait
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Wait up to a given amount of time, and throw an error if the promise does not resolve in time.
+ * @param promise The promise to timeout on.
+ * @param timeoutMs How long to wait for the promise in milliseconds.
+ * @param message The error message if a timeout occurs.
+ */
+export function timeout(promise, timeoutMs, message = 'Timeout reached') {
+    if (!timeoutMs || timeoutMs <= 0)
+        return promise;
+    return new Promise((resolve, reject) => {
+        setTimeout(() => {
+            reject(new Error(message));
+        }, timeoutMs);
+        promise.then(resolve).catch(reject);
+    });
+}
+/**
+ * Run a callback with a timeout.
+ * @param timeoutMs How long to wait for the promise in milliseconds.
+ * @param callback The callback to run.
+ * @returns callback return value
+ * @throws Error if the timeout is reached before the callback completes
+ */
+export async function runWithTimeout(timeoutMs, callback) {
+    let timeoutId;
+    const timeoutProm = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`Timed out in ${timeoutMs}ms.`));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([callback(), timeoutProm]);
+        return result;
+    }
+    finally {
+        // @ts-ignore timeout gets set immediately by the promise constructor
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Executes a fetch request that fails after a timeout via an AbortController.
+ * @param resource resource to fetch (e.g URL)
+ * @param options fetch call options object
+ * @param timeout timeout MS (default 10_000)
+ * @returns fetch response
+ */
+export async function fetchWithTimeout(resource, options, timeout = 10000) {
+    const controller = new AbortController();
+    const id = setTimeout(() => controller.abort(), timeout);
+    const response = await fetch(resource, {
+        ...options,
+        signal: controller.signal,
+    });
+    clearTimeout(id);
+    return response;
+}
+/**
+ * Retries an async function with exponential backoff.
+ * Always executes at least once, even if `attempts` is 0 or negative.
+ * Stops retrying if `error.isRecoverable` is set to false.
+ * @param runner callback to run
+ * @param attempts max number of attempts (defaults to 5, minimum 1)
+ * @param baseRetryMs base delay between attempts in milliseconds (defaults to 50ms)
+ * @returns runner return value
+ */
+export async function retryAsync(runner, attempts = 5, baseRetryMs = 50) {
+    // Guard against invalid attempts - always try at least once
+    attempts = attempts > 0 ? attempts : 1;
+    let i = 0;
+    for (;;) {
+        try {
+            const result = await runner();
+            return result;
+        }
+        catch (e) {
+            const error = e;
+            // Non-recoverable only if the flag is present _and_ set to false
+            if (error.isRecoverable === false || ++i >= attempts) {
+                throw error;
+            }
+            await sleep(baseRetryMs * 2 ** (i - 1));
+        }
+    }
+}
+/**
+ * Run a callback with a timeout, and retry if the callback throws an error.
+ * @param runner callback to run
+ * @param delayMs base delay between attempts
+ * @param maxAttempts maximum number of attempts
+ * @returns runner return value
+ */
+export async function pollAsync(runner, delayMs = 500, maxAttempts = undefined) {
+    let attempts = 0;
+    let saveError;
+    while (!maxAttempts || attempts < maxAttempts) {
+        try {
+            const ret = await runner();
+            return ret;
+        }
+        catch (error) {
+            rootLogger.debug(`Error in pollAsync`, { error });
+            saveError = error;
+            attempts += 1;
+            await sleep(delayMs);
+        }
+    }
+    throw saveError;
+}
+/**
+ * An enhanced Promise.race that returns
+ * objects with the promise itself and index
+ * instead of just the resolved value.
+ */
+export async function raceWithContext(promises) {
+    const promisesWithContext = promises.map((p, i) => p.then((resolved) => ({ resolved, promise: p, index: i })));
+    return Promise.race(promisesWithContext);
+}
+/**
+ * Map an async function over a list xs with a given concurrency level
+ * Forked from https://github.com/celo-org/developer-tooling/blob/0c61e7e02c741fe10ecd1d733a33692d324cdc82/packages/sdk/base/src/async.ts#L128
+ *
+ * @param concurrency number of `mapFn` concurrent executions
+ * @param xs list of value
+ * @param mapFn mapping function
+ */
+export async function concurrentMap(concurrency, xs, mapFn) {
+    let res = [];
+    assert(concurrency > 0, 'concurrency must be greater than 0');
+    for (let i = 0; i < xs.length; i += concurrency) {
+        const remaining = xs.length - i;
+        const sliceSize = Math.min(remaining, concurrency);
+        const slice = xs.slice(i, i + sliceSize);
+        res = res.concat(await Promise.all(slice.map((elem, index) => mapFn(elem, i + index))));
+    }
+    return res;
+}
+//# sourceMappingURL=async.js.map

package/dist/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../src/async.ts"],"names":[],"mappings":"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"}

package/dist/async.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async.test.d.ts.map

package/dist/async.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.test.d.ts","sourceRoot":"","sources":["../src/async.test.ts"],"names":[],"mappings":""}

package/dist/async.test.js

@@ -0,0 +1,204 @@
+import { expect } from 'chai';
+import { concurrentMap, fetchWithTimeout, pollAsync, raceWithContext, retryAsync, runWithTimeout, sleep, timeout, } from './async.js';
+describe('Async Utilities', () => {
+    describe('sleep', () => {
+        it('should resolve after sleep duration', async () => {
+            const start = Date.now();
+            await sleep(100);
+            const duration = Date.now() - start;
+            expect(duration).to.be.at.least(95);
+            expect(duration).to.be.lessThan(200);
+        });
+    });
+    describe('timeout', () => {
+        it('should timeout a promise', async () => {
+            const promise = new Promise((resolve) => setTimeout(resolve, 200));
+            try {
+                await timeout(promise, 100);
+                throw new Error('Expected timeout error');
+            }
+            catch (error) {
+                expect(error.message).to.equal('Timeout reached');
+            }
+        });
+    });
+    describe('runWithTimeout', () => {
+        it('should run a callback with a timeout', async () => {
+            const result = await runWithTimeout(100, async () => {
+                await sleep(50);
+                return 'success';
+            });
+            expect(result).to.equal('success');
+        });
+    });
+    describe('fetchWithTimeout', () => {
+        it('should fetch with timeout', async () => {
+            // Mock fetch for testing
+            global.fetch = async () => {
+                await sleep(50);
+                return new Response('ok');
+            };
+            const response = await fetchWithTimeout('https://example.com', {}, 100);
+            expect(await response.text()).to.equal('ok');
+        });
+    });
+    describe('retryAsync', () => {
+        it('should retry until success', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                if (attempt < 3)
+                    throw new Error('fail');
+                return 'success';
+            };
+            const result = await retryAsync(runner, 5, 10);
+            expect(result).to.equal('success');
+        });
+        it('should retry `attempts` times at most', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                throw new Error('fail');
+            };
+            try {
+                await retryAsync(runner, 5, 10);
+                throw new Error('Expected error to be thrown');
+            }
+            catch (error) {
+                expect(error.message).to.equal('fail');
+                expect(attempt).to.equal(5);
+            }
+        });
+        it('should immediately throw error if isRecoverable is false', async () => {
+            let attempts = 0;
+            const runner = async () => {
+                attempts++;
+                const error = new Error('non-recoverable error');
+                error.isRecoverable = false;
+                throw error;
+            };
+            try {
+                await retryAsync(runner, 5, 10);
+                throw new Error('Expected error to be thrown');
+            }
+            catch (error) {
+                expect(error.message).to.equal('non-recoverable error');
+                expect(error.isRecoverable).to.equal(false);
+                expect(attempts).to.equal(1);
+            }
+        });
+        it('should continue retrying if isRecoverable is not set', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                if (attempt < 3)
+                    throw new Error('recoverable error');
+                return 'success';
+            };
+            const result = await retryAsync(runner, 5, 10);
+            expect(result).to.equal('success');
+            expect(attempt).to.equal(3);
+        });
+        it('should continue retrying if isRecoverable is true', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                if (attempt < 3) {
+                    const error = new Error('recoverable error');
+                    error.isRecoverable = true;
+                    throw error;
+                }
+                return 'success';
+            };
+            const result = await retryAsync(runner, 5, 10);
+            expect(result).to.equal('success');
+            expect(attempt).to.equal(3);
+        });
+        it('should execute at least once even with 0 attempts', async () => {
+            let attempts = 0;
+            const runner = async () => {
+                attempts++;
+                return 'success';
+            };
+            const result = await retryAsync(runner, 0, 10);
+            expect(result).to.equal('success');
+            expect(attempts).to.equal(1);
+        });
+        it('should execute at least once even with negative attempts', async () => {
+            let attempts = 0;
+            const runner = async () => {
+                attempts++;
+                return 'success';
+            };
+            const result = await retryAsync(runner, -5, 10);
+            expect(result).to.equal('success');
+            expect(attempts).to.equal(1);
+        });
+    });
+    describe('pollAsync', () => {
+        it('should poll async function until success', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                if (attempt < 3)
+                    throw new Error('fail');
+                return 'success';
+            };
+            const result = await pollAsync(runner, 10, 5);
+            expect(result).to.equal('success');
+        });
+        it('should fail after reaching max retries', async () => {
+            let attempt = 0;
+            const runner = async () => {
+                attempt++;
+                throw new Error('fail');
+            };
+            try {
+                await pollAsync(runner, 10, 3); // Set maxAttempts to 3
+                throw new Error('Expected pollAsync to throw an error');
+            }
+            catch (error) {
+                expect(attempt).to.equal(3); // Ensure it attempted 3 times
+                expect(error.message).to.equal('fail');
+            }
+        });
+    });
+    describe('raceWithContext', () => {
+        it('should race with context', async () => {
+            const promises = [
+                sleep(50).then(() => 'first'),
+                sleep(100).then(() => 'second'),
+            ];
+            const result = await raceWithContext(promises);
+            expect(result.resolved).to.equal('first');
+            expect(result.index).to.equal(0);
+        });
+    });
+    describe('concurrentMap', () => {
+        it('should map concurrently with correct results', async () => {
+            const xs = [1, 2, 3, 4, 5, 6];
+            const mapFn = async (val) => {
+                await new Promise((resolve) => setTimeout(resolve, 50)); // Simulate async work
+                return val * 2;
+            };
+            const result = await concurrentMap(2, xs, mapFn);
+            expect(result).to.deep.equal([2, 4, 6, 8, 10, 12]);
+        });
+        it('should respect concurrency limit', async () => {
+            const xs = [1, 2, 3, 4, 5, 6];
+            const concurrency = 2;
+            let activeTasks = 0;
+            let maxActiveTasks = 0;
+            const mapFn = async (val) => {
+                activeTasks++;
+                maxActiveTasks = Math.max(maxActiveTasks, activeTasks);
+                await new Promise((resolve) => setTimeout(resolve, 50)); // Simulate async work
+                activeTasks--;
+                return val * 2;
+            };
+            await concurrentMap(concurrency, xs, mapFn);
+            expect(maxActiveTasks).to.equal(concurrency);
+        });
+    });
+});
+//# sourceMappingURL=async.test.js.map

package/dist/async.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.test.js","sourceRoot":"","sources":["../src/async.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,EACV,cAAc,EACd,KAAK,EACL,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;gBAClD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;gBAChB,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;YACzC,yBAAyB;YACzB,MAAM,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;gBACxB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;gBAChB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,qBAAqB,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACxE,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzC,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACvC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,QAAQ,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAE9C,CAAC;gBACF,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBACxD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBACtD,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,mBAAmB,CAE1C,CAAC;oBACF,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;oBAC3B,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,QAAQ,EAAE,CAAC;gBACX,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,QAAQ,EAAE,CAAC;gBACX,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzC,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACxB,OAAO,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB;gBACvD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;gBAC3D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,QAAQ,GAAG;gBACf,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;gBAC7B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC;aAChC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;gBAClC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB;gBAC/E,OAAO,GAAG,GAAG,CAAC,CAAC;YACjB,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,MAAM,WAAW,GAAG,CAAC,CAAC;YACtB,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,IAAI,cAAc,GAAG,CAAC,CAAC;YAEvB,MAAM,KAAK,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;gBAClC,WAAW,EAAE,CAAC;gBACd,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;gBACvD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB;gBAC/E,WAAW,EAAE,CAAC;gBACd,OAAO,GAAG,GAAG,CAAC,CAAC;YACjB,CAAC,CAAC;YAEF,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/base58.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="node" resolution-mode="require"/>
+export declare function base58ToBuffer(value: string): Buffer;
+export declare function bufferToBase58(value: Buffer): string;
+export declare function hexOrBase58ToHex(value: string): string;
+//# sourceMappingURL=base58.d.ts.map

package/dist/base58.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../src/base58.ts"],"names":[],"mappings":";AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,UAE3C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,UAE3C;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAI7C"}

package/dist/base58.js

@@ -0,0 +1,15 @@
+import { utils } from 'ethers';
+export function base58ToBuffer(value) {
+    return Buffer.from(utils.base58.decode(value));
+}
+export function bufferToBase58(value) {
+    return utils.base58.encode(value);
+}
+// If the value is already hex (checked by 0x prefix), return it as is.
+// Otherwise, treat it as base58 and convert it to hex.
+export function hexOrBase58ToHex(value) {
+    if (value.startsWith('0x'))
+        return value;
+    return utils.hexlify(base58ToBuffer(value));
+}
+//# sourceMappingURL=base58.js.map

package/dist/base58.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../src/base58.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,uEAAuE;AACvE,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/base58.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base58.test.d.ts.map

package/dist/base58.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.test.d.ts","sourceRoot":"","sources":["../src/base58.test.ts"],"names":[],"mappings":""}

package/dist/base58.test.js

@@ -0,0 +1,31 @@
+import { expect } from 'chai';
+import { utils } from 'ethers';
+import { base58ToBuffer, bufferToBase58, hexOrBase58ToHex } from './base58.js';
+describe('Base58 Utilities', () => {
+    describe('base58ToBuffer', () => {
+        it('should convert a base58 string to a buffer', () => {
+            const base58String = '3mJr7AoUXx2Wqd';
+            const expectedBuffer = Buffer.from(utils.base58.decode(base58String));
+            expect(base58ToBuffer(base58String)).to.deep.equal(expectedBuffer);
+        });
+    });
+    describe('bufferToBase58', () => {
+        it('should convert a buffer to a base58 string', () => {
+            const buffer = Buffer.from([1, 2, 3, 4]);
+            const expectedBase58String = utils.base58.encode(buffer);
+            expect(bufferToBase58(buffer)).to.equal(expectedBase58String);
+        });
+    });
+    describe('hexOrBase58ToHex', () => {
+        it('should return the hex string as is if it starts with 0x', () => {
+            const hexString = '0x1234abcd';
+            expect(hexOrBase58ToHex(hexString)).to.equal(hexString);
+        });
+        it('should convert a base58 string to a hex string', () => {
+            const base58String = '3mJr7AoUXx2Wqd';
+            const expectedHexString = utils.hexlify(Buffer.from(utils.base58.decode(base58String)));
+            expect(hexOrBase58ToHex(base58String)).to.equal(expectedHexString);
+        });
+    });
+});
+//# sourceMappingURL=base58.test.js.map

package/dist/base58.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.test.js","sourceRoot":"","sources":["../src/base58.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,YAAY,GAAG,gBAAgB,CAAC;YACtC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;YACtE,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,SAAS,GAAG,YAAY,CAAC;YAC/B,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,YAAY,GAAG,gBAAgB,CAAC;YACtC,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAC/C,CAAC;YACF,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/base64.d.ts

@@ -0,0 +1,3 @@
+export declare function toBase64(data: any): string | undefined;
+export declare function fromBase64<T>(data: string | string[]): T | undefined;
+//# sourceMappingURL=base64.d.ts.map

package/dist/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAQtD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CASpE"}

package/dist/base64.js

@@ -0,0 +1,25 @@
+import { rootLogger } from './logging.js';
+export function toBase64(data) {
+    try {
+        if (!data)
+            throw new Error('No data to encode');
+        return btoa(JSON.stringify(data));
+    }
+    catch {
+        rootLogger.error('Unable to serialize + encode data to base64', data);
+        return undefined;
+    }
+}
+export function fromBase64(data) {
+    try {
+        if (!data)
+            throw new Error('No data to decode');
+        const msg = Array.isArray(data) ? data[0] : data;
+        return JSON.parse(atob(msg));
+    }
+    catch {
+        rootLogger.error('Unable to decode + deserialize data from base64', data);
+        return undefined;
+    }
+}
+//# sourceMappingURL=base64.js.map

package/dist/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,IAAS;IAChC,IAAI,CAAC;QACH,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,KAAK,CAAC,6CAA6C,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,IAAuB;IACnD,IAAI,CAAC;QACH,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,KAAK,CAAC,iDAAiD,EAAE,IAAI,CAAC,CAAC;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/base64.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base64.test.d.ts.map

package/dist/base64.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.test.d.ts","sourceRoot":"","sources":["../src/base64.test.ts"],"names":[],"mappings":""}

package/dist/base64.test.js

@@ -0,0 +1,54 @@
+import { expect } from 'chai';
+import Sinon from 'sinon';
+import { fromBase64, toBase64 } from './base64.js';
+import { rootLogger } from './logging.js';
+describe('Base64 Utility Functions', () => {
+    let loggerStub;
+    beforeEach(() => {
+        loggerStub = Sinon.stub(rootLogger, 'error');
+    });
+    afterEach(() => {
+        loggerStub.restore();
+    });
+    describe('toBase64', () => {
+        it('should encode a valid object to a base64 string', () => {
+            const data = { key: 'value' };
+            const result = toBase64(data);
+            expect(result).to.be.a('string');
+            expect(result).to.equal(btoa(JSON.stringify(data)));
+        });
+        it('should return undefined for null or undefined input', () => {
+            expect(toBase64(null)).to.be.undefined;
+            expect(toBase64(undefined)).to.be.undefined;
+        });
+        it('should log an error for invalid input', () => {
+            toBase64(null);
+            expect(loggerStub.calledOnce).to.be.true;
+            expect(loggerStub.calledWith('Unable to serialize + encode data to base64', null)).to.be.true;
+        });
+    });
+    describe('fromBase64', () => {
+        it('should decode a valid base64 string to an object', () => {
+            const data = { key: 'value' };
+            const base64String = btoa(JSON.stringify(data));
+            const result = fromBase64(base64String);
+            expect(result).to.deep.equal(data);
+        });
+        it('should return undefined for null or undefined input', () => {
+            expect(fromBase64(null)).to.be.undefined;
+            expect(fromBase64(undefined)).to.be.undefined;
+        });
+        it('should handle array input and decode the first element', () => {
+            const data = { key: 'value' };
+            const base64String = btoa(JSON.stringify(data));
+            const result = fromBase64([base64String, 'anotherString']);
+            expect(result).to.deep.equal(data);
+        });
+        it('should log an error for invalid base64 input', () => {
+            fromBase64('invalidBase64');
+            expect(loggerStub.calledOnce).to.be.true;
+            expect(loggerStub.calledWith('Unable to decode + deserialize data from base64', 'invalidBase64')).to.be.true;
+        });
+    });
+});
+//# sourceMappingURL=base64.test.js.map

package/dist/base64.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.test.js","sourceRoot":"","sources":["../src/base64.test.ts"],"names":[],"mappings":"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"}

package/dist/big-numbers.d.ts

@@ -0,0 +1,50 @@
+import { BigNumber } from 'bignumber.js';
+import { FixedNumber } from 'ethers';
+/**
+ * Check if a value is bigNumberish (e.g. valid numbers, bigNumber).
+ * @param value The value to check.
+ * @returns true/false.
+ */
+export declare function isBigNumberish(value: BigNumber.Value | undefined | null): boolean;
+/**
+ * Check if a value (e.g. hex string or number) is zeroish (0, 0x0, 0x00, etc.).
+ * @param value The value to check.
+ * @returns true/false.
+ */
+export declare function isZeroish(value: BigNumber.Value): boolean;
+/**
+ * Converts a BigNumber to a FixedNumber of the format fixed128x18.
+ * @param big The BigNumber to convert.
+ * @returns A FixedNumber representation of a BigNumber.
+ */
+export declare function bigToFixed(big: BigNumber.Value): FixedNumber;
+/**
+ * Converts a FixedNumber (of any format) to a BigNumber.
+ * @param fixed The FixedNumber to convert.
+ * @param ceil If true, the ceiling of fixed is used. Otherwise, the floor is used.
+ * @returns A BigNumber representation of a FixedNumber.
+ */
+export declare function fixedToBig(fixed: FixedNumber, ceil?: boolean): BigNumber;
+/**
+ * Multiplies a BigNumber by a FixedNumber, returning the BigNumber product.
+ * @param big The BigNumber to multiply.
+ * @param fixed The FixedNumber to multiply.
+ * @param ceil If true, the ceiling of the product is used. Otherwise, the floor is used.
+ * @returns The BigNumber product in string type.
+ */
+export declare function mulBigAndFixed(big: BigNumber.Value, fixed: FixedNumber, ceil?: boolean): string;
+/**
+ * Return the smaller in the given two BigNumbers.
+ * @param bn1 The BigNumber to compare.
+ * @param bn2 The BigNumber to compare.
+ * @returns The smaller BigNumber in string type.
+ */
+export declare function BigNumberMin(bn1: BigNumber.Value, bn2: BigNumber.Value): string;
+/**
+ * Return the bigger in the given two BigNumbers.
+ * @param bn1 The BigNumber to compare.
+ * @param bn2 The BigNumber to compare.
+ * @returns The bigger BigNumber in string type.
+ */
+export declare function BigNumberMax(bn1: BigNumber.Value, bn2: BigNumber.Value): string;
+//# sourceMappingURL=big-numbers.d.ts.map

package/dist/big-numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-numbers.d.ts","sourceRoot":"","sources":["../src/big-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAKrC;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,SAAS,GAAG,IAAI,GACxC,OAAO,CAOT;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,OAAO,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,GAAG,WAAW,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,UAAQ,GAAG,SAAS,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,CAAC,KAAK,EACpB,KAAK,EAAE,WAAW,EAClB,IAAI,UAAQ,GACX,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,CAAC,KAAK,EACpB,GAAG,EAAE,SAAS,CAAC,KAAK,GACnB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,CAAC,KAAK,EACpB,GAAG,EAAE,SAAS,CAAC,KAAK,GACnB,MAAM,CAER"}