Content - RPC - Add bls

Used to create operator keys for DIP3 Pro*tx special txs

_autocrossref.yaml

@@ -260,6 +260,8 @@ DIP1:
 '`addwitnessaddress` RPC': rpc addwitnessaddress
 '`backupwallet`': rpc backupwallet
 '`backupwallet` RPC': rpc backupwallet
+'`bls`': rpc bls
+'`bls` RPC': rpc bls
 '`bumpfee`': rpc bumpfee
 '`bumpfee` RPC': rpc bumpfee
 '`clearbanned`': rpc clearbanned

_config.yml

@@ -187,6 +187,7 @@ devsearches:
     - 'AddNode': "/en/developer-reference#addnode"
     - 'AddWitnessAddress': "/en/developer-reference#addwitnessaddress"
     - 'BackupWallet': "/en/developer-reference#backupwallet"
+    - 'BLS': "/en/developer-reference#bls"
     - 'BumpFee': "/en/developer-reference#bumpfee"
     - 'ClearBanned': "/en/developer-reference#clearbanned"
     - 'CreateMultisig': "/en/developer-reference#createmultisig"

_includes/devdoc/dash-core/rpcs/quick-reference.md

@@ -19,6 +19,10 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
 <!-- Dash - Not Implemented -->
 {% assign DASH_NOT_IMPLEMENTED='**<abbr title="Not Implemented in Dash">Not Implemented</abbr>**' %}
 
+<!-- Dash Core 0.13.0.0 Nov 2018 -->
+{% assign DASH_NEW0_13_0='**<abbr title="New in Dash Core v0.13.0">New in Dash Core 0.13.0</abbr>**' %}
+{% assign DASH_UPDATED0_13_0='**<abbr title="Updated in Dash Core v0.13.0">Updated in Dash Core 0.13.0</abbr>**' %}
+
 <!-- Dash Core 0.12.3.0 July 2018 -->
 {% assign DASH_NEW0_12_3='**<abbr title="New in Dash Core v0.12.3">New in Dash Core 0.12.3</abbr>**' %}
 {% assign DASH_UPDATED0_12_3='**<abbr title="Updated in Dash Core v0.12.3">Updated in Dash Core 0.12.3</abbr>**' %}
@@ -157,6 +161,16 @@ These RPCs are all Dash-specific and not found in Bitcoin Core
 
 {% endautocrossref %}
 
+#### Evolution RPCs
+{:.no_toc}
+<!-- no subhead-links here -->
+
+{% autocrossref %}
+
+* [BLS][rpc bls]: {{summary_bls}} {{DASH_NEW0_13_0}}
+
+{% endautocrossref %}
+
 #### Generating RPCs
 {:.no_toc}
 <!-- no subhead-links here -->

_includes/devdoc/dash-core/rpcs/rpcs/bls.md

@@ -0,0 +1,64 @@
+{% comment %}
+This file is licensed under the MIT License (MIT) available on
+http://opensource.org/licenses/MIT.
+{% endcomment %}
+{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/bls.md" %}
+
+<!-- __ -->
+
+##### BLS
+{% include helpers/subhead-links.md %}
+
+{% assign summary_bLS="provides a set of commands to execute BLS-related actions." %}
+
+{% autocrossref %}
+
+The `bls` RPC {{summary_bLS}}
+
+{% endautocrossref %}
+
+###### BLS<!--noref--> Generate
+<!-- no subhead-links here -->
+
+{% autocrossref %}
+
+The `bls<!--noref--> generate` RPC creates a new BLS secret/public key pair.
+
+*Parameters: none*
+
+*Result---a secret/public key pair*
+
+{% itemplate ntpd1 %}
+- n: "`result`"
+  t: "object"
+  p: "Required<br>(exactly 1)"
+  d: "BLS key pair"
+
+- n: "→<br>`secret`"
+  t: "string (hex)"
+  p: "Required<br>(exactly 1)"
+  d: "A BLS secret key"
+
+- n: "→<br>`public`"
+  t: "string (hex)"
+  p: "Required<br>(exactly 1)"
+  d: "A BLS public key"
+{% enditemplate %}
+
+*Example from Dash Core 0.13.0*
+
+{% highlight bash %}
+dash-cli -testnet bls generate
+{% endhighlight %}
+
+Result:
+{% highlight bash %}
+{
+  "secret": "52f35cd3d977a505485f2474e7e71ef3f60f859603d72ad6b0fa7f7bd163e144",
+  "public": "885d01d746c3e4d2093b0975de2d8c1f3e5a2c3e8fdaaed929f86fc9fbb278a095248163c101a2456650b415776b7990"
+}
+{% endhighlight %}
+
+*See also: none*
+
+{% endautocrossref %}

_includes/helpers/summaries.md

@@ -4,6 +4,7 @@ This file is licensed under the terms of its source texts{%endcomment%}
 {% assign summary_addMultiSigAddress="adds a P2SH multisig address to the wallet." %}
 {% assign summary_addNode="attempts to add or remove a node from the addnode list, or to try a connection to a node once." %}
 {% assign summary_addWitnessAddress="adds a witness address for a script (with pubkey or redeem script known)." %}
+{% assign summary_bLS="provides a set of commands to execute BLS-related actions." %}
 {% assign summary_backupWallet="safely copies `wallet.dat`<!--noref--> to the specified file, which can be a directory or a path with filename." %}
 {% assign summary_bumpFee="replaces an unconfirmed wallet transaction that signaled RBF with a new transaction that pays a higher fee." %}
 {% assign summary_clearBanned="clears list of banned nodes." %}

_includes/layout/base/rpc-table.html

@@ -295,6 +295,12 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
     <td class="tg-baqh">Y</td>
     <td class="tg-baqh"></td>
   </tr>
+  <tr>
+    <td class="tg-b7b8">Evolution</td>
+    <td class="tg-b7b8"><a href="#bls">BLS</a></td>
+    <td class="tg-dzk6">Y</td>
+    <td class="tg-dzk6">Added in 0.13.0</td>
+  </tr>
   <tr>
     <td class="tg-b7b8">Generating</td>
     <td class="tg-b7b8"><a href="#generate">Generate</a></td>

_includes/references.md

@@ -65,6 +65,7 @@ http://opensource.org/licenses/MIT.
 [rpc addnode]: /en/developer-reference#addnode
 [rpc addwitnessaddress]: /en/developer-reference#addwitnessaddress
 [rpc backupwallet]: /en/developer-reference#backupwallet
+[rpc bls]: /en/developer-reference#bls
 [rpc bumpfee]: /en/developer-reference#bumpfee
 [rpc clearbanned]: /en/developer-reference#clearbanned
 [rpc createmultisig]: /en/developer-reference#createmultisig

en/developer-reference.md

@@ -80,6 +80,8 @@ untrusted source.
 
 {% include devdoc/dash-core/rpcs/rpcs/backupwallet.md %}
 
+{% include devdoc/dash-core/rpcs/rpcs/bls.md %}
+
 {% include devdoc/dash-core/rpcs/rpcs/bumpfee.md %}
 
 {% include devdoc/dash-core/rpcs/rpcs/clearbanned.md %}