rustywallet-recovery

Wallet recovery tools for Bitcoin - scan blockchain for funds from mnemonic or xpub.

Features

• Mnemonic Recovery: Scan all standard derivation paths from a seed phrase
• Extended Key Recovery: Scan from xpub or xprv
• Multi-Path Support: BIP44, BIP49, BIP84, BIP86
• Gap Limit: Configurable gap limit for address scanning
• UTXO Discovery: Find all unspent outputs for spending
• Progress Reporting: Callback for scan progress updates

Installation

[dependencies]
rustywallet-recovery = "0.1"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Usage

Basic Recovery from Mnemonic

use rustywallet_recovery::{RecoveryScanner, RecoveryConfig, ElectrumBackend};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Connect to Electrum server
    let backend = ElectrumBackend::mainnet().await?;

    // Configure scan
    let config = RecoveryConfig::new()
        .with_gap_limit(20);

    // Create scanner from mnemonic
    let mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
    let scanner = RecoveryScanner::from_mnemonic(mnemonic, None, backend, config)?;

    // Run scan
    let result = scanner.scan().await?;

    println!("Total balance: {} sats", result.total_balance);
    println!("Addresses found: {}", result.addresses.len());
    println!("UTXOs found: {}", result.utxos.len());
    
    // Print summary
    println!("{}", result.summary());
    
    Ok(())
}

Quick Scan (Smaller Gap Limit)

use rustywallet_recovery::{RecoveryScanner, RecoveryConfig, ElectrumBackend, ScanPath};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = RecoveryConfig::quick()
        .with_scan_paths(vec![ScanPath::Bip84]); // Only native segwit

    let backend = ElectrumBackend::mainnet().await?;
    let scanner = RecoveryScanner::from_mnemonic("your mnemonic...", None, backend, config)?;

    let result = scanner.scan().await?;
    println!("{}", result.summary());
    Ok(())
}

Recovery from Extended Public Key

use rustywallet_recovery::{RecoveryScanner, RecoveryConfig, ElectrumBackend};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let backend = ElectrumBackend::mainnet().await?;
    let config = RecoveryConfig::new();

    let xpub = "xpub661MyMwAqRbcFtXgS5sYJABqqG9YLmC4Q1Rdap9gSE8NqtwybGhePY2gZ29ESFjqJoCu1Rupje8YtGqsefD265TMg7usUDFdp6W1EGMcet8";
    let scanner = RecoveryScanner::from_xpub(xpub, backend, config)?;

    let result = scanner.scan().await?;
    println!("Found {} addresses with balance", result.addresses.len());
    Ok(())
}

Export Results to JSON

let result = scanner.scan().await?;
let json = result.to_json()?;
std::fs::write("recovery_result.json", json)?;

Configuration Options

Scan Paths

License

MIT