qos

type BackendServiceDetails struct {
	BackendServiceType BackendServiceType `` /* 151-byte string literal not displayed */
	SelectionReason    string             `protobuf:"bytes,2,opt,name=selection_reason,json=selectionReason,proto3" json:"selection_reason,omitempty"`
	// contains filtered or unexported fields
}

type BackendServiceType int32

type CosmosEndpointObservation struct {

	// Address of the endpoint handling the request
	EndpointAddr string `protobuf:"bytes,1,opt,name=endpoint_addr,json=endpointAddr,proto3" json:"endpoint_addr,omitempty"`
	// Result of validating the endpoint response.
	// Examples:
	//   - invalid JSONRPC response
	//   - unexpected format of response to REST request.
	EndpointResponseValidationResult *CosmosEndpointResponseValidationResult `` /* 161-byte string literal not displayed */
	// contains filtered or unexported fields
}

type CosmosEndpointResponseValidationResult struct {

	// The type of response expected.
	// Examples: JSONRPC, JSON, integer, etc.
	ResponseValidationType CosmosResponseValidationType `` /* 173-byte string literal not displayed */
	// HTTP status code returned to the user.
	// It is derived from the endpoint response payload and/or HTTP status code.
	// e.g. for JSONRPC, it is based on the error code of the JSONRPC response.
	HttpStatusCode int32 `protobuf:"varint,2,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// Validation error, if any.
	// This is set if parsing the endpoint response fails.
	ValidationError *CosmosResponseValidationError `` /* 157-byte string literal not displayed */
	// TODO_TECHDEBT(@adshmh): Replace the parsed_response and user_response with request-type-specific messages, i.e. separate message type for:
	// - single JSONRPC requests
	// - RESTful API requests
	//
	// Tracks the JSONRPC response returned to the user
	// Only set for JSONRPC requests.
	UserJsonrpcResponse *JsonRpcResponse `` /* 127-byte string literal not displayed */
	// The parsed response; JSON, JSONRPC, REST, unstructured, etc..
	// Only set if validation succeeded.
	//
	// Types that are valid to be assigned to ParsedResponse:
	//
	//	*CosmosEndpointResponseValidationResult_ResponseJsonrpc
	//	*CosmosEndpointResponseValidationResult_ResponseUnrecognized
	//	*CosmosEndpointResponseValidationResult_ResponseCometBftHealth
	//	*CosmosEndpointResponseValidationResult_ResponseCometBftStatus
	//	*CosmosEndpointResponseValidationResult_ResponseCosmosSdkStatus
	//	*CosmosEndpointResponseValidationResult_ResponseEvmJsonrpcChainId
	ParsedResponse isCosmosEndpointResponseValidationResult_ParsedResponse `protobuf_oneof:"parsed_response"`
	// contains filtered or unexported fields
}

type CosmosEndpointResponseValidationResult_ResponseCometBftHealth struct {
	// Response to CometBFT request using method `health`
	// Reference: https://docs.cometbft.com/v1.0/spec/rpc/#health
	ResponseCometBftHealth *CosmosResponseCometBFTHealth `protobuf:"bytes,8,opt,name=response_comet_bft_health,json=responseCometBftHealth,proto3,oneof"`
}

type CosmosEndpointResponseValidationResult_ResponseCometBftStatus struct {
	// Response to CometBFT request using method `status`
	// Reference: https://docs.cometbft.com/v1.0/spec/rpc/#status
	ResponseCometBftStatus *CosmosResponseCometBFTStatus `protobuf:"bytes,9,opt,name=response_comet_bft_status,json=responseCometBftStatus,proto3,oneof"`
}

type CosmosEndpointResponseValidationResult_ResponseCosmosSdkStatus struct {
	// Response to CosmosSDK request against API path `/cosmos/base/node/v1beta1/status`
	// Reference: https://docs.cosmos.network/api#tag/Service/operation/Status
	ResponseCosmosSdkStatus *CosmosResponseCosmosSDKStatus `protobuf:"bytes,10,opt,name=response_cosmos_sdk_status,json=responseCosmosSdkStatus,proto3,oneof"`
}

type CosmosEndpointResponseValidationResult_ResponseEvmJsonrpcChainId struct {
	// Response to Ethereum JSONRPC request using method `eth_chainId`
	// Reference: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_chainid
	ResponseEvmJsonrpcChainId *CosmosResponseEVMJSONRPCChainID `protobuf:"bytes,11,opt,name=response_evm_jsonrpc_chain_id,json=responseEvmJsonrpcChainId,proto3,oneof"`
}

type CosmosEndpointResponseValidationResult_ResponseJsonrpc struct {
	// JSONRPC response
	ResponseJsonrpc *JsonRpcResponse `protobuf:"bytes,4,opt,name=response_jsonrpc,json=responseJsonrpc,proto3,oneof"`
}

type CosmosEndpointResponseValidationResult_ResponseUnrecognized struct {
	// For unrecognized responses.
	// These are returned as-is to the user.
	ResponseUnrecognized *UnrecognizedResponse `protobuf:"bytes,7,opt,name=response_unrecognized,json=responseUnrecognized,proto3,oneof"`
}

type CosmosRequestObservations struct {

	// cosmos_chain_id is the blockchain identifier in the Cosmos ecosystem.
	CosmosChainId string `protobuf:"bytes,8,opt,name=cosmos_chain_id,json=cosmosChainId,proto3" json:"cosmos_chain_id,omitempty"`
	// evm_chain_id is the EVM blockchain identifier for the Cosmos chain that has native EVM support, e.g. XRPLEVM, etc...
	EvmChainId string `protobuf:"bytes,7,opt,name=evm_chain_id,json=evmChainId,proto3" json:"evm_chain_id,omitempty"`
	// service_id is the Pocket Network service identifier.
	ServiceId string `protobuf:"bytes,2,opt,name=service_id,json=serviceId,proto3" json:"service_id,omitempty"`
	// The origin of the request
	RequestOrigin RequestOrigin `` /* 129-byte string literal not displayed */
	// Profiles of the requests: backend service selection and format determination
	// This field supports batch requests where multiple request profiles can be processed
	RequestProfiles []*CosmosRequestProfile `protobuf:"bytes,9,rep,name=request_profiles,json=requestProfiles,proto3" json:"request_profiles,omitempty"`
	// Request-level error, i.e. failed without any endpoint responses.
	// Examples:
	//   - Failed to parse request
	//   - No endpoint response received, i.e. any protocol-level error.
	RequestLevelError *RequestError `protobuf:"bytes,5,opt,name=request_level_error,json=requestLevelError,proto3,oneof" json:"request_level_error,omitempty"`
	// Cosmos-specific observations from endpoint(s) that responded to the service request.
	EndpointObservations []*CosmosEndpointObservation `protobuf:"bytes,6,rep,name=endpoint_observations,json=endpointObservations,proto3" json:"endpoint_observations,omitempty"`
	// contains filtered or unexported fields
}

type CosmosRequestProfile struct {

	// Backend service configuration and selection details
	BackendServiceDetails *BackendServiceDetails `` /* 126-byte string literal not displayed */
	// Parsed request payload by format type
	//
	// Types that are valid to be assigned to ParsedRequest:
	//
	//	*CosmosRequestProfile_RestRequest
	//	*CosmosRequestProfile_JsonrpcRequest
	ParsedRequest isCosmosRequestProfile_ParsedRequest `protobuf_oneof:"parsed_request"`
	// contains filtered or unexported fields
}

type CosmosRequestProfile_JsonrpcRequest struct {
	JsonrpcRequest *JsonRpcRequest `protobuf:"bytes,3,opt,name=jsonrpc_request,json=jsonrpcRequest,proto3,oneof"`
}

type CosmosRequestProfile_RestRequest struct {
	RestRequest *RESTRequest `protobuf:"bytes,2,opt,name=rest_request,json=restRequest,proto3,oneof"`
}

type CosmosResponseCometBFTHealth struct {
	HealthStatus bool `protobuf:"varint,1,opt,name=health_status,json=healthStatus,proto3" json:"health_status,omitempty"`
	// contains filtered or unexported fields
}

type CosmosResponseCometBFTStatus struct {
	ChainId           string `protobuf:"bytes,1,opt,name=chain_id,json=chainId,proto3" json:"chain_id,omitempty"`
	CatchingUp        bool   `protobuf:"varint,2,opt,name=catching_up,json=catchingUp,proto3" json:"catching_up,omitempty"`
	LatestBlockHeight string `protobuf:"bytes,3,opt,name=latest_block_height,json=latestBlockHeight,proto3" json:"latest_block_height,omitempty"`
	// contains filtered or unexported fields
}

type CosmosResponseCosmosSDKStatus struct {
	LatestBlockHeight uint64 `protobuf:"varint,1,opt,name=latest_block_height,json=latestBlockHeight,proto3" json:"latest_block_height,omitempty"`
	// contains filtered or unexported fields
}

type CosmosResponseEVMJSONRPCChainID struct {

	// The HTTP status code received from the endpoint
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The chain ID value returned in the response
	EvmChainId string `protobuf:"bytes,2,opt,name=evm_chain_id,json=evmChainId,proto3" json:"evm_chain_id,omitempty"`
	// contains filtered or unexported fields
}

type CosmosResponseValidationError int32

type CosmosResponseValidationType int32

type CosmosSDKObservationInterpreter struct {
	// Logger for reporting issues during interpretation
	Logger polylog.Logger

	// Observations contains the raw CosmosSDK request data
	Observations *CosmosRequestObservations
}

type EVMBlockNumberResponse struct {

	// The HTTP status code received from the endpoint
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The block number value returned in the response
	BlockNumberResponse string `protobuf:"bytes,2,opt,name=block_number_response,json=blockNumberResponse,proto3" json:"block_number_response,omitempty"`
	// Why the response failed QoS validation
	// If not set, the response is considered valid
	ResponseValidationError *EVMResponseValidationError `` /* 180-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMChainIDResponse struct {

	// The HTTP status code received from the endpoint
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The chain ID value returned in the response
	ChainIdResponse string `protobuf:"bytes,2,opt,name=chain_id_response,json=chainIdResponse,proto3" json:"chain_id_response,omitempty"`
	// Why the response failed QoS validation
	// If not set, the response is considered valid
	ResponseValidationError *EVMResponseValidationError `` /* 180-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMEmptyResponse struct {

	// The HTTP status code represents the status code sent to the client when the chosen endpoint returns an empty response.
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// Always set to EMPTY for empty responses
	ResponseValidationError EVMResponseValidationError `` /* 174-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMEndpointObservation struct {

	// Address of the endpoint handling the request (e.g., onchain address of a Pocket Shannon node)
	EndpointAddr string `protobuf:"bytes,1,opt,name=endpoint_addr,json=endpointAddr,proto3" json:"endpoint_addr,omitempty"`
	// Details of the response received from the endpoint
	//
	// Types that are valid to be assigned to ResponseObservation:
	//
	//	*EVMEndpointObservation_ChainIdResponse
	//	*EVMEndpointObservation_BlockNumberResponse
	//	*EVMEndpointObservation_GetBalanceResponse
	//	*EVMEndpointObservation_UnrecognizedResponse
	//	*EVMEndpointObservation_EmptyResponse
	//	*EVMEndpointObservation_NoResponse
	ResponseObservation isEVMEndpointObservation_ResponseObservation `protobuf_oneof:"response_observation"`
	// Only set if the endpoint returned a valid JSONRPC response.
	ParsedJsonrpcResponse *JsonRpcResponse `` /* 132-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMEndpointObservation_BlockNumberResponse struct {
	// Response to `eth_blockNumber` request
	// References:
	// * https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_blocknumber
	// * Chain IDs: https://chainlist.org
	BlockNumberResponse *EVMBlockNumberResponse `protobuf:"bytes,3,opt,name=block_number_response,json=blockNumberResponse,proto3,oneof"`
}

type EVMEndpointObservation_ChainIdResponse struct {
	// Response to `eth_chainId` request
	// Reference: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_chainid
	ChainIdResponse *EVMChainIDResponse `protobuf:"bytes,2,opt,name=chain_id_response,json=chainIdResponse,proto3,oneof"`
}

type EVMEndpointObservation_EmptyResponse struct {
	// EVMEmptyResponse indicates an endpoint returned no data.
	// Used to:
	//   - Disqualify endpoints that return empty responses
	//   - Track metrics for empty response patterns
	EmptyResponse *EVMEmptyResponse `protobuf:"bytes,6,opt,name=empty_response,json=emptyResponse,proto3,oneof"`
}

type EVMEndpointObservation_GetBalanceResponse struct {
	// Response to `eth_getBalance` request, which may be used to update archival state.
	// See the EVMGetBalanceResponse message for more details.
	// References:
	// * https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance
	GetBalanceResponse *EVMGetBalanceResponse `protobuf:"bytes,4,opt,name=get_balance_response,json=getBalanceResponse,proto3,oneof"`
}

type EVMEndpointObservation_NoResponse struct {
	// EVMNoResponse indicates no response was received from any endpoint.
	// This differs from EVMEmptyResponse as no response was reported by the protocol.
	NoResponse *EVMNoResponse `protobuf:"bytes,7,opt,name=no_response,json=noResponse,proto3,oneof"`
}

type EVMEndpointObservation_UnrecognizedResponse struct {
	// Responses not used in endpoint validation (e.g., JSONRPC ID field from `eth_call`)
	UnrecognizedResponse *EVMUnrecognizedResponse `protobuf:"bytes,5,opt,name=unrecognized_response,json=unrecognizedResponse,proto3,oneof"`
}

type EVMGetBalanceResponse struct {

	// The HTTP status code received from the endpoint
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The contract address for which the the balance is checked.
	ContractAddress string `protobuf:"bytes,2,opt,name=contract_address,json=contractAddress,proto3" json:"contract_address,omitempty"`
	// The block number at which the balance is checked.
	BlockNumber string `protobuf:"bytes,3,opt,name=block_number,json=blockNumber,proto3" json:"block_number,omitempty"`
	// The balance value at the block number for the address provided.
	Balance string `protobuf:"bytes,4,opt,name=balance,proto3" json:"balance,omitempty"`
	// Why the response failed QoS validation
	// If not set, the response is considered valid
	ResponseValidationError *EVMResponseValidationError `` /* 180-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMHTTPBodyReadFailure struct {

	// The HTTP status code to return to the client - typically 500 Internal Server Error
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The specific type of request validation error
	ValidationError EVMRequestValidationError `` /* 147-byte string literal not displayed */
	// Additional error details if available
	ErrorDetails *string `protobuf:"bytes,3,opt,name=error_details,json=errorDetails,proto3,oneof" json:"error_details,omitempty"`
	// contains filtered or unexported fields
}

type EVMNoResponse struct {

	// The HTTP status code to return, typically 503 Service Unavailable
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// Always set to NO_RESPONSE for this scenario
	ResponseValidationError EVMResponseValidationError `` /* 174-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EVMObservationInterpreter struct {
	Logger polylog.Logger

	// TODO_TECHDEBT(@adshmh): Missing a logger
	Observations *EVMRequestObservations
}

type EVMRequestError struct {
	// contains filtered or unexported fields
}

type EVMRequestObservation struct {

	// The EVM blockchain service's JSON-RPC request.
	// This field will be populated only if request validation succeeds.
	// If there is an error reading the HTTP request, there will be no jsonrpc_request.
	// TODO_TECHDEBT: Assumes EVM chains only support JSON-RPC. May need refactoring to support other protocols.
	JsonrpcRequest *JsonRpcRequest `protobuf:"bytes,5,opt,name=jsonrpc_request,json=jsonrpcRequest,proto3" json:"jsonrpc_request,omitempty"`
	// EVM-specific observations from endpoint(s) that responded to the service request.
	// Multiple observations may occur when:
	// * Original endpoint fails
	// * Request is sent to additional endpoints for data collection
	// This field will only be populated if request validation succeeds.
	EndpointObservations []*EVMEndpointObservation `protobuf:"bytes,6,rep,name=endpoint_observations,json=endpointObservations,proto3" json:"endpoint_observations,omitempty"`
	// contains filtered or unexported fields
}

type EVMRequestObservations struct {

	// chain_id is the blockchain identifier for the evm QoS implementation.
	// This is preset by the processor and not determined by the request.
	// Expected as the `Result` field in eth_chainId responses.
	ChainId string `protobuf:"bytes,1,opt,name=chain_id,json=chainId,proto3" json:"chain_id,omitempty"`
	// service_id is the identifier for the evm QoS implementation.
	// It is the "alias" or human readable interpratation of the chain_id.
	ServiceId string `protobuf:"bytes,7,opt,name=service_id,json=serviceId,proto3" json:"service_id,omitempty"`
	// The origin of the request:
	// - Organic: real (i.e. user) requests
	// - Synthetic: requests built by QoS module for collecting data on endpoints (a.k.a hydrator)
	RequestOrigin RequestOrigin `` /* 129-byte string literal not displayed */
	// The length of the client's request payload, in bytes.
	RequestPayloadLength uint32 `protobuf:"varint,2,opt,name=request_payload_length,json=requestPayloadLength,proto3" json:"request_payload_length,omitempty"`
	// If this oneof IS SET, then one of the following validation failures happened:
	//   - Indicates the request failed validation
	//   - Contains details about the specific failure type
	//   - The HTTP status code in the selected failure type overrides any status codes from
	//     endpoint observations and should be returned to the client
	//
	// If this oneof IS NOT SET, then one of the following occurred:
	//   - The request passed validation
	//   - The HTTP status code from the most recent endpoint observation should be used instead
	//
	// Types that are valid to be assigned to RequestValidationFailure:
	//
	//	*EVMRequestObservations_EvmHttpBodyReadFailure
	//	*EVMRequestObservations_EvmRequestUnmarshalingFailure
	RequestValidationFailure isEVMRequestObservations_RequestValidationFailure `protobuf_oneof:"request_validation_failure"`
	// Each request may have multiple observations to support batch requests.
	RequestObservations []*EVMRequestObservation `protobuf:"bytes,10,rep,name=request_observations,json=requestObservations,proto3" json:"request_observations,omitempty"`
	// endpoint_selection_metadata contains metadata about the endpoint selection process.
	EndpointSelectionMetadata *EndpointSelectionMetadata `` /* 138-byte string literal not displayed */
	// Internal error encountered processing the request, if any.
	// Example: no endpoint responses received.
	// On single JSONRPC request: applies to the single request.
	// On batch JSONRPC requests: only set if the entire batch failed (e.g. no endpoint responses for any of the requests of the batch)
	RequestError *RequestError `protobuf:"bytes,11,opt,name=request_error,json=requestError,proto3,oneof" json:"request_error,omitempty"`
	// contains filtered or unexported fields
}

type EVMRequestObservations_EvmHttpBodyReadFailure struct {
	// Indicates a failure to read the HTTP request body
	EvmHttpBodyReadFailure *EVMHTTPBodyReadFailure `protobuf:"bytes,3,opt,name=evm_http_body_read_failure,json=evmHttpBodyReadFailure,proto3,oneof"`
}

type EVMRequestObservations_EvmRequestUnmarshalingFailure struct {
	// Indicates a failure to unmarshal/parse the request
	EvmRequestUnmarshalingFailure *EVMRequestUnmarshalingFailure `protobuf:"bytes,4,opt,name=evm_request_unmarshaling_failure,json=evmRequestUnmarshalingFailure,proto3,oneof"`
}

type EVMRequestUnmarshalingFailure struct {

	// The HTTP status code to return to the client - typically 400 Bad Request
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The specific type of request validation error
	ValidationError EVMRequestValidationError `` /* 147-byte string literal not displayed */
	// Additional error details if available
	ErrorDetails *string `protobuf:"bytes,3,opt,name=error_details,json=errorDetails,proto3,oneof" json:"error_details,omitempty"`
	// contains filtered or unexported fields
}

type EVMRequestValidationError int32

type EVMResponseValidationError int32

type EVMUnrecognizedResponse struct {

	// The HTTP status code received from the endpoint
	HttpStatusCode int32 `protobuf:"varint,1,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// The JSON-RPC response received
	JsonrpcResponse *JsonRpcResponse `protobuf:"bytes,2,opt,name=jsonrpc_response,json=jsonrpcResponse,proto3" json:"jsonrpc_response,omitempty"`
	// Why the response failed QoS validation
	// If not set, the response is considered valid
	ResponseValidationError *EVMResponseValidationError `` /* 180-byte string literal not displayed */
	// contains filtered or unexported fields
}

type EndpointSelectionMetadata struct {

	// random_endpoint_fallback indicates random endpoint selection was used
	// when all available endpoints failed QoS validation.
	RandomEndpointFallback bool `` /* 130-byte string literal not displayed */
	// validation_results contains detailed information about each endpoint
	// validation attempt during the selection process (both successful and failed).
	//
	// Derived counts can be calculated from this field:
	// - available_endpoints_count = len(validation_results)
	// - valid_endpoints_count = count(validation_results where success = true)
	ValidationResults []*EndpointValidationResult `protobuf:"bytes,2,rep,name=validation_results,json=validationResults,proto3" json:"validation_results,omitempty"`
	// contains filtered or unexported fields
}

type EndpointValidationFailureReason int32

type EndpointValidationResult struct {

	// The endpoint address that was validated
	EndpointAddr string `protobuf:"bytes,1,opt,name=endpoint_addr,json=endpointAddr,proto3" json:"endpoint_addr,omitempty"`
	// Whether the validation was successful
	Success bool `protobuf:"varint,2,opt,name=success,proto3" json:"success,omitempty"`
	// The specific reason why validation failed (only set when success = false)
	FailureReason *EndpointValidationFailureReason `` /* 153-byte string literal not displayed */
	// Optional additional details about the failure (only set when success = false)
	FailureDetails *string `protobuf:"bytes,4,opt,name=failure_details,json=failureDetails,proto3,oneof" json:"failure_details,omitempty"`
	// contains filtered or unexported fields
}

type JsonRpcRequest struct {

	// Client-established identifier. Must be a String, Number, or NULL if present.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// Name of the JSON-RPC method being called (e.g., eth_chainId for EVM chains)
	Method string `protobuf:"bytes,2,opt,name=method,proto3" json:"method,omitempty"`
	// contains filtered or unexported fields
}

type JsonRpcResponse struct {

	// Must match the id value from the corresponding request
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// A preview of the JSONRPC response's `result` field.
	// It may have been truncated to reduce message size.
	ResultPreview string `protobuf:"bytes,2,opt,name=result_preview,json=resultPreview,proto3" json:"result_preview,omitempty"`
	// Error details, if the request failed
	Error *JsonRpcResponseError `protobuf:"bytes,3,opt,name=error,proto3,oneof" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type JsonRpcResponseError struct {

	// Error code indicating the type of failure
	Code int64 `protobuf:"varint,1,opt,name=code,proto3" json:"code,omitempty"`
	// Human-readable error description
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

type JsonRpcResponseValidationError struct {

	// Type of validation error
	ErrorType JsonRpcValidationErrorType `` /* 130-byte string literal not displayed */
	// Timestamp when the validation error occurred
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,2,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// contains filtered or unexported fields
}

type JsonRpcValidationErrorType int32

type Observations struct {

	// service_observations contains QoS measurements specific to the service type
	//
	// Types that are valid to be assigned to ServiceObservations:
	//
	//	*Observations_Solana
	//	*Observations_Evm
	//	*Observations_Cosmos
	ServiceObservations isObservations_ServiceObservations `protobuf_oneof:"service_observations"`
	// contains filtered or unexported fields
}

type Observations_Cosmos struct {
	// cosmos contains QoS measurements for a single CosmosSDK blockchain request
	Cosmos *CosmosRequestObservations `protobuf:"bytes,3,opt,name=cosmos,proto3,oneof"`
}

type Observations_Evm struct {
	// evm contains QoS measurements for a single EVM blockchain request
	Evm *EVMRequestObservations `protobuf:"bytes,2,opt,name=evm,proto3,oneof"`
}

type Observations_Solana struct {
	// solana contains QoS measurements for a single Solana blockchain request
	Solana *SolanaRequestObservations `protobuf:"bytes,1,opt,name=solana,proto3,oneof"`
}

type RESTRequest struct {

	// API path that was called (e.g. "/", "/health", "/status")
	ApiPath string `protobuf:"bytes,1,opt,name=api_path,json=apiPath,proto3" json:"api_path,omitempty"`
	// HTTP method used (GET, POST, etc.)
	HttpMethod string `protobuf:"bytes,2,opt,name=http_method,json=httpMethod,proto3" json:"http_method,omitempty"`
	// Tracks the value of HTTP request's Content-Type header.
	ContentType string `protobuf:"bytes,3,opt,name=content_type,json=contentType,proto3" json:"content_type,omitempty"`
	// Length of request payload: could be 0, e.g. for GET requests.
	PayloadLength uint32 `protobuf:"varint,4,opt,name=payload_length,json=payloadLength,proto3" json:"payload_length,omitempty"`
	// contains filtered or unexported fields
}

type RequestError struct {

	// Tracks the kind of error: e.g. internal.
	ErrorKind RequestErrorKind `protobuf:"varint,1,opt,name=error_kind,json=errorKind,proto3,enum=path.qos.RequestErrorKind" json:"error_kind,omitempty"`
	// Tracks details of the error.
	ErrorDetails string `protobuf:"bytes,2,opt,name=error_details,json=errorDetails,proto3" json:"error_details,omitempty"`
	// TODO_MVP(@adshm): drop this in favor of JUDGE's solution:
	// store the JSONRPC Response's details (specifically the `code` field).
	// The HTTP status can be derived from the JSONRPC response.
	HttpStatusCode int32 `protobuf:"varint,3,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// contains filtered or unexported fields
}

type RequestErrorKind int32

type RequestOrigin int32

type SolanaEndpointObservation struct {

	// Address of the endpoint handling the request
	EndpointAddr string `protobuf:"bytes,1,opt,name=endpoint_addr,json=endpointAddr,proto3" json:"endpoint_addr,omitempty"`
	// HTTP status code returned to the user.
	// It is derived from either:
	//   - The endpoint payload parsed as a JSONRPC response.
	//   - A generic JSONRPC error response if the endpoint payload fails to parse.
	HttpStatusCode int32 `protobuf:"varint,2,opt,name=http_status_code,json=httpStatusCode,proto3" json:"http_status_code,omitempty"`
	// Types that are valid to be assigned to ResponseObservation:
	//
	//	*SolanaEndpointObservation_GetEpochInfoResponse
	//	*SolanaEndpointObservation_GetHealthResponse
	//	*SolanaEndpointObservation_UnrecognizedResponse
	ResponseObservation isSolanaEndpointObservation_ResponseObservation `protobuf_oneof:"response_observation"`
	// contains filtered or unexported fields
}

type SolanaEndpointObservation_GetEpochInfoResponse struct {
	// Response from getEpochInfo
	// Docs: https://solana.com/docs/rpc/http/getepochinfo
	GetEpochInfoResponse *SolanaGetEpochInfoResponse `protobuf:"bytes,3,opt,name=get_epoch_info_response,json=getEpochInfoResponse,proto3,oneof"`
}

type SolanaEndpointObservation_GetHealthResponse struct {
	// Response from getHealth
	// Docs: https://solana.com/docs/rpc/http/gethealth
	GetHealthResponse *SolanaGetHealthResponse `protobuf:"bytes,4,opt,name=get_health_response,json=getHealthResponse,proto3,oneof"`
}

type SolanaEndpointObservation_UnrecognizedResponse struct {
	// Responses not used in endpoint validation (e.g., getAccountInfo)
	UnrecognizedResponse *SolanaUnrecognizedResponse `protobuf:"bytes,5,opt,name=unrecognized_response,json=unrecognizedResponse,proto3,oneof"`
}

type SolanaGetEpochInfoResponse struct {

	// Stored as uint64 for cross-instance validation
	BlockHeight uint64 `protobuf:"varint,1,opt,name=block_height,json=blockHeight,proto3" json:"block_height,omitempty"`
	Epoch       uint64 `protobuf:"varint,2,opt,name=epoch,proto3" json:"epoch,omitempty"`
	// contains filtered or unexported fields
}

type SolanaGetHealthResponse struct {
	Result string `protobuf:"bytes,1,opt,name=result,proto3" json:"result,omitempty"`
	// contains filtered or unexported fields
}

type SolanaObservationInterpreter struct {
	// Logger for reporting issues during interpretation
	Logger polylog.Logger

	// Observations contains the raw Solana request data
	Observations *SolanaRequestObservations
}

type SolanaRequestObservations struct {

	// chain_id is the blockchain identifier for the QoS implementation.
	// This is preset by the processor and not determined by the request.
	// Used by metrics and data pipeline.
	ChainId string `protobuf:"bytes,1,opt,name=chain_id,json=chainId,proto3" json:"chain_id,omitempty"`
	// service_id is the identifier for the QoS implementation.
	// It is the "alias" or human readable interpratation of the chain_id.
	ServiceId string `protobuf:"bytes,2,opt,name=service_id,json=serviceId,proto3" json:"service_id,omitempty"`
	// The length of the client's request payload, in bytes.
	RequestPayloadLength uint32 `protobuf:"varint,3,opt,name=request_payload_length,json=requestPayloadLength,proto3" json:"request_payload_length,omitempty"`
	// The origin of the request: user vs. QoS service (requests built by QoS for collecting data on endpoints)
	RequestOrigin RequestOrigin `` /* 129-byte string literal not displayed */
	// Tracks request errors, if any.
	RequestError *RequestError `protobuf:"bytes,5,opt,name=request_error,json=requestError,proto3,oneof" json:"request_error,omitempty"`
	// JSON-RPC request to the Solana blockchain service.
	// Only set if the HTTP request payload was successfully parsed into JSONRPC.
	// TODO_TECHDEBT: This assumes all SolanaVM blockchains only (and always) support JSON-RPC.
	// May need expansion/refactoring for future blockchain support.
	JsonrpcRequest *JsonRpcRequest `protobuf:"bytes,6,opt,name=jsonrpc_request,json=jsonrpcRequest,proto3,oneof" json:"jsonrpc_request,omitempty"`
	// Multiple observations possible if:
	// - Original endpoint returns invalid response
	// - Retry mechanism activates
	EndpointObservations []*SolanaEndpointObservation `protobuf:"bytes,7,rep,name=endpoint_observations,json=endpointObservations,proto3" json:"endpoint_observations,omitempty"`
	// contains filtered or unexported fields
}

type SolanaUnrecognizedResponse struct {
	JsonrpcResponse *JsonRpcResponse `protobuf:"bytes,1,opt,name=jsonrpc_response,json=jsonrpcResponse,proto3" json:"jsonrpc_response,omitempty"`
	// Optional validation error information
	ValidationError *JsonRpcResponseValidationError `protobuf:"bytes,2,opt,name=validation_error,json=validationError,proto3,oneof" json:"validation_error,omitempty"`
	// contains filtered or unexported fields
}

type UnrecognizedResponse struct {

	// Length of payload received from the endpoint.
	EndpointPayloadLength uint32 `` /* 127-byte string literal not displayed */
	// contains filtered or unexported fields
}