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

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

// OpenEthereum 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.

// OpenEthereum 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 OpenEthereum.  If not, see <http://www.gnu.org/licenses/>.

//! SecretStore-specific rpc interface.

use std::collections::BTreeSet;

use ethereum_types::{H160, H256, H512};
use ethkey::Password;
use jsonrpc_core::Result;
use jsonrpc_derive::rpc;
use v1::types::{Bytes, EncryptedDocumentKey};

/// Parity-specific rpc interface.
#[rpc(server)]
pub trait SecretStore {
    /// Generate document key to store in secret store.
    /// Arguments: `account`, `password`, `server_key_public`.
    #[rpc(name = "secretstore_generateDocumentKey")]
    fn generate_document_key(&self, _: H160, _: Password, _: H512) -> Result<EncryptedDocumentKey>;

    /// Encrypt data with key, received from secret store.
    /// Arguments: `account`, `password`, `key`, `data`.
    #[rpc(name = "secretstore_encrypt")]
    fn encrypt(&self, _: H160, _: Password, _: Bytes, _: Bytes) -> Result<Bytes>;

    /// Decrypt data with key, received from secret store.
    /// Arguments: `account`, `password`, `key`, `data`.
    #[rpc(name = "secretstore_decrypt")]
    fn decrypt(&self, _: H160, _: Password, _: Bytes, _: Bytes) -> Result<Bytes>;

    /// Decrypt data with shadow key, received from secret store.
    /// Arguments: `account`, `password`, `decrypted_secret`, `common_point`, `decrypt_shadows`, `data`.
    #[rpc(name = "secretstore_shadowDecrypt")]
    fn shadow_decrypt(
        &self,
        _: H160,
        _: Password,
        _: H512,
        _: H512,
        _: Vec<Bytes>,
        _: Bytes,
    ) -> Result<Bytes>;

    /// Calculates the hash (keccak256) of servers set for using in ServersSetChange session.
    /// Returned hash must be signed later by using `secretstore_signRawHash` method.
    /// Arguments: `servers_set`.
    #[rpc(name = "secretstore_serversSetHash")]
    fn servers_set_hash(&self, _: BTreeSet<H512>) -> Result<H256>;

    /// Generate recoverable ECDSA signature of raw hash.
    /// Passed hash is treated as an input to the `sign` function (no prefixes added, no hash function is applied).
    /// Arguments: `account`, `password`, `raw_hash`.
    #[rpc(name = "secretstore_signRawHash")]
    fn sign_raw_hash(&self, _: H160, _: Password, _: H256) -> Result<Bytes>;
}