// 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 . //! Parity Accounts-related rpc interface. use std::collections::BTreeMap; use jsonrpc_core::Error; use v1::types::{H160, H256, DappId, DeriveHash, DeriveHierarchical}; build_rpc_trait! { /// Personal Parity rpc interface. pub trait ParityAccounts { /// Returns accounts information. #[rpc(name = "parity_allAccountsInfo")] fn all_accounts_info(&self) -> Result>, Error>; /// Creates new account from the given phrase using standard brainwallet mechanism. /// Second parameter is password for the new account. #[rpc(name = "parity_newAccountFromPhrase")] fn new_account_from_phrase(&self, String, String) -> Result; /// Creates new account from the given JSON wallet. /// Second parameter is password for the wallet and the new account. #[rpc(name = "parity_newAccountFromWallet")] fn new_account_from_wallet(&self, String, String) -> Result; /// Creates new account from the given raw secret. /// Second parameter is password for the new account. #[rpc(name = "parity_newAccountFromSecret")] fn new_account_from_secret(&self, H256, String) -> Result; /// Returns true if given `password` would unlock given `account`. /// Arguments: `account`, `password`. #[rpc(name = "parity_testPassword")] fn test_password(&self, H160, String) -> Result; /// Changes an account's password. /// Arguments: `account`, `password`, `new_password`. #[rpc(name = "parity_changePassword")] fn change_password(&self, H160, String, String) -> Result; /// Permanently deletes an account. /// Arguments: `account`, `password`. #[rpc(name = "parity_killAccount")] fn kill_account(&self, H160, String) -> Result; /// Permanently deletes an address from the addressbook /// Arguments: `address` #[rpc(name = "parity_removeAddress")] fn remove_address(&self, H160) -> Result; /// Set an account's name. #[rpc(name = "parity_setAccountName")] fn set_account_name(&self, H160, String) -> Result; /// Set an account's metadata string. #[rpc(name = "parity_setAccountMeta")] fn set_account_meta(&self, H160, String) -> Result; /// Sets addresses exposed for particular dapp. /// Setting a non-empty list will also override default account. /// Setting `None` will resets visible account to what's visible for new dapps /// (does not affect default account though) #[rpc(name = "parity_setDappAddresses")] fn set_dapp_addresses(&self, DappId, Option>) -> Result; /// Gets accounts exposed for particular dapp. #[rpc(name = "parity_getDappAddresses")] fn dapp_addresses(&self, DappId) -> Result, Error>; /// Changes dapp default address. /// Does not affect other accounts exposed for this dapp, but /// default account will always be retured as the first one. #[rpc(name = "parity_setDappDefaultAddress")] fn set_dapp_default_address(&self, DappId, H160) -> Result; /// Returns current dapp default address. /// If not set explicite for the dapp will return global default. #[rpc(name = "parity_getDappDefaultAddress")] fn dapp_default_address(&self, DappId) -> Result; /// Sets accounts exposed for new dapps. /// Setting a non-empty list will also override default account. /// Setting `None` exposes all internal-managed accounts. /// (does not affect default account though) #[rpc(name = "parity_setNewDappsAddresses")] fn set_new_dapps_addresses(&self, Option>) -> Result; /// Gets accounts exposed for new dapps. /// `None` means that all accounts are exposes. #[rpc(name = "parity_getNewDappsAddresses")] fn new_dapps_addresses(&self) -> Result>, Error>; /// Changes default address for new dapps (global default address) /// Does not affect other accounts exposed for new dapps, but /// default account will always be retured as the first one. #[rpc(name = "parity_setNewDappsDefaultAddress")] fn set_new_dapps_default_address(&self, H160) -> Result; /// Returns current default address for new dapps (global default address) /// In case it's not set explicite will return first available account. /// If no accounts are available will return `0x0` #[rpc(name = "parity_getNewDappsDefaultAddress")] fn new_dapps_default_address(&self) -> Result; /// Returns identified dapps that recently used RPC /// Includes last usage timestamp. #[rpc(name = "parity_listRecentDapps")] fn recent_dapps(&self) -> Result, Error>; /// Imports a number of Geth accounts, with the list provided as the argument. #[rpc(name = "parity_importGethAccounts")] fn import_geth_accounts(&self, Vec) -> Result, Error>; /// Returns the accounts available for importing from Geth. #[rpc(name = "parity_listGethAccounts")] fn geth_accounts(&self) -> Result, Error>; /// Create new vault. #[rpc(name = "parity_newVault")] fn create_vault(&self, String, String) -> Result; /// Open existing vault. #[rpc(name = "parity_openVault")] fn open_vault(&self, String, String) -> Result; /// Close previously opened vault. #[rpc(name = "parity_closeVault")] fn close_vault(&self, String) -> Result; /// List all vaults. #[rpc(name = "parity_listVaults")] fn list_vaults(&self) -> Result, Error>; /// List all currently opened vaults. #[rpc(name = "parity_listOpenedVaults")] fn list_opened_vaults(&self) -> Result, Error>; /// Change vault password. #[rpc(name = "parity_changeVaultPassword")] fn change_vault_password(&self, String, String) -> Result; /// Change vault of the given address. #[rpc(name = "parity_changeVault")] fn change_vault(&self, H160, String) -> Result; /// Get vault metadata string. #[rpc(name = "parity_getVaultMeta")] fn get_vault_meta(&self, String) -> Result; /// Set vault metadata string. #[rpc(name = "parity_setVaultMeta")] fn set_vault_meta(&self, String, String) -> Result; /// Derive new address from given account address using specific hash. /// Resulting address can be either saved as a new account (with the same password). #[rpc(name = "parity_deriveAddressHash")] fn derive_key_hash(&self, H160, String, DeriveHash, bool) -> Result; /// Derive new address from given account address using /// hierarchical derivation (sequence of 32-bit integer indices). /// Resulting address can be either saved as a new account (with the same password). #[rpc(name = "parity_deriveAddressIndex")] fn derive_key_index(&self, H160, String, DeriveHierarchical, bool) -> Result; } }