errors

Documentation

Index

• Constants
• func Errorf(msg ErrorID, inserts ...interface{}) error
• func RestErrReply(res http.ResponseWriter, req *http.Request, err error, status int)
• type Error
  • func (e Error) Error() string
• type ErrorID
• type RestErrMsg

Constants

const (
	// ConfigFileReadFailed failed to read the server config file
	ConfigFileReadFailed = "Failed to read %s: %s"
	// ConfigNoYAML missing configuration file on server start
	ConfigFileMissing = "No configuration filename specified"
	// ConfigYAMLParseFile failed to parse YAML during server startup
	ConfigYAMLParseFile = "Unable to parse %s as YAML: %s"
	// ConfigYAMLPostParseFile failed to process YAML as JSON after parsing
	ConfigYAMLPostParseFile = "Failed to process YAML config from %s: %s"
	// ConfigRESTGatewayRequiredHTTPPort for rest server listening port missing
	ConfigRESTGatewayRequiredHTTPPort = "Must provide REST Gateway http listening port"
	// ConfigRESTGatewayRequiredRPCPath for rest server's Fabric client config file missing
	ConfigRESTGatewayRequiredRPCPath = "Must provide REST Gateway client configuration path"
	// ConfigRESTGatewayRequiredReceiptStore need to enable params for REST Gatewya
	ConfigRESTGatewayRequiredReceiptStore = "MongoDB URL, Database and Collection name must be specified to enable the receipt store"
	// ConfigTLSCertOrKey incomplete TLS config
	ConfigTLSCertOrKey = "Client private key and certificate must both be provided for mutual auth"

	// SecurityModulePluginLoad failed to load .so
	SecurityModulePluginLoad = "Failed to load plugin: %s"
	// SecurityModulePluginSymbol missing symbol in plugin
	SecurityModulePluginSymbol = "Failed to load 'SecurityModule' symbol from '%s': %s"
	// SecurityModuleNoAuthContext missing auth context in context object at point security module is invoked
	SecurityModuleNoAuthContext = "No auth context"

	// RequestHandlerInvalidMsgTypeMissing need to specify a msg type in the header
	RequestHandlerInvalidMsgTypeMissing = "Invalid message - missing 'headers.type' (or not a string)"
	// RequestHandlerInvalidMsgSignerMissing need to specify a msg signer in the header
	RequestHandlerInvalidMsgSignerMissing = "Invalid message - missing 'signer' (or not a string)"
	// RequestHandlerInvalidMsgType need to specify a valid msg type in the header
	RequestHandlerInvalidMsgType = "Invalid message type: \"%s\""

	// RequestHandlerDirectTooManyInflight when we're not using a buffered store (Kafka) we have to reject
	RequestHandlerDirectTooManyInflight = "Too many in-flight transactions"
	// RequestHandlerDirectBadHeaders problem processing for in-memory operation
	RequestHandlerDirectBadHeaders = "Failed to process headers in message"

	// TransactionSendMsgTypeUnknown we got a JSON message into the core processor (from Kafka, direct handler etc.) that we don't understand
	TransactionSendMsgTypeUnknown = "Unknown message type '%s'"

	// TransactionSendReceiptCheckError we continually had bad RCs back from the node while trying to check for the receipt up to the timeout
	TransactionSendReceiptCheckError = "Error obtaining transaction receipt (%d retries): %s"
	// TransactionSendReceiptCheckTimeout we didn't have a problem asking the node for a receipt, but the transaction wasn't mined at the end of the timeout
	TransactionSendReceiptCheckTimeout = "Timed out waiting for transaction receipt"

	// RPCCallReturnedError specified RPC call returned error
	RPCCallReturnedError = "%s returned: %s"
	// RPCConnectFailed error connecting to back-end server over JSON/RPC
	RPCConnectFailed = "JSON/RPC connection to %s failed: %s"

	// RESTGatewayMissingFromAddress did not supply a signing address for the transaction
	RESTGatewayMissingSigner = "Please specify a valid signer ID in the '%[1]s-signer' query string parameter or x-%[2]s-signer HTTP header"
	// RESTGatewaySyncMsgTypeMismatch sync-invoke code paths in REST API Gateway should be maintained such that this cannot happen
	RESTGatewaySyncMsgTypeMismatch = "Unexpected condition (message types do not match when processing)"
	// RESTGatewaySyncWrapErrorWithTXDetail wraps a low level error with transaction hash context on sync APIs before returning
	RESTGatewaySyncWrapErrorWithTXDetail = "TX %s: %s"
	// RESTGatewayEventManagerInitFailed constructor failure for event manager
	RESTGatewayEventManagerInitFailed = "Event-stream subscription manager failed to initialize: %s"
	// RESTGatewayEventStreamInvalid attempt to create an event stream with invalid parameters
	RESTGatewayEventStreamInvalid = "Invalid event stream specification: %s"
	// RESTGatewaySubscriptionInvalid attempt to create an event stream with invalid parameters
	RESTGatewaySubscriptionInvalid = "Invalid event subscription specification: %s"

	// ConfigKafkaMissingOutputTopic response topic missing
	ConfigKafkaMissingOutputTopic = "No output topic specified for bridge to send events to"
	// ConfigKafkaMissingInputTopic request topic missing
	ConfigKafkaMissingInputTopic = "No input topic specified for bridge to listen to"
	// ConfigKafkaMissingConsumerGroup consumer group missing
	ConfigKafkaMissingConsumerGroup = "No consumer group specified"
	// ConfigKafkaMissingBadSASL problem with SASL config
	ConfigKafkaMissingBadSASL = "Username and Password must both be provided for SASL"
	// ConfigKafkaMissingBrokers missing/empty brokers
	ConfigKafkaMissingBrokers = "No Kafka brokers configured"
	// WebhooksKafkaUnexpectedErrFmt problem processing an error that came back from Kafka, so do a deep dump
	WebhooksKafkaUnexpectedErrFmt = "Error did not contain message and metadata: %+v"
	// WebhooksKafkaDeliveryReportNoMeta delivery reports should contain the metadata we set when we sent
	WebhooksKafkaDeliveryReportNoMeta = "Sent message did not contain metadata: %+v"
	// WebhooksKafkaYAMLtoJSON re-serialization of webhook message into JSON failed
	WebhooksKafkaMsgtoJSON = "Unable to reserialize message payload as JSON: %s"
	// WebhooksKafkaErr wrapper on detailed error from Kafka itself
	WebhooksKafkaErr = "Failed to deliver message to Kafka: %s"

	// HelperPayloadTooLarge input message too large
	HelperPayloadTooLarge = "Message exceeds maximum allowable size"
	// HelperYAMLorJSONPayloadReadFailed failed to read input
	HelperPayloadReadFailed = "Unable to read input data: %s"
	// HelperYAMLorJSONPayloadParseFailed input message got error parsing
	HelperPayloadParseFailed = "Unable to parse as JSON: %s"

	// ReceiptStoreDisabled not configured
	ReceiptStoreDisabled = "Receipt store not enabled"
	// ReceiptStoreSerializeResponse problem sending a receipt stored back over the REST API
	ReceiptStoreSerializeResponse = "Error serializing response"
	// ReceiptStoreInvalidRequestID bad ID query
	ReceiptStoreInvalidRequestID = "Invalid 'id' query parameter"
	// ReceiptStoreInvalidRequestMaxLimit bad limit over max
	ReceiptStoreInvalidRequestMaxLimit = "Maximum limit is %d"
	// ReceiptStoreInvalidRequestBadLimit bad limit
	ReceiptStoreInvalidRequestBadLimit = "Invalid 'limit' query parameter"
	// ReceiptStoreInvalidRequestBadSkip bad skip
	ReceiptStoreInvalidRequestBadSkip = "Invalid 'skip' query parameter"
	// ReceiptStoreInvalidRequestBadSince bad since
	ReceiptStoreInvalidRequestBadSince = "since cannot be parsed as RFC3339 or millisecond timestamp"
	// ReceiptStoreFailedQuery wrapper over detailed error
	ReceiptStoreFailedQuery = "Error querying replies: %s"
	// ReceiptStoreFailedQuerySingle wrapper over detailed error
	ReceiptStoreFailedQuerySingle = "Error querying reply: %s"
	// ReceiptStoreFailedNotFound receipt isn't in the store
	ReceiptStoreFailedNotFound = "Receipt not available"
	// ReceiptStoreMongoDBConnect couldn't connect to MongoDB
	ReceiptStoreMongoDBConnect = "Unable to connect to MongoDB: %s"
	// ReceiptStoreMongoDBIndex couldn't create MongoDB index
	ReceiptStoreMongoDBIndex = "Unable to create index: %s"
	// ReceiptStoreLevelDBConnect couldn't open file for the level DB
	ReceiptStoreLevelDBConnect = "Unable to open LevelDB: %s"

	// LevelDBFailedRetriveOriginalKey problem retrieving entry - original key
	LevelDBFailedRetriveOriginalKey = "Failed to retrieve the entry for the original key: %s. %s"
	// LevelDBFailedRetriveGeneratedID problem retrieving entry - generated ID
	LevelDBFailedRetriveGeneratedID = "failed to retrieve the entry for the generated ID: %s. %s"

	// KVStoreDBLoad failed to init DB
	KVStoreDBLoad = "Failed to open DB at %s: %s"
	// KVStoreMemFilteringUnsupported memory db is really just for testing. No filtering support
	KVStoreMemFilteringUnsupported = "Memory receipts do not support filtering"

	// Unauthorized (401 error)
	Unauthorized = "Unauthorized"

	// EventStreamsDBLoad failed to init DB
	EventStreamsDBLoad = "Failed to open DB at %s: %s"
	// EventStreamsInvalidActionType unknown action type
	EventStreamsInvalidActionType = "Unknown action type '%s'"
	// EventStreamsWebhookNoURL attempt to create a Webhook event stream without a URL
	EventStreamsWebhookNoURL = "Must specify webhook.url for action type 'webhook'"
	// EventStreamsWebhookInvalidURL attempt to create a Webhook event stream with an invalid URL
	EventStreamsWebhookInvalidURL = "Invalid URL in webhook action"
	// EventStreamsWebhookResumeActive resume when already resumed
	EventStreamsResumeActive = "Event processor is already active. Suspending:%t"
	// EventStreamsWebhookProhibitedAddress some IP ranges can be restricted
	EventStreamsWebhookProhibitedAddress = "Cannot send Webhook POST to address: %s"
	// EventStreamsWebhookFailedHTTPStatus server at the other end of a webhook returned a non-OK response
	EventStreamsWebhookFailedHTTPStatus = "%s: Failed with status=%d"
	// EventStreamsSubscribeBadBlock the starting block for a subscription request is invalid
	EventStreamsSubscribeBadBlock = "FromBlock cannot be parsed as a BigInt"
	// EventStreamsSubscribeStoreFailed problem saving a subscription to our DB
	EventStreamsSubscribeStoreFailed = "Failed to store subscription: %s"
	// EventStreamsSubscribeStoreFailed problem saving a subscription to our DB
	EventStreamsSubscribeLookupKeyStoreFailed = "Failed to store subscription lookup key: %s"
	// EventStreamsSubscribeNoEvent missing event
	EventStreamsSubscribeNoEvent = "Chaincode event name must be specified"
	// EventStreamsSubscriptionNotFound sub not found
	EventStreamsSubscriptionNotFound = "Subscription with ID '%s' not found"
	// EventStreamsCreateStreamStoreFailed problem saving a subscription to our DB
	EventStreamsCreateStreamStoreFailed = "Failed to store stream: %s"
	// EventStreamsCreateStreamResourceErr problem creating a resource required by the eventstream
	EventStreamsCreateStreamResourceErr = "Failed to create a resource for the stream: %s"
	// EventStreamsStreamNotFound stream not found
	EventStreamsStreamNotFound = "Stream with ID '%s' not found"
	// EventStreamsLogDecode problem decoding the logs for an event emitted on the chain
	EventStreamsLogDecode = "%s: Failed to decode data: %s"
	// EventStreamsLogDecodeInsufficientTopics ran out of topics according to the indexed fields described on the ABI event
	EventStreamsLogDecodeInsufficientTopics = "%s: Ran out of topics for indexed fields at field %d of %s"
	// EventStreamsLogDecodeData RLP decoding of the data section of the logs failed
	EventStreamsLogDecodeData = "%s: Failed to parse RLP data from event: %s"
	// EventStreamsWebSocketNotConfigured WebSocket not configured
	EventStreamsWebSocketNotConfigured = "WebSocket listener not configured"
	// EventStreamsWebSocketInterruptedSend When we are interrupted waiting for a viable connection to send down
	EventStreamsWebSocketInterruptedSend = "Interrupted waiting for WebSocket connection to send event"
	// EventStreamsWebSocketInterruptedReceive When we are interrupted waiting for a viable connection to send down
	EventStreamsWebSocketInterruptedReceive = "Interrupted waiting for WebSocket acknowledgment"
	// EventStreamsWebSocketErrorFromClient Error message received from client
	EventStreamsWebSocketErrorFromClient = "Error received from WebSocket client: %s"
	// EventStreamsCannotUpdateType cannot change tyep
	EventStreamsCannotUpdateType = "The type of an event stream cannot be changed"
	// EventStreamsInvalidDistributionMode unknown distribution mode
	EventStreamsInvalidDistributionMode = "Invalid distribution mode '%s'. Valid distribution modes are: 'workloadDistribution' and 'broadcast'."
	// EventStreamsUpdateAlreadyInProgress update already in progress
	EventStreamsUpdateAlreadyInProgress = "Update to event stream already in progress"
)

Functions

func Errorf

func Errorf(msg ErrorID, inserts ...interface{}) error

Errorf creates an error (not yet translated, but an extensible interface for that using simple sprintf formatting rather than named i18n inserts)

func RestErrReply

func RestErrReply(res http.ResponseWriter, req *http.Request, err error, status int)

Types

type Error

type Error string

func (Error) Error

func (e Error) Error() string

type ErrorID

type ErrorID string

ErrorID enumerates all errors in ethconnect.

type RestErrMsg

type RestErrMsg struct {
	Message string `json:"error"`
}