tvc 0.8.0

CLI for Turnkey Verifiable Cloud
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

//! Stored API key for Turnkey authentication.

use super::OrgConfig;
use anyhow::{Context, Result};
use serde::{Deserialize, Serialize};
use tracing::debug;

/// API key stored in api_key.json
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StoredApiKey {
    /// Hex-encoded compressed public key
    pub public_key: String,
    /// Hex-encoded private key
    pub private_key: String,
    /// The elliptic curve used for this key
    pub curve: KeyCurve,
}

/// Supported elliptic curves for API keys
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum KeyCurve {
    P256,
    Secp256k1,
}

impl StoredApiKey {
    /// Load API key from the path specified in org config
    pub async fn load(org_config: &OrgConfig) -> Result<Option<Self>> {
        let path = &org_config.api_key_path;
        debug!(api_key_path = %path.display(), "loading stored API key");
        if !path.exists() {
            debug!(api_key_path = %path.display(), "stored API key not found");
            return Ok(None);
        }

        let content = tokio::fs::read_to_string(path)
            .await
            .with_context(|| format!("failed to read API key: {}", path.display()))?;

        let key: StoredApiKey = serde_json::from_str(&content)
            .with_context(|| format!("failed to parse API key: {}", path.display()))?;

        debug!(
            api_key_path = %path.display(),
            curve = ?key.curve,
            has_public_key = !key.public_key.is_empty(),
            "loaded stored API key"
        );

        Ok(Some(key))
    }

    /// Save API key to the path specified in org config
    pub async fn save(&self, org_config: &OrgConfig) -> Result<()> {
        let path = &org_config.api_key_path;
        debug!(api_key_path = %path.display(), curve = ?self.curve, "saving stored API key");

        // Ensure parent directory exists
        if let Some(parent) = path.parent() {
            tokio::fs::create_dir_all(parent)
                .await
                .with_context(|| format!("failed to create directory: {}", parent.display()))?;
        }

        let content = serde_json::to_string_pretty(self).context("failed to serialize API key")?;

        tokio::fs::write(path, content)
            .await
            .with_context(|| format!("failed to write API key: {}", path.display()))?;

        debug!(api_key_path = %path.display(), "saved stored API key");

        Ok(())
    }
}