mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-21 20:25:51 +00:00
mark 0.31.0 features as new
This commit is contained in:
@@ -132,6 +132,7 @@
|
|||||||
<main class="main" role="main">
|
<main class="main" role="main">
|
||||||
<div class="content">
|
<div class="content">
|
||||||
<h1 id="amendments">Amendments</h1>
|
<h1 id="amendments">Amendments</h1>
|
||||||
|
<p><em>(New in <a href="https://wiki.ripple.com/Rippled-0.31.0">version 0.31.0</a>)</em></p>
|
||||||
<p>The Amendments system provides a means of introducing new features to the decentralized Ripple consensus network without causing disruptions. The amendments system works by utilizing the core consensus process of the network to approve any changes by showing continuous support before those changes go into effect. An amendment normally requires <strong>80% support for two weeks</strong> before it can apply.</p>
|
<p>The Amendments system provides a means of introducing new features to the decentralized Ripple consensus network without causing disruptions. The amendments system works by utilizing the core consensus process of the network to approve any changes by showing continuous support before those changes go into effect. An amendment normally requires <strong>80% support for two weeks</strong> before it can apply.</p>
|
||||||
<p>When an Amendment has been enabled, it applies permanently to all ledger versions after the one that included it. You cannot disable an Amendment, unless you introduce a new Amendment to do so.</p>
|
<p>When an Amendment has been enabled, it applies permanently to all ledger versions after the one that included it. You cannot disable an Amendment, unless you introduce a new Amendment to do so.</p>
|
||||||
<h2 id="background">Background</h2>
|
<h2 id="background">Background</h2>
|
||||||
@@ -212,15 +213,16 @@ TrustSetAuth
|
|||||||
<tr>
|
<tr>
|
||||||
<td><a href="#multisign">MultiSign</a></td>
|
<td><a href="#multisign">MultiSign</a></td>
|
||||||
<td>v0.31.0</td>
|
<td>v0.31.0</td>
|
||||||
<td>Expected 2016-04-18</td>
|
<td>TBD</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td><a href="#feeescalation">FeeEscalation</a></td>
|
<td><a href="#feeescalation">FeeEscalation</a></td>
|
||||||
<td>v0.31.0</td>
|
<td>v0.31.0</td>
|
||||||
<td>Expected 2016-04-11</td>
|
<td>TBD</td>
|
||||||
</tr>
|
</tr>
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
|
<p><strong>Note:</strong> In many cases, an incomplete version of the code for an amendment is present in previous versions of the software. The "Introduced" version in the table above is the first stable version.</p>
|
||||||
<h2 id="feeescalation">FeeEscalation</h2>
|
<h2 id="feeescalation">FeeEscalation</h2>
|
||||||
<table>
|
<table>
|
||||||
<thead>
|
<thead>
|
||||||
|
|||||||
@@ -1,5 +1,7 @@
|
|||||||
# Amendments #
|
# Amendments #
|
||||||
|
|
||||||
|
_(New in [version 0.31.0](https://wiki.ripple.com/Rippled-0.31.0))_
|
||||||
|
|
||||||
The Amendments system provides a means of introducing new features to the decentralized Ripple consensus network without causing disruptions. The amendments system works by utilizing the core consensus process of the network to approve any changes by showing continuous support before those changes go into effect. An amendment normally requires **80% support for two weeks** before it can apply.
|
The Amendments system provides a means of introducing new features to the decentralized Ripple consensus network without causing disruptions. The amendments system works by utilizing the core consensus process of the network to approve any changes by showing continuous support before those changes go into effect. An amendment normally requires **80% support for two weeks** before it can apply.
|
||||||
|
|
||||||
When an Amendment has been enabled, it applies permanently to all ledger versions after the one that included it. You cannot disable an Amendment, unless you introduce a new Amendment to do so.
|
When an Amendment has been enabled, it applies permanently to all ledger versions after the one that included it. You cannot disable an Amendment, unless you introduce a new Amendment to do so.
|
||||||
@@ -96,8 +98,10 @@ The following is a comprehensive list of all known amendments and their status o
|
|||||||
| [Tickets](#tickets) | v0.31.0 | TBD |
|
| [Tickets](#tickets) | v0.31.0 | TBD |
|
||||||
| [SusPay](#suspay) | v0.31.0 | TBD |
|
| [SusPay](#suspay) | v0.31.0 | TBD |
|
||||||
| [TrustSetAuth](#trustsetauth) | v0.30.0 | TBD |
|
| [TrustSetAuth](#trustsetauth) | v0.30.0 | TBD |
|
||||||
| [MultiSign](#multisign) | v0.31.0 | Expected 2016-04-18 |
|
| [MultiSign](#multisign) | v0.31.0 | TBD |
|
||||||
| [FeeEscalation](#feeescalation) | v0.31.0 | Expected 2016-04-11 |
|
| [FeeEscalation](#feeescalation) | v0.31.0 | TBD |
|
||||||
|
|
||||||
|
**Note:** In many cases, an incomplete version of the code for an amendment is present in previous versions of the software. The "Introduced" version in the table above is the first stable version.
|
||||||
|
|
||||||
## FeeEscalation ##
|
## FeeEscalation ##
|
||||||
|
|
||||||
|
|||||||
@@ -408,7 +408,7 @@ The `index` of a RippleState node is the SHA-512Half of the following values put
|
|||||||
## SignerList ##
|
## SignerList ##
|
||||||
[[Source]<br>](https://github.com/ripple/rippled/blob/6d2e3da30696bd10e3bb11a5ff6d45d2c4dae90f/src/ripple/protocol/impl/LedgerFormats.cpp#L127 "Source")
|
[[Source]<br>](https://github.com/ripple/rippled/blob/6d2e3da30696bd10e3bb11a5ff6d45d2c4dae90f/src/ripple/protocol/impl/LedgerFormats.cpp#L127 "Source")
|
||||||
|
|
||||||
The `SignerList` node type represents a list of parties that, as a group, are authorized to sign a transaction in place of an individual account.
|
The `SignerList` node type represents a list of parties that, as a group, are authorized to sign a transaction in place of an individual account. This node type is introduced by the [MultiSign amendment](concept-amendments.html#multisign). _(New in [version 0.31.0][])_
|
||||||
|
|
||||||
Example SignerList node:
|
Example SignerList node:
|
||||||
|
|
||||||
|
|||||||
@@ -6304,7 +6304,7 @@ __*Caution:*__ If this command results in an error messages, the message can con
|
|||||||
|
|
||||||
The `sign_for` command provides one signature for a [multi-signed transaction](reference-transaction-format.html#multi-signing).
|
The `sign_for` command provides one signature for a [multi-signed transaction](reference-transaction-format.html#multi-signing).
|
||||||
|
|
||||||
This command requires the [MultiSign amendment](concept-amendments.html#multisign) to be enabled.
|
This command requires the [MultiSign amendment](concept-amendments.html#multisign) to be enabled. _(New in [version 0.31.0][])_
|
||||||
|
|
||||||
#### Request Format ####
|
#### Request Format ####
|
||||||
An example of the request format:
|
An example of the request format:
|
||||||
@@ -6766,7 +6766,7 @@ __*Caution:*__ If this command results in an error messages, the message can con
|
|||||||
|
|
||||||
The `submit_multisigned` command applies a [multi-signed](reference-transaction-format.html#multi-signing) transaction and sends it to the network to be included in future ledgers. (You can also submit multi-signed transactions in binary form using the [`submit` command in submit-only mode](#submit-only-mode).)
|
The `submit_multisigned` command applies a [multi-signed](reference-transaction-format.html#multi-signing) transaction and sends it to the network to be included in future ledgers. (You can also submit multi-signed transactions in binary form using the [`submit` command in submit-only mode](#submit-only-mode).)
|
||||||
|
|
||||||
This command requires the [MultiSign amendment](concept-amendments.html#multisign) to be enabled.
|
This command requires the [MultiSign amendment](concept-amendments.html#multisign) to be enabled. _(New in [version 0.31.0][])_
|
||||||
|
|
||||||
#### Request Format ####
|
#### Request Format ####
|
||||||
An example of the request format:
|
An example of the request format:
|
||||||
@@ -8830,7 +8830,7 @@ The fields describing a fetch in progress are subject to change without notice.
|
|||||||
## feature ##
|
## feature ##
|
||||||
[[Source]<br>](https://github.com/ripple/rippled/blob/develop/src/ripple/rpc/handlers/Feature1.cpp "Source")
|
[[Source]<br>](https://github.com/ripple/rippled/blob/develop/src/ripple/rpc/handlers/Feature1.cpp "Source")
|
||||||
|
|
||||||
The `feature` command returns information about [amendments](concept-amendments.html) this server knows about, including whether they are enabled and whether the server is voting in favor of those amendments in the [amendment process](concept-amendments.html#amendment-process).
|
The `feature` command returns information about [amendments](concept-amendments.html) this server knows about, including whether they are enabled and whether the server is voting in favor of those amendments in the [amendment process](concept-amendments.html#amendment-process). _(New in [version 0.31.0][])_
|
||||||
|
|
||||||
You can use the `feature` command to temporarily configure the server to vote against or in favor of an amendment. This change does not persist if you restart the server. To make lasting changes in amendment voting, use the `rippled.cfg` file. See [Configuring Amendment Voting](concept-amendments.html#configuring-amendment-voting) for more information.
|
You can use the `feature` command to temporarily configure the server to vote against or in favor of an amendment. This change does not persist if you restart the server. To make lasting changes in amendment voting, use the `rippled.cfg` file. See [Configuring Amendment Voting](concept-amendments.html#configuring-amendment-voting) for more information.
|
||||||
|
|
||||||
|
|||||||
@@ -792,7 +792,7 @@ Transactions of the TrustSet type support additional values in the [`Flags` fiel
|
|||||||
## SignerListSet ##
|
## SignerListSet ##
|
||||||
[[Source]<br>](https://github.com/ripple/rippled/blob/ef511282709a6a0721b504c6b7703f9de3eecf38/src/ripple/app/tx/impl/SetSignerList.cpp "Source")
|
[[Source]<br>](https://github.com/ripple/rippled/blob/ef511282709a6a0721b504c6b7703f9de3eecf38/src/ripple/app/tx/impl/SetSignerList.cpp "Source")
|
||||||
|
|
||||||
The SignerListSet transaction creates, modifies, or removes a list of signers that can be used to [multi-sign](#multi-signing) a transaction.
|
The SignerListSet transaction creates, replaces, or removes a list of signers that can be used to [multi-sign](#multi-signing) a transaction. This transaction type is introduced by the [MultiSign amendment](concept-amendments.html#multisign). _(New in [version 0.31.0][])_
|
||||||
|
|
||||||
Example SignerListSet:
|
Example SignerListSet:
|
||||||
|
|
||||||
|
|||||||
@@ -20,7 +20,7 @@ To use multi-signing:
|
|||||||
Availability of Multi-Signing
|
Availability of Multi-Signing
|
||||||
-----------------------------
|
-----------------------------
|
||||||
|
|
||||||
Multi-signing is built into `rippled` starting with version **0.31.0**. Because multi-signing is a change in transaction processing, the change is due to be enabled by an **Amendment** to the Ripple Consensus Protocol. This Amendment must be approved by a consensus of validators showing consistent support for the feature over a period of time. For more information, see [Amendments](concept-amendments.html).
|
Multi-signing is built into `rippled` starting with [version 0.31.0](https://wiki.ripple.com/Rippled-0.31.0). Because multi-signing is a change in transaction processing, the change is due to be enabled by an **Amendment** to the Ripple Consensus Protocol. This Amendment must be approved by a consensus of validators showing consistent support for the feature over a period of time. For more information, see [Amendments](concept-amendments.html).
|
||||||
|
|
||||||
If you want to test multi-signing before it becomes available in the production network, or without risking real money, you can do so by running `rippled` in [stand-alone mode](concept-stand-alone-mode.html) with the MultiSign feature enabled. To enable multi-signing for testing, add the following stanza to your `rippled.cfg`:
|
If you want to test multi-signing before it becomes available in the production network, or without risking real money, you can do so by running `rippled` in [stand-alone mode](concept-stand-alone-mode.html) with the MultiSign feature enabled. To enable multi-signing for testing, add the following stanza to your `rippled.cfg`:
|
||||||
|
|
||||||
|
|||||||
@@ -985,7 +985,7 @@
|
|||||||
</ul>
|
</ul>
|
||||||
<h2 id="signerlist">SignerList</h2>
|
<h2 id="signerlist">SignerList</h2>
|
||||||
<p><a href="https://github.com/ripple/rippled/blob/6d2e3da30696bd10e3bb11a5ff6d45d2c4dae90f/src/ripple/protocol/impl/LedgerFormats.cpp#L127" title="Source">[Source]<br/></a></p>
|
<p><a href="https://github.com/ripple/rippled/blob/6d2e3da30696bd10e3bb11a5ff6d45d2c4dae90f/src/ripple/protocol/impl/LedgerFormats.cpp#L127" title="Source">[Source]<br/></a></p>
|
||||||
<p>The <code>SignerList</code> node type represents a list of parties that, as a group, are authorized to sign a transaction in place of an individual account.</p>
|
<p>The <code>SignerList</code> node type represents a list of parties that, as a group, are authorized to sign a transaction in place of an individual account. This node type is introduced by the <a href="concept-amendments.html#multisign">MultiSign amendment</a>. <em>(New in [version 0.31.0][])</em></p>
|
||||||
<p>Example SignerList node:</p>
|
<p>Example SignerList node:</p>
|
||||||
<pre><code>{
|
<pre><code>{
|
||||||
"Flags": 0,
|
"Flags": 0,
|
||||||
|
|||||||
@@ -7326,7 +7326,7 @@ rippled sign sssssssssssssssssssssssssssss '{"TransactionType": "Payment", "Acco
|
|||||||
<h2 id="sign-for">sign_for</h2>
|
<h2 id="sign-for">sign_for</h2>
|
||||||
<p><a href="https://github.com/ripple/rippled/blob/release/src/ripple/rpc/handlers/SignFor.cpp" title="Source">[Source]<br/></a></p>
|
<p><a href="https://github.com/ripple/rippled/blob/release/src/ripple/rpc/handlers/SignFor.cpp" title="Source">[Source]<br/></a></p>
|
||||||
<p>The <code>sign_for</code> command provides one signature for a <a href="reference-transaction-format.html#multi-signing">multi-signed transaction</a>.</p>
|
<p>The <code>sign_for</code> command provides one signature for a <a href="reference-transaction-format.html#multi-signing">multi-signed transaction</a>.</p>
|
||||||
<p>This command requires the <a href="concept-amendments.html#multisign">MultiSign amendment</a> to be enabled.</p>
|
<p>This command requires the <a href="concept-amendments.html#multisign">MultiSign amendment</a> to be enabled. <em>(New in <a href="https://wiki.ripple.com/Rippled-0.31.0">version 0.31.0</a>)</em></p>
|
||||||
<h4 id="request-format-24">Request Format</h4>
|
<h4 id="request-format-24">Request Format</h4>
|
||||||
<p>An example of the request format:</p>
|
<p>An example of the request format:</p>
|
||||||
<div class="multicode">
|
<div class="multicode">
|
||||||
@@ -7845,7 +7845,7 @@ submit sssssssssssssssssssssssssssss '{"TransactionType":"Payment", "Account":"r
|
|||||||
<h2 id="submit-multisigned">submit_multisigned</h2>
|
<h2 id="submit-multisigned">submit_multisigned</h2>
|
||||||
<p><a href="https://github.com/ripple/rippled/blob/release/src/ripple/rpc/handlers/SubmitMultiSigned.cpp" title="Source">[Source]<br/></a></p>
|
<p><a href="https://github.com/ripple/rippled/blob/release/src/ripple/rpc/handlers/SubmitMultiSigned.cpp" title="Source">[Source]<br/></a></p>
|
||||||
<p>The <code>submit_multisigned</code> command applies a <a href="reference-transaction-format.html#multi-signing">multi-signed</a> transaction and sends it to the network to be included in future ledgers. (You can also submit multi-signed transactions in binary form using the <a href="#submit-only-mode"><code>submit</code> command in submit-only mode</a>.)</p>
|
<p>The <code>submit_multisigned</code> command applies a <a href="reference-transaction-format.html#multi-signing">multi-signed</a> transaction and sends it to the network to be included in future ledgers. (You can also submit multi-signed transactions in binary form using the <a href="#submit-only-mode"><code>submit</code> command in submit-only mode</a>.)</p>
|
||||||
<p>This command requires the <a href="concept-amendments.html#multisign">MultiSign amendment</a> to be enabled.</p>
|
<p>This command requires the <a href="concept-amendments.html#multisign">MultiSign amendment</a> to be enabled. <em>(New in <a href="https://wiki.ripple.com/Rippled-0.31.0">version 0.31.0</a>)</em></p>
|
||||||
<h4 id="request-format-27">Request Format</h4>
|
<h4 id="request-format-27">Request Format</h4>
|
||||||
<p>An example of the request format:</p>
|
<p>An example of the request format:</p>
|
||||||
<div class="multicode">
|
<div class="multicode">
|
||||||
@@ -10377,7 +10377,7 @@ Connecting to 127.0.0.1:5005
|
|||||||
</ul>
|
</ul>
|
||||||
<h2 id="feature">feature</h2>
|
<h2 id="feature">feature</h2>
|
||||||
<p><a href="https://github.com/ripple/rippled/blob/develop/src/ripple/rpc/handlers/Feature1.cpp" title="Source">[Source]<br/></a></p>
|
<p><a href="https://github.com/ripple/rippled/blob/develop/src/ripple/rpc/handlers/Feature1.cpp" title="Source">[Source]<br/></a></p>
|
||||||
<p>The <code>feature</code> command returns information about <a href="concept-amendments.html">amendments</a> this server knows about, including whether they are enabled and whether the server is voting in favor of those amendments in the <a href="concept-amendments.html#amendment-process">amendment process</a>.</p>
|
<p>The <code>feature</code> command returns information about <a href="concept-amendments.html">amendments</a> this server knows about, including whether they are enabled and whether the server is voting in favor of those amendments in the <a href="concept-amendments.html#amendment-process">amendment process</a>. <em>(New in <a href="https://wiki.ripple.com/Rippled-0.31.0">version 0.31.0</a>)</em></p>
|
||||||
<p>You can use the <code>feature</code> command to temporarily configure the server to vote against or in favor of an amendment. This change does not persist if you restart the server. To make lasting changes in amendment voting, use the <code>rippled.cfg</code> file. See <a href="concept-amendments.html#configuring-amendment-voting">Configuring Amendment Voting</a> for more information.</p>
|
<p>You can use the <code>feature</code> command to temporarily configure the server to vote against or in favor of an amendment. This change does not persist if you restart the server. To make lasting changes in amendment voting, use the <code>rippled.cfg</code> file. See <a href="concept-amendments.html#configuring-amendment-voting">Configuring Amendment Voting</a> for more information.</p>
|
||||||
<p><em>The <code>feature</code> method is an <a href="#connecting-to-rippled">admin command</a> that cannot be run by unpriviledged users.</em></p>
|
<p><em>The <code>feature</code> method is an <a href="#connecting-to-rippled">admin command</a> that cannot be run by unpriviledged users.</em></p>
|
||||||
<h4 id="request-format-36">Request Format</h4>
|
<h4 id="request-format-36">Request Format</h4>
|
||||||
|
|||||||
@@ -1210,7 +1210,7 @@
|
|||||||
</table>
|
</table>
|
||||||
<h2 id="signerlistset">SignerListSet</h2>
|
<h2 id="signerlistset">SignerListSet</h2>
|
||||||
<p><a href="https://github.com/ripple/rippled/blob/ef511282709a6a0721b504c6b7703f9de3eecf38/src/ripple/app/tx/impl/SetSignerList.cpp" title="Source">[Source]<br/></a></p>
|
<p><a href="https://github.com/ripple/rippled/blob/ef511282709a6a0721b504c6b7703f9de3eecf38/src/ripple/app/tx/impl/SetSignerList.cpp" title="Source">[Source]<br/></a></p>
|
||||||
<p>The SignerListSet transaction creates, modifies, or removes a list of signers that can be used to <a href="#multi-signing">multi-sign</a> a transaction.</p>
|
<p>The SignerListSet transaction creates, replaces, or removes a list of signers that can be used to <a href="#multi-signing">multi-sign</a> a transaction. This transaction type is introduced by the <a href="concept-amendments.html#multisign">MultiSign amendment</a>. <em>(New in [version 0.31.0][])</em></p>
|
||||||
<p>Example SignerListSet:</p>
|
<p>Example SignerListSet:</p>
|
||||||
<pre><code>{
|
<pre><code>{
|
||||||
"Flags": 0,
|
"Flags": 0,
|
||||||
|
|||||||
@@ -142,7 +142,7 @@
|
|||||||
<li><a href="#sending-a-multi-signed-transaction">Send transactions using multiple signatures.</a></li>
|
<li><a href="#sending-a-multi-signed-transaction">Send transactions using multiple signatures.</a></li>
|
||||||
</ol>
|
</ol>
|
||||||
<h2 id="availability-of-multi-signing">Availability of Multi-Signing</h2>
|
<h2 id="availability-of-multi-signing">Availability of Multi-Signing</h2>
|
||||||
<p>Multi-signing is built into <code>rippled</code> starting with version <strong>0.31.0</strong>. Because multi-signing is a change in transaction processing, the change is due to be enabled by an <strong>Amendment</strong> to the Ripple Consensus Protocol. This Amendment must be approved by a consensus of validators showing consistent support for the feature over a period of time. For more information, see <a href="concept-amendments.html">Amendments</a>.</p>
|
<p>Multi-signing is built into <code>rippled</code> starting with <a href="https://wiki.ripple.com/Rippled-0.31.0">version 0.31.0</a>. Because multi-signing is a change in transaction processing, the change is due to be enabled by an <strong>Amendment</strong> to the Ripple Consensus Protocol. This Amendment must be approved by a consensus of validators showing consistent support for the feature over a period of time. For more information, see <a href="concept-amendments.html">Amendments</a>.</p>
|
||||||
<p>If you want to test multi-signing before it becomes available in the production network, or without risking real money, you can do so by running <code>rippled</code> in <a href="concept-stand-alone-mode.html">stand-alone mode</a> with the MultiSign feature enabled. To enable multi-signing for testing, add the following stanza to your <code>rippled.cfg</code>:</p>
|
<p>If you want to test multi-signing before it becomes available in the production network, or without risking real money, you can do so by running <code>rippled</code> in <a href="concept-stand-alone-mode.html">stand-alone mode</a> with the MultiSign feature enabled. To enable multi-signing for testing, add the following stanza to your <code>rippled.cfg</code>:</p>
|
||||||
<pre><code>[features]
|
<pre><code>[features]
|
||||||
MultiSign
|
MultiSign
|
||||||
|
|||||||
Reference in New Issue
Block a user