Error Codes

The nChain Event REST API endpoints may emit these errors during operation:

Error Code	Endpoints	Meaning - mitigation
CONTENT_IS_REQUIRED	Write / Verify / Create / Update	No content has been supplied to submit to the blockchain, but it is required - try again
CONTENT_LENGTH_LIMIT_EXCEEDED	Write / Verify / Create / Update	The size of the content exceeds a configuration setting - make the payload smaller or contact nChain for an update
ENCODER_ARGUMENT_MISSING	Write / Verify / Create / Update	No encoder argument was supplied - try this: SHA256(any-salt-you-want)
ENCODER_FINGERPRINT_MISSING ENCODER_SHA256_MISSING	Write / Verify / Create / Update	A fingerprint encoder is required for this configuration - specify a SHA256 encoder or contact nChain for an update
ENCODE_PARAM_INVALID	Write / Verify / Create / Update	The parameter supplied to Encode is erroneous - check the syntax above
INCORRECT_EVENT_TRANSACTION_TYPE	Delete	The delete operation does not accept any content - perform an update followed by a delete
INVALID_NAVIGATION_TRANSACTION_TYPE	Navigate	It is only possible to navigate nChain Event linked records - try again
NOT_A_DATA_TRANSACTION NOT_AN_EVENT_TRANSACTION	Get (Link) Location Status / Read (Link) Record	The supplied TX_ID parameter appears to be invalid - check and try again
NOT_LINKED_RECORDS_END	Update / Delete	It is only possible to update or delete the last location in linked records - use the last location
PREV_TX_ID_PARAM_MISSING	Verify / Delete	You must supply the previous TX_ID to verify the linked record - try again
TX_ID_PARAM_INVALID	Get (Link) Location Status / Read (Link) Record	The supplied TX_ID parameter appears to be invalid - check and try again
TX_NOT_LINKABLE	Update / Delete	The location refers to a transaction that cannot be updated or deleted - try again with the location of a valid unlinked transaction
UNKNOWN_ENCODER	Write / Verify / Create / Update	The supplied encoder appears to be invalid - try again or contact nChain for an upgrade