Struct Memory 

pub struct Memory(/* private fields */);

A basic implementation of Wallet that doesn’t persist anything and merely tracks the chains in memory.

This can be used as-is as an ephemeral wallet for testing or ephemeral clients, or as a building block for more complex wallets that layer persistence on top of it.

Implementations

impl Memory

pub fn get(&self, id: ChainId) -> Option<Chain>

Returns the state of the chain with the given ID, if it is tracked.

pub fn insert(&self, id: ChainId, chain: Chain) -> Option<Chain>

Inserts or replaces the state of the given chain, returning the previous state if any.

pub fn try_insert(&self, id: ChainId, chain: Chain) -> Option<Chain>

Inserts the given chain only if it is not already tracked, returning the existing state otherwise.

pub fn remove(&self, id: ChainId) -> Option<Chain>

Removes the chain with the given ID, returning its previous state if any.

pub fn items(&self) -> Vec<(ChainId, Chain)>

Returns all tracked chains and their states.

pub fn chain_ids(&self) -> Vec<ChainId>

Returns the IDs of all tracked chains.

pub fn owned_chain_ids(&self) -> Vec<ChainId>

Returns the IDs of the tracked chains that have an owner configured.

pub fn mutate<R>( &self, chain_id: ChainId, mutate: impl Fn(&mut Chain) -> R, ) -> Option<R>

Applies a closure to the given chain if it is tracked, returning the closure’s result.

Trait Implementations

impl Clone for Memory

fn clone(&self) -> Memory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Memory

fn default() -> Memory

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Memory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Extend<(ChainId, Chain)> for Memory

fn extend<It: IntoIterator<Item = (ChainId, Chain)>>(&mut self, chains: It)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl Serialize for Memory

Custom Serialize implementation that ensures stable ordering by sorting entries by ChainId.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Wallet for Memory

type Error = Infallible

The error type returned by the wallet’s operations.

async fn get(&self, id: ChainId) -> Result<Option<Chain>, Self::Error>

Returns the state of the chain with the given ID, if it is tracked.

async fn insert( &self, id: ChainId, chain: Chain, ) -> Result<Option<Chain>, Self::Error>

Inserts or replaces the state of the given chain, returning the previous state if any.

async fn try_insert( &self, id: ChainId, chain: Chain, ) -> Result<Option<Chain>, Self::Error>

Inserts the given chain only if it is not already tracked, returning the existing state otherwise.

async fn remove(&self, id: ChainId) -> Result<Option<Chain>, Self::Error>

Removes the chain with the given ID, returning its previous state if any.

fn items(&self) -> impl Stream<Item = Result<(ChainId, Chain), Self::Error>>

Returns a stream over all tracked chains and their states.

async fn modify( &self, id: ChainId, f: impl Fn(&mut Chain) + Send, ) -> Result<Option<()>, Self::Error>

Modifies a chain in the wallet. Returns Ok(None) if the chain doesn’t exist.

fn chain_ids(&self) -> impl Stream<Item = Result<ChainId, Self::Error>> + Send

Returns a stream over the IDs of all tracked chains.

fn owned_chain_ids( &self, ) -> impl Stream<Item = Result<ChainId, Self::Error>> + Send

Returns a stream over the IDs of the tracked chains that have an owner.