Eris-DB

	Linux
Master
Develop

Eris-db is Monax' permissioned blockchain client. It executes Ethereum smart contracts on a permissioned virtual machine. Eris-db provides transaction finality and high transaction throughput on proof-of-stake Tendermint consensus engine. For smart contract development most functionality is provided by eris chains, exposed through eris, the entry point for the Eris Platform.

Table of Contents

• Background
• Installation
• Usage
  • Security
• Contribute
• License

Background

See the eris-db documentation for more information.

Installation

eris-db is intended to be used by the eris chains command via eris. Available commands such as make | start | stop | logs | inspect | update are used for chain lifecycle management.

For Developers

Dependency management for eris-db is managed with glide, and you can build eris-db from source by following

1. Install go
2. Ensure you have gmp installed (sudo apt-get install libgmp3-dev || brew install gmp)
3. and execute following commands in a terminal:

go get github.com/Masterminds/glide

go get -d github.com/eris-ltd/eris-db

REPO=$($GOPATH/src/github.com/eris-ltd/eris-db)

cd $REPO && glide install

cd $REPO/cmd/eris-db && go install

To run eris-db, just type $ eris-db serve --work-dir <path to chain directory>, where the chain directory needs to contain the configuration files as generated by eris chains make.

This will start the node using the provided folder as working dir. If the path is omitted it defaults to ~/.erisdb

Usage

Once the server has started, it will begin syncing up with the network. At that point you may begin using it. The preferred way is through our javascript api, but it is possible to connect directly via HTTP or websocket. The JSON-RPC and web-api reference can be found here.

Configuration

A commented template config will be written as part of the eris chains make process and can be edited prior to the eris chains start process.

Contribute

See the CONTRIBUTING.md for more details.

License

Apache 2.0