bitfeed/server/README.md

Building and Running the Bitfeed API Server

Prerequisites

• Elixir
• Bitcoin Full Node
  • unpruned
  • indexed
  • running in server mode
  • with ZMQ enabled
  • (see an example bitcoin.conf file here)

Installation

mix do deps.get
mix do deps.compile

Configuration

The API server expects the following environment variables to be set:

variable	usage
MIX_ENV	compilation environment, either "prod" or "dev"
PORT	Port to expose the API (front end connects to this)
BITCOIN_HOST	Bitcoin node host address
BITCOIN_ZMQ_RAWBLOCK_PORT	Bitcoin node ZMQ port for block events (to match zmqpubrawblock in bitcoin.conf)
BITCOIN_ZMQ_RAWTX_PORT	Bitcoin node ZMQ port for transaction events (to match zmqpubrawtx in bitcoin.conf)
BITCOIN_ZMQ_SEQUENCE_PORT	Bitcoin node ZMQ port for sequence events (to match zmqpubsequence in bitcoin.conf)
BITCOIN_RPC_PORT	Bitcoin node RPC port
either
BITCOIN_RPC_USER	Bitcoin node RPC user
BITCOIN_RPC_PASS	Bitcoin node RPC password
or
BITCOIN_RPC_COOKIE	absolute path to a Bitcoin node RPC authentication .cookie file

Running in development

Compile and run in an interactive local shell:

iex -S mix

Building for production

mix release

Running production build

_build/prod/rel/prod/bin/prod start