An API server that provides a REST-like interface to the XRP Ledger.
- Node v10 or higher
- yarn
- An XRP Ledger account with XRP For development, you can use the XRP Test Net and get some test XRP from the XRP Test Net Faucet.
-
Clone this repository (or download and extract a copy).
git clone [email protected]:ripple/xrp-api.git
-
Install dependencies using Yarn.
yarn install
-
Set up your configuration file for the first time.
yarn run setup
To start the server in development mode:
yarn dev
This starts the server with nodemon
so that it will be automatically restarted when you save changes to the code.
As this server is still in active development, we do not recommend using it in production at this time.
Considerations:
- SSL/TLS must be used for all requests. An SSL/TLS termination proxy is recommended.
- Restrictions should be made on signing, such as on the types of transactions, amount/velocity, and whitelisting of destinations. This feature is coming in the future.
- If an error occurs, the server will exit to protect security & data integrity. We recommend using nodemon or forever to restart the server if any errors occur in production.
In this simple tutorial, we will get our account's XRP balance, send a payment, and check the status of our payment.
-
Get our account's XRP balance.
In the following example, replace
{ACCOUNT_ADDRESS_HERE}
with your Address:curl -X GET \ http://localhost:3000/v1/accounts/{ACCOUNT_ADDRESS_HERE}/info
-
Send a payment
In the following example, replace
{ACCOUNT_ADDRESS_HERE}
with your Address (2 locations),{API_KEY_HERE}
with your API key, and{DESTINATION_ADDRESS_HERE}
with a destination address. If you are using the Test Net, you can use the addressrPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
as a destination.curl -X POST \ http://localhost:3000/v1/payments \ -H 'Authorization: Bearer {API_KEY_HERE}' \ -H 'Content-Type: application/json' \ -d '{ "payment": { "source_address": "{ACCOUNT_ADDRESS_HERE}", "source_amount": { "value": "20", "currency": "XRP" }, "destination_address": "{DESTINATION_ADDRESS_HERE}", "destination_amount": { "value": "20", "currency": "XRP" } }, "submit": true }'
The response shows the transaction's identifying hash in the
hash
field of thetx_json
object. Take note of this value for the next step. -
Check the status of the payment.
In the following example, replace
{TRANSACTION_ID}
with the transaction's identifying hash from the previous step:curl -X GET \ http://localhost:3000/v1/transactions/{TRANSACTION_ID}
You can also run the service in a docker container using the Dockerfile in this repo.
-
Be sure you have done the secret_config step from the Initial Setup section.
-
Build the container.
docker build . -t <some_tag>
-
Run the container.
docker run -it -p 3000:3000 -v <path_to_secret_config>/.secret_config.js:/xrp-api/.secret_config.js <some_tag>
-
You should now be able to run the steps in the tutorial.