From 5b0125b1f3fb715ac63d44531200e44fbc475d9e Mon Sep 17 00:00:00 2001 From: Edward Hennis Date: Wed, 5 Aug 2020 13:04:44 -0400 Subject: [PATCH 1/5] Fix some typos in the Validator List Method page --- content/references/rippled-api/validator-list.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/content/references/rippled-api/validator-list.md b/content/references/rippled-api/validator-list.md index f4575d9ee4..25adcebc5a 100644 --- a/content/references/rippled-api/validator-list.md +++ b/content/references/rippled-api/validator-list.md @@ -6,7 +6,8 @@ Like the [Peer Crawler](peer-crawler.html), the validator list method is availab ## Request Format -To request the Peer Crawler information, make the following HTTP request: +To request the Validator List information, make the following HTTP +request: - **Protocol:** https - **HTTP Method:** GET @@ -67,8 +68,9 @@ If you decode the `blob` from base64, the result is a JSON object with the follo | `Field` | Value | Description | |:-------------|:-------|:-----------------------------------------------------| | `sequence` | Number | Unique sequence number for this list. A larger sequence number indicates a newer list; only the newest list is valid at a time. | -| `expiration` | Number | The time this list expires, in [seconds since the Ripple Epoch][]. | -| `validators | Array | A list of recommended validators. | +| `expiration` | Number | The time this list expires, in [seconds since +the Ripple Epoch][]. | +| `validators` | Array | A list of recommended validators. | Each member of the `validators` array has the following fields: @@ -99,7 +101,7 @@ GET https://localhost:51235/vl *cURL* ``` -curl --insecure https://localhost:51235/vl +curl --insecure https://localhost:51235/vl/ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 ``` From 920e39a8a4dfdaed1ba65cadd769938b1cca1135 Mon Sep 17 00:00:00 2001 From: Edward Hennis Date: Wed, 5 Aug 2020 18:16:11 -0400 Subject: [PATCH 2/5] [FOLD] Fix hard-wrap --- content/references/rippled-api/validator-list.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/references/rippled-api/validator-list.md b/content/references/rippled-api/validator-list.md index 25adcebc5a..b01ee83a28 100644 --- a/content/references/rippled-api/validator-list.md +++ b/content/references/rippled-api/validator-list.md @@ -68,9 +68,8 @@ If you decode the `blob` from base64, the result is a JSON object with the follo | `Field` | Value | Description | |:-------------|:-------|:-----------------------------------------------------| | `sequence` | Number | Unique sequence number for this list. A larger sequence number indicates a newer list; only the newest list is valid at a time. | -| `expiration` | Number | The time this list expires, in [seconds since -the Ripple Epoch][]. | -| `validators` | Array | A list of recommended validators. | +| `expiration` | Number | The time this list expires, in [seconds since the Ripple Epoch][]. | +| `validators` | Array | A list of recommended validators. | Each member of the `validators` array has the following fields: From 8eb2b2f5f1d4971722c90e4bab36b23f265db0e4 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 10 Aug 2020 15:55:55 -0700 Subject: [PATCH 3/5] Update Devnet connection instructions to use UNL --- ...ect-your-rippled-to-the-xrp-test-net.ja.md | 65 ++++--- ...onnect-your-rippled-to-the-xrp-test-net.md | 169 ++++++++++++------ 2 files changed, 143 insertions(+), 91 deletions(-) diff --git a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md index 456e534c9f..ffc96e52a7 100644 --- a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md +++ b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md @@ -7,87 +7,84 @@ Rippleは[代替となるテスト用および開発用ネットワーク](paral `rippled`サーバーをXRP TestnetまたはDevnetに接続するには、以下の構成を設定します。 1. `rippled.cfg`ファイルで以下の手順に従います。 - + a. [Testnet](xrp-testnet-faucet.html)に接続するには、以下のセクションのコメントを解除し、次のように追加します。 - + [ips] s.altnet.rippletest.net 51235 - + b. [Devnet](xrp-testnet-faucet.html)に接続するには、以下のセクションのコメントを解除し、次のように追加します。 - + [ips] s.devnet.rippletest.net 51235 - + c. 以下のセクションを次のようにコメントアウトします。 - + # [ips] # r.ripple.com 51235 2. `validators.txt`ファイルで以下の手順に従います。 - + 2a. Altnetに接続するための変更 - + a. 以下のセクションのコメントを解除し、Altnetに接続するようにします。 - + [validator_list_sites] https://vl.altnet.rippletest.net - + [validator_list_keys] ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 - + b. 以下のセクションを次のようにコメントアウトします。 - + # [validator_list_sites] # https://vl.ripple.com # # [validator_list_keys] # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 - + 2b. Devnetに接続するための変更 - + a. 以下のセクションをコメントアウトします。 - + # [validator_list_sites] # https://vl.altnet.rippletest.net - + # [validator_list_keys] # ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 - + # [validator_list_sites] # https://vl.ripple.com # # [validator_list_keys] # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 - + b. 次の信頼できるバリデータをvalidator.txtファイルに追加します。 - - # Hard-coded List of Devnet Validators - [validators] - n9Mo4QVGnMrRN9jhAxdUFxwvyM4aeE1RvCuEGvMYt31hPspb1E2c - n9MEwP4LSSikUnhZJNQVQxoMCgoRrGm6GGbG46AumH2KrRrdmr6B - n9M1pogKUmueZ2r3E3JnZyM3g6AxkxWPr8Vr3zWtuRLqB7bHETFD - n9MX7LbfHvPkFYgGrJmCyLh8Reu38wsnnxA4TKhxGTZBuxRz3w1U - n94aw2fof4xxd8g3swN2qJCmooHdGv1ajY8Ae42T77nAQhZeYGdd - n9LiE1gpUGws1kFGKCM9rVFNYPVS4QziwkQn281EFXX7TViCp2RC - n9Jq9w1R8UrvV1u2SQqGhSXLroeWNmPNc3AVszRXhpUr1fmbLyhS + + [validator_list_sites] + https://vl.devnet.rippletest.net/index.json + + [validator_list_keys] + 021B0DE76CED20C8B341086D8F4C8AB3D62657C6EDE19395461B197223D6271CA5 + 3. `rippled`を再起動します。 4. `rippled`がXRP TestnetまたはDevnetに接続していることを確認するため、サーバーで[server_infoメソッド][]を使用して、その結果をTestnetまたはDevnetの公開サーバーの結果と比較します。両方のサーバーで`validated_ledger`オブジェクトの`seq`フィールドが同一である必要があります（確認中にこの数が変化した場合は、1～2の差が生じる可能性があります）。 - + 以下のコマンドは、`s.altnet.rippletest.net`にあるTestnetサーバーの最新の検証済みレジャーをチェックします。 - + $ ./rippled --rpc_ip 34.210.87.206:51234 server_info | grep seq - + 以下のコマンドは、`s.devnet.rippletest.net`にあるDevnetサーバーの最新の検証済みレジャーをチェックします。 - + $ ./rippled --rpc_ip 34.83.125.234:51234 server_info | grep seq - + 以下のコマンドは、ローカルの`rippled`の最新検証済みレジャーインデックスをチェックします。 - + $ ./rippled server_info | grep seq diff --git a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md index df457c3712..43d79900b6 100644 --- a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md +++ b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md @@ -4,98 +4,153 @@ Ripple hosts [alternative test and development networks](parallel-networks.html) **Note:** The XRP Testnet and Devnet ledger and balances are reset on a regular basis. -To connect your `rippled` server to the XRP Testnet or Devnet, set the following configurations: +## Steps -1. Edit your `rippled.cfg` file to connect to a hub server in the network you want to connect to. +To connect your `rippled` server to the XRP Testnet or Devnet, complete these steps. You can also use these steps to switch back to the production Mainnet after being on the Testnet or Devnet. - 1. To connect to the [Testnet](xrp-testnet-faucet.html), uncomment or add the following section: +## 1. Configure your server to connect to the right hub. - [ips] - s.altnet.rippletest.net 51235 +Edit your `rippled.cfg` file. - 2. To connect to the [Devnet](xrp-testnet-faucet.html), uncomment or add the following section: +{% include '_snippets/conf-file-location.md' %} + - [ips] - s.devnet.rippletest.net 51235 +1. Set an `[ips]` stanza with the hub for the network you want to connect to: - 3. Comment out the existing `[ips]` stanza: + - # [ips] - # r.ripple.com 51235 + *Testnet* + + [ips] + s.altnet.rippletest.net 51235 + + *Devnet* + + [ips] + s.devnet.rippletest.net 51235 + + *Mainnet* + + # No [ips] stanza. Use the default hubs to connect to Mainnet. +3. Comment out the previous `[ips]` stanza, if there is one: -2. Edit your `validators.txt` file. + # [ips] + # r.ripple.com 51235 + # zaphod.alloy.ee 51235 + # sahyadri.isrdc.in 51235 - - To connect to the Testnet: +## 2. Set your trusted validator list. - 1. Uncomment the following sections: +Edit your `validators.txt` file. This file is located in the same folder as your `rippled.cfg` file and defines which validators your server trusts not to collude. - [validator_list_sites] - https://vl.altnet.rippletest.net +1. Uncomment or add the `[validator_list_sites]` and `[validator_list_keys]` stanzas for the network you want to connect to: - [validator_list_keys] - ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 + - 1. Comment out the following sections, as follows: + *Testnet* - # [validator_list_sites] - # https://vl.ripple.com - # - # [validator_list_keys] - # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 + [validator_list_sites] + https://vl.altnet.rippletest.net - - To connect to the Devnet: + [validator_list_keys] + ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 - 1. Comment out the following sections: + *Devnet* - # [validator_list_sites] - # https://vl.altnet.rippletest.net + [validator_list_sites] + https://vl.devnet.rippletest.net/index.json - # [validator_list_keys] - # ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 - - # [validator_list_sites] - # https://vl.ripple.com - # - # [validator_list_keys] - # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 - - 2. Add the following trusted validators to the `validator.txt` file: - - # Hard-coded List of Devnet Validators - [validators] - n9Mo4QVGnMrRN9jhAxdUFxwvyM4aeE1RvCuEGvMYt31hPspb1E2c - n9MEwP4LSSikUnhZJNQVQxoMCgoRrGm6GGbG46AumH2KrRrdmr6B - n9M1pogKUmueZ2r3E3JnZyM3g6AxkxWPr8Vr3zWtuRLqB7bHETFD - n9MX7LbfHvPkFYgGrJmCyLh8Reu38wsnnxA4TKhxGTZBuxRz3w1U - n94aw2fof4xxd8g3swN2qJCmooHdGv1ajY8Ae42T77nAQhZeYGdd - n9LiE1gpUGws1kFGKCM9rVFNYPVS4QziwkQn281EFXX7TViCp2RC - n9Jq9w1R8UrvV1u2SQqGhSXLroeWNmPNc3AVszRXhpUr1fmbLyhS + [validator_list_keys] + 021B0DE76CED20C8B341086D8F4C8AB3D62657C6EDE19395461B197223D6271CA5 -3. Restart `rippled`. + *Mainnet* -4. To verify that your `rippled` is connected to the XRP Testnet or Devnet, use the [server_info method][] on your server and compare it to the results from a public server on the Testnet or Devnet. The `seq` field of the `validated_ledger` object should be the same on both servers (possibly off by one or two, if it changed as you were checking). + [validator_list_sites] + https://vl.ripple.com - The following command checks the latest validated ledger of a Testnet server at `s.altnet.rippletest.net`: + [validator_list_keys] + ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 - $ ./rippled --rpc_ip 34.210.87.206:51234 server_info | grep seq + - The following command checks the latest validated ledger of a Devnet server at `s.devnet.rippletest.net`: +1. Comment out any previous `[validator_list_sites]`, `[validator_list_keys]`, or `[validators]` stanzas. - $ ./rippled --rpc_ip 34.83.125.234:51234 server_info | grep seq + For example: - The following command checks your local `rippled`'s latest validated ledger index: + # [validator_list_sites] + # https://vl.ripple.com + # + # [validator_list_keys] + # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 + + # Old hard-coded List of Devnet Validators + # [validators] + # n9Mo4QVGnMrRN9jhAxdUFxwvyM4aeE1RvCuEGvMYt31hPspb1E2c + # n9MEwP4LSSikUnhZJNQVQxoMCgoRrGm6GGbG46AumH2KrRrdmr6B + # n9M1pogKUmueZ2r3E3JnZyM3g6AxkxWPr8Vr3zWtuRLqB7bHETFD + # n9MX7LbfHvPkFYgGrJmCyLh8Reu38wsnnxA4TKhxGTZBuxRz3w1U + # n94aw2fof4xxd8g3swN2qJCmooHdGv1ajY8Ae42T77nAQhZeYGdd + # n9LiE1gpUGws1kFGKCM9rVFNYPVS4QziwkQn281EFXX7TViCp2RC + # n9Jq9w1R8UrvV1u2SQqGhSXLroeWNmPNc3AVszRXhpUr1fmbLyhS + +## 3. Restart the server. + +``` +$ sudo systemctl restart rippled +``` + +## 4. Verify that your server syncs. + +It takes about 5 to 15 minutes to sync to the network after a restart. After your server is synced, the [server_info method][] shows the a `validated_ledger` object based on the network you are connected to. + +To verify that your `rippled` is connected to the XRP Testnet or Devnet, compare the results from your server to [a public server](get-started-with-the-rippled-api.html#public-servers) on the Testnet or Devnet. The `seq` field of the `validated_ledger` object should be the same on both servers (possibly off by one or two, if it changed as you were checking). + +The following example shows how to check the latest validated ledger from the commandline: + + + +*Local Server* + +```sh +$ rippled server_info | grep seq +``` + +*Testnet* + +```sh +# s.altnet.rippletest.net +$ rippled --rpc_ip 35.158.96.209:51234 server_info | grep seq +``` + +*Devnet* + +```sh +# s.devnet.rippletest.net +$ rippled --rpc_ip 34.83.125.234:51234 server_info | grep seq +``` + + +*Mainnet* + +```sh +# s1.ripple.com +$ rippled --rpc_ip 34.201.59.230:51234 server_info | grep seq +``` + + + +**Note:** The IP addresses in these examples are for public servers, and may change periodically. If you get no response, look up the IP address of a [public server](get-started-with-the-rippled-api.html#public-servers), for example using the `dig` command. - $ ./rippled server_info | grep seq ## See Also - **Tools:** - [XRP Faucets](xrp-testnet-faucet.html) - - [WebSocket API Tool](websocket-api-tool.html) - Select 'Testnet Public Server' in the connection options. + - [WebSocket API Tool](websocket-api-tool.html) - Select 'Testnet Public Server' or 'Devnet Public Server' in the connection options. - **Concepts:** - [Parallel Networks](parallel-networks.html) - [Introduction to Consensus](intro-to-consensus.html) From d7f3e9cd9ebeea2de2c7075630b2170e77c5ba93 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 10 Aug 2020 16:42:59 -0700 Subject: [PATCH 4/5] Use Devnet master public key, remove tabs chars --- .../connect-your-rippled-to-the-xrp-test-net.ja.md | 2 +- .../connect-your-rippled-to-the-xrp-test-net.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md index ffc96e52a7..ddc9f54b8e 100644 --- a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md +++ b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.ja.md @@ -67,7 +67,7 @@ Rippleは[代替となるテスト用および開発用ネットワーク](paral https://vl.devnet.rippletest.net/index.json [validator_list_keys] - 021B0DE76CED20C8B341086D8F4C8AB3D62657C6EDE19395461B197223D6271CA5 + EDDF2F53DFEC79358F7BE76BC884AC31048CFF6E2A00C628EAE06DB7750A247B12 diff --git a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md index 43d79900b6..5a19950693 100644 --- a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md +++ b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md @@ -68,11 +68,11 @@ Edit your `validators.txt` file. This file is located in the same folder as your *Mainnet* - [validator_list_sites] - https://vl.ripple.com + [validator_list_sites] + https://vl.ripple.com - [validator_list_keys] - ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 + [validator_list_keys] + EDDF2F53DFEC79358F7BE76BC884AC31048CFF6E2A00C628EAE06DB7750A247B12 From cecbfe8d3ff812168b214359862a691827a1bacb Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 10 Aug 2020 17:39:53 -0700 Subject: [PATCH 5/5] Devnet instructions: fix key mixup --- .../connect-your-rippled-to-the-xrp-test-net.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md index 5a19950693..59c9db80fb 100644 --- a/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md +++ b/content/tutorials/manage-the-rippled-server/configuration/connect-your-rippled-to-the-xrp-test-net.md @@ -60,10 +60,10 @@ Edit your `validators.txt` file. This file is located in the same folder as your *Devnet* [validator_list_sites] - https://vl.devnet.rippletest.net/index.json + https://vl.devnet.rippletest.net [validator_list_keys] - 021B0DE76CED20C8B341086D8F4C8AB3D62657C6EDE19395461B197223D6271CA5 + EDDF2F53DFEC79358F7BE76BC884AC31048CFF6E2A00C628EAE06DB7750A247B12 *Mainnet* @@ -72,7 +72,7 @@ Edit your `validators.txt` file. This file is located in the same folder as your https://vl.ripple.com [validator_list_keys] - EDDF2F53DFEC79358F7BE76BC884AC31048CFF6E2A00C628EAE06DB7750A247B12 + ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734