Hex Artifact Content
Not logged in

Artifact 44c7232865216405fc6079690dd288b86397c817:


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 31 2e 20 20 54 68 69 73 2c 20 61  on 1.1.  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 61 63 74 69 6f 6e 3a  re...use action:
03f0: 3a 41 63 74 69 6f 6e 3b 0a 75 73 65 20 63 61 63  :Action;.use cac
0400: 68 65 3a 3a 4e 75 6c 6c 43 61 63 68 65 3b 0a 75  he::NullCache;.u
0410: 73 65 20 64 61 74 61 3a 3a 7b 41 70 70 65 6e 64  se data::{Append
0420: 57 72 61 70 70 65 72 2c 20 44 61 74 61 2c 20 44  Wrapper, Data, D
0430: 61 74 61 49 64 65 6e 74 69 66 69 65 72 7d 3b 0a  ataIdentifier};.
0440: 75 73 65 20 65 72 72 6f 72 3a 3a 7b 49 6e 74 65  use error::{Inte
0450: 72 66 61 63 65 45 72 72 6f 72 2c 20 52 6f 75 74  rfaceError, Rout
0460: 69 6e 67 45 72 72 6f 72 7d 3b 0a 75 73 65 20 65  ingError};.use e
0470: 76 65 6e 74 3a 3a 45 76 65 6e 74 3b 0a 75 73 65  vent::Event;.use
0480: 20 69 64 3a 3a 46 75 6c 6c 49 64 3b 0a 23 5b 63   id::FullId;.#[c
0490: 66 67 28 6e 6f 74 28 66 65 61 74 75 72 65 20 3d  fg(not(feature =
04a0: 20 22 75 73 65 2d 6d 6f 63 6b 2d 63 72 75 73 74   "use-mock-crust
04b0: 22 29 29 5d 0a 75 73 65 20 6d 61 69 64 73 61 66  "))].use maidsaf
04c0: 65 5f 75 74 69 6c 69 74 69 65 73 3a 3a 74 68 72  e_utilities::thr
04d0: 65 61 64 3a 3a 7b 73 65 6c 66 2c 20 4a 6f 69 6e  ead::{self, Join
04e0: 65 72 7d 3b 0a 75 73 65 20 6d 65 73 73 61 67 65  er};.use message
04f0: 73 3a 3a 7b 43 4c 49 45 4e 54 5f 47 45 54 5f 50  s::{CLIENT_GET_P
0500: 52 49 4f 52 49 54 59 2c 20 44 45 46 41 55 4c 54  RIORITY, DEFAULT
0510: 5f 50 52 49 4f 52 49 54 59 2c 20 52 65 71 75 65  _PRIORITY, Reque
0520: 73 74 7d 3b 0a 75 73 65 20 6f 75 74 62 6f 78 3a  st};.use outbox:
0530: 3a 7b 45 76 65 6e 74 42 6f 78 2c 20 45 76 65 6e  :{EventBox, Even
0540: 74 42 75 66 7d 3b 0a 75 73 65 20 72 6f 75 74 69  tBuf};.use routi
0550: 6e 67 5f 74 61 62 6c 65 3a 3a 41 75 74 68 6f 72  ng_table::Author
0560: 69 74 79 3b 0a 23 5b 63 66 67 28 6e 6f 74 28 66  ity;.#[cfg(not(f
0570: 65 61 74 75 72 65 20 3d 20 22 75 73 65 2d 6d 6f  eature = "use-mo
0580: 63 6b 2d 63 72 75 73 74 22 29 29 5d 0a 75 73 65  ck-crust"))].use
0590: 20 72 75 73 74 5f 73 6f 64 69 75 6d 3b 0a 75 73   rust_sodium;.us
05a0: 65 20 73 74 61 74 65 5f 6d 61 63 68 69 6e 65 3a  e state_machine:
05b0: 3a 7b 53 74 61 74 65 2c 20 53 74 61 74 65 4d 61  :{State, StateMa
05c0: 63 68 69 6e 65 7d 3b 0a 75 73 65 20 73 74 61 74  chine};.use stat
05d0: 65 73 3b 0a 23 5b 63 66 67 28 66 65 61 74 75 72  es;.#[cfg(featur
05e0: 65 20 3d 20 22 75 73 65 2d 6d 6f 63 6b 2d 63 72  e = "use-mock-cr
05f0: 75 73 74 22 29 5d 0a 75 73 65 20 73 74 64 3a 3a  ust")].use std::
0600: 63 65 6c 6c 3a 3a 52 65 66 43 65 6c 6c 3b 0a 75  cell::RefCell;.u
0610: 73 65 20 73 74 64 3a 3a 73 79 6e 63 3a 3a 6d 70  se std::sync::mp
0620: 73 63 3a 3a 7b 52 65 63 65 69 76 65 72 2c 20 53  sc::{Receiver, S
0630: 65 6e 64 65 72 2c 20 63 68 61 6e 6e 65 6c 7d 3b  ender, channel};
0640: 0a 23 5b 63 66 67 28 66 65 61 74 75 72 65 20 3d  .#[cfg(feature =
0650: 20 22 75 73 65 2d 6d 6f 63 6b 2d 63 72 75 73 74   "use-mock-crust
0660: 22 29 5d 0a 75 73 65 20 73 74 64 3a 3a 73 79 6e  ")].use std::syn
0670: 63 3a 3a 6d 70 73 63 3a 3a 54 72 79 52 65 63 76  c::mpsc::TryRecv
0680: 45 72 72 6f 72 3b 0a 75 73 65 20 74 79 70 65 73  Error;.use types
0690: 3a 3a 4d 65 73 73 61 67 65 49 64 3b 0a 75 73 65  ::MessageId;.use
06a0: 20 74 79 70 65 73 3a 3a 52 6f 75 74 69 6e 67 41   types::RoutingA
06b0: 63 74 69 6f 6e 53 65 6e 64 65 72 3b 0a 75 73 65  ctionSender;.use
06c0: 20 78 6f 72 5f 6e 61 6d 65 3a 3a 58 6f 72 4e 61   xor_name::XorNa
06d0: 6d 65 3b 0a 0a 2f 2f 2f 20 49 6e 74 65 72 66 61  me;../// Interfa
06e0: 63 65 20 66 6f 72 20 73 65 6e 64 69 6e 67 20 61  ce for sending a
06f0: 6e 64 20 72 65 63 65 69 76 69 6e 67 20 6d 65 73  nd receiving mes
0700: 73 61 67 65 73 20 74 6f 20 61 6e 64 20 66 72 6f  sages to and fro
0710: 6d 20 61 20 6e 65 74 77 6f 72 6b 20 6f 66 20 6e  m a network of n
0720: 6f 64 65 73 20 69 6e 20 74 68 65 20 72 6f 6c 65  odes in the role
0730: 20 6f 66 20 61 0a 2f 2f 2f 20 63 6c 69 65 6e 74   of a./// client
0740: 2e 0a 2f 2f 2f 0a 2f 2f 2f 20 41 20 63 6c 69 65  ..///./// A clie
0750: 6e 74 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20  nt is connected 
0760: 74 6f 20 74 68 65 20 6e 65 74 77 6f 72 6b 20 76  to the network v
0770: 69 61 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6e  ia one or more n
0780: 6f 64 65 73 2e 20 4d 65 73 73 61 67 65 73 20 61  odes. Messages a
0790: 72 65 20 6e 65 76 65 72 20 72 6f 75 74 65 64 20  re never routed 
07a0: 76 69 61 20 61 0a 2f 2f 2f 20 63 6c 69 65 6e 74  via a./// client
07b0: 2c 20 61 6e 64 20 61 20 63 6c 69 65 6e 74 20 63  , and a client c
07c0: 61 6e 6e 6f 74 20 62 65 20 70 61 72 74 20 6f 66  annot be part of
07d0: 20 61 20 73 65 63 74 69 6f 6e 20 61 75 74 68 6f   a section autho
07e0: 72 69 74 79 2e 0a 70 75 62 20 73 74 72 75 63 74  rity..pub struct
07f0: 20 43 6c 69 65 6e 74 20 7b 0a 20 20 20 20 69 6e   Client {.    in
0800: 74 65 72 66 61 63 65 5f 72 65 73 75 6c 74 5f 74  terface_result_t
0810: 78 3a 20 53 65 6e 64 65 72 3c 52 65 73 75 6c 74  x: Sender<Result
0820: 3c 28 29 2c 20 49 6e 74 65 72 66 61 63 65 45 72  <(), InterfaceEr
0830: 72 6f 72 3e 3e 2c 0a 20 20 20 20 69 6e 74 65 72  ror>>,.    inter
0840: 66 61 63 65 5f 72 65 73 75 6c 74 5f 72 78 3a 20  face_result_rx: 
0850: 52 65 63 65 69 76 65 72 3c 52 65 73 75 6c 74 3c  Receiver<Result<
0860: 28 29 2c 20 49 6e 74 65 72 66 61 63 65 45 72 72  (), InterfaceErr
0870: 6f 72 3e 3e 2c 0a 20 20 20 20 61 63 74 69 6f 6e  or>>,.    action
0880: 5f 73 65 6e 64 65 72 3a 20 52 6f 75 74 69 6e 67  _sender: Routing
0890: 41 63 74 69 6f 6e 53 65 6e 64 65 72 2c 0a 0a 20  ActionSender,.. 
08a0: 20 20 20 23 5b 63 66 67 28 66 65 61 74 75 72 65     #[cfg(feature
08b0: 20 3d 20 22 75 73 65 2d 6d 6f 63 6b 2d 63 72 75   = "use-mock-cru
08c0: 73 74 22 29 5d 0a 20 20 20 20 6d 61 63 68 69 6e  st")].    machin
08d0: 65 3a 20 52 65 66 43 65 6c 6c 3c 53 74 61 74 65  e: RefCell<State
08e0: 4d 61 63 68 69 6e 65 3e 2c 0a 0a 20 20 20 20 23  Machine>,..    #
08f0: 5b 63 66 67 28 66 65 61 74 75 72 65 20 3d 20 22  [cfg(feature = "
0900: 75 73 65 2d 6d 6f 63 6b 2d 63 72 75 73 74 22 29  use-mock-crust")
0910: 5d 0a 20 20 20 20 65 76 65 6e 74 5f 62 75 66 66  ].    event_buff
0920: 65 72 3a 20 52 65 66 43 65 6c 6c 3c 45 76 65 6e  er: RefCell<Even
0930: 74 42 75 66 3e 2c 0a 0a 20 20 20 20 23 5b 63 66  tBuf>,..    #[cf
0940: 67 28 6e 6f 74 28 66 65 61 74 75 72 65 20 3d 20  g(not(feature = 
0950: 22 75 73 65 2d 6d 6f 63 6b 2d 63 72 75 73 74 22  "use-mock-crust"
0960: 29 29 5d 0a 20 20 20 20 5f 72 61 69 69 5f 6a 6f  ))].    _raii_jo
0970: 69 6e 65 72 3a 20 4a 6f 69 6e 65 72 2c 0a 7d 0a  iner: Joiner,.}.
0980: 0a 69 6d 70 6c 20 43 6c 69 65 6e 74 20 7b 0a 20  .impl Client {. 
0990: 20 20 20 2f 2f 2f 20 43 72 65 61 74 65 20 61 20     /// Create a 
09a0: 6e 65 77 20 60 43 6c 69 65 6e 74 60 2e 0a 20 20  new `Client`..  
09b0: 20 20 2f 2f 2f 0a 20 20 20 20 2f 2f 2f 20 49 74    ///.    /// It
09c0: 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61   will automatica
09d0: 6c 6c 79 20 63 6f 6e 6e 65 63 74 20 74 6f 20 74  lly connect to t
09e0: 68 65 20 6e 65 74 77 6f 72 6b 2c 20 62 75 74 20  he network, but 
09f0: 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 61  not attempt to a
0a00: 63 68 69 65 76 65 20 66 75 6c 6c 20 72 6f 75 74  chieve full rout
0a10: 69 6e 67 20 6e 6f 64 65 0a 20 20 20 20 2f 2f 2f  ing node.    ///
0a20: 20 73 74 61 74 75 73 2e 20 54 68 65 20 6e 61 6d   status. The nam
0a30: 65 20 6f 66 20 74 68 65 20 63 6c 69 65 6e 74 20  e of the client 
0a40: 77 69 6c 6c 20 62 65 20 74 68 65 20 6e 61 6d 65  will be the name
0a50: 20 6f 66 20 74 68 65 20 60 50 75 62 6c 69 63 49   of the `PublicI
0a60: 64 60 20 6f 66 20 74 68 65 20 60 6b 65 79 73 60  d` of the `keys`
0a70: 20 61 6e 64 20 6d 75 73 74 0a 20 20 20 20 2f 2f   and must.    //
0a80: 2f 20 65 71 75 61 6c 20 74 68 65 20 53 48 41 35  / equal the SHA5
0a90: 31 32 20 68 61 73 68 20 6f 66 20 69 74 73 20 70  12 hash of its p
0aa0: 75 62 6c 69 63 20 73 69 67 6e 69 6e 67 20 6b 65  ublic signing ke
0ab0: 79 2c 20 6f 74 68 65 72 77 69 73 65 20 74 68 65  y, otherwise the
0ac0: 20 63 6c 69 65 6e 74 20 77 69 6c 6c 20 62 65 20   client will be 
0ad0: 69 6e 73 74 61 6e 74 6c 79 0a 20 20 20 20 2f 2f  instantly.    //
0ae0: 2f 20 74 65 72 6d 69 6e 61 74 65 64 2e 0a 20 20  / terminated..  
0af0: 20 20 2f 2f 2f 0a 20 20 20 20 2f 2f 2f 20 4b 65    ///.    /// Ke
0b00: 79 73 20 77 69 6c 6c 20 62 65 20 65 78 63 68 61  ys will be excha
0b10: 6e 67 65 64 20 77 69 74 68 20 74 68 65 20 60 43  nged with the `C
0b20: 6c 69 65 6e 74 41 75 74 68 6f 72 69 74 79 60 20  lientAuthority` 
0b30: 73 6f 20 74 68 61 74 20 63 6f 6d 6d 75 6e 69 63  so that communic
0b40: 61 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 6e  ation with the n
0b50: 65 74 77 6f 72 6b 20 69 73 0a 20 20 20 20 2f 2f  etwork is.    //
0b60: 2f 20 63 72 79 70 74 6f 67 72 61 70 68 69 63 61  / cryptographica
0b70: 6c 6c 79 20 73 65 63 75 72 65 20 61 6e 64 20 75  lly secure and u
0b80: 73 65 73 20 73 65 63 74 69 6f 6e 20 63 6f 6e 73  ses section cons
0b90: 65 6e 73 75 73 2e 20 54 68 65 20 72 65 73 74 72  ensus. The restr
0ba0: 69 63 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 63  iction for the c
0bb0: 6c 69 65 6e 74 20 6e 61 6d 65 0a 20 20 20 20 2f  lient name.    /
0bc0: 2f 2f 20 65 78 69 73 74 73 20 74 6f 20 65 6e 73  // exists to ens
0bd0: 75 72 65 20 74 68 61 74 20 74 68 65 20 63 6c 69  ure that the cli
0be0: 65 6e 74 20 63 61 6e 6e 6f 74 20 63 68 6f 6f 73  ent cannot choos
0bf0: 65 20 69 74 73 20 60 43 6c 69 65 6e 74 41 75 74  e its `ClientAut
0c00: 68 6f 72 69 74 79 60 2e 0a 20 20 20 20 23 5b 63  hority`..    #[c
0c10: 66 67 28 6e 6f 74 28 66 65 61 74 75 72 65 20 3d  fg(not(feature =
0c20: 20 22 75 73 65 2d 6d 6f 63 6b 2d 63 72 75 73 74   "use-mock-crust
0c30: 22 29 29 5d 0a 20 20 20 20 70 75 62 20 66 6e 20  "))].    pub fn 
0c40: 6e 65 77 28 65 76 65 6e 74 5f 73 65 6e 64 65 72  new(event_sender
0c50: 3a 20 53 65 6e 64 65 72 3c 45 76 65 6e 74 3e 2c  : Sender<Event>,
0c60: 20 6b 65 79 73 3a 20 4f 70 74 69 6f 6e 3c 46 75   keys: Option<Fu
0c70: 6c 6c 49 64 3e 29 20 2d 3e 20 52 65 73 75 6c 74  llId>) -> Result
0c80: 3c 43 6c 69 65 6e 74 2c 20 52 6f 75 74 69 6e 67  <Client, Routing
0c90: 45 72 72 6f 72 3e 20 7b 0a 20 20 20 20 20 20 20  Error> {.       
0ca0: 20 2f 2f 20 54 4f 44 4f 20 2d 20 72 65 70 6c 61   // TODO - repla
0cb0: 63 65 20 74 68 69 73 20 68 61 72 64 2d 63 6f 64  ce this hard-cod
0cc0: 65 64 20 76 61 6c 75 65 0a 20 20 20 20 20 20 20  ed value.       
0cd0: 20 6c 65 74 20 6d 69 6e 5f 73 65 63 74 69 6f 6e   let min_section
0ce0: 5f 73 69 7a 65 20 3d 20 38 3b 0a 20 20 20 20 20  _size = 8;.     
0cf0: 20 20 20 72 75 73 74 5f 73 6f 64 69 75 6d 3a 3a     rust_sodium::
0d00: 69 6e 69 74 28 29 3b 20 2f 2f 20 65 6e 61 62 6c  init(); // enabl
0d10: 65 20 73 68 61 72 65 64 20 67 6c 6f 62 61 6c 20  e shared global 
0d20: 28 69 2e 65 2e 20 73 61 66 65 20 74 6f 20 6d 75  (i.e. safe to mu
0d30: 6c 74 69 74 68 72 65 61 64 20 6e 6f 77 29 0a 0a  ltithread now)..
0d40: 20 20 20 20 20 20 20 20 2f 2f 20 73 74 61 72 74          // start
0d50: 20 74 68 65 20 68 61 6e 64 6c 65 72 20 66 6f 72   the handler for
0d60: 20 72 6f 75 74 69 6e 67 20 77 69 74 68 20 61 20   routing with a 
0d70: 72 65 73 74 72 69 63 74 69 6f 6e 20 74 6f 20 62  restriction to b
0d80: 65 63 6f 6d 65 20 61 20 66 75 6c 6c 20 6e 6f 64  ecome a full nod
0d90: 65 0a 20 20 20 20 20 20 20 20 6c 65 74 20 6d 75  e.        let mu
0da0: 74 20 65 76 65 6e 74 5f 62 75 66 66 65 72 20 3d  t event_buffer =
0db0: 20 45 76 65 6e 74 42 75 66 3a 3a 6e 65 77 28 29   EventBuf::new()
0dc0: 3b 0a 20 20 20 20 20 20 20 20 6c 65 74 20 28 61  ;.        let (a
0dd0: 63 74 69 6f 6e 5f 73 65 6e 64 65 72 2c 20 6d 75  ction_sender, mu
0de0: 74 20 6d 61 63 68 69 6e 65 29 20 3d 0a 20 20 20  t machine) =.   
0df0: 20 20 20 20 20 20 20 20 20 53 65 6c 66 3a 3a 6d           Self::m
0e00: 61 6b 65 5f 73 74 61 74 65 5f 6d 61 63 68 69 6e  ake_state_machin
0e10: 65 28 6b 65 79 73 2c 20 6d 69 6e 5f 73 65 63 74  e(keys, min_sect
0e20: 69 6f 6e 5f 73 69 7a 65 2c 20 26 6d 75 74 20 65  ion_size, &mut e
0e30: 76 65 6e 74 5f 62 75 66 66 65 72 29 3b 0a 0a 20  vent_buffer);.. 
0e40: 20 20 20 20 20 20 20 66 6f 72 20 65 76 20 69 6e         for ev in
0e50: 20 65 76 65 6e 74 5f 62 75 66 66 65 72 2e 74 61   event_buffer.ta
0e60: 6b 65 5f 61 6c 6c 28 29 20 7b 0a 20 20 20 20 20  ke_all() {.     
0e70: 20 20 20 20 20 20 20 65 76 65 6e 74 5f 73 65 6e         event_sen
0e80: 64 65 72 2e 73 65 6e 64 28 65 76 29 3f 3b 0a 20  der.send(ev)?;. 
0e90: 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20         }..      
0ea0: 20 20 6c 65 74 20 28 74 78 2c 20 72 78 29 20 3d    let (tx, rx) =
0eb0: 20 63 68 61 6e 6e 65 6c 28 29 3b 0a 0a 20 20 20   channel();..   
0ec0: 20 20 20 20 20 6c 65 74 20 72 61 69 69 5f 6a 6f       let raii_jo
0ed0: 69 6e 65 72 20 3d 20 74 68 72 65 61 64 3a 3a 6e  iner = thread::n
0ee0: 61 6d 65 64 28 22 43 6c 69 65 6e 74 20 74 68 72  amed("Client thr
0ef0: 65 61 64 22 2c 20 6d 6f 76 65 20 7c 7c 20 7b 0a  ead", move || {.
0f00: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 47              // G
0f10: 61 74 68 65 72 20 65 76 65 6e 74 73 20 66 72 6f  ather events fro
0f20: 6d 20 74 68 65 20 73 74 61 74 65 20 6d 61 63 68  m the state mach
0f30: 69 6e 65 27 73 20 65 76 65 6e 74 20 6c 6f 6f 70  ine's event loop
0f40: 20 61 6e 64 20 70 72 6f 78 79 20 74 68 65 6d 20   and proxy them 
0f50: 6f 76 65 72 20 74 68 65 0a 20 20 20 20 20 20 20  over the.       
0f60: 20 20 20 20 20 2f 2f 20 65 76 65 6e 74 5f 73 65       // event_se
0f70: 6e 64 65 72 20 63 68 61 6e 6e 65 6c 2e 0a 20 20  nder channel..  
0f80: 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 20            while 
0f90: 4f 6b 28 28 29 29 20 3d 3d 20 6d 61 63 68 69 6e  Ok(()) == machin
0fa0: 65 2e 73 74 65 70 28 26 6d 75 74 20 65 76 65 6e  e.step(&mut even
0fb0: 74 5f 62 75 66 66 65 72 29 20 7b 0a 20 20 20 20  t_buffer) {.    
0fc0: 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 20              for 
0fd0: 65 76 20 69 6e 20 65 76 65 6e 74 5f 62 75 66 66  ev in event_buff
0fe0: 65 72 2e 74 61 6b 65 5f 61 6c 6c 28 29 20 7b 0a  er.take_all() {.
0ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1000: 20 20 20 20 2f 2f 20 49 66 20 73 65 6e 64 69 6e      // If sendin
1010: 67 20 74 68 65 20 65 76 65 6e 74 20 66 61 69 6c  g the event fail
1020: 73 2c 20 74 65 72 6d 69 6e 61 74 65 20 74 68 69  s, terminate thi
1030: 73 20 74 68 72 65 61 64 2e 0a 20 20 20 20 20 20  s thread..      
1040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66                if
1050: 20 65 76 65 6e 74 5f 73 65 6e 64 65 72 2e 73 65   event_sender.se
1060: 6e 64 28 65 76 29 2e 69 73 5f 65 72 72 28 29 20  nd(ev).is_err() 
1070: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  {.              
1080: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
1090: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;.              
10a0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
10b0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
10c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
10d0: 20 20 20 20 2f 2f 20 57 68 65 6e 20 74 68 65 72      // When ther
10e0: 65 20 61 72 65 20 6e 6f 20 6d 6f 72 65 20 65 76  e are no more ev
10f0: 65 6e 74 73 20 74 6f 20 70 72 6f 63 65 73 73 2c  ents to process,
1100: 20 74 65 72 6d 69 6e 61 74 65 20 74 68 69 73 20   terminate this 
1110: 74 68 72 65 61 64 2e 0a 20 20 20 20 20 20 20 20  thread..        
1120: 7d 29 3b 0a 0a 20 20 20 20 20 20 20 20 4f 6b 28  });..        Ok(
1130: 43 6c 69 65 6e 74 20 7b 0a 20 20 20 20 20 20 20  Client {.       
1140: 20 20 20 20 20 69 6e 74 65 72 66 61 63 65 5f 72       interface_r
1150: 65 73 75 6c 74 5f 74 78 3a 20 74 78 2c 0a 20 20  esult_tx: tx,.  
1160: 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 66            interf
1170: 61 63 65 5f 72 65 73 75 6c 74 5f 72 78 3a 20 72  ace_result_rx: r
1180: 78 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 61  x,.            a
1190: 63 74 69 6f 6e 5f 73 65 6e 64 65 72 3a 20 61 63  ction_sender: ac
11a0: 74 69 6f 6e 5f 73 65 6e 64 65 72 2c 0a 20 20 20  tion_sender,.   
11b0: 20 20 20 20 20 20 20 20 20 5f 72 61 69 69 5f 6a           _raii_j
11c0: 6f 69 6e 65 72 3a 20 72 61 69 69 5f 6a 6f 69 6e  oiner: raii_join
11d0: 65 72 2c 0a 20 20 20 20 20 20 20 20 7d 29 0a 20  er,.        }). 
11e0: 20 20 20 7d 0a 0a 20 20 20 20 66 6e 20 6d 61 6b     }..    fn mak
11f0: 65 5f 73 74 61 74 65 5f 6d 61 63 68 69 6e 65 28  e_state_machine(
1200: 6b 65 79 73 3a 20 4f 70 74 69 6f 6e 3c 46 75 6c  keys: Option<Ful
1210: 6c 49 64 3e 2c 0a 20 20 20 20 20 20 20 20 20 20  lId>,.          
1220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1230: 6d 69 6e 5f 73 65 63 74 69 6f 6e 5f 73 69 7a 65  min_section_size
1240: 3a 20 75 73 69 7a 65 2c 0a 20 20 20 20 20 20 20  : usize,.       
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1260: 20 20 20 6f 75 74 62 6f 78 3a 20 26 6d 75 74 20     outbox: &mut 
1270: 45 76 65 6e 74 42 6f 78 29 0a 20 20 20 20 20 20  EventBox).      
1280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1290: 20 20 20 20 2d 3e 20 28 52 6f 75 74 69 6e 67 41      -> (RoutingA
12a0: 63 74 69 6f 6e 53 65 6e 64 65 72 2c 20 53 74 61  ctionSender, Sta
12b0: 74 65 4d 61 63 68 69 6e 65 29 20 7b 0a 20 20 20  teMachine) {.   
12c0: 20 20 20 20 20 6c 65 74 20 63 61 63 68 65 20 3d       let cache =
12d0: 20 42 6f 78 3a 3a 6e 65 77 28 4e 75 6c 6c 43 61   Box::new(NullCa
12e0: 63 68 65 29 3b 0a 20 20 20 20 20 20 20 20 6c 65  che);.        le
12f0: 74 20 66 75 6c 6c 5f 69 64 20 3d 20 6b 65 79 73  t full_id = keys
1300: 2e 75 6e 77 72 61 70 5f 6f 72 5f 65 6c 73 65 28  .unwrap_or_else(
1310: 46 75 6c 6c 49 64 3a 3a 6e 65 77 29 3b 0a 0a 20  FullId::new);.. 
1320: 20 20 20 20 20 20 20 53 74 61 74 65 4d 61 63 68         StateMach
1330: 69 6e 65 3a 3a 6e 65 77 28 6d 6f 76 65 20 7c 63  ine::new(move |c
1340: 72 75 73 74 5f 73 65 72 76 69 63 65 2c 20 74 69  rust_service, ti
1350: 6d 65 72 2c 20 5f 6f 75 74 62 6f 78 32 7c 20 7b  mer, _outbox2| {
1360: 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61  .            sta
1370: 74 65 73 3a 3a 42 6f 6f 74 73 74 72 61 70 70 69  tes::Bootstrappi
1380: 6e 67 3a 3a 6e 65 77 28 63 61 63 68 65 2c 20 74  ng::new(cache, t
1390: 72 75 65 2c 20 63 72 75 73 74 5f 73 65 72 76 69  rue, crust_servi
13a0: 63 65 2c 20 66 75 6c 6c 5f 69 64 2c 20 6d 69 6e  ce, full_id, min
13b0: 5f 73 65 63 74 69 6f 6e 5f 73 69 7a 65 2c 20 74  _section_size, t
13c0: 69 6d 65 72 29 0a 20 20 20 20 20 20 20 20 20 20  imer).          
13d0: 20 20 20 20 20 20 2e 6d 61 70 5f 6f 72 28 53 74        .map_or(St
13e0: 61 74 65 3a 3a 54 65 72 6d 69 6e 61 74 65 64 2c  ate::Terminated,
13f0: 20 53 74 61 74 65 3a 3a 42 6f 6f 74 73 74 72 61   State::Bootstra
1400: 70 70 69 6e 67 29 0a 20 20 20 20 20 20 20 20 7d  pping).        }
1410: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
1420: 20 20 20 20 20 20 20 20 20 20 20 20 6f 75 74 62              outb
1430: 6f 78 29 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  ox).    }..    /
1440: 2f 2f 20 53 65 6e 64 20 61 20 47 65 74 20 6d 65  // Send a Get me
1450: 73 73 61 67 65 20 77 69 74 68 20 61 20 60 44 61  ssage with a `Da
1460: 74 61 49 64 65 6e 74 69 66 69 65 72 60 20 74 6f  taIdentifier` to
1470: 20 61 6e 20 60 41 75 74 68 6f 72 69 74 79 60 2c   an `Authority`,
1480: 20 73 69 67 6e 65 64 20 77 69 74 68 20 67 69 76   signed with giv
1490: 65 6e 20 6b 65 79 73 2e 0a 20 20 20 20 70 75 62  en keys..    pub
14a0: 20 66 6e 20 73 65 6e 64 5f 67 65 74 5f 72 65 71   fn send_get_req
14b0: 75 65 73 74 28 26 73 65 6c 66 2c 0a 20 20 20 20  uest(&self,.    
14c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14d0: 20 20 20 20 20 20 20 20 64 73 74 3a 20 41 75 74          dst: Aut
14e0: 68 6f 72 69 74 79 3c 58 6f 72 4e 61 6d 65 3e 2c  hority<XorName>,
14f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
1500: 20 20 20 20 20 20 20 20 20 20 20 20 20 64 61 74               dat
1510: 61 5f 69 64 3a 20 44 61 74 61 49 64 65 6e 74 69  a_id: DataIdenti
1520: 66 69 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20  fier,.          
1530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1540: 20 20 6d 65 73 73 61 67 65 5f 69 64 3a 20 4d 65    message_id: Me
1550: 73 73 61 67 65 49 64 29 0a 20 20 20 20 20 20 20  ssageId).       
1560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1570: 20 20 20 20 20 2d 3e 20 52 65 73 75 6c 74 3c 28       -> Result<(
1580: 29 2c 20 49 6e 74 65 72 66 61 63 65 45 72 72 6f  ), InterfaceErro
1590: 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 73 65 6c  r> {.        sel
15a0: 66 2e 73 65 6e 64 5f 61 63 74 69 6f 6e 28 52 65  f.send_action(Re
15b0: 71 75 65 73 74 3a 3a 47 65 74 28 64 61 74 61 5f  quest::Get(data_
15c0: 69 64 2c 20 6d 65 73 73 61 67 65 5f 69 64 29 2c  id, message_id),
15d0: 20 64 73 74 2c 20 43 4c 49 45 4e 54 5f 47 45 54   dst, CLIENT_GET
15e0: 5f 50 52 49 4f 52 49 54 59 29 0a 20 20 20 20 7d  _PRIORITY).    }
15f0: 0a 0a 20 20 20 20 2f 2f 2f 20 41 64 64 20 73 6f  ..    /// Add so
1600: 6d 65 74 68 69 6e 67 20 74 6f 20 74 68 65 20 6e  mething to the n
1610: 65 74 77 6f 72 6b 0a 20 20 20 20 70 75 62 20 66  etwork.    pub f
1620: 6e 20 73 65 6e 64 5f 70 75 74 5f 72 65 71 75 65  n send_put_reque
1630: 73 74 28 26 73 65 6c 66 2c 0a 20 20 20 20 20 20  st(&self,.      
1640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1650: 20 20 20 20 20 20 64 73 74 3a 20 41 75 74 68 6f        dst: Autho
1660: 72 69 74 79 3c 58 6f 72 4e 61 6d 65 3e 2c 0a 20  rity<XorName>,. 
1670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1680: 20 20 20 20 20 20 20 20 20 20 20 64 61 74 61 3a             data:
1690: 20 44 61 74 61 2c 0a 20 20 20 20 20 20 20 20 20   Data,.         
16a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
16b0: 20 20 20 6d 65 73 73 61 67 65 5f 69 64 3a 20 4d     message_id: M
16c0: 65 73 73 61 67 65 49 64 29 0a 20 20 20 20 20 20  essageId).      
16d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
16e0: 20 20 20 20 20 20 2d 3e 20 52 65 73 75 6c 74 3c        -> Result<
16f0: 28 29 2c 20 49 6e 74 65 72 66 61 63 65 45 72 72  (), InterfaceErr
1700: 6f 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 73 65  or> {.        se
1710: 6c 66 2e 73 65 6e 64 5f 61 63 74 69 6f 6e 28 52  lf.send_action(R
1720: 65 71 75 65 73 74 3a 3a 50 75 74 28 64 61 74 61  equest::Put(data
1730: 2c 20 6d 65 73 73 61 67 65 5f 69 64 29 2c 20 64  , message_id), d
1740: 73 74 2c 20 44 45 46 41 55 4c 54 5f 50 52 49 4f  st, DEFAULT_PRIO
1750: 52 49 54 59 29 0a 20 20 20 20 7d 0a 0a 20 20 20  RITY).    }..   
1760: 20 2f 2f 2f 20 43 68 61 6e 67 65 20 73 6f 6d 65   /// Change some
1770: 74 68 69 6e 67 20 61 6c 72 65 61 64 79 20 6f 6e  thing already on
1780: 20 74 68 65 20 6e 65 74 77 6f 72 6b 0a 20 20 20   the network.   
1790: 20 70 75 62 20 66 6e 20 73 65 6e 64 5f 70 6f 73   pub fn send_pos
17a0: 74 5f 72 65 71 75 65 73 74 28 26 73 65 6c 66 2c  t_request(&self,
17b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
17c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 73                ds
17d0: 74 3a 20 41 75 74 68 6f 72 69 74 79 3c 58 6f 72  t: Authority<Xor
17e0: 4e 61 6d 65 3e 2c 0a 20 20 20 20 20 20 20 20 20  Name>,.         
17f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1800: 20 20 20 20 64 61 74 61 3a 20 44 61 74 61 2c 0a      data: Data,.
1810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1820: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 73               mes
1830: 73 61 67 65 5f 69 64 3a 20 4d 65 73 73 61 67 65  sage_id: Message
1840: 49 64 29 0a 20 20 20 20 20 20 20 20 20 20 20 20  Id).            
1850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1860: 20 2d 3e 20 52 65 73 75 6c 74 3c 28 29 2c 20 49   -> Result<(), I
1870: 6e 74 65 72 66 61 63 65 45 72 72 6f 72 3e 20 7b  nterfaceError> {
1880: 0a 20 20 20 20 20 20 20 20 73 65 6c 66 2e 73 65  .        self.se
1890: 6e 64 5f 61 63 74 69 6f 6e 28 52 65 71 75 65 73  nd_action(Reques
18a0: 74 3a 3a 50 6f 73 74 28 64 61 74 61 2c 20 6d 65  t::Post(data, me
18b0: 73 73 61 67 65 5f 69 64 29 2c 20 64 73 74 2c 20  ssage_id), dst, 
18c0: 44 45 46 41 55 4c 54 5f 50 52 49 4f 52 49 54 59  DEFAULT_PRIORITY
18d0: 29 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f  ).    }..    ///
18e0: 20 52 65 6d 6f 76 65 20 73 6f 6d 65 74 68 69 6e   Remove somethin
18f0: 67 20 66 72 6f 6d 20 74 68 65 20 6e 65 74 77 6f  g from the netwo
1900: 72 6b 0a 20 20 20 20 70 75 62 20 66 6e 20 73 65  rk.    pub fn se
1910: 6e 64 5f 64 65 6c 65 74 65 5f 72 65 71 75 65 73  nd_delete_reques
1920: 74 28 26 73 65 6c 66 2c 0a 20 20 20 20 20 20 20  t(&self,.       
1930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1940: 20 20 20 20 20 20 20 20 64 73 74 3a 20 41 75 74          dst: Aut
1950: 68 6f 72 69 74 79 3c 58 6f 72 4e 61 6d 65 3e 2c  hority<XorName>,
1960: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
1970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1980: 64 61 74 61 3a 20 44 61 74 61 2c 0a 20 20 20 20  data: Data,.    
1990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
19a0: 20 20 20 20 20 20 20 20 20 20 20 6d 65 73 73 61             messa
19b0: 67 65 5f 69 64 3a 20 4d 65 73 73 61 67 65 49 64  ge_id: MessageId
19c0: 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ).              
19d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
19e0: 20 2d 3e 20 52 65 73 75 6c 74 3c 28 29 2c 20 49   -> Result<(), I
19f0: 6e 74 65 72 66 61 63 65 45 72 72 6f 72 3e 20 7b  nterfaceError> {
1a00: 0a 20 20 20 20 20 20 20 20 73 65 6c 66 2e 73 65  .        self.se
1a10: 6e 64 5f 61 63 74 69 6f 6e 28 52 65 71 75 65 73  nd_action(Reques
1a20: 74 3a 3a 44 65 6c 65 74 65 28 64 61 74 61 2c 20  t::Delete(data, 
1a30: 6d 65 73 73 61 67 65 5f 69 64 29 2c 20 64 73 74  message_id), dst
1a40: 2c 20 44 45 46 41 55 4c 54 5f 50 52 49 4f 52 49  , DEFAULT_PRIORI
1a50: 54 59 29 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  TY).    }..    /
1a60: 2f 2f 20 41 70 70 65 6e 64 20 61 6e 20 69 74 65  // Append an ite
1a70: 6d 20 74 6f 20 61 70 70 65 6e 64 61 62 6c 65 20  m to appendable 
1a80: 64 61 74 61 2e 0a 20 20 20 20 70 75 62 20 66 6e  data..    pub fn
1a90: 20 73 65 6e 64 5f 61 70 70 65 6e 64 5f 72 65 71   send_append_req
1aa0: 75 65 73 74 28 26 73 65 6c 66 2c 0a 20 20 20 20  uest(&self,.    
1ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ac0: 20 20 20 20 20 20 20 20 20 20 20 64 73 74 3a 20             dst: 
1ad0: 41 75 74 68 6f 72 69 74 79 3c 58 6f 72 4e 61 6d  Authority<XorNam
1ae0: 65 3e 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  e>,.            
1af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b00: 20 20 20 77 72 61 70 70 65 72 3a 20 41 70 70 65     wrapper: Appe
1b10: 6e 64 57 72 61 70 70 65 72 2c 0a 20 20 20 20 20  ndWrapper,.     
1b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b30: 20 20 20 20 20 20 20 20 20 20 6d 65 73 73 61 67            messag
1b40: 65 5f 69 64 3a 20 4d 65 73 73 61 67 65 49 64 29  e_id: MessageId)
1b50: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
1b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b70: 2d 3e 20 52 65 73 75 6c 74 3c 28 29 2c 20 49 6e  -> Result<(), In
1b80: 74 65 72 66 61 63 65 45 72 72 6f 72 3e 20 7b 0a  terfaceError> {.
1b90: 20 20 20 20 20 20 20 20 73 65 6c 66 2e 73 65 6e          self.sen
1ba0: 64 5f 61 63 74 69 6f 6e 28 52 65 71 75 65 73 74  d_action(Request
1bb0: 3a 3a 41 70 70 65 6e 64 28 77 72 61 70 70 65 72  ::Append(wrapper
1bc0: 2c 20 6d 65 73 73 61 67 65 5f 69 64 29 2c 20 64  , message_id), d
1bd0: 73 74 2c 20 44 45 46 41 55 4c 54 5f 50 52 49 4f  st, DEFAULT_PRIO
1be0: 52 49 54 59 29 0a 20 20 20 20 7d 0a 0a 0a 20 20  RITY).    }...  
1bf0: 20 20 2f 2f 2f 20 52 65 71 75 65 73 74 20 61 63    /// Request ac
1c00: 63 6f 75 6e 74 20 69 6e 66 6f 72 6d 61 74 69 6f  count informatio
1c10: 6e 20 66 6f 72 20 74 68 65 20 43 6c 69 65 6e 74  n for the Client
1c20: 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75   calling this fu
1c30: 6e 63 74 69 6f 6e 0a 20 20 20 20 70 75 62 20 66  nction.    pub f
1c40: 6e 20 73 65 6e 64 5f 67 65 74 5f 61 63 63 6f 75  n send_get_accou
1c50: 6e 74 5f 69 6e 66 6f 5f 72 65 71 75 65 73 74 28  nt_info_request(
1c60: 26 73 65 6c 66 2c 0a 20 20 20 20 20 20 20 20 20  &self,.         
1c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c90: 64 73 74 3a 20 41 75 74 68 6f 72 69 74 79 3c 58  dst: Authority<X
1ca0: 6f 72 4e 61 6d 65 3e 2c 0a 20 20 20 20 20 20 20  orName>,.       
1cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1cd0: 20 20 6d 65 73 73 61 67 65 5f 69 64 3a 20 4d 65    message_id: Me
1ce0: 73 73 61 67 65 49 64 29 0a 20 20 20 20 20 20 20  ssageId).       
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d10: 20 20 2d 3e 20 52 65 73 75 6c 74 3c 28 29 2c 20    -> Result<(), 
1d20: 49 6e 74 65 72 66 61 63 65 45 72 72 6f 72 3e 20  InterfaceError> 
1d30: 7b 0a 20 20 20 20 20 20 20 20 73 65 6c 66 2e 73  {.        self.s
1d40: 65 6e 64 5f 61 63 74 69 6f 6e 28 52 65 71 75 65  end_action(Reque
1d50: 73 74 3a 3a 47 65 74 41 63 63 6f 75 6e 74 49 6e  st::GetAccountIn
1d60: 66 6f 28 6d 65 73 73 61 67 65 5f 69 64 29 2c 0a  fo(message_id),.
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d80: 20 20 20 20 20 20 20 20 20 64 73 74 2c 0a 20 20           dst,.  
1d90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1da0: 20 20 20 20 20 20 20 43 4c 49 45 4e 54 5f 47 45         CLIENT_GE
1db0: 54 5f 50 52 49 4f 52 49 54 59 29 0a 20 20 20 20  T_PRIORITY).    
1dc0: 7d 0a 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75 72  }..    /// Retur
1dd0: 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  ns the name of t
1de0: 68 69 73 20 6e 6f 64 65 2e 0a 20 20 20 20 70 75  his node..    pu
1df0: 62 20 66 6e 20 6e 61 6d 65 28 26 73 65 6c 66 29  b fn name(&self)
1e00: 20 2d 3e 20 52 65 73 75 6c 74 3c 58 6f 72 4e 61   -> Result<XorNa
1e10: 6d 65 2c 20 49 6e 74 65 72 66 61 63 65 45 72 72  me, InterfaceErr
1e20: 6f 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 6c 65  or> {.        le
1e30: 74 20 28 72 65 73 75 6c 74 5f 74 78 2c 20 72 65  t (result_tx, re
1e40: 73 75 6c 74 5f 72 78 29 20 3d 20 63 68 61 6e 6e  sult_rx) = chann
1e50: 65 6c 28 29 3b 0a 20 20 20 20 20 20 20 20 73 65  el();.        se
1e60: 6c 66 2e 61 63 74 69 6f 6e 5f 73 65 6e 64 65 72  lf.action_sender
1e70: 2e 73 65 6e 64 28 41 63 74 69 6f 6e 3a 3a 4e 61  .send(Action::Na
1e80: 6d 65 20 7b 20 72 65 73 75 6c 74 5f 74 78 3a 20  me { result_tx: 
1e90: 72 65 73 75 6c 74 5f 74 78 20 7d 29 3f 3b 0a 0a  result_tx })?;..
1ea0: 20 20 20 20 20 20 20 20 73 65 6c 66 2e 72 65 63          self.rec
1eb0: 65 69 76 65 5f 61 63 74 69 6f 6e 5f 72 65 73 75  eive_action_resu
1ec0: 6c 74 28 26 72 65 73 75 6c 74 5f 72 78 29 0a 20  lt(&result_rx). 
1ed0: 20 20 20 7d 0a 0a 20 20 20 20 66 6e 20 73 65 6e     }..    fn sen
1ee0: 64 5f 61 63 74 69 6f 6e 28 26 73 65 6c 66 2c 0a  d_action(&self,.
1ef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f00: 20 20 20 63 6f 6e 74 65 6e 74 3a 20 52 65 71 75     content: Requ
1f10: 65 73 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20  est,.           
1f20: 20 20 20 20 20 20 20 20 64 73 74 3a 20 41 75 74          dst: Aut
1f30: 68 6f 72 69 74 79 3c 58 6f 72 4e 61 6d 65 3e 2c  hority<XorName>,
1f40: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
1f50: 20 20 20 20 70 72 69 6f 72 69 74 79 3a 20 75 38      priority: u8
1f60: 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ).              
1f70: 20 20 20 20 20 2d 3e 20 52 65 73 75 6c 74 3c 28       -> Result<(
1f80: 29 2c 20 49 6e 74 65 72 66 61 63 65 45 72 72 6f  ), InterfaceErro
1f90: 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 6c 65 74  r> {.        let
1fa0: 20 61 63 74 69 6f 6e 20 3d 20 41 63 74 69 6f 6e   action = Action
1fb0: 3a 3a 43 6c 69 65 6e 74 53 65 6e 64 52 65 71 75  ::ClientSendRequ
1fc0: 65 73 74 20 7b 0a 20 20 20 20 20 20 20 20 20 20  est {.          
1fd0: 20 20 63 6f 6e 74 65 6e 74 3a 20 63 6f 6e 74 65    content: conte
1fe0: 6e 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  nt,.            
1ff0: 64 73 74 3a 20 64 73 74 2c 0a 20 20 20 20 20 20  dst: dst,.      
2000: 20 20 20 20 20 20 70 72 69 6f 72 69 74 79 3a 20        priority: 
2010: 70 72 69 6f 72 69 74 79 2c 0a 20 20 20 20 20 20  priority,.      
2020: 20 20 20 20 20 20 72 65 73 75 6c 74 5f 74 78 3a        result_tx:
2030: 20 73 65 6c 66 2e 69 6e 74 65 72 66 61 63 65 5f   self.interface_
2040: 72 65 73 75 6c 74 5f 74 78 2e 63 6c 6f 6e 65 28  result_tx.clone(
2050: 29 2c 0a 20 20 20 20 20 20 20 20 7d 3b 0a 0a 20  ),.        };.. 
2060: 20 20 20 20 20 20 20 73 65 6c 66 2e 61 63 74 69         self.acti
2070: 6f 6e 5f 73 65 6e 64 65 72 2e 73 65 6e 64 28 61  on_sender.send(a
2080: 63 74 69 6f 6e 29 3f 3b 0a 20 20 20 20 20 20 20  ction)?;.       
2090: 20 73 65 6c 66 2e 72 65 63 65 69 76 65 5f 61 63   self.receive_ac
20a0: 74 69 6f 6e 5f 72 65 73 75 6c 74 28 26 73 65 6c  tion_result(&sel
20b0: 66 2e 69 6e 74 65 72 66 61 63 65 5f 72 65 73 75  f.interface_resu
20c0: 6c 74 5f 72 78 29 3f 0a 20 20 20 20 7d 0a 0a 20  lt_rx)?.    }.. 
20d0: 20 20 20 66 6e 20 72 65 63 65 69 76 65 5f 61 63     fn receive_ac
20e0: 74 69 6f 6e 5f 72 65 73 75 6c 74 3c 54 3e 28 26  tion_result<T>(&
20f0: 73 65 6c 66 2c 20 72 78 3a 20 26 52 65 63 65 69  self, rx: &Recei
2100: 76 65 72 3c 54 3e 29 20 2d 3e 20 52 65 73 75 6c  ver<T>) -> Resul
2110: 74 3c 54 2c 20 49 6e 74 65 72 66 61 63 65 45 72  t<T, InterfaceEr
2120: 72 6f 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 2f  ror> {.        /
2130: 2f 20 49 66 20 77 65 27 72 65 20 72 75 6e 6e 69  / If we're runni
2140: 6e 67 20 77 69 74 68 20 6d 6f 63 6b 5f 63 72 75  ng with mock_cru
2150: 73 74 2c 20 74 68 65 6e 20 74 68 65 20 73 74 61  st, then the sta
2160: 74 65 20 6d 61 63 68 69 6e 65 20 6e 65 65 64 73  te machine needs
2170: 20 74 6f 20 62 65 20 73 74 65 70 70 65 64 0a 20   to be stepped. 
2180: 20 20 20 20 20 20 20 2f 2f 20 6d 61 6e 75 61 6c         // manual
2190: 6c 79 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 70  ly in order to p
21a0: 72 6f 63 65 73 73 20 74 68 65 20 61 63 74 69 6f  rocess the actio
21b0: 6e 20 77 65 20 6a 75 73 74 20 73 65 6e 74 20 69  n we just sent i
21c0: 74 2e 0a 20 20 20 20 20 20 20 20 23 5b 63 66 67  t..        #[cfg
21d0: 28 66 65 61 74 75 72 65 20 3d 20 22 75 73 65 2d  (feature = "use-
21e0: 6d 6f 63 6b 2d 63 72 75 73 74 22 29 5d 0a 20 20  mock-crust")].  
21f0: 20 20 20 20 20 20 61 73 73 65 72 74 21 28 73 65        assert!(se
2200: 6c 66 2e 70 6f 6c 6c 28 29 29 3b 0a 0a 20 20 20  lf.poll());..   
2210: 20 20 20 20 20 4f 6b 28 72 78 2e 72 65 63 76 28       Ok(rx.recv(
2220: 29 3f 29 0a 20 20 20 20 7d 0a 7d 0a 0a 23 5b 63  )?).    }.}..#[c
2230: 66 67 28 66 65 61 74 75 72 65 20 3d 20 22 75 73  fg(feature = "us
2240: 65 2d 6d 6f 63 6b 2d 63 72 75 73 74 22 29 5d 0a  e-mock-crust")].
2250: 69 6d 70 6c 20 43 6c 69 65 6e 74 20 7b 0a 20 20  impl Client {.  
2260: 20 20 2f 2f 2f 20 43 72 65 61 74 65 20 61 20 6e    /// Create a n
2270: 65 77 20 60 43 6c 69 65 6e 74 60 20 66 6f 72 20  ew `Client` for 
2280: 75 6e 69 74 20 74 65 73 74 69 6e 67 2e 0a 20 20  unit testing..  
2290: 20 20 70 75 62 20 66 6e 20 6e 65 77 28 6b 65 79    pub fn new(key
22a0: 73 3a 20 4f 70 74 69 6f 6e 3c 46 75 6c 6c 49 64  s: Option<FullId
22b0: 3e 2c 20 6d 69 6e 5f 73 65 63 74 69 6f 6e 5f 73  >, min_section_s
22c0: 69 7a 65 3a 20 75 73 69 7a 65 29 20 2d 3e 20 52  ize: usize) -> R
22d0: 65 73 75 6c 74 3c 43 6c 69 65 6e 74 2c 20 52 6f  esult<Client, Ro
22e0: 75 74 69 6e 67 45 72 72 6f 72 3e 20 7b 0a 20 20  utingError> {.  
22f0: 20 20 20 20 20 20 2f 2f 20 73 74 61 72 74 20 74        // start t
2300: 68 65 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 72  he handler for r
2310: 6f 75 74 69 6e 67 20 77 69 74 68 20 61 20 72 65  outing with a re
2320: 73 74 72 69 63 74 69 6f 6e 20 74 6f 20 62 65 63  striction to bec
2330: 6f 6d 65 20 61 20 66 75 6c 6c 20 6e 6f 64 65 0a  ome a full node.
2340: 20 20 20 20 20 20 20 20 6c 65 74 20 6d 75 74 20          let mut 
2350: 65 76 65 6e 74 5f 62 75 66 66 65 72 20 3d 20 45  event_buffer = E
2360: 76 65 6e 74 42 75 66 3a 3a 6e 65 77 28 29 3b 0a  ventBuf::new();.
2370: 0a 20 20 20 20 20 20 20 20 6c 65 74 20 28 61 63  .        let (ac
2380: 74 69 6f 6e 5f 73 65 6e 64 65 72 2c 20 6d 61 63  tion_sender, mac
2390: 68 69 6e 65 29 20 3d 0a 20 20 20 20 20 20 20 20  hine) =.        
23a0: 20 20 20 20 53 65 6c 66 3a 3a 6d 61 6b 65 5f 73      Self::make_s
23b0: 74 61 74 65 5f 6d 61 63 68 69 6e 65 28 6b 65 79  tate_machine(key
23c0: 73 2c 20 6d 69 6e 5f 73 65 63 74 69 6f 6e 5f 73  s, min_section_s
23d0: 69 7a 65 2c 20 26 6d 75 74 20 65 76 65 6e 74 5f  ize, &mut event_
23e0: 62 75 66 66 65 72 29 3b 0a 0a 20 20 20 20 20 20  buffer);..      
23f0: 20 20 6c 65 74 20 28 74 78 2c 20 72 78 29 20 3d    let (tx, rx) =
2400: 20 63 68 61 6e 6e 65 6c 28 29 3b 0a 0a 20 20 20   channel();..   
2410: 20 20 20 20 20 4f 6b 28 43 6c 69 65 6e 74 20 7b       Ok(Client {
2420: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74  .            int
2430: 65 72 66 61 63 65 5f 72 65 73 75 6c 74 5f 74 78  erface_result_tx
2440: 3a 20 74 78 2c 0a 20 20 20 20 20 20 20 20 20 20  : tx,.          
2450: 20 20 69 6e 74 65 72 66 61 63 65 5f 72 65 73 75    interface_resu
2460: 6c 74 5f 72 78 3a 20 72 78 2c 0a 20 20 20 20 20  lt_rx: rx,.     
2470: 20 20 20 20 20 20 20 61 63 74 69 6f 6e 5f 73 65         action_se
2480: 6e 64 65 72 3a 20 61 63 74 69 6f 6e 5f 73 65 6e  nder: action_sen
2490: 64 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20  der,.           
24a0: 20 6d 61 63 68 69 6e 65 3a 20 52 65 66 43 65 6c   machine: RefCel
24b0: 6c 3a 3a 6e 65 77 28 6d 61 63 68 69 6e 65 29 2c  l::new(machine),
24c0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 65 76 65  .            eve
24d0: 6e 74 5f 62 75 66 66 65 72 3a 20 52 65 66 43 65  nt_buffer: RefCe
24e0: 6c 6c 3a 3a 6e 65 77 28 65 76 65 6e 74 5f 62 75  ll::new(event_bu
24f0: 66 66 65 72 29 2c 0a 20 20 20 20 20 20 20 20 7d  ffer),.        }
2500: 29 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2f 2f  ).    }..    ///
2510: 20 47 65 74 20 74 68 65 20 6e 65 78 74 20 65 76   Get the next ev
2520: 65 6e 74 20 69 6e 20 61 20 6e 6f 6e 2d 62 6c 6f  ent in a non-blo
2530: 63 6b 69 6e 67 20 6d 61 6e 6e 65 72 2e 0a 20 20  cking manner..  
2540: 20 20 2f 2f 2f 0a 20 20 20 20 2f 2f 2f 20 45 69    ///.    /// Ei
2550: 74 68 65 72 20 72 65 61 64 73 20 66 72 6f 6d 20  ther reads from 
2560: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 62 75 66  the internal buf
2570: 66 65 72 2c 20 6f 72 20 70 72 6f 6d 70 74 73 20  fer, or prompts 
2580: 61 20 73 74 61 74 65 20 6d 61 63 68 69 6e 65 20  a state machine 
2590: 73 74 65 70 2e 0a 20 20 20 20 70 75 62 20 66 6e  step..    pub fn
25a0: 20 74 72 79 5f 6e 65 78 74 5f 65 76 28 26 73 65   try_next_ev(&se
25b0: 6c 66 29 20 2d 3e 20 52 65 73 75 6c 74 3c 45 76  lf) -> Result<Ev
25c0: 65 6e 74 2c 20 54 72 79 52 65 63 76 45 72 72 6f  ent, TryRecvErro
25d0: 72 3e 20 7b 0a 20 20 20 20 20 20 20 20 69 66 20  r> {.        if 
25e0: 6c 65 74 20 53 6f 6d 65 28 63 61 63 68 65 64 5f  let Some(cached_
25f0: 65 76 29 20 3d 20 73 65 6c 66 2e 65 76 65 6e 74  ev) = self.event
2600: 5f 62 75 66 66 65 72 2e 62 6f 72 72 6f 77 5f 6d  _buffer.borrow_m
2610: 75 74 28 29 2e 74 61 6b 65 5f 66 69 72 73 74 28  ut().take_first(
2620: 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ) {.            
2630: 72 65 74 75 72 6e 20 4f 6b 28 63 61 63 68 65 64  return Ok(cached
2640: 5f 65 76 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  _ev);.        }.
2650: 20 20 20 20 20 20 20 20 73 65 6c 66 2e 74 72 79          self.try
2660: 5f 73 74 65 70 28 29 3f 3b 0a 20 20 20 20 20 20  _step()?;.      
2670: 20 20 73 65 6c 66 2e 65 76 65 6e 74 5f 62 75 66    self.event_buf
2680: 66 65 72 2e 62 6f 72 72 6f 77 5f 6d 75 74 28 29  fer.borrow_mut()
2690: 2e 74 61 6b 65 5f 66 69 72 73 74 28 29 2e 6f 6b  .take_first().ok
26a0: 5f 6f 72 28 54 72 79 52 65 63 76 45 72 72 6f 72  _or(TryRecvError
26b0: 3a 3a 45 6d 70 74 79 29 0a 20 20 20 20 7d 0a 0a  ::Empty).    }..
26c0: 20 20 20 20 2f 2f 2f 20 50 72 6f 63 65 73 73 20      /// Process 
26d0: 61 6c 6c 20 69 6e 62 6f 75 6e 64 20 65 76 65 6e  all inbound even
26e0: 74 73 20 61 6e 64 20 62 75 66 66 65 72 20 61 6e  ts and buffer an
26f0: 79 20 70 72 6f 64 75 63 65 64 20 65 76 65 6e 74  y produced event
2700: 73 20 6f 6e 20 74 68 65 20 69 6e 74 65 72 6e 61  s on the interna
2710: 6c 20 62 75 66 66 65 72 2e 0a 20 20 20 20 70 75  l buffer..    pu
2720: 62 20 66 6e 20 70 6f 6c 6c 28 26 73 65 6c 66 29  b fn poll(&self)
2730: 20 2d 3e 20 62 6f 6f 6c 20 7b 0a 20 20 20 20 20   -> bool {.     
2740: 20 20 20 6c 65 74 20 6d 75 74 20 72 65 73 75 6c     let mut resul
2750: 74 20 3d 20 66 61 6c 73 65 3b 0a 20 20 20 20 20  t = false;.     
2760: 20 20 20 77 68 69 6c 65 20 4f 6b 28 28 29 29 20     while Ok(()) 
2770: 3d 3d 20 73 65 6c 66 2e 74 72 79 5f 73 74 65 70  == self.try_step
2780: 28 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20  () {.           
2790: 20 72 65 73 75 6c 74 20 3d 20 74 72 75 65 3b 0a   result = true;.
27a0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
27b0: 20 20 72 65 73 75 6c 74 0a 20 20 20 20 7d 0a 0a    result.    }..
27c0: 20 20 20 20 2f 2f 2f 20 53 74 65 70 20 74 68 65      /// Step the
27d0: 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 74 61 74   underlying stat
27e0: 65 20 6d 61 63 68 69 6e 65 20 69 66 20 74 68 65  e machine if the
27f0: 72 65 20 61 72 65 20 61 6e 79 20 65 76 65 6e 74  re are any event
2800: 73 20 66 6f 72 20 69 74 20 74 6f 20 70 72 6f 63  s for it to proc
2810: 65 73 73 2e 0a 20 20 20 20 66 6e 20 74 72 79 5f  ess..    fn try_
2820: 73 74 65 70 28 26 73 65 6c 66 29 20 2d 3e 20 52  step(&self) -> R
2830: 65 73 75 6c 74 3c 28 29 2c 20 54 72 79 52 65 63  esult<(), TryRec
2840: 76 45 72 72 6f 72 3e 20 7b 0a 20 20 20 20 20 20  vError> {.      
2850: 20 20 73 65 6c 66 2e 6d 61 63 68 69 6e 65 2e 62    self.machine.b
2860: 6f 72 72 6f 77 5f 6d 75 74 28 29 2e 74 72 79 5f  orrow_mut().try_
2870: 73 74 65 70 28 26 6d 75 74 20 2a 73 65 6c 66 2e  step(&mut *self.
2880: 65 76 65 6e 74 5f 62 75 66 66 65 72 2e 62 6f 72  event_buffer.bor
2890: 72 6f 77 5f 6d 75 74 28 29 29 0a 20 20 20 20 7d  row_mut()).    }
28a0: 0a 0a 20 20 20 20 2f 2f 2f 20 52 65 73 65 6e 64  ..    /// Resend
28b0: 20 61 6c 6c 20 75 6e 61 63 6b 6e 6f 77 6c 65 64   all unacknowled
28c0: 67 65 64 20 6d 65 73 73 61 67 65 73 2e 0a 20 20  ged messages..  
28d0: 20 20 70 75 62 20 66 6e 20 72 65 73 65 6e 64 5f    pub fn resend_
28e0: 75 6e 61 63 6b 6e 6f 77 6c 65 64 67 65 64 28 26  unacknowledged(&
28f0: 73 65 6c 66 29 20 2d 3e 20 62 6f 6f 6c 20 7b 0a  self) -> bool {.
2900: 20 20 20 20 20 20 20 20 73 65 6c 66 2e 6d 61 63          self.mac
2910: 68 69 6e 65 2e 62 6f 72 72 6f 77 5f 6d 75 74 28  hine.borrow_mut(
2920: 29 2e 63 75 72 72 65 6e 74 5f 6d 75 74 28 29 2e  ).current_mut().
2930: 72 65 73 65 6e 64 5f 75 6e 61 63 6b 6e 6f 77 6c  resend_unacknowl
2940: 65 64 67 65 64 28 29 0a 20 20 20 20 7d 0a 0a 20  edged().    }.. 
2950: 20 20 20 2f 2f 2f 20 41 72 65 20 74 68 65 72 65     /// Are there
2960: 20 61 6e 79 20 75 6e 61 63 6b 6e 6f 77 6c 65 64   any unacknowled
2970: 67 65 64 20 6d 65 73 73 61 67 65 73 3f 0a 20 20  ged messages?.  
2980: 20 20 70 75 62 20 66 6e 20 68 61 73 5f 75 6e 61    pub fn has_una
2990: 63 6b 6e 6f 77 6c 65 64 67 65 64 28 26 73 65 6c  cknowledged(&sel
29a0: 66 29 20 2d 3e 20 62 6f 6f 6c 20 7b 0a 20 20 20  f) -> bool {.   
29b0: 20 20 20 20 20 73 65 6c 66 2e 6d 61 63 68 69 6e       self.machin
29c0: 65 2e 62 6f 72 72 6f 77 28 29 2e 63 75 72 72 65  e.borrow().curre
29d0: 6e 74 28 29 2e 68 61 73 5f 75 6e 61 63 6b 6e 6f  nt().has_unackno
29e0: 77 6c 65 64 67 65 64 28 29 0a 20 20 20 20 7d 0a  wledged().    }.
29f0: 7d 0a 0a 69 6d 70 6c 20 44 72 6f 70 20 66 6f 72  }..impl Drop for
2a00: 20 43 6c 69 65 6e 74 20 7b 0a 20 20 20 20 66 6e   Client {.    fn
2a10: 20 64 72 6f 70 28 26 6d 75 74 20 73 65 6c 66 29   drop(&mut self)
2a20: 20 7b 0a 20 20 20 20 20 20 20 20 69 66 20 6c 65   {.        if le
2a30: 74 20 45 72 72 28 65 72 72 29 20 3d 20 73 65 6c  t Err(err) = sel
2a40: 66 2e 61 63 74 69 6f 6e 5f 73 65 6e 64 65 72 2e  f.action_sender.
2a50: 73 65 6e 64 28 41 63 74 69 6f 6e 3a 3a 54 65 72  send(Action::Ter
2a60: 6d 69 6e 61 74 65 29 20 7b 0a 20 20 20 20 20 20  minate) {.      
2a70: 20 20 20 20 20 20 64 65 62 75 67 21 28 22 45 72        debug!("Er
2a80: 72 6f 72 20 7b 3a 3f 7d 20 73 65 6e 64 69 6e 67  ror {:?} sending
2a90: 20 65 76 65 6e 74 20 74 6f 20 43 6f 72 65 22 2c   event to Core",
2aa0: 20 65 72 72 29 3b 0a 20 20 20 20 20 20 20 20 7d   err);.        }
2ab0: 0a 20 20 20 20 7d 0a 7d 0a                       .    }.}.