@hyperlane-xyz/widgets/dist/utils/explorers.js

Common react components for Hyperlane projects

import { fetchWithTimeout } from '@hyperlane-xyz/utils';
import { widgetLogger } from '../logger.js';
export async function getExplorerApiUrl(chainName, multiProvider) {
    const metadata = await multiProvider.getChainMetadata(chainName);
    const blockExplorers = metadata?.blockExplorers;
    if (!blockExplorers?.length)
        return null;
    return blockExplorers[0].apiUrl || blockExplorers[0].url;
}
export async function queryExplorer(chainName, multiProvider, path, apiKey, timeout) {
    const baseUrl = getExplorerApiUrl(chainName, multiProvider);
    if (!baseUrl)
        throw new Error(`No URL found for explorer for chain ${chainName}`);
    let url = `${baseUrl}/${path}`;
    widgetLogger.debug('Querying explorer url:', url);
    if (apiKey) {
        url += `&apikey=${apiKey}`;
    }
    const result = await executeExplorerQuery(url, timeout);
    return result;
}
export async function executeExplorerQuery(url, timeout) {
    const response = await fetchWithTimeout(url, undefined, timeout);
    if (!response.ok) {
        throw new Error(`Fetch response not okay: ${response.status}`);
    }
    const json = (await response.json());
    if (!json.result) {
        const responseText = await response.text();
        throw new Error(`Invalid result format: ${responseText}`);
    }
    return json.result;
}
export async function queryExplorerForBlock(chainName, multiProvider, blockNumber) {
    const path = `?module=proxy&action=eth_getBlockByNumber&tag=${blockNumber || 'latest'}&boolean=false`;
    const block = await queryExplorer(chainName, multiProvider, path);
    if (!block?.number || parseInt(block.number.toString()) < 0) {
        const msg = 'Invalid block result';
        widgetLogger.error(msg, JSON.stringify(block), path);
        throw new Error(msg);
    }
    return block;
}
//# sourceMappingURL=explorers.js.map