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

package/dist/services/quotes/source-registry.d.ts

@@ -0,0 +1,70 @@
+import { GlobalQuoteSourceConfig, SourceMetadata } from './types';
+import { Without } from '../../utility-types';
+import { IQuoteSource } from './quote-sources/types';
+import { OdosQuoteSource } from './quote-sources/odos-quote-source';
+import { ParaswapQuoteSource } from './quote-sources/paraswap-quote-source';
+import { ZRXQuoteSource } from './quote-sources/0x-quote-source';
+import { OneInchQuoteSource } from './quote-sources/1inch-quote-source';
+import { UniswapQuoteSource } from './quote-sources/uniswap-quote-source';
+import { OpenOceanQuoteSource } from './quote-sources/open-ocean-quote-source';
+import { LiFiQuoteSource } from './quote-sources/li-fi-quote-source';
+import { KyberswapQuoteSource } from './quote-sources/kyberswap-quote-source';
+import { RangoQuoteSource } from './quote-sources/rango-quote-source';
+import { ChangellyQuoteSource } from './quote-sources/changelly-quote-source';
+import { PortalsFiQuoteSource } from './quote-sources/portals-fi-quote-source';
+import { OKXDexQuoteSource } from './quote-sources/okx-dex-quote-source';
+import { BebopQuoteSource } from './quote-sources/bebop-quote-source';
+import { XYFinanceQuoteSource } from './quote-sources/xy-finance-quote-source';
+import { FlyTradeQuoteSource } from './quote-sources/fly-trade-quote-source';
+import { SquidQuoteSource } from './quote-sources/squid-quote-source';
+import { ConveyorQuoteSource } from './quote-sources/conveyor-quote-source';
+import { EnsoQuoteSource } from './quote-sources/enso-quote-source';
+import { BrainDexQuoteSource } from './quote-sources/braindex-quote-source';
+import { BarterQuoteSource } from './quote-sources/barter-quote-source';
+import { DodoDexQuoteSource } from './quote-sources/dodo-quote-source';
+import { SwingQuoteSource } from './quote-sources/swing-quote-source';
+import { SushiswapQuoteSource } from './quote-sources/sushiswap-quote-source';
+import { JupiterQuoteSource } from './quote-sources/jupiter-quote-source';
+export declare const QUOTE_SOURCES: {
+    bebop: BebopQuoteSource;
+    paraswap: ParaswapQuoteSource;
+    'xy-finance': XYFinanceQuoteSource;
+    '0x': ZRXQuoteSource;
+    '1inch': OneInchQuoteSource;
+    uniswap: UniswapQuoteSource;
+    'open-ocean': OpenOceanQuoteSource;
+    'li-fi': LiFiQuoteSource;
+    kyberswap: KyberswapQuoteSource;
+    odos: OdosQuoteSource;
+    braindex: BrainDexQuoteSource;
+    barter: BarterQuoteSource;
+    rango: RangoQuoteSource;
+    changelly: ChangellyQuoteSource;
+    "fly-trade": FlyTradeQuoteSource;
+    squid: SquidQuoteSource;
+    'portals-fi': PortalsFiQuoteSource;
+    enso: EnsoQuoteSource;
+    'okx-dex': OKXDexQuoteSource;
+    conveyor: ConveyorQuoteSource;
+    dodo: DodoDexQuoteSource;
+    swing: SwingQuoteSource;
+    sushiswap: SushiswapQuoteSource;
+    jupiter: JupiterQuoteSource;
+};
+export declare const SOURCES_METADATA: Record<"0x" | "open-ocean" | "paraswap" | "1inch" | "fly-trade" | "bebop" | "xy-finance" | "uniswap" | "li-fi" | "kyberswap" | "odos" | "braindex" | "barter" | "rango" | "changelly" | "squid" | "portals-fi" | "enso" | "okx-dex" | "conveyor" | "dodo" | "swing" | "sushiswap" | "jupiter", SourceMetadata>;
+export type SourceWithConfigId = keyof LocalSourcesConfig;
+export type SourceConfig = {
+    global?: GlobalQuoteSourceConfig;
+    custom?: Partial<LocalSourcesConfig>;
+};
+export type LocalSourceConfig = LocalSourcesConfig[keyof LocalSourcesConfig];
+type ImplementedSources = typeof QUOTE_SOURCES;
+type LocalSourcesConfig = Without<{
+    [K in keyof AllLocalSourcesConfig]: ConfigHasKeys<AllLocalSourcesConfig[K]> extends true ? AllLocalSourcesConfig[K] : never;
+}, never>;
+type AllLocalSourcesConfig = {
+    [K in keyof ImplementedSources]: ImplementedSources[K] extends IQuoteSource<any, any> ? GetCustomConfigFromSource<ImplementedSources[K]> : never;
+};
+type ConfigHasKeys<CustomQuoteSourceConfig extends object> = keyof CustomQuoteSourceConfig extends never ? false : true;
+type GetCustomConfigFromSource<T extends IQuoteSource<any, any>> = T extends IQuoteSource<any, infer CustomQuoteSourceConfig> ? CustomQuoteSourceConfig : never;
+export {};

package/dist/services/quotes/source-registry.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOURCES_METADATA = exports.QUOTE_SOURCES = void 0;
+const odos_quote_source_1 = require("./quote-sources/odos-quote-source");
+const paraswap_quote_source_1 = require("./quote-sources/paraswap-quote-source");
+const _0x_quote_source_1 = require("./quote-sources/0x-quote-source");
+const _1inch_quote_source_1 = require("./quote-sources/1inch-quote-source");
+const uniswap_quote_source_1 = require("./quote-sources/uniswap-quote-source");
+const open_ocean_quote_source_1 = require("./quote-sources/open-ocean-quote-source");
+const li_fi_quote_source_1 = require("./quote-sources/li-fi-quote-source");
+const kyberswap_quote_source_1 = require("./quote-sources/kyberswap-quote-source");
+const rango_quote_source_1 = require("./quote-sources/rango-quote-source");
+const changelly_quote_source_1 = require("./quote-sources/changelly-quote-source");
+const portals_fi_quote_source_1 = require("./quote-sources/portals-fi-quote-source");
+const okx_dex_quote_source_1 = require("./quote-sources/okx-dex-quote-source");
+const bebop_quote_source_1 = require("./quote-sources/bebop-quote-source");
+const xy_finance_quote_source_1 = require("./quote-sources/xy-finance-quote-source");
+const fly_trade_quote_source_1 = require("./quote-sources/fly-trade-quote-source");
+const squid_quote_source_1 = require("./quote-sources/squid-quote-source");
+const conveyor_quote_source_1 = require("./quote-sources/conveyor-quote-source");
+const enso_quote_source_1 = require("./quote-sources/enso-quote-source");
+const braindex_quote_source_1 = require("./quote-sources/braindex-quote-source");
+const barter_quote_source_1 = require("./quote-sources/barter-quote-source");
+const dodo_quote_source_1 = require("./quote-sources/dodo-quote-source");
+const swing_quote_source_1 = require("./quote-sources/swing-quote-source");
+const sushiswap_quote_source_1 = require("./quote-sources/sushiswap-quote-source");
+// Solana sources
+const jupiter_quote_source_1 = require("./quote-sources/jupiter-quote-source");
+exports.QUOTE_SOURCES = {
+    bebop: new bebop_quote_source_1.BebopQuoteSource(),
+    paraswap: new paraswap_quote_source_1.ParaswapQuoteSource(),
+    'xy-finance': new xy_finance_quote_source_1.XYFinanceQuoteSource(),
+    '0x': new _0x_quote_source_1.ZRXQuoteSource(),
+    '1inch': new _1inch_quote_source_1.OneInchQuoteSource(),
+    uniswap: new uniswap_quote_source_1.UniswapQuoteSource(),
+    'open-ocean': new open_ocean_quote_source_1.OpenOceanQuoteSource(),
+    'li-fi': new li_fi_quote_source_1.LiFiQuoteSource(),
+    kyberswap: new kyberswap_quote_source_1.KyberswapQuoteSource(),
+    odos: new odos_quote_source_1.OdosQuoteSource(),
+    braindex: new braindex_quote_source_1.BrainDexQuoteSource(),
+    barter: new barter_quote_source_1.BarterQuoteSource(),
+    rango: new rango_quote_source_1.RangoQuoteSource(),
+    changelly: new changelly_quote_source_1.ChangellyQuoteSource(),
+    ['fly-trade']: new fly_trade_quote_source_1.FlyTradeQuoteSource(),
+    squid: new squid_quote_source_1.SquidQuoteSource(),
+    'portals-fi': new portals_fi_quote_source_1.PortalsFiQuoteSource(),
+    enso: new enso_quote_source_1.EnsoQuoteSource(),
+    'okx-dex': new okx_dex_quote_source_1.OKXDexQuoteSource(),
+    conveyor: new conveyor_quote_source_1.ConveyorQuoteSource(),
+    dodo: new dodo_quote_source_1.DodoDexQuoteSource(),
+    swing: new swing_quote_source_1.SwingQuoteSource(),
+    sushiswap: new sushiswap_quote_source_1.SushiswapQuoteSource(),
+    // Solana sources
+    jupiter: new jupiter_quote_source_1.JupiterQuoteSource(),
+};
+exports.SOURCES_METADATA = Object.fromEntries(Object.entries(exports.QUOTE_SOURCES).map(([sourceId, source]) => [sourceId, source.getMetadata()]));
+//# sourceMappingURL=source-registry.js.map

package/dist/services/quotes/source-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-registry.js","sourceRoot":"","sources":["../../../src/services/quotes/source-registry.ts"],"names":[],"mappings":";;;AAGA,yEAAoE;AACpE,iFAA4E;AAC5E,sEAAiE;AACjE,4EAAwE;AACxE,+EAA0E;AAC1E,qFAA+E;AAC/E,2EAAqE;AACrE,mFAA8E;AAC9E,2EAAsE;AACtE,mFAA8E;AAC9E,qFAA+E;AAC/E,+EAAyE;AACzE,2EAAsE;AACtE,qFAA+E;AAC/E,mFAA6E;AAC7E,2EAAsE;AACtE,iFAA4E;AAC5E,yEAAoE;AACpE,iFAA4E;AAC5E,6EAAwE;AACxE,yEAAuE;AACvE,2EAAsE;AACtE,mFAA8E;AAC9E,iBAAiB;AACjB,+EAA0E;AAE7D,QAAA,aAAa,GAAG;IAC3B,KAAK,EAAE,IAAI,qCAAgB,EAAE;IAC7B,QAAQ,EAAE,IAAI,2CAAmB,EAAE;IACnC,YAAY,EAAE,IAAI,8CAAoB,EAAE;IACxC,IAAI,EAAE,IAAI,iCAAc,EAAE;IAC1B,OAAO,EAAE,IAAI,wCAAkB,EAAE;IACjC,OAAO,EAAE,IAAI,yCAAkB,EAAE;IACjC,YAAY,EAAE,IAAI,8CAAoB,EAAE;IACxC,OAAO,EAAE,IAAI,oCAAe,EAAE;IAC9B,SAAS,EAAE,IAAI,6CAAoB,EAAE;IACrC,IAAI,EAAE,IAAI,mCAAe,EAAE;IAC3B,QAAQ,EAAE,IAAI,2CAAmB,EAAE;IACnC,MAAM,EAAE,IAAI,uCAAiB,EAAE;IAC/B,KAAK,EAAE,IAAI,qCAAgB,EAAE;IAC7B,SAAS,EAAE,IAAI,6CAAoB,EAAE;IACrC,CAAC,WAAW,CAAC,EAAE,IAAI,4CAAmB,EAAE;IACxC,KAAK,EAAE,IAAI,qCAAgB,EAAE;IAC7B,YAAY,EAAE,IAAI,8CAAoB,EAAE;IACxC,IAAI,EAAE,IAAI,mCAAe,EAAE;IAC3B,SAAS,EAAE,IAAI,wCAAiB,EAAE;IAClC,QAAQ,EAAE,IAAI,2CAAmB,EAAE;IACnC,IAAI,EAAE,IAAI,sCAAkB,EAAE;IAC9B,KAAK,EAAE,IAAI,qCAAgB,EAAE;IAC7B,SAAS,EAAE,IAAI,6CAAoB,EAAE;IACrC,iBAAiB;IACjB,OAAO,EAAE,IAAI,yCAAkB,EAAE;CACgC,CAAC;AAEvD,QAAA,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAChD,MAAM,CAAC,OAAO,CAAC,qBAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CACtC,CAAC"}

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

@@ -0,0 +1,204 @@
+import { GasSpeed, SupportedGasValues } from '../gas/types';
+import { BaseTokenMetadata } from '../metadata/types';
+import { Address, BigIntish, ChainId, SupportInChain, TimeString, TokenAddress, BuiltTransaction, AmountsOfToken } from '../../types';
+import { Either } from '../../utility-types';
+import { CompareQuotesBy, CompareQuotesUsing } from './quote-compare';
+import { QuoteSourceMetadata, QuoteSourceSupport } from './quote-sources/types';
+import { SourceConfig } from './source-registry';
+export type GlobalQuoteSourceConfig = {
+    referrer?: {
+        address: Address;
+        name: string;
+    };
+    disableValidation?: boolean;
+};
+export type SourceId = string;
+export type SourceMetadata = QuoteSourceMetadata<QuoteSourceSupport>;
+export type IQuoteService = {
+    supportedSources(): Record<SourceId, SourceMetadata>;
+    supportedChains(): ChainId[];
+    supportedSourcesInChain(_: {
+        chainId: ChainId;
+    }): Record<SourceId, SourceMetadata>;
+    supportedGasSpeeds(): Record<ChainId, SupportInChain<SupportedGasValues>>;
+    estimateQuotes(_: {
+        request: EstimatedQuoteRequest;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Record<SourceId, Promise<EstimatedQuoteResponse>>;
+    estimateAllQuotes<IgnoreFailed extends boolean = true>(_: {
+        request: EstimatedQuoteRequest;
+        config?: {
+            ignoredFailed?: IgnoreFailed;
+            sort?: {
+                by: CompareQuotesBy;
+                using?: CompareQuotesUsing;
+            };
+            timeout?: TimeString;
+        };
+    }): Promise<IgnoreFailedResponses<IgnoreFailed, EstimatedQuoteResponse>[]>;
+    getQuotes(_: {
+        request: QuoteRequest;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Record<SourceId, Promise<QuoteResponse>>;
+    getAllQuotes<IgnoreFailed extends boolean = true>(_: {
+        request: QuoteRequest;
+        config?: {
+            ignoredFailed?: IgnoreFailed;
+            sort?: {
+                by: CompareQuotesBy;
+                using?: CompareQuotesUsing;
+            };
+            timeout?: TimeString;
+        };
+    }): Promise<IgnoreFailedResponses<IgnoreFailed, QuoteResponse>[]>;
+    getBestQuote(_: {
+        request: QuoteRequest;
+        config?: {
+            choose?: {
+                by: CompareQuotesBy;
+                using?: CompareQuotesUsing;
+            };
+            timeout?: TimeString;
+        };
+    }): Promise<QuoteResponse>;
+    getAllQuotesWithTxs<IgnoreFailed extends boolean = true>(_: {
+        request: QuoteRequest;
+        config?: {
+            ignoredFailed?: IgnoreFailed;
+            sort?: {
+                by: CompareQuotesBy;
+                using?: CompareQuotesUsing;
+            };
+            timeout?: TimeString;
+        };
+    }): Promise<IgnoreFailedResponses<IgnoreFailed, QuoteResponseWithTx>[]>;
+    buildTxs(_: {
+        quotes: Record<SourceId, Promise<QuoteResponseRelevantForTxBuild>> | Record<SourceId, QuoteResponseRelevantForTxBuild>;
+        sourceConfig?: SourceConfig;
+        config?: {
+            timeout?: TimeString;
+        };
+    }): Record<SourceId, Promise<QuoteTransaction>>;
+    buildAllTxs<IgnoreFailed extends boolean = true>(_: {
+        quotes: Record<SourceId, Promise<QuoteResponseRelevantForTxBuild>> | Promise<Record<SourceId, QuoteResponseRelevantForTxBuild>> | Record<SourceId, QuoteResponseRelevantForTxBuild>;
+        sourceConfig?: SourceConfig;
+        config?: {
+            timeout?: TimeString;
+            ignoredFailed?: IgnoreFailed;
+        };
+    }): Promise<Record<SourceId, IgnoreFailedResponses<IgnoreFailed, QuoteTransaction>>>;
+};
+export type QuoteRequest = {
+    chainId: ChainId;
+    sellToken: TokenAddress;
+    buyToken: TokenAddress;
+    order: {
+        type: 'sell';
+        sellAmount: BigIntish;
+    } | {
+        type: 'buy';
+        buyAmount: BigIntish;
+    };
+    slippagePercentage: number;
+    takerAddress: Address;
+    recipient?: Address;
+    gasSpeed?: {
+        speed: GasSpeed;
+        requirement?: 'required' | 'best effort';
+    };
+    txValidFor?: TimeString;
+    filters?: Either<{
+        includeSources: SourceId[];
+    }, {
+        excludeSources: SourceId[];
+    }>;
+    includeNonTransferSourcesWhenRecipientIsSet?: boolean;
+    estimateBuyOrdersWithSellOnlySources?: boolean;
+    sourceConfig?: SourceConfig;
+};
+type TokenWithOptionalPrice = BaseTokenMetadata & {
+    address: TokenAddress;
+    price?: number;
+};
+export type QuoteResponse<CustomQuoteSourceData extends Record<string, any> = Record<string, any>> = {
+    chainId: ChainId;
+    sellToken: TokenWithOptionalPrice;
+    buyToken: TokenWithOptionalPrice;
+    sellAmount: AmountsOfToken;
+    buyAmount: AmountsOfToken;
+    maxSellAmount: AmountsOfToken;
+    minBuyAmount: AmountsOfToken;
+    gas?: {
+        estimatedGas: bigint;
+        estimatedCost: bigint;
+        estimatedCostInUnits: string;
+        gasTokenSymbol: string;
+        estimatedCostInUSD?: string;
+        gasTokenPrice?: number;
+    };
+    accounts: {
+        takerAddress: Address;
+        recipient: Address;
+    };
+    source: {
+        id: SourceId;
+        allowanceTarget: Address;
+        name: string;
+        logoURI: string;
+    };
+    type: 'sell' | 'buy';
+    customData: CustomQuoteSourceData;
+};
+export type QuoteResponseRelevantForTxBuild<CustomQuoteSourceData extends Record<string, any> = Record<string, any>> = {
+    chainId: ChainId;
+    sellToken: {
+        address: Address;
+    };
+    buyToken: {
+        address: Address;
+    };
+    sellAmount: {
+        amount: bigint;
+    };
+    buyAmount: {
+        amount: bigint;
+    };
+    maxSellAmount: {
+        amount: bigint;
+    };
+    minBuyAmount: {
+        amount: bigint;
+    };
+    accounts: {
+        takerAddress: Address;
+        recipient: Address;
+    };
+    source: {
+        id: SourceId;
+    };
+    type: 'sell' | 'buy';
+    customData: CustomQuoteSourceData;
+};
+export type QuoteResponseWithTx<CustomQuoteSourceData extends Record<string, any> = Record<string, any>> = QuoteResponse<CustomQuoteSourceData> & {
+    tx: QuoteTransaction;
+};
+export type QuoteTransaction = BuiltTransaction & {
+    from: Address;
+};
+export type EstimatedQuoteRequest = Omit<QuoteRequest, 'takerAddress' | 'recipient' | 'txValidFor'>;
+export type EstimatedQuoteResponse<CustomQuoteSourceData extends Record<string, any> = Record<string, any>> = Omit<QuoteResponse<CustomQuoteSourceData>, 'accounts'>;
+export type IgnoreFailedResponses<IgnoredFailed extends boolean, Response> = IgnoredFailed extends true ? Response : Response | FailedResponse;
+export type FailedResponse = {
+    failed: true;
+    source: {
+        id: string;
+        name: string;
+        logoURI: string;
+    };
+    error: any;
+};
+export {};

package/dist/services/quotes/types.js

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

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

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

package/dist/shared/abis/erc20.d.ts

@@ -0,0 +1,86 @@
+declare const _default: readonly [{
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "name";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_from";
+        readonly type: "address";
+    }, {
+        readonly name: "_to";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "transferFrom";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "decimals";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly name: "balance";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "symbol";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+    }, {
+        readonly name: "_spender";
+        readonly type: "address";
+    }];
+    readonly name: "allowance";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}];
+export default _default;

package/dist/shared/abis/erc20.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = [
+    {
+        constant: true,
+        inputs: [],
+        name: 'name',
+        outputs: [
+            {
+                name: '',
+                type: 'string',
+            },
+        ],
+        payable: false,
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        constant: false,
+        inputs: [
+            {
+                name: '_from',
+                type: 'address',
+            },
+            {
+                name: '_to',
+                type: 'address',
+            },
+            {
+                name: '_value',
+                type: 'uint256',
+            },
+        ],
+        name: 'transferFrom',
+        outputs: [
+            {
+                name: '',
+                type: 'bool',
+            },
+        ],
+        payable: false,
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        constant: true,
+        inputs: [],
+        name: 'decimals',
+        outputs: [
+            {
+                name: '',
+                type: 'uint8',
+            },
+        ],
+        payable: false,
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        constant: true,
+        inputs: [
+            {
+                name: '_owner',
+                type: 'address',
+            },
+        ],
+        name: 'balanceOf',
+        outputs: [
+            {
+                name: 'balance',
+                type: 'uint256',
+            },
+        ],
+        payable: false,
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        constant: true,
+        inputs: [],
+        name: 'symbol',
+        outputs: [
+            {
+                name: '',
+                type: 'string',
+            },
+        ],
+        payable: false,
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        constant: true,
+        inputs: [
+            {
+                name: '_owner',
+                type: 'address',
+            },
+            {
+                name: '_spender',
+                type: 'address',
+            },
+        ],
+        name: 'allowance',
+        outputs: [
+            {
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        payable: false,
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+//# sourceMappingURL=erc20.js.map

package/dist/shared/abis/erc20.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.js","sourceRoot":"","sources":["../../../src/shared/abis/erc20.ts"],"names":[],"mappings":";;AAAA,kBAAe;IACb;QACE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,QAAQ;aACf;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IACD;QACE,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;aAChB;YACD;gBACE,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,SAAS;aAChB;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;aAChB;SACF;QACD,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,MAAM;aACb;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB;IACD;QACE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,OAAO;aACd;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IACD;QACE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;aAChB;SACF;QACD,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;aAChB;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IACD;QACE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,QAAQ;aACf;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;IAED;QACE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;aAChB;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,SAAS;aAChB;SACF;QACD,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,SAAS;aAChB;SACF;QACD,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;CACO,CAAC"}

package/dist/shared/alchemy.d.ts

@@ -0,0 +1,7 @@
+import { ChainId } from '../types';
+export declare const ALCHEMY_NETWORKS: Record<ChainId, {
+    key: string;
+    price: {
+        supported: boolean;
+    };
+}>;

package/dist/shared/alchemy.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALCHEMY_NETWORKS = void 0;
+const _chains_1 = require("../chains");
+exports.ALCHEMY_NETWORKS = {
+    [_chains_1.Chains.ETHEREUM.chainId]: { key: 'eth-mainnet', price: { supported: true } },
+    [_chains_1.Chains.ETHEREUM_SEPOLIA.chainId]: { key: 'eth-sepolia', price: { supported: false } },
+    [_chains_1.Chains.OPTIMISM.chainId]: { key: 'opt-mainnet', price: { supported: true } },
+    [_chains_1.Chains.ARBITRUM.chainId]: { key: 'arb-mainnet', price: { supported: true } },
+    [_chains_1.Chains.POLYGON.chainId]: { key: 'polygon-mainnet', price: { supported: true } },
+    [_chains_1.Chains.POLYGON_MUMBAI.chainId]: { key: 'polygon-mumbai', price: { supported: false } },
+    [_chains_1.Chains.ASTAR.chainId]: { key: 'astar-mainnet', price: { supported: false } },
+    [_chains_1.Chains.BLAST.chainId]: { key: 'blast-mainnet', price: { supported: true } },
+    [_chains_1.Chains.BNB_CHAIN.chainId]: { key: 'bnb-mainnet', price: { supported: true } },
+    [_chains_1.Chains.AVALANCHE.chainId]: { key: 'avax-mainnet', price: { supported: true } },
+    [_chains_1.Chains.FANTOM.chainId]: { key: 'fantom-mainnet', price: { supported: true } },
+    [_chains_1.Chains.METIS_ANDROMEDA.chainId]: { key: 'metis-mainnet', price: { supported: true } },
+    [_chains_1.Chains.POLYGON_ZKEVM.chainId]: {
+        key: 'polygonzkevm-mainnet',
+        price: { supported: true },
+    },
+    [_chains_1.Chains.BASE.chainId]: { key: 'base-mainnet', price: { supported: true } },
+    [_chains_1.Chains.GNOSIS.chainId]: { key: 'gnosis-mainnet', price: { supported: true } },
+    [_chains_1.Chains.SCROLL.chainId]: { key: 'scroll-mainnet', price: { supported: true } },
+    [_chains_1.Chains.opBNB.chainId]: { key: 'opbnb-mainnet', price: { supported: true } },
+    [_chains_1.Chains.MANTLE.chainId]: { key: 'mantle-mainnet', price: { supported: false } },
+    [_chains_1.Chains.ROOTSTOCK.chainId]: { key: 'rootstock-mainnet', price: { supported: false } },
+    [_chains_1.Chains.LINEA.chainId]: { key: 'linea-mainnet', price: { supported: true } },
+    [_chains_1.Chains.SONIC.chainId]: { key: 'sonic-mainnet', price: { supported: false } },
+    [_chains_1.Chains.ZK_SYNC_ERA.chainId]: { key: 'zksync-mainnet', price: { supported: true } },
+    [_chains_1.Chains.CELO.chainId]: { key: 'celo-mainnet', price: { supported: false } },
+    [_chains_1.Chains.PLASMA.chainId]: { key: 'plasma-mainnet', price: { supported: false } },
+    [_chains_1.Chains.UNICHAIN.chainId]: { key: 'unichain-mainnet', price: { supported: false } },
+};
+//# sourceMappingURL=alchemy.js.map

package/dist/shared/alchemy.js.map

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

package/dist/shared/auto-update-cache.d.ts

@@ -0,0 +1,23 @@
+import { TimeString } from '../types';
+type CacheConstructorParams<Value> = {
+    calculate: () => Promise<Value>;
+    config: AutoUpdateCacheConfig;
+};
+export type AutoUpdateCacheConfig = {
+    valid?: 'always' | {
+        onlyFor: TimeString;
+    };
+    update: {
+        every: TimeString;
+        ifFailsTryAgainIn?: TimeString;
+    };
+};
+export declare class AutoUpdateCache<Value> {
+    private readonly calculate;
+    private readonly config;
+    private cache;
+    constructor({ calculate, config }: CacheConstructorParams<Value>);
+    getValue(): Value | undefined;
+    private update;
+}
+export {};

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

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoUpdateCache = void 0;
+const ms_1 = __importDefault(require("ms"));
+const DEFAULT_RETRY_TIME = '5Minutes';
+class AutoUpdateCache {
+    constructor({ calculate, config }) {
+        this.calculate = calculate;
+        this.config = config;
+        this.cache = { lastUpdated: 0, value: undefined };
+        const isInvalid = config.valid && config.valid !== 'always' && (0, ms_1.default)(config.valid.onlyFor) <= (0, ms_1.default)(config.update.every);
+        if (isInvalid)
+            throw new Error(`'onlyFor' must be greater than 'every'`);
+        this.update();
+    }
+    getValue() {
+        const now = Date.now();
+        const isValid = ({ lastUpdated }) => !this.config.valid || this.config.valid === 'always' || (this.config.valid.onlyFor && lastUpdated >= now - (0, ms_1.default)(this.config.valid.onlyFor));
+        return this.cache && isValid(this.cache) ? this.cache.value : undefined;
+    }
+    async update() {
+        try {
+            const result = await this.calculate();
+            if (result !== undefined) {
+                this.cache = { lastUpdated: Date.now(), value: result };
+            }
+            setTimeout(() => this.update(), (0, ms_1.default)(this.config.update.every));
+        }
+        catch (error) {
+            setTimeout(() => this.update(), (0, ms_1.default)(this.config.update.ifFailsTryAgainIn ?? DEFAULT_RETRY_TIME));
+        }
+    }
+}
+exports.AutoUpdateCache = AutoUpdateCache;
+//# sourceMappingURL=auto-update-cache.js.map