amendments - add FlowV2

concept-amendments.html

@@ -151,6 +151,7 @@
 <li class="level-2"><a href="#testing-amendments">Testing Amendments</a></li>
 <li class="level-1"><a href="#known-amendments">Known Amendments</a></li>
 <li class="level-2"><a href="#feeescalation">FeeEscalation</a></li>
+<li class="level-2"><a href="#flowv2">FlowV2</a></li>
 <li class="level-2"><a href="#multisign">MultiSign</a></li>
 <li class="level-2"><a href="#suspay">SusPay</a></li>
 <li class="level-2"><a href="#trustsetauth">TrustSetAuth</a></li>
@@ -227,6 +228,11 @@ TrustSetAuth
 </thead>
 <tbody>
 <tr>
+<td><a href="#flowv2">FlowV2</a></td>
+<td>v0.32.1</td>
+<td>Expected 2016-08-24</td>
+</tr>
+<tr>
 <td><a href="#tickets">Tickets</a></td>
 <td>v0.31.0</td>
 <td>TBD</td>
@@ -278,6 +284,23 @@ TrustSetAuth
 <li>It becomes invalid (for example, the <a href="reference-transaction-format.html#lastledgersequence"><code>LastLedgerSequence</code></a> causes it to expire)</li>
 <li>It gets dropped because there are too many transactions in the queue with a higher transaction cost.</li>
 </ul>
+<h2 id="flowv2">FlowV2</h2>
+<table>
+<thead>
+<tr>
+<th>Amendment ID</th>
+<th>Status</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>5CC22CFF2864B020BD79E0E1F048F63EF3594F95E650E43B3F837EF1DF5F4B26</td>
+<td>Planned for voting, expected to be enabled 2016-08-24</td>
+</tr>
+</tbody>
+</table>
+<p>Replaces the payment processing engine with a complete rewrite. The new version of the payment processing engine is intended to follow the same rules as the old one, but occasionally produces different results due to floating point rounding.</p>
+<p>FlowV2 also fixes an inconsistency in the way <a href="concept-transfer-fees.html">transfer fees</a> are calculated between OfferCreate and Payment transaction types. In the old payment processing engine, the initial sender of a transaction paid the transfer fees for offers that were executed as part of payment processing, but the holder of the issuances paid the transfer fee if an offer was executed in offer placement. With FlowV2, the holder of the issuances always pays the transfer fee, regardless of whether the offer is executed as part of a Payment or an OfferCreate transaction. Offer processing outside of payments is unaffected.</p>
 <h2 id="multisign">MultiSign</h2>
 <table>
 <thead>

concept-transfer-fees.html

@@ -161,6 +161,7 @@
 <p>The following diagram shows a Ripple payment of 2 EUR.ACME from Alice to Charlie with a transfer fee of 1%:</p>
 <p><img alt="Alice sends 2,02€, Charlie receives 2,00€, and ACME owes 0,02€ less in Ripple" src="img/e2g-with_transferrate.png"/></p>
 <h2 id="transfer-fees-in-payment-paths">Transfer Fees in Payment Paths</h2>
+<!-- -->
 <p>A transfer fee applies whenever an individual transfer would shift issuances from one party to another through the issuing account. In more complex transactions, this can occur multiple times. Transfer fees apply starting from the end and working backwards, so that ultimately the sender of a payment must send enough to account for all fees. For example:</p>
 <p><img alt="Diagram of cross-currency payment with transfer fees" src="img/transfer_fees_example.png"/></p>
 <p>In this scenario, Salazar (the sender) holds EUR issued by ACME, and wants to deliver 100 USD issued by WayGate to Rosa (the recipient). FXMaker is a currency trader with the best offer in the order book, at a rate of 1 USD.WayGate for every 0.9 EUR.ACME. If there were no transfer fees, Salazar could deliver 100 USD to Rosa by sending 90 EUR. However, ACME has a transfer fee of 1% and WayGate has a transfer fee of 0.2%. This means:</p>

content/concept-amendments.md

@@ -95,6 +95,7 @@ The following is a comprehensive list of all known amendments and their status o
 
 | Name                            | Introduced | Enabled |
 |---------------------------------|------------|---------|
+| [FlowV2](#flowv2)               | v0.32.1    | Expected 2016-08-24 |
 | [Tickets](#tickets)             | v0.31.0    | TBD |
 | [SusPay](#suspay)               | v0.31.0    | TBD |
 | [TrustSetAuth](#trustsetauth)   | v0.30.0    | Expected 2016-07-19 |
@@ -121,6 +122,16 @@ A transaction remains in the queue until one of the following happens:
 * It becomes invalid (for example, the [`LastLedgerSequence`](reference-transaction-format.html#lastledgersequence) causes it to expire)
 * It gets dropped because there are too many transactions in the queue with a higher transaction cost.
 
+## FlowV2 ##
+
+| Amendment ID | Status |
+|--------------|--------|
+| 5CC22CFF2864B020BD79E0E1F048F63EF3594F95E650E43B3F837EF1DF5F4B26 | Planned for voting, expected to be enabled 2016-08-24 |
+
+Replaces the payment processing engine with a complete rewrite. The new version of the payment processing engine is intended to follow the same rules as the old one, but occasionally produces different results due to floating point rounding.
+
+FlowV2 also fixes an inconsistency in the way [transfer fees](concept-transfer-fees.html) are calculated between OfferCreate and Payment transaction types. In the old payment processing engine, the initial sender of a transaction paid the transfer fees for offers that were executed as part of payment processing, but the holder of the issuances paid the transfer fee if an offer was executed in offer placement. With FlowV2, the holder of the issuances always pays the transfer fee, regardless of whether the offer is executed as part of a Payment or an OfferCreate transaction. Offer processing outside of payments is unaffected.
+
 ## MultiSign ##
 
 | Amendment ID | Status |

content/concept-transfer-fees.md

@@ -15,6 +15,8 @@ The following diagram shows a Ripple payment of 2 EUR.ACME from Alice to Charlie
 
 ## Transfer Fees in Payment Paths ##
 
+<!--{# TODO: Update this for FlowV2? #}-->
+
 A transfer fee applies whenever an individual transfer would shift issuances from one party to another through the issuing account. In more complex transactions, this can occur multiple times. Transfer fees apply starting from the end and working backwards, so that ultimately the sender of a payment must send enough to account for all fees. For example:
 
 ![Diagram of cross-currency payment with transfer fees](img/transfer_fees_example.png)