From 71ba5bae71b332e9a2eae06826e8699c2c8ebb59 Mon Sep 17 00:00:00 2001 From: mayurbhandary Date: Thu, 6 Feb 2020 18:39:18 -0500 Subject: [PATCH 1/4] Updated The validator claims ownership of the domain section Description of how to update the validator's manifest with a domain by generating a new validator token. --- content/references/xrp-ledger-toml.md | 50 ++++++++++++++++++++++----- 1 file changed, 42 insertions(+), 8 deletions(-) diff --git a/content/references/xrp-ledger-toml.md b/content/references/xrp-ledger-toml.md index 549a5c2b13..b2d95f77a9 100644 --- a/content/references/xrp-ledger-toml.md +++ b/content/references/xrp-ledger-toml.md @@ -280,16 +280,50 @@ Domain verification requires establishing a two-way link between the domain oper - In that `xrp-ledger.toml` file, provide a `[[VALIDATORS]]` entry with the validator's master public key in the `public_key` field. -2. The validator claims ownership by the domain. The instructions for this step are out of scope for this specification. +2. The validator claims ownership of the domain: - - + - Ensure that you have access to the validator-keys.json file that you created when first setting up your validator. If you have lost your keys or the keys have been compromised, please [revoke your keys](https://xrpl.org/run-rippled-as-a-validator.html#revoke-validator-keys) and generate new keys. + Note: Recall that your validator-keys.json file should be stored **in a location not on your validator**. + + - **In a location not on your validator**, build the [validator-keys-too1](https://github.com/ripple/validator-keys-tool). + + - Run the following command to generate a new validator token that incorporates your domain and update your `xrp-ledger.toml` and `rippled.cfg` files: + + ``` + $./validator-keys set_domain your-domain-here.com + ``` + +Sample Output: + +``` +The domain name has been set to: your-domain-here.com + +The domain attestation for validator nHDG5CRUHp17ShsEdRweMc7WsA4csiL7qEjdZbRVTr74wa5QyqoF is: + +attestation="A59AB577E14A7BEC053752FBFE78C3DE + D6DCEC81A7C41DF1931BC61742BB4FAE + AA0D4F1C1EAE5BC74F6D68A3B26C8A22 + 3EA2492A5BD18D51F8AC7F4A97DFBE0C" + +You should include it in your xrp-ledger.toml file in the +section for this validator. + +You also need to update the rippled.cfg file to add a new +validator token and restart rippled: + +# validator public key: nHDG5CRUHp17ShsEdRweMc7WsA4csiL7qEjdZbRVTr74wa5QyqoF + +[validator_token] +eyJ2YWxpZGF0aW9uX3NlY3J|dF9rZXkiOiI5ZWQ0NWY4NjYyNDFjYzE4YTI3NDdiNT +QzODdjMDYyNTkwNzk3MmY0ZTcxOTAyMzFmYWE5Mzc0NTdmYT|kYWY2IiwibWFuaWZl +c3QiOiJKQUFBQUFGeEllMUZ0d21pbXZHdEgyaUNjTUpxQzlnVkZLaWxHZncxL3ZDeE +hYWExwbGMyR25NaEFrRTFhZ3FYeEJ3RHdEYklENk9NU1l1TTBGREFscEFnTms4U0tG +bjdNTzJmZGtjd1JRSWhBT25ndTlzQUtxWFlvdUorbDJWMFcrc0FPa1ZCK1pSUzZQU2 +hsSkFmVXNYZkFpQnNWSkdlc2FhZE9KYy9hQVpva1MxdnltR21WcmxIUEtXWDNZeXd1 +NmluOEhBU1FLUHVnQkQ2N2tNYVJGR3ZtcEFUSGxHS0pkdkRGbFdQWXk1QXFEZWRGdj +VUSmEydzBpMjFlcTNNWXl3TFZKWm5GT3I3QzBrdzJBaVR6U0NqSXpkaXRROD0ifQ== +``` ## Account Verification From 74309d284a5a87457749d1b1cce74f81a02fe101 Mon Sep 17 00:00:00 2001 From: mbhandary Date: Mon, 10 Feb 2020 18:20:00 -0500 Subject: [PATCH 2/4] Changed formatting, added attestations, and added token warning --- content/references/xrp-ledger-toml.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/content/references/xrp-ledger-toml.md b/content/references/xrp-ledger-toml.md index b2d95f77a9..15c32a1f4c 100644 --- a/content/references/xrp-ledger-toml.md +++ b/content/references/xrp-ledger-toml.md @@ -89,6 +89,7 @@ expires = 2019-03-01T00:00:00.000Z [[VALIDATORS]] public_key = "nHBtDzdRDykxiuv7uSMPTcGexNm879RUUz5GW4h1qgjbtyvWZ1LE" +attestation="A59AB577E14A7BEC053752ABFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA2492A5BD18D51F8AC7F4A97DFBE0C" network = "main" owner_country = "us" server_country = "us" @@ -96,11 +97,14 @@ unl = "https://vl.ripple.com" [[VALIDATORS]] public_key = "nHB57Sey9QgaB8CubTPvMZLkLAzfJzNMWBCCiDRgazWJujRdnz13" +attestation="A59AB577E14A7BEC053752FBFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA249BA5BD18D51F8AC7F4A97DFBE0C" network = "testnet" owner_country = "us" server_country = "us" unl = "https://vl.testnet.rippletest.net" +# Note: the attestions above are only examples and are not real. + [[ACCOUNTS]] address = "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV" desc = "Ripple-owned address from old ripple.txt file" @@ -282,7 +286,7 @@ Domain verification requires establishing a two-way link between the domain oper 2. The validator claims ownership of the domain: - - Ensure that you have access to the validator-keys.json file that you created when first setting up your validator. If you have lost your keys or the keys have been compromised, please [revoke your keys](https://xrpl.org/run-rippled-as-a-validator.html#revoke-validator-keys) and generate new keys. + - Ensure that you have access to the validator-keys.json file that you created when first setting up your validator. If you have lost your keys or the keys have been compromised, please [revoke your keys](run-rippled-as-a-validator.html#revoke-validator-keys) and generate new keys. Note: Recall that your validator-keys.json file should be stored **in a location not on your validator**. @@ -290,14 +294,14 @@ Domain verification requires establishing a two-way link between the domain oper - Run the following command to generate a new validator token that incorporates your domain and update your `xrp-ledger.toml` and `rippled.cfg` files: - ``` - $./validator-keys set_domain your-domain-here.com - ``` + + $./validator-keys set_domain example.com + Sample Output: ``` -The domain name has been set to: your-domain-here.com +The domain name has been set to: example.com The domain attestation for validator nHDG5CRUHp17ShsEdRweMc7WsA4csiL7qEjdZbRVTr74wa5QyqoF is: @@ -325,6 +329,13 @@ NmluOEhBU1FLUHVnQkQ2N2tNYVJGR3ZtcEFUSGxHS0pkdkRGbFdQWXk1QXFEZWRGdj VUSmEydzBpMjFlcTNNWXl3TFZKWm5GT3I3QzBrdzJBaVR6U0NqSXpkaXRROD0ifQ== ``` +Update your `xrp-ledger.toml` file as described in the sample output. See [here](xrp-ledger-toml.html#contents) for an example. + + + + +**Warning:** Your validator token is meant to be kept secret. Do not share it on your `xrp-ledger.toml` file or anywhere else. + ## Account Verification Similar to [Domain Verification](#domain-verification), account verification is the idea of proving that the same entity operates a particular domain and a particular XRP Ledger address. Account verification is not necessary for using the XRP Ledger or providing an `xrp-ledger.toml` file, but you may desire to verify your accounts in the name of transparency. From db1c8a4314d6ff94aa4a53fa5d84253b68877b83 Mon Sep 17 00:00:00 2001 From: mbhandary Date: Tue, 18 Feb 2020 09:17:44 -0500 Subject: [PATCH 3/4] Made TOML and cfg update more explicit and changed link --- content/references/xrp-ledger-toml.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/references/xrp-ledger-toml.md b/content/references/xrp-ledger-toml.md index 15c32a1f4c..4c1fb3395f 100644 --- a/content/references/xrp-ledger-toml.md +++ b/content/references/xrp-ledger-toml.md @@ -89,7 +89,7 @@ expires = 2019-03-01T00:00:00.000Z [[VALIDATORS]] public_key = "nHBtDzdRDykxiuv7uSMPTcGexNm879RUUz5GW4h1qgjbtyvWZ1LE" -attestation="A59AB577E14A7BEC053752ABFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA2492A5BD18D51F8AC7F4A97DFBE0C" +attestation = "A59AB577E14A7BEC053752ABFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA2492A5BD18D51F8AC7F4A97DFBE0C" network = "main" owner_country = "us" server_country = "us" @@ -97,7 +97,7 @@ unl = "https://vl.ripple.com" [[VALIDATORS]] public_key = "nHB57Sey9QgaB8CubTPvMZLkLAzfJzNMWBCCiDRgazWJujRdnz13" -attestation="A59AB577E14A7BEC053752FBFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA249BA5BD18D51F8AC7F4A97DFBE0C" +attestation = "A59AB577E14A7BEC053752FBFE78C3DED6DCEC81A7C41DF1931BC61742BB4FAEAA0D4F1C1EAE5BC74F6D68A3B26C8A223EA249BA5BD18D51F8AC7F4A97DFBE0C" network = "testnet" owner_country = "us" server_country = "us" @@ -329,7 +329,7 @@ NmluOEhBU1FLUHVnQkQ2N2tNYVJGR3ZtcEFUSGxHS0pkdkRGbFdQWXk1QXFEZWRGdj VUSmEydzBpMjFlcTNNWXl3TFZKWm5GT3I3QzBrdzJBaVR6U0NqSXpkaXRROD0ifQ== ``` -Update your `xrp-ledger.toml` file as described in the sample output. See [here](xrp-ledger-toml.html#contents) for an example. +Update [the contents of your `xrp-ledger.toml` file](#contents) with the `attestation` block, and update the `rippled.cfg` file with the `[validator_token]` block from the sample output. From 74581c6b7a7e4904f6b12e978604a8318db3fd01 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 18 Feb 2020 11:04:38 -0800 Subject: [PATCH 4/4] [JA] toml: Fix broken link to key revocation --- dactyl-config.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/dactyl-config.yml b/dactyl-config.yml index e542c325e2..bf3f3d0b51 100644 --- a/dactyl-config.yml +++ b/dactyl-config.yml @@ -215,9 +215,10 @@ targets: "xrp-ledger-overview.html#censorship-resistant-transaction-processing": "xrp-ledger-overview.html#耐検閲性のある取引処理" # Fix 1 link from untranslated software-ecosystem.html: "rippled-server-modes.html#reasons-to-run-a-validator": "rippled-server-modes.html#バリデータを運用する理由" - # Fix 2 links from untranslated xrp-ledger-toml.html: + # Fix 3 links from untranslated xrp-ledger-toml.html: "currency-formats.html#currency-codes": "currency-formats.html#通貨コード" "run-rippled-as-a-validator.html#1-understand-the-traits-of-a-good-validator": "run-rippled-as-a-validator.html#1-優れたバリデータの特徴の理解" + "run-rippled-as-a-validator.html#revoke-validator-keys": "run-rippled-as-a-validator.html#バリデータキーの破棄" # Fix 1 link from untranslated snippet post-rippled-install.md: "get-started-with-the-rippled-api.html#commandline": "get-started-with-the-rippled-api.html#コマンドライン" # Fix 8 links from untranslated use-an-escrow-as-a-smart-contract.html: