Note this code is beta.

It is not ready yet for production.

Horizon

Horizon is the client facing API server for the Stellar ecosystem. It acts as the interface between stellar-core and applications that want to access the Stellar network. It allows you to submit transactions to the network, check the status of accounts, subscribe to event streams, etc. See an overview of the Stellar ecosystem for more details.

Dependencies

Horizon requires go 1.5 or higher to build. See (https://golang.org/doc/install) for installation instructions.

Building

gb is used for building horizon.

Given you have a running golang installation, you can install this with:

go get -u github.com/constabulary/gb/...

From within the project directory, simply run gb build. After successful completion, you should find bin/horizon is present in the project directory.

Regenerating generated code

Horizon uses two go tools you'll need to install:

1. go-bindata is used to bundle test data
2. go-codegen is used to generate some boilerplate code

After the above are installed, simply run gb generate.

Running Tests

first, create two local Postgres databases, and start a redis server on port 6379

psql -c 'create database "horizon_test";'
psql -c 'create database "stellar-core_test";'
redis-server

then, run the tests like so:

bash scripts/run_tests.bash