Type Members

1.  sealed trait AbstractLengthLimitedString extends AnyRef

   This trait wraps a String that is limited to a certain maximum length.

   This trait wraps a String that is limited to a certain maximum length. The canonical use case is ensuring that we don't write too long strings into the database.

   You should normally implement LengthLimitedString or use its subclasses, for strings to be stored in standard string columns.

   As this class implements fewer checks, this also serves as the basis for longer strings such as CLOBs.

2.  final case class InstanceName extends NoCopy with PrettyPrinting with Product with Serializable
3.  sealed trait LengthLimitedString extends AbstractLengthLimitedString

   This trait wraps a String that is limited to a certain maximum length.

   This trait wraps a String that is limited to a certain maximum length. Classes implementing this trait expose create and tryCreate methods to safely (and non-safely) construct such a String.

   The canonical use case for LengthLimitedStrings is ensuring that we don't write too long strings into the database. This validation generally occurs on the server side and not on the client side. Concretely, this means that the Admin API and Ledger API gRPC services is the point where we validate that the received Protobuf Strings are not too long (and convert them into LengthLimitedStrings). On the client side, e.g. at the console, we generally take normal String types.

   For longer strings, directly inherit from AbstractLengthLimitedString.

4.  trait LengthLimitedStringCompanion[A <: AbstractLengthLimitedString] extends AnyRef

   Trait that implements method commonly needed in the companion object of an AbstractLengthLimitedString

5.  final case class LengthLimitedStringVar extends LengthLimitedString with Product with Serializable
6.  trait LengthLimitedStringWrapper extends AnyRef

   Trait for case classes that are a wrapper around a LengthLimitedString.

   Trait for case classes that are a wrapper around a LengthLimitedString.

   See also

   com.digitalasset.canton.crypto.CertificateId for an example

7.  trait LengthLimitedStringWrapperCompanion[A <: LengthLimitedString, Wrapper <: LengthLimitedStringWrapper] extends AnyRef

   Trait that implements utility methods to avoid boilerplate in the companion object of a case class that wraps a LengthLimitedString type using LengthLimitedStringWrapper.

   Trait that implements utility methods to avoid boilerplate in the companion object of a case class that wraps a LengthLimitedString type using LengthLimitedStringWrapper.

   See also

   com.digitalasset.canton.crypto.CertificateId for an example

8.  final case class NonEmptyString extends Product with Serializable
9.  final case class String1 extends LengthLimitedString with Product with Serializable
10.  final case class String100 extends LengthLimitedString with Product with Serializable
11.  final case class String185 extends LengthLimitedString with Product with Serializable

    Limit used by com.digitalasset.canton.topology.UniqueIdentifier.

    Limit used by com.digitalasset.canton.topology.UniqueIdentifier.

    See also

    com.digitalasset.canton.topology.Identifier for documentation on its origin

12.  final case class String2066 extends AbstractLengthLimitedString with Product with Serializable

    Length limitation for an com.digitalasset.canton.protocol.LfTemplateId.

    Length limitation for an com.digitalasset.canton.protocol.LfTemplateId. A com.digitalasset.canton.protocol.LfTemplateId consists of

    • The module name (com.digitalasset.daml.lf.data.Ref.DottedName)
    • The template name (com.digitalasset.daml.lf.data.Ref.DottedName)
    • The package ID
    • Two separating dots Each com.digitalasset.daml.lf.data.Ref.DottedName can have 1000 chars (com.digitalasset.daml.lf.data.Ref.DottedName.maxLength). So a com.digitalasset.canton.protocol.LfTemplateId serializes to 1000 + 1000 + 64 + 2 = 2066 chars.
13.  final case class String255 extends LengthLimitedString with Product with Serializable

    Default LengthLimitedString that should be used when in doubt.

    Default LengthLimitedString that should be used when in doubt. 255 was chosen as it is also the limit used in the upstream code for, e.g., LedgerStrings in the upstream code

14.  final case class String256M extends AbstractLengthLimitedString with Product with Serializable

    Length limitation of a TEXT or unbounded VARCHAR field in postgres.

    Length limitation of a TEXT or unbounded VARCHAR field in postgres.

    • Postgres TEXT or VARCHAR support up to 1GB storage. That is at least 2 ^ 28 characters in UTF8 encoding as each character needs at most 4 bytes.

    TEXT/VARCHAR are only used for the following values (none are indices):

    • daml_packages.source_description
    • topology_transactions.ignore_reason
15.  final case class String3 extends LengthLimitedString with Product with Serializable

    Limit used for enum names.

16.  final case class String300 extends LengthLimitedString with Product with Serializable

    Longest limited-length strings that have been needed so far.

    Longest limited-length strings that have been needed so far. Typical use case: when a 255-length identifier is combined with other short suffixes or prefixes to further specialize them.

    See also

    com.digitalasset.canton.store.db.SequencerClientDiscriminator

    com.digitalasset.canton.crypto.KeyName

17.  final case class String36 extends LengthLimitedString with Product with Serializable

    Limit used by a UUID.

18.  final case class String68 extends LengthLimitedString with Product with Serializable

    Limit used by a hash (SHA256 in particular) in a com.digitalasset.canton.topology.UniqueIdentifier.

    Limit used by a hash (SHA256 in particular) in a com.digitalasset.canton.topology.UniqueIdentifier.

    See also

    com.digitalasset.canton.topology.UniqueIdentifier for documentation on its origin

19.  final case class String73 extends LengthLimitedString with Product with Serializable

    Limit used by a com.digitalasset.canton.sequencing.protocol.MessageId.