Use this as a temporary solution, to make the code compile during an ongoing migration. Drawbacks:

• Instances of Pretty[T] are ignored.
• No parameter names

The gRPC status encoded as a StatusRuntimeException

The gRPC status

A human readable string indicating the error

The error code, usually passed in as implicit where the error class is defined

The context (declared fields) of this error

The correlationId (e.g. submissionId) associated with the request that caused the error

Use this if you need a custom representation of a parameter. Do not use this to create lengthy strings, as line wrapping is not supported.

Controls whether a definite_answer error detail is added to the gRPC status code

Use this to indicate that you've omitted fields from pretty printing

Contains the location where the error has been created.

Flag to control if an error should be logged at creation Generally, we do want to log upon creation, except in the case of "nested" or combined errors, where we just nest the error but don't want it to be logged twice. See com.digitalasset.canton.error.ParentCantonError as an example.

The logging context obtained when we created the error, usually passed in as implicit via com.digitalasset.canton.logging.NamedLogging

A tree representing both parameter name and value.

A tree only written if not matching the default value

A tree representing a parameter name without a parameter value. Use this for parameters storing confidential or binary data.

Indicates how to pretty print this instance. See PrettyPrintingTest for examples on how to implement this method.

A tree consisting of a labelled node with the given children.

A tree representing the type name and parameter trees.

Like prettyOfClass, except takes an explicit name for the class.

A tree presenting the type name only. (E.g., for case objects.)

Use this to give a class with a singleton parameter the same pretty representation as the parameter.

Creates a pretty instance from a string function. Do not use this with lengthy strings, as line wrapping is not supported.

The resources related to this error

We return the set of resources via com.google.rpc.ResourceInfo. Override this method in order to return resource information via com.google.rpc.Status

Returns retryability information of this particular error

In some cases, error instances would like to provide custom retry intervals. This can be achieved by locally overriding this method.

Do not use this to change the contract of the error categories. Non-retryable errors shouldn't be made retryable. Only use it for adjusting the retry intervals.

Enables the syntax show"This object is pretty: $myPrettyType".

An optional argument to log exceptions

If you want to log an exception as part of your error, then use the following example:

object MyCode extends ErrorCode(id="SUPER_DUPER_ERROR") {
  case class MyError(someString: String, throwable: Throwable) extends SomeInternalError(
    cause = "Something failed with an exception bla",
    throwableO = Some(throwable)
  )
}

NOTE: This throwable's details are not included the exception communicated to the gRPC clients so if you want them communicated, you need to explicitly add them to the e.g. context map or cause string.

Yields a readable string representation based on com.digitalasset.canton.logging.pretty.Pretty.DefaultPprinter. Final to avoid accidental overwriting.

The traceId associated with the TraceContext at error creation

A tree representing a parameter value without a parameter name.