Struct ZewifWallet

pub struct ZewifWallet { /* private fields */ }

A complete Zcash wallet with multiple accounts and cryptographic key material.

ZewifWallet represents an entire wallet consisting of multiple accounts, all operating on the same Zcash network. It can optionally include seed material for generating keys. This structure is the primary container for user wallet data but is not the top level of the interchange format hierarchy (that’s Zewif).

Zcash Concept Relation

In Zcash wallet architecture:

• Network Context: Wallets operate within a specific Zcash network environment (mainnet, testnet, regtest)
• Multi-Account Organization: A single wallet can contain multiple accounts for different purposes or users
• HD Wallet Structure: When a seed is present, the wallet follows hierarchical deterministic (HD) principles for key derivation

Data Preservation

During wallet migration, the following wallet data must be preserved:

• Network: The Zcash network context (mainnet, testnet, regtest)
• Seed Material: When available, the cryptographic material used for key generation
• Accounts: All accounts contained within the wallet, with their full structure
• Vendor-Specific Information: Custom metadata stored in attachments

Examples

// Create a new wallet for the Zcash mainnet
let mut wallet = ZewifWallet::new(Network::Main);

// Add a new account to the wallet
let account = Account::new();
wallet.add_account(account);

// Access the wallet's network
assert_eq!(wallet.network(), Network::Main);

// If seed material were available, you could add it:
// wallet.set_seed_material(seed_material);

Implementations

impl ZewifWallet

pub fn new(network: Network) -> Self

pub fn network(&self) -> Network

pub fn seed_material(&self) -> Option<&SeedMaterial>

pub fn set_seed_material(&mut self, seed_material: SeedMaterial)

pub fn accounts(&self) -> &Vec<Account>

pub fn add_account(&mut self, account: Account)

Trait Implementations

impl Attachable for ZewifWallet

fn attachments(&self) -> &Attachments

Returns a reference to the attachments container.

fn attachments_mut(&mut self) -> &mut Attachments

Returns a mutable reference to the attachments container.

fn add_attachment( &mut self, payload: impl EnvelopeEncodable, vendor: &str, conforms_to: Option<&str>, )

Adds a new attachment with the specified payload and metadata.

fn get_attachment(&self, digest: &Digest) -> Option<&Envelope>

Retrieves an attachment by its digest.

fn remove_attachment(&mut self, digest: &Digest) -> Option<Envelope>

Removes an attachment by its digest.

fn clear_attachments(&mut self)

Removes all attachments from the object.

fn has_attachments(&self) -> bool

Returns whether the object has any attachments.

impl Clone for ZewifWallet

fn clone(&self) -> ZewifWallet

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ZewifWallet

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<ZewifWallet> for Envelope

fn from(value: ZewifWallet) -> Self

Converts to this type from the input type.

impl Indexed for ZewifWallet

fn index(&self) -> usize

fn set_index(&mut self, index: usize)

impl PartialEq for ZewifWallet

fn eq(&self, other: &ZewifWallet) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<Envelope> for ZewifWallet

type Error = Error

The type returned in the event of a conversion error.

fn try_from(envelope: Envelope) -> Result<Self, Self::Error>

Performs the conversion.

impl StructuralPartialEq for ZewifWallet