object TopologyManagerError extends TopologyManagerErrorGroup
Linear Supertypes
Ordering
- Alphabetic
- By Inheritance
Inherited
- TopologyManagerError
- TopologyManagerErrorGroup
- ErrorGroup
- AnyRef
- Any
- Hide All
- Show All
Visibility
- Public
- Protected
Type Members
- abstract class ParticipantErrorGroup extends ErrorGroup
- abstract class SynchronizerErrorGroup extends ErrorGroup
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @IntrinsicCandidate() @native()
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- implicit val errorClass: ErrorClass
- Definition Classes
- ErrorGroup
- val fullClassName: String
- Definition Classes
- ErrorGroup
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @IntrinsicCandidate() @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @IntrinsicCandidate() @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @IntrinsicCandidate() @native()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- object CannotRemoveMapping extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that a mapping cannot be removed.") @Resolution(resolution = "Use the REPLACE operation to change the existing mapping.")
- object DangerousCommandRequiresForce extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that a dangerous command that could break a node was rejected.
|This is the case if a dangerous command is run on a node to issue transactions for another node.
|Such commands must be run with force, as they are very dangerous and could easily break
|the node.
|As an example, if we assign an encryption key to a participant that the participant does not
|have, then the participant will be unable to process an incoming transaction. Therefore we must
|be very careful to not create such situations.
| """) @Resolution(resolution = "Set the ForceFlag.AlienMember if you really know what you are doing.")
- object IllegalRemovalOfSynchronizerTrustCertificate extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that a participant is trying to rescind their synchronizer trust certificate
|while still being hosting parties.""") @Resolution(resolution = """The participant should work with the owners of the parties mentioned in the ``parties`` field in the
|error details metadata to get itself removed from the list of hosting participants of those parties.""")
- object InconsistentTopologySnapshot extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that the submitted topology snapshot was internally inconsistent.") @Resolution(resolution = """Inspect the transactions mentioned in the ``transactions`` field in the error details metadata for inconsistencies.""")
- object IncreaseOfPreparationTimeRecordTimeTolerance extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that it has been attempted to increase the ``preparationTimeRecordTimeTolerance`` synchronizer parameter in an insecure manner.
|Increasing this parameter may disable security checks and can therefore be a security risk.
|""") @Resolution(resolution = """Make sure that the new value of ``preparationTimeRecordTimeTolerance`` is at most half of the ``mediatorDeduplicationTimeout`` synchronizer parameter.
|
|Use ``mySynchronizer.service.set_preparation_time_record_time_tolerance`` for securely increasing preparationTimeRecordTimeTolerance.
|
|Alternatively, add the flag ``ForceFlag.PreparationTimeRecordTimeToleranceIncrease`` to your command, if security is not a concern for you.
|The security checks will be effective again after twice the new value of ``preparationTimeRecordTimeTolerance``.
|Using ``ForceFlag.PreparationTimeRecordTimeToleranceIncrease`` is safe upon synchronizer bootstrapping.
|""")
- object InsufficientKeys extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that members referenced in a topology transaction have not declared at least one signing key or at least 1 encryption key or both.") @Resolution(resolution = """Ensure that all members referenced in the topology transaction have declared at least one signing key and at least one encryption key, then resubmit the failed transaction.
|The metadata details of this error contain the members with the missing keys in the field ``members``.""")
- object InternalError extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that there was an internal error within the topology manager.""") @Resolution(resolution = "Inspect error message for details.")
- object InvalidSignatureError extends AlarmErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the uploaded signed transaction contained an invalid signature.""") @Resolution(resolution = "Ensure that the transaction is valid and uses a crypto version understood by this participant.")
- object InvalidSynchronizer extends ErrorCode
- Annotations
- @Explanation(explanation = """This error is returned if a transaction was submitted that is restricted to another synchronizer.""") @Resolution(resolution = """Recreate the content of the transaction with a correct synchronizer identifier.""")
- object InvalidTopologyMapping extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the submitted topology mapping was invalid.""") @Resolution(resolution = """The participant should work with the owners of the parties mentioned in the ``parties`` field in the
|error details metadata to get itself removed from the list of hosting participants of those parties.""")
- object MappingAlreadyExists extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that a topology transaction would create a state that already exists and has been authorized with the same key.""") @Resolution(resolution = """Your intended change is already in effect.""")
- object MediatorsAlreadyInOtherGroups extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that a topology transaction attempts to add mediators to multiple mediator groups.""") @Resolution(resolution = "Either first remove the mediators from their current groups or choose other mediators to add.")
- object MemberCannotRejoinSynchronizer extends ErrorCode
- object MissingTopologyMapping extends ErrorCode
- object MultiTransactionHashMismatch extends ErrorCode
- Annotations
- @Explanation(explanation = """This error is returned when a signature does not cover the expected transaction hash
|of the transaction.""") @Resolution(resolution = """Either add a signature for the hash of this specific transaction only, or a signature
|that covers the this transaction as part of a multi transaction hash.""")
- object NamespaceAlreadyInUse extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the namespace is already used by another entity.""") @Resolution(resolution = """Change the namespace used in the submitted topology transaction.""")
- object NoAppropriateSigningKeyInStore extends ErrorCode
- Annotations
- @Explanation(explanation = """This error results if the topology manager did not find a secret key in its store to authorize a certain topology transaction.""") @Resolution(resolution = """Inspect your topology transaction and your secret key store and check that you have the
appropriate certificates and keys to issue the desired topology transaction.
If you explicitly requested signing with specific keys, then the unusable keys are listed. Otherwise,
if the list is empty, then you are missing the certificates.""")
- object NoCorrespondingActiveTxToRevoke extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the attempt to add a removal transaction was rejected, as the mapping affecting the removal did not exist.""") @Resolution(resolution = """Inspect the topology state and ensure the mapping of the active transaction you are trying to revoke matches your revocation arguments.""")
- object ParticipantIdConflictWithPartyId extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that a participant failed to be onboarded, because it has the same UID as an already existing party.") @Resolution(resolution = "Change the identity of the participant by either changing the namespace or the participant's UID and try to onboard to the synchronizer again.")
- object ParticipantOnboardingRefused extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that a participant was not able to onboard to a synchronizer because onboarding restrictions are in place.""") @Resolution(resolution = """Verify the onboarding restrictions of the synchronizer. If the synchronizer is not locked, then the participant needs first to be put on the allow list by issuing a ParticipantSynchronizerPermission transaction.""")
- object ParticipantTopologyManagerError extends ParticipantErrorGroup
- object PartyIdConflictWithAdminParty extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that the partyId to allocate is the same as an already existing admin party.") @Resolution(resolution = "Submit the topology transaction with a changed partyId.")
- object RemoveMustNotChangeMapping extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the removal of a topology mapping also changed the content compared
|to the mapping with the previous serial.""") @Resolution(resolution = "Submit the transaction with the same topology mapping as the previous serial, but with the operation REMOVE.")
- object RemovingKeyWithDanglingTransactionsMustBeForced extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the attempted key removal would create dangling topology transactions, making the node unusable.""") @Resolution(resolution = """Add the `force = true` flag to your command if you are really sure what you are doing.""")
- object RemovingLastKeyMustBeForced extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the attempted key removal would remove the last valid key of the given entity, making the node unusable.""") @Resolution(resolution = """Add the `force = true` flag to your command if you are really sure what you are doing.""")
- object SecretKeyNotInStore extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the secret key with the respective fingerprint can not be found.""") @Resolution(resolution = "Ensure you only use fingerprints of secret keys stored in your secret key store.")
- object SerialMismatch extends ErrorCode
- object TemporaryTopologyStoreAlreadyExists extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that there already exists a temporary topology store with the desired identifier.") @Resolution(resolution = "Either first the existing temporary topology store before resubmitting the request or use the store as it is.")
- object TimeoutWaitingForTransaction extends ErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the topology transactions weren't processed in the allotted time.""") @Resolution(resolution = "Contact the node administrator to check the result of processing the topology transactions.")
- object TooManyTransactionsWithHash extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that more than one topology transaction with the same transaction hash was found.") @Resolution(resolution = """Inspect the topology state for consistency and take corrective measures before retrying.
|The metadata details of this error contains the transactions in the field ``transactions``.""")
- object TopologyManagerAlarm extends AlarmErrorCode
- Annotations
- @Explanation(explanation = """The topology manager has received a malformed message from another node.""") @Resolution(resolution = "Inspect the error message for details.")
- object TopologyStoreUnknown extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that the expected topology store was not found.") @Resolution(resolution = "Check that the provided topology store name is correct before retrying.")
- object TopologyTransactionNotFound extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that a topology transaction could not be found.") @Resolution(resolution = "The topology transaction either has been rejected, is not valid anymore, is not yet valid, or does not yet exist.")
- object UnauthorizedTransaction extends AlarmErrorCode
- Annotations
- @Explanation(explanation = """This error indicates that the attempt to add a transaction was rejected, as the signing key is not authorized within the current state.""") @Resolution(resolution = """Inspect the topology state and ensure that a valid namespace delegations of the signing key exists or upload one before adding this transaction.""")
- object UnknownMembers extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that the topology transaction references members that are currently unknown.") @Resolution(resolution = """Wait for the onboarding of the members to be become active or remove the unknown members from the topology transaction.
|The metadata details of this error contain the unknown member in the field ``members``.""")
- object UnknownParties extends ErrorCode
- Annotations
- @Explanation(explanation = "This error indicates that the topology transaction references parties that are currently unknown.") @Resolution(resolution = """Wait for the onboarding of the parties to be become active or remove the unknown parties from the topology transaction.
|The metadata details of this error contain the unknown parties in the field ``parties``.""")