<img src="https://api.travis-ci.org/ripple/gatewayd.svg?branch=develop" />
Gatewayd (pronounced "gateway-dee"), provides a framework you can extend to build a gateway on the Ripple Network. The system includes a core database that manages accounting for deposits and withdrawals of assets, linking the network with your holdings in the outside world. Gatewayd provides a standard interface for issuing any currency on the Ripple network and exchange, with the goal of completely abstracting interaction with Ripple.
Gatewayd's features include:
The Ripple Dev Portal contains detailed information on Gatewayd and its APIs.
The update process for gatewayd may change in the future, but for now, updating to a new version follows this process:
masterbranch from Github. (This assumes you created it by using
git cloneon the repository first.)
sudo npm install --global
Before you can run gatewayd, you need to set up the appropriate accounts that will be used to store and send funds in the Ripple network. You also need to define which currencies your gateway issues. Beyond that, there are some options you can set if they fit your needs.
The defaults for all of gatewayd's settings are found in the file
config/environment.js. You can override any of those settings with your own values by editing them in the file
config/config.json, or by using the API methods for setting the configuration. (The API methods result in editing the
config/config.json file anyway.) Don't edit the
config/environment.js file, since that only contains the defaults, and gets overridden in a software update.
After installation, start the gateway processes by running the command:
In addition to the REST interface, many pieces of Gatewayd can be controlled directly through the commandline. This is done by running the
gateway script (
bin/gateway from the project's top level directory) with the relevant commands.
You can get usage information for the commandline as follows: