@0xkoaj/sdk 0.0.1-beta.1 → 0.0.1-beta.3

package/dist/shared/auto-update-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update-cache.js","sourceRoot":"","sources":["../../src/shared/auto-update-cache.ts"],"names":[],"mappings":";;;;;;AACA,4CAAoB;AAMpB,MAAM,kBAAkB,GAAe,UAAU,CAAC;AAOlD,MAAa,eAAe;IAK1B,YAAY,EAAE,SAAS,EAAE,MAAM,EAAiC;QAC9D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAElD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAA,YAAE,EAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAA,YAAE,EAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEnH,IAAI,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAEzE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,OAAO,GAAG,CAAC,EAAE,WAAW,EAA8B,EAAE,EAAE,CAC9D,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,IAAI,GAAG,GAAG,IAAA,YAAE,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAE5I,OAAO,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC1D,CAAC;YACD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAA,YAAE,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAA,YAAE,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,IAAI,kBAAkB,CAAC,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;CACF;AArCD,0CAqCC"}

package/dist/shared/concurrent-lru-cache.d.ts

@@ -0,0 +1,66 @@
+import { TimeString } from '../types';
+import { StringValue } from 'ms';
+export type ExpirationConfigOptions = {
+    useCachedValue: 'always' | {
+        ifUnder: StringValue;
+    };
+    useCachedValueIfCalculationFailed: 'always' | {
+        ifUnder: StringValue;
+    };
+};
+export type CacheConfig = {
+    expiration: ExpirationConfigOptions;
+    maxSize: number;
+};
+type ValidKey = string | number | symbol;
+type CacheConstructorParams<Context, Key extends ValidKey, Value> = {
+    calculate: (context: Context, keys: Key[]) => Promise<Record<Key, Value>>;
+    config: CacheConfig;
+};
+export declare class ConcurrentLRUCache<Key extends ValidKey, Value> {
+    private readonly cache;
+    constructor({ calculate, config, }: {
+        calculate: (keys: Key[]) => Promise<Record<Key, Value>>;
+    } & {
+        config: CacheConfig;
+    });
+    getOrCalculateSingle({ key, expirationConfig, timeout, }: {
+        key: Key;
+        expirationConfig?: Partial<ExpirationConfigOptions>;
+        timeout?: TimeString;
+    }): Promise<Value | undefined>;
+    getOrCalculate({ keys, expirationConfig, timeout, }: {
+        keys: Key[];
+        expirationConfig?: Partial<ExpirationConfigOptions>;
+        timeout?: TimeString;
+    }): Promise<Record<Key, Value>>;
+    holdsValidValue(key: Key, expirationConfig?: ExpirationConfigOptions): boolean;
+    holdsValidValues(keys: Key[], expirationConfig?: ExpirationConfigOptions): Record<Key, boolean>;
+    invalidate(keys: Key[]): void;
+    populate(values: Record<Key, Value>): void;
+}
+export declare class ConcurrentLRUCacheWithContext<Context, Key extends ValidKey, Value> {
+    private readonly calculate;
+    private readonly storableKeyMapper;
+    private readonly expirationConfig;
+    private readonly beingCalculated;
+    private readonly cache;
+    constructor({ calculate, config }: CacheConstructorParams<Context, Key, Value>);
+    getOrCalculateSingle({ key, context, expirationConfig, timeout, }: {
+        key: Key;
+        context: Context;
+        expirationConfig?: Partial<ExpirationConfigOptions>;
+        timeout?: TimeString;
+    }): Promise<Value | undefined>;
+    getOrCalculate({ keys, context, expirationConfig, timeout, }: {
+        keys: Key[];
+        context: Context;
+        expirationConfig?: Partial<ExpirationConfigOptions>;
+        timeout?: TimeString;
+    }): Promise<Record<Key, Value>>;
+    holdsValidValue(key: Key, expirationConfig?: ExpirationConfigOptions): boolean;
+    holdsValidValues(keys: Key[], expirationConfig?: ExpirationConfigOptions): Record<Key, boolean>;
+    invalidate(keys: Key[]): void;
+    populate(values: Record<Key, Value>): void;
+}
+export {};

package/dist/shared/concurrent-lru-cache.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConcurrentLRUCacheWithContext = exports.ConcurrentLRUCache = void 0;
+const ms_1 = __importDefault(require("ms"));
+const lru_cache_1 = require("lru-cache");
+const timeouts_1 = require("./timeouts");
+class ConcurrentLRUCache {
+    constructor({ calculate, config, }) {
+        this.cache = new ConcurrentLRUCacheWithContext({
+            calculate: (_, keys) => calculate(keys),
+            config,
+        });
+    }
+    async getOrCalculateSingle({ key, expirationConfig, timeout, }) {
+        return this.cache.getOrCalculateSingle({ context: undefined, key, expirationConfig, timeout });
+    }
+    async getOrCalculate({ keys, expirationConfig, timeout, }) {
+        return this.cache.getOrCalculate({ context: undefined, keys, expirationConfig, timeout });
+    }
+    holdsValidValue(key, expirationConfig) {
+        return this.cache.holdsValidValue(key, expirationConfig);
+    }
+    holdsValidValues(keys, expirationConfig) {
+        return this.cache.holdsValidValues(keys, expirationConfig);
+    }
+    invalidate(keys) {
+        return this.cache.invalidate(keys);
+    }
+    populate(values) {
+        this.cache.populate(values);
+    }
+}
+exports.ConcurrentLRUCache = ConcurrentLRUCache;
+class ConcurrentLRUCacheWithContext {
+    constructor({ calculate, config }) {
+        this.beingCalculated = new Map();
+        const isInvalid = config.expiration.useCachedValue !== 'always' &&
+            config.expiration.useCachedValueIfCalculationFailed !== 'always' &&
+            (0, ms_1.default)(config.expiration.useCachedValue.ifUnder) > (0, ms_1.default)(config.expiration.useCachedValueIfCalculationFailed.ifUnder);
+        if (isInvalid)
+            throw new Error(`'useCachedValue' must be lower or equal than 'useCachedValueIfCalculationFailed'`);
+        this.calculate = calculate;
+        this.storableKeyMapper = (key) => key.toString().toLowerCase();
+        this.expirationConfig = config.expiration;
+        this.cache = new lru_cache_1.LRUCache({ max: config.maxSize });
+    }
+    async getOrCalculateSingle({ key, context, expirationConfig, timeout, }) {
+        const result = await this.getOrCalculate({ keys: [key], context, expirationConfig, timeout });
+        return result[key];
+    }
+    async getOrCalculate({ keys, context, expirationConfig, timeout, }) {
+        const options = { ...this.expirationConfig, ...expirationConfig };
+        const storableKeys = Object.fromEntries(keys.map((key) => [key, this.storableKeyMapper(key)]));
+        const now = Date.now();
+        const useCachedValue = ({ lastUpdated }) => options.useCachedValue === 'always' || lastUpdated >= now - (0, ms_1.default)(options.useCachedValue.ifUnder);
+        const notInCache = [];
+        const result = {};
+        // Check if we can use cached version or we need to calculate values
+        for (const key of keys) {
+            const valueInCache = this.cache.get(storableKeys[key]);
+            if (valueInCache && useCachedValue(valueInCache)) {
+                result[key] = valueInCache.value;
+            }
+            else {
+                notInCache.push(key);
+            }
+        }
+        // Nothing else to calculate
+        if (notInCache.length === 0)
+            return result;
+        // Try to calculate missing values
+        const toCalculate = notInCache.filter((key) => !this.beingCalculated.has(storableKeys[key]));
+        if (toCalculate.length > 0) {
+            const calculated = this.calculate(context, toCalculate);
+            for (const key of toCalculate) {
+                const storableKey = storableKeys[key];
+                const promise = calculated
+                    .then((result) => {
+                    const value = result[key];
+                    if (value !== undefined) {
+                        this.cache.set(storableKey, { lastUpdated: Date.now(), value });
+                        return value;
+                    }
+                    return undefined;
+                })
+                    .catch(() => undefined)
+                    .finally(() => this.beingCalculated.delete(storableKey));
+                this.beingCalculated.set(storableKey, promise);
+            }
+        }
+        // Wait for all calculations
+        const calculationPromises = notInCache.map(async (key) => [
+            key,
+            // Note: we add the timeout here so that even though this particular request might timeout, the result is still being made in the background
+            //       Once it's done, we'll fill the cache for the next time
+            await (0, timeouts_1.timeoutPromise)(this.beingCalculated.get(storableKeys[key]) ?? Promise.resolve(undefined), timeout).catch(() => undefined),
+        ]);
+        const calculated = Object.fromEntries(await Promise.all(calculationPromises));
+        const nowAgain = Date.now();
+        const useCachedValueIfCalculationFailed = ({ lastUpdated }) => options.useCachedValueIfCalculationFailed === 'always' || lastUpdated >= nowAgain - (0, ms_1.default)(options.useCachedValueIfCalculationFailed.ifUnder);
+        // Check all values again
+        for (const key of notInCache) {
+            // Check if we could calculate it
+            const calculatedValue = calculated[key];
+            if (calculatedValue !== undefined) {
+                result[key] = calculatedValue;
+            }
+            else {
+                // If we couldn't calculate it, check if we had an old value stored in the cache we can still use
+                const storableKey = storableKeys[key];
+                const valueInCache = this.cache.get(storableKey);
+                if (valueInCache) {
+                    if (useCachedValueIfCalculationFailed(valueInCache)) {
+                        // If can use it, then add it to result
+                        result[key] = valueInCache.value;
+                    }
+                    else {
+                        // If not, then delete the value
+                        this.cache.delete(storableKey);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    holdsValidValue(key, expirationConfig) {
+        const { [key]: holdsValidValue } = this.holdsValidValues([key], expirationConfig);
+        return holdsValidValue;
+    }
+    holdsValidValues(keys, expirationConfig) {
+        const options = { ...this.expirationConfig, ...expirationConfig };
+        const now = Date.now();
+        const isValidEntry = ({ lastUpdated }) => options.useCachedValue === 'always' || lastUpdated >= now - (0, ms_1.default)(options.useCachedValue.ifUnder);
+        const entries = keys.map((key) => {
+            const entry = this.cache.get(this.storableKeyMapper(key));
+            const holdsValidValue = entry ? isValidEntry(entry) : false;
+            return [key, holdsValidValue];
+        });
+        return Object.fromEntries(entries);
+    }
+    invalidate(keys) {
+        keys.forEach((key) => this.cache.delete(this.storableKeyMapper(key)));
+    }
+    populate(values) {
+        const now = Date.now();
+        for (const key in values) {
+            const storableKey = this.storableKeyMapper(key);
+            this.cache.set(storableKey, { lastUpdated: now, value: values[key] });
+        }
+    }
+}
+exports.ConcurrentLRUCacheWithContext = ConcurrentLRUCacheWithContext;
+//# sourceMappingURL=concurrent-lru-cache.js.map

package/dist/shared/concurrent-lru-cache.js.map

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

package/dist/shared/constants.d.ts

@@ -0,0 +1,12 @@
+export declare enum Addresses {
+    NATIVE_TOKEN = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    ZERO_ADDRESS = "0x0000000000000000000000000000000000000000"
+}
+export declare enum SolanaAddresses {
+    NATIVE_SOL = "So11111111111111111111111111111111111111112",// Wrapped SOL mint (also represents native SOL)
+    USDC = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+    USDT = "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
+}
+export declare const Uint: {
+    MAX_256: bigint;
+};

package/dist/shared/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Uint = exports.SolanaAddresses = exports.Addresses = void 0;
+// EVM Addresses
+var Addresses;
+(function (Addresses) {
+    Addresses["NATIVE_TOKEN"] = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+    Addresses["ZERO_ADDRESS"] = "0x0000000000000000000000000000000000000000";
+})(Addresses || (exports.Addresses = Addresses = {}));
+// Solana Addresses
+var SolanaAddresses;
+(function (SolanaAddresses) {
+    SolanaAddresses["NATIVE_SOL"] = "So11111111111111111111111111111111111111112";
+    SolanaAddresses["USDC"] = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+    SolanaAddresses["USDT"] = "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
+})(SolanaAddresses || (exports.SolanaAddresses = SolanaAddresses = {}));
+exports.Uint = {
+    MAX_256: 2n ** 256n - 1n,
+};
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AAChB,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wEAA2D,CAAA;IAC3D,wEAA2D,CAAA;AAC7D,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED,mBAAmB;AACnB,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,6EAA0D,CAAA;IAC1D,wEAAqD,CAAA;IACrD,wEAAqD,CAAA;AACvD,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAEY,QAAA,IAAI,GAAG;IAClB,OAAO,EAAE,EAAE,IAAI,IAAI,GAAG,EAAE;CACzB,CAAC"}

package/dist/shared/contracts.d.ts

@@ -0,0 +1,27 @@
+import { Address as ViemAddress } from 'viem';
+import { ChainId, Address, Chain } from '../types';
+export declare class Contract {
+    private readonly defaultAddress;
+    private readonly overrides;
+    constructor({ defaultAddress, overrides }: {
+        defaultAddress: ContractAddress | undefined;
+        overrides: Record<ChainId, ContractAddress>;
+    });
+    address(chain: ChainId | Chain): ContractAddress;
+    static with({ defaultAddress }: {
+        defaultAddress: Address;
+    }): ContractBuilder;
+    static withNoDefault(): ContractBuilder;
+}
+declare class ContractBuilder {
+    private readonly overrides;
+    private readonly defaultAddress;
+    constructor(defaultAddress?: Address);
+    and({ address, onChain }: {
+        address: Address;
+        onChain: ChainId | Chain;
+    }): this;
+    build(): Contract;
+}
+type ContractAddress = Lowercase<Address> & ViemAddress;
+export {};

package/dist/shared/contracts.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Contract = void 0;
+const utils_1 = require("./utils");
+class Contract {
+    constructor({ defaultAddress, overrides }) {
+        this.overrides = {};
+        this.defaultAddress = defaultAddress;
+        this.overrides = overrides;
+    }
+    address(chain) {
+        const chainId = typeof chain === 'number' || typeof chain === 'string' ? chain : chain.chainId;
+        const address = this.overrides[chainId] ?? this.defaultAddress;
+        if (!address) {
+            throw new Error(`Found no address on chain with id ${chainId}`);
+        }
+        return address;
+    }
+    static with({ defaultAddress }) {
+        return new ContractBuilder(defaultAddress);
+    }
+    static withNoDefault() {
+        return new ContractBuilder();
+    }
+}
+exports.Contract = Contract;
+class ContractBuilder {
+    constructor(defaultAddress) {
+        this.overrides = {};
+        this.defaultAddress = defaultAddress ? (0, utils_1.toLower)(defaultAddress) : undefined;
+    }
+    and({ address, onChain }) {
+        const chainId = typeof onChain === 'number' || typeof onChain === 'string' ? onChain : onChain.chainId;
+        this.overrides[chainId] = (0, utils_1.toLower)(address);
+        return this;
+    }
+    build() {
+        return new Contract({ defaultAddress: this.defaultAddress, overrides: this.overrides });
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/shared/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/shared/contracts.ts"],"names":[],"mappings":";;;AAEA,mCAAkC;AAElC,MAAa,QAAQ;IAInB,YAAY,EAAE,cAAc,EAAE,SAAS,EAAgG;QAFtH,cAAS,GAAqC,EAAE,CAAC;QAGhE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,KAAsB;QAC5B,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/F,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,EAA+B;QACzD,OAAO,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;CACF;AAzBD,4BAyBC;AAED,MAAM,eAAe;IAInB,YAAY,cAAwB;QAHnB,cAAS,GAAqC,EAAE,CAAC;QAIhE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,CAAE,IAAA,eAAO,EAAC,cAAc,CAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,CAAC;IAED,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAkD;QACtE,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACvG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAA,eAAO,EAAC,OAAO,CAAoB,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,IAAI,QAAQ,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1F,CAAC;CACF"}

package/dist/shared/deferred.d.ts

@@ -0,0 +1,12 @@
+export declare class Deferred<T> implements Promise<T> {
+    private _resolveSelf;
+    private _rejectSelf;
+    private promise;
+    constructor();
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<T | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<T>;
+    resolve(val: T): void;
+    reject(reason: any): void;
+    [Symbol.toStringTag]: 'Promise';
+}

package/dist/shared/deferred.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deferred = void 0;
+class Deferred {
+    constructor() {
+        // Will overwrite these below, but the compile can't tell
+        this._resolveSelf = () => { };
+        this._rejectSelf = () => { };
+        this.promise = new Promise((resolve, reject) => {
+            this._resolveSelf = resolve;
+            this._rejectSelf = reject;
+        });
+    }
+    then(onfulfilled, onrejected) {
+        return this.promise.then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.promise.catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.promise.finally(onfinally);
+    }
+    resolve(val) {
+        this._resolveSelf(val);
+    }
+    reject(reason) {
+        this._rejectSelf(reason);
+    }
+}
+exports.Deferred = Deferred;
+Symbol.toStringTag;
+//# sourceMappingURL=deferred.js.map

package/dist/shared/deferred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../../src/shared/deferred.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IAKnB;QACE,yDAAyD;QACzD,IAAI,CAAC,YAAY,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,IAAI,CACT,WAAiF,EACjF,UAAmF;QAEnF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAEM,KAAK,CAAkB,UAAiF;QAC7G,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAEM,OAAO,CAAC,SAA2C;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAEM,OAAO,CAAC,GAAM;QACnB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACM,MAAM,CAAC,MAAW;QACvB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;CAIF;AAvCD,4BAuCC;AADE,MAAM,CAAC,WAAW"}

package/dist/shared/defi-llama.d.ts

@@ -0,0 +1,72 @@
+import { ChainId, TimeString, TokenAddress, Timestamp } from '../types';
+import { IFetchService } from '../services/fetch/types';
+import { PriceResult } from '../services/prices';
+export declare class DefiLlamaClient {
+    private readonly fetch;
+    constructor(fetch: IFetchService);
+    supportedChains(): ChainId[];
+    getCurrentTokenData({ tokens, config, }: {
+        tokens: {
+            chainId: ChainId;
+            token: TokenAddress;
+        }[];
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, Required<FetchTokenResult>>>>;
+    getHistoricalTokenData({ tokens, timestamp, searchWidth, config, }: {
+        tokens: {
+            chainId: ChainId;
+            token: TokenAddress;
+        }[];
+        timestamp: Timestamp;
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<string, Required<FetchTokenResult>>>>;
+    getChart({ tokens, span, period, bound, searchWidth, config, }: {
+        tokens: {
+            chainId: ChainId;
+            token: TokenAddress;
+        }[];
+        span: number;
+        period: TimeString;
+        bound: {
+            from: Timestamp;
+        } | {
+            upTo: Timestamp | 'now';
+        };
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, PriceResult[]>>>;
+    getBulkHistoricalTokenData({ tokens, searchWidth, config, }: {
+        tokens: {
+            chainId: ChainId;
+            token: TokenAddress;
+            timestamp: Timestamp;
+        }[];
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<string, Record<number, PriceResult>>>>;
+    getClosestBlock(chainId: ChainId, timestamp: Timestamp): Promise<{
+        block: bigint;
+        timestamp: any;
+    }>;
+    private fetchAndMapPrices;
+    private fetchAndMapTokens;
+    private fetchTokens;
+}
+export declare function toChainId(key: string): ChainId;
+type FetchTokenResult = {
+    decimals?: number;
+    price: number;
+    symbol: string;
+    timestamp: number;
+    confidence: number;
+};
+export {};