Connecting to a Testnet

Connect an Interledger node to an ILP Testnet.

Connect to an ILP Testnet

This tutorial will help you start moneyd locally on your computer and connect it to an ILP router on the Testnet .

This tutorial describes how to:

  1. Configure and start moneyd to connect to an ILP router on the Testnet
  2. Send value in XRP to a payment pointer on the Testnet

Before you begin

For this tutorial you will need to:

  1. Install moneyd and SPSP. You can learn how to install moneyd and SPSP from the Getting Started tutorial.
  2. Install the moneyd XRP uplink using the command:
    npm install -g moneyd-uplink-xrp

Note: Interledger supports many different underlying asset types, but you don't need to use real cryptocurrency for this tutorial. You send value through an ILP router on the Testnet and funds are sourced from the XRP Testnet faucet , which have no real-world value.

Configuring moneyd

Note: Before configuring moneyd, make sure to delete the .moneyd.test.json config file, located in the home folder of your computer, if the file already exists.

To configure moneyd:

  1. Open a terminal and use the following command:

    moneyd xrp:configure --testnet --advanced
  2. When prompted for the BTP host of parent connector, enter:
  3. Press enter for all other default options.

Starting moneyd

After you’ve configured moneyd, run the following command to start it on your computer and connect it to an ILP router on the Testnet:

moneyd xrp:start --testnet

If everything goes well, you should see connector ready in the logs similar to this:

2019-07-01T16:33:34.921Z connector:ilp-plugin-mini-accounts[local] info listening on port 7768
2019-07-01T16:33:34.924Z connector:app info connector ready (republic attitude). address=test.xpring-dev.js1.ilspServer.P7sCid1j1WzWayl2s4w8Tuu2yyBrLCqtRc9s4Umb3xg version=22.4.1

Sending value

Once moneyd is connected to the router on the Testnet, you can send value to Alice or Carol.

To send value to Alice, open a new terminal and run:

$ ilp-spsp send --amount 10 --receiver '$'

If you were successful, you should see the following output on the sending terminal:

paying 10 to "$"...
sent 10 units!