     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95

    // Copyright 2015-2017 Parity Technologies (UK) Ltd.
    // This file is part of Parity.

    // Parity is free software: you can redistribute it and/or modify
    // it under the terms of the GNU General Public License as published by
    // the Free Software Foundation, either version 3 of the License, or
    // (at your option) any later version.

    // Parity is distributed in the hope that it will be useful,
    // but WITHOUT ANY WARRANTY; without even the implied warranty of
    // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    // GNU General Public License for more details.

    // You should have received a copy of the GNU General Public License
    // along with Parity.  If not, see <http://www.gnu.org/licenses/>.

    use std::sync::Arc;
    use std::ops::Deref;
    use util::Mutex;
    use transient_hashmap::TransientHashMap;

    use ethstore::random_string;

    use v1::helpers::signing_queue::{ConfirmationsQueue};

    const TOKEN_LIFETIME_SECS: u64 = 3600;

    /// Manages communication with Signer crate
    pub struct SignerService {
    	queue: Arc<ConfirmationsQueue>,
    	web_proxy_tokens: Mutex<TransientHashMap<String, ()>>,
    	generate_new_token: Box<Fn() -> Result<String, String> + Send + Sync + 'static>,
    	address: Option<(String, u16)>,
    }

    impl SignerService {
    	/// Creates new Signer Service given function to generate new tokens.
    	pub fn new<F>(new_token: F, address: Option<(String, u16)>) -> Self
    		where F: Fn() -> Result<String, String> + Send + Sync + 'static {
    		SignerService {
    			queue: Arc::new(ConfirmationsQueue::default()),
    			web_proxy_tokens: Mutex::new(TransientHashMap::new(TOKEN_LIFETIME_SECS)),
    			generate_new_token: Box::new(new_token),
    			address: address,
    		}
    	}

    	/// Checks if the token is valid web proxy access token.
    	pub fn is_valid_web_proxy_access_token(&self, token: &String) -> bool {
    		self.web_proxy_tokens.lock().contains_key(&token)
    	}

    	/// Generates a new web proxy access token.
    	pub fn generate_web_proxy_access_token(&self) -> String {
    		let token = random_string(16);
    		let mut tokens = self.web_proxy_tokens.lock();
    		tokens.prune();
    		tokens.insert(token.clone(), ());
    		token
    	}

    	/// Generates new signer authorization token.
    	pub fn generate_token(&self) -> Result<String, String> {
    		(self.generate_new_token)()
    	}

    	/// Returns a reference to `ConfirmationsQueue`
    	pub fn queue(&self) -> Arc<ConfirmationsQueue> {
    		self.queue.clone()
    	}

    	/// Returns signer address (if signer enabled) or `None` otherwise
    	pub fn address(&self) -> Option<(String, u16)> {
    		self.address.clone()
    	}

    	/// Returns true if Signer is enabled.
    	pub fn is_enabled(&self) -> bool {
    		self.address.is_some()
    	}

    	#[cfg(test)]
    	/// Creates new Signer Service for tests.
    	pub fn new_test(address: Option<(String, u16)>) -> Self {
    		SignerService::new(|| Ok("new_token".into()), address)
    	}
    }

    impl Deref for SignerService {
    	type Target = ConfirmationsQueue;
    	fn deref(&self) -> &Self::Target {
    		&self.queue
    	}
    }

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)