Documentation
¶
Overview ¶
Request package is responsible for parsing and forwarding user requests. It is not responsible for QoS, authorization, etc... For example, Processing should fail here only if no authoritative service ID is provided - Bad Request
The responsibility of the `request` package is to extract the authoritative service ID and return the target service's corresponding QoS instance. See: https://github.com/pokt-network/path/blob/e0067eb0f9ab0956127c952980b09909a795b300/gateway/gateway.go#L52C2-L52C45
Index ¶
Constants ¶
const ( // HTTPHeaderTargetServiceID is the key used to lookup the HTTP header specifying the target // service's ID. HTTPHeaderTargetServiceID = "Target-Service-Id" // TODO_DOCUMENT(@adshmh): Update the docs at https://path.grove.city/ to reflect this usage pattern. // HTTPHeaderAppAddress is the key of the entry in HTTP headers that holds the target app's address // in delegated mode. The target app will be used for sending the relay request. HTTPHeaderAppAddress = "App-Address" )
HTTP Request Headers Please see the following link on the deprecation of X- prefix in HTTP header parameter names and why it wasn't used: https://www.rfc-editor.org/rfc/rfc6648#section-3
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Parser ¶
type Parser struct {
Logger polylog.Logger
// QoSServices is the set of QoS services to which the request parser should map requests based on the extracted service ID.
QoSServices map[protocol.ServiceID]gateway.QoSService
}
The Parser struct is responsible for parsing the authoritative service ID from the request's 'Target-Service-Id' header and returning the corresponding QoS service implementation.
func (*Parser) GetHTTPErrorResponse ¶
GetHTTPErrorResponse returns an HTTP response with the appropriate status code and error message, which ensures the error response is returned in a valid JSON format.
func (*Parser) GetQoSService ¶
func (p *Parser) GetQoSService(ctx context.Context, req *http.Request) (protocol.ServiceID, gateway.QoSService, error)
GetQoSService returns the QoS service implementation for the given request, as well as the authoritative service ID. If the service ID does not have a corresponding QoS implementation, the NoOp QoS service is returned.
Source Files