Passa al contenuto principale

Wallet

Il Wallet gestisce le coppie di chiavi ed25519, firma i messaggi e si connette opzionalmente a un nodo RPC per le interrogazioni on-chain.

Gestione delle Chiavi​

Crea un Nuovo Wallet​

use savitri_sdk::Wallet;

// Random keypair (cryptographically secure)
let wallet = Wallet::new();
println!("Address: {}", wallet.address());  // 64 hex chars (32-byte pubkey)

Importa da Chiave Privata​

// From raw bytes
let private_key: [u8; 32] = [/* your key */];
let wallet = Wallet::from_private_key(&private_key)?;

// From hex string
let wallet = Wallet::from_private_key_hex("aabbccdd...64hexchars")?;

// With 0x prefix
let wallet = Wallet::from_private_key_hex("0xaabbccdd...64hexchars")?;

Esporta le Chiavi​

// Public key (safe to share)
let pubkey = wallet.public_key();
println!("Public key: {}", hex::encode(pubkey.as_bytes()));

// Address (derived from public key)
println!("Address: {}", wallet.address());

// Private key (NEVER share or log)
let privkey: [u8; 32] = wallet.private_key();

Firma​

Firma un Messaggio​

let message = b"Hello, Savitri!";
let signature: [u8; 64] = wallet.sign_message(message);

Verifica una Firma​

wallet.verify_signature(message, &signature)?;
// Returns Ok(()) if valid, Err if invalid

Lo schema di firma usa Ed25519 (ed25519-dalek). Per la firma delle transazioni, il messaggio viene prima sottoposto a hash SHA-256:

message = from_hex || to_hex || amount_le_u64 || nonce_le_u64 || fee_le_u128
hash    = SHA-256(message)
sig     = Ed25519_sign(hash)

Integrazione RPC​

Connetti un wallet a un nodo per le interrogazioni on-chain:

// Create with RPC connection
let wallet = Wallet::with_rpc("http://localhost:8545")?;

// Or connect later
let mut wallet = Wallet::new();
wallet.connect_rpc("http://localhost:8545")?;

// Query balance (requires RPC)
let balance: String = wallet.get_balance().await?;
println!("Balance: {}", balance);

// Query nonce (requires RPC)
let nonce: u64 = wallet.get_nonce().await?;
println!("Nonce: {}", nonce);

// Access underlying RPC client
if let Some(rpc) = wallet.rpc() {
    let height = rpc.get_block_number().await?;
    println!("Height: {}", height);
}

Sicurezza​

  • Azzeramento: Il materiale della chiave privata viene azzerato quando il wallet viene distrutto (trait Drop tramite crate zeroize).
  • Comportamento del clone: I wallet clonati NON ereditano la connessione RPC (partono disconnessi).
  • Nessuna persistenza: Il wallet non salva le chiavi su disco. Usa il tuo sistema di archiviazione sicura.
{
    let wallet = Wallet::new();
    // ... use wallet ...
} // wallet dropped here — private key bytes are zeroed in memory