Struct PersistentWallet 

pub struct PersistentWallet { /* private fields */ }

A wallet that automatically persists state to a WalletStore after mutations.

Wraps an InMemoryWallet and a WalletStore implementation. All read operations delegate directly to the inner wallet. Write operations (key generation, key import, transaction broadcast) trigger an automatic save after the operation completes.

Construction

Use PersistentWallet::new() to create a persistent wallet. If the store contains previously saved state, it will be loaded into the inner wallet.

Implementations

impl PersistentWallet

pub async fn new( inner: Arc<InMemoryWallet>, store: Arc<dyn WalletStore>, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Create a persistent wallet, loading any existing state from the store.

If the store contains a saved snapshot, it is restored into the inner wallet. If the store is empty (first run), the wallet starts fresh.

pub async fn save(&self) -> Result<(), Box<dyn Error + Send + Sync>>

Save the current wallet state to the store.

pub async fn add_utxo( &self, utxo: UnspentOutput, ) -> Result<(), Box<dyn Error + Send + Sync>>

Add a UTXO and persist.

pub async fn remove_utxos( &self, spent: &[OutPoint], ) -> Result<(), Box<dyn Error + Send + Sync>>

Remove spent UTXOs and persist.

pub async fn key_count(&self) -> usize

Get the number of keys in the wallet.

pub fn inner(&self) -> &InMemoryWallet

Get a reference to the inner InMemoryWallet.

Trait Implementations

impl WalletPort for PersistentWallet

fn get_balance<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Balance, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gets the wallet’s current balance.

fn list_unspent<'life0, 'async_trait>( &'life0 self, min_confirmations: u32, max_amount: Option<Amount>, ) -> Pin<Box<dyn Future<Output = Result<Vec<UnspentOutput>, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists all unspent outputs (UTXOs) controlled by the wallet.

fn create_transaction<'life0, 'async_trait>( &'life0 self, to: Vec<(String, Amount)>, fee_rate: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<Transaction, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Creates a transaction sending to specified addresses.

fn sign_transaction<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 Transaction, ) -> Pin<Box<dyn Future<Output = Result<Transaction, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Signs a transaction with wallet keys.

fn send_transaction<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 Transaction, ) -> Pin<Box<dyn Future<Output = Result<String, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Broadcasts a signed transaction to the network.

fn get_new_address<'life0, 'life1, 'async_trait>( &'life0 self, label: Option<&'life1 str>, ) -> Pin<Box<dyn Future<Output = Result<String, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Generates a new address for receiving funds.

fn import_key<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, privkey_wif: &'life1 str, label: Option<&'life2 str>, rescan: bool, ) -> Pin<Box<dyn Future<Output = Result<(), Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Imports a private key into the wallet.

fn get_transaction_history<'life0, 'async_trait>( &'life0 self, count: u32, skip: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<Transaction>, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gets transaction history for the wallet.