// Copyright 2015, 2016 Ethcore (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 . //! Account management. use std::{fs, fmt}; use std::collections::HashMap; use std::path::PathBuf; use std::time::{Instant, Duration}; use util::{Mutex, RwLock}; use ethstore::{SecretStore, Error as SSError, SafeAccount, EthStore}; use ethstore::dir::{KeyDirectory}; use ethstore::ethkey::{Address, Message, Public, Secret, Random, Generator}; use ethjson::misc::AccountMeta; pub use ethstore::ethkey::Signature; /// Type of unlock. #[derive(Clone)] enum Unlock { /// If account is unlocked temporarily, it should be locked after first usage. Temp, /// Account unlocked permantently can always sign message. /// Use with caution. Perm, /// Account unlocked with a timeout Timed((Instant, u32)), } /// Data associated with account. #[derive(Clone)] struct AccountData { unlock: Unlock, password: String, } /// `AccountProvider` errors. #[derive(Debug)] pub enum Error { /// Returned when account is not unlocked. NotUnlocked, /// Returned when signing fails. SStore(SSError), } impl fmt::Display for Error { fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> { match *self { Error::NotUnlocked => write!(f, "Account is locked"), Error::SStore(ref e) => write!(f, "{}", e), } } } impl From for Error { fn from(e: SSError) -> Self { Error::SStore(e) } } #[derive(Default)] struct NullDir { accounts: RwLock>, } impl KeyDirectory for NullDir { fn load(&self) -> Result, SSError> { Ok(self.accounts.read().values().cloned().collect()) } fn insert(&self, account: SafeAccount) -> Result { self.accounts.write().insert(account.address.clone(), account.clone()); Ok(account) } fn remove(&self, address: &Address) -> Result<(), SSError> { self.accounts.write().remove(address); Ok(()) } } /// Disk-backed map from Address to String. Uses JSON. struct AddressBook { path: PathBuf, cache: HashMap, } impl AddressBook { pub fn new(path: String) -> Self { trace!(target: "addressbook", "new({})", path); let mut path: PathBuf = path.into(); path.push("address_book.json"); trace!(target: "addressbook", "path={:?}", path); let mut r = AddressBook { path: path, cache: HashMap::new(), }; r.revert(); r } pub fn get(&self) -> HashMap { self.cache.clone() } pub fn set_name(&mut self, a: Address, name: String) { let mut x = self.cache.get(&a) .cloned() .unwrap_or_else(|| AccountMeta {name: Default::default(), meta: "{}".to_owned(), uuid: None}); x.name = name; self.cache.insert(a, x); self.save(); } pub fn set_meta(&mut self, a: Address, meta: String) { let mut x = self.cache.get(&a) .cloned() .unwrap_or_else(|| AccountMeta {name: "Anonymous".to_owned(), meta: Default::default(), uuid: None}); x.meta = meta; self.cache.insert(a, x); self.save(); } fn revert(&mut self) { trace!(target: "addressbook", "revert"); let _ = fs::File::open(self.path.clone()) .map_err(|e| trace!(target: "addressbook", "Couldn't open address book: {}", e)) .and_then(|f| AccountMeta::read_address_map(&f) .map_err(|e| warn!(target: "addressbook", "Couldn't read address book: {}", e)) .and_then(|m| { self.cache = m; Ok(()) }) ); } fn save(&mut self) { trace!(target: "addressbook", "save"); let _ = fs::File::create(self.path.clone()) .map_err(|e| warn!(target: "addressbook", "Couldn't open address book for writing: {}", e)) .and_then(|mut f| AccountMeta::write_address_map(&self.cache, &mut f) .map_err(|e| warn!(target: "addressbook", "Couldn't write to address book: {}", e)) ); } } /// Account management. /// Responsible for unlocking accounts. pub struct AccountProvider { unlocked: Mutex>, sstore: Box, address_book: Mutex, } impl AccountProvider { /// Creates new account provider. pub fn new(sstore: Box) -> Self { AccountProvider { unlocked: Mutex::new(HashMap::new()), address_book: Mutex::new(AddressBook::new(sstore.local_path().into())), sstore: sstore, } } /// Creates not disk backed provider. pub fn transient_provider() -> Self { AccountProvider { unlocked: Mutex::new(HashMap::new()), address_book: Mutex::new(AddressBook::new(Default::default())), sstore: Box::new(EthStore::open(Box::new(NullDir::default())).unwrap()) } } /// Creates new random account. pub fn new_account(&self, password: &str) -> Result { self.new_account_and_public(password).map(|d| d.0) } /// Creates new random account and returns address and public key pub fn new_account_and_public(&self, password: &str) -> Result<(Address, Public), Error> { let acc = Random.generate().unwrap(); let public = acc.public().clone(); let secret = acc.secret().clone(); let address = try!(self.sstore.insert_account(secret, password)); Ok((address, public)) } /// Inserts new account into underlying store. /// Does not unlock account! pub fn insert_account(&self, secret: Secret, password: &str) -> Result { let address = try!(self.sstore.insert_account(secret, password)); Ok(address) } /// Import a new presale wallet. pub fn import_presale(&self, presale_json: &[u8], password: &str) -> Result { let address = try!(self.sstore.import_presale(presale_json, password)); Ok(Address::from(address).into()) } /// Import a new presale wallet. pub fn import_wallet(&self, json: &[u8], password: &str) -> Result { let address = try!(self.sstore.import_wallet(json, password)); Ok(Address::from(address).into()) } /// Returns addresses of all accounts. pub fn accounts(&self) -> Result, Error> { let accounts = try!(self.sstore.accounts()); Ok(accounts) } /// Returns each address along with metadata. pub fn addresses_info(&self) -> Result, Error> { Ok(self.address_book.lock().get()) } /// Returns each address along with metadata. pub fn set_address_name(&self, account: Address, name: String) -> Result<(), Error> { Ok(self.address_book.lock().set_name(account, name)) } /// Returns each address along with metadata. pub fn set_address_meta(&self, account: Address, meta: String) -> Result<(), Error> { Ok(self.address_book.lock().set_meta(account, meta)) } /// Returns each account along with name and meta. pub fn accounts_info(&self) -> Result, Error> { let r: HashMap = try!(self.sstore.accounts()) .into_iter() .map(|a| (a.clone(), self.account_meta(a).ok().unwrap_or_default())) .collect(); Ok(r) } /// Returns each account along with name and meta. pub fn account_meta(&self, account: Address) -> Result { Ok(AccountMeta { name: try!(self.sstore.name(&account)), meta: try!(self.sstore.meta(&account)), uuid: self.sstore.uuid(&account).ok().map(Into::into), // allowed to not have a UUID }) } /// Returns each account along with name and meta. pub fn set_account_name(&self, account: Address, name: String) -> Result<(), Error> { try!(self.sstore.set_name(&account, name)); Ok(()) } /// Returns each account along with name and meta. pub fn set_account_meta(&self, account: Address, meta: String) -> Result<(), Error> { try!(self.sstore.set_meta(&account, meta)); Ok(()) } /// Helper method used for unlocking accounts. fn unlock_account(&self, account: Address, password: String, unlock: Unlock) -> Result<(), Error> { // verify password by signing dump message // result may be discarded let _ = try!(self.sstore.sign(&account, &password, &Default::default())); // check if account is already unlocked pernamently, if it is, do nothing let mut unlocked = self.unlocked.lock(); if let Some(data) = unlocked.get(&account) { if let Unlock::Perm = data.unlock { return Ok(()) } } let data = AccountData { unlock: unlock, password: password, }; unlocked.insert(account, data); Ok(()) } fn password(&self, account: &Address) -> Result { let mut unlocked = self.unlocked.lock(); let data = try!(unlocked.get(account).ok_or(Error::NotUnlocked)).clone(); if let Unlock::Temp = data.unlock { unlocked.remove(account).expect("data exists: so key must exist: qed"); } if let Unlock::Timed((ref start, ref duration)) = data.unlock { if start.elapsed() > Duration::from_millis(*duration as u64) { unlocked.remove(account).expect("data exists: so key must exist: qed"); return Err(Error::NotUnlocked); } } Ok(data.password.clone()) } /// Unlocks account permanently. pub fn unlock_account_permanently(&self, account: Address, password: String) -> Result<(), Error> { self.unlock_account(account, password, Unlock::Perm) } /// Unlocks account temporarily (for one signing). pub fn unlock_account_temporarily(&self, account: Address, password: String) -> Result<(), Error> { self.unlock_account(account, password, Unlock::Temp) } /// Unlocks account temporarily with a timeout. pub fn unlock_account_timed(&self, account: Address, password: String, duration_ms: u32) -> Result<(), Error> { self.unlock_account(account, password, Unlock::Timed((Instant::now(), duration_ms))) } /// Checks if given account is unlocked pub fn is_unlocked(&self, account: Address) -> bool { let unlocked = self.unlocked.lock(); unlocked.get(&account).is_some() } /// Signs the message. If password is not provided the account must be unlocked. pub fn sign(&self, account: Address, password: Option, message: Message) -> Result { let password = try!(password.map(Ok).unwrap_or_else(|| self.password(&account))); Ok(try!(self.sstore.sign(&account, &password, &message))) } /// Decrypts a message. If password is not provided the account must be unlocked. pub fn decrypt(&self, account: Address, password: Option, shared_mac: &[u8], message: &[u8]) -> Result, Error> { let password = try!(password.map(Ok).unwrap_or_else(|| self.password(&account))); Ok(try!(self.sstore.decrypt(&account, &password, shared_mac, message))) } /// Returns the underlying `SecretStore` reference if one exists. pub fn list_geth_accounts(&self, testnet: bool) -> Vec
{ self.sstore.list_geth_accounts(testnet).into_iter().map(|a| Address::from(a).into()).collect() } /// Returns the underlying `SecretStore` reference if one exists. pub fn import_geth_accounts(&self, desired: Vec
, testnet: bool) -> Result, Error> { self.sstore.import_geth_accounts(desired, testnet).map_err(Into::into) } } #[cfg(test)] mod tests { use super::{AccountProvider, AddressBook}; use std::collections::HashMap; use ethjson::misc::AccountMeta; use ethstore::ethkey::{Generator, Random}; use std::time::Duration; use devtools::RandomTempPath; #[test] fn should_save_and_reload_address_book() { let temp = RandomTempPath::create_dir(); let path = temp.as_str().to_owned(); let mut b = AddressBook::new(path.clone()); b.set_name(1.into(), "One".to_owned()); b.set_meta(1.into(), "{1:1}".to_owned()); let b = AddressBook::new(path); assert_eq!(b.get(), hash_map![1.into() => AccountMeta{name: "One".to_owned(), meta: "{1:1}".to_owned(), uuid: None}]); } #[test] fn unlock_account_temp() { let kp = Random.generate().unwrap(); let ap = AccountProvider::transient_provider(); assert!(ap.insert_account(kp.secret().clone(), "test").is_ok()); assert!(ap.unlock_account_temporarily(kp.address(), "test1".into()).is_err()); assert!(ap.unlock_account_temporarily(kp.address(), "test".into()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_err()); } #[test] fn unlock_account_perm() { let kp = Random.generate().unwrap(); let ap = AccountProvider::transient_provider(); assert!(ap.insert_account(kp.secret().clone(), "test").is_ok()); assert!(ap.unlock_account_permanently(kp.address(), "test1".into()).is_err()); assert!(ap.unlock_account_permanently(kp.address(), "test".into()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); assert!(ap.unlock_account_temporarily(kp.address(), "test".into()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); } #[test] fn unlock_account_timer() { let kp = Random.generate().unwrap(); let ap = AccountProvider::transient_provider(); assert!(ap.insert_account(kp.secret().clone(), "test").is_ok()); assert!(ap.unlock_account_timed(kp.address(), "test1".into(), 2000).is_err()); assert!(ap.unlock_account_timed(kp.address(), "test".into(), 2000).is_ok()); assert!(ap.sign(kp.address(), None, Default::default()).is_ok()); ::std::thread::sleep(Duration::from_millis(2000)); assert!(ap.sign(kp.address(), None, Default::default()).is_err()); } }