Struct ValidatorWorkerClient

pub struct ValidatorWorkerClient<T> { /* private fields */ }

Interface provided by each physical shard (aka “worker”) of a validator or a local node.

• All commands return either the current chain info or an error.
• Repeating commands produces no changes and returns no error.
• Some handlers may return cross-chain requests, that is, messages to be communicated to other workers of the same validator.

Implementations

impl<T> ValidatorWorkerClient<T>

where T: GrpcService<BoxBody>, T::Error: Into<StdError>, T::ResponseBody: Body<Data = Bytes> + Send + 'static, <T::ResponseBody as Body>::Error: Into<StdError> + Send,

pub fn new(inner: T) -> Self

pub fn with_origin(inner: T, origin: Uri) -> Self

pub fn with_interceptor<F>( inner: T, interceptor: F, ) -> ValidatorWorkerClient<InterceptedService<T, F>>

where F: Interceptor, T::ResponseBody: Default, T: Service<Request<BoxBody>, Response = Response<<T as GrpcService<BoxBody>>::ResponseBody>>, <T as Service<Request<BoxBody>>>::Error: Into<StdError> + Send + Sync,

pub fn send_compressed(self, encoding: CompressionEncoding) -> Self

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

pub fn accept_compressed(self, encoding: CompressionEncoding) -> Self

Enable decompressing responses.

pub fn max_decoding_message_size(self, limit: usize) -> Self

Limits the maximum size of a decoded message.

Default: 4MB

pub fn max_encoding_message_size(self, limit: usize) -> Self

Limits the maximum size of an encoded message.

Default: usize::MAX

pub async fn handle_block_proposal( &mut self, request: impl IntoRequest<BlockProposal>, ) -> Result<Response<ChainInfoResult>, Status>

Propose a new block.

pub async fn handle_lite_certificate( &mut self, request: impl IntoRequest<LiteCertificate>, ) -> Result<Response<ChainInfoResult>, Status>

Process a certificate without value.

pub async fn handle_certificate( &mut self, request: impl IntoRequest<HandleCertificateRequest>, ) -> Result<Response<ChainInfoResult>, Status>

Process a certificate.

pub async fn handle_chain_info_query( &mut self, request: impl IntoRequest<ChainInfoQuery>, ) -> Result<Response<ChainInfoResult>, Status>

Handle information queries for this chain.

pub async fn handle_cross_chain_request( &mut self, request: impl IntoRequest<CrossChainRequest>, ) -> Result<Response<()>, Status>

Handle a (trusted!) cross-chain request.

Trait Implementations

impl<T: Clone> Clone for ValidatorWorkerClient<T>

fn clone(&self) -> ValidatorWorkerClient<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ValidatorWorkerClient<T>

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

Formats the value using the given formatter.