ILP TestNet: Getting Started

Create an account on the ILP TestNet to send and receive money.

Overview

This tutorial describes how to:

  1. Create an account at https://faucet.ilpv4.dev.

  2. Grab an API token.

  3. Fund your account using the TestNet Rainmaker.

  4. Check your balance.

  5. Pay a Friend.

  6. Get paid.

1. Get Super Powers

Create a new, programmable TestNet account at https://faucent.ilpv4.dev.

2. Make it Rain

To send your new faucet account faux XRP, issue the following command:

curl --location --request POST 'https://hermes-rest.ilpv4.dev/accounts/{your-account-id}/money' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw ''

This will add 10 faux XRP to your faucet account.

The Rainmaker is available to any anyone who asks - after all, this is just a TestNet!

If you prefer a UI instead, the testnet wallet at https://wallet.ilpv4.dev has a rainmaker button that you can use to send yourself some faux XRP. Click the button in that wallet to grant yourself some XRP.

3. Grab an API Token

In the ilpv4.dev Faucet, you can obtain an API token by pressing the Generate ILP Testnet Credentials button.

4. Check Your Balance

To see how much money is in your account, try the following call:

curl --location --request GET 'https://jc.ilpv4.dev/accounts/{your-faucet-account-id}/balance' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {auth_token}'

This request will return a JSON payload similar to this one:

{
    "assetCode": "XRP",
    "assetScale": "9",
    "accountBalance": {
        "accountId": "user_ykqwwe2b",
        "netBalance": "0",
        "clearingBalance": "0",
        "prepaidAmount": "0"
    }
}

5. Pay a Friend

Spread the love to a friend by making a payment to a payment pointer. In this case, try sending value to a different wallet on the testnet. Maybe someone at https://rafiki.money.

curl --location \
--request POST 'https://hermes-rest.ilpv4.dev/accounts/{your-account-id}/pay' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {auth_token}' \
--data-raw '{
  "amount": "1000000",
  "destinationPaymentPointer": "$rafiki.money/p/{receiver-email-address}"
}'

This request will return JSON similar to the JSON below, representing 1,000 XRP drops paid:

{
    "originalAmount": "1000000",
    "amountDelivered": "1000000",
    "amountSent": "1000000",
    "successfulPayment": true
}

Note the meaning of the following fields:

originalAmount: the amount that you wanted to send. amountDelivered: the amount your friend actually received. amountSent: is the amount that actually got sent to your friend.

6. Get Paid

Try sending money back to your Faucet wallet using the PaymentPointer obtained in step 1. Then, check your balance programmatically to see that the money has arrived in your account.

Last updated

Was this helpful?