Hex Artifact Content
Not logged in

Artifact 016d7a5eda95faa73b6a1fc92a188ed5d190851f:


0000: 2f 2f 20 43 6f 70 79 72 69 67 68 74 20 32 30 31  // Copyright 201
0010: 35 20 4d 61 69 64 53 61 66 65 2e 6e 65 74 20 6c  5 MaidSafe.net l
0020: 69 6d 69 74 65 64 2e 0a 2f 2f 0a 2f 2f 20 54 68  imited..//.// Th
0030: 69 73 20 53 41 46 45 20 4e 65 74 77 6f 72 6b 20  is SAFE Network 
0040: 53 6f 66 74 77 61 72 65 20 69 73 20 6c 69 63 65  Software is lice
0050: 6e 73 65 64 20 74 6f 20 79 6f 75 20 75 6e 64 65  nsed to you unde
0060: 72 20 28 31 29 20 74 68 65 20 4d 61 69 64 53 61  r (1) the MaidSa
0070: 66 65 2e 6e 65 74 20 43 6f 6d 6d 65 72 63 69 61  fe.net Commercia
0080: 6c 20 4c 69 63 65 6e 73 65 2c 0a 2f 2f 20 76 65  l License,.// ve
0090: 72 73 69 6f 6e 20 31 2e 30 20 6f 72 20 6c 61 74  rsion 1.0 or lat
00a0: 65 72 2c 20 6f 72 20 28 32 29 20 54 68 65 20 47  er, or (2) The G
00b0: 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69  eneral Public Li
00c0: 63 65 6e 73 65 20 28 47 50 4c 29 2c 20 76 65 72  cense (GPL), ver
00d0: 73 69 6f 6e 20 33 2c 20 64 65 70 65 6e 64 69 6e  sion 3, dependin
00e0: 67 20 6f 6e 20 77 68 69 63 68 0a 2f 2f 20 6c 69  g on which.// li
00f0: 63 65 6e 63 65 20 79 6f 75 20 61 63 63 65 70 74  cence you accept
0100: 65 64 20 6f 6e 20 69 6e 69 74 69 61 6c 20 61 63  ed on initial ac
0110: 63 65 73 73 20 74 6f 20 74 68 65 20 53 6f 66 74  cess to the Soft
0120: 77 61 72 65 20 28 74 68 65 20 22 4c 69 63 65 6e  ware (the "Licen
0130: 63 65 73 22 29 2e 0a 2f 2f 0a 2f 2f 20 42 79 20  ces")..//.// By 
0140: 63 6f 6e 74 72 69 62 75 74 69 6e 67 20 63 6f 64  contributing cod
0150: 65 20 74 6f 20 74 68 65 20 53 41 46 45 20 4e 65  e to the SAFE Ne
0160: 74 77 6f 72 6b 20 53 6f 66 74 77 61 72 65 2c 20  twork Software, 
0170: 6f 72 20 74 6f 20 74 68 69 73 20 70 72 6f 6a 65  or to this proje
0180: 63 74 20 67 65 6e 65 72 61 6c 6c 79 2c 20 79 6f  ct generally, yo
0190: 75 20 61 67 72 65 65 20 74 6f 20 62 65 0a 2f 2f  u agree to be.//
01a0: 20 62 6f 75 6e 64 20 62 79 20 74 68 65 20 74 65   bound by the te
01b0: 72 6d 73 20 6f 66 20 74 68 65 20 4d 61 69 64 53  rms of the MaidS
01c0: 61 66 65 20 43 6f 6e 74 72 69 62 75 74 6f 72 20  afe Contributor 
01d0: 41 67 72 65 65 6d 65 6e 74 2c 20 76 65 72 73 69  Agreement, versi
01e0: 6f 6e 20 31 2e 30 2e 20 20 54 68 69 73 2c 20 61  on 1.0.  This, a
01f0: 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 0a 2f 2f  long with the.//
0200: 20 4c 69 63 65 6e 73 65 73 20 63 61 6e 20 62 65   Licenses can be
0210: 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 72 6f   found in the ro
0220: 6f 74 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20  ot directory of 
0230: 74 68 69 73 20 70 72 6f 6a 65 63 74 20 61 74 20  this project at 
0240: 4c 49 43 45 4e 53 45 2c 20 43 4f 50 59 49 4e 47  LICENSE, COPYING
0250: 20 61 6e 64 20 43 4f 4e 54 52 49 42 55 54 4f 52   and CONTRIBUTOR
0260: 2e 0a 2f 2f 0a 2f 2f 20 55 6e 6c 65 73 73 20 72  ..//.// Unless r
0270: 65 71 75 69 72 65 64 20 62 79 20 61 70 70 6c 69  equired by appli
0280: 63 61 62 6c 65 20 6c 61 77 20 6f 72 20 61 67 72  cable law or agr
0290: 65 65 64 20 74 6f 20 69 6e 20 77 72 69 74 69 6e  eed to in writin
02a0: 67 2c 20 74 68 65 20 53 41 46 45 20 4e 65 74 77  g, the SAFE Netw
02b0: 6f 72 6b 20 53 6f 66 74 77 61 72 65 20 64 69 73  ork Software dis
02c0: 74 72 69 62 75 74 65 64 0a 2f 2f 20 75 6e 64 65  tributed.// unde
02d0: 72 20 74 68 65 20 47 50 4c 20 4c 69 63 65 6e 63  r the GPL Licenc
02e0: 65 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64  e is distributed
02f0: 20 6f 6e 20 61 6e 20 22 41 53 20 49 53 22 20 42   on an "AS IS" B
0300: 41 53 49 53 2c 20 57 49 54 48 4f 55 54 20 57 41  ASIS, WITHOUT WA
0310: 52 52 41 4e 54 49 45 53 20 4f 52 20 43 4f 4e 44  RRANTIES OR COND
0320: 49 54 49 4f 4e 53 20 4f 46 20 41 4e 59 0a 2f 2f  ITIONS OF ANY.//
0330: 20 4b 49 4e 44 2c 20 65 69 74 68 65 72 20 65 78   KIND, either ex
0340: 70 72 65 73 73 20 6f 72 20 69 6d 70 6c 69 65 64  press or implied
0350: 2e 0a 2f 2f 0a 2f 2f 20 50 6c 65 61 73 65 20 72  ..//.// Please r
0360: 65 76 69 65 77 20 74 68 65 20 4c 69 63 65 6e 63  eview the Licenc
0370: 65 73 20 66 6f 72 20 74 68 65 20 73 70 65 63 69  es for the speci
0380: 66 69 63 20 6c 61 6e 67 75 61 67 65 20 67 6f 76  fic language gov
0390: 65 72 6e 69 6e 67 20 70 65 72 6d 69 73 73 69 6f  erning permissio
03a0: 6e 73 20 61 6e 64 20 6c 69 6d 69 74 61 74 69 6f  ns and limitatio
03b0: 6e 73 0a 2f 2f 20 72 65 6c 61 74 69 6e 67 20 74  ns.// relating t
03c0: 6f 20 75 73 65 20 6f 66 20 74 68 65 20 53 41 46  o use of the SAF
03d0: 45 20 4e 65 74 77 6f 72 6b 20 53 6f 66 74 77 61  E Network Softwa
03e0: 72 65 2e 0a 0a 75 73 65 20 63 6f 72 65 3a 3a 65  re...use core::e
03f0: 72 72 6f 72 73 3a 3a 43 6f 72 65 45 72 72 6f 72  rrors::CoreError
0400: 3b 0a 75 73 65 20 63 6f 72 65 3a 3a 69 64 3a 3a  ;.use core::id::
0410: 72 65 76 6f 63 61 74 69 6f 6e 5f 69 64 5f 74 79  revocation_id_ty
0420: 70 65 3a 3a 52 65 76 6f 63 61 74 69 6f 6e 49 64  pe::RevocationId
0430: 54 79 70 65 3b 0a 75 73 65 20 72 6f 75 74 69 6e  Type;.use routin
0440: 67 3a 3a 58 6f 72 4e 61 6d 65 3b 0a 75 73 65 20  g::XorName;.use 
0450: 72 75 73 74 5f 73 6f 64 69 75 6d 3a 3a 63 72 79  rust_sodium::cry
0460: 70 74 6f 3a 3a 7b 62 6f 78 5f 2c 20 73 69 67 6e  pto::{box_, sign
0470: 7d 3b 0a 75 73 65 20 72 75 73 74 5f 73 6f 64 69  };.use rust_sodi
0480: 75 6d 3a 3a 63 72 79 70 74 6f 3a 3a 68 61 73 68  um::crypto::hash
0490: 3a 3a 73 68 61 32 35 36 3b 0a 0a 2f 2f 2f 20 49  ::sha256;../// I
04a0: 64 54 79 70 65 0a 2f 2f 2f 0a 2f 2f 2f 20 23 45  dType.///./// #E
04b0: 78 61 6d 70 6c 65 73 0a 2f 2f 2f 0a 2f 2f 2f 20  xamples.///./// 
04c0: 60 60 60 0a 2f 2f 2f 20 75 73 65 20 3a 3a 73 61  ```./// use ::sa
04d0: 66 65 5f 63 6f 72 65 3a 3a 63 6f 72 65 3a 3a 69  fe_core::core::i
04e0: 64 3a 3a 7b 49 64 54 79 70 65 2c 20 52 65 76 6f  d::{IdType, Revo
04f0: 63 61 74 69 6f 6e 49 64 54 79 70 65 2c 20 4d 61  cationIdType, Ma
0500: 69 64 54 79 70 65 54 61 67 73 7d 3b 0a 2f 2f 2f  idTypeTags};.///
0510: 20 2f 2f 20 43 72 65 61 74 69 6e 67 20 6e 65 77   // Creating new
0520: 20 49 64 54 79 70 65 0a 2f 2f 2f 20 6c 65 74 20   IdType./// let 
0530: 5f 6d 61 69 64 20 20 3d 20 49 64 54 79 70 65 3a  _maid  = IdType:
0540: 3a 6e 65 77 28 26 52 65 76 6f 63 61 74 69 6f 6e  :new(&Revocation
0550: 49 64 54 79 70 65 3a 3a 6e 65 77 3a 3a 3c 4d 61  IdType::new::<Ma
0560: 69 64 54 79 70 65 54 61 67 73 3e 28 29 29 3b 0a  idTypeTags>());.
0570: 2f 2f 2f 0a 2f 2f 2f 20 60 60 60 0a 23 5b 64 65  ///./// ```.#[de
0580: 72 69 76 65 28 43 6c 6f 6e 65 2c 20 44 65 62 75  rive(Clone, Debu
0590: 67 2c 20 45 71 2c 20 50 61 72 74 69 61 6c 45 71  g, Eq, PartialEq
05a0: 2c 20 52 75 73 74 63 45 6e 63 6f 64 61 62 6c 65  , RustcEncodable
05b0: 2c 20 52 75 73 74 63 44 65 63 6f 64 61 62 6c 65  , RustcDecodable
05c0: 29 5d 0a 70 75 62 20 73 74 72 75 63 74 20 49 64  )].pub struct Id
05d0: 54 79 70 65 20 7b 0a 20 20 20 20 74 79 70 65 5f  Type {.    type_
05e0: 74 61 67 3a 20 75 36 34 2c 0a 20 20 20 20 70 75  tag: u64,.    pu
05f0: 62 6c 69 63 5f 6b 65 79 73 3a 20 28 73 69 67 6e  blic_keys: (sign
0600: 3a 3a 50 75 62 6c 69 63 4b 65 79 2c 20 62 6f 78  ::PublicKey, box
0610: 5f 3a 3a 50 75 62 6c 69 63 4b 65 79 29 2c 0a 20  _::PublicKey),. 
0620: 20 20 20 73 65 63 72 65 74 5f 6b 65 79 73 3a 20     secret_keys: 
0630: 28 73 69 67 6e 3a 3a 53 65 63 72 65 74 4b 65 79  (sign::SecretKey
0640: 2c 20 62 6f 78 5f 3a 3a 53 65 63 72 65 74 4b 65  , box_::SecretKe
0650: 79 29 2c 0a 7d 0a 0a 69 6d 70 6c 20 49 64 54 79  y),.}..impl IdTy
0660: 70 65 20 7b 0a 20 20 20 20 2f 2f 2f 20 49 6e 76  pe {.    /// Inv
0670: 6f 6b 65 64 20 74 6f 20 63 72 65 61 74 65 20 61  oked to create a
0680: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 49 64  n instance of Id
0690: 54 79 70 65 0a 20 20 20 20 70 75 62 20 66 6e 20  Type.    pub fn 
06a0: 6e 65 77 28 72 65 76 6f 63 61 74 69 6f 6e 5f 69  new(revocation_i
06b0: 64 3a 20 26 52 65 76 6f 63 61 74 69 6f 6e 49 64  d: &RevocationId
06c0: 54 79 70 65 29 20 2d 3e 20 49 64 54 79 70 65 20  Type) -> IdType 
06d0: 7b 0a 20 20 20 20 20 20 20 20 6c 65 74 20 61 73  {.        let as
06e0: 79 6d 5f 6b 65 79 73 20 3d 20 62 6f 78 5f 3a 3a  ym_keys = box_::
06f0: 67 65 6e 5f 6b 65 79 70 61 69 72 28 29 3b 0a 20  gen_keypair();. 
0700: 20 20 20 20 20 20 20 6c 65 74 20 73 69 67 6e 69         let signi
0710: 6e 67 5f 6b 65 79 73 20 3d 20 73 69 67 6e 3a 3a  ng_keys = sign::
0720: 67 65 6e 5f 6b 65 79 70 61 69 72 28 29 3b 0a 0a  gen_keypair();..
0730: 20 20 20 20 20 20 20 20 49 64 54 79 70 65 20 7b          IdType {
0740: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 79 70  .            typ
0750: 65 5f 74 61 67 3a 20 72 65 76 6f 63 61 74 69 6f  e_tag: revocatio
0760: 6e 5f 69 64 2e 74 79 70 65 5f 74 61 67 73 28 29  n_id.type_tags()
0770: 2e 31 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  .1,.            
0780: 70 75 62 6c 69 63 5f 6b 65 79 73 3a 20 28 73 69  public_keys: (si
0790: 67 6e 69 6e 67 5f 6b 65 79 73 2e 30 2c 20 61 73  gning_keys.0, as
07a0: 79 6d 5f 6b 65 79 73 2e 30 29 2c 0a 20 20 20 20  ym_keys.0),.    
07b0: 20 20 20 20 20 20 20 20 73 65 63 72 65 74 5f 6b          secret_k
07c0: 65 79 73 3a 20 28 73 69 67 6e 69 6e 67 5f 6b 65  eys: (signing_ke
07d0: 79 73 2e 31 2c 20 61 73 79 6d 5f 6b 65 79 73 2e  ys.1, asym_keys.
07e0: 31 29 2c 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  1),.        }.  
07f0: 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f 20 52 65 74    }..    /// Ret
0800: 75 72 6e 73 20 6e 61 6d 65 0a 20 20 20 20 70 75  urns name.    pu
0810: 62 20 66 6e 20 6e 61 6d 65 28 26 73 65 6c 66 29  b fn name(&self)
0820: 20 2d 3e 20 58 6f 72 4e 61 6d 65 20 7b 0a 20 20   -> XorName {.  
0830: 20 20 20 20 20 20 6c 65 74 20 63 6f 6d 62 69 6e        let combin
0840: 65 64 5f 69 74 65 72 20 3d 20 28 26 73 65 6c 66  ed_iter = (&self
0850: 2e 70 75 62 6c 69 63 5f 6b 65 79 73 2e 30 29 0a  .public_keys.0).
0860: 20 20 20 20 20 20 20 20 20 20 20 20 2e 30 0a 20              .0. 
0870: 20 20 20 20 20 20 20 20 20 20 20 2e 69 6e 74 6f             .into
0880: 5f 69 74 65 72 28 29 0a 20 20 20 20 20 20 20 20  _iter().        
0890: 20 20 20 20 2e 63 68 61 69 6e 28 28 26 73 65 6c      .chain((&sel
08a0: 66 2e 70 75 62 6c 69 63 5f 6b 65 79 73 2e 31 29  f.public_keys.1)
08b0: 2e 30 2e 69 6e 74 6f 5f 69 74 65 72 28 29 29 3b  .0.into_iter());
08c0: 0a 20 20 20 20 20 20 20 20 6c 65 74 20 6d 75 74  .        let mut
08d0: 20 63 6f 6d 62 69 6e 65 64 20 3d 20 56 65 63 3a   combined = Vec:
08e0: 3a 6e 65 77 28 29 3b 0a 20 20 20 20 20 20 20 20  :new();.        
08f0: 66 6f 72 20 69 74 65 72 20 69 6e 20 63 6f 6d 62  for iter in comb
0900: 69 6e 65 64 5f 69 74 65 72 20 7b 0a 20 20 20 20  ined_iter {.    
0910: 20 20 20 20 20 20 20 20 63 6f 6d 62 69 6e 65 64          combined
0920: 2e 70 75 73 68 28 2a 69 74 65 72 29 3b 0a 20 20  .push(*iter);.  
0930: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
0940: 66 6f 72 20 69 20 69 6e 20 73 65 6c 66 2e 74 79  for i in self.ty
0950: 70 65 5f 74 61 67 2e 74 6f 5f 73 74 72 69 6e 67  pe_tag.to_string
0960: 28 29 2e 69 6e 74 6f 5f 62 79 74 65 73 28 29 2e  ().into_bytes().
0970: 69 6e 74 6f 5f 69 74 65 72 28 29 20 7b 0a 20 20  into_iter() {.  
0980: 20 20 20 20 20 20 20 20 20 20 63 6f 6d 62 69 6e            combin
0990: 65 64 2e 70 75 73 68 28 69 29 3b 0a 20 20 20 20  ed.push(i);.    
09a0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 58 6f      }.        Xo
09b0: 72 4e 61 6d 65 28 73 68 61 32 35 36 3a 3a 68 61  rName(sha256::ha
09c0: 73 68 28 26 63 6f 6d 62 69 6e 65 64 29 2e 30 29  sh(&combined).0)
09d0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f 20  .    }..    /// 
09e0: 52 65 74 75 72 6e 73 20 74 68 65 20 50 75 62 6c  Returns the Publ
09f0: 69 63 4b 65 79 73 0a 20 20 20 20 70 75 62 20 66  icKeys.    pub f
0a00: 6e 20 70 75 62 6c 69 63 5f 6b 65 79 73 28 26 73  n public_keys(&s
0a10: 65 6c 66 29 20 2d 3e 20 26 28 73 69 67 6e 3a 3a  elf) -> &(sign::
0a20: 50 75 62 6c 69 63 4b 65 79 2c 20 62 6f 78 5f 3a  PublicKey, box_:
0a30: 3a 50 75 62 6c 69 63 4b 65 79 29 20 7b 0a 20 20  :PublicKey) {.  
0a40: 20 20 20 20 20 20 26 73 65 6c 66 2e 70 75 62 6c        &self.publ
0a50: 69 63 5f 6b 65 79 73 0a 20 20 20 20 7d 0a 0a 20  ic_keys.    }.. 
0a60: 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74     /// Returns t
0a70: 68 65 20 50 75 62 6c 69 63 4b 65 79 73 0a 20 20  he PublicKeys.  
0a80: 20 20 70 75 62 20 66 6e 20 73 65 63 72 65 74 5f    pub fn secret_
0a90: 6b 65 79 73 28 26 73 65 6c 66 29 20 2d 3e 20 26  keys(&self) -> &
0aa0: 28 73 69 67 6e 3a 3a 53 65 63 72 65 74 4b 65 79  (sign::SecretKey
0ab0: 2c 20 62 6f 78 5f 3a 3a 53 65 63 72 65 74 4b 65  , box_::SecretKe
0ac0: 79 29 20 7b 0a 20 20 20 20 20 20 20 20 26 73 65  y) {.        &se
0ad0: 6c 66 2e 73 65 63 72 65 74 5f 6b 65 79 73 0a 20  lf.secret_keys. 
0ae0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f 20 53 69     }..    /// Si
0af0: 67 6e 73 20 74 68 65 20 64 61 74 61 20 77 69 74  gns the data wit
0b00: 68 20 74 68 65 20 53 65 63 72 65 74 4b 65 79 20  h the SecretKey 
0b10: 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 65 20  and returns the 
0b20: 53 69 67 6e 65 64 20 64 61 74 61 0a 20 20 20 20  Signed data.    
0b30: 70 75 62 20 66 6e 20 73 69 67 6e 28 26 73 65 6c  pub fn sign(&sel
0b40: 66 2c 20 64 61 74 61 3a 20 26 5b 75 38 5d 29 20  f, data: &[u8]) 
0b50: 2d 3e 20 56 65 63 3c 75 38 3e 20 7b 0a 20 20 20  -> Vec<u8> {.   
0b60: 20 20 20 20 20 73 69 67 6e 3a 3a 73 69 67 6e 28       sign::sign(
0b70: 64 61 74 61 2c 20 26 73 65 6c 66 2e 73 65 63 72  data, &self.secr
0b80: 65 74 5f 6b 65 79 73 2e 30 29 0a 20 20 20 20 7d  et_keys.0).    }
0b90: 0a 0a 20 20 20 20 2f 2f 2f 20 45 6e 63 72 79 70  ..    /// Encryp
0ba0: 74 73 20 61 6e 64 20 61 75 74 68 65 6e 74 69 63  ts and authentic
0bb0: 61 74 65 73 20 64 61 74 61 2e 20 49 74 20 72 65  ates data. It re
0bc0: 74 75 72 6e 73 20 61 20 63 69 70 68 65 72 74 65  turns a cipherte
0bd0: 78 74 20 61 6e 64 20 74 68 65 20 4e 6f 6e 63 65  xt and the Nonce
0be0: 2e 0a 20 20 20 20 70 75 62 20 66 6e 20 73 65 61  ..    pub fn sea
0bf0: 6c 28 26 73 65 6c 66 2c 20 64 61 74 61 3a 20 26  l(&self, data: &
0c00: 5b 75 38 5d 2c 20 74 6f 3a 20 26 62 6f 78 5f 3a  [u8], to: &box_:
0c10: 3a 50 75 62 6c 69 63 4b 65 79 29 20 2d 3e 20 28  :PublicKey) -> (
0c20: 56 65 63 3c 75 38 3e 2c 20 62 6f 78 5f 3a 3a 4e  Vec<u8>, box_::N
0c30: 6f 6e 63 65 29 20 7b 0a 20 20 20 20 20 20 20 20  once) {.        
0c40: 6c 65 74 20 6e 6f 6e 63 65 20 3d 20 62 6f 78 5f  let nonce = box_
0c50: 3a 3a 67 65 6e 5f 6e 6f 6e 63 65 28 29 3b 0a 20  ::gen_nonce();. 
0c60: 20 20 20 20 20 20 20 6c 65 74 20 73 65 61 6c 65         let seale
0c70: 64 20 3d 20 62 6f 78 5f 3a 3a 73 65 61 6c 28 64  d = box_::seal(d
0c80: 61 74 61 2c 20 26 6e 6f 6e 63 65 2c 20 74 6f 2c  ata, &nonce, to,
0c90: 20 26 73 65 6c 66 2e 73 65 63 72 65 74 5f 6b 65   &self.secret_ke
0ca0: 79 73 2e 31 29 3b 0a 20 20 20 20 20 20 20 20 28  ys.1);.        (
0cb0: 73 65 61 6c 65 64 2c 20 6e 6f 6e 63 65 29 0a 20  sealed, nonce). 
0cc0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f 20 56 65     }..    /// Ve
0cd0: 72 69 66 69 65 73 20 61 6e 64 20 64 65 63 72 79  rifies and decry
0ce0: 70 74 73 20 74 68 65 20 64 61 74 61 0a 20 20 20  pts the data.   
0cf0: 20 70 75 62 20 66 6e 20 6f 70 65 6e 28 26 73 65   pub fn open(&se
0d00: 6c 66 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  lf,.            
0d10: 20 20 20 20 64 61 74 61 3a 20 26 5b 75 38 5d 2c      data: &[u8],
0d20: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
0d30: 20 6e 6f 6e 63 65 3a 20 26 62 6f 78 5f 3a 3a 4e   nonce: &box_::N
0d40: 6f 6e 63 65 2c 0a 20 20 20 20 20 20 20 20 20 20  once,.          
0d50: 20 20 20 20 20 20 66 72 6f 6d 3a 20 26 62 6f 78        from: &box
0d60: 5f 3a 3a 50 75 62 6c 69 63 4b 65 79 29 0a 20 20  _::PublicKey).  
0d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 3e                ->
0d80: 20 52 65 73 75 6c 74 3c 56 65 63 3c 75 38 3e 2c   Result<Vec<u8>,
0d90: 20 43 6f 72 65 45 72 72 6f 72 3e 20 7b 0a 20 20   CoreError> {.  
0da0: 20 20 20 20 20 20 62 6f 78 5f 3a 3a 6f 70 65 6e        box_::open
0db0: 28 64 61 74 61 2c 20 6e 6f 6e 63 65 2c 20 66 72  (data, nonce, fr
0dc0: 6f 6d 2c 20 26 73 65 6c 66 2e 73 65 63 72 65 74  om, &self.secret
0dd0: 5f 6b 65 79 73 2e 31 29 0a 20 20 20 20 20 20 20  _keys.1).       
0de0: 20 20 20 20 20 2e 6d 61 70 5f 65 72 72 28 7c 5f       .map_err(|_
0df0: 7c 20 43 6f 72 65 45 72 72 6f 72 3a 3a 41 73 79  | CoreError::Asy
0e00: 6d 6d 65 74 72 69 63 44 65 63 69 70 68 65 72 46  mmetricDecipherF
0e10: 61 69 6c 75 72 65 29 0a 20 20 20 20 7d 0a 7d 0a  ailure).    }.}.
0e20: 0a 23 5b 63 66 67 28 74 65 73 74 29 5d 0a 6d 6f  .#[cfg(test)].mo
0e30: 64 20 74 65 73 74 20 7b 0a 20 20 20 20 65 78 74  d test {.    ext
0e40: 65 72 6e 20 63 72 61 74 65 20 72 61 6e 64 3b 0a  ern crate rand;.
0e50: 0a 20 20 20 20 75 73 65 20 63 6f 72 65 3a 3a 69  .    use core::i
0e60: 64 3a 3a 7b 49 64 54 79 70 65 2c 20 4d 61 69 64  d::{IdType, Maid
0e70: 54 79 70 65 54 61 67 73 2c 20 52 65 76 6f 63 61  TypeTags, Revoca
0e80: 74 69 6f 6e 49 64 54 79 70 65 7d 3b 0a 20 20 20  tionIdType};.   
0e90: 20 75 73 65 20 63 6f 72 65 3a 3a 69 64 3a 3a 52   use core::id::R
0ea0: 61 6e 64 6f 6d 3b 0a 20 20 20 20 75 73 65 20 6d  andom;.    use m
0eb0: 61 69 64 73 61 66 65 5f 75 74 69 6c 69 74 69 65  aidsafe_utilitie
0ec0: 73 3a 3a 73 65 72 69 61 6c 69 73 61 74 69 6f 6e  s::serialisation
0ed0: 3a 3a 7b 64 65 73 65 72 69 61 6c 69 73 65 2c 20  ::{deserialise, 
0ee0: 73 65 72 69 61 6c 69 73 65 7d 3b 0a 20 20 20 20  serialise};.    
0ef0: 75 73 65 20 72 75 73 74 5f 73 6f 64 69 75 6d 3a  use rust_sodium:
0f00: 3a 63 72 79 70 74 6f 3a 3a 7b 62 6f 78 5f 2c 20  :crypto::{box_, 
0f10: 73 69 67 6e 7d 3b 0a 20 20 20 20 75 73 65 20 73  sign};.    use s
0f20: 65 6c 66 3a 3a 72 61 6e 64 3a 3a 52 6e 67 3b 0a  elf::rand::Rng;.
0f30: 0a 20 20 20 20 69 6d 70 6c 20 52 61 6e 64 6f 6d  .    impl Random
0f40: 20 66 6f 72 20 49 64 54 79 70 65 20 7b 0a 20 20   for IdType {.  
0f50: 20 20 20 20 20 20 66 6e 20 67 65 6e 65 72 61 74        fn generat
0f60: 65 5f 72 61 6e 64 6f 6d 28 29 20 2d 3e 20 49 64  e_random() -> Id
0f70: 54 79 70 65 20 7b 0a 20 20 20 20 20 20 20 20 20  Type {.         
0f80: 20 20 20 49 64 54 79 70 65 3a 3a 6e 65 77 28 26     IdType::new(&
0f90: 52 65 76 6f 63 61 74 69 6f 6e 49 64 54 79 70 65  RevocationIdType
0fa0: 3a 3a 6e 65 77 3a 3a 3c 4d 61 69 64 54 79 70 65  ::new::<MaidType
0fb0: 54 61 67 73 3e 28 29 29 0a 20 20 20 20 20 20 20  Tags>()).       
0fc0: 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 5b   }.    }..    #[
0fd0: 74 65 73 74 5d 0a 20 20 20 20 66 6e 20 73 65 72  test].    fn ser
0fe0: 69 61 6c 69 73 61 74 69 6f 6e 5f 6d 61 69 64 28  ialisation_maid(
0ff0: 29 20 7b 0a 20 20 20 20 20 20 20 20 6c 65 74 20  ) {.        let 
1000: 6f 62 6a 5f 62 65 66 6f 72 65 20 3d 20 49 64 54  obj_before = IdT
1010: 79 70 65 3a 3a 67 65 6e 65 72 61 74 65 5f 72 61  ype::generate_ra
1020: 6e 64 6f 6d 28 29 3b 0a 0a 20 20 20 20 20 20 20  ndom();..       
1030: 20 6c 65 74 20 73 65 72 69 61 6c 69 73 65 64 5f   let serialised_
1040: 6f 62 6a 20 3d 20 75 6e 77 72 61 70 21 28 73 65  obj = unwrap!(se
1050: 72 69 61 6c 69 73 65 28 26 6f 62 6a 5f 62 65 66  rialise(&obj_bef
1060: 6f 72 65 29 29 3b 0a 0a 20 20 20 20 20 20 20 20  ore));..        
1070: 6c 65 74 20 6f 62 6a 5f 61 66 74 65 72 3a 20 49  let obj_after: I
1080: 64 54 79 70 65 20 3d 20 75 6e 77 72 61 70 21 28  dType = unwrap!(
1090: 64 65 73 65 72 69 61 6c 69 73 65 28 26 73 65 72  deserialise(&ser
10a0: 69 61 6c 69 73 65 64 5f 6f 62 6a 29 29 3b 0a 0a  ialised_obj));..
10b0: 20 20 20 20 20 20 20 20 6c 65 74 20 26 28 73 69          let &(si
10c0: 67 6e 3a 3a 50 75 62 6c 69 63 4b 65 79 28 70 75  gn::PublicKey(pu
10d0: 62 5f 73 69 67 6e 5f 61 72 72 5f 62 65 66 6f 72  b_sign_arr_befor
10e0: 65 29 2c 20 62 6f 78 5f 3a 3a 50 75 62 6c 69 63  e), box_::Public
10f0: 4b 65 79 28 70 75 62 5f 61 73 79 6d 5f 61 72 72  Key(pub_asym_arr
1100: 5f 62 65 66 6f 72 65 29 29 20 3d 0a 20 20 20 20  _before)) =.    
1110: 20 20 20 20 20 20 20 20 6f 62 6a 5f 62 65 66 6f          obj_befo
1120: 72 65 2e 70 75 62 6c 69 63 5f 6b 65 79 73 28 29  re.public_keys()
1130: 3b 0a 20 20 20 20 20 20 20 20 6c 65 74 20 26 28  ;.        let &(
1140: 73 69 67 6e 3a 3a 50 75 62 6c 69 63 4b 65 79 28  sign::PublicKey(
1150: 70 75 62 5f 73 69 67 6e 5f 61 72 72 5f 61 66 74  pub_sign_arr_aft
1160: 65 72 29 2c 20 62 6f 78 5f 3a 3a 50 75 62 6c 69  er), box_::Publi
1170: 63 4b 65 79 28 70 75 62 5f 61 73 79 6d 5f 61 72  cKey(pub_asym_ar
1180: 72 5f 61 66 74 65 72 29 29 20 3d 0a 20 20 20 20  r_after)) =.    
1190: 20 20 20 20 20 20 20 20 6f 62 6a 5f 61 66 74 65          obj_afte
11a0: 72 2e 70 75 62 6c 69 63 5f 6b 65 79 73 28 29 3b  r.public_keys();
11b0: 0a 20 20 20 20 20 20 20 20 6c 65 74 20 26 28 73  .        let &(s
11c0: 69 67 6e 3a 3a 53 65 63 72 65 74 4b 65 79 28 73  ign::SecretKey(s
11d0: 65 63 5f 73 69 67 6e 5f 61 72 72 5f 62 65 66 6f  ec_sign_arr_befo
11e0: 72 65 29 2c 20 62 6f 78 5f 3a 3a 53 65 63 72 65  re), box_::Secre
11f0: 74 4b 65 79 28 73 65 63 5f 61 73 79 6d 5f 61 72  tKey(sec_asym_ar
1200: 72 5f 62 65 66 6f 72 65 29 29 20 3d 0a 20 20 20  r_before)) =.   
1210: 20 20 20 20 20 20 20 20 20 26 6f 62 6a 5f 62 65           &obj_be
1220: 66 6f 72 65 2e 73 65 63 72 65 74 5f 6b 65 79 73  fore.secret_keys
1230: 3b 0a 20 20 20 20 20 20 20 20 6c 65 74 20 26 28  ;.        let &(
1240: 73 69 67 6e 3a 3a 53 65 63 72 65 74 4b 65 79 28  sign::SecretKey(
1250: 73 65 63 5f 73 69 67 6e 5f 61 72 72 5f 61 66 74  sec_sign_arr_aft
1260: 65 72 29 2c 20 62 6f 78 5f 3a 3a 53 65 63 72 65  er), box_::Secre
1270: 74 4b 65 79 28 73 65 63 5f 61 73 79 6d 5f 61 72  tKey(sec_asym_ar
1280: 72 5f 61 66 74 65 72 29 29 20 3d 0a 20 20 20 20  r_after)) =.    
1290: 20 20 20 20 20 20 20 20 26 6f 62 6a 5f 61 66 74          &obj_aft
12a0: 65 72 2e 73 65 63 72 65 74 5f 6b 65 79 73 3b 0a  er.secret_keys;.
12b0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 5f  .        assert_
12c0: 65 71 21 28 70 75 62 5f 73 69 67 6e 5f 61 72 72  eq!(pub_sign_arr
12d0: 5f 62 65 66 6f 72 65 2c 20 70 75 62 5f 73 69 67  _before, pub_sig
12e0: 6e 5f 61 72 72 5f 61 66 74 65 72 29 3b 0a 20 20  n_arr_after);.  
12f0: 20 20 20 20 20 20 61 73 73 65 72 74 5f 65 71 21        assert_eq!
1300: 28 70 75 62 5f 61 73 79 6d 5f 61 72 72 5f 62 65  (pub_asym_arr_be
1310: 66 6f 72 65 2c 20 70 75 62 5f 61 73 79 6d 5f 61  fore, pub_asym_a
1320: 72 72 5f 61 66 74 65 72 29 3b 0a 20 20 20 20 20  rr_after);.     
1330: 20 20 20 61 73 73 65 72 74 21 28 26 73 65 63 5f     assert!(&sec_
1340: 73 69 67 6e 5f 61 72 72 5f 62 65 66 6f 72 65 5b  sign_arr_before[
1350: 2e 2e 5d 20 3d 3d 20 26 73 65 63 5f 73 69 67 6e  ..] == &sec_sign
1360: 5f 61 72 72 5f 61 66 74 65 72 5b 2e 2e 5d 29 3b  _arr_after[..]);
1370: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 5f  .        assert_
1380: 65 71 21 28 73 65 63 5f 61 73 79 6d 5f 61 72 72  eq!(sec_asym_arr
1390: 5f 62 65 66 6f 72 65 2c 20 73 65 63 5f 61 73 79  _before, sec_asy
13a0: 6d 5f 61 72 72 5f 61 66 74 65 72 29 3b 0a 20 20  m_arr_after);.  
13b0: 20 20 7d 0a 0a 20 20 20 20 23 5b 74 65 73 74 5d    }..    #[test]
13c0: 0a 20 20 20 20 66 6e 20 67 65 6e 65 72 61 74 69  .    fn generati
13d0: 6f 6e 28 29 20 7b 0a 20 20 20 20 20 20 20 20 6c  on() {.        l
13e0: 65 74 20 6d 61 69 64 31 20 3d 20 49 64 54 79 70  et maid1 = IdTyp
13f0: 65 3a 3a 67 65 6e 65 72 61 74 65 5f 72 61 6e 64  e::generate_rand
1400: 6f 6d 28 29 3b 0a 20 20 20 20 20 20 20 20 6c 65  om();.        le
1410: 74 20 6d 61 69 64 32 20 3d 20 49 64 54 79 70 65  t maid2 = IdType
1420: 3a 3a 67 65 6e 65 72 61 74 65 5f 72 61 6e 64 6f  ::generate_rando
1430: 6d 28 29 3b 0a 20 20 20 20 20 20 20 20 6c 65 74  m();.        let
1440: 20 6d 61 69 64 32 5f 63 6c 6f 6e 65 20 3d 20 6d   maid2_clone = m
1450: 61 69 64 32 2e 63 6c 6f 6e 65 28 29 3b 0a 0a 20  aid2.clone();.. 
1460: 20 20 20 20 20 20 20 61 73 73 65 72 74 5f 65 71         assert_eq
1470: 21 28 6d 61 69 64 32 2c 20 6d 61 69 64 32 5f 63  !(maid2, maid2_c
1480: 6c 6f 6e 65 29 3b 0a 20 20 20 20 20 20 20 20 61  lone);.        a
1490: 73 73 65 72 74 21 28 21 28 6d 61 69 64 32 20 21  ssert!(!(maid2 !
14a0: 3d 20 6d 61 69 64 32 5f 63 6c 6f 6e 65 29 29 3b  = maid2_clone));
14b0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 21  .        assert!
14c0: 28 6d 61 69 64 31 20 21 3d 20 6d 61 69 64 32 29  (maid1 != maid2)
14d0: 3b 0a 0a 20 20 20 20 20 20 20 20 6c 65 74 20 72  ;..        let r
14e0: 61 6e 64 6f 6d 5f 62 79 74 65 73 20 3d 20 72 61  andom_bytes = ra
14f0: 6e 64 3a 3a 74 68 72 65 61 64 5f 72 6e 67 28 29  nd::thread_rng()
1500: 2e 67 65 6e 5f 69 74 65 72 3a 3a 3c 75 38 3e 28  .gen_iter::<u8>(
1510: 29 2e 74 61 6b 65 28 31 30 30 29 2e 63 6f 6c 6c  ).take(100).coll
1520: 65 63 74 3a 3a 3c 56 65 63 3c 75 38 3e 3e 28 29  ect::<Vec<u8>>()
1530: 3b 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 20  ;.        {.    
1540: 20 20 20 20 20 20 20 20 6c 65 74 20 73 69 67 6e          let sign
1550: 31 20 3d 20 6d 61 69 64 31 2e 73 69 67 6e 28 26  1 = maid1.sign(&
1560: 72 61 6e 64 6f 6d 5f 62 79 74 65 73 29 3b 0a 20  random_bytes);. 
1570: 20 20 20 20 20 20 20 20 20 20 20 6c 65 74 20 73             let s
1580: 69 67 6e 32 20 3d 20 6d 61 69 64 32 2e 73 69 67  ign2 = maid2.sig
1590: 6e 28 26 72 61 6e 64 6f 6d 5f 62 79 74 65 73 29  n(&random_bytes)
15a0: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 73  ;.            as
15b0: 73 65 72 74 21 28 73 69 67 6e 31 20 21 3d 20 73  sert!(sign1 != s
15c0: 69 67 6e 32 29 3b 0a 0a 20 20 20 20 20 20 20 20  ign2);..        
15d0: 20 20 20 20 61 73 73 65 72 74 21 28 73 69 67 6e      assert!(sign
15e0: 3a 3a 76 65 72 69 66 79 28 26 73 69 67 6e 31 2c  ::verify(&sign1,
15f0: 20 26 6d 61 69 64 31 2e 70 75 62 6c 69 63 5f 6b   &maid1.public_k
1600: 65 79 73 28 29 2e 30 29 2e 69 73 5f 6f 6b 28 29  eys().0).is_ok()
1610: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61  );.            a
1620: 73 73 65 72 74 21 28 73 69 67 6e 3a 3a 76 65 72  ssert!(sign::ver
1630: 69 66 79 28 26 73 69 67 6e 32 2c 20 26 6d 61 69  ify(&sign2, &mai
1640: 64 31 2e 70 75 62 6c 69 63 5f 6b 65 79 73 28 29  d1.public_keys()
1650: 2e 30 29 2e 69 73 5f 65 72 72 28 29 29 3b 0a 0a  .0).is_err());..
1660: 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73 65              asse
1670: 72 74 21 28 73 69 67 6e 3a 3a 76 65 72 69 66 79  rt!(sign::verify
1680: 28 26 73 69 67 6e 32 2c 20 26 6d 61 69 64 32 2e  (&sign2, &maid2.
1690: 70 75 62 6c 69 63 5f 6b 65 79 73 28 29 2e 30 29  public_keys().0)
16a0: 2e 69 73 5f 6f 6b 28 29 29 3b 0a 20 20 20 20 20  .is_ok());.     
16b0: 20 20 20 20 20 20 20 61 73 73 65 72 74 21 28 73         assert!(s
16c0: 69 67 6e 3a 3a 76 65 72 69 66 79 28 26 73 69 67  ign::verify(&sig
16d0: 6e 32 2c 20 26 6d 61 69 64 31 2e 70 75 62 6c 69  n2, &maid1.publi
16e0: 63 5f 6b 65 79 73 28 29 2e 30 29 2e 69 73 5f 65  c_keys().0).is_e
16f0: 72 72 28 29 29 3b 0a 20 20 20 20 20 20 20 20 7d  rr());.        }
1700: 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 20 20  .        {.     
1710: 20 20 20 20 20 20 20 6c 65 74 20 6d 61 69 64 33         let maid3
1720: 20 3d 20 49 64 54 79 70 65 3a 3a 67 65 6e 65 72   = IdType::gener
1730: 61 74 65 5f 72 61 6e 64 6f 6d 28 29 3b 0a 0a 20  ate_random();.. 
1740: 20 20 20 20 20 20 20 20 20 20 20 6c 65 74 20 65             let e
1750: 6e 63 72 79 70 74 31 20 3d 20 6d 61 69 64 31 2e  ncrypt1 = maid1.
1760: 73 65 61 6c 28 26 72 61 6e 64 6f 6d 5f 62 79 74  seal(&random_byt
1770: 65 73 2c 20 26 6d 61 69 64 33 2e 70 75 62 6c 69  es, &maid3.publi
1780: 63 5f 6b 65 79 73 28 29 2e 31 29 3b 0a 20 20 20  c_keys().1);.   
1790: 20 20 20 20 20 20 20 20 20 6c 65 74 20 65 6e 63           let enc
17a0: 72 79 70 74 32 20 3d 20 6d 61 69 64 32 2e 73 65  rypt2 = maid2.se
17b0: 61 6c 28 26 72 61 6e 64 6f 6d 5f 62 79 74 65 73  al(&random_bytes
17c0: 2c 20 26 6d 61 69 64 33 2e 70 75 62 6c 69 63 5f  , &maid3.public_
17d0: 6b 65 79 73 28 29 2e 31 29 3b 0a 20 20 20 20 20  keys().1);.     
17e0: 20 20 20 20 20 20 20 61 73 73 65 72 74 21 28 65         assert!(e
17f0: 6e 63 72 79 70 74 31 2e 30 20 21 3d 20 65 6e 63  ncrypt1.0 != enc
1800: 72 79 70 74 32 2e 30 29 3b 0a 0a 20 20 20 20 20  rypt2.0);..     
1810: 20 20 20 20 20 20 20 61 73 73 65 72 74 21 28 6d         assert!(m
1820: 61 69 64 33 2e 6f 70 65 6e 28 26 65 6e 63 72 79  aid3.open(&encry
1830: 70 74 31 2e 30 2c 20 26 65 6e 63 72 79 70 74 31  pt1.0, &encrypt1
1840: 2e 31 2c 20 26 6d 61 69 64 31 2e 70 75 62 6c 69  .1, &maid1.publi
1850: 63 5f 6b 65 79 73 28 29 2e 31 29 2e 69 73 5f 6f  c_keys().1).is_o
1860: 6b 28 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20  k());.          
1870: 20 20 61 73 73 65 72 74 21 28 6d 61 69 64 33 2e    assert!(maid3.
1880: 6f 70 65 6e 28 26 65 6e 63 72 79 70 74 31 2e 30  open(&encrypt1.0
1890: 2c 20 26 65 6e 63 72 79 70 74 31 2e 31 2c 20 26  , &encrypt1.1, &
18a0: 6d 61 69 64 32 2e 70 75 62 6c 69 63 5f 6b 65 79  maid2.public_key
18b0: 73 28 29 2e 31 29 2e 69 73 5f 65 72 72 28 29 29  s().1).is_err())
18c0: 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 61  ;..            a
18d0: 73 73 65 72 74 21 28 6d 61 69 64 33 2e 6f 70 65  ssert!(maid3.ope
18e0: 6e 28 26 65 6e 63 72 79 70 74 32 2e 30 2c 20 26  n(&encrypt2.0, &
18f0: 65 6e 63 72 79 70 74 32 2e 31 2c 20 26 6d 61 69  encrypt2.1, &mai
1900: 64 32 2e 70 75 62 6c 69 63 5f 6b 65 79 73 28 29  d2.public_keys()
1910: 2e 31 29 2e 69 73 5f 6f 6b 28 29 29 3b 0a 20 20  .1).is_ok());.  
1920: 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74            assert
1930: 21 28 6d 61 69 64 33 2e 6f 70 65 6e 28 26 65 6e  !(maid3.open(&en
1940: 63 72 79 70 74 32 2e 30 2c 20 26 65 6e 63 72 79  crypt2.0, &encry
1950: 70 74 32 2e 31 2c 20 26 6d 61 69 64 31 2e 70 75  pt2.1, &maid1.pu
1960: 62 6c 69 63 5f 6b 65 79 73 28 29 2e 31 29 2e 69  blic_keys().1).i
1970: 73 5f 65 72 72 28 29 29 3b 0a 20 20 20 20 20 20  s_err());.      
1980: 20 20 7d 0a 20 20 20 20 7d 0a 7d 0a                }.    }.}.