Add JCLI command for creating own stake delegation certificate

Author: CodeSandwich

doc/stake_pool/delegating_stake.md

@@ -2,10 +2,32 @@
 
 ## how to create the delegation certificate
 
-Stake is concentrated in accounts, and you will need your account public key to
-delegate its associated stake.
+Stake is concentrated in accounts, and you will need account public key to delegate its associated stake.
 
-You will need your:
+### for own account
+
+You will need:
+
+* the Stake Pool ID: an hexadecimal string identifying the stake pool you want
+  to delegate your stake to.
+
+```sh
+jcli certificate new owned-stake-delegation STAKE_POOL_ID > stake_delegation.cert
+```
+
+Note that the certificate is in blaco, there's no account key used for its creation.
+In order for delegation to work it must be submitted to a node inside a very specific transaction:
+
+* Transaction must have exactly 1 input
+* The input must be from account
+* The input value must be strictly equal to fee of the transaction
+* Transaction must have 0 outputs
+
+The account used for input will have its stake delegated to the stake pool
+
+### for any account
+
+You will need:
 
 * account public key: a bech32 string of a public key
 * the Stake Pool ID: an hexadecimal string identifying the stake pool you want

jcli/src/jcli_app/certificate/mod.rs

@@ -7,6 +7,7 @@ use std::path::{Path, PathBuf};
 use structopt::StructOpt;
 
 mod get_stake_pool_id;
+mod new_owner_stake_delegation;
 mod new_stake_delegation;
 mod new_stake_pool_registration;
 mod sign;
@@ -74,6 +75,8 @@ pub enum NewArgs {
     StakePoolRegistration(new_stake_pool_registration::StakePoolRegistration),
     /// build a stake delegation certificate
     StakeDelegation(new_stake_delegation::StakeDelegation),
+    /// build an owner stake delegation certificate
+    OwnerStakeDelegation(new_owner_stake_delegation::OwnerStakeDelegation),
 }
 
 #[derive(StructOpt)]
@@ -99,6 +102,7 @@ impl NewArgs {
         match self {
             NewArgs::StakePoolRegistration(args) => args.exec()?,
             NewArgs::StakeDelegation(args) => args.exec()?,
+            NewArgs::OwnerStakeDelegation(args) => args.exec()?,
         }
         Ok(())
     }

jcli/src/jcli_app/certificate/new_owner_stake_delegation.rs

@@ -0,0 +1,29 @@
+use crate::jcli_app::certificate::{weighted_pool_ids::WeightedPoolIds, write_cert, Error};
+use chain_impl_mockchain::certificate::{Certificate, OwnerStakeDelegation as Delegation};
+use jormungandr_lib::interfaces::Certificate as CertificateType;
+use std::convert::TryInto;
+use std::ops::Deref;
+use std::path::PathBuf;
+use structopt::StructOpt;
+
+#[derive(StructOpt)]
+pub struct OwnerStakeDelegation {
+    #[structopt(flatten)]
+    pool_ids: WeightedPoolIds,
+
+    /// write the output to the given file or print it to the standard output if not defined
+    #[structopt(short = "o", long = "output")]
+    output: Option<PathBuf>,
+}
+
+impl OwnerStakeDelegation {
+    pub fn exec(self) -> Result<(), Error> {
+        let cert = Certificate::OwnerStakeDelegation(Delegation {
+            delegation: (&self.pool_ids).try_into()?,
+        });
+        write_cert(
+            self.output.as_ref().map(|x| x.deref()),
+            CertificateType(cert),
+        )
+    }
+}