With the growing popularity of BitCoin in the last couple of years, other blockchains have been in development for solving various problems that need distributed consensus. Ethereum blockchain is one example, that gives users to develop "smart contracts" that runs in the blockchain. This gives the ability to develop decentralized applications (or dApps). Users do not need to 'trust' anything or anybody. In addition to that, dApps are always available and will be guaranteed to be available in the future as well. Also, it is resistant to traditional attacks such as DDoS. This framework has given many developers to write a decentralized application without much effort, without needing distributed systems or cryptography knowledge. Many startups are actively developing applications for Ethereum such as Ethereum Name Service (ENS), Etheria or WeiFund. Unfortunately, because the technology being used is bleeding edge it is inevitable that attacks or hacks will target these apps for monetary reasons. Last year DAO suffered a severe attack because of its security flaws. Due to that attack, 3.6m ether was stolen from DAO's smart contract. Also, once you publish a smart contract in Ethereum it is not possible to modify or update it as a regular web application. Thus, even developers identify a critical bug in the contract it is not possible to push a bugfix in a straightforward way. Thus, in order to fill the gap of not having a proper 'smart contract' compatible monitoring service, we propose to build a web application that can monitor other smart contracts in Ethereum and give the capability to safeguard it's critical functions (Ether send and receive) and interact and visualize with smart contract functions in a much simpler way. Also depending smart contracts can using our base smart contracts to gain the advantage of having 'circuit-breaker' which will pause the activity if things go wrong in an unexpected way.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Make sure you have installed,
- Node.js (v6 and above)
- Apache TinkerPop server (v7.2.5)
- Python 3
EtherBeat depends on a Web3 compatible JSON-RPC server like Parity or Geth Ethereum node to query information. Enhanced querying capability is provided by TinkerPop server that will store the blockchain in a graph database.
Please follow instructions at here to setup your TinkerPop instance. Initial syncing process of Ethereum mainnet network with TinkerPop will take a considerable amount of time, therefore we recommend you to work with a test network to get started. Using Ethereum extractor provided in extractor.py, user can sync the graph database instance.
After Parity/Geth and TinkerPop server is running, you can start the node.js application. If there are any changes in default configuration, please make sure to edit them in config/web3conn.js file.
git clone git@github.com:scorelab/EtherBeat.git # or clone your own fork
cd EtherBeat
npm install
After running the node.js app, you can browse the grahql query instance at http://localhost:3000/graphql.
{
account (accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
balance
}
}
{
account (accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
creator
}
}
{
account (accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
transactions {
value
}
}
}
{
account(accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
transactions(page: 2, size: 100) {
value
}
}
}
Since from and to fields are Ethereum addresses it is possible treat them as accounts in EtherBeat, which gives the ability to do nested queries.
{
account(accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
transactions {
from {
address
balance
}
to {
address
balance
}
}
}
}
{
account(accountHash: "0xf7d93bcb8e4372f46383ecee82f9adf1aa397ba9") {
parameters (jsonAbi: "provide JSON abi interface here")
}
}
Result are returned as a list of (function name, variable type, result)
{
"data": {
"account": {
"parameters": "[{\"function\":\"newVersionReleased\",\"type\":[{\"name\":\"\",\"type\":\"bool\"}],\"result\":false},{\"function\":\"creationBlockNumber\",\"type\":[{\"name\":\"\",\"type\":\"uint256\"}],\"result\":\"639374\"},{\"function\":\"extraBalance\",\"type\":[{\"name\":\"\",\"type\":\"uint256\"}],\"result\":\"5.1707074912426014124443e+22\"},{\"function\":\"version\",\"type\":[{\"name\":\"\",\"type\":\"string\"}],\"result\":\"0.1.0\"},{\"function\":\"subsidyFactor\",\"type\":[{\"name\":\"\",\"type\":\"uint256\"}],\"result\":\"2\"}]"
}
}
}