dequanto 0.1.24 → 0.1.26

package/lib/esm/explorer/BlockchainExplorer.mjs

@@ -0,0 +1,481 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import alot from 'alot';
+import memd from 'memd';
+import { $logger } from '../utils/$logger.mjs';
+import { $promise } from '../utils/$promise.mjs';
+import { $address } from '../utils/$address.mjs';
+import { $require } from '../utils/$require.mjs';
+import { Web3ClientFactory } from '../clients/Web3ClientFactory.mjs';
+import { $config } from '../utils/$config.mjs';
+import { $str } from '../solidity/utils/$str.mjs';
+import { $platform } from '../utils/$platform.mjs';
+import { $is } from '../utils/$is.mjs';
+import { $http } from '../utils/$http.mjs';
+import { FsHtmlVerifier } from './verifiers/FsHtmlVerifier.mjs';
+export class BlockchainExplorer {
+    constructor(mix) {
+        this.client = new HttpClient();
+        let opts = typeof mix === 'string'
+            ? { platform: mix }
+            : mix;
+        this.opts = ensureDefaults(opts);
+        this.config = opts.getConfig(this.platform);
+        this.inMemoryDb = this.opts.CONTRACTS ?? [];
+        this.platform = this.opts.platform;
+        if ($str.isNullOrWhiteSpace(opts.ABI_CACHE) === false) {
+            this.getContractAbi = memd.fn.memoize(this.getContractAbi, {
+                trackRef: true,
+                persistence: new memd.FsTransport({
+                    path: opts.ABI_CACHE
+                })
+            });
+            this.getContractSource = memd.fn.memoize(this.getContractSource, {
+                trackRef: true,
+                persistence: new memd.FsTransport({
+                    path: opts.ABI_CACHE.replace('.json', '-source.json')
+                })
+            });
+        }
+        this.fsVerification = new FsHtmlVerifier(this.platform, this.config);
+    }
+    async getContractMeta(q) {
+        q = q.toLowerCase();
+        let info = this.inMemoryDb.find(x => $address.eq(x.address, q) || x.name?.toLowerCase() === q);
+        return info;
+    }
+    async getContractCreation(address) {
+        let apiUrl = this.config.api ?? `${this.config.host}/api`;
+        let url = `${apiUrl}?module=contract&action=getcontractcreation&contractaddresses=${address}&apikey=${this.config.key}`;
+        let result = await this.client.get(url);
+        let json = Array.isArray(result) ? result[0] : result;
+        if (json == null) {
+            throw new Error(`EMPTY_RESPONSE: ContractCreation response is empty for ${address}`);
+        }
+        return {
+            creator: json.contractCreator,
+            txHash: json.txHash
+        };
+    }
+    async getContractAbi(address, params) {
+        if ($address.isValid(params?.implementation)) {
+            return this.getContractAbi(params.implementation);
+        }
+        let info = await this.getContractMeta(address);
+        if (info?.proxy) {
+            address = info.proxy;
+        }
+        if (info?.abi) {
+            return { abi: info.abi, implementation: address };
+        }
+        let apiUrl = this.config.api ?? `${this.config.host}/api`;
+        let url = `${apiUrl}?module=contract&action=getabi&address=${address}&apikey=${this.config.key}`;
+        let abi;
+        try {
+            abi = await this.client.get(url);
+        }
+        catch (err) {
+            let addressByByteCode = await this.getSimilarContract(address);
+            if (addressByByteCode != null) {
+                $logger.log(`Found similar byte code address: ${addressByByteCode}`);
+                return this.getContractAbi(addressByByteCode);
+            }
+            throw err;
+        }
+        let abiJson = JSON.parse(abi);
+        if (params?.implementation) {
+            if ($is.HexBytes32(params.implementation)) {
+                let web3 = this.opts.getWeb3(this.platform);
+                let uin256Hex = await web3.getStorageAt(address, params.implementation);
+                let hex = $address.fromBytes32(uin256Hex);
+                return this.getContractAbi(hex);
+            }
+            throw new Error(`Implement ${params.implementation} support`);
+        }
+        if (isOpenZeppelinProxy(abiJson) || mightBeProxy(abiJson)) {
+            let web3 = this.opts.getWeb3(this.platform);
+            // (BigInt($contract.keccak256("eip1967.proxy.implementation")) - 1n).toString(16);
+            let uint256Hex = await web3.getStorageAt(address, `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`);
+            if ($address.isEmpty(uint256Hex)) {
+                // keccak-256 hash of "org.zeppelinos.proxy.implementation"
+                uint256Hex = await web3.getStorageAt(address, `0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3`);
+            }
+            if ($address.isEmpty(uint256Hex) === false) {
+                let hex = $address.fromBytes32(uint256Hex);
+                try {
+                    return await this.getContractAbi(hex);
+                }
+                catch (err) {
+                    err.message += `. Proxy ${hex}`;
+                    throw err;
+                }
+            }
+        }
+        if (hasImplementationSlot(abiJson)) {
+            let web3 = this.opts.getWeb3(this.platform);
+            let implAddress = await web3.readContract({
+                address: address,
+                abi: abiJson,
+                method: 'implementation',
+                params: []
+            });
+            return this.getContractAbi(implAddress);
+        }
+        if (hasTargetSlot(abiJson)) {
+            let web3 = this.opts.getWeb3(this.platform);
+            let implAddress = await web3.readContract({
+                address: address,
+                abi: abiJson,
+                method: 'getTarget',
+                params: []
+            });
+            return this.getContractAbi(implAddress);
+        }
+        return { abi, implementation: address };
+    }
+    async submitContractVerification(contractData) {
+        await this.fsVerification.submitContractVerification(contractData);
+        let url = this.config.api ?? `${this.config.host}/api`;
+        let body = {
+            apikey: this.config.key,
+            module: 'contract',
+            action: 'verifysourcecode',
+            contractaddress: contractData.address,
+            sourceCode: contractData.sourceCode,
+            codeformat: 'solidity-standard-json-input',
+            contractname: contractData.contractName,
+            compilerversion: contractData.compilerVersion,
+            optimizationUsed: contractData.optimizer == null || contractData.optimizer.enabled === false ? 0 : 1,
+            runs: contractData.optimizer?.runs,
+            constructorArguements: contractData.arguments?.replace('0x', '')
+        };
+        let guid = await this.client.post(url, {
+            body
+        });
+        return guid;
+    }
+    async checkContractVerificationSubmission(submission) {
+        let url = this.config.api ?? `${this.config.host}/api`;
+        let result = await this.client.get(url, {
+            apikey: this.config.key,
+            module: "contract",
+            action: "checkverifystatus",
+            guid: submission.guid
+        });
+        return result;
+    }
+    async submitContractProxyVerification(contractData) {
+        await this.fsVerification.submitContractProxyVerification(contractData);
+        let url = this.config.api ?? `${this.config.host}/api`;
+        let guid = await this.client.post(url, {
+            body: {
+                apikey: this.config.key,
+                module: "contract",
+                action: "verifyproxycontract",
+                address: contractData.address,
+                expectedimplementation: contractData.expectedImplementation ?? void 0
+            }
+        });
+        return guid;
+    }
+    async checkContractProxyVerificationSubmission(submission) {
+        let url = this.config.api ?? `${this.config.host}/api`;
+        let result = await this.client.get(url, {
+            apikey: this.config.key,
+            module: "contract",
+            action: "checkproxyverification",
+            guid: submission.guid
+        });
+        return result;
+    }
+    async getContractSource(address) {
+        let apiUrl = this.config.api ?? `${this.config.host}/api`;
+        let url = `${apiUrl}?module=contract&action=getsourcecode&address=${address}&apikey=${this.config.key}`;
+        let result = await this.client.get(url);
+        let json = Array.isArray(result) ? result[0] : result;
+        function parseSourceCode(contractName, code, filename, additionalSources) {
+            if (typeof code !== 'string') {
+                return code;
+            }
+            if (/^\s*\{/.test(code) === false) {
+                filename ??= `${contractName}.sol`;
+                let additionalSourcesDict = alot(additionalSources ?? []).toDictionary(x => x.Filename, x => ({ content: x.SourceCode }));
+                // single source code (not a serialized JSON)
+                return {
+                    contractName: contractName,
+                    files: {
+                        [filename]: {
+                            content: code
+                        },
+                        ...additionalSourcesDict
+                    }
+                };
+            }
+            try {
+                let sources = parseJson(code);
+                let files = sources.sources ?? sources;
+                return {
+                    contractName: contractName,
+                    files
+                };
+            }
+            catch (error) {
+                throw new Error(`Source code (${url}) can't be parsed: ${error.message}`);
+            }
+        }
+        function parseJson(str) {
+            try {
+                return JSON.parse(str);
+            }
+            catch (error) {
+                // etherscan returns code wrapped into {{}}
+            }
+            str = str
+                .replace(/^\s*\{\{/g, '{')
+                .replace(/\}\}\s*$/g, '}');
+            // @TODO check etherscan serialized jsons. Does it always has "{{...}}" wrappings
+            return JSON.parse(str);
+        }
+        return {
+            ...json,
+            SourceCode: parseSourceCode(json.ContractName, json.SourceCode, json.FileName, json.AdditionalSources)
+        };
+    }
+    async getTransactions(addr, params) {
+        return this.loadTxs('txlist', addr, params);
+    }
+    async getTransactionsAll(addr, params) {
+        return this.loadTxsAll('txlist', addr, params);
+    }
+    async getInternalTransactions(addr, params) {
+        return this.loadTxs('txlistinternal', addr, params);
+    }
+    async getInternalTransactionsAll(addr) {
+        return this.loadTxsAll('txlistinternal', addr);
+    }
+    async getErc20Transfers(addr, fromBlockNumber) {
+        let events = await this.loadTxs('tokentx', addr, { fromBlockNumber });
+        events.forEach(transfer => {
+            transfer.timeStamp = new Date((Number(transfer.timeStamp) * 1000));
+            transfer.value = BigInt(transfer.value);
+            transfer.blockNumber = Number(transfer.blockNumber);
+            transfer.tokenDecimal = Number(transfer.tokenDecimal);
+        });
+        return events;
+    }
+    async getErc20TransfersAll(addr, fromBlockNumber) {
+        let events = await this.loadTxsAll('tokentx', addr);
+        events.forEach(transfer => {
+            transfer.timeStamp = new Date((Number(transfer.timeStamp) * 1000));
+            transfer.value = BigInt(transfer.value);
+            transfer.blockNumber = Number(transfer.blockNumber);
+            transfer.tokenDecimal = Number(transfer.tokenDecimal);
+        });
+        return events;
+    }
+    async getSimilarContract(address) {
+        let url = `${this.config.www}/address/${address}#code`;
+        let html = await this.client.getHtml(url);
+        let rgx = /This contract matches/ig;
+        let match = rgx.exec(html);
+        if (match == null) {
+            return null;
+        }
+        let rgxAddress = /0x[a-f\d]{40}/g;
+        rgxAddress.lastIndex = match.index;
+        let matchAddress = rgxAddress.exec(html);
+        if (matchAddress == null) {
+            return null;
+        }
+        return matchAddress[0];
+    }
+    async loadTxs(type, address, params) {
+        let apiUrl = this.config.api ?? `${this.config.host}/api`;
+        let url = `${apiUrl}?module=account&action=${type}&address=${address}&sort=${params.sort ?? 'desc'}&apikey=${this.config.key}`;
+        if (params.fromBlockNumber != null) {
+            url += `&startblock=${params.fromBlockNumber}`;
+        }
+        if (params.page != null) {
+            url += `&page=${params.page}`;
+        }
+        if (params.size != null) {
+            url += `&offset=${params.size}`;
+        }
+        let txs = await this.client.get(url);
+        return txs;
+    }
+    async loadTxsAll(type, address, params) {
+        let page = 1;
+        let size = 1000;
+        let out = [];
+        let fromBlockNumber = params?.fromBlockNumber;
+        while (true) {
+            let arr = await this.loadTxs(type, address, { fromBlockNumber, sort: 'asc' });
+            out.push(...arr);
+            $logger.log(`Got transactions(${type}) for ${address}. Page: ${arr.length}; Received: ${out.length}. Latest Block: ${fromBlockNumber}`);
+            if (arr.length < size) {
+                break;
+            }
+            page++;
+            fromBlockNumber = Number(arr[arr.length - 1].blockNumber);
+        }
+        return alot(out).distinctBy(x => x.hash).toArray();
+    }
+    async registerAbi(abis) {
+        abis.forEach(x => {
+            let fromDb = this.inMemoryDb.find(current => $address.eq(current.address, x.address));
+            if (fromDb != null) {
+                fromDb.abi = x.abi;
+                return;
+            }
+            this.inMemoryDb.push(x);
+        });
+    }
+}
+function isOpenZeppelinProxy(abi) {
+    let $interface = ['upgradeTo', 'implementation'];
+    return $interface.every(name => {
+        return hasMethod(abi, name);
+    });
+}
+function mightBeProxy(abi) {
+    let methods = abi.filter(x => x.type === 'function');
+    if (methods.length === 0) {
+        return true;
+    }
+    return false;
+}
+function hasImplementationSlot(abi) {
+    let $required = ['implementation'];
+    let hasRequired = $required.every(name => {
+        return hasMethod(abi, name);
+    });
+    if (hasRequired === false) {
+        return false;
+    }
+    let $some = ['proxyOwner', 'proxyType'];
+    let hasOneOf = $some.some(name => {
+        return hasMethod(abi, name);
+    });
+    if (hasOneOf === false) {
+        return false;
+    }
+    return true;
+}
+function hasTargetSlot(abi) {
+    let $interface = ['upgrade', 'getTarget'];
+    return $interface.every(name => {
+        return hasMethod(abi, name);
+    });
+}
+function hasMethod(abi, name) {
+    return abi.some(item => item.type === 'function' && item.name === name);
+}
+function ensureDefaults(opts) {
+    opts ??= {};
+    let platform = opts.platform;
+    $require.notNull(platform, `Generic Blockchain Explorer Config should contain platform name`);
+    opts.ABI_CACHE ??= `./cache/${$platform.toPath(platform)}/abis.json`;
+    opts.CONTRACTS ??= [];
+    opts.getWeb3 ??= (_) => {
+        return Web3ClientFactory.get(platform);
+    };
+    opts.getConfig ??= () => {
+        let config = $config.get(`blockchainExplorer.${platform}`);
+        return {
+            ...(config ?? {}),
+            ...opts,
+        };
+    };
+    return opts;
+}
+class HttpClient {
+    async get(url, params) {
+        return this.getInner(url, {
+            params
+        });
+    }
+    async post(url, opts) {
+        return this.postInner(url, opts);
+    }
+    async getHtml(url) {
+        let resp = await $http.get(url);
+        if (resp.status !== 200) {
+            throw new Error(`${url} not loaded with status ${resp.status}.`);
+        }
+        return resp.data;
+    }
+    async getPaged(url) {
+        let arr = [];
+        let page = 1;
+        let size = 200;
+        while (true) {
+            let path = `${url}&page=${page}&offset=${size}`;
+            let pageArr = await this.get(path);
+            arr = arr.concat(pageArr);
+            if (pageArr.length < size) {
+                break;
+            }
+            page++;
+        }
+        return arr;
+    }
+    async getInner(url, opts) {
+        let resp = await $http.get({
+            url,
+            params: opts.params
+        });
+        let data = resp.data;
+        if (data.message === 'NOTOK') {
+            let str = data.result;
+            if (/Max rate/i.test(str)) {
+                let count = opts?.retryCount ?? 3;
+                if (--count === 0) {
+                    throw new Error(str);
+                }
+                await $promise.wait(200);
+                return this.getInner(url, {
+                    ...(opts ?? {}),
+                    retryCount: count
+                });
+            }
+            throw new Error(str);
+        }
+        if (data.result == null) {
+            $logger.warn(`Blockchain "${url}" explorer returned empty result`, data);
+        }
+        return data.result;
+    }
+    async postInner(url, opts) {
+        let resp = await $http.post({
+            url,
+            method: 'post',
+            //params: opts.params,
+            body: opts.body,
+            headers: {
+                "content-type": "application/x-www-form-urlencoded"
+            }
+        });
+        let data = resp.data;
+        if (data.message === 'NOTOK') {
+            let str = data.result;
+            throw new Error(str);
+        }
+        if (data.result == null) {
+            $logger.warn(`Blockchain "${url}" explorer returned empty result`, data);
+        }
+        return data.result;
+    }
+}
+__decorate([
+    memd.deco.queued({ throttle: 1000 / 5 })
+], HttpClient.prototype, "get", null);
+__decorate([
+    memd.deco.queued({ throttle: 1000 / 5 })
+], HttpClient.prototype, "getHtml", null);
+//# sourceMappingURL=BlockchainExplorer.js.map
+//# sourceMappingURL=BlockchainExplorer.ts.map

package/lib/esm/explorer/BlockchainExplorerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockchainExplorerFactory.js","sourceRoot":"","sources":["../../../src/explorer/BlockchainExplorerFactory.ts"],"names":[],"mappings":";;;AAEA,6DAAuH;AAEvH,qDAAkD;AAClD,oDAAiD;AAIjD;;GAEG;AACH,IAAiB,yBAAyB,CA0CzC;AA1CD,WAAiB,yBAAyB;IAEtC,MAAM,QAAQ,GAAG,EAA+E,CAAC;IAEjG,SAAgB,QAAQ,CAAE,QAAmB,EAAE,QAAgE;QAC3G,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAClC,CAAC;IAFe,kCAAQ,WAEvB,CAAA;IAED,SAAgB,GAAG,CAAE,QAA4B,EAAE,IAAuC;QAEtF,IAAI,GAAG,GAAG,iBAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,GAAG;YACT,QAAQ;YACR,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,GAAG,IAAG,EAAE,CAAC;SAChB,CAAC;QACF,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,IAAI,IAAI,IAAI,EAAE;YACd,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE;gBAC5B,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;aAC3B;YACD,OAAO,IAAI,CAAC;SACf;QAED,OAAO,IAAI,uCAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAjBe,6BAAG,MAiBlB,CAAA;IAED,sEAAsE;IAC/D,KAAK,UAAU,QAAQ,CAAE,QAA4B,EAAE,IAAuC;QACjG,MAAM,eAAM,CAAC,GAAG,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAHqB,kCAAQ,WAG7B,CAAA;IAED,sEAAsE;IACtE,SAAgB,MAAM,CAAE,IAAsC;QAE1D,OAAO,KAAM,SAAQ,uCAAkB;YACnC,YAAa,MAAyC;gBAClD,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;YAC1B,CAAC;SACJ,CAAA;IACL,CAAC;IAPe,gCAAM,SAOrB,CAAA;AACL,CAAC,EA1CgB,yBAAyB,GAAzB,iCAAyB,KAAzB,iCAAyB,QA0CzC"}

package/lib/esm/explorer/BlockchainExplorerFactory.mjs

@@ -0,0 +1,48 @@
+import { BlockchainExplorer } from './BlockchainExplorer.mjs';
+import { $config } from '../utils/$config.mjs';
+import { Config } from '../config/Config.mjs';
+/**
+ * @obsolete Use BlockchainExplorer class instead.
+ */
+export var BlockchainExplorerFactory;
+(function (BlockchainExplorerFactory) {
+    const registry = {};
+    function register(platform, explorer) {
+        registry[platform] = explorer;
+    }
+    BlockchainExplorerFactory.register = register;
+    function get(platform, opts) {
+        let cfg = $config.get(`blockchainExplorer.${platform}`);
+        let params = {
+            platform,
+            ...(opts ?? {}),
+            ...(cfg ?? {})
+        };
+        let Ctor = registry[platform];
+        if (Ctor != null) {
+            if (typeof Ctor === 'function') {
+                return new Ctor(params);
+            }
+            return Ctor;
+        }
+        return new BlockchainExplorer(params);
+    }
+    BlockchainExplorerFactory.get = get;
+    /** Same as sync variation, but ensures the config is being fetched */
+    async function getAsync(platform, opts) {
+        await Config.get();
+        return get(platform, opts);
+    }
+    BlockchainExplorerFactory.getAsync = getAsync;
+    /** @obsolete Create instance directly with the get/getAsync method */
+    function create(opts) {
+        return class extends BlockchainExplorer {
+            constructor(config) {
+                super(config ?? opts);
+            }
+        };
+    }
+    BlockchainExplorerFactory.create = create;
+})(BlockchainExplorerFactory || (BlockchainExplorerFactory = {}));
+//# sourceMappingURL=BlockchainExplorerFactory.js.map
+//# sourceMappingURL=BlockchainExplorerFactory.ts.map

package/lib/esm/explorer/BlockchainExplorerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockchainExplorerProvider.js","sourceRoot":"","sources":["../../../src/explorer/BlockchainExplorerProvider.ts"],"names":[],"mappings":";;;AACA,qDAAkD;AAGlD,6DAA4F;AAE5F,sDAAsD;AACtD,IAAiB,0BAA0B,CAiC1C;AAjCD,WAAiB,0BAA0B;IAEvC,MAAM,QAAQ,GAAG,EAA+E,CAAC;IAEjG,SAAgB,GAAG,CAAE,QAAmB;QACpC,QAAQ,QAAQ,EAAE;YACd,KAAK,SAAS;gBACV,OAAO,IAAI,uCAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChD;gBACI,IAAI,GAAG,GAAG,iBAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;gBAExD,IAAI,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC7B,IAAI,GAAG,IAAI,IAAI,EAAE;oBACb,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;wBAC3B,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;qBACvB;oBACD,OAAO,GAAG,CAAC;iBACd;gBACD,IAAI,GAAG,IAAI,IAAI,EAAE;oBACb,OAAO,IAAI,uCAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;iBAC/C;gBACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,2BAA2B,CAAC,CAAC;SACpF;IACL,CAAC;IAnBe,8BAAG,MAmBlB,CAAA;IAED,SAAgB,QAAQ,CAAE,QAAmB,EAAE,QAAgE;QAC3G,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAClC,CAAC;IAFe,mCAAQ,WAEvB,CAAA;IAED,qDAAqD;IACrD,SAAgB,MAAM,CAAC,OAAyC;QAC5D,OAAO,IAAI,uCAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAFe,iCAAM,SAErB,CAAA;AACL,CAAC,EAjCgB,0BAA0B,GAA1B,kCAA0B,KAA1B,kCAA0B,QAiC1C"}

package/lib/esm/explorer/BlockchainExplorerProvider.mjs

@@ -0,0 +1,38 @@
+import { $config } from '../utils/$config.mjs';
+import { BlockchainExplorer } from './BlockchainExplorer.mjs';
+/** @obsolete Use BlockchainExplorerFactory instead */
+export var BlockchainExplorerProvider;
+(function (BlockchainExplorerProvider) {
+    const registry = {};
+    function get(platform) {
+        switch (platform) {
+            case 'hardhat':
+                return new BlockchainExplorer({ platform });
+            default:
+                let cfg = $config.get(`blockchainExplorer.${platform}`);
+                let Mix = registry[platform];
+                if (Mix != null) {
+                    if (typeof Mix === 'function') {
+                        return new Mix(cfg);
+                    }
+                    return Mix;
+                }
+                if (cfg != null) {
+                    return new BlockchainExplorer({ platform });
+                }
+                throw new Error(`Unsupported platform ${platform} for block chain explorer`);
+        }
+    }
+    BlockchainExplorerProvider.get = get;
+    function register(platform, explorer) {
+        registry[platform] = explorer;
+    }
+    BlockchainExplorerProvider.register = register;
+    /** @obsolete Use BlockchainExplorer class instead */
+    function create(options) {
+        return new BlockchainExplorer(options);
+    }
+    BlockchainExplorerProvider.create = create;
+})(BlockchainExplorerProvider || (BlockchainExplorerProvider = {}));
+//# sourceMappingURL=BlockchainExplorerProvider.js.map
+//# sourceMappingURL=BlockchainExplorerProvider.ts.map

package/lib/esm/explorer/{BlockChainExplorerStorage.js.map → BlockchainExplorerStorage.js.map}

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

package/lib/esm/explorer/{BlockChainExplorerStorage.mjs → BlockchainExplorerStorage.mjs}

@@ -1,6 +1,6 @@
 import { $require } from '../utils/$require.mjs';
 import { $address } from '../utils/$address.mjs';
-export class BlockChainExplorerStorage {
+export class BlockchainExplorerStorage {
     constructor(options) {
         this.contracts = {};
         for (let address in options.contracts) {
@@ -29,12 +29,12 @@ export class BlockChainExplorerStorage {
     }
     registerAbi(abis) {
         abis.forEach(x => {
-            let fromDb = this.localDb.find(current => $address.eq(current.address, x.address));
+            let fromDb = this.inMemoryDb.find(current => $address.eq(current.address, x.address));
             if (fromDb != null) {
                 fromDb.abi = x.abi;
                 return;
             }
-            this.localDb.push(x);
+            this.inMemoryDb.push(x);
         });
     }
     getContractMeta(q) {
@@ -86,5 +86,5 @@ export class BlockChainExplorerStorage {
         throw new Error('Method not implemented.');
     }
 }
-//# sourceMappingURL=BlockChainExplorerStorage.js.map
-//# sourceMappingURL=BlockChainExplorerStorage.ts.map
+//# sourceMappingURL=BlockchainExplorerStorage.js.map
+//# sourceMappingURL=BlockchainExplorerStorage.ts.map

package/lib/esm/explorer/Bscscan.js.map

@@ -1 +1 @@
-{"version":3,"file":"Bscscan.js","sourceRoot":"","sources":["../../../src/explorer/Bscscan.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAsB;AACtB,2EAAwE;AAExE,qDAAkD;AAClD,mEAAgE;AAEhE,MAAM,SAAS,GAAG,iBAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AACnD,MAAa,OAAQ,SAAQ,qDAAyB,CAAC,MAAM,CAAC;IAC1D,SAAS,EAAE,uBAAuB;IAClC,SAAS,EAAE,SAAS;IACpB,OAAO;QACH,OAAO,cAAE,CAAC,OAAO,CAAC,6BAAa,CAAC,CAAA;IACpC,CAAC;IACD,SAAS;QACL,MAAM,MAAM,GAAG,iBAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACrD,OAAO;YACH,GAAG,EAAE,MAAM,EAAE,GAAG;YAChB,IAAI,EAAE,MAAM,EAAE,IAAI;YAClB,GAAG,EAAE,MAAM,EAAE,GAAG;SACnB,CAAC;IACN,CAAC;CACJ,CAAC;CAED;AAhBD,0BAgBC"}
+{"version":3,"file":"Bscscan.js","sourceRoot":"","sources":["../../../src/explorer/Bscscan.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAsB;AAEtB,qDAAkD;AAClD,mEAAgE;AAChE,6DAA0D;AAE1D,MAAM,SAAS,GAAG,iBAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAEnD,MAAa,OAAQ,SAAQ,uCAAkB;IAE3C;QACI,KAAK,CAAC;YACF,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,uBAAuB;YAClC,SAAS,EAAE,SAAS;YACpB,OAAO;gBACH,OAAO,cAAE,CAAC,OAAO,CAAC,6BAAa,CAAC,CAAA;YACpC,CAAC;YACD,SAAS;gBACL,MAAM,MAAM,GAAG,iBAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACrD,OAAO;oBACH,GAAG,EAAE,MAAM,EAAE,GAAG;oBAChB,IAAI,EAAE,MAAM,EAAE,IAAI;oBAClB,GAAG,EAAE,MAAM,EAAE,GAAG;iBACnB,CAAC;YACN,CAAC;SACJ,CAAC,CAAA;IACN,CAAC;CACJ;AApBD,0BAoBC"}

package/lib/esm/explorer/Bscscan.mjs

@@ -1,23 +1,27 @@
 import di from 'a-di';
-import { BlockChainExplorerFactory } from './BlockChainExplorerFactory.mjs';
 import { $config } from '../utils/$config.mjs';
 import { BscWeb3Client } from '../clients/BscWeb3Client.mjs';
+import { BlockchainExplorer } from './BlockchainExplorer.mjs';
 const contracts = $config.get('contracts.bsc', []);
-export class Bscscan extends BlockChainExplorerFactory.create({
-    ABI_CACHE: `./cache/bsc/abis.json`,
-    CONTRACTS: contracts,
-    getWeb3() {
-        return di.resolve(BscWeb3Client);
-    },
-    getConfig() {
-        const config = $config.get('blockchainExplorer.bsc');
-        return {
-            key: config?.key,
-            host: config?.host,
-            www: config?.www,
-        };
+export class Bscscan extends BlockchainExplorer {
+    constructor() {
+        super({
+            platform: 'bsc',
+            ABI_CACHE: `./cache/bsc/abis.json`,
+            CONTRACTS: contracts,
+            getWeb3() {
+                return di.resolve(BscWeb3Client);
+            },
+            getConfig() {
+                const config = $config.get('blockchainExplorer.bsc');
+                return {
+                    key: config?.key,
+                    host: config?.host,
+                    www: config?.www,
+                };
+            }
+        });
     }
-}) {
 }
 //# sourceMappingURL=Bscscan.js.map
 //# sourceMappingURL=Bscscan.ts.map