Struct WalletController 

pub struct WalletController { /* private fields */ }

WalletController manages multiple keyrings (HD + Simple) with a unified interface.

Implementations

impl WalletController

pub fn new() -> Self

pub fn create_hd_wallet( &mut self, mnemonic: Option<&str>, ) -> Result<Vec<KeyringAccount>, KeyringError>

Create a new HD wallet (optionally from existing mnemonic). Derives one initial account and returns it.

pub fn import_key( &mut self, private_key: &str, ) -> Result<KeyringAccount, KeyringError>

Import a standalone private key into a simple keyring.

pub fn derive_next_agent(&mut self) -> Result<KeyringAccount, KeyringError>

Derive next agent wallet from the first HD keyring.

pub fn get_accounts(&self) -> Vec<KeyringAccount>

Get all accounts across all keyrings.

pub fn export_account(&self, address: &str) -> Result<String, KeyringError>

Export private key for an address (searches HD keyrings first, then simple).

pub fn sign_for_account( &self, address: &str, hash: &[u8; 32], ) -> Result<[u8; 65], KeyringError>

Sign a hash with the key for a given address (routes to correct keyring).

pub fn remove_account(&mut self, address: &str) -> Result<(), KeyringError>

Remove an account from whichever keyring contains it.

pub fn serialize(&self) -> Result<Vec<u8>, KeyringError>

Serialize all keyrings for storage.

pub fn deserialize(data: &[u8]) -> Result<Self, KeyringError>

Deserialize and restore all keyrings.

Trait Implementations

impl Default for WalletController

fn default() -> Self

Returns the “default value” for a type.

impl Keyring for WalletController

fn keyring_type(&self) -> &str

Keyring type identifier (e.g., “simple”, “hd”)

fn serialize(&self) -> Result<Vec<u8>, KeyringError>

Serialize keyring state (for encrypted storage)

fn deserialize(data: &[u8]) -> Result<Self, KeyringError>

where Self: Sized,

Deserialize keyring state

fn add_accounts( &mut self, private_keys: &[String], ) -> Result<Vec<KeyringAccount>, KeyringError>

Add accounts (for SimpleKeyring: import private keys)

fn get_accounts(&self) -> Vec<KeyringAccount>

Get all accounts managed by this keyring

fn export_account(&self, address: &str) -> Result<String, KeyringError>

Export a private key for a given address

fn remove_account(&mut self, address: &str) -> Result<(), KeyringError>

Remove an account by address

fn sign_hash( &self, address: &str, hash: &[u8; 32], ) -> Result<[u8; 65], KeyringError>

Sign an arbitrary message hash (32 bytes) with the key for the given address

impl Signer for WalletController

fn sign_hash( &self, address: &str, hash: &[u8; 32], ) -> Result<[u8; 65], ExchangeError>

Sign an arbitrary message hash (32 bytes) with the key for the given address.