rustywallet 🦀💰

🎯 Features

📦 Crates

Core

Performance & Network

Transaction & PSBT

Advanced Cryptography

Utility

🔧 Feature Matrix

🚀 Quick Start

Installation

[dependencies]
rustywallet = "0.1"

[dependencies]
rustywallet-keys = "0.1"
rustywallet-address = "0.3"
rustywallet-tx = "0.3"

Basic Usage

use rustywallet::prelude::*;
// Generate a random private key
let private_key = PrivateKey::random();
println!("WIF: {}", private_key.to_wif(Network::Mainnet));
// Generate Bitcoin address
let address = Address::p2wpkh(&private_key.public_key(), Network::Mainnet)?;
println!("Address: {}", address);
// Generate from mnemonic
let mnemonic = Mnemonic::generate(12)?;
println!("Mnemonic: {}", mnemonic.phrase());

Descriptor-Based Address Derivation

use rustywallet_address::prelude::*;
// Derive from wpkh descriptor
let addr = Address::from_descriptor(
 "wpkh(02c6047f9441ed7d6d3045406e95c07cd85c778e4b8cef3ca7abac09b95c709ee5)",
 0,
 Network::BitcoinMainnet,
)?;
// Derive from Taproot descriptor
let addr = Address::from_descriptor(
 "tr(02c6047f9441ed7d6d3045406e95c07cd85c778e4b8cef3ca7abac09b95c709ee5)",
 0,
 Network::BitcoinMainnet,
)?;

BOLT12 Offers

use rustywallet_lightning::bolt12::{Bolt12Offer, OfferBuilder};
// Create an offer
let offer = OfferBuilder::new()
 .description("Coffee")
 .amount_msats(10_000)
 .issuer("Bob's Coffee Shop")
 .build()?;
println!("Offer: {}", offer.encode()); // lno1...
// Parse an offer
let parsed = Bolt12Offer::parse(&offer.encode())?;

High-Performance Batch Generation

use rustywallet_batch::prelude::*;
// Generate keys at 7M+ keys/sec
let generator = FastKeyGenerator::new();
for key in generator.take(1_000_000) {
 // Process key...
}
// Generate addresses in parallel
let addr_gen = BatchAddressGenerator::new(BatchAddressType::P2TR, Network::Mainnet);
for (key, address) in addr_gen.generate_stream(10_000) {
 // Process...
}

Vanity Address Generation (Including Taproot)

use rustywallet_vanity::prelude::*;
// Find Taproot address with pattern
let result = VanityGenerator::new()
 .address_type(AddressType::P2TR)
 .pattern(Pattern::prefix("abc"))
 .generate()?;
println!("Found: {}", result.address); // bc1pabc...

Electrum Balance Checking

use rustywallet_electrum::{ElectrumClient, Network};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
 let client = ElectrumClient::connect("electrum.blockstream.info:50002", Network::Mainnet).await?;
 
 // Check balance - no rate limits!
 let balance = client.get_balance("bc1q...").await?;
 println!("Balance: {} sats", balance.confirmed);
 
 Ok(())
}

Counting Bloom Filter

use rustywallet_bloom::CountingBloomFilter;
let mut filter = CountingBloomFilter::new(100_000, 0.01);
// Insert and remove items
filter.insert("address1");
filter.insert("address2");
assert!(filter.contains("address1"));
filter.remove("address1")?;
assert!(!filter.contains("address1"));

Multi-Language Mnemonics

use rustywallet_mnemonic::{Mnemonic, Language};
// Generate in Japanese
let mnemonic = Mnemonic::generate_with_language(12, Language::Japanese)?;
// Auto-detect language when parsing
let parsed = Mnemonic::parse_auto_detect("あいこくしん あいさつ...")?;
assert_eq!(parsed.language(), Language::Japanese);

SLIP39 Shamir Secret Sharing

use rustywallet_hd::Slip39;
// Split seed into 5 shares, need 3 to recover
let slip39 = Slip39::new(3, 5);
let shares = slip39.split(&seed)?;
// Recover with any 3 shares
let recovered = Slip39::combine(&shares[0..3])?;

📚 Documentation

🔒 Security

🤝 Contributing

📄 License

⭐ Star History