Struct WalletRepository 

pub struct WalletRepository { /* private fields */ }

FFI-compatible WalletRepository

Implementations

impl WalletRepository

pub fn new(mnemonic: String, store: WalletStore) -> Result<Self, FfiError>

Create a new WalletRepository from locally persisted wallet state.

Construction does not make network requests to configured mints.

Accepts a WalletStore which can be:

• Sqlite { path } — built-in Rust SQLite backend
• Postgres { url } — built-in Rust Postgres backend
• Custom { db } — foreign-language implementation of WalletDatabase

pub fn new_with_proxy( mnemonic: String, store: WalletStore, proxy_url: String, ) -> Result<Self, FfiError>

Create a new WalletRepository with proxy configuration.

Construction restores locally persisted wallet state without making network requests to configured mints. The proxy is used by subsequent mint operations.

pub async fn set_metadata_cache_ttl_for_mint( &self, mint_url: MintUrl, ttl_secs: Option<u64>, ) -> Result<(), FfiError>

Set metadata cache TTL (time-to-live) in seconds for a specific mint

Controls how long cached mint metadata (keysets, keys, mint info) is considered fresh before requiring a refresh from the mint server for a specific mint.

Arguments

• mint_url - The mint URL to set the TTL for
• ttl_secs - Optional TTL in seconds. If None, cache never expires.

pub async fn set_metadata_cache_ttl_for_all_mints(&self, ttl_secs: Option<u64>)

Set metadata cache TTL (time-to-live) in seconds for all mints

Controls how long cached mint metadata is considered fresh for all mints in this WalletRepository.

Arguments

• ttl_secs - Optional TTL in seconds. If None, cache never expires for any mint.

pub async fn create_wallet( &self, mint_url: MintUrl, unit: Option<CurrencyUnit>, target_proof_count: Option<u32>, ) -> Result<(), FfiError>

Add a mint to this WalletRepository

pub async fn remove_wallet( &self, mint_url: MintUrl, currency_unit: CurrencyUnit, ) -> Result<(), FfiError>

Remove mint from WalletRepository

pub async fn has_mint(&self, mint_url: MintUrl) -> bool

Check if mint is in wallet

pub fn mint_backup_public_key(&self) -> Result<String, FfiError>

Get the NUT-27 mint backup public key as hex.

pub async fn backup_mints( &self, relays: Vec<String>, options: BackupOptions, ) -> Result<BackupResult, FfiError>

Backup the current mint list to Nostr relays using NUT-27.

pub async fn restore_mints( &self, relays: Vec<String>, add_mints: bool, options: RestoreOptions, ) -> Result<RestoreResult, FfiError>

Restore the mint list from Nostr relays using NUT-27.

pub async fn fetch_mint_backup( &self, relays: Vec<String>, options: RestoreOptions, ) -> Result<MintBackup, FfiError>

Fetch the NUT-27 mint backup without adding mints to the repository.

pub async fn get_balances(&self) -> Result<HashMap<WalletKey, Amount>, FfiError>

Get wallet balances for all mints

pub async fn get_wallets(&self) -> Vec<Arc<Wallet>>

Get all wallets from WalletRepository

pub async fn get_wallet( &self, mint_url: MintUrl, unit: CurrencyUnit, ) -> Result<Arc<Wallet>, FfiError>

Get a specific wallet from WalletRepository by mint URL

Returns an error if no wallet exists for the given mint URL.

pub async fn get_token_data( &self, token: Arc<Token>, ) -> Result<TokenData, FfiError>

Get token data, including the expected redemption fee, without redeeming it.

Trait Implementations

impl<UT> LiftRef<UT> for WalletRepository

type LiftType = Arc<WalletRepository>

impl<UT> LowerError<UT> for WalletRepository

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for WalletRepository

type ReturnType = <Arc<WalletRepository> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for WalletRepository

const TYPE_ID_META: MetadataBuffer