@paraswap/dex-lib 2.12.12-rfqtests.1 → 2.12.12

package/build/lib/stateful-rpc-poller/state-polling-manager.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatePollingManager = void 0;
+const console_1 = require("console");
+const log4js_1 = require("../log4js");
+class StatePollingManager {
+    constructor(dexHelper) {
+        this.dexHelper = dexHelper;
+        this._lastProcessedBlockNumber = 0;
+        this._registeredPendingPools = [];
+        // ALl registered instances from identifier to instance
+        this._poolsToInstances = {};
+        // This pools will be updated if we see new block and the time has come
+        this._poolsToBeUpdated = new Set();
+        // This pools wont be updated before we change _isStateToBeUpdated to true
+        this._idlePools = new Set();
+        this.logger = (0, log4js_1.getLogger)(`${this.constructor.name}-${dexHelper.config.data.network}`);
+        if (this.isMaster) {
+        }
+    }
+    static getInstance(dexHelper) {
+        const network = dexHelper.config.data.network;
+        if (StatePollingManager.__instances[network] === undefined) {
+            StatePollingManager.__instances[network] = new StatePollingManager(dexHelper);
+        }
+        return StatePollingManager.__instances[network];
+    }
+    get isMaster() {
+        return !this.dexHelper.config.isSlave;
+    }
+    enableStateTracking(identifierKey) {
+        (0, console_1.assert)(this._poolsToInstances[identifierKey] !== undefined, `enableTracking: pool with identifierKey=${identifierKey} is not initialized`);
+        this._poolsToBeUpdated.add(identifierKey);
+        this._idlePools.delete(identifierKey);
+    }
+    disableStateTracking(identifierKey) {
+        (0, console_1.assert)(this._poolsToInstances[identifierKey] !== undefined, `disableStateTracking: pool with identifierKey=${identifierKey} is not initialized`);
+        this._poolsToBeUpdated.delete(identifierKey);
+        this._idlePools.add(identifierKey);
+    }
+    async onBlockNumber(blockNumber) {
+        if (!this.isMaster) {
+            return;
+        }
+        // Events-client calls several times for the same blockNumber sometimes
+        // I want to filter them. The only condition, that matters is that blockNumbers are the same
+        if (this._lastProcessedBlockNumber === blockNumber) {
+            return;
+        }
+        this._lastProcessedBlockNumber = blockNumber;
+        const poolsToBeUpdated = [];
+        Array.from(this._poolsToBeUpdated).forEach(p => {
+            const pool = this._keyToPoolInstance(p);
+            // We always expect pools in _poolsToBeUpdated to participate in updates
+            (0, console_1.assert)(pool.isPoolParticipateInUpdates, `onBlockNumber: pool=${p} from ${pool.dexKey} is not participate in updates`);
+            if (!pool.isPoolInTheMiddleOfUpdate &&
+                pool.isTimeToTriggerUpdate(blockNumber)) {
+                pool.isPoolInTheMiddleOfUpdate = true;
+                poolsToBeUpdated.push(pool);
+            }
+        });
+        if (poolsToBeUpdated.length === 0) {
+            this.logger.debug(`onBlockNumber=${blockNumber} no pools to be updated. Skipping`);
+            return;
+        }
+        this._updatePoolStates(poolsToBeUpdated)
+            .then(receivedBlockNumber => {
+            // There is no guarantee that we receive latest state. This is our best effort
+            if (receivedBlockNumber < blockNumber) {
+                this.logger.warn(`onBlockNumber=${blockNumber} at least for some pools receivedBlockNumber=${receivedBlockNumber} is lower than expected`);
+            }
+        })
+            .catch(e => this.logger.error(`onBlockNumber=${blockNumber} error while updating pools: ${e}`))
+            .finally(() => {
+            poolsToBeUpdated.forEach(pool => {
+                pool.isPoolInTheMiddleOfUpdate = false;
+            });
+        });
+    }
+    async _updatePoolStates(poolsToBeUpdated, blockNumber = 'latest', numberOfChunks) {
+        const indexDividers = [];
+        const multiCalls = poolsToBeUpdated
+            .map((p, i) => {
+            const callData = p.getFetchStateWithBlockInfoMultiCalls();
+            indexDividers.push(callData.length);
+            return callData;
+        })
+            .flat();
+        (0, console_1.assert)(indexDividers.length === poolsToBeUpdated.length, 'indexDividers.length === poolsToBeUpdated.length');
+        const results = (await this.dexHelper.multiWrapper.tryAggregate(false, multiCalls, blockNumber, numberOfChunks));
+        let minBlockNumber = 0;
+        const lastUpdatedAtMs = Date.now();
+        // Let's pack each result into relevant pools
+        const unFlattenedResults = [];
+        let accumulatedStart = 0;
+        indexDividers.forEach(divider => {
+            unFlattenedResults.push(results.slice(accumulatedStart, accumulatedStart + divider));
+            accumulatedStart += divider;
+        });
+        (0, console_1.assert)(unFlattenedResults.length === poolsToBeUpdated.length, 'unFlattenedResults.length === poolsToBeUpdated.length');
+        await Promise.all(unFlattenedResults.map(async (result, index) => {
+            const pool = poolsToBeUpdated[index];
+            try {
+                const parsedStateResult = pool.parseStateFromMultiResultsWithBlockInfo(result, lastUpdatedAtMs);
+                minBlockNumber = Math.min(parsedStateResult.blockNumber, minBlockNumber);
+                await pool.setState(parsedStateResult.value, parsedStateResult.blockNumber, parsedStateResult.lastUpdatedAtMs);
+            }
+            catch (e) {
+                this.logger.error(`onBlockNumber=${blockNumber} error while parsing state from multicall for pool=${pool.identifierKey} from ${pool.dexKey}: ${e}`);
+            }
+        }));
+        return minBlockNumber;
+    }
+    // When this method is called, we expect that all pools are initialized
+    _keyToPoolInstance(identifierKey) {
+        const pool = this._poolsToInstances[identifierKey];
+        (0, console_1.assert)(pool !== undefined, `keyToPoolInstance: pool=${identifierKey} is undefined`);
+        return pool;
+    }
+    // Once you instantiated all your pools, you should trigger at the end of initializing this method
+    // So all state will be initialized. It is not part of constructor, because and that time we don't have
+    // all classes built
+    initializeAllPendingPools() {
+        if (this._registeredPendingPools.length === 0) {
+            return;
+        }
+        this._registeredPendingPools.forEach(p => {
+            this.initializePool(p);
+        });
+        this._registeredPendingPools = [];
+    }
+    registerPendingPool(statefulRpcPoller) {
+        if (this._poolsToInstances[statefulRpcPoller.identifierKey]) {
+            this.logger.error(`Attempt to register initialized pool=${statefulRpcPoller.identifierKey}`);
+            return;
+        }
+        const alreadyRegisteredAsPending = this._registeredPendingPools.some(p => p.identifierKey === statefulRpcPoller.identifierKey);
+        if (alreadyRegisteredAsPending) {
+            this.logger.error(`Attempt to register pool=${statefulRpcPoller.identifierKey} twice`);
+            return;
+        }
+        this._registeredPendingPools.push(statefulRpcPoller);
+    }
+    initializePool(statefulRpcPoller) {
+        const { identifierKey } = statefulRpcPoller;
+        if (this._idlePools.has(identifierKey) ||
+            this._poolsToBeUpdated.has(identifierKey) ||
+            this._poolsToInstances.hasOwnProperty(identifierKey)) {
+            this.logger.warn(`Attempt to reinitialize existing poolIdentifier=` +
+                `${identifierKey}. Maybe there is memory leak`);
+        }
+        else {
+            this._poolsToInstances[identifierKey] = statefulRpcPoller;
+            statefulRpcPoller.isPoolParticipateInUpdates
+                ? this._poolsToBeUpdated.add(identifierKey)
+                : this._idlePools.add(identifierKey);
+            const currentBlockNumber = this.dexHelper.blockManager.getActiveChainHead()?.number;
+            (0, console_1.assert)(currentBlockNumber !== undefined, 'currentBlockNumber !== undefined');
+            statefulRpcPoller
+                .initializeState()
+                .then(() => {
+                this.logger.info(`Successfully initialized pool=${identifierKey}`);
+            })
+                .catch(e => {
+                // Must never happen
+                this.logger.error(`initializePool: pool=${identifierKey} from ${statefulRpcPoller.dexKey} error while initializing state: ${e}`);
+            });
+        }
+    }
+}
+exports.StatePollingManager = StatePollingManager;
+StatePollingManager.__instances = {};
+//# sourceMappingURL=state-polling-manager.js.map

package/build/lib/stateful-rpc-poller/state-polling-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-polling-manager.js","sourceRoot":"","sources":["../../../src/lib/stateful-rpc-poller/state-polling-manager.ts"],"names":[],"mappings":"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"}

package/build/lib/stateful-rpc-poller/stateful-rpc-poller.d.ts

@@ -0,0 +1,72 @@
+import { Logger, LogLevels } from '../../types';
+import { IDexHelper } from '../../dex-helper';
+import { IStatefulRpcPoller, ObjWithUpdateInfo, PollingManagerControllersCb, StateSources } from './types';
+import { MultiCallParams, MultiResult } from '../multi-wrapper';
+import { LogMessagesSuppressor, MessageInfo } from '../log-messages-suppressor';
+declare const StatefulRPCPollerMessages: {
+    readonly ERROR_FETCHING_STATE_FROM_CACHE: "Unexpected error while fetching state from Cache";
+    readonly ERROR_FETCHING_STATE_FROM_RPC: "Unexpected error while fetching state from RPC";
+    readonly ERROR_SAVING_LIQUIDITY_IN_CACHE: "Unexpected error while saving liquidity in Cache";
+    readonly ERROR_SAVING_STATE_IN_CACHE: "Unexpected error while saving state in Cache";
+    readonly FALLBACK_TO_RPC: "Failed to retrieve updated state from cache. Falling back to RPC";
+    readonly LIQUIDITY_INFO_IS_OUTDATED: string;
+};
+export declare abstract class StatefulRpcPoller<State, M> implements IStatefulRpcPoller<State, M> {
+    readonly dexKey: string;
+    protected dexHelper: IDexHelper;
+    protected liquidityThresholdForUpdate: number;
+    protected liquidityUpdateAllowedDelayMs: number;
+    protected isLiquidityTracked: boolean;
+    protected managerCbControllers: PollingManagerControllersCb;
+    protected maxAllowedStateDelayInBlocks: number;
+    protected blocksBackToTriggerUpdate: number;
+    protected liquidityUpdatePeriodMs: number;
+    static StatefulRPCPollerMessages: Record<keyof typeof StatefulRPCPollerMessages, MessageInfo<typeof StatefulRPCPollerMessages>>;
+    protected _stateWithUpdateInfo?: ObjWithUpdateInfo<State>;
+    protected _liquidityInUSDWithUpdateInfo: ObjWithUpdateInfo<number>;
+    readonly cacheStateKey: string;
+    readonly cacheLiquidityMapKey: string;
+    protected _cachedMultiCallData?: [
+        MultiCallParams<number>,
+        ...MultiCallParams<M>[]
+    ];
+    protected _getBlockNumberMultiCall: MultiCallParams<number>;
+    readonly entityName: string;
+    protected logMessagesSuppressor: LogMessagesSuppressor<typeof StatefulRPCPollerMessages>;
+    protected _isPoolParticipateInUpdates: boolean;
+    protected _isPoolInTheMiddleOfUpdate: boolean;
+    readonly identifierKey: string;
+    protected logger: Logger;
+    constructor(dexKey: string, poolIdentifier: string, dexHelper: IDexHelper, liquidityThresholdForUpdate: number, liquidityUpdateAllowedDelayMs: number, isLiquidityTracked: boolean, managerCbControllers: PollingManagerControllersCb, maxAllowedStateDelayInBlocks?: number, blocksBackToTriggerUpdate?: number, liquidityUpdatePeriodMs?: number);
+    get network(): number;
+    protected get isMaster(): boolean;
+    protected _isStateOutdated(checkForBlockNumber: number, stateValidBlockNumber: number, stateValidityBlockNumDelay: number): boolean;
+    protected _isStateOutdatedForUse(checkForBlockNumber: number, stateValidBlockNumber: number): boolean;
+    isTimeToTriggerUpdate(blocknumber: number): boolean;
+    protected _retrieveStateWithChecks(retriever: () => Promise<ObjWithUpdateInfo<State> | null>, blockNumber: number | 'latest', source: StateSources): Promise<ObjWithUpdateInfo<State> | null>;
+    getState(blockNumber?: number | 'latest', forInitialization?: boolean, saveInMemory?: boolean): Promise<ObjWithUpdateInfo<State> | null>;
+    protected _logMessageWithSuppression(msgKey: keyof typeof StatefulRPCPollerMessages, ...args: unknown[]): void;
+    protected _immediateLogMessage(message: string, level: LogLevels, ...args: unknown[]): void;
+    get isPoolParticipateInUpdates(): boolean;
+    set isPoolParticipateInUpdates(value: boolean);
+    get isPoolInTheMiddleOfUpdate(): boolean;
+    set isPoolInTheMiddleOfUpdate(value: boolean);
+    protected abstract _getFetchStateMultiCalls(): MultiCallParams<M>[];
+    getFetchStateWithBlockInfoMultiCalls(): [
+        MultiCallParams<number>,
+        ...MultiCallParams<M>[]
+    ];
+    protected abstract _parseStateFromMultiResults(multiOutputs: M[]): State;
+    parseStateFromMultiResultsWithBlockInfo(multiOutputs: [MultiResult<number>, ...MultiResult<M>[]], lastUpdatedAtMs: number): ObjWithUpdateInfo<State>;
+    fetchLatestStateFromRpc(): Promise<ObjWithUpdateInfo<State> | null>;
+    setState(state: State, blockNumber: number, lastUpdatedAtMs: number): Promise<void>;
+    protected _saveStateInCache(): Promise<boolean>;
+    protected _saveLiquidityInCache(): Promise<boolean>;
+    fetchStateFromCache(): Promise<ObjWithUpdateInfo<State> | null>;
+    protected _fetchLiquidityFromCache(): Promise<ObjWithUpdateInfo<number> | null>;
+    setLiquidity(newLiquidityInUSD: number, lastUpdatedAtMs: number, blockNumber?: number): Promise<void>;
+    protected _adjustIsStateToBeUpdated(): void;
+    protected _getExpiryTimeForCachedLiquidity(): number;
+    initializeState(): Promise<void>;
+}
+export {};

package/build/lib/stateful-rpc-poller/stateful-rpc-poller.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatefulRpcPoller = void 0;
+const types_1 = require("./types");
+const constants_1 = require("../../constants");
+const decoders_1 = require("../decoders");
+const ts_essentials_1 = require("ts-essentials");
+const log4js_1 = require("../log4js");
+const log_messages_suppressor_1 = require("../log-messages-suppressor");
+const utils_1 = require("../../utils");
+const utils_2 = require("./utils");
+const StatefulRPCPollerMessages = {
+    ERROR_FETCHING_STATE_FROM_CACHE: `Unexpected error while fetching state from Cache`,
+    ERROR_FETCHING_STATE_FROM_RPC: `Unexpected error while fetching state from RPC`,
+    ERROR_SAVING_LIQUIDITY_IN_CACHE: `Unexpected error while saving liquidity in Cache`,
+    ERROR_SAVING_STATE_IN_CACHE: `Unexpected error while saving state in Cache`,
+    FALLBACK_TO_RPC: `Failed to retrieve updated state from cache. Falling back to RPC`,
+    LIQUIDITY_INFO_IS_OUTDATED: `Liquidity info in USD is outdated. Wil be updating ` +
+        `every pool that is outdated to not degrade performance`,
+};
+const DEFAULT_LIQUIDITY_UPDATE_PERIOD_MS = 2 * 60 * 1000;
+const DEFAULT_STATE_INIT_RETRY_MS = 1000;
+class StatefulRpcPoller {
+    constructor(dexKey, poolIdentifier, dexHelper, 
+    // If liquidity is less than this value, we will not update state
+    liquidityThresholdForUpdate, 
+    // If for some reason liquidity update is broken, for this delay we will still
+    // continue to serve update state
+    liquidityUpdateAllowedDelayMs, 
+    // For some pools we don't worry about liquidity and want always to keep state updated
+    isLiquidityTracked, 
+    // Polling manager callbacks. They are useful when you want
+    // to give some change information in reverse way.
+    // For example, you changed liquidity state, notify manager to
+    // not poll that particular pools
+    managerCbControllers, 
+    // If the state is outdated more than this amount of blocks, we will not use this state anymore
+    maxAllowedStateDelayInBlocks = dexHelper.config.data
+        .rpcPollingMaxAllowedStateDelayInBlocks, 
+    // When cross this threshold we will trigger update. The idea is this number is less than
+    // maxAllowedStateDelayToUpdate, so we trigger update before state become invalid.
+    // If blocksBackToTriggerUpdate = maxAllowedStateDelayInBlocks, we will do our best
+    // effort to keep up with a tip of chain: trigger update on every new block
+    blocksBackToTriggerUpdate = dexHelper.config.data
+        .rpcPollingBlocksBackToTriggerUpdate, liquidityUpdatePeriodMs = DEFAULT_LIQUIDITY_UPDATE_PERIOD_MS) {
+        this.dexKey = dexKey;
+        this.dexHelper = dexHelper;
+        this.liquidityThresholdForUpdate = liquidityThresholdForUpdate;
+        this.liquidityUpdateAllowedDelayMs = liquidityUpdateAllowedDelayMs;
+        this.isLiquidityTracked = isLiquidityTracked;
+        this.managerCbControllers = managerCbControllers;
+        this.maxAllowedStateDelayInBlocks = maxAllowedStateDelayInBlocks;
+        this.blocksBackToTriggerUpdate = blocksBackToTriggerUpdate;
+        this.liquidityUpdatePeriodMs = liquidityUpdatePeriodMs;
+        // This values is used to determine if current pool will participate in update or not
+        // We don't want to keep track of state for pools without liquidity
+        this._liquidityInUSDWithUpdateInfo = {
+            value: 0,
+            blockNumber: 0,
+            lastUpdatedAtMs: 0,
+        };
+        // This flag is changed only via isPoolParticipateInUpdates setter
+        // It is used to determine if we should update state or not
+        this._isPoolParticipateInUpdates = true;
+        this._isPoolInTheMiddleOfUpdate = false;
+        // Don't make it too custom, like adding poolIdentifier. It will break log suppressor
+        // If we are really need to do that, update log Suppressor to handle that case
+        // The idea is to have one entity name per Dex level, not pool level
+        this.entityName = `StatefulPoller-${this.dexKey}-${this.dexHelper.config.data.network}`;
+        // I made it a little bit different from poolIdentifier, because usually
+        // pool identifier doesn't contain network information and it may occasionally
+        // collide across chains, though that scenario is very unlikely to happen
+        // For consumers they still can use poolIdentifier to get instance, but since
+        // we always give network information, it is better we can hide this implementation detail
+        this.identifierKey = (0, utils_2.getIdentifierKeyForRpcPoller)(poolIdentifier, this.network);
+        this.cacheLiquidityMapKey =
+            `${constants_1.CACHE_PREFIX}_${this.network}_${this.dexKey}_liquidity_usd`.toLowerCase();
+        this.cacheStateKey =
+            `${constants_1.CACHE_PREFIX}_${this.network}_${this.dexKey}_states`.toLowerCase();
+        this.logger = (0, log4js_1.getLogger)(`${this.entityName}`);
+        (0, ts_essentials_1.assert)(this.maxAllowedStateDelayInBlocks >= 0, `${this.dexKey}-${this.network}-${this.identifierKey}: ` +
+            `Max allowed state delay must be >= 0. Received ${this.maxAllowedStateDelayInBlocks}`);
+        (0, ts_essentials_1.assert)(this.blocksBackToTriggerUpdate >= 0, `${this.dexKey}-${this.network}-${this.identifierKey}: ` +
+            `Blocks back to trigger update must be >= 0. Received ${this.blocksBackToTriggerUpdate}`);
+        // You can not go more blocks back than you allow to be delayed
+        (0, ts_essentials_1.assert)(this.blocksBackToTriggerUpdate <= this.maxAllowedStateDelayInBlocks, `${this.dexKey}-${this.network}-${this.identifierKey}: ` +
+            `Blocks back to trigger update must be <= maxAllowedStateDelayInBlocks. ` +
+            `Received ${this.blocksBackToTriggerUpdate} > ${this.maxAllowedStateDelayInBlocks}`);
+        this._getBlockNumberMultiCall = {
+            target: this.dexHelper.multiContract.options.address,
+            callData: this.dexHelper.multiContract.methods
+                .getBlockNumber()
+                .encodeABI(),
+            decodeFunction: decoders_1.uint256DecodeToNumber,
+        };
+        this.logMessagesSuppressor = log_messages_suppressor_1.LogMessagesSuppressor.getLogSuppressorInstance(this.entityName, StatefulRpcPoller.StatefulRPCPollerMessages, this.logger);
+        // This is done to not rely on manual initialize pool call.
+        // Any time new pool initialized, it is already automatically registered in polling manager
+        this.managerCbControllers.registerPendingPool(this);
+    }
+    get network() {
+        return this.dexHelper.config.data.network;
+    }
+    get isMaster() {
+        return !this.dexHelper.config.isSlave;
+    }
+    _isStateOutdated(checkForBlockNumber, stateValidBlockNumber, stateValidityBlockNumDelay) {
+        return (checkForBlockNumber - stateValidBlockNumber > stateValidityBlockNumDelay);
+    }
+    _isStateOutdatedForUse(checkForBlockNumber, stateValidBlockNumber) {
+        return this._isStateOutdated(checkForBlockNumber, stateValidBlockNumber, this.maxAllowedStateDelayInBlocks);
+    }
+    isTimeToTriggerUpdate(blocknumber) {
+        return this._isStateOutdated(blocknumber, this._stateWithUpdateInfo?.blockNumber || 0, this.blocksBackToTriggerUpdate);
+    }
+    async _retrieveStateWithChecks(retriever, blockNumber, source) {
+        const state = await retriever();
+        if (state) {
+            if (blockNumber === 'latest' ||
+                !this._isStateOutdatedForUse(blockNumber, state.blockNumber)) {
+                return state;
+            }
+            else {
+                this._immediateLogMessage(`State from ${source} is outdated. Valid for number ${state.blockNumber}, but requested for ${blockNumber}. Diff ${blockNumber - state.blockNumber} blocks`, 'trace');
+            }
+        }
+        else {
+            if (source === types_1.StateSources.LOCAL_MEMORY) {
+                this._immediateLogMessage(`State is not initialized in memory`, 'error');
+            }
+            else {
+                this._immediateLogMessage(`State from ${source} is not available`, 'trace');
+            }
+        }
+        return null;
+    }
+    async getState(blockNumber = 'latest', forInitialization = false, 
+    // If we found that state in memory is outdated, then we save it for future use
+    saveInMemory = true) {
+        // If it is for initialization purposes, we for sure doesn't have state in memory
+        if (!forInitialization) {
+            // Try to get with least effort from local memory
+            const localState = await this._retrieveStateWithChecks(async () => this._stateWithUpdateInfo ?? null, blockNumber, types_1.StateSources.LOCAL_MEMORY);
+            if (localState !== null) {
+                return localState;
+            }
+        }
+        // If we failed to get from memory. Try to fetch state from cache
+        try {
+            const cacheState = await this._retrieveStateWithChecks(async () => (await this.fetchStateFromCache()) ?? null, blockNumber, types_1.StateSources.CACHE);
+            if (cacheState !== null) {
+                if (saveInMemory) {
+                    // We want to save latest available state in memory for future use
+                    // This await shouldn't slow down because if we are slave, we won't save state in cache
+                    await this.setState(cacheState.value, cacheState.blockNumber, cacheState.lastUpdatedAtMs);
+                }
+                return cacheState;
+            }
+        }
+        catch (e) {
+            this._logMessageWithSuppression(`ERROR_FETCHING_STATE_FROM_CACHE`, e);
+        }
+        this._logMessageWithSuppression('FALLBACK_TO_RPC');
+        // As a last step. If we failed everything above, try to fetch from RPC
+        try {
+            const rpcState = await this._retrieveStateWithChecks(async () => (await this.fetchLatestStateFromRpc()) ?? null, blockNumber, types_1.StateSources.RPC);
+            if (rpcState !== null) {
+                if (saveInMemory) {
+                    // We want to save latest available state in memory for future use
+                    // This await shouldn't slow down because if we are slave, we won't save state in cache
+                    await this.setState(rpcState.value, rpcState.blockNumber, rpcState.lastUpdatedAtMs);
+                    return rpcState;
+                }
+            }
+        }
+        catch (e) {
+            this._logMessageWithSuppression('ERROR_FETCHING_STATE_FROM_RPC', e);
+        }
+        // If nothing works, then we can not do anything here and skip this pool
+        return null;
+    }
+    _logMessageWithSuppression(msgKey, ...args) {
+        this.logMessagesSuppressor.logMessage(msgKey, this.identifierKey, ...args);
+    }
+    _immediateLogMessage(message, level, ...args) {
+        this.logger[level](`${this.entityName}: ${message}`, ...args);
+    }
+    get isPoolParticipateInUpdates() {
+        return this._isPoolParticipateInUpdates;
+    }
+    set isPoolParticipateInUpdates(value) {
+        // If we change state update status, we always keep relevant info in manager
+        value
+            ? this.managerCbControllers.enableStateTracking(this.identifierKey)
+            : this.managerCbControllers.disableStateTracking(this.identifierKey);
+        this._isPoolParticipateInUpdates = value;
+    }
+    get isPoolInTheMiddleOfUpdate() {
+        return this._isPoolInTheMiddleOfUpdate;
+    }
+    set isPoolInTheMiddleOfUpdate(value) {
+        this._isPoolInTheMiddleOfUpdate = value;
+    }
+    getFetchStateWithBlockInfoMultiCalls() {
+        if (this._cachedMultiCallData === undefined) {
+            const stateMultiCalls = this._getFetchStateMultiCalls();
+            this._cachedMultiCallData = [
+                this._getBlockNumberMultiCall,
+                ...stateMultiCalls,
+            ];
+        }
+        return this._cachedMultiCallData;
+    }
+    parseStateFromMultiResultsWithBlockInfo(multiOutputs, lastUpdatedAtMs) {
+        // By abstract I mean for abstract method which must be implemented
+        const [blockNumber, ...outputsForAbstract] = multiOutputs.map((m, i) => {
+            if (!m.success) {
+                throw new Error(`${this.entityName} failed to get multicall with index ${i}`);
+            }
+            return m.returnData;
+        });
+        return {
+            value: this._parseStateFromMultiResults(outputsForAbstract),
+            blockNumber,
+            lastUpdatedAtMs,
+        };
+    }
+    async fetchLatestStateFromRpc() {
+        const multiCalls = this.getFetchStateWithBlockInfoMultiCalls();
+        try {
+            const lastUpdatedAtMs = Date.now();
+            const aggregatedResults = (await this.dexHelper.multiWrapper.tryAggregate(true, multiCalls));
+            return this.parseStateFromMultiResultsWithBlockInfo(aggregatedResults, lastUpdatedAtMs);
+        }
+        catch (e) {
+            this._logMessageWithSuppression('ERROR_FETCHING_STATE_FROM_RPC', e);
+        }
+        return null;
+    }
+    async setState(state, blockNumber, lastUpdatedAtMs) {
+        if (this._stateWithUpdateInfo === undefined) {
+            this._stateWithUpdateInfo = {
+                value: state,
+                blockNumber,
+                lastUpdatedAtMs,
+            };
+        }
+        else {
+            this._stateWithUpdateInfo.value = state;
+            this._stateWithUpdateInfo.blockNumber = blockNumber;
+            this._stateWithUpdateInfo.lastUpdatedAtMs = lastUpdatedAtMs;
+        }
+        // Master version must keep cache up to date
+        if (this.isMaster) {
+            await this._saveStateInCache();
+        }
+    }
+    async _saveStateInCache() {
+        try {
+            await this.dexHelper.cache.hset(this.cacheStateKey, this.identifierKey, utils_1.Utils.Serialize(this._stateWithUpdateInfo));
+            return true;
+        }
+        catch (e) {
+            this._logMessageWithSuppression('ERROR_SAVING_STATE_IN_CACHE', e);
+        }
+        return false;
+    }
+    async _saveLiquidityInCache() {
+        try {
+            await this.dexHelper.cache.setex(this.dexKey, this.network, this.cacheLiquidityMapKey, this._getExpiryTimeForCachedLiquidity(), JSON.stringify(this._liquidityInUSDWithUpdateInfo));
+            return true;
+        }
+        catch (e) {
+            this._logMessageWithSuppression('ERROR_SAVING_LIQUIDITY_IN_CACHE', e);
+        }
+        return false;
+    }
+    async fetchStateFromCache() {
+        const resultUnparsed = await this.dexHelper.cache.hget(this.cacheStateKey, this.identifierKey);
+        if (resultUnparsed !== null) {
+            return utils_1.Utils.Parse(resultUnparsed);
+        }
+        return null;
+    }
+    async _fetchLiquidityFromCache() {
+        const resultUnparsed = await this.dexHelper.cache.get(this.dexKey, this.network, this.cacheStateKey);
+        if (resultUnparsed !== null) {
+            return utils_1.Utils.Parse(resultUnparsed);
+        }
+        return null;
+    }
+    async setLiquidity(newLiquidityInUSD, lastUpdatedAtMs, blockNumber) {
+        this._liquidityInUSDWithUpdateInfo.value = newLiquidityInUSD;
+        this._liquidityInUSDWithUpdateInfo.lastUpdatedAtMs = lastUpdatedAtMs;
+        this._liquidityInUSDWithUpdateInfo.blockNumber = blockNumber || 0;
+        this._adjustIsStateToBeUpdated();
+        if (this.isMaster) {
+            await this._saveLiquidityInCache();
+        }
+    }
+    _adjustIsStateToBeUpdated() {
+        if (this.isLiquidityTracked) {
+            if (Date.now() - this._liquidityInUSDWithUpdateInfo.lastUpdatedAtMs >
+                this.liquidityUpdateAllowedDelayMs) {
+                this._logMessageWithSuppression('LIQUIDITY_INFO_IS_OUTDATED', `Last updated at ${this._liquidityInUSDWithUpdateInfo.lastUpdatedAtMs}`);
+                this.isPoolParticipateInUpdates = true;
+            }
+            else {
+                this.isPoolParticipateInUpdates =
+                    this._liquidityInUSDWithUpdateInfo.value >=
+                        this.liquidityThresholdForUpdate;
+            }
+        }
+    }
+    _getExpiryTimeForCachedLiquidity() {
+        // Give it 10 minutes margin to recover
+        return Math.floor(this.liquidityUpdatePeriodMs / 1000) + 10 * 60 * 1000;
+    }
+    async initializeState() {
+        try {
+            const state = await this.fetchLatestStateFromRpc();
+            if (state === null) {
+                this.logger.error(`initializePool: pool=${this.identifierKey} from ${this.dexKey} state is null. Retry in ${DEFAULT_STATE_INIT_RETRY_MS} ms`);
+            }
+            else {
+                this.setState(state.value, state.blockNumber, state.lastUpdatedAtMs);
+                return;
+            }
+        }
+        catch (e) {
+            this.logger.error(`initializePool: pool=${this.identifierKey} from ${this.dexKey} failed to initialize state from RPC. Retry in ${DEFAULT_STATE_INIT_RETRY_MS} ms`, e);
+        }
+        setTimeout(() => this.initializeState(), DEFAULT_STATE_INIT_RETRY_MS);
+    }
+}
+exports.StatefulRpcPoller = StatefulRpcPoller;
+StatefulRpcPoller.StatefulRPCPollerMessages = {
+    ERROR_FETCHING_STATE_FROM_CACHE: {
+        key: 'ERROR_FETCHING_STATE_FROM_CACHE',
+        message: StatefulRPCPollerMessages.ERROR_FETCHING_STATE_FROM_CACHE,
+        logLevel: 'error',
+    },
+    ERROR_FETCHING_STATE_FROM_RPC: {
+        key: 'ERROR_FETCHING_STATE_FROM_RPC',
+        message: StatefulRPCPollerMessages.ERROR_FETCHING_STATE_FROM_RPC,
+        logLevel: 'error',
+    },
+    ERROR_SAVING_LIQUIDITY_IN_CACHE: {
+        key: 'ERROR_SAVING_LIQUIDITY_IN_CACHE',
+        message: StatefulRPCPollerMessages.ERROR_SAVING_LIQUIDITY_IN_CACHE,
+        logLevel: 'error',
+    },
+    ERROR_SAVING_STATE_IN_CACHE: {
+        key: 'ERROR_SAVING_STATE_IN_CACHE',
+        message: StatefulRPCPollerMessages.ERROR_SAVING_STATE_IN_CACHE,
+        logLevel: 'error',
+    },
+    LIQUIDITY_INFO_IS_OUTDATED: {
+        key: 'LIQUIDITY_INFO_IS_OUTDATED',
+        message: StatefulRPCPollerMessages.LIQUIDITY_INFO_IS_OUTDATED,
+        logLevel: 'error',
+    },
+    FALLBACK_TO_RPC: {
+        key: 'FALLBACK_TO_RPC',
+        message: StatefulRPCPollerMessages.FALLBACK_TO_RPC,
+        logLevel: 'warn',
+    },
+};
+//# sourceMappingURL=stateful-rpc-poller.js.map

package/build/lib/stateful-rpc-poller/stateful-rpc-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateful-rpc-poller.js","sourceRoot":"","sources":["../../../src/lib/stateful-rpc-poller/stateful-rpc-poller.ts"],"names":[],"mappings":";;;AAEA,mCAKiB;AAEjB,+CAA+C;AAC/C,0CAAoD;AACpD,iDAAuC;AACvC,sCAAsC;AACtC,wEAAgF;AAChF,uCAAoC;AACpC,mCAAuD;AAEvD,MAAM,yBAAyB,GAAG;IAChC,+BAA+B,EAAE,kDAAkD;IACnF,6BAA6B,EAAE,gDAAgD;IAC/E,+BAA+B,EAAE,kDAAkD;IACnF,2BAA2B,EAAE,8CAA8C;IAE3E,eAAe,EAAE,kEAAkE;IAEnF,0BAA0B,EACxB,qDAAqD;QACrD,wDAAwD;CAClD,CAAC;AAEX,MAAM,kCAAkC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACzD,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAsB,iBAAiB;IA8ErC,YACW,MAAc,EACvB,cAAsB,EACZ,SAAqB;IAE/B,iEAAiE;IACvD,2BAAmC;IAC7C,8EAA8E;IAC9E,iCAAiC;IACvB,6BAAqC;IAE/C,sFAAsF;IAC5E,kBAA2B;IAErC,2DAA2D;IAC3D,kDAAkD;IAClD,8DAA8D;IAC9D,iCAAiC;IACvB,oBAAiD;IAE3D,+FAA+F;IACrF,+BAAuC,SAAS,CAAC,MAAM,CAAC,IAAI;SACnE,sCAAsC;IAEzC,yFAAyF;IACzF,kFAAkF;IAClF,mFAAmF;IACnF,2EAA2E;IACjE,4BAAoC,SAAS,CAAC,MAAM,CAAC,IAAI;SAChE,mCAAmC,EAE5B,0BAA0B,kCAAkC;QA9B7D,WAAM,GAAN,MAAM,CAAQ;QAEb,cAAS,GAAT,SAAS,CAAY;QAGrB,gCAA2B,GAA3B,2BAA2B,CAAQ;QAGnC,kCAA6B,GAA7B,6BAA6B,CAAQ;QAGrC,uBAAkB,GAAlB,kBAAkB,CAAS;QAM3B,yBAAoB,GAApB,oBAAoB,CAA6B;QAGjD,iCAA4B,GAA5B,4BAA4B,CACG;QAM/B,8BAAyB,GAAzB,yBAAyB,CACG;QAE5B,4BAAuB,GAAvB,uBAAuB,CAAqC;QAlExE,qFAAqF;QACrF,mEAAmE;QACzD,kCAA6B,GAA8B;YACnE,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,CAAC;SACnB,CAAC;QAmBF,kEAAkE;QAClE,2DAA2D;QACjD,gCAA2B,GAAY,IAAI,CAAC;QAE5C,+BAA0B,GAAY,KAAK,CAAC;QAuCpD,qFAAqF;QACrF,8EAA8E;QAC9E,oEAAoE;QACpE,IAAI,CAAC,UAAU,GAAG,kBAAkB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAExF,wEAAwE;QACxE,8EAA8E;QAC9E,yEAAyE;QACzE,6EAA6E;QAC7E,0FAA0F;QAC1F,IAAI,CAAC,aAAa,GAAG,IAAA,oCAA4B,EAC/C,cAAc,EACd,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,IAAI,CAAC,oBAAoB;YACvB,GAAG,wBAAY,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAC/E,IAAI,CAAC,aAAa;YAChB,GAAG,wBAAY,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;QAExE,IAAI,CAAC,MAAM,GAAG,IAAA,kBAAS,EAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAE9C,IAAA,sBAAM,EACJ,IAAI,CAAC,4BAA4B,IAAI,CAAC,EACtC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI;YACtD,kDAAkD,IAAI,CAAC,4BAA4B,EAAE,CACxF,CAAC;QAEF,IAAA,sBAAM,EACJ,IAAI,CAAC,yBAAyB,IAAI,CAAC,EACnC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI;YACtD,wDAAwD,IAAI,CAAC,yBAAyB,EAAE,CAC3F,CAAC;QAEF,+DAA+D;QAC/D,IAAA,sBAAM,EACJ,IAAI,CAAC,yBAAyB,IAAI,IAAI,CAAC,4BAA4B,EACnE,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI;YACtD,yEAAyE;YACzE,YAAY,IAAI,CAAC,yBAAyB,MAAM,IAAI,CAAC,4BAA4B,EAAE,CACtF,CAAC;QAEF,IAAI,CAAC,wBAAwB,GAAG;YAC9B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO;YACpD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO;iBAC3C,cAAc,EAAE;iBAChB,SAAS,EAAE;YACd,cAAc,EAAE,gCAAqB;SACtC,CAAC;QAEF,IAAI,CAAC,qBAAqB,GAAG,+CAAqB,CAAC,wBAAwB,CAGzE,IAAI,CAAC,UAAU,EACf,iBAAiB,CAAC,yBAAyB,EAC3C,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,2DAA2D;QAC3D,2FAA2F;QAC3F,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;IAC5C,CAAC;IAED,IAAc,QAAQ;QACpB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;IACxC,CAAC;IAES,gBAAgB,CACxB,mBAA2B,EAC3B,qBAA6B,EAC7B,0BAAkC;QAElC,OAAO,CACL,mBAAmB,GAAG,qBAAqB,GAAG,0BAA0B,CACzE,CAAC;IACJ,CAAC;IAES,sBAAsB,CAC9B,mBAA2B,EAC3B,qBAA6B;QAE7B,OAAO,IAAI,CAAC,gBAAgB,CAC1B,mBAAmB,EACnB,qBAAqB,EACrB,IAAI,CAAC,4BAA4B,CAClC,CAAC;IACJ,CAAC;IAED,qBAAqB,CAAC,WAAmB;QACvC,OAAO,IAAI,CAAC,gBAAgB,CAC1B,WAAW,EACX,IAAI,CAAC,oBAAoB,EAAE,WAAW,IAAI,CAAC,EAC3C,IAAI,CAAC,yBAAyB,CAC/B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,wBAAwB,CACtC,SAAyD,EACzD,WAA8B,EAC9B,MAAoB;QAEpB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;QAEhC,IAAI,KAAK,EAAE;YACT,IACE,WAAW,KAAK,QAAQ;gBACxB,CAAC,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC5D;gBACA,OAAO,KAAK,CAAC;aACd;iBAAM;gBACL,IAAI,CAAC,oBAAoB,CACvB,cAAc,MAAM,kCAClB,KAAK,CAAC,WACR,uBAAuB,WAAW,UAChC,WAAW,GAAG,KAAK,CAAC,WACtB,SAAS,EACT,OAAO,CACR,CAAC;aACH;SACF;aAAM;YACL,IAAI,MAAM,KAAK,oBAAY,CAAC,YAAY,EAAE;gBACxC,IAAI,CAAC,oBAAoB,CACvB,oCAAoC,EACpC,OAAO,CACR,CAAC;aACH;iBAAM;gBACL,IAAI,CAAC,oBAAoB,CACvB,cAAc,MAAM,mBAAmB,EACvC,OAAO,CACR,CAAC;aACH;SACF;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,cAAiC,QAAQ,EACzC,oBAA6B,KAAK;IAClC,+EAA+E;IAC/E,eAAwB,IAAI;QAE5B,iFAAiF;QACjF,IAAI,CAAC,iBAAiB,EAAE;YACtB,iDAAiD;YACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,wBAAwB,CACpD,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,oBAAoB,IAAI,IAAI,EAC7C,WAAW,EACX,oBAAY,CAAC,YAAY,CAC1B,CAAC;YACF,IAAI,UAAU,KAAK,IAAI,EAAE;gBACvB,OAAO,UAAU,CAAC;aACnB;SACF;QAED,iEAAiE;QACjE,IAAI;YACF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,wBAAwB,CACpD,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC,IAAI,IAAI,EACtD,WAAW,EACX,oBAAY,CAAC,KAAK,CACnB,CAAC;YACF,IAAI,UAAU,KAAK,IAAI,EAAE;gBACvB,IAAI,YAAY,EAAE;oBAChB,kEAAkE;oBAClE,uFAAuF;oBACvF,MAAM,IAAI,CAAC,QAAQ,CACjB,UAAU,CAAC,KAAK,EAChB,UAAU,CAAC,WAAW,EACtB,UAAU,CAAC,eAAe,CAC3B,CAAC;iBACH;gBACD,OAAO,UAAU,CAAC;aACnB;SACF;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,0BAA0B,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;SACvE;QAED,IAAI,CAAC,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;QAEnD,uEAAuE;QACvE,IAAI;YACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAClD,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC,IAAI,IAAI,EAC1D,WAAW,EACX,oBAAY,CAAC,GAAG,CACjB,CAAC;YACF,IAAI,QAAQ,KAAK,IAAI,EAAE;gBACrB,IAAI,YAAY,EAAE;oBAChB,kEAAkE;oBAClE,uFAAuF;oBACvF,MAAM,IAAI,CAAC,QAAQ,CACjB,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,eAAe,CACzB,CAAC;oBACF,OAAO,QAAQ,CAAC;iBACjB;aACF;SACF;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,0BAA0B,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;SACrE;QAED,wEAAwE;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAES,0BAA0B,CAClC,MAA8C,EAC9C,GAAG,IAAe;QAElB,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7E,CAAC;IAES,oBAAoB,CAC5B,OAAe,EACf,KAAgB,EAChB,GAAG,IAAe;QAElB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,0BAA0B;QAC5B,OAAO,IAAI,CAAC,2BAA2B,CAAC;IAC1C,CAAC;IAED,IAAI,0BAA0B,CAAC,KAAc;QAC3C,4EAA4E;QAC5E,KAAK;YACH,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC;YACnE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEvE,IAAI,CAAC,2BAA2B,GAAG,KAAK,CAAC;IAC3C,CAAC;IAED,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,0BAA0B,CAAC;IACzC,CAAC;IAED,IAAI,yBAAyB,CAAC,KAAc;QAC1C,IAAI,CAAC,0BAA0B,GAAG,KAAK,CAAC;IAC1C,CAAC;IAOD,oCAAoC;QAIlC,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,EAAE;YAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;YACxD,IAAI,CAAC,oBAAoB,GAAG;gBAC1B,IAAI,CAAC,wBAAwB;gBAC7B,GAAG,eAAe;aACnB,CAAC;SACH;QAED,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAID,uCAAuC,CACrC,YAAwD,EACxD,eAAuB;QAEvB,mEAAmE;QACnE,MAAM,CAAC,WAAW,EAAE,GAAG,kBAAkB,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrE,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE;gBACd,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,UAAU,uCAAuC,CAAC,EAAE,CAC7D,CAAC;aACH;YAED,OAAO,CAAC,CAAC,UAAU,CAAC;QACtB,CAAC,CAAqB,CAAC;QAEvB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,2BAA2B,CAAC,kBAAkB,CAAC;YAC3D,WAAW;YACX,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,oCAAoC,EAAE,CAAC;QAC/D,IAAI;YACF,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,MAAM,iBAAiB,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAEvE,IAAI,EAAE,UAA2C,CAAC,CAGnD,CAAC;YAEF,OAAO,IAAI,CAAC,uCAAuC,CACjD,iBAAiB,EACjB,eAAe,CAChB,CAAC;SACH;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,0BAA0B,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;SACrE;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAY,EACZ,WAAmB,EACnB,eAAuB;QAEvB,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,EAAE;YAC3C,IAAI,CAAC,oBAAoB,GAAG;gBAC1B,KAAK,EAAE,KAAK;gBACZ,WAAW;gBACX,eAAe;aAChB,CAAC;SACH;aAAM;YACL,IAAI,CAAC,oBAAoB,CAAC,KAAK,GAAG,KAAK,CAAC;YACxC,IAAI,CAAC,oBAAoB,CAAC,WAAW,GAAG,WAAW,CAAC;YACpD,IAAI,CAAC,oBAAoB,CAAC,eAAe,GAAG,eAAe,CAAC;SAC7D;QAED,4CAA4C;QAC5C,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;SAChC;IACH,CAAC;IAES,KAAK,CAAC,iBAAiB;QAC/B,IAAI;YACF,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAC7B,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,aAAa,EAClB,aAAK,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAC3C,CAAC;YACF,OAAO,IAAI,CAAC;SACb;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,0BAA0B,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;SACnE;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAES,KAAK,CAAC,qBAAqB;QACnC,IAAI;YACF,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAC9B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gCAAgC,EAAE,EACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,CACnD,CAAC;YACF,OAAO,IAAI,CAAC;SACb;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,0BAA0B,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;SACvE;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CACpD,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,IAAI,cAAc,KAAK,IAAI,EAAE;YAC3B,OAAO,aAAK,CAAC,KAAK,CAAC,cAAc,CAA6B,CAAC;SAChE;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,wBAAwB;QACtC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CACnD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,IAAI,cAAc,KAAK,IAAI,EAAE;YAC3B,OAAO,aAAK,CAAC,KAAK,CAAC,cAAc,CAA8B,CAAC;SACjE;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,iBAAyB,EACzB,eAAuB,EACvB,WAAoB;QAEpB,IAAI,CAAC,6BAA6B,CAAC,KAAK,GAAG,iBAAiB,CAAC;QAC7D,IAAI,CAAC,6BAA6B,CAAC,eAAe,GAAG,eAAe,CAAC;QACrE,IAAI,CAAC,6BAA6B,CAAC,WAAW,GAAG,WAAW,IAAI,CAAC,CAAC;QAElE,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEjC,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;SACpC;IACH,CAAC;IAES,yBAAyB;QACjC,IAAI,IAAI,CAAC,kBAAkB,EAAE;YAC3B,IACE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAAC,eAAe;gBAC/D,IAAI,CAAC,6BAA6B,EAClC;gBACA,IAAI,CAAC,0BAA0B,CAC7B,4BAA4B,EAC5B,mBAAmB,IAAI,CAAC,6BAA6B,CAAC,eAAe,EAAE,CACxE,CAAC;gBACF,IAAI,CAAC,0BAA0B,GAAG,IAAI,CAAC;aACxC;iBAAM;gBACL,IAAI,CAAC,0BAA0B;oBAC7B,IAAI,CAAC,6BAA6B,CAAC,KAAK;wBACxC,IAAI,CAAC,2BAA2B,CAAC;aACpC;SACF;IACH,CAAC;IAES,gCAAgC;QACxC,uCAAuC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI;YACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAEnD,IAAI,KAAK,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wBAAwB,IAAI,CAAC,aAAa,SAAS,IAAI,CAAC,MAAM,4BAA4B,2BAA2B,KAAK,CAC3H,CAAC;aACH;iBAAM;gBACL,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;gBACrE,OAAO;aACR;SACF;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wBAAwB,IAAI,CAAC,aAAa,SAAS,IAAI,CAAC,MAAM,kDAAkD,2BAA2B,KAAK,EAChJ,CAAC,CACF,CAAC;SACH;QAED,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACxE,CAAC;;AAnjBH,8CAojBC;AAjjBQ,2CAAyB,GAG5B;IACF,+BAA+B,EAAE;QAC/B,GAAG,EAAE,iCAAiC;QACtC,OAAO,EAAE,yBAAyB,CAAC,+BAA+B;QAClE,QAAQ,EAAE,OAAO;KAClB;IACD,6BAA6B,EAAE;QAC7B,GAAG,EAAE,+BAA+B;QACpC,OAAO,EAAE,yBAAyB,CAAC,6BAA6B;QAChE,QAAQ,EAAE,OAAO;KAClB;IACD,+BAA+B,EAAE;QAC/B,GAAG,EAAE,iCAAiC;QACtC,OAAO,EAAE,yBAAyB,CAAC,+BAA+B;QAClE,QAAQ,EAAE,OAAO;KAClB;IACD,2BAA2B,EAAE;QAC3B,GAAG,EAAE,6BAA6B;QAClC,OAAO,EAAE,yBAAyB,CAAC,2BAA2B;QAC9D,QAAQ,EAAE,OAAO;KAClB;IACD,0BAA0B,EAAE;QAC1B,GAAG,EAAE,4BAA4B;QACjC,OAAO,EAAE,yBAAyB,CAAC,0BAA0B;QAC7D,QAAQ,EAAE,OAAO;KAClB;IACD,eAAe,EAAE;QACf,GAAG,EAAE,iBAAiB;QACtB,OAAO,EAAE,yBAAyB,CAAC,eAAe;QAClD,QAAQ,EAAE,MAAM;KACjB;CACF,CAAC"}