gobitfly / erc20-explorer

An explorer for ERC20 based Ethereum tokens

ERC20-Exporter

Lightweight explorer for ERC20 based Ethereum tokens

ERC20-Exporter is an explorer built with NodeJS, Express and Parity. It does not require an external database and retrieves all information on the fly from a backend Ethereum node.

A demo instance connected to the Golem Network Token is available at gnt.etherchain.org.

Current Features

• Browse transactions and accounts
• Named accounts
• Event log browser
• Supports Transfer and Approval events
• Live Backend Node status display
• Support for all Bootswatch skins
• Accounts enumeration
• Supports IPC and HTTP backend connections
• Responsive layout

Missing a feature? Please request it by creating a new Issue.

Getting started

Supported OS: Ubuntu 16.04

Supported Ethereum backend nodes: Parity, Geth (untested)

1. Setup a nodejs & npm environment
2. Install the latest version of the Parity Ethereum client
3. Start parity using the following options: parity --warp
4. Clone this repository to your local machine: git clone https://github.com/gobitfly/erc20-exporter
5. Install all dependencies: npm install
6. Rename config.js.example into config.js and adjust the file to your local environment & token
7. Start the explorer: npm start
8. Browse to http://localhost:3000

Please note that for large tokens the initial data export can take up to 30 minutes. Once completed it is recommended to change the exportStartBlock parameter in the config file to a block number that is around 30.000 blocks behind the current tip of the chain and restart the exporter.

erc20-explorer's Issues

tokens

I have found tokens that MetaMask had lost. They are listed on ertherscan with my address and password. How do I get them to my MEW

Added an ERC20 Token from Private Parity Network (Correct ABI, Contract Address, Etherchain Light Working)

Exporter initialized, waiting for historical events...
Historical events received
Exporting log: 73_0_0
73_0_0 already exported!
All historical logs processed
Exporting balance of undefined
/home/user1/erc20explorer/node_modules/web3/lib/web3/function.js:71
throw errors.InvalidNumberOfSolidityArgs();
^

Error: Invalid number of arguments to Solidity function
at Object.InvalidNumberOfSolidityArgs (/home/user1/erc20explorer/node_modules/web3/lib/web3/errors.js:25:16)
at SolidityFunction.validateArgs (/home/user1/erc20explorer/node_modules/web3/lib/web3/function.js:71:22)
at SolidityFunction.toPayload (/home/user1/erc20explorer/node_modules/web3/lib/web3/function.js:87:10)
at SolidityFunction.call (/home/user1/erc20explorer/node_modules/web3/lib/web3/function.js:128:24)
at SolidityFunction.execute (/home/user1/erc20explorer/node_modules/web3/lib/web3/function.js:257:22)
at exporter.self.exportBalance (/home/user1/erc20explorer/services/exporter.js:107:19)
at /home/user1/erc20explorer/services/exporter.js:67:12
at /home/user1/erc20explorer/node_modules/async/dist/async.js:3110:16
at replenish (/home/user1/erc20explorer/node_modules/async/dist/async.js:1011:17)
at /home/user1/erc20explorer/node_modules/async/dist/async.js:1016:9
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] start: node ./bin/www
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] start script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR! /home/user1/.npm/_logs/2018-08-09T12_52_41_579Z-debug.log

Full Log:
0 info it worked if it ends with ok
1 verbose cli [ '/usr/bin/node', '/usr/bin/npm', 'start' ]
2 info using [email protected]
3 info using [email protected]
4 verbose run-script [ 'prestart', 'start', 'poststart' ]
5 info lifecycle [email protected]prestart: [email protected]
6 info lifecycle [email protected]start: [email protected]
7 verbose lifecycle [email protected]start: unsafe-perm in lifecycle true
8 verbose lifecycle [email protected]start: PATH: /usr/lib/node_modules/npm/node_modules/npm-lifecycle/node-gyp-bin:/home/user1/erc20explorer/node_modules/.bin:/home/user1/bin:/home/user1/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin
9 verbose lifecycle [email protected]start: CWD: /home/user1/erc20explorer
10 silly lifecycle [email protected]start: Args: [ '-c', 'node ./bin/www' ]
11 silly lifecycle [email protected]start: Returned: code: 1 signal: null
12 info lifecycle [email protected]start: Failed to exec start script
13 verbose stack Error: [email protected] start: node ./bin/www
13 verbose stack Exit status 1
13 verbose stack at EventEmitter. (/usr/lib/node_modules/npm/node_modules/npm-lifecycle/index.js:285:16)
13 verbose stack at emitTwo (events.js:126:13)
13 verbose stack at EventEmitter.emit (events.js:214:7)
13 verbose stack at ChildProcess. (/usr/lib/node_modules/npm/node_modules/npm-lifecycle/lib/spawn.js:55:14)
13 verbose stack at emitTwo (events.js:126:13)
13 verbose stack at ChildProcess.emit (events.js:214:7)
13 verbose stack at maybeClose (internal/child_process.js:925:16)
13 verbose stack at Process.ChildProcess._handle.onexit (internal/child_process.js:209:5)
14 verbose pkgid [email protected]
15 verbose cwd /home/user1/erc20explorer
16 verbose Linux 4.4.0-31-generic
17 verbose argv "/usr/bin/node" "/usr/bin/npm" "start"
18 verbose node v8.11.3
19 verbose npm v5.6.0
20 error code ELIFECYCLE
21 error errno 1
22 error [email protected] start: node ./bin/www
22 error Exit status 1
23 error Failed at the [email protected] start script.
23 error This is probably not a problem with npm. There is likely additional logging output above.
24 verbose exit [ 1, true ]

Thanks.

Readme Update

Step 4 in the instructions:
git clone https://github.com/gobitfly/erc20-exporter
should be
git clone https://github.com/gobitfly/erc20-explorer

tokenz erc-20

No events showed with a different ABI

My ERC20 contract is based on OpenZeppelin's MintableToken and NoEther. I've altered the ABI in the config to:

this.erc20ABI = [{"constant":true,"inputs":[],"name":"mintingFinished","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":true,"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_value","type":"uint256"}],"name":"approve","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"totalSupply","outputs":[{"name":"","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFrom","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"decimals","outputs":[{"name":"","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_amount","type":"uint256"}],"name":"mint","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_subtractedValue","type":"uint256"}],"name":"decreaseApproval","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"finishMinting","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"owner","outputs":[{"name":"","type":"address"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":true,"inputs":[],"name":"symbol","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"reclaimEther","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_addedValue","type":"uint256"}],"name":"increaseApproval","outputs":[{"name":"","type":"bool"}],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"},{"name":"_spender","type":"address"}],"name":"allowance","outputs":[{"name":"","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[{"name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"payable":false,"stateMutability":"nonpayable","type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"amount","type":"uint256"}],"name":"Mint","type":"event"},{"anonymous":false,"inputs":[],"name":"MintFinished","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"previousOwner","type":"address"},{"indexed":true,"name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"owner","type":"address"},{"indexed":true,"name":"spender","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"from","type":"address"},{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Transfer","type":"event"}];

However, with this ABI no events are showed. Is there some incompatibility?

ERC20

Update NPM Version

Is there any chance you could update this required NPM version. Seems you can only run with version 8.11.3...

this.names not working

I've tried to add custom name for each address,not working.

Issue with Geth IPC

I have configured it successfully and connected it with Geth IPC. But it's not showing any data.. :(

Any idea, why?

Thanks,
Ashish

Make it work with Geth

Is it possible and how to make it work with geth instead of parity nodes? cheers

can u supply contract api?

i am use php dev ethereum Tokens . but i can't find the contract json-rpc command.
thanks.