c

com.digitalasset.canton.domain.config

DomainParametersConfig

final case class DomainParametersConfig(reconciliationInterval: PositiveDurationSeconds = StaticDomainParameters.defaultReconciliationInterval.toConfig, maxRatePerParticipant: NonNegativeInt = StaticDomainParameters.defaultMaxRatePerParticipant, maxInboundMessageSize: MaxRequestSize = StaticDomainParameters.defaultMaxRequestSize, uniqueContractKeys: Boolean = true, requiredSigningKeySchemes: Option[NonEmpty[Set[SigningKeyScheme]]] = None, requiredEncryptionKeySchemes: Option[NonEmpty[Set[EncryptionKeyScheme]]] = None, requiredSymmetricKeySchemes: Option[NonEmpty[Set[SymmetricKeyScheme]]] = None, requiredHashAlgorithms: Option[NonEmpty[Set[HashAlgorithm]]] = None, requiredCryptoKeyFormats: Option[NonEmpty[Set[CryptoKeyFormat]]] = None, protocolVersion: Option[DomainProtocolVersion] = None, devVersionSupport: Boolean = false, betaVersionSupport: Boolean = false, dontWarnOnDeprecatedPV: Boolean = false, resetStoredStaticConfig: Boolean = false) extends ProtocolConfig with PrettyPrinting with Product with Serializable

Configuration of domain parameters that all members connecting to a domain must adhere to.

To set these parameters, you need to be familiar with the Canton architecture. See the Canton architecture overview for further information.

reconciliationInterval

determines the time between sending two successive ACS commitments. Must be a multiple of 1 second.

maxRatePerParticipant

maximum number of messages sent per participant per second

maxInboundMessageSize

maximum size of messages (in bytes) that the domain can receive through the public API

uniqueContractKeys

When set, participants connected to this domain will check that contract keys are unique. When a participant is connected to a domain with unique contract keys support, it must not connect nor have ever been connected to any other domain.

requiredSigningKeySchemes

The optional required signing key schemes that a member has to support. If none is specified, all the allowed schemes are required.

requiredEncryptionKeySchemes

The optional required encryption key schemes that a member has to support. If none is specified, all the allowed schemes are required.

requiredSymmetricKeySchemes

The optional required symmetric key schemes that a member has to support. If none is specified, all the allowed schemes are required.

requiredHashAlgorithms

The optional required hash algorithms that a member has to support. If none is specified, all the allowed algorithms are required.

requiredCryptoKeyFormats

The optional required crypto key formats that a member has to support. If none is specified, all the supported algorithms are required.

protocolVersion

The protocol version spoken on the domain. All participants and domain nodes attempting to connect to the sequencer need to support this protocol version to connect. Must be defined, otherwise config validation will fail.

dontWarnOnDeprecatedPV

If true, then this domain will not emit a warning when configured to use a deprecated protocol version (such as 2.0.0).

resetStoredStaticConfig

DANGEROUS: If true, then the stored static configuration parameters will be reset to the ones in the configuration file

Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. DomainParametersConfig
  2. Serializable
  3. Product
  4. Equals
  5. PrettyPrinting
  6. PrettyUtil
  7. ShowUtil
  8. ShowSyntax
  9. ToShowOps
  10. ProtocolConfig
  11. AnyRef
  12. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new DomainParametersConfig(reconciliationInterval: PositiveDurationSeconds = StaticDomainParameters.defaultReconciliationInterval.toConfig, maxRatePerParticipant: NonNegativeInt = StaticDomainParameters.defaultMaxRatePerParticipant, maxInboundMessageSize: MaxRequestSize = StaticDomainParameters.defaultMaxRequestSize, uniqueContractKeys: Boolean = true, requiredSigningKeySchemes: Option[NonEmpty[Set[SigningKeyScheme]]] = None, requiredEncryptionKeySchemes: Option[NonEmpty[Set[EncryptionKeyScheme]]] = None, requiredSymmetricKeySchemes: Option[NonEmpty[Set[SymmetricKeyScheme]]] = None, requiredHashAlgorithms: Option[NonEmpty[Set[HashAlgorithm]]] = None, requiredCryptoKeyFormats: Option[NonEmpty[Set[CryptoKeyFormat]]] = None, protocolVersion: Option[DomainProtocolVersion] = None, devVersionSupport: Boolean = false, betaVersionSupport: Boolean = false, dontWarnOnDeprecatedPV: Boolean = false, resetStoredStaticConfig: Boolean = false)

    reconciliationInterval

    determines the time between sending two successive ACS commitments. Must be a multiple of 1 second.

    maxRatePerParticipant

    maximum number of messages sent per participant per second

    maxInboundMessageSize

    maximum size of messages (in bytes) that the domain can receive through the public API

    uniqueContractKeys

    When set, participants connected to this domain will check that contract keys are unique. When a participant is connected to a domain with unique contract keys support, it must not connect nor have ever been connected to any other domain.

    requiredSigningKeySchemes

    The optional required signing key schemes that a member has to support. If none is specified, all the allowed schemes are required.

    requiredEncryptionKeySchemes

    The optional required encryption key schemes that a member has to support. If none is specified, all the allowed schemes are required.

    requiredSymmetricKeySchemes

    The optional required symmetric key schemes that a member has to support. If none is specified, all the allowed schemes are required.

    requiredHashAlgorithms

    The optional required hash algorithms that a member has to support. If none is specified, all the allowed algorithms are required.

    requiredCryptoKeyFormats

    The optional required crypto key formats that a member has to support. If none is specified, all the supported algorithms are required.

    protocolVersion

    The protocol version spoken on the domain. All participants and domain nodes attempting to connect to the sequencer need to support this protocol version to connect. Must be defined, otherwise config validation will fail.

    dontWarnOnDeprecatedPV

    If true, then this domain will not emit a warning when configured to use a deprecated protocol version (such as 2.0.0).

    resetStoredStaticConfig

    DANGEROUS: If true, then the stored static configuration parameters will be reset to the ones in the configuration file

Type Members

  1. implicit class ShowAnyRefSyntax extends AnyRef
    Definition Classes
    ShowUtil
  2. implicit class ShowEitherSyntax[L, R] extends AnyRef

    Enables the syntax show"${myEither.showMerged}".

    Enables the syntax show"${myEither.showMerged}".

    Definition Classes
    ShowUtil
  3. implicit class ShowLengthLimitedStringSyntax extends StringOperators
    Definition Classes
    ShowUtil
  4. implicit class ShowLengthLimitedStringWrapperSyntax extends StringOperators
    Definition Classes
    ShowUtil
  5. implicit class ShowOptionSyntax[T] extends AnyRef
    Definition Classes
    ShowUtil
  6. implicit class ShowProductSyntax extends AnyRef
    Definition Classes
    ShowUtil
    Annotations
    @SuppressWarnings()
  7. implicit class ShowStringSyntax extends StringOperators
    Definition Classes
    ShowUtil
  8. implicit class ShowTraversableSyntax[T] extends AnyRef

    Enables syntax like show"Found several elements: ${myCollection.mkShow()}".

    Enables syntax like show"Found several elements: ${myCollection.mkShow()}".

    Definition Classes
    ShowUtil
  9. abstract class StringOperators extends AnyRef

    Enables syntax like show"This is a string: ${myString.doubleQuoted}" and show"This is a hash: ${myHash.readableHash}".

    Enables syntax like show"This is a string: ${myString.doubleQuoted}" and show"This is a hash: ${myHash.readableHash}".

    Definition Classes
    ShowUtil

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def adHocPrettyInstance[T <: Product](implicit c: ClassTag[T]): Pretty[T]

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

    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
    Definition Classes
    PrettyUtil
  5. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  6. val betaVersionSupport: Boolean
  7. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native() @IntrinsicCandidate()
  8. def customParam[T](getValue: (T) => String, cond: (T) => Boolean = (_: T) => true): (T) => Option[Tree]

    Use this if you need a custom representation of a parameter.

    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.

    Definition Classes
    PrettyUtil
  9. val devVersionSupport: Boolean
  10. val dontWarnOnDeprecatedPV: Boolean
  11. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @IntrinsicCandidate()
  13. def indicateOmittedFields[T]: (T) => Option[Tree]

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

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

    Definition Classes
    PrettyUtil
  14. def initialProtocolVersion: ProtocolVersion
  15. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  16. val maxInboundMessageSize: MaxRequestSize
  17. val maxRatePerParticipant: NonNegativeInt
  18. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  19. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @IntrinsicCandidate()
  20. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @IntrinsicCandidate()
  21. def param[T, V](name: String, getValue: (T) => V, cond: (T) => Boolean = (_: T) => true)(implicit arg0: Pretty[V]): (T) => Option[Tree]

    A tree representing both parameter name and value.

    A tree representing both parameter name and value.

    Definition Classes
    PrettyUtil
  22. def paramIfDefined[T, V](name: String, getValue: (T) => Option[V])(implicit arg0: Pretty[V]): (T) => Option[Tree]
    Definition Classes
    PrettyUtil
  23. def paramIfNonEmpty[T, V <: IterableOnce[_]](name: String, getValue: (T) => V)(implicit arg0: Pretty[V]): (T) => Option[Tree]
    Definition Classes
    PrettyUtil
  24. def paramIfNotDefault[T, V](name: String, getValue: (T) => V, default: V)(implicit arg0: Pretty[V]): (T) => Option[Tree]

    A tree only written if not matching the default value

    A tree only written if not matching the default value

    Definition Classes
    PrettyUtil
  25. def paramIfTrue[T](label: String, getValue: (T) => Boolean): (T) => Option[Tree]
    Definition Classes
    PrettyUtil
  26. def paramWithoutValue[T](name: String, cond: (T) => Boolean = (_: T) => true): (T) => Option[Tree]

    A tree representing a parameter name without a parameter value.

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

    Definition Classes
    PrettyUtil
  27. def pretty: Pretty[DomainParametersConfig]

    Indicates how to pretty print this instance.

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

    Definition Classes
    DomainParametersConfigPrettyPrinting
  28. def prettyInfix[T]: PrettyInfixPartiallyApplied[T]
    Definition Classes
    PrettyUtil
  29. def prettyNode[T](label: String, children: (T) => Option[Tree]*): Pretty[T]

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

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

    Definition Classes
    PrettyUtil
  30. def prettyOfClass[T](getParamTrees: (T) => Option[Tree]*): Pretty[T]

    A tree representing the type name and parameter trees.

    A tree representing the type name and parameter trees.

    Definition Classes
    PrettyUtil
  31. def prettyOfObject[T <: Product]: Pretty[T]

    A tree presenting the type name only.

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

    Definition Classes
    PrettyUtil
  32. def prettyOfParam[T, V](getValue: (T) => V)(implicit arg0: Pretty[V]): Pretty[T]

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

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

    Definition Classes
    PrettyUtil
  33. def prettyOfString[T](toString: (T) => String): Pretty[T]

    Creates a pretty instance from a string function.

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

    Definition Classes
    PrettyUtil
  34. def productElementNames: Iterator[String]
    Definition Classes
    Product
  35. val protocolVersion: Option[DomainProtocolVersion]
  36. val reconciliationInterval: PositiveDurationSeconds
  37. val requiredCryptoKeyFormats: Option[NonEmpty[Set[CryptoKeyFormat]]]
  38. val requiredEncryptionKeySchemes: Option[NonEmpty[Set[EncryptionKeyScheme]]]
  39. val requiredHashAlgorithms: Option[NonEmpty[Set[HashAlgorithm]]]
  40. val requiredSigningKeySchemes: Option[NonEmpty[Set[SigningKeyScheme]]]
  41. val requiredSymmetricKeySchemes: Option[NonEmpty[Set[SymmetricKeyScheme]]]
  42. val resetStoredStaticConfig: Boolean
  43. implicit final def showInterpolator(sc: StringContext): ShowInterpolator
    Definition Classes
    ShowSyntax
  44. implicit def showPretty[T](implicit arg0: Pretty[T]): Show[T]

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

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

    Definition Classes
    ShowUtil
  45. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  46. implicit def toShow[A](target: A)(implicit tc: Show[A]): Ops[A]
    Definition Classes
    ToShowOps
  47. def toStaticDomainParameters(cryptoConfig: CryptoConfig): Either[String, StaticDomainParameters]

    Converts the domain parameters config into a domain parameters protocol message.

    Converts the domain parameters config into a domain parameters protocol message.

    Sets the required crypto schemes based on the provided crypto config if they are unset in the config.

  48. final def toString(): String

    Yields a readable string representation based on com.digitalasset.canton.logging.pretty.Pretty.DefaultPprinter.

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

    Definition Classes
    PrettyPrinting → AnyRef → Any
  49. def tryDomainProtocolVersion: DomainProtocolVersion
  50. val uniqueContractKeys: Boolean
  51. def unnamedParam[T, V](getValue: (T) => V, cond: (T) => Boolean = (_: T) => true)(implicit arg0: Pretty[V]): (T) => Option[Tree]

    A tree representing a parameter value without a parameter name.

    A tree representing a parameter value without a parameter name.

    Definition Classes
    PrettyUtil
  52. def unnamedParamIfDefined[T, V](getValue: (T) => Option[V])(implicit arg0: Pretty[V]): (T) => Option[Tree]
    Definition Classes
    PrettyUtil
  53. def unnamedParamIfNonEmpty[T, V <: IterableOnce[_]](getValue: (T) => V)(implicit arg0: Pretty[V]): (T) => Option[Tree]
    Definition Classes
    PrettyUtil
  54. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  55. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  56. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated @Deprecated
    Deprecated

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from PrettyPrinting

Inherited from PrettyUtil

Inherited from ShowUtil

Inherited from ShowSyntax

Inherited from ToShowOps

Inherited from ProtocolConfig

Inherited from AnyRef

Inherited from Any

Ungrouped