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

package/dist/services/metadata/metadata-service.d.ts

@@ -0,0 +1,23 @@
+import { ChainId, DefaultRequirements, FieldsRequirements, TimeString, TokenAddress } from '../../types';
+import { IMetadataService, IMetadataSource, MetadataInput } from './types';
+export declare class MetadataService<TokenMetadata extends object> implements IMetadataService<TokenMetadata> {
+    private readonly metadataSource;
+    constructor(metadataSource: IMetadataSource<TokenMetadata>);
+    supportedChains(): ChainId[];
+    supportedProperties(): Record<ChainId, import("../../types").SupportInChain<TokenMetadata>>;
+    getMetadataInChain<Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>>({ chainId, tokens, config, }: {
+        chainId: ChainId;
+        tokens: TokenAddress[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<string, import("./types").MetadataResult<TokenMetadata, Requirements>>>;
+    getMetadata<Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>>({ tokens, config, }: {
+        tokens: MetadataInput[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<string, import("./types").MetadataResult<TokenMetadata, Requirements>>>>;
+}

package/dist/services/metadata/metadata-service.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataService = void 0;
+const requirements_and_support_1 = require("../../shared/requirements-and-support");
+const timeouts_1 = require("../../shared/timeouts");
+class MetadataService {
+    constructor(metadataSource) {
+        this.metadataSource = metadataSource;
+    }
+    supportedChains() {
+        return Object.keys(this.supportedProperties()).map(Number);
+    }
+    supportedProperties() {
+        return this.metadataSource.supportedProperties();
+    }
+    async getMetadataInChain({ chainId, tokens, config, }) {
+        const result = await this.getMetadata({ tokens: tokens.map((token) => ({ chainId, token })), config });
+        return result[chainId] ?? {};
+    }
+    async getMetadata({ tokens, config, }) {
+        if (tokens.length === 0)
+            return {};
+        const chains = [...new Set(tokens.map(({ chainId }) => chainId))];
+        (0, requirements_and_support_1.validateRequirements)(this.supportedProperties(), chains, config?.fields);
+        const response = await (0, timeouts_1.timeoutPromise)(this.metadataSource.getMetadata({ tokens, config }), config?.timeout);
+        validateResponse(tokens, response, config?.fields);
+        return response;
+    }
+}
+exports.MetadataService = MetadataService;
+function validateResponse(request, response, requirements) {
+    for (const { chainId, token } of request) {
+        if (!(0, requirements_and_support_1.doesResponseMeetRequirements)(response[chainId]?.[token], requirements)) {
+            throw new Error('Failed to fetch metadata that meets the given requirements');
+        }
+    }
+}
+//# sourceMappingURL=metadata-service.js.map

package/dist/services/metadata/metadata-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-service.js","sourceRoot":"","sources":["../../../src/services/metadata/metadata-service.ts"],"names":[],"mappings":";;;AAAA,+EAAsG;AACtG,+CAAkD;AAIlD,MAAa,eAAe;IAC1B,YAA6B,cAA8C;QAA9C,mBAAc,GAAd,cAAc,CAAgC;IAAG,CAAC;IAE/E,eAAe;QACb,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAA8F,EACpH,OAAO,EACP,MAAM,EACN,MAAM,GAKP;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACvG,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CAA8F,EAC7G,MAAM,EACN,MAAM,GAIP;QACC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClE,IAAA,+CAAoB,EAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAc,EAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5G,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAtCD,0CAsCC;AAED,SAAS,gBAAgB,CACvB,OAAwB,EACxB,QAAuD,EACvD,YAAsC;IAEtC,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,IAAA,uDAA4B,EAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/services/metadata/metadata-sources/cached-metadata-source.d.ts

@@ -0,0 +1,17 @@
+import { ChainId, FieldsRequirements, TimeString } from '../../../types';
+import { CacheConfig } from '../../../shared/concurrent-lru-cache';
+import { IMetadataSource, MetadataInput, MetadataResult } from '../types';
+export declare class CachedMetadataSource<TokenMetadata extends object> implements IMetadataSource<TokenMetadata> {
+    private readonly source;
+    private readonly cache;
+    constructor(source: IMetadataSource<TokenMetadata>, config: CacheConfig);
+    getMetadata<Requirements extends FieldsRequirements<TokenMetadata>>({ tokens, config, }: {
+        tokens: MetadataInput[];
+        config?: {
+            timeout?: TimeString;
+            fields?: Requirements;
+        };
+    }): Promise<Record<ChainId, Record<string, MetadataResult<TokenMetadata, Requirements>>>>;
+    supportedProperties(): Record<ChainId, import("../../../types").SupportInChain<TokenMetadata>>;
+    private fetchMetadata;
+}

package/dist/services/metadata/metadata-sources/cached-metadata-source.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachedMetadataSource = void 0;
+const concurrent_lru_cache_1 = require("../../../shared/concurrent-lru-cache");
+const requirements_and_support_1 = require("../../../shared/requirements-and-support");
+class CachedMetadataSource {
+    constructor(source, config) {
+        this.source = source;
+        this.cache = new concurrent_lru_cache_1.ConcurrentLRUCacheWithContext({
+            calculate: (context, tokensInChain) => this.fetchMetadata(tokensInChain, context),
+            config,
+        });
+    }
+    async getMetadata({ tokens, config, }) {
+        const chainIds = [...new Set(tokens.map(({ chainId }) => chainId))];
+        const support = (0, requirements_and_support_1.combineSupportInChains)(chainIds, this.supportedProperties());
+        const fieldRequirements = (0, requirements_and_support_1.calculateFieldRequirements)(support, config?.fields);
+        const requiredFields = Object.entries(fieldRequirements)
+            .filter(([, requirement]) => requirement === 'required')
+            .map(([field]) => field);
+        const tokensInChain = addressesToTokensInChain(tokens, requiredFields);
+        const result = await this.cache.getOrCalculate({
+            context: config,
+            keys: tokensInChain,
+            timeout: config?.timeout,
+        });
+        return tokenInChainRecordToChainAndAddress(result);
+    }
+    supportedProperties() {
+        return this.source.supportedProperties();
+    }
+    async fetchMetadata(tokensInChain, context) {
+        const { tokens, requiredFields } = tokensInChainToAddresses(tokensInChain);
+        const requirements = Object.fromEntries(requiredFields.map((field) => [field, 'required']));
+        // We set the default to best effort here, even if it wasn't set on the original request. The idea is that we try our best to fetch all properties,
+        // so that if we have a future request with the same required fields and best effort is set, then we can use the cached values
+        const metadata = (await this.source.getMetadata({
+            tokens,
+            config: { timeout: context?.timeout, fields: { requirements, default: 'best effort' } },
+        }));
+        return chainAndAddressRecordToTokenInChain(metadata, requiredFields);
+    }
+}
+exports.CachedMetadataSource = CachedMetadataSource;
+function addressesToTokensInChain(tokens, requiredFields) {
+    return tokens.map(({ chainId, token }) => toTokenInChain(chainId, token, requiredFields));
+}
+function tokensInChainToAddresses(tokensInChain) {
+    const result = [];
+    let requiredFieldsResult = [];
+    for (const tokenInChain of tokensInChain) {
+        const { chainId, address, requiredFields } = fromTokenInChain(tokenInChain);
+        requiredFieldsResult = requiredFields; // All tokens should have the same required fields
+        result.push({ chainId, token: address });
+    }
+    return { tokens: result, requiredFields: requiredFieldsResult };
+}
+function tokenInChainRecordToChainAndAddress(record) {
+    const result = {};
+    for (const [tokenInChain, token] of Object.entries(record)) {
+        const { chainId, address } = fromTokenInChain(tokenInChain);
+        if (!(chainId in result)) {
+            result[chainId] = {};
+        }
+        result[chainId][address] = token;
+    }
+    return result;
+}
+function chainAndAddressRecordToTokenInChain(record, requiredFields) {
+    const entries = Object.entries(record).flatMap(([chainId, record]) => Object.entries(record).map(([address, token]) => [
+        toTokenInChain(Number(chainId), address, requiredFields),
+        token,
+    ]));
+    return Object.fromEntries(entries);
+}
+function toTokenInChain(chainId, address, requiredFields) {
+    return `${chainId}-${address}-${requiredFields.join(',')}`;
+}
+function fromTokenInChain(tokenInChain) {
+    const [chainId, address, requiredFields] = tokenInChain.split('-');
+    return {
+        chainId: Number(chainId),
+        address,
+        requiredFields: requiredFields.length > 0 ? requiredFields.split(',') : [],
+    };
+}
+//# sourceMappingURL=cached-metadata-source.js.map

package/dist/services/metadata/metadata-sources/cached-metadata-source.js.map

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

package/dist/services/metadata/metadata-sources/defi-llama-metadata-source.d.ts

@@ -0,0 +1,16 @@
+import { ChainId, FieldsRequirements, SupportInChain, TimeString } from '../../../types';
+import { IFetchService } from '../../fetch/types';
+import { BaseTokenMetadata, IMetadataSource, MetadataInput, MetadataResult } from '../types';
+export declare class DefiLlamaMetadataSource implements IMetadataSource<BaseTokenMetadata> {
+    private readonly defiLlama;
+    constructor(fetch: IFetchService);
+    getMetadata<Requirements extends FieldsRequirements<BaseTokenMetadata>>(params: {
+        tokens: MetadataInput[];
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<string, MetadataResult<BaseTokenMetadata, Requirements>>>>;
+    supportedProperties(): {
+        [k: string]: SupportInChain<BaseTokenMetadata>;
+    };
+}

package/dist/services/metadata/metadata-sources/defi-llama-metadata-source.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefiLlamaMetadataSource = void 0;
+const defi_llama_1 = require("../../../shared/defi-llama");
+class DefiLlamaMetadataSource {
+    constructor(fetch) {
+        this.defiLlama = new defi_llama_1.DefiLlamaClient(fetch);
+    }
+    async getMetadata(params) {
+        const result = {};
+        const data = await this.defiLlama.getCurrentTokenData(params);
+        for (const [chainIdString, tokens] of Object.entries(data)) {
+            const chainId = Number(chainIdString);
+            result[chainId] = {};
+            for (const [address, { confidence, timestamp, price, ...metadata }] of Object.entries(tokens)) {
+                result[chainId][address] = metadata;
+            }
+        }
+        return result;
+    }
+    supportedProperties() {
+        const properties = { symbol: 'present', decimals: 'present' };
+        return Object.fromEntries(this.defiLlama.supportedChains().map((chainId) => [chainId, properties]));
+    }
+}
+exports.DefiLlamaMetadataSource = DefiLlamaMetadataSource;
+//# sourceMappingURL=defi-llama-metadata-source.js.map

package/dist/services/metadata/metadata-sources/defi-llama-metadata-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defi-llama-metadata-source.js","sourceRoot":"","sources":["../../../../src/services/metadata/metadata-sources/defi-llama-metadata-source.ts"],"names":[],"mappings":";;;AAGA,mDAAqD;AAErD,MAAa,uBAAuB;IAGlC,YAAY,KAAoB;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,4BAAe,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,WAAW,CAA6D,MAG7E;QACC,MAAM,MAAM,GAA6D,EAAE,CAAC;QAC5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9F,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,MAAgG,CAAC;IAC1G,CAAC;IAED,mBAAmB;QACjB,MAAM,UAAU,GAAsC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjG,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtG,CAAC;CACF;AA3BD,0DA2BC"}

package/dist/services/metadata/metadata-sources/fallback-metadata-source.d.ts

@@ -0,0 +1,14 @@
+import { ChainId, FieldsRequirements, TimeString } from '../../../types';
+import { IMetadataSource, MergeMetadata, MetadataInput, MetadataResult } from '../types';
+export declare class FallbackMetadataSource<Sources extends IMetadataSource<object>[] | []> implements IMetadataSource<MergeMetadata<Sources>> {
+    private readonly sources;
+    constructor(sources: Sources);
+    getMetadata<Requirements extends FieldsRequirements<MergeMetadata<Sources>>>({ tokens, config, }: {
+        tokens: MetadataInput[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<string, MetadataResult<MergeMetadata<Sources>, Requirements>>>>;
+    supportedProperties(): Record<ChainId, import("../../../types").SupportInChain<MergeMetadata<Sources>>>;
+}

package/dist/services/metadata/metadata-sources/fallback-metadata-source.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackMetadataSource = void 0;
+const timeouts_1 = require("../../../shared/timeouts");
+const requirements_and_support_1 = require("../../../shared/requirements-and-support");
+const utils_1 = require("../../../shared/utils");
+// This fallback source will use different sources and combine the results of each of them
+class FallbackMetadataSource {
+    constructor(sources) {
+        this.sources = sources;
+        if (sources.length === 0)
+            throw new Error('Need at least one source to setup a fallback token source');
+    }
+    // @ts-ignore Will get 'Return type annotation circularly references itself' if not ignored
+    getMetadata({ tokens, config, }) {
+        return new Promise((resolve, reject) => {
+            const chainsInRequest = [...new Set(tokens.map(({ chainId }) => chainId))];
+            const sources = this.sources.filter((source) => doesSourceSupportAtLeastOneChain(source, chainsInRequest));
+            if (sources.length === 0) {
+                reject(new Error(`Couldn't find sources that supported the given chains`));
+            }
+            const result = {};
+            const requirements = (0, requirements_and_support_1.calculateFieldRequirementsPerChain)(this.supportedProperties(), config?.fields);
+            const requestTracker = buildRequestTracker(sources, tokens, requirements);
+            const handleFulfil = (source) => {
+                updateCounterWhenSourceFulfilled(source, requestTracker);
+                const status = checkStatus(requestTracker);
+                if (status === 'finished') {
+                    resolve(result);
+                }
+                else if (status === 'error') {
+                    reject(new Error('Could not find metadata for the given addresses'));
+                }
+            };
+            sources.forEach(async (source) => {
+                const tokensForSource = getAddressesForSource(source, tokens);
+                const reducedTimeout = (0, timeouts_1.reduceTimeout)(config?.timeout, '100');
+                try {
+                    // Some requirements might not be compatible with all sources, so we need to filter them before
+                    // passing them to the source. This is so that the underlying source doesn't fail
+                    const filteredRequirements = (0, requirements_and_support_1.makeRequirementsCompatible)(source.supportedProperties(), [...new Set(tokensForSource.map(({ chainId }) => chainId))], config?.fields);
+                    const sourceResult = await (0, timeouts_1.timeoutPromise)(source.getMetadata({
+                        tokens: tokensForSource,
+                        config: { timeout: reducedTimeout, fields: filteredRequirements },
+                    }), reducedTimeout);
+                    for (const [chainIdString, metadataRecord] of Object.entries(sourceResult)) {
+                        const chainId = Number(chainIdString);
+                        const metadatas = Object.entries(metadataRecord);
+                        if (!(chainId in result) && metadatas.length > 0)
+                            result[chainId] = {};
+                        for (const [address, metadata] of metadatas) {
+                            // Add to result
+                            result[chainId][address] = { ...result[chainId][address], ...metadata };
+                            // Remove token address from counter
+                            for (const tokenProperty in metadata) {
+                                const property = tokenProperty;
+                                requestTracker?.[chainId]?.[property]?.tokens?.delete(address);
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Handle, but do nothing
+                }
+                finally {
+                    handleFulfil(source);
+                }
+            });
+        });
+    }
+    // @ts-ignore Will get 'Return type annotation circularly references itself' if not ignored
+    supportedProperties() {
+        return (0, requirements_and_support_1.combineSourcesSupport)(this.sources, (source) => source.supportedProperties());
+    }
+}
+exports.FallbackMetadataSource = FallbackMetadataSource;
+function buildRequestTracker(sources, tokens, fieldRequirements) {
+    const groupedByChain = (0, utils_1.groupByChain)(tokens, ({ token }) => token);
+    const requestTracker = {};
+    for (const [chainIdString, addressesInChain] of Object.entries(groupedByChain)) {
+        const chainId = Number(chainIdString);
+        requestTracker[chainId] = Object.fromEntries(Object.entries(fieldRequirements[chainId]).map(([property, requirement]) => [
+            property,
+            { sources: 0, tokens: new Set(addressesInChain), requirement },
+        ]));
+        for (const source of sources) {
+            const supportedProperties = source.supportedProperties();
+            if (chainId in supportedProperties) {
+                for (const property in supportedProperties[chainId]) {
+                    requestTracker[chainId][property].sources += 1;
+                }
+            }
+        }
+    }
+    return requestTracker;
+}
+function updateCounterWhenSourceFulfilled(source, requestTracker) {
+    const supportedProperties = source.supportedProperties();
+    for (const [chainId, properties] of Object.entries(supportedProperties)) {
+        if (chainId in requestTracker) {
+            for (const property in properties) {
+                requestTracker[Number(chainId)][property].sources -= 1;
+            }
+        }
+    }
+}
+function checkStatus(requestTracker) {
+    let result = 'finished';
+    for (const chainId in requestTracker) {
+        for (const { sources, tokens, requirement } of Object.values(requestTracker[chainId])) {
+            if (sources === 0 && tokens.size > 0 && requirement === 'required') {
+                return 'error';
+            }
+            else if (sources > 0 && tokens.size > 0 && requirement !== 'can ignore') {
+                result = 'continue';
+            }
+        }
+    }
+    return result;
+}
+function getAddressesForSource(source, tokens) {
+    const chainsForSource = new Set(Object.keys(source.supportedProperties()).map(Number));
+    // Filter tokens that match supported chains (for EVM chains which are numeric)
+    return tokens.filter(({ chainId }) => typeof chainId === 'number' && chainsForSource.has(chainId));
+}
+function doesSourceSupportAtLeastOneChain(source, chainIds) {
+    return Object.keys(source.supportedProperties())
+        .map(Number)
+        .some((chainId) => chainIds.includes(chainId));
+}
+//# sourceMappingURL=fallback-metadata-source.js.map

package/dist/services/metadata/metadata-sources/fallback-metadata-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-metadata-source.js","sourceRoot":"","sources":["../../../../src/services/metadata/metadata-sources/fallback-metadata-source.ts"],"names":[],"mappings":";;;AACA,+CAAiE;AAEjE,+EAAyI;AACzI,yCAA6C;AAE7C,0FAA0F;AAC1F,MAAa,sBAAsB;IACjC,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACzG,CAAC;IAED,2FAA2F;IAC3F,WAAW,CAAkE,EAC3E,MAAM,EACN,MAAM,GAIP;QACC,OAAO,IAAI,OAAO,CAA8F,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClI,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gCAAgC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAY,CAAC;YACtH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,MAAM,GAAgG,EAAE,CAAC;YAC/G,MAAM,YAAY,GAAG,IAAA,6DAAkC,EAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACpG,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YAE1E,MAAM,YAAY,GAAG,CAAC,MAA+B,EAAE,EAAE;gBACvD,gCAAgC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;gBAC3C,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;qBAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC,CAAC;YAEF,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC/B,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC9D,MAAM,cAAc,GAAG,IAAA,wBAAa,EAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC7D,IAAI,CAAC;oBACH,+FAA+F;oBAC/F,iFAAiF;oBACjF,MAAM,oBAAoB,GAAG,IAAA,qDAA0B,EACrD,MAAM,CAAC,mBAAmB,EAAE,EAC5B,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAC3D,MAAM,EAAE,MAAM,CACf,CAAC;oBACF,MAAM,YAAY,GAAG,MAAM,IAAA,yBAAc,EACvC,MAAM,CAAC,WAAW,CAAC;wBACjB,MAAM,EAAE,eAAe;wBACvB,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,oBAAoB,EAAE;qBAClE,CAAC,EACF,cAAc,CACf,CAAC;oBACF,KAAK,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;wBACtC,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;wBACjD,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;4BAAE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;wBAEvE,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;4BAC5C,gBAAgB;4BAChB,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;4BAExE,oCAAoC;4BACpC,KAAK,MAAM,aAAa,IAAI,QAAQ,EAAE,CAAC;gCACrC,MAAM,QAAQ,GAAG,aAA6C,CAAC;gCAC/D,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;4BACjE,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,yBAAyB;gBAC3B,CAAC;wBAAS,CAAC;oBACT,YAAY,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,mBAAmB;QACjB,OAAO,IAAA,gDAAqB,EAAkD,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxI,CAAC;CACF;AAjFD,wDAiFC;AAED,SAAS,mBAAmB,CAC1B,OAAgB,EAChB,MAAuB,EACvB,iBAA+C;IAE/C,MAAM,cAAc,GAAG,IAAA,oBAAY,EAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,cAAc,GAA4B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,CAC1C,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;YAC1E,QAAQ;YACR,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE;SAC/D,CAAC,CACgD,CAAC;QAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACzD,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;gBACnC,KAAK,MAAM,QAAQ,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;oBACpD,cAAc,CAAC,OAAO,CAAC,CAAC,QAAwC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAS,gCAAgC,CACvC,MAA+B,EAC/B,cAAuC;IAEvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACzD,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACxE,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;YAC9B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAClC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAwC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAiD,cAAuC;IAC1G,IAAI,MAAM,GAAsC,UAAU,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAY,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACjG,IAAI,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;gBACnE,OAAO,OAAO,CAAC;YACjB,CAAC;iBAAM,IAAI,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;gBAC1E,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAA+B,MAAsC,EAAE,MAAuB;IAC1H,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,+EAA+E;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,gCAAgC,CAAC,MAA+B,EAAE,QAAmB;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;SAC7C,GAAG,CAAC,MAAM,CAAC;SACX,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/services/metadata/metadata-sources/rpc-metadata-source.d.ts

@@ -0,0 +1,23 @@
+import { FieldsRequirements, SupportInChain, TimeString } from '../../../types';
+import { BaseTokenMetadata, IMetadataSource, MetadataInput, MetadataResult } from '../types';
+import { IProviderService } from '../../providers';
+export type RPCMetadataProperties = BaseTokenMetadata & {
+    name: string;
+};
+export declare class RPCMetadataSource implements IMetadataSource<RPCMetadataProperties> {
+    private readonly providerService;
+    constructor(providerService: IProviderService);
+    getMetadata<Requirements extends FieldsRequirements<RPCMetadataProperties>>({ tokens, config, }: {
+        tokens: MetadataInput[];
+        config?: {
+            fields?: Requirements;
+            timeout: TimeString;
+        };
+    }): Promise<{
+        [k: string]: Record<string, MetadataResult<RPCMetadataProperties, Requirements>>;
+    }>;
+    supportedProperties(): {
+        [k: string]: SupportInChain<RPCMetadataProperties>;
+    };
+    private fetchMetadataInChain;
+}

package/dist/services/metadata/metadata-sources/rpc-metadata-source.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPCMetadataSource = void 0;
+const _chains_1 = require("../../../chains");
+const constants_1 = require("../../../shared/constants");
+const utils_1 = require("../../../shared/utils");
+const timeouts_1 = require("../../../shared/timeouts");
+const requirements_and_support_1 = require("../../../shared/requirements-and-support");
+const erc20_1 = __importDefault(require("../../../shared/abis/erc20"));
+const utils_2 = require("../../providers/utils");
+const SUPPORT = { symbol: 'present', decimals: 'present', name: 'present' };
+class RPCMetadataSource {
+    constructor(providerService) {
+        this.providerService = providerService;
+    }
+    async getMetadata({ tokens, config, }) {
+        const groupedByChain = (0, utils_1.groupByChain)(tokens, ({ token }) => token);
+        const promises = Object.entries(groupedByChain).map(async ([chainId, tokens]) => [
+            Number(chainId),
+            await (0, timeouts_1.timeoutPromise)(this.fetchMetadataInChain(Number(chainId), tokens, config?.fields), config?.timeout, { reduceBy: '100' }),
+        ]);
+        return Object.fromEntries(await (0, utils_1.filterRejectedResults)(promises));
+    }
+    supportedProperties() {
+        return Object.fromEntries(this.providerService.supportedChains().map((chainId) => [chainId, SUPPORT]));
+    }
+    async fetchMetadataInChain(chainId, tokens, requirements) {
+        const chain = (0, _chains_1.getChainByKey)(chainId);
+        const addressesWithoutNativeToken = tokens.filter((address) => !(0, utils_1.isSameAddress)(address, constants_1.Addresses.NATIVE_TOKEN));
+        const fieldRequirements = (0, requirements_and_support_1.calculateFieldRequirements)(SUPPORT, requirements);
+        const fieldsToFetch = Object.entries(fieldRequirements)
+            .filter(([, requirement]) => requirement !== 'can ignore')
+            .map(([field]) => field);
+        if (fieldsToFetch.length === 0)
+            return {};
+        const contracts = [];
+        for (const field of fieldsToFetch) {
+            contracts.push(...addressesWithoutNativeToken.map((address) => ({ address: address, functionName: field, abi: erc20_1.default })));
+        }
+        const multicallResults = contracts.length
+            ? await this.providerService
+                .getViemPublicClient({ chainId })
+                .multicall({ contracts, allowFailure: true, multicallAddress: utils_2.MULTICALL_CONTRACT.address(chainId), batchSize: 0 })
+            : [];
+        const result = {};
+        for (let i = 0; i < addressesWithoutNativeToken.length; i++) {
+            const address = addressesWithoutNativeToken[i];
+            const tokenMetadata = {};
+            fieldsToFetch.forEach((field, j) => {
+                const result = multicallResults[addressesWithoutNativeToken.length * j + i];
+                if (result.status === 'success') {
+                    tokenMetadata[field] = result.result;
+                }
+            });
+            result[address] = tokenMetadata;
+        }
+        if (addressesWithoutNativeToken.length !== tokens.length) {
+            const nativeResult = {};
+            if (fieldsToFetch.includes('symbol')) {
+                nativeResult.symbol = chain?.nativeCurrency?.symbol ?? '???';
+            }
+            if (fieldsToFetch.includes('decimals')) {
+                nativeResult.decimals = 18;
+            }
+            if (fieldsToFetch.includes('name')) {
+                nativeResult.name = chain?.nativeCurrency?.name ?? 'Unknown';
+            }
+            result[constants_1.Addresses.NATIVE_TOKEN] = nativeResult;
+        }
+        return result;
+    }
+}
+exports.RPCMetadataSource = RPCMetadataSource;
+//# sourceMappingURL=rpc-metadata-source.js.map

package/dist/services/metadata/metadata-sources/rpc-metadata-source.js.map

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

package/dist/services/metadata/types.d.ts

@@ -0,0 +1,44 @@
+import { BasedOnRequirements, ChainId, DefaultRequirements, FieldsRequirements, SupportInChain, TimeString, TokenAddress } from '../../types';
+import { UnionMerge } from '../../utility-types';
+export type IMetadataService<TokenMetadata extends object> = {
+    supportedChains(): ChainId[];
+    supportedProperties(): Record<ChainId, SupportInChain<TokenMetadata>>;
+    getMetadataInChain<Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>>(_: {
+        chainId: ChainId;
+        tokens: TokenAddress[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<TokenAddress, MetadataResult<TokenMetadata, Requirements>>>;
+    getMetadata<Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>>(_: {
+        tokens: MetadataInput[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, MetadataResult<TokenMetadata, Requirements>>>>;
+};
+export type IMetadataSource<TokenMetadata extends object> = {
+    getMetadata<Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>>(_: {
+        tokens: MetadataInput[];
+        config?: {
+            fields?: Requirements;
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, MetadataResult<TokenMetadata, Requirements>>>>;
+    supportedProperties(): Record<ChainId, SupportInChain<TokenMetadata>>;
+};
+export type MetadataResult<TokenMetadata extends object, Requirements extends FieldsRequirements<TokenMetadata> = DefaultRequirements<TokenMetadata>> = BasedOnRequirements<TokenMetadata, Requirements>;
+export type BaseTokenMetadata = {
+    symbol: string;
+    decimals: number;
+};
+export type ExtractMetadata<Source extends IMetadataSource<object>> = Source extends IMetadataSource<infer R> ? R : never;
+export type MergeMetadata<Sources extends IMetadataSource<object>[] | []> = UnionMerge<{
+    [K in keyof Sources]: ExtractMetadata<Sources[K]>;
+}[number]>;
+export type MetadataInput = {
+    chainId: ChainId;
+    token: TokenAddress;
+};

package/dist/services/metadata/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/metadata/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/metadata/types.ts"],"names":[],"mappings":""}

package/dist/services/prices/index.d.ts

@@ -0,0 +1 @@
+export { IPriceService, IPriceSource, TokenPrice, PriceResult, PriceInput } from './types';

package/dist/services/prices/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/services/prices/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/prices/index.ts"],"names":[],"mappings":""}

package/dist/services/prices/price-service.d.ts

@@ -0,0 +1,69 @@
+import { ChainId, TimeString, Timestamp, TokenAddress } from '../../types';
+import { IPriceService, IPriceSource, PriceInput, PriceResult } from './types';
+export declare class PriceService implements IPriceService {
+    private readonly priceSource;
+    constructor(priceSource: IPriceSource);
+    supportedChains(): number[];
+    supportedQueries(): Record<ChainId, import("./types").PricesQueriesSupport>;
+    getCurrentPricesInChain({ chainId, tokens, config, }: {
+        chainId: ChainId;
+        tokens: TokenAddress[];
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<TokenAddress, PriceResult>>;
+    getCurrentPrices({ tokens, config, }: {
+        tokens: PriceInput[];
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, PriceResult>>>;
+    getHistoricalPricesInChain({ chainId, tokens, timestamp, searchWidth, config, }: {
+        chainId: ChainId;
+        tokens: TokenAddress[];
+        timestamp: Timestamp;
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<{
+        [k: string]: PriceResult;
+    }>;
+    getHistoricalPrices({ config, searchWidth, tokens, timestamp, }: {
+        tokens: PriceInput[];
+        timestamp: Timestamp;
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<{
+        [k: string]: {
+            [k: string]: PriceResult;
+        };
+    }>;
+    getBulkHistoricalPrices({ tokens, searchWidth, config, }: {
+        tokens: {
+            chainId: ChainId;
+            token: TokenAddress;
+            timestamp: Timestamp;
+        }[];
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, Record<Timestamp, PriceResult>>>>;
+    getChart({ tokens, span, period, bound, searchWidth, config, }: {
+        tokens: PriceInput[];
+        span: number;
+        period: TimeString;
+        bound: {
+            from: Timestamp;
+        } | {
+            upTo: Timestamp | 'now';
+        };
+        searchWidth?: TimeString;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Promise<Record<ChainId, Record<TokenAddress, PriceResult[]>>>;
+}