Skip to main content
Version: 3.13

ScalarDL Ledger Error Codes

This page provides a list of error codes in ScalarDL Ledger.

Error code classes and descriptions​

ClassDescription
DL-LEDGER-3xxxxErrors for the validation error category
DL-LEDGER-4xxxxErrors for the user error category
DL-LEDGER-5xxxxErrors for the internal error category

DL-LEDGER-3xxxx status codes​

The following are status codes and messages for the validation error category.

DL-LEDGER-300001​

Message

Validation failed for the hash.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-301001​

Message

Validation failed for the previous hash.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-302001​

Message

Validation failed for the contract.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-303001​

Message

Validation failed for the output. Recomputed: %s; Stored: %s

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-304001​

Message

Validation failed for nonce. %s contains the nonce '%s' more than once.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-305001​

Message

The specified asset and the asset metadata are inconsistent.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-305002​

Message

The asset specified by input dependencies is not found.

Solution

Data or program tampering, or a software bug, may have occurred. Contact your system administrator to check for any signs of malicious activity.

DL-LEDGER-4xxxx status codes​

The following are status codes and messages for the user error category.

DL-LEDGER-400001​

Message

The request signature can't be validated.

Solution

Verify that the certificate used to sign the request is registered and valid.

DL-LEDGER-400002​

Message

The request signature from Auditor can't be validated.

Solution

Verify that the certificate used by Auditor is registered and valid.

DL-LEDGER-407001​

Message

The specified contract class is not allowed to be executed.

Solution

Verify the contract binary name and ensure it is listed in the configuration file specified by scalar.dl.ledger.executable_contracts.

DL-LEDGER-407002​

Message

A configuration mismatch is detected. Check the Auditor setting in the client or Ledger.

Solution

Verify that the Auditor settings in the client and Ledger configurations are consistent.

DL-LEDGER-407003​

Message

The Auditor signature must be included in the request when Auditor is enabled.

Solution

Verify that the Auditor settings in the client and Ledger configurations are consistent.

DL-LEDGER-407004​

Message

%s must be enabled to make auditing work.

Solution

Verify that the Auditor settings in the client and Ledger configurations are consistent.

DL-LEDGER-407005​

Message

Registering a function via a non-privileged port is not allowed. Use a privileged port or enable %s.

Solution

Use a privileged port for function registration, or enable the appropriate configuration property to allow function registration from non-privileged ports.

DL-LEDGER-407006​

Message

Overwriting an existing function is not allowed. Enable %s to allow overwriting.

Solution

Enable the function overwrite configuration property to allow overwriting existing functions.

DL-LEDGER-409001​

Message

The specified asset is not found.

Solution

Verify the asset ID and namespace are correct and the asset has been created.

DL-LEDGER-410001​

Message

The specified function is not found.

Solution

Register the function first before executing it.

DL-LEDGER-411001​

Message

Loading the function failed. Details: %s

Solution

Check the error details and verify that the function class is valid and accessible.

DL-LEDGER-412001​

Message

The function is not allowed to access the specified namespace.

Solution

Functions cannot access system namespaces or namespaces with reserved prefixes. Disallowed namespaces: system, system_schema, system_auth, system_distributed, system_traces, coordinator. Disallowed namespace prefixes: scalar, auditor. Use a different namespace for your function operations.

DL-LEDGER-412002​

Message

The database operation in the function failed. Details: %s

Solution

Verify that the arguments passed to the database operation are valid and correct.

DL-LEDGER-414001​

Message

%s must be set if HMAC authentication is used.

Solution

Set the cipher key configuration property for HMAC authentication.

DL-LEDGER-414002​

Message

%s must be set to true if Auditor is enabled.

Solution

Set the proof configuration property to true when Auditor is enabled.

DL-LEDGER-414003​

Message

Authentication between Ledger and Auditor is not correctly configured. Set a private key with %s or %s if you use digital signature authentication with Auditor enabled.

Solution

Set the private key configuration property for digital signature authentication between Ledger and Auditor.

DL-LEDGER-414004​

Message

Authentication between Ledger and Auditor is not correctly configured. Set %s if you use HMAC authentication with Auditor enabled.

Solution

Set the required configuration property for HMAC authentication between Ledger and Auditor.

DL-LEDGER-414005​

Message

Either %s or %s must be set if proof is enabled.

Solution

Set either the private key PEM or path configuration property when proof is enabled.

DL-LEDGER-414006​

Message

%s must be set to true when using the JDBC transaction manager in the Auditor mode.

Solution

Set the transaction state management configuration property to true when using JDBC transaction manager in Auditor mode.

DL-LEDGER-414007​

Message

%s must be disabled when using the Consensus Commit transaction manager for performance reasons.

Solution

Set the transaction state management configuration property to false when using Consensus Commit transaction manager.

DL-LEDGER-414008​

Message

%s must be disabled because group commit is not supported.

Solution

Set the group commit configuration property to false as it is not supported.

DL-LEDGER-5xxxx status codes​

The following are status codes and messages for the internal error category.

DL-LEDGER-500001​

Message

Binding the function failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500002​

Message

Unbinding the function failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500003​

Message

Getting the function failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500004​

Message

Starting a transaction failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500005​

Message

Getting the transaction state failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500006​

Message

Putting or committing asset records failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500007​

Message

Aborting the transaction failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500008​

Message

Retrieving the asset records failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500009​

Message

Retrieving the asset metadata failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500010​

Message

Putting the asset metadata failed. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-500011​

Message

The database operation in the function failed due to a database error. Details: %s

Solution

Check the error details in the logs and verify your database configuration and connection.

DL-LEDGER-501001​

Message

The asset status is unknown. Details: %s

Solution

Check the asset status manually and review the error details in the logs.

DL-LEDGER-502001​

Message

The function type or instance is not supported.

Solution

Check the error details in the logs and verify that the function type is supported.

DL-LEDGER-504001​

Message

The transaction state has already been %s.

Solution

Retry the operation.

DL-LEDGER-504002​

Message

Retrieving the asset records failed due to a conflict. Details: %s

Solution

Retry the operation.

DL-LEDGER-504003​

Message

Putting the asset records failed due to a conflict. Details: %s

Solution

Retry the operation.

DL-LEDGER-504004​

Message

Committing the asset records failed due to a conflict. Details: %s

Solution

Retry the operation.

DL-LEDGER-504005​

Message

Retrieving the asset metadata failed due to a conflict. Details: %s

Solution

Retry the operation.

DL-LEDGER-504006​

Message

Putting the asset metadata failed due to a conflict. Details: %s

Solution

Retry the operation.

DL-LEDGER-504007​

Message

The database operation in the function failed due to a conflict. Details: %s

Solution

Retry the operation.