apx_core 0.22.0

APx core primitives
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

//! Proof types
use std::str::FromStr;

use thiserror::Error;

// https://www.w3.org/TR/vc-data-integrity/
pub(super) const DATA_INTEGRITY_PROOF: &str = "DataIntegrityProof";

// Similar to https://identity.foundation/JcsEd25519Signature2020/
// - Canonicalization algorithm: JCS
// - Digest algorithm: SHA-256
// - Signature algorithm: RSASSA-PKCS1-v1_5
pub(super) const PROOF_TYPE_JCS_RSA: &str = "MitraJcsRsaSignature2022";

// Similar to EthereumPersonalSignature2021 but with JCS
#[cfg(feature = "eip191")]
pub(super) const PROOF_TYPE_JCS_EIP191: &str = "MitraJcsEip191Signature2022";

// Similar to Ed25519Signature2020
// - Canonicalization algorithm: JCS
// - Digest algorithm: BLAKE2b-512
// - Signature algorithm: EdDSA
#[cfg(feature = "minisign")]
pub(super) const PROOF_TYPE_JCS_BLAKE2_ED25519: &str = "MitraJcsEd25519Signature2022";

// https://www.w3.org/TR/vc-di-eddsa/#eddsa-jcs-2022
// (old name, and a variant without context injection)
pub(super) const CRYPTOSUITE_JCS_EDDSA_LEGACY: &str = "jcs-eddsa-2022";
// (normal variant)
pub(super) const CRYPTOSUITE_JCS_EDDSA: &str = "eddsa-jcs-2022";

/// Integrity proof type
#[derive(Debug, PartialEq)]
pub enum ProofType {
    #[cfg(feature = "eip191")]
    JcsEip191Signature,
    #[cfg(feature = "minisign")]
    JcsBlake2Ed25519Signature,
    #[deprecated]
    JcsRsaSignature,
    #[deprecated]
    JcsEddsaSignature,
    /// `eddsa-jcs-2022` cryptosuite  
    /// <https://www.w3.org/TR/vc-di-eddsa/#eddsa-jcs-2022>
    EddsaJcsSignature,
}

/// Error that may occur when cryptosuite name is parsed
#[derive(Debug, Error)]
#[error("unsupported proof type")]
pub struct UnsupportedProofType;

impl FromStr for ProofType {
    type Err = UnsupportedProofType;

    fn from_str(value: &str) -> Result<Self, Self::Err> {
        let proof_type = match value {
            #[cfg(feature = "eip191")]
            PROOF_TYPE_JCS_EIP191 => Self::JcsEip191Signature,
            #[cfg(feature = "minisign")]
            PROOF_TYPE_JCS_BLAKE2_ED25519 => Self::JcsBlake2Ed25519Signature,
            #[allow(deprecated)]
            PROOF_TYPE_JCS_RSA => Self::JcsRsaSignature,
            _ => return Err(UnsupportedProofType),
        };
        Ok(proof_type)
    }
}

impl ProofType {
    pub fn from_cryptosuite(value: &str) -> Result<Self, UnsupportedProofType> {
        let proof_type = match value {
            #[allow(deprecated)]
            CRYPTOSUITE_JCS_EDDSA_LEGACY => Self::JcsEddsaSignature,
            CRYPTOSUITE_JCS_EDDSA => Self::EddsaJcsSignature,
            _ => return Err(UnsupportedProofType),
        };
        Ok(proof_type)
    }
}