Consensus Errors

Dash Platform protocol error codes

🚧

New site!

All content has been migrated to docs.dash.org. You will be automatically redirected momentarily.

Platform Error Codes

A comprehensive set of consensus error codes were introduced in Dash Platform v0.21. The tables below follow the codes found in code.js of the consensus source code.

The error codes are organized into four categories that each span 1000 error codes. Each category may be further divided into sub-categories. The four categories and their error code ranges are:

Category	Code range	Description
Basic	1000 - 1999	Errors encountered while validating structure and data
Signature	2000 - 2999	Errors encountered while validating identity existence and state transition signature
Fee	3000 - 3999	Errors encountered while validating an identity's balance is sufficient to pay fees
State	4000 - 4999	Errors encounter while validating state transitions against the platform state

Basic

Basic errors occupy the codes ranging from 1000 to 1999. This range is divided into several categories for clarity.

Decoding Errors

Code	Error Description	Comment
1000	ProtocolVersionParsingError
1001	SerializedObjectParsingError
1002	UnsupportedProtocolVersionError
1003	IncompatibleProtocolVersionError

Structure Errors

Code	Error Description	Comment
1004	JsonSchemaCompilationError
1005	JsonSchemaError
1006	InvalidIdentifierError
1060	ValueError	Added in v0.24

Data Contract Errors

Code	Error Description	Comment
1007	DataContractMaxDepthExceedError
1008	DuplicateIndexError
1009	IncompatibleRe2PatternError
1010	InvalidCompoundIndexError
1011	InvalidDataContractIDError
1012	InvalidIndexedPropertyConstraintError
1013	InvalidIndexPropertyTypeError
1014	InvalidJsonSchemaRefError
1015	SystemPropertyIndexAlreadyPresentError
1016	UndefinedIndexPropertyError
1017	UniqueIndicesLimitReachedError
1048	DuplicateIndexNameError	Added in v0.22
1050	InvalidDataContractVersionError	4013 prior to v0.23
1051	IncompatibleDataContractSchemaError	4014 prior to v0.23
1052	DataContractImmutablePropertiesUpdateError	4015 prior to v0.23
1053	DataContractUniqueIndicesChangedError	4016 prior to v0.23
1054	DataContractInvalidIndexDefinitionUpdateError	Added in v0.23
1055	DataContractHaveNewUniqueIndexError	Added in v0.23

Document Errors

Code	Error Description	Comment
1018	DataContractNotPresentError
1019	DuplicateDocumentTransitionsWithIDsError
1020	DuplicateDocumentTransitionsWithIndicesError
1021	InconsistentCompoundIndexDataError
1022	InvalidDocumentTransitionActionError
1023	InvalidDocumentTransitionIDError
1024	InvalidDocumentTypeError
1025	MissingDataContractIDBasicError
1026	MissingDocumentTransitionActionError
1027	MissingDocumentTransitionTypeError
1028	MissingDocumentTypeError

Identity Errors

Code	Error Description	Comment
1029	DuplicatedIdentityPublicKeyBasicError
1030	DuplicatedIdentityPublicKeyIDBasicError
1031	IdentityAssetLockProofLockedTransactionMismatchError
1032	IdentityAssetLockTransactionIsNotFoundError
1033	IdentityAssetLockTransactionOutputAlreadyExistsError
1034	IdentityAssetLockTransactionOutputNotFoundError
1035	InvalidAssetLockProofCoreChainHeightError
1036	InvalidAssetLockProofTransactionHeightError
1037	InvalidAssetLockTransactionOutputReturnSizeError
1038	InvalidIdentityAssetLockTransactionError
1039	InvalidIdentityAssetLockTransactionOutputError
1040	InvalidIdentityPublicKeyDataError
1041	InvalidInstantAssetLockProofError
1042	InvalidInstantAssetLockProofSignatureError
1046	MissingMasterPublicKeyError	Added in v0.22
1047	InvalidIdentityPublicKeySecurityLevelError	Added in v0.22
1056	InvalidIdentityKeySignatureError	Added in v0.23
1057	InvalidIdentityCreditWithdrawalTransitionOutputScriptError	Added in v0.24
1058	InvalidIdentityCreditWithdrawalTransitionCoreFeeError	Added in v0.24
1059	NotImplementedIdentityCreditWithdrawalTransitionPoolingError	Added in v0.24

State Transition Errors

Code	Error Description	Comment
1043	InvalidStateTransitionTypeError
1044	MissingStateTransitionTypeError
1045	StateTransitionMaxSizeExceededError

Signature Errors

Signature errors occupy the codes ranging from 2000 to 2999.

Code	Error Description	Comment
2000	IdentityNotFoundError
2001	InvalidIdentityPublicKeyTypeError
2002	InvalidStateTransitionSignatureError
2003	MissingPublicKeyError
2004	InvalidSignaturePublicKeySecurityLevelError	Added in v0.23
2005	WrongPublicKeyPurposeError	Added in v0.23
2006	PublicKeyIsDisabledError	Added in v0.23
2007	PublicKeySecurityLevelNotMetError	Added in v0.23

Fee Errors

Fee errors occupy the codes ranging from 3000 to 3999.

Code	Error Description	Comment
3000	BalanceIsNotEnoughError	Current credits balance is insufficient to pay fee

State

State errors occupy the codes ranging from 4000 to 4999. This range is divided into several categories for clarity.

Data Contract Errors

Code	Error Description	Comment
4000	DataContractAlreadyPresentError

Document Errors

Code	Error Description	Comment
4004	DocumentAlreadyPresentError
4005	DocumentNotFoundError
4006	DocumentOwnerIdMismatchError
4007	DocumentTimestampsMismatchError
4008	DocumentTimestampWindowViolationError
4009	DuplicateUniqueIndexError
4010	InvalidDocumentRevisionError

Identity Errors

Code	Error Description	Comment
4011	IdentityAlreadyExistsError
4012	IdentityPublicKeyDisabledAtWindowViolationError	Added in v0.23
4017	IdentityPublicKeyIsReadOnlyError	Added in v0.23
4018	InvalidIdentityPublicKeyIdError	Added in v0.23
4019	InvalidIdentityRevisionError	Added in v0.23
4020	StateMaxIdentityPublicKeyLimitReachedError	Added in v0.23
4021	DuplicatedIdentityPublicKeyStateError	Added in v0.23
4022	DuplicatedIdentityPublicKeyIdStateError	Added in v0.23
4023	IdentityPublicKeyIsDisabledError	Added in v0.23
4024	IdentityInsufficientBalanceError	Added in v0.24

Data Trigger Errors

Code	Error Description	Comment
4001	DataTriggerConditionError
4002	DataTriggerExecutionError
4003	DataTriggerInvalidResultError