Struct ClientContext

pub struct ClientContext<M> { /* private fields */ }

A Client context for a ClientModule M

Client modules can interact with the whole client through this struct.

Implementations

impl<M> ClientContext<M>

where M: ClientModule,

pub fn self_ref<'s>(&'s self) -> ClientContextSelfRef<'s, M>

Get a reference back to client module from the Self

It’s often necessary for a client module to “move self” by-value, especially due to async lifetimes issues. Clients usually work with &mut self, which can’t really work in such context.

Fortunately ClientContext is Clone and `Send, and can be used to recover the reference to the module at later time.

pub fn global_api(&self) -> DynGlobalApi

Get a reference to a global Api handle

pub fn decoders(&self) -> ModuleDecoderRegistry

pub fn input_from_dyn<'i>( &self, input: &'i DynInput, ) -> Option<&'i <M::Common as ModuleCommon>::Input>

pub fn output_from_dyn<'o>( &self, output: &'o DynOutput, ) -> Option<&'o <M::Common as ModuleCommon>::Output>

pub fn map_dyn<'s, 'i, 'o, I>( &'s self, typed: impl IntoIterator<Item = I> + 'i, ) -> impl Iterator<Item = <I as IntoDynInstance>::DynType> + 'o

where I: IntoDynInstance, 'i: 'o, 's: 'o,

pub fn make_dyn_output( &self, output: <M::Common as ModuleCommon>::Output, ) -> DynOutput

Turn a typed output into a dyn version

pub fn make_dyn_input( &self, input: <M::Common as ModuleCommon>::Input, ) -> DynInput

Turn a typed input into a dyn version

pub fn make_dyn<I>(&self, typed: I) -> <I as IntoDynInstance>::DynType

where I: IntoDynInstance,

Turn a typed into a dyn version

pub fn make_client_output<O, S>( &self, output: ClientOutput<O, S>, ) -> ClientOutput

where O: IntoDynInstance<DynType = DynOutput> + 'static, S: IntoDynInstance<DynType = DynState> + 'static,

Turn a typed ClientOutput into a dyn version

pub fn make_client_input<O, S>(&self, input: ClientInput<O, S>) -> ClientInput

where O: IntoDynInstance<DynType = DynInput> + 'static, S: IntoDynInstance<DynType = DynState> + 'static,

Turn a typed ClientInput into a dyn version

pub fn make_dyn_state<S>(&self, sm: S) -> DynState

where S: IState + 'static,

pub async fn module_autocommit<'s, 'dbtx, F, T, E>( &'s self, tx_fn: F, max_attempts: Option<usize>, ) -> Result<T, AutocommitError<E>>

where for<'r, 'o> F: Fn(&'r mut ClientDbTxContext<'r, 'o, M>, PhantomBound<'dbtx, 'o>) -> BoxFuture<'r, Result<T, E>> + MaybeSync, 's: 'dbtx,

An Database::autocommit on module’s own database partition

pub async fn module_autocommit_2<'s, 'dbtx, F, T>( &'s self, tx_fn: F, max_attempts: Option<usize>, ) -> Result<T>

where for<'r, 'o> F: Fn(&'r mut ClientDbTxContext<'r, 'o, M>, PhantomBound<'dbtx, 'o>) -> BoxFuture<'r, Result<T>> + MaybeSync, 's: 'dbtx,

pub async fn finalize_and_submit_transaction<F, Meta>( &self, operation_id: OperationId, operation_type: &str, operation_meta: F, tx_builder: TransactionBuilder, ) -> Result<(TransactionId, Vec<OutPoint>)>

where F: Fn(TransactionId, Vec<OutPoint>) -> Meta + Clone + MaybeSend + MaybeSync, Meta: Serialize + MaybeSend,

See crate::Client::finalize_and_submit_transaction

pub async fn transaction_updates( &self, operation_id: OperationId, ) -> TransactionUpdates

See crate::Client::transaction_updates

pub async fn await_primary_module_outputs( &self, operation_id: OperationId, outputs: Vec<OutPoint>, ) -> Result<Amount>

See crate::Client::await_primary_module_outputs

pub async fn get_operation( &self, operation_id: OperationId, ) -> Result<OperationLogEntry>

pub fn global_db(&self) -> Database

pub fn module_db(&self) -> &Database

pub async fn has_active_states(&self, op_id: OperationId) -> bool

pub async fn operation_exists(&self, op_id: OperationId) -> bool

pub async fn get_own_active_states(&self) -> Vec<(M::States, ActiveStateMeta)>

pub async fn get_config(&self) -> ClientConfig

pub async fn get_invite_code(&self) -> InviteCode

Returns an invite code for the federation that points to an arbitrary guardian server for fetching the config

pub fn get_internal_payment_markers(&self) -> Result<(PublicKey, u64)>

pub async fn manual_operation_start( &self, operation_id: OperationId, op_type: &str, operation_meta: impl Serialize + Debug, sms: Vec<DynState>, ) -> Result<()>

This method starts n state machines with given operation id without a corresponding transaction

pub async fn manual_operation_start_dbtx<C: ClientModule>( &self, dbtx: &mut ClientDbTxContext<'_, '_, C>, operation_id: OperationId, op_type: &str, operation_meta: impl Serialize + Debug, sms: Vec<DynState>, ) -> Result<()>

Trait Implementations

impl<M> Clone for ClientContext<M>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M> Debug for ClientContext<M>

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

Formats the value using the given formatter.