@cryptorubic/core 0.0.1

package/src/lib/tokens/price-token.d.ts

@@ -0,0 +1,11 @@
+import { Token } from './token';
+import { PriceTokenStruct } from './price-token-struct';
+import BigNumber from 'bignumber.js';
+import { BlockchainName } from "../blockchains/blockchain-name";
+export declare class PriceToken<Blockchain extends BlockchainName = BlockchainName> extends Token<Blockchain> {
+    private _price;
+    get price(): BigNumber;
+    set price(price: BigNumber);
+    get asStructWithPrice(): PriceTokenStruct<Blockchain>;
+    constructor(tokenStruct: PriceTokenStruct<Blockchain>);
+}

package/src/lib/tokens/price-token.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriceToken = void 0;
+const token_1 = require("./token");
+class PriceToken extends token_1.Token {
+    get price() {
+        return this._price;
+    }
+    set price(price) {
+        this._price = price;
+    }
+    get asStructWithPrice() {
+        return {
+            address: this.address,
+            blockchain: this.blockchain,
+            decimals: this.decimals,
+            name: this.name,
+            price: this.price,
+            symbol: this.symbol
+        };
+    }
+    constructor(tokenStruct) {
+        super(tokenStruct);
+        this._price = tokenStruct.price;
+    }
+}
+exports.PriceToken = PriceToken;
+//# sourceMappingURL=price-token.js.map

package/src/lib/tokens/price-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-token.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/price-token.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAKhC,MAAa,UAA+D,SAAQ,aAAiB;IAGjG,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAW,KAAK,CAAC,KAAgB;QAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,IAAW,iBAAiB;QACxB,OAAO;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;IAED,YAAY,WAAyC;QACjD,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC;IACpC,CAAC;CACJ;AA1BD,gCA0BC"}

package/src/lib/tokens/token-amount-struct.d.ts

@@ -0,0 +1,12 @@
+import { TokenStruct } from './token-struct';
+import BigNumber from 'bignumber.js';
+import { BlockchainName } from "../blockchains/blockchain-name";
+export type TokenAmountStruct<T extends BlockchainName = BlockchainName> = TokenStruct<T> & ({
+    weiAmount: BigNumber;
+} | {
+    tokenAmount: BigNumber;
+} | {
+    tokenAmount: string;
+} | {
+    weiAmount: string;
+});

package/src/lib/tokens/token-amount-struct.js

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

package/src/lib/tokens/token-amount-struct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-amount-struct.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/token-amount-struct.ts"],"names":[],"mappings":""}

package/src/lib/tokens/token-amount.d.ts

@@ -0,0 +1,16 @@
+import { Token } from './token';
+import { TokenAmountStruct } from './token-amount-struct';
+import BigNumber from 'bignumber.js';
+import { BlockchainName } from "../blockchains/blockchain-name";
+export declare class TokenAmount<T extends BlockchainName = BlockchainName> extends Token<T> {
+    private readonly _weiAmount;
+    get weiAmount(): BigNumber;
+    get stringWeiAmount(): string;
+    get tokenAmount(): BigNumber;
+    get stringTokenAmount(): string;
+    constructor(tokenStruct: TokenAmountStruct<T>);
+    weiAmountMinusSlippage(slippage: number): BigNumber;
+    weiAmountPlusSlippage(slippage: number): BigNumber;
+    private getWeiAmount;
+    get asStructWithAmount(): TokenAmountStruct<BlockchainName>;
+}

package/src/lib/tokens/token-amount.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenAmount = void 0;
+const token_1 = require("./token");
+const bignumber_js_1 = require("bignumber.js");
+class TokenAmount extends token_1.Token {
+    get weiAmount() {
+        return this._weiAmount;
+    }
+    get stringWeiAmount() {
+        return this._weiAmount.toString();
+    }
+    get tokenAmount() {
+        const divider = new bignumber_js_1.default(10).pow(this.decimals);
+        return new bignumber_js_1.default(this._weiAmount).div(divider);
+    }
+    get stringTokenAmount() {
+        return this.tokenAmount.toString();
+    }
+    constructor(tokenStruct) {
+        super(tokenStruct);
+        this._weiAmount = this.getWeiAmount(tokenStruct);
+    }
+    weiAmountMinusSlippage(slippage) {
+        return this._weiAmount.multipliedBy(1 - slippage);
+    }
+    weiAmountPlusSlippage(slippage) {
+        return this._weiAmount.multipliedBy(1 + slippage);
+    }
+    getWeiAmount(tokenStruct) {
+        if ('weiAmount' in tokenStruct) {
+            if (typeof tokenStruct.weiAmount === 'string') {
+                try {
+                    return new bignumber_js_1.default(tokenStruct.weiAmount);
+                }
+                catch {
+                    this.logger?.customWarn('Invalid weiAmount value');
+                    throw new Error('Invalid weiAmount value');
+                }
+            }
+            return tokenStruct.weiAmount;
+        }
+        else {
+            if (typeof tokenStruct.tokenAmount === 'string') {
+                try {
+                    return new bignumber_js_1.default(token_1.Token.toWei(tokenStruct.tokenAmount, tokenStruct.decimals));
+                }
+                catch {
+                    this.logger?.customWarn('Invalid tokenAmount value');
+                    throw new Error('Invalid tokenAmount value');
+                }
+            }
+            return new bignumber_js_1.default(token_1.Token.toWei(tokenStruct.tokenAmount, tokenStruct.decimals));
+        }
+    }
+    get asStructWithAmount() {
+        return {
+            address: this.address,
+            blockchain: this.blockchain,
+            decimals: this.decimals,
+            name: this.name,
+            symbol: this.symbol,
+            weiAmount: this.weiAmount
+        };
+    }
+}
+exports.TokenAmount = TokenAmount;
+//# sourceMappingURL=token-amount.js.map

package/src/lib/tokens/token-amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-amount.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/token-amount.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAEhC,+CAAqC;AAGrC,MAAa,WAAuD,SAAQ,aAAQ;IAGhF,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAW,eAAe;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACtC,CAAC;IAED,IAAW,WAAW;QAClB,MAAM,OAAO,GAAG,IAAI,sBAAS,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,OAAO,IAAI,sBAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,IAAW,iBAAiB;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,YAAY,WAAiC;QACzC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAEM,sBAAsB,CAAC,QAAgB;QAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;IACtD,CAAC;IAEM,qBAAqB,CAAC,QAAgB;QACzC,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;IACtD,CAAC;IAEO,YAAY,CAAC,WAAiC;QAClD,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,OAAO,WAAW,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACD,OAAO,IAAI,sBAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAChD,CAAC;gBAAC,MAAM,CAAC;oBACL,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC;oBACnD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC/C,CAAC;YACL,CAAC;YACD,OAAO,WAAW,CAAC,SAAS,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,IAAI,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;gBAC9C,IAAI,CAAC;oBACD,OAAO,IAAI,sBAAS,CAAC,aAAK,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACrF,CAAC;gBAAC,MAAM,CAAC;oBACL,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,2BAA2B,CAAC,CAAC;oBACrD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBACjD,CAAC;YACL,CAAC;YACD,OAAO,IAAI,sBAAS,CAAC,aAAK,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrF,CAAC;IACL,CAAC;IAED,IAAW,kBAAkB;QACzB,OAAO;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC;IACN,CAAC;CACJ;AAnED,kCAmEC"}

package/src/lib/tokens/token-base-struct.d.ts

@@ -0,0 +1,5 @@
+import { BlockchainName } from "../blockchains/blockchain-name";
+export interface TokenBaseStruct<Blockchain extends BlockchainName = BlockchainName> {
+    address: string;
+    blockchain: Blockchain;
+}

package/src/lib/tokens/token-base-struct.js

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

package/src/lib/tokens/token-base-struct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-base-struct.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/token-base-struct.ts"],"names":[],"mappings":""}

package/src/lib/tokens/token-struct.d.ts

@@ -0,0 +1,8 @@
+import { BlockchainName } from "../blockchains/blockchain-name";
+export type TokenStruct<T extends BlockchainName = BlockchainName> = {
+    blockchain: T;
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+};

package/src/lib/tokens/token-struct.js

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

package/src/lib/tokens/token-struct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-struct.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/token-struct.ts"],"names":[],"mappings":""}

package/src/lib/tokens/token.d.ts

@@ -0,0 +1,30 @@
+import { TokenStruct } from './token-struct';
+import { TokenBaseStruct } from './token-base-struct';
+import BigNumber from 'bignumber.js';
+import { BlockchainName } from "../blockchains/blockchain-name";
+import { ICustomLogger } from "../models/custom-logger";
+export declare class Token<Blockchain extends BlockchainName = BlockchainName> {
+    /**
+     * Maps provided tokens to their addresses.
+     */
+    static tokensToAddresses(tokens: Token[]): string[];
+    protected readonly logger?: ICustomLogger;
+    readonly blockchain: Blockchain;
+    readonly address: string;
+    readonly name: string;
+    readonly symbol: string;
+    readonly decimals: number;
+    get isNative(): boolean;
+    get isWrapped(): boolean;
+    get asStruct(): TokenStruct<Blockchain>;
+    constructor(tokenStruct: TokenStruct<Blockchain>);
+    isEqualTo(token: TokenBaseStruct): boolean;
+    isEqualToTokens(tokens: TokenBaseStruct[]): boolean;
+    static toWei(amount: BigNumber | string | number, decimals?: number, roundingMode?: BigNumber.RoundingMode): string;
+    /**
+     * Converts amount from Wei to Ether units.
+     * @param amountInWei Amount to convert.
+     * @param decimals Token decimals.
+     */
+    static fromWei(amountInWei: BigNumber | string | number, decimals?: number): BigNumber;
+}

package/src/lib/tokens/token.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Token = void 0;
+const bignumber_js_1 = require("bignumber.js");
+const blockchains_info_1 = require("../blockchains/blockchains-info");
+const wrapped_addresses_1 = require("../blockchains/wrapped-addresses");
+class Token {
+    /**
+     * Maps provided tokens to their addresses.
+     */
+    static tokensToAddresses(tokens) {
+        return tokens.map((token) => token.address);
+    }
+    get isNative() {
+        const nativeAddress = '0x0000000000000000000000000000000000000000';
+        return nativeAddress.toLowerCase() === this.address.toLowerCase();
+    }
+    get isWrapped() {
+        if (blockchains_info_1.BlockchainsInfo.isEvmBlockchainName(this.blockchain)) {
+            const address = wrapped_addresses_1.wrappedAddress[this.blockchain];
+            if (!address) {
+                return false;
+            }
+            return address.toLowerCase() === this.address.toLowerCase();
+        }
+        return false;
+    }
+    get asStruct() {
+        return {
+            address: this.address,
+            blockchain: this.blockchain,
+            decimals: this.decimals,
+            name: this.name,
+            symbol: this.symbol
+        };
+    }
+    constructor(tokenStruct) {
+        this.blockchain = tokenStruct.blockchain;
+        this.address = tokenStruct.address;
+        this.name = tokenStruct.name;
+        this.symbol = tokenStruct.symbol;
+        this.decimals = tokenStruct.decimals;
+    }
+    isEqualTo(token) {
+        return token.blockchain === this.blockchain && (token.address.toLowerCase() === this.address.toLowerCase());
+    }
+    isEqualToTokens(tokens) {
+        return tokens.some((token) => this.isEqualTo(token));
+    }
+    static toWei(amount, decimals = 18, roundingMode) {
+        return new bignumber_js_1.default(amount || 0).times(new bignumber_js_1.default(10).pow(decimals)).toFixed(0, roundingMode);
+    }
+    /**
+     * Converts amount from Wei to Ether units.
+     * @param amountInWei Amount to convert.
+     * @param decimals Token decimals.
+     */
+    static fromWei(amountInWei, decimals = 18) {
+        return new bignumber_js_1.default(amountInWei).div(new bignumber_js_1.default(10).pow(decimals));
+    }
+}
+exports.Token = Token;
+//# sourceMappingURL=token.js.map

package/src/lib/tokens/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/tokens/token.ts"],"names":[],"mappings":";;;AAEA,+CAAqC;AACrC,sEAAgE;AAChE,wEAAgE;AAIhE,MAAa,KAAK;IACd;;OAEG;IACI,MAAM,CAAC,iBAAiB,CAAC,MAAe;QAC3C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAcD,IAAW,QAAQ;QACf,MAAM,aAAa,GAAG,4CAA4C,CAAC;QACnE,OAAO,aAAa,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtE,CAAC;IAED,IAAW,SAAS;QAChB,IAAI,kCAAe,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,kCAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAW,QAAQ;QACf,OAAO;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;IAED,YAAY,WAAoC;QAC5C,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IACzC,CAAC;IAEM,SAAS,CAAC,KAAsB;QACnC,OAAO,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChH,CAAC;IAEM,eAAe,CAAC,MAAyB;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,MAAmC,EAAE,QAAQ,GAAG,EAAE,EAAE,YAAqC;QACzG,OAAO,IAAI,sBAAS,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,sBAAS,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACtG,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,OAAO,CAAC,WAAwC,EAAE,QAAQ,GAAG,EAAE;QACzE,OAAO,IAAI,sBAAS,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,sBAAS,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3E,CAAC;CACJ;AA1ED,sBA0EC"}

package/src/lib/utils/cache.decorator.d.ts

@@ -0,0 +1,13 @@
+import { CacheConfig } from "./models/cache-config";
+type DecoratorSignature = <T>(_: Object, __: string | symbol, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T> | void;
+/**
+ * Decorator, used to cache calculated result of functions.
+ */
+export declare function Cache(cacheConfigOrTarget: CacheConfig): DecoratorSignature;
+export declare function Cache<T>(cacheConfigOrTarget: Object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<T>): TypedPropertyDescriptor<T> | void;
+/**
+ * Decorated function should return {@link ConditionalResult}.
+ * You have to check types by yourself {@see https://github.com/microsoft/TypeScript/issues/4881}
+ */
+export declare function PConditionalCache<T>(_: Object, __: string | symbol, descriptor: TypedPropertyDescriptor<T>): TypedPropertyDescriptor<T> | void;
+export {};

package/src/lib/utils/cache.decorator.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = Cache;
+exports.PConditionalCache = PConditionalCache;
+function generateKey(...args) {
+    return args.reduce((acc, arg) => (Object(arg) === arg ? acc + JSON.stringify(arg) : acc + String(arg)), '');
+}
+function saveResult(storage, key, result, maxAge) {
+    const validUntilTimestamp = maxAge ? Date.now() + maxAge : Infinity;
+    storage.set(key, { validUntilTimestamp, value: result });
+}
+function buildGetterCacheDescriptor(propertyKey, { get, enumerable }) {
+    return {
+        enumerable,
+        get() {
+            const value = get.call(this);
+            Object.defineProperty(this, propertyKey, {
+                enumerable,
+                value
+            });
+            return value;
+        }
+    };
+}
+function modifyMethodCacheDescriptor(cacheConfig, descriptor) {
+    const originalMethod = descriptor.value;
+    const storage = new WeakMap();
+    descriptor.value = function method(...args) {
+        if (!storage.has(this)) {
+            storage.set(this, new Map());
+        }
+        const instanceStore = storage.get(this);
+        const key = generateKey(args);
+        if (instanceStore.has(key)) {
+            const cacheItem = instanceStore.get(key);
+            if (cacheItem.validUntilTimestamp > Date.now()) {
+                return cacheItem.value;
+            }
+            instanceStore.delete(key);
+        }
+        let result = originalMethod.apply(this, args);
+        if (cacheConfig.conditionalCache) {
+            if (result instanceof Promise) {
+                const handledPromise = result
+                    .then((resolved) => {
+                    if (resolved.notSave) {
+                        instanceStore.delete(key);
+                    }
+                    return resolved.value;
+                })
+                    .catch(err => {
+                    instanceStore.delete(key);
+                    throw err;
+                });
+                saveResult(instanceStore, key, handledPromise, cacheConfig.maxAge);
+                return handledPromise;
+            }
+            result = result;
+            if (result.notSave) {
+                instanceStore.delete(key);
+            }
+            else {
+                saveResult(instanceStore, key, result.value, cacheConfig.maxAge);
+            }
+            return result.value;
+        }
+        if (result instanceof Promise) {
+            const handledPromise = result.catch(err => {
+                instanceStore.delete(key);
+                throw err;
+            });
+            saveResult(instanceStore, key, handledPromise, cacheConfig.maxAge);
+            return handledPromise;
+        }
+        saveResult(instanceStore, key, result, cacheConfig.maxAge);
+        return result;
+    };
+    return descriptor;
+}
+function CacheBuilder(cacheConfig) {
+    return function cacheBuilder(_, propertyKey, descriptor) {
+        const { get, value: originalMethod } = descriptor;
+        if (get) {
+            return buildGetterCacheDescriptor(propertyKey, {
+                get,
+                enumerable: descriptor.enumerable
+            });
+        }
+        if (!originalMethod) {
+            throw new Error('Descriptor value is undefined.');
+        }
+        return modifyMethodCacheDescriptor(cacheConfig, descriptor);
+    };
+}
+function Cache(cacheConfigOrTarget, propertyKey, descriptor) {
+    const defaultCacheConfig = {};
+    // if decorator called with config as @Cache({ ... })
+    if (!propertyKey) {
+        return CacheBuilder(cacheConfigOrTarget);
+    }
+    // decorator called as @Cache
+    if (!descriptor) {
+        throw new Error('Descriptor is undefined');
+    }
+    return CacheBuilder(defaultCacheConfig)(cacheConfigOrTarget, propertyKey, descriptor);
+}
+/**
+ * Decorated function should return {@link ConditionalResult}.
+ * You have to check types by yourself {@see https://github.com/microsoft/TypeScript/issues/4881}
+ */
+function PConditionalCache(_, __, descriptor) {
+    const originalMethod = descriptor.value;
+    if (!originalMethod) {
+        throw new Error('Descriptor value is undefined');
+    }
+    const storage = new WeakMap();
+    descriptor.value = async function method(...args) {
+        if (!storage.has(this)) {
+            storage.set(this, new Map());
+        }
+        const instanceStore = storage.get(this);
+        const key = generateKey(args);
+        if (instanceStore.has(key)) {
+            return instanceStore.get(key);
+        }
+        const result = await originalMethod.apply(this, args);
+        if (result.notSave) {
+            instanceStore.delete(key);
+        }
+        else {
+            instanceStore.set(key, result.value);
+        }
+        return result.value;
+    };
+}
+//# sourceMappingURL=cache.decorator.js.map

package/src/lib/utils/cache.decorator.js.map

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

package/src/lib/utils/compare-addresses.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Compares provided addresses case insensitive.
+ */
+export declare function compareAddresses(address0: string, address1: string): boolean;

package/src/lib/utils/compare-addresses.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareAddresses = compareAddresses;
+/**
+ * Compares provided addresses case insensitive.
+ */
+function compareAddresses(address0, address1) {
+    return address0.toLowerCase() === address1.toLowerCase();
+}
+//# sourceMappingURL=compare-addresses.js.map

package/src/lib/utils/compare-addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-addresses.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/utils/compare-addresses.ts"],"names":[],"mappings":";;AAGA,4CAEC;AALD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IAC/D,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;AAC7D,CAAC"}

package/src/lib/utils/models/cache-config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration, used for cache decorator.
+ */
+export interface CacheConfig {
+    /**
+     * Amount of time, during which cached result is relevant.
+     */
+    maxAge?: number;
+    /**
+     * If true, then results must be of type {@link ConditionalResult},
+     * defining whether to cache calculated result.
+     */
+    conditionalCache?: boolean;
+}

package/src/lib/utils/models/cache-config.js

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

package/src/lib/utils/models/cache-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-config.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/utils/models/cache-config.ts"],"names":[],"mappings":""}

package/src/lib/utils/models/conditional-result.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Used for {@link Cache} decorator.
+ * User `notSave` field to define whether to cache calculated result.
+ */
+export type ConditionalResult<T> = {
+    notSave: boolean;
+    value: T;
+};

package/src/lib/utils/models/conditional-result.js

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

package/src/lib/utils/models/conditional-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-result.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/utils/models/conditional-result.ts"],"names":[],"mappings":""}

package/src/lib/utils/models/infinite-array.d.ts

@@ -0,0 +1 @@
+export type InfiniteArray<T> = (T | InfiniteArray<T>)[];

package/src/lib/utils/models/infinite-array.js

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

package/src/lib/utils/models/infinite-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infinite-array.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/utils/models/infinite-array.ts"],"names":[],"mappings":""}

package/src/lib/utils/object.d.ts

@@ -0,0 +1,5 @@
+export declare function cloneObject<T extends object>(obj: T): T;
+/**
+ * Filters object, that can possible be `null`.
+ */
+export declare function notNull<T>(obj: T | null): obj is T;

package/src/lib/utils/object.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneObject = cloneObject;
+exports.notNull = notNull;
+function cloneObject(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ * Filters object, that can possible be `null`.
+ */
+function notNull(obj) {
+    return obj !== null;
+}
+//# sourceMappingURL=object.js.map

package/src/lib/utils/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/utils/object.ts"],"names":[],"mappings":";;AAAA,kCAEC;AAKD,0BAEC;AATD,SAAgB,WAAW,CAAmB,GAAM;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAI,GAAa;IACpC,OAAO,GAAG,KAAK,IAAI,CAAC;AACxB,CAAC"}