vade-didcomm 0.3.0

DIDComm communication helper for vade
Documentation 
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

use crate::{
    datatypes::CommKeyPair,
    db::{read_db, write_db},
};

/// Saves a communication keypair within db for two DIDs (from -> to). Entry key will be
/// comm_keypair_{from}_{to}.
///
/// # Arguments
/// * `from_did` - from DID
/// * `to_did` - to DID as string
/// * `pub_key` - pub key of the active did to communicate with the target did
/// * `secret_key` - secret key of the active did to encrypt message for the target did
/// * `target_pub_key` - pub key of the target did (optional nullable, default will be empty string)
/// * `service_endpoint` - url, where the target did can be reached (optional nullable, default will be empty string)
///
/// # Returns
/// * `CommKeyPair` - new instance of the comm key pair
#[allow(clippy::too_many_arguments)]
pub fn save_com_keypair(
    from_did: &str,
    to_did: &str,
    key_agreement_key: &str,
    target_key_agreement_key: &str,
    pub_key: &str,
    secret_key: &str,
    target_pub_key: Option<String>,
    service_endpoint: Option<String>,
) -> Result<CommKeyPair, Box<dyn std::error::Error>> {
    let comm_keypair = CommKeyPair {
        pub_key: String::from(pub_key),
        secret_key: String::from(secret_key),
        key_agreement_key: String::from(key_agreement_key),
        target_key_agreement_key: String::from(target_key_agreement_key),
        target_pub_key: target_pub_key.unwrap_or_else(|| String::from("")),
        target_service_endpoint: service_endpoint.unwrap_or_else(|| String::from("")),
    };

    write_db(
        &format!("comm_keypair_{}_{}", from_did, to_did),
        &serde_json::to_string(&comm_keypair)?,
    )?;

    write_db(
        &format!("key_agreement_key_{}", key_agreement_key),
        &serde_json::to_string(&comm_keypair)?,
    )?;

    Ok(comm_keypair)
}

/// Loads a communication keypair from the db for two DIDs (from -> to). Entry key will be
/// comm_keypair_{from}_{to}.
///
/// # Arguments
/// * `from_did` - from DID
/// * `to_did` - to DID as string
///
/// # Returns
/// * `CommKeyPair` - new instance of the comm key pair
pub fn get_com_keypair(
    from_did: &str,
    to_did: &str,
) -> Result<CommKeyPair, Box<dyn std::error::Error>> {
    let db_result = read_db(&format!("comm_keypair_{}_{}", from_did, to_did))?;
    log::debug!(
        "receiving key: comm_keypair_{}_{} with data: {}",
        from_did,
        to_did,
        db_result,
    );
    let comm_keypair: CommKeyPair = serde_json::from_str(&db_result)?;

    Ok(comm_keypair)
}

/// Loads a communication keypair from the db for two DIDs (from -> to). Entry key will be
/// comm_keypair_{from}_{to}.
///
/// # Arguments
/// * `from_did` - from DID
/// * `to_did` - to DID as string
///
/// # Returns
/// * `CommKeyPair` - new instance of the comm key pair
pub fn get_key_agreement_key(
    key_agreement_key: &str,
) -> Result<CommKeyPair, Box<dyn std::error::Error>> {
    let db_result = read_db(&format!("key_agreement_key_{}", key_agreement_key))?;
    log::debug!(
        "receving key: key_agreement_key_{} with data: {}",
        key_agreement_key,
        db_result,
    );
    let comm_keypair: CommKeyPair = serde_json::from_str(&db_result)?;

    Ok(comm_keypair)
}