routescan-client v2.10.0
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.
6 days ago
13 days ago
13 days ago
13 days ago
12 days ago
15 days ago
15 days ago
15 days ago
15 days ago
15 days ago
15 days ago
19 days ago
20 days ago
21 days ago
28 days ago
28 days ago
1 month ago
1 month ago
1 month ago
1 month ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago