CoinTape

Bitcoin Transaction Fees Prediction

CoinTape analyses Blockchain transaction fees and displays current and predicted fees:

Requirements for Deployment:

• PostgreSQL database 9.2 or higher
• Java SDK 7 or higher
• Apache, nginx or other web server as reverse proxy.

Requirements for Development:

• SBT (Simple Build Tool) - http://www.scala-sbt.org/download.html
• PostgreSQL database 9.2 or higher
• Java SDK 7 or higher
• Node for frontend development (React/JSX): https://nodejs.org

How to run locally:

• Create an empty database on your local PostgreSQL instance named "cointape", and user login for "cointape" / "cointape". You may change these settings in application.conf
• Run a local Bitcoin Core daemon with the parameters -txindex=1 -rest. The REST interface is necessary for fetching data from the blockchain. The transaction index is necessary to fetch full data about all transactions. Read more about this here: https://en.bitcoin.it/wiki/Running_Bitcoin
• Make sure Node is installed, and an empty cointape PostgreSQL database is created and the db server is running.
• Switch to the cointape root directory and run sbt run to start CoinTape with its local development webserver.
• Go to http://localhost:9000 and wait for CoinTape to pull the latest blockchain data and start predicting. This will also automatically create all necessary database tables on the first start. Pulling blockchain data may take a few minutes.

How to deploy:

• Change database settings if necessary in conf/application.conf. Make sure the (empty) database is reachable from the production system. Any empty database will automatically be initialized on first application start.
• run sbt stage. This creates an executable bundle in target\universal\stage, which can be run on any system with JDK 7+. See an example upstart script for Debian-based systems in deployment/upstart.conf, which uses /var/www/cointape as its deployment path.
• CoinTape runs its own webserver on port 9000 by default. Use a reverse proxy to host on a domain, see example nginx webserver config in deployment/nginx.conf.

Messages

Common log messages and their meaning.

• "not enough blocks for prediction": Still analysing the latest blocks from Bitcoin Core. This will take a couple of minutes until at least 12 blocks are reached,
• "Block update error: java.net.ConnectException: Connection refused: no further information: localhost/127.0.0.1:8332": Bitcoin Core is not running, or does not have REST interface enabled, or is still booting up (while indexing its database).