Rust密钥存储库holochain_keystore使用指南

概述

holochain_keystore是Rust中一个安全高效的密钥管理与加密库，专为Holochain生态设计，但也适用于其他需要密钥管理的Rust项目。它提供了密钥生成、存储、签名和加密等核心功能。

主要特性

• 安全的密钥存储和管理
• 支持多种加密算法
• 线程安全的操作
• 简单的API设计
• 与Holochain生态无缝集成

安装

在Cargo.toml中添加依赖：

[dependencies]
holochain_keystore = "0.1.0"

基本使用方法

1. 创建密钥存储

use holochain_keystore::*;
use holochain_keystore::keystore::*;

async fn create_keystore() -> KeystoreResult<MetaLairClient> {
    let keystore = lair_keystore_in_memory().await?;
    Ok(keystore)
}

2. 生成新密钥

async fn generate_new_key(keystore: &MetaLairClient) -> KeystoreResult<holochain_keystore::AgentPubKey> {
    let key = keystore.new_sign_key_ed25519().await?;
    Ok(key)
}

3. 使用密钥签名

async fn sign_data(
    keystore: &MetaLairClient,
    key: &AgentPubKey,
    data: &[u8],
) -> KeystoreResult<Signature> {
    let signature = keystore.sign(key.clone(), data.to_vec()).await?;
    Ok(signature)
}

4. 验证签名

async fn verify_signature(
    keystore: &MetaLairClient,
    key: &AgentPubKey,
    signature: &Signature,
    data: &[u8],
) -> KeystoreResult<bool> {
    let valid = keystore.verify_signature(key.clone(), signature.clone(), data.to_vec()).await?;
    Ok(valid)
}

高级用法

1. 加密数据

async fn encrypt_data(
    keystore: &MetaLairClient,
    sender_key: &AgentPubKey,
    recipient_key: &AgentPubKey,
    data: &[u8],
) -> KeystoreResult<Vec<u8>> {
    let encrypted = keystore.encrypt_x25519(
        sender_key.clone(),
        recipient_key.clone(),
        data.to_vec()
    ).await?;
    Ok(encrypted)
}

2. 解密数据

async fn decrypt_data(
    keystore: &MetaLairClient,
    recipient_key: &AgentPubKey,
    sender_key: &AgentPubKey,
    encrypted_data: &[u8],
) -> KeystoreResult<Vec<u8>> {
    let decrypted = keystore.decrypt_x25519(
        recipient_key.clone(),
        sender_key.clone(),
        encrypted_data.to_vec()
    ).await?;
    Ok(decrypted)
}

3. 密钥派生

async fn derive_key(
    keystore: &MetaLairClient,
    base_key: &AgentPubKey,
    context: &[u8],
) -> KeystoreResult<AgentPubKey> {
    let derived_key = keystore.derive_seed(base_key.clone(), context.to_vec()).await?;
    Ok(derived_key)
}

完整示例

use holochain_keystore::*;
use holochain_keystore::keystore::*;

#[tokio::main]
async fn main() -> KeystoreResult<()> {
    // 1. 创建密钥存储
    let keystore = lair_keystore_in_memory().await?;
    
    // 2. 生成密钥对
    let key = keystore.new_sign_key_ed25519().await?;
    println!("Generated key: {:?}", key);
    
    // 3. 签名数据
    let data = b"Hello, holochain_keystore!";
    let signature = keystore.sign(key.clone(), data.to_vec()).await?;
    println!("Signature: {:?}", signature);
    
    // 4. 验证签名
    let valid = keystore.verify_signature(key.clone(), signature.clone(), data.to_vec()).await?;
    println!("Signature valid: {}", valid);
    
    // 5. 加密示例
    let recipient_key = keystore.new_sign_key_ed25519().await?;
    let encrypted = keystore.encrypt_x25519(
        key.clone(),
        recipient_key.clone(),
        data.to_vec()
    ).await?;
    println!("Encrypted data length: {}", encrypted.len());
    
    // 6. 解密示例
    let decrypted = keystore.decrypt_x25519(
        recipient_key.clone(),
        key.clone(),
        encrypted
    ).await?;
    println!("Decrypted data: {:?}", String::from_utf8_lossy(&decrypted));
    
    Ok(())
}

注意事项

1. 生产环境中应使用持久化存储而非内存存储
2. 妥善保管主密钥，它是访问所有派生密钥的关键
3. 定期轮换敏感密钥
4. 使用最新版本的库以获得安全更新

holochain_keystore为Rust开发者提供了强大的密钥管理功能，特别适合分布式应用和安全敏感场景。