README.md

Horizon

Build Status

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.

Downloading the server

Prebuilt binaries of horizon are available on the releases page.

See the old releases page for prior releases

Platform Binary file name
Mac OSX 64 bit horizon-darwin-amd64
Linux 64 bit horizon-linux-amd64
Windows 64 bit horizon-windows-amd64.exe

Alternatively, you can build the binary yourself.

Dependencies

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

Building

mercurial is used during glide build.

glide is used for building horizon.

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

curl https://glide.sh/get | sh

Next, you must download the source for packages that horizon depends upon. From within the project directory, run:

glide install

Then, simply run go install github.com/stellar/go/services/horizon. After successful completion, you should find horizon is present in your $GOPATH/bin directory.

More detailed intructions and admin guide.

Developing Horizon

See the development guide.

Contributing

Please see the CONTRIBUTING.md for details on how to contribute to this project.