Trait QueryStrategy

Source

pub trait QueryStrategy<IR, OR = IR> {
    // Required method
    fn process(
        &mut self,
        peer_id: PeerId,
        response: IR,
    ) -> impl Future<Output = QueryStep<OR>> + MaybeSend;

    // Provided method
    fn process_error(
        &mut self,
        _peer_id: PeerId,
        _error: &ServerError,
    ) -> QueryStep<OR> { ... }
}

Expand description

Fedimint query strategy

Due to federated security model each Fedimint client API call to the Federation might require a different way to process one or more required responses from the Federation members. This trait abstracts away the details of each specific strategy for the generic client Api code.

Required Methods§

Source

fn process( &mut self, peer_id: PeerId, response: IR, ) -> impl Future<Output = QueryStep<OR>> + MaybeSend

Processes a peer’s response.

A strategy that verifies responses awaits the verification, so a heavy one can run off the async workers.

Provided Methods§

Source

fn process_error( &mut self, _peer_id: PeerId, _error: &ServerError, ) -> QueryStep<OR>

Called when a peer’s request fails, so a strategy can tell “still waiting” apart from “will never answer”.

Defaults to QueryStep::Continue, leaving failed peers entirely to the caller’s error accounting, which is what every strategy other than ThresholdAgreement wants.