update docs to 1.19

Author: gimre-xymcity

ApiBeautifier.py

@@ -207,7 +207,7 @@ def adjust(level):
         # while len(parents) != level:
         #	addObj('')
 
-    soup = BeautifulSoup(open('NisApi.src.html'))
+    soup = BeautifulSoup(open('NisApi.src.html'), 'html.parser')
     for header in soup.findAll(['h1', 'h2', 'h3']):
         c = header.contents[0]
         header['id'] = prettyName(c)
@@ -222,7 +222,7 @@ def adjust(level):
 
     e = soup.find(id='toc')
     e.clear()
-    newtoc = BeautifulSoup(printToc(toc['root']))
+    newtoc = BeautifulSoup(printToc(toc['root']), 'html.parser')
     if 'html' in newtoc:
         e.contents = newtoc.html.body.contents
     else:

ApiBeautifier3.py

@@ -207,7 +207,7 @@ def adjust(level):
         # while len(parents) != level:
         #	addObj('')
 
-    soup = BeautifulSoup(open('NisApi.src.html'))
+    soup = BeautifulSoup(open('NisApi.src.html'), 'html.parser')
     for header in soup.findAll(['h1', 'h2', 'h3']):
         c = header.contents[0]
         header['id'] = prettyName(c)
@@ -222,7 +222,7 @@ def adjust(level):
 
     e = soup.find(id='toc')
     e.clear()
-    newtoc = BeautifulSoup(printToc(toc['root']))
+    newtoc = BeautifulSoup(printToc(toc['root']), 'html.parser')
     if 'html' in newtoc:
         e.contents = newtoc.html.body.contents
     else:

NisApi.src.html

@@ -15,7 +15,7 @@
 
     <p class=NemTitleText>NEM NIS API Documentation</p>
 
-    <p class=NemSubtitle>Version 1.18</p>
+    <p class=NemSubtitle>Version 1.19</p>
 
     <p class=NemSubtitle>
         <time>FILLED AUTOMATICALLY</time>
@@ -35,6 +35,10 @@
 
     <hr/>
     <div>
+        <h4>Changes since 1.18</h4>
+        <ul>
+            <li>Updated the fee table.</li>
+        </ul>
         <h4>Changes since 1.17</h4>
         <ul>
             <li>Corrected the API paths for the namespace and mosaic requests in several places.</li>
@@ -1527,9 +1531,9 @@ <h4>Example of returned JSON object:</h4>
     <resp>
 {
         "data": [{
-        "fqn": "makoto.metal.coins",
-        "owner": TD3RXTHBLK6J3UD2BH2PXSOFLPWZOTR34WCG4HXH",
-        "height": 13465
+                "fqn": "makoto.metal.coins",
+                "owner": TD3RXTHBLK6J3UD2BH2PXSOFLPWZOTR34WCG4HXH",
+                "height": 13465
         }]
 }
     </resp>
@@ -2632,7 +2636,7 @@ <h4>Example of returned JSON <a href="#nodeCollection">NodeCollection</a> object
               {
                      "name": "Alice",
                      "public-key": "a1aaca6c17a24252e674d155713cdf55996ad00175be4af02a20c67b59f9fe8a"
-              },
+              }
        ]
 }
     </resp>
@@ -2687,7 +2691,7 @@ <h4>Example of returned JSON <a href="#nodeCollection">NodeCollection</a> object
               {
                      "name": "Alice",
                      "public-key": "a1aaca6c17a24252e674d155713cdf55996ad00175be4af02a20c67b59f9fe8a"
-              },
+              }
        ]
 }
     </resp>
@@ -4728,43 +4732,47 @@ <h2>Transaction fees</h2>
                 <p>The fee is the sum of the fee for transferring an amount of
                     XEM and the fee for appending a message to the transaction.</p>
 
-                <p>1) Fees for transferring XEM to another account:<br/>
-                    a) If the amount transferred is less than 8 XEM then the
-                    fee is 10 - amount XEM.<br/>
-                    Example:<br/>
-                    Transferring 6 XEM costs 4 XEM fee.<br/>
-                    b) If the amount transferred is greater or equal 8 XEM
-                    then the fee is<br/>
-                    max(2, 99 * arctan(amount / 150000)) XEM.<br/>
-                    Example:<br/>
-                    Transferring 100000 XEM costs 58 XEM.</p>
-
-                <p>2) Fees for appending a message to a transaction:<br/>
-                    Transferring 100000 XEM costs 58 XEM.</p>
-
-                <p>2) Fees for transferring a mosaic to another account:<br/>
-                    For each mosaic that is transferred the fee is calculated the following way:<br>
-                    a) given a mosaic with initial supply s, divisibility d and quantity q, the XEM equivalent is (round to the next smaller integer)<br/>
-                    xemEquivalent = (8,999,999,999 * q) / (s * 10^d) <br/>
-                    The fee is then calculated by applying 1) to xemEquivalent and in a final step adding 25% to it:<br>
-                    fee = (apply 1) to xemEquivalent) * 1.25<br>
-                    Example:<br/>
-                    Suppose the transaction has an amount of 3,000,000 micro-xem and the mosaic in the attachment has an initial supply of 1,000,000,
-                    a divisibility of 3 and a quantity of 5,000. This means that a quantity of 15,000 will be transferred.
-                    Applying the above formula gives<br>
-                    xemEquivalent = (8,999,999,999 * 15,000) / (1,000,000 * 1000) = 134999<br>
-                    The result was rounded to the next smaller integer. Applying 1) to xemEquivalent gives (again after rounding) 72.<br>
-                    So the fee is 72 * 1.25 XEM = 90 XEM.</p>
-
-                <p>3) Fees for appending a message to a transaction:<br/>
-                    If no message or an empty message is append it costs
-                    0 XEM. Else the fee is calculated as<br/>
-                    2 * max(1, message length / 16)<br/>
-                    Example:<br/>
-                    The unencrypted message &bdquo;The New Economy
-                    Movement will change the world!!!&ldquo; has a length 49
-                    characters and thus will cost 2 * 49/16 = 6 XEM.</p>
-            </td>
+				<ol>
+				<li>Fees for transferring XEM to another account:<br>
+                    1 xem per 10,000 xem transferred, capped at 25 xem<br>
+                    Example:<br>
+                    4 xem fee for a 45,000 xem transfer, 25 xem fee for a 500,000 xem transfer.</li>
+
+                <li>Fees for appending a message to a transaction:<br>
+                    1 xem per commenced 32 message bytes (messageLength / 32 + 1).<br>
+                    Example:<br>
+                    The unencrypted message „The New Economy
+                    Movement will change the world!!!” has a length 49
+                    characters and thus will cost 2 xem fee.</li>
+
+                <li>Fees for transferring a mosaic to another account:
+                    <ol>
+                        <li>mosaics with divisibility of 0 and a maximum supply of 10,000 are called small business mosaics.<br>
+	                    1 xem fee for any transfer of a small business mosaic.</li>
+                        <li> For each mosaic that is transferred the fee is calculated the following way:
+                        given a mosaic with initial supply s, divisibility d and quantity q, the XEM equivalent is (round to the next smaller integer)<br>
+                        xemEquivalent = (8,999,999,999 * q) / (s * 10^d) <br>
+                        To take into account the total quantities for different mosaics, an adjustment term is calculated.<br>
+                        For a mosaic called m calculate<br>
+                        maxMosaicQuantity = 9,000,000,000,000,000<br>
+                        totalMosaicQuantity = mosaic m supply * 10 ^ (mosaic m divisibility)<br>
+                        supplyRelatedAdjustment = floor(0.8 * ln(maxMosaicQuantity  / totalMosaicQuantity)<br>
+                        Then the fee is calculated as<br>
+                        fee = max(1L, xemFee - supplyRelatedAdjustment)<br>
+                        Example:<br>
+                        Suppose you have a mosaic with 9,000,000 supply and divisibility of 3.<br>
+                        totalMosaicQuantity  = 9,000,000 * 1,000 = 9,000,000,000<br>
+                        supplyRelatedAdjustment = floor(0.8 * ln(9,000,000,000,000,000 / 9,000,000,000)) = floor(11.052) = 11<br>
+                        Transferring 150 such mosaics (i.e. a quantity of 150,000 smallest units) has<br>
+                        xemEquivalent = (8,999,999,999 * 150,000) / (9,000,000 * 10^3) = 149,999<br>
+                        xemFee = 14 xem<br>
+                        So the transction will have the following fee:<br>
+                        fee = 14 xem - 11 xem = 3 xem
+                        </li>
+                    </ol>
+                </li>
+				</ol>
+             </td>
         </tr>
         <tr>
             <td>
@@ -4779,12 +4787,12 @@ <h2>Transaction fees</h2>
                 <p class=JSON>Aggregate modification transaction</p>
             </td>
             <td>
-                <p>10 + 6 * number of modifications + 6 (if a min cosignatory change is involved)<br/>
-                    Example:<br/>
-                    Adding 3 cosignatories to an account without changing the min cosignatories will cost<br/>
-                    10 + 6 * 3 = 28 XEM.<br/>
-                    Adding 3 cosignatories to an account and changing the min cosignatories will cost<br/>
-                    10 + 6 * 3 + 6 = 34 XEM.<br/>
+                <p>10 + 6 * number of modifications + 6 (if a min cosignatory change is involved)<br>
+                    Example:<br>
+                    Adding 3 cosignatories to an account without changing the min cosignatories will cost<br>
+                    10 + 6 * 3 = 28 XEM.<br>
+                    Adding 3 cosignatories to an account and changing the min cosignatories will cost<br>
+                    10 + 6 * 3 + 6 = 34 XEM.<br>
                 </p>
             </td>
         </tr>
@@ -4809,23 +4817,23 @@ <h2>Transaction fees</h2>
                 <p class=JSON>Provision namespace transaction</p>
             </td>
             <td>
-                <p>108 XEM</p>
+                <p>20 XEM</p>
             </td>
         </tr>
         <tr>
             <td>
                 <p class=JSON>Mosaic definition creation transaction</p>
             </td>
             <td>
-                <p>108 XEM</p>
+                <p>20 XEM</p>
             </td>
         </tr>
         <tr>
             <td>
                 <p class=JSON>Mosaic supply change transaction</p>
             </td>
             <td>
-                <p>108 XEM</p>
+                <p>20 XEM</p>
             </td>
         </tr>
     </table>
@@ -5415,10 +5423,10 @@ <h4>JSON structure by example:</h4>
     <h2>BlockHeight</h2>
 
     <desc>
-    <p class=NemNoSpacing>The block height describes the position
-    of the block within the block chain. The first block of the chain has height
-    one. Each subsequent block has a height which is one higher than the previous
-    block.</p>
+        <p class=NemNoSpacing>The block height describes the position
+            of the block within the block chain. The first block of the chain has height
+            one. Each subsequent block has a height which is one higher than the previous
+            block.</p>
     </desc>
 
     <h4>JSON structure by example:</h4>