From dd938439c632722b1b27c9b5407af43f7d46b9c2 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Wed, 10 Oct 2018 15:39:29 -0700 Subject: [PATCH 1/4] Known Amendments: Update DepositPreauth, fix1515 status --- content/news/known-amendments.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/news/known-amendments.md b/content/news/known-amendments.md index f2f85d0821..cf9600a0fd 100644 --- a/content/news/known-amendments.md +++ b/content/news/known-amendments.md @@ -5,14 +5,14 @@ The following is a comprehensive list of all known amendments and their status o | Name | Introduced | Status | |:--------------------------|:-----------|:------------------------------------| -| [DepositPreauth][] | v1.1.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | -| [fix1515][] | v1.1.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | | [Checks][] | v0.90.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | | [FlowCross][] | v0.70.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | | [CryptoConditionsSuite][] | TBD | [In Development: TBD]( "BADGE_LIGHTGREY") | | [OwnerPaysFee][] | TBD | [In Development: TBD]( "BADGE_LIGHTGREY") | | [SHAMapV2][] | TBD | [In Development: TBD]( "BADGE_LIGHTGREY") | | [Tickets][] | TBD | [In Development: TBD]( "BADGE_LIGHTGREY") | +| [DepositPreauth][] | v1.1.0 | [Enabled: 2018-10-09](https://xrpcharts.ripple.com/#/transactions/AD27403CB840AE67CADDB084BC54249D7BD1B403885819B39CCF723DC671F927 "BADGE_GREEN") | +| [fix1515][] | v1.1.0 | [Enabled: 2018-10-09](https://xrpcharts.ripple.com/#/transactions/6DF60D9EC8AF3C39B173840F4D1C57F8A8AB51E7C6571483B4A5F1AA0A9AAEBF "BADGE_GREEN") | | [fix1543][] | v1.0.0 | [Enabled: 2018-06-21](https://xrpcharts.ripple.com/#/transactions/EA6054C9D256657014052F1447216CEA75FFDB1C9342D45EB0F9E372C0F879E6 "BADGE_GREEN") | | [fix1623][] | v1.0.0 | [Enabled: 2018-06-20](https://xrpcharts.ripple.com/#/transactions/4D218D86A2B33E29F17AA9C25D8DFFEE5D2559F75F7C0B1D016D3F2C2220D3EB "BADGE_GREEN") | | [fix1571][] | v1.0.0 | [Enabled: 2018-06-19](https://xrpcharts.ripple.com/#/transactions/920AA493E57D991414B614FB3C1D1E2F863211B48129D09BC8CB74C9813C38FC "BADGE_GREEN") | @@ -98,7 +98,7 @@ Also fixes a bug in the EscrowCreate and PaymentChannelCreate transactions where | Amendment ID | Status | |:-----------------------------------------------------------------|:----------| -| 3CBC5C4E630A1B82380295CDA84B32B49DD066602E74E39B85EF64137FA65194 | In Development | +| 3CBC5C4E630A1B82380295CDA84B32B49DD066602E74E39B85EF64137FA65194 | Enabled | Provides users of [deposit authorization](depositauth.html) with a way to preauthorize specific senders so those senders are allowed to send payments directly. @@ -222,7 +222,7 @@ With this amendment, the new `STAmountCalcSwitchovers` code applies, which may c | Amendment ID | Status | |:-----------------------------------------------------------------|:----------| -| 5D08145F0A4983F23AFFFF514E83FAD355C5ABFBB6CAB76FB5BC8519FF5F33BE | Planned | +| 5D08145F0A4983F23AFFFF514E83FAD355C5ABFBB6CAB76FB5BC8519FF5F33BE | Enabled | Changes how Payment transactions consume offers to remove a minor difference in how payment processing and offer processing consume liquidity. (Also affects how OfferCreate transactions are processed if [FlowCross][] is enabled.) From 05e6c45fa3383118f6f55b787784ec5d1b50ddfd Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Thu, 11 Oct 2018 13:35:36 -0700 Subject: [PATCH 2/4] Remove links to old Ripple Wiki. - amended to reword the TLS cert message in accountset --- content/references/data-api.md | 2 +- .../transaction-formats/transaction-types/accountset.md | 6 +++++- .../load-a-saved-ledger-in-stand-alone-mode.md | 6 ++++-- .../start-a-new-genesis-ledger-in-stand-alone-mode.md | 4 +++- .../xrp-ledger-businesses/become-an-xrp-ledger-gateway.md | 4 +--- 5 files changed, 14 insertions(+), 8 deletions(-) diff --git a/content/references/data-api.md b/content/references/data-api.md index e5d08a0d43..784baf94b9 100644 --- a/content/references/data-api.md +++ b/content/references/data-api.md @@ -3360,7 +3360,7 @@ A successful response uses the HTTP code **200 OK** and has a JSON body with the | `start_date` | String - [Timestamp][] | The approximate date of the first time exchanges for this gateway's currencies appeared in the ledger. | | `accounts` | Array | A list of [issuing addresses](issuing-and-operational-addresses.html) used by this gateway. (Gateways may use different issuing accounts for different currencies.) | | `hotwallets` | Array of [Address][]es | This gateway's [operational addresses](issuing-and-operational-addresses.html). | -| `domain` | String | The domain name where this gateway does business. Typically the gateway hosts a [`ripple.txt`](https://wiki.ripple.com/Ripple.txt) there. | +| `domain` | String | The domain name where this gateway does business. | | `normalized` | String | A normalized version of the `name` field suitable for including in URLs. | | `assets` | Array of Strings | Graphics filenames available for this gateway, if any. (Mostly, these are logos used by XRP Charts.) | diff --git a/content/references/rippled-api/transaction-formats/transaction-types/accountset.md b/content/references/rippled-api/transaction-formats/transaction-types/accountset.md index dce08e2ca3..e052d541d0 100644 --- a/content/references/rippled-api/transaction-formats/transaction-types/accountset.md +++ b/content/references/rippled-api/transaction-formats/transaction-types/accountset.md @@ -42,7 +42,11 @@ The `Domain` field is represented as the hex string of the lowercase ASCII of th To remove the `Domain` field from an account, send an AccountSet with the Domain set to an empty string. -Client applications can use the [ripple.txt](https://wiki.ripple.com/Ripple.txt) file hosted by the domain to confirm that the account is actually operated by that domain. +You can put any domain in your account's `Domain` field. To prove that an account truly belongs to the same person or business as a domain, Ripple recommends establishing a "two-way link": + +- Accounts you own should have a domain you own in the `Domain` field. +- A website hosted at that domain should have a text file listing accounts you own, and optionally other information about how you use the XRP Ledger. Conventionally, this file is named `ripple.txt`. For an example, see . + - To prevent man-in-the-middle attacks, this website should be hosted via HTTPS with an up-to-date TLS certificate. ## AccountSet Flags diff --git a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md index 0a41e623c6..27a5837838 100644 --- a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md +++ b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md @@ -38,18 +38,20 @@ rippled stop --conf=/path/to/rippled.cfg ## 5. Start `rippled` in stand-alone mode. -To load the most recent ledger version, you can use the [`-a`](https://wiki.ripple.com/Rippled#--standalone.2C_-a) and [`--load`](https://wiki.ripple.com/Rippled#--load) options when starting the server: +To load the most recent ledger version, you can use the `-a` and `--load` options when starting the server: ``` rippled -a --load --conf=/path/to/rippled.cfg ``` -To instead load a specific historical ledger, use the [`--load`](https://wiki.ripple.com/Rippled#--load) parameter along with the `--ledger` parameter, providing the ledger index or identifying hash of the ledger version to load: +To instead load a specific historical ledger, use the `--load` parameter along with the `--ledger` parameter, providing the ledger index or identifying hash of the ledger version to load: ``` rippled -a --load --ledger 19860944 --conf=/path/to/rippled.cfg ``` +For more information on the options you can use when starting `rippled` in Stand-Alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). + ## 6. Manually advance the ledger. When you load a ledger with `--ledger` in stand-alone mode, it goes to the current open ledger, so you must [manually advance the ledger](advance-the-ledger-in-stand-alone-mode.html): diff --git a/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md b/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md index 463a413a61..1ec85da92e 100644 --- a/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md +++ b/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md @@ -2,12 +2,14 @@ In stand-alone mode, you can have `rippled` create a new genesis ledger. This provides a known state, with none of the ledger history from the production XRP Ledger. (This is very useful for unit tests, among other things.) -* To start `rippled` in stand-alone mode with a new genesis ledger, use the [`-a`](https://wiki.ripple.com/Rippled#--standalone.2C_-a) and [`--start`](https://wiki.ripple.com/Rippled#--start) options: +* To start `rippled` in stand-alone mode with a new genesis ledger, use the `-a` and `--start` options: ``` rippled -a --start --conf=/path/to/rippled.cfg ``` +For more information on the options you can use when starting `rippled` in Stand-Alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). + In a genesis ledger, the [genesis address](accounts.html#special-addresses) holds all 100 billion XRP. The keys of the genesis address are [hardcoded](https://github.com/ripple/rippled/blob/94ed5b3a53077d815ad0dd65d490c8d37a147361/src/ripple/app/ledger/Ledger.cpp#L184) as follows: **Address:** `rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh` diff --git a/content/tutorials/xrp-ledger-businesses/become-an-xrp-ledger-gateway.md b/content/tutorials/xrp-ledger-businesses/become-an-xrp-ledger-gateway.md index f2149e873f..6fae9c1cf6 100644 --- a/content/tutorials/xrp-ledger-businesses/become-an-xrp-ledger-gateway.md +++ b/content/tutorials/xrp-ledger-businesses/become-an-xrp-ledger-gateway.md @@ -841,9 +841,7 @@ For more information, see [Reliable Transaction Submission](reliable-transaction ## ripple.txt -The [ripple.txt](https://wiki.ripple.com/Ripple.txt) standard provides a way to publish information about your gateway so that automated tools and applications can read and understand it. - -For example, if you run a validating `rippled` server, you can use ripple.txt to publish the public key of your validating server. You can also publish information about what currencies your gateway issues, and which XRP Ledger addresses you control, to protect against impostors or confusion. +If you run a `rippled` validator, you can publish the public key of your validating server and other information about what currencies your gateway issues, and which XRP Ledger addresses you control, to protect against impostors or confusion. Conventionally, gateways do this by hosting a file named `ripple.txt` on their website. For an example, see . From bdf73e2ef450690e9d0cfcf8361fbbb9b85a178a Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 12 Oct 2018 12:09:41 -0700 Subject: [PATCH 3/4] Lowercase non-titled instances of 'stand-alone mode' --- content/concepts/consensus-network/amendments.md | 2 +- .../load-a-saved-ledger-in-stand-alone-mode.md | 2 +- .../start-a-new-genesis-ledger-in-stand-alone-mode.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/concepts/consensus-network/amendments.md b/content/concepts/consensus-network/amendments.md index b1270e6eee..70019ac85e 100644 --- a/content/concepts/consensus-network/amendments.md +++ b/content/concepts/consensus-network/amendments.md @@ -221,7 +221,7 @@ To look up which `rippled` version supports these features, see [Known Amendment If you want to see how `rippled` behaves with an amendment enabled, before that amendment gets enabled on the production network, you can run use `rippled`'s configuration file to forcibly enable a feature. This is intended for development purposes only. -Because other members of the consensus network probably do not have the feature enabled, you should not use this feature while connecting to the production network. While testing with features forcibly enabled, you should run `rippled` in [Stand-Alone Mode](rippled-server-modes.html#reasons-to-run-a-rippled-server-in-stand-alone-mode). +Because other members of the consensus network probably do not have the feature enabled, you should not use this feature while connecting to the production network. While testing with features forcibly enabled, you should run `rippled` in [stand-alone mode](rippled-server-modes.html#reasons-to-run-a-rippled-server-in-stand-alone-mode). To forcibly enable a feature, add a `[features]` stanza to your `rippled.cfg` file. In this stanza, add the short names of the features to enable, one per line. For example: diff --git a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md index 27a5837838..9cff00007e 100644 --- a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md +++ b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md @@ -50,7 +50,7 @@ To instead load a specific historical ledger, use the `--load` parameter along w rippled -a --load --ledger 19860944 --conf=/path/to/rippled.cfg ``` -For more information on the options you can use when starting `rippled` in Stand-Alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). +For more information on the options you can use when starting `rippled` in stand-alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). ## 6. Manually advance the ledger. diff --git a/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md b/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md index 1ec85da92e..d19b3b1f0c 100644 --- a/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md +++ b/content/tutorials/manage-the-rippled-server/start-a-new-genesis-ledger-in-stand-alone-mode.md @@ -8,7 +8,7 @@ In stand-alone mode, you can have `rippled` create a new genesis ledger. This pr rippled -a --start --conf=/path/to/rippled.cfg ``` -For more information on the options you can use when starting `rippled` in Stand-Alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). +For more information on the options you can use when starting `rippled` in stand-alone mode, see [Commandline Usage: Stand-Alone Mode Options](commandline-usage.html#stand-alone-mode-options). In a genesis ledger, the [genesis address](accounts.html#special-addresses) holds all 100 billion XRP. The keys of the genesis address are [hardcoded](https://github.com/ripple/rippled/blob/94ed5b3a53077d815ad0dd65d490c8d37a147361/src/ripple/app/ledger/Ledger.cpp#L184) as follows: From 2cc80db995e0a8d8c6f751f955f741d0bb80b4cf Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 12 Oct 2018 13:10:06 -0700 Subject: [PATCH 4/4] Stand-alone mode: Wording nitpick fixes --- .../transaction-formats/transaction-types/accountset.md | 6 +++--- .../load-a-saved-ledger-in-stand-alone-mode.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/references/rippled-api/transaction-formats/transaction-types/accountset.md b/content/references/rippled-api/transaction-formats/transaction-types/accountset.md index e052d541d0..3596f728b5 100644 --- a/content/references/rippled-api/transaction-formats/transaction-types/accountset.md +++ b/content/references/rippled-api/transaction-formats/transaction-types/accountset.md @@ -42,11 +42,11 @@ The `Domain` field is represented as the hex string of the lowercase ASCII of th To remove the `Domain` field from an account, send an AccountSet with the Domain set to an empty string. -You can put any domain in your account's `Domain` field. To prove that an account truly belongs to the same person or business as a domain, Ripple recommends establishing a "two-way link": +You can put any domain in your account's `Domain` field. To prove that an account and domain belong to the same person or business, Ripple recommends establishing a "two-way link": - Accounts you own should have a domain you own in the `Domain` field. -- A website hosted at that domain should have a text file listing accounts you own, and optionally other information about how you use the XRP Ledger. Conventionally, this file is named `ripple.txt`. For an example, see . - - To prevent man-in-the-middle attacks, this website should be hosted via HTTPS with an up-to-date TLS certificate. +- On a website at that domain, host a text file listing accounts you own, and optionally other information about how you use the XRP Ledger. Conventionally, this file is named `ripple.txt`. For an example, see . + **Caution:** To prevent man-in-the-middle attacks, serve your website using HTTPS with an up-to-date TLS certificate. ## AccountSet Flags diff --git a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md index 9cff00007e..a194ac6cf9 100644 --- a/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md +++ b/content/tutorials/manage-the-rippled-server/load-a-saved-ledger-in-stand-alone-mode.md @@ -38,13 +38,13 @@ rippled stop --conf=/path/to/rippled.cfg ## 5. Start `rippled` in stand-alone mode. -To load the most recent ledger version, you can use the `-a` and `--load` options when starting the server: +To load the most recent ledger version, start the server with the `-a` and `--load` options: ``` rippled -a --load --conf=/path/to/rippled.cfg ``` -To instead load a specific historical ledger, use the `--load` parameter along with the `--ledger` parameter, providing the ledger index or identifying hash of the ledger version to load: +To load a specific historical ledger, start the server with the `--load` parameter along with the `--ledger` parameter, providing the ledger index or identifying hash of the ledger version to load: ``` rippled -a --load --ledger 19860944 --conf=/path/to/rippled.cfg