package error
- Alphabetic
- Public
- Protected
Type Members
- trait BaseError extends LocationMixin
The main error interface for everything that should be logged and notified.
The main error interface for everything that should be logged and notified.
There are two ways to communicate an error to the user: write it into a log or send it as a string. In most cases, we'll do both: log the error appropriately locally and communicate it to the user by failing the API call with an error string.
- trait ContextualizedError extends BaseError
Base class for errors for which error context is known at creation.
- trait ContextualizedErrorLogger extends AnyRef
Abstracts away from the logging tech stack used.
- class DamlError extends ContextualizedError
- class DamlErrorWithDefiniteAnswer extends DamlError
- final case class Description(description: String) extends Annotation with StaticAnnotation with Product with Serializable
- sealed trait ErrorCategory extends Product with Serializable
Standard error categories
Standard error categories
Ideally, all products will return errors with appropriate error codes. Every such error code is associated with an error category that defines how the error will appear in the log file and on the api level.
- final case class ErrorCategoryRetry(duration: FiniteDuration) extends Product with Serializable
Default retryability information
Default retryability information
Every error category has a default retryability classification. An error code may adjust the retry duration.
- final case class ErrorClass(groupings: List[Grouping]) extends Product with Serializable
Used to hierarchically structure error codes in the official documentation.
- abstract class ErrorCode extends AnyRef
Error Code Definition
Error Code Definition
We want to support our users and our developers with good error codes. Therefore, every error that an API returns should refer to a documented error code and provide some context information.
Every error code is uniquely identified using an error-id of max 63 CAPITALIZED_WITH_UNDERSCORES characters
Errors are organised according to ErrorGroups. And we separate the error code definition (using a singleton by virtue of using objects to express the nested hierarchy) and the actual error.
Please note that there is some implicit argument passing involved in the example below:
object SyncServiceErrors extends ParticipantErrorGroup { object ConnectionErrors extends ErrorGroup { object DomainUnavailable extends ErrorCode(id="DOMAIN_UNAVAILABLE", ..) { case class ActualError(someContext: Val) extends BaseError with SyncServiceError // this error will actually be referring to the same error code! case class OtherError(otherContext: Val) extends BaseError with SyncServiceError } } object HandshakeErrors extends ErrorGroup { ... } }
- abstract class ErrorGroup extends AnyRef
- trait ErrorResource extends AnyRef
Type of error resource
Type of error resource
Some errors are linked to a specific resource such as a contract id or a package id. In such cases, we include the resource identifier as part of the error message. This enum allows an error to provide identifiers of a resource
- final case class Explanation(explanation: String) extends Annotation with StaticAnnotation with Product with Serializable
- final case class Grouping(docName: String, fullClassName: String) extends Product with Serializable
A component of ErrorClass
A component of ErrorClass
- docName
The name that will appear in the generated documentation for the grouping.
- fullClassName
Full class name of the corresponding ErrorGroup.
- trait LocationMixin extends AnyRef
- class NoLogging extends ContextualizedErrorLogger
- final case class Resolution(resolution: String) extends Annotation with StaticAnnotation with Product with Serializable
- final case class RetryStrategy(retryStrategy: String) extends Annotation with StaticAnnotation with Product with Serializable
- sealed trait SerializableErrorCodeComponents extends AnyRef
Value Members
- object BaseError
- object ContextualizedErrorLogger
- object ErrorCategory extends Serializable
- object ErrorClass extends Serializable
- object ErrorCode
- object ErrorCodeMsg
- object ErrorResource
- object GrpcStatuses
- object NoLogging extends NoLogging
- object SerializableErrorCodeComponents