Module request_response_factory

Collection of request-response protocols.

The [RequestResponse] struct defined in this module provides support for zero or more so-called “request-response” protocols.

A request-response protocol works in the following way:

• For every emitted request, a new substream is open and the protocol is negotiated. If the remote supports the protocol, the size of the request is sent as a LEB128 number, followed with the request itself. The remote then sends the size of the response as a LEB128 number, followed with the response.

• Requests have a certain time limit before they time out. This time includes the time it takes to send/receive the request and response.

• If provided, a “requests processing” channel is used to handle incoming requests.

Original file commit: https://github.com/paritytech/substrate/commit/c2fc4b3ca0d7a15cc3f9cb1e5f441d99ec8d6e0b

Structs

IncomingRequest

A single request received by a peer on a request-response protocol.

OutgoingResponse

Response for an incoming request to be send by a request protocol handler.

ProtocolConfig

Configuration for a single request-response protocol.

RequestResponseFactoryBehaviour

Implementation of NetworkBehaviour that provides support for multiple request-response protocols.

Enums

Event

Event generated by the RequestResponseFactoryBehaviour.

IfDisconnected

When sending a request, what to do on a disconnected recipient.

InboundFailure

Possible failures occurring in the context of receiving an inbound request and sending a response.

OutboundFailure

Possible failures occurring in the context of sending an outbound request and receiving the response.

RegisterError

Error when registering a protocol.

RequestFailure

Error in a request.

ResponseFailure

Error when processing a request sent by a remote.

Traits

RequestHandler

Defines a handler for the request-response protocol factory.