diff --git a/content/references/xrp-ledger-toml.md b/content/references/xrp-ledger-toml.md index 549a5c2b13..4c1fb3395f 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" @@ -280,16 +284,57 @@ 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](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 example.com + + +Sample Output: + +``` +The domain name has been set to: example.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== +``` + +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. + + + + +**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 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: