bennie-elvambuena / etherscan-api-1

A node.js wrapper for the etherscan api to fetch data and metadata from the ethereum blockchain

Etherscan API

Development of a NEXTGEN Version has started - please stand by

A way to access the etherscan.io api using promises. Fetch a diverse set of information about the blockchain.

Mainnet

var api = require('etherscan-api').init('YourApiKey');
var balance = api.account.balance('0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae');
balance.then(function(balanceData){
  console.log(balanceData);
});

Example in the wild

• Polymer3 based example

use a own instance of axios

const axios = require('axios');
const {
  init,
  pickChainUrl
} = require('..');


const chain = pickChainUrl(null);
const client = axios.create({
  baseURL: chain,
  timeout: 10000
});

var api = init('apikey', null, 10000, client);

For testnet and L2s usage

Supported:

• morden
• ropsten
• rinkeby
• arbitrum
• arbitrum_rinkeby

Latest

// apikey, network, timeout
var api = require('etherscan-api').init('YourApiKey','rinkeby'. '3000');

Install

npm install etherscan-api --save

API Documentation

Full Api Docs

Development workflow

• npm test - runs tests
  • npm run posttest - starts the linter
• npm run lint - preconfigured linter
• npm run docs - generates the apidocs
• npm run bundle - builds a new bundle
• npm run preversion - Steps before we create a new Tag
  • lint
  • changelog
• npm run pages - pushes generated apidocs to the server
• postversion - after generating a new version, push the tag to the server
• npm run changelog - generates a changelog and pushes it