      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
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105

    // 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::hash::{Hash, Hasher};
    use ethkey::{Address, Message, Signature, Secret, Public};
    use Error;
    use json::Uuid;

    /// Key directory reference
    #[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
    pub enum SecretVaultRef {
    	/// Reference to key in root directory
    	Root,
    	/// Referenc to key in specific vault
    	Vault(String),
    }

    /// Stored account reference
    #[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
    pub struct StoreAccountRef {
    	/// Vault reference
    	pub vault: SecretVaultRef,
    	/// Account address
    	pub address: Address,
    }

    pub trait SimpleSecretStore: Send + Sync {
    	fn insert_account(&self, vault: SecretVaultRef, secret: Secret, password: &str) -> Result<StoreAccountRef, Error>;
    	fn change_password(&self, account: &StoreAccountRef, old_password: &str, new_password: &str) -> Result<(), Error>;
    	fn remove_account(&self, account: &StoreAccountRef, password: &str) -> Result<(), Error>;

    	fn sign(&self, account: &StoreAccountRef, password: &str, message: &Message) -> Result<Signature, Error>;
    	fn decrypt(&self, account: &StoreAccountRef, password: &str, shared_mac: &[u8], message: &[u8]) -> Result<Vec<u8>, Error>;

    	fn accounts(&self) -> Result<Vec<StoreAccountRef>, Error>;

    	/// Create new vault with given password
    	fn create_vault(&self, name: &str, password: &str) -> Result<(), Error>;
    	/// Open vault with given password
    	fn open_vault(&self, name: &str, password: &str) -> Result<(), Error>;
    	/// Close vault
    	fn close_vault(&self, name: &str) -> Result<(), Error>;
    	/// Change vault password
    	fn change_vault_password(&self, name: &str, password: &str, new_password: &str) -> Result<(), Error>;
    }

    pub trait SecretStore: SimpleSecretStore {
    	fn import_presale(&self, vault: SecretVaultRef, json: &[u8], password: &str) -> Result<StoreAccountRef, Error>;
    	fn import_wallet(&self, vault: SecretVaultRef, json: &[u8], password: &str) -> Result<StoreAccountRef, Error>;
    	fn copy_account(&self, new_store: &SimpleSecretStore, new_vault: SecretVaultRef, account: &StoreAccountRef, password: &str, new_password: &str) -> Result<(), Error>;
    	fn move_account(&self, new_store: &SimpleSecretStore, new_vault: SecretVaultRef, account: &StoreAccountRef, password: &str, new_password: &str) -> Result<(), Error>;
    	fn test_password(&self, account: &StoreAccountRef, password: &str) -> Result<bool, Error>;

    	fn public(&self, account: &StoreAccountRef, password: &str) -> Result<Public, Error>;

    	fn uuid(&self, account: &StoreAccountRef) -> Result<Uuid, Error>;
    	fn name(&self, account: &StoreAccountRef) -> Result<String, Error>;
    	fn meta(&self, account: &StoreAccountRef) -> Result<String, Error>;

    	fn set_name(&self, account: &StoreAccountRef, name: String) -> Result<(), Error>;
    	fn set_meta(&self, account: &StoreAccountRef, meta: String) -> Result<(), Error>;

    	fn local_path(&self) -> String;
    	fn list_geth_accounts(&self, testnet: bool) -> Vec<Address>;
    	fn import_geth_accounts(&self, vault: SecretVaultRef, desired: Vec<Address>, testnet: bool) -> Result<Vec<StoreAccountRef>, Error>;
    }

    impl StoreAccountRef {
    	/// Create reference to root account with given address
    	pub fn root(address: Address) -> Self {
    		StoreAccountRef::new(SecretVaultRef::Root, address)
    	}

    	/// Create reference to vault account with given address
    	pub fn vault(vault_name: &str, address: Address) -> Self {
    		StoreAccountRef::new(SecretVaultRef::Vault(vault_name.to_owned()), address)
    	}

    	/// Create new account reference
    	pub fn new(vault_ref: SecretVaultRef, address: Address) -> Self {
    		StoreAccountRef {
    			vault: vault_ref,
    			address: address,
    		}
    	}
    }

    impl Hash for StoreAccountRef {
    	fn hash<H: Hasher>(&self, state: &mut H) {
    		self.address.hash(state);
    	}
    }

# 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`)