From 9fa37ab7dfba0afb6c37ce2fec6bd1c86f537c2d Mon Sep 17 00:00:00 2001 From: thephez Date: Tue, 30 Oct 2018 14:41:48 -0400 Subject: [PATCH] Content - RPC - Add bls Used to create operator keys for DIP3 Pro*tx special txs --- _autocrossref.yaml | 2 + _config.yml | 1 + .../devdoc/dash-core/rpcs/quick-reference.md | 14 ++++ _includes/devdoc/dash-core/rpcs/rpcs/bls.md | 64 +++++++++++++++++++ _includes/helpers/summaries.md | 1 + _includes/layout/base/rpc-table.html | 6 ++ _includes/references.md | 1 + en/developer-reference.md | 2 + 8 files changed, 91 insertions(+) create mode 100644 _includes/devdoc/dash-core/rpcs/rpcs/bls.md diff --git a/_autocrossref.yaml b/_autocrossref.yaml index 9ad61b3c..745560d9 100644 --- a/_autocrossref.yaml +++ b/_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 diff --git a/_config.yml b/_config.yml index 5bc0b793..db5a57ec 100644 --- a/_config.yml +++ b/_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" diff --git a/_includes/devdoc/dash-core/rpcs/quick-reference.md b/_includes/devdoc/dash-core/rpcs/quick-reference.md index bbb309dd..d9224f18 100644 --- a/_includes/devdoc/dash-core/rpcs/quick-reference.md +++ b/_includes/devdoc/dash-core/rpcs/quick-reference.md @@ -19,6 +19,10 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. {% assign DASH_NOT_IMPLEMENTED='**Not Implemented**' %} + +{% assign DASH_NEW0_13_0='**New in Dash Core 0.13.0**' %} +{% assign DASH_UPDATED0_13_0='**Updated in Dash Core 0.13.0**' %} + {% assign DASH_NEW0_12_3='**New in Dash Core 0.12.3**' %} {% assign DASH_UPDATED0_12_3='**Updated in Dash Core 0.12.3**' %} @@ -157,6 +161,16 @@ These RPCs are all Dash-specific and not found in Bitcoin Core {% endautocrossref %} +#### Evolution RPCs +{:.no_toc} + + +{% autocrossref %} + +* [BLS][rpc bls]: {{summary_bls}} {{DASH_NEW0_13_0}} + +{% endautocrossref %} + #### Generating RPCs {:.no_toc} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/bls.md b/_includes/devdoc/dash-core/rpcs/rpcs/bls.md new file mode 100644 index 00000000..9729619d --- /dev/null +++ b/_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 Generate + + +{% autocrossref %} + +The `bls 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
(exactly 1)" + d: "BLS key pair" + +- n: "→
`secret`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "A BLS secret key" + +- n: "→
`public`" + t: "string (hex)" + p: "Required
(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 %} diff --git a/_includes/helpers/summaries.md b/_includes/helpers/summaries.md index a26c2867..9b4214f4 100644 --- a/_includes/helpers/summaries.md +++ b/_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` 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." %} diff --git a/_includes/layout/base/rpc-table.html b/_includes/layout/base/rpc-table.html index 04497fe7..91681e56 100644 --- a/_includes/layout/base/rpc-table.html +++ b/_includes/layout/base/rpc-table.html @@ -295,6 +295,12 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header:: Y + + Evolution + BLS + Y + Added in 0.13.0 + Generating Generate diff --git a/_includes/references.md b/_includes/references.md index f3204433..4007c41f 100644 --- a/_includes/references.md +++ b/_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 diff --git a/en/developer-reference.md b/en/developer-reference.md index a52124f3..49c88ce2 100644 --- a/en/developer-reference.md +++ b/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 %}