Routescan client

Client for receiving blockchain data through block explorers (in particular, routescan).
At the moment, the number of available methods is limited to those indicated in the examples below:

Donation

To support this project, you can send crypto to 0x3F2f0098310e654040f7794AB7E44Ac48E0eaF7B.

Accounts section

import { BlockExplorerCommon, BlockExplorerTag, BlockExplorerTopicOperation, Chain, BlockExplorerSort } from 'routescan-client';

const ROUTESCAN_API_KEY = 'YourApiKey';
const WALLET = '0x285f5F8Cd290Cff6596337C4eEC14e1a62235854';

async function main() {
  const blockExplorer = BlockExplorerCommon.build({
    chain: Chain.AvalancheCChainFuji,
    apiKey: ROUTESCAN_API_KEY
  });

  // Get AVAX balance for a single address:
  const balance = await blockExplorer.getAccountBalance({
    address: WALLET,
    tag: BlockExplorerTag.Latest
  });
  console.log(`Balance of ${WALLET} is ${balance}`);

  // Get AVAX balance for multiple addresses in a single call:
  const WALLET_SECOND = '0xCD5B8Ea4a848b1c576125f20F9aDe5F58FDf4D4f';
  const balances = await blockExplorer.getAccountsBalances({
    address: [WALLET, WALLET_SECOND].join(','),
    tag: BlockExplorerTag.Latest
  });
  console.log(balances);

  // Get a list of 'Normal' Transactions By Address
  const normalTxs = await blockExplorer.getNormalTxListByAddress({
    address: WALLET
  });
  console.log(normalTxs);

  // Get a list of 'internal' transactions by address:
  const internalTxs = await blockExplorer.getInternalTxListByAddress({
    address: WALLET
  });
  console.log(internalTxs);

  // Get 'internal transactions' by transaction hash
  const internalTxsByHash = await blockExplorer.getInternalTxListByTxHash({
    txhash: '0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170'
  });
  console.log(internalTxsByHash);

  // Get a list of 'ERC20 - token transfer events' by address:
  const tokenEvents = await blockExplorer.getErc20TokenTransferEventsList({
    address: '0x77134cbC06cB00b66F4c7e623D5fdBF6777635EC',
    contractaddress: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7',
    page: 1,
    offset: 100,
    startblock: 34372864,
    endblock: 34472864,
    sort: BlockExplorerSort.Asc
  });
  console.log(tokenEvents);

  // Get ERC20-Token Account Balance for TokenContractAddress:
  const tokenBalance = await blockExplorer.getAccountTokenBalance({
    contractAddress: '0x57d90b64a1a57749b0f932f1a3395792e12e7055',
    address: WALLET,
    tag: BlockExplorerTag.Latest
  });
  console.log(`Balance of ${WALLET} is ${tokenBalance}`);
}

main();

Blocks section

import { BlockExplorerClosest, BlockExplorerCommon, Chain } from 'routescan-client';

const ROUTESCAN_API_KEY = 'YourApiKey';
const WALLET = '0x285f5F8Cd290Cff6596337C4eEC14e1a62235854';

async function main() {
  const blockExplorer = BlockExplorerCommon.build({
    chain: Chain.AvalancheCChainFuji,
    apiKey: ROUTESCAN_API_KEY
  });

  // Get estimated block countdown time by blockNo:
  const blockCountdown = await blockExplorer.getBlockCountdownTime({
    blockno: 167015880000
  });
  console.log('Block countdown', blockCountdown);

  // Get block number by timestamp:
  const timestamp = 1619638524;
  const blockNumberByTimestamp = await blockExplorer.getBlockNumberByTimestamp({
    timestamp,
    closest: BlockExplorerClosest.After
  });
  console.log(`Block number after ${timestamp} is ${blockNumberByTimestamp}`);
}

main();

Logs section

import { BlockExplorerCommon, BlockExplorerTopicOperation, Chain } from 'routescan-client';

const ROUTESCAN_API_KEY = 'YourApiKey';
const WALLET = '0x285f5F8Cd290Cff6596337C4eEC14e1a62235854';

async function main() {
  const blockExplorer = BlockExplorerCommon.build({
    chain: Chain.AvalancheCChainFuji,
    apiKey: ROUTESCAN_API_KEY
  });

  // Get event logs by address:
  const logs = await blockExplorer.getEventLogsByAddress({
    address: '0x9e66eba102b77fc75cd87b5e60141b85573bc8e8',
    fromBlock: 37000000,
    toBlock: 37200000,
    page: 1,
    offset: 1000
  });
  console.log(logs);

  // Get event logs by topics:
  const topicsLogs = await blockExplorer.getEventLogsByTopics({
    fromBlock: 37000000,
    toBlock: 37200000,
    topic0: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
    topic0_1_opr: BlockExplorerTopicOperation.And,
    topic1: '0x0000000000000000000000000000000000000000000000000000000000000000',
    page: 1,
    offset: 1000
  });
  console.log(topicsLogs.length);

  // Get Event Logs by Address filtered by Topics:
  const addressLogs = await blockExplorer.getEventLogsByAddressFiltered({
    address: '0x9e66eba102b77fc75cd87b5e60141b85573bc8e8',
    fromBlock: 37000000,
    toBlock: 37200000,
    topic0: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
    topic0_1_opr: BlockExplorerTopicOperation.And,
    topic1: '0x0000000000000000000000000000000000000000000000000000000000000000',
    page: 1,
    offset: 1000
  });
  console.log(addressLogs.length);
}

main();

Supported networks table

You must use the API key of the corresponding block explorer!!!
Just register an account on corresponding site and generate an API key.

PS: Client also support other etherscan-compatible block explorers, but in this case you must provide custom url parameter.

| ID | Name | Block explorer | Block explorer API url | | -------- | ------------------------ | ------------------------------- | ------------------------------------------------------------------- | | 1 | Ethereum | https://etherscan.io | https://api.etherscan.io/api | | 5 | EthereumGoerli | https://etherscan.io | https://api-goerli.etherscan.io/api | | 11155111 | EthereumSepolia | https://etherscan.io | https://api-sepolia.etherscan.io/api | | 10 | Optimism | https://optimistic.etherscan.io | https://api-optimistic.etherscan.io/api | | 420 | OptimismGoerli | https://optimistic.etherscan.io | https://api-goerli-optimistic.etherscan.io/api | | 11155420 | OptimismSepolia | https://optimistic.etherscan.io | https://api-sepolia-optimistic.etherscan.io/api | | 56 | BinanceSmartChain | https://bscscan.com | https://api.bscscan.com/api | | 97 | BinanceSmartChainTestnet | https://bscscan.com | https://api-testnet.bscscan.com/api | | 137 | Polygon | https://polygonscan.com | https://api.polygonscan.com/api | | 80002 | PolygonAmoy | https://polygonscan.com | https://api-amoy.polygonscan.com/api | | 204 | BinanceOpBnbMainnet | https://opbnb.bscscan.com | https://api-opbnb.bscscan.com/api | | 5611 | BinanceOpBnbTestnet | https://opbnb.bscscan.com | https://api-opbnb-testnet.bscscan.com/api | | 250 | Fantom | https://ftmscan.com | https://api.ftmscan.com/api | | 4002 | FantomTestnet | https://ftmscan.com | https://api-testnet.ftmscan.com/api | | 8453 | Base | https://basescan.org | https://api.basescan.org/api | | 84532 | BaseSepolia | https://basescan.org | https://api-sepolia.basescan.org/api | | 42161 | Arbitrum | https://arbiscan.io | https://api.arbiscan.io/api | | 42170 | ArbitrumNova | https://arbiscan.io | https://api-nova.arbiscan.io/api | | 421614 | ArbitrumSepolia | https://arbiscan.io | https://api-sepolia.arbiscan.io/api | | 43114 | AvalancheCChain | https://routescan.io | https://api.routescan.io/v2/network/mainnet/evm/43114/etherscan/api | | 43113 | AvalancheCChainFuji | https://routescan.io | https://api.routescan.io/v2/network/testnet/evm/43113/etherscan/api | | 42220 | Celo | https://celoscan.io | https://api.celoscan.io/api | | 44787 | CeloAlfajores | https://celoscan.io | https://api-alfajores.celoscan.io/api | | 59144 | Linea | https://lineascan.build | https://api.lineascan.build/api | | 59140 | LineaGoerli | https://lineascan.build | https://api-testnet.lineascan.build/api |