Skip to content

helium/blockchain-http

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

blockchain-http

CI codecov

This is an Erlang application to serve up the Helium blockchain as stored by the blockchain-etl service and schema. The two applications rely on the schema being compatible to work

Developer Usage

  • Clone this repository

  • Create .env file by copying .env.template and editing it to reflect your postgres read-only and read-write access URLs

  • Run make release in the top level folder

  • Run make start to start the application. Logs will be at _build/default/rel/blockchain_http/log/*.

Once started the application will start serving up the blockchain through a number of routes. Documentation for these routes will be added soon.

Installing Ubuntu Required Packages

If running on Ubuntu, you will need the following packages installed before running make release:

wget https://packages.erlang-solutions.com/erlang-solutions_2.0_all.deb
sudo dpkg -i erlang-solutions_2.0_all.deb
sudo apt-get update
sudo apt install esl-erlang=1:23.2.3-1 cmake libsodium-dev libssl-dev
sudo apt install build-essential

WARNING

This application does NOT serve up over TLS, and does NOT rate control, or access control clients. Please run this service behind a load balancer that terminates SSL and does some rate and access control.

Using Docker

Building the Docker Image

docker build -t helium/api .

Running the Docker Container

docker run -d --init \
--restart unless-stopped \
--publish 8080:8080/tcp \
--name api \
--mount type=bind,source=$HOME/api_data,target=/var/data \
-e DATABASE_RO_URL=postgresql://user:pass@127.0.0.1:5432/helium_blockchain \
-e DATABASE_RW_URL=postgresql://user:pass@127.0.0.1:5432/helium_blockchain \
-e DATABASE_RO_POOL_SIZE=10 \
helium/api

Updating Docker

Navigate to your copy of the blockchain-http repository.

cd /path/to/blockchain-http

Stop the Docker container.

docker stop api

Remove the existing Docker container.

docker rm api

Update the repository.

git pull

Rebuild the Docker image.

docker build -t helium/api .

Run the updated Docker container.

docker run -d --init \
--restart unless-stopped \
--publish 8080:8080/tcp \
--name api \
--mount type=bind,source=$HOME/api_data,target=/var/data \
-e DATABASE_RO_URL=postgresql://user:pass@127.0.0.1:5432/helium_blockchain \
-e DATABASE_RW_URL=postgresql://user:pass@127.0.0.1:5432/helium_blockchain \
-e DATABASE_RO_POOL_SIZE=10 \
helium/api