Carteiras e Gerenciamento de Chaves

Gerencie keypairs, derivação HD e fluxos de assinatura em carteiras e validadores Rust sem vazar segredos.

Receita

use ed25519_dalek::SigningKey;
use rand::rngs::OsRng;
 
struct KeyStore {
    signing: SigningKey,
}
 
impl KeyStore {
    fn generate() -> Self {
        Self {
            signing: SigningKey::generate(&mut OsRng),
        }
    }
 
    fn sign(&self, msg: &[u8]) -> ed25519_dalek::Signature {
        use ed25519_dalek::Signer;
        self.signing.sign(msg)
    }
}

Quando usar isso:

• Carteiras CLI e signers de bot para estratégias automatizadas
• Serviços de custódia com APIs de assinatura com suporte de HSM
• Chaves de identidade de validador separadas das carteiras operacionais "hot"

Exemplo de Trabalho

Documentação de caminho estilo HD com limite explícito de crate de derivação:

use ed25519_dalek::SigningKey;
use bip39::{Language, Mnemonic, Seed};
use rand::rngs::OsRng;
 
fn derive_from_mnemonic(words: &str, path: &str) -> anyhow::Result<SigningKey> {
    let mnemonic = Mnemonic::parse_in(Language::English, words)?;
    let seed = Seed::new(&mnemonic, "");
    // Use a crate de derivação SLIP-0010 ou ed25519 específica da cadeia para `path`
    let _ = (seed.as_bytes(), path);
    Ok(SigningKey::generate(&mut OsRng)) // placeholder: substituir por derivação real
}

O que isso demonstra:

• Análise de mnemônicos sem imprimir a seed no stdout
• Separação entre geração de seed e derivação de caminho específica da cadeia
• Propagação de erros com Result em vez de panics na UX da carteira

Mergulho Profundo

Como Funciona

• Mnemônico codifica entropia como palavras; BIP-39 padroniza listas de palavras.
• Caminhos HD como m/44'/501'/0'/0' mapeiam contas por cadeia (Solana 501).
• Keystore JSON criptografa a chave privada com chave derivada de senha.
• HSM/MPC movem a operação de assinatura para fora da memória do laptop.

Níveis de Chave

Armadilhas

• Commit de mnemônicos no git - perda instantânea de fundos. Correção: scan git-secrets; use env + KMS em CI apenas para chaves de teste.
• Mesma chave para deploy e tesouraria - um vazamento drena tudo. Correção: chaves separadas por função com multisig na tesouraria.
• Erro de digitação no caminho de derivação - o usuário vê uma carteira vazia. Correção: exibir o caminho na UI e vetores de teste contra endereços conhecidos.
• Assinar JSON de usuário bruto - phishing troca campos. Correção: mensagens tipadas estruturadas com tags de domínio.
• Backup de seed na área de transferência - malware coleta a área de transferência. Correção: desencorajar área de transferência; preferir exibição em hardware.

Alternativas

FAQs

Relacionado

• Criptografia Aplicada - curvas e hashes
• Programas Solana - autoridades de programa
• Segurança e Auditoria - auditorias de manuseio de chaves
• Fundamentos de Blockchain em Rust - exemplo de keygen

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.