Skip to main content
Version: 3.14

ScalarDL Common Error Codes

This page provides a list of error codes common across ScalarDL.

Error code classes and descriptions​

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

DL-COMMON-3xxxx status codes​

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

DL-COMMON-302001​

Message

The format of the contract ID is invalid.

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-COMMON-302002​

Message

Contract validation failed. A bug might exist, or tampering might have occurred.

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-COMMON-305001​

Message

An unexpected record value is observed. A bug might exist, or tampering might have occurred. Details: %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-COMMON-4xxxx status codes​

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

DL-COMMON-400001​

Message

Signing failed. Details: %s

Solution

Verify that your private key is valid and accessible. Check the error details for specific issues.

DL-COMMON-400002​

Message

Validating signature failed. Details: %s

Solution

Verify that the certificate matches the private key used for signing and that both are valid.

DL-COMMON-400003​

Message

The request signature can't be validated.

Solution

Verify that the certificate used for signing the request is registered and matches the private key.

DL-COMMON-400004​

Message

The proof signature can't be validated.

Solution

Verify that the proof configuration is correct and that the certificate used for signing is valid.

DL-COMMON-401001​

Message

Loading the key failed. Details: %s

Solution

If using a key file, verify that it exists at the specified path, is readable, and has the correct format. If using a PEM-formatted string, verify that the key has the correct format.

DL-COMMON-401002​

Message

Loading the certificate failed. Details: %s

Solution

If using a certificate file, verify that it exists at the specified path, is readable, and has the correct format. If using a PEM-formatted string, verify that the certificate has the correct format.

DL-COMMON-401003​

Message

Creating a cipher key failed. Details: %s

Solution

Verify that the cipher configuration is correct and that the key material is valid.

DL-COMMON-401004​

Message

Invalid private key. File: %s

Solution

Provide a valid private key file in PEM format at the specified path.

DL-COMMON-401005​

Message

Invalid certificate. File: %s

Solution

Provide a valid certificate file in PEM format at the specified path.

DL-COMMON-401006​

Message

Reading the private key failed. File: %s; Details: %s

Solution

Verify that the private key file exists, is readable, and has the correct permissions and format.

DL-COMMON-401007​

Message

Reading the certificate failed. File: %s; Details: %s

Solution

Verify that the certificate file exists, is readable, and has the correct permissions and format.

DL-COMMON-401008​

Message

Creating a key store failed. Details: %s

Solution

Verify that the key store configuration is correct and that all required files are accessible.

DL-COMMON-402001​

Message

Loading the contract failed. Details: %s

Solution

Verify that the contract class is valid and all dependencies are available. Check the error details for specific issues.

DL-COMMON-403001​

Message

The specified certificate is not found.

Solution

Before using the certificate, register it by using the register-cert command.

DL-COMMON-404001​

Message

The specified contract is not found.

Solution

Before executing the contract, register it by using the register-contract command.

DL-COMMON-405001​

Message

The specified certificate is already registered.

Solution

Use the existing certificate or register it with a new version number.

DL-COMMON-406001​

Message

The specified contract is already registered.

Solution

Use the existing contract or register it with a different contract ID.

DL-COMMON-406002​

Message

The specified contract binary name has been already registered with a different byte code.

Solution

Use a different contract ID or class name to register this version of the contract.

DL-COMMON-407001​

Message

Accessing the specified namespace is not allowed. Namespace: %s, context namespace: %s

Solution

Verify that your certificate or secret has been registered to the specified namespace, or use the appropriate context namespace for your operation.

DL-COMMON-413001​

Message

The specified secret is already registered.

Solution

Use the existing secret or register it with a new version number.

DL-COMMON-414001​

Message

The specified value of the property '%s' is not a number. Value: %s

Solution

Set the property to a valid numeric value in your configuration.

DL-COMMON-414002​

Message

The specified value of the property '%s' is not a boolean. Value: %s

Solution

Set the property to 'true' or 'false' in your configuration.

DL-COMMON-414003​

Message

Reading the file failed. File: %s

Solution

Verify that the file exists at the specified path and is readable.

DL-COMMON-414004​

Message

Please set your license key to %s.

Solution

Set your license key to the specified configuration property.

DL-COMMON-414005​

Message

Please set your certificate for checking the corresponding license key to %s or %s.

Solution

Set your certificate to one of the specified configuration properties.

DL-COMMON-414006​

Message

The license key is not for the product '%s'. Please set the correct license key.

Solution

Set the correct license key for the product in your configuration.

DL-COMMON-414007​

Message

The license type of the license key must be ENTERPRISE or TRIAL. Please set the correct license key.

Solution

Set a valid ENTERPRISE or TRIAL license key in your configuration.

DL-COMMON-414008​

Message

The port and privileged port must be greater than or equal to zero.

Solution

Set the port and privileged port to valid values (>= 0) in your configuration.

DL-COMMON-414009​

Message

The private key and certificate are required.

Solution

Provide both the private key and certificate in your configuration.

DL-COMMON-414010​

Message

The certificate version must be greater than zero.

Solution

Set the certificate version to a value greater than zero.

DL-COMMON-414011​

Message

A secret key is required for HMAC authentication.

Solution

Provide a secret key in your configuration for HMAC authentication.

DL-COMMON-414012​

Message

The secret version for HMAC authentication must be greater than zero.

Solution

Set the secret version to a value greater than zero.

DL-COMMON-414013​

Message

The grpc deadline duration must be greater than or equal to zero.

Solution

Set the gRPC deadline duration to a value greater than or equal to zero in your configuration.

DL-COMMON-414014​

Message

The grpc max inbound message size must be greater than or equal to zero.

Solution

Set the gRPC max inbound message size to a value greater than or equal to zero in your configuration.

DL-COMMON-414015​

Message

The grpc max inbound metadata size must be greater than or equal to zero.

Solution

Set the gRPC max inbound metadata size to a value greater than or equal to zero in your configuration.

DL-COMMON-414016​

Message

The authentication method name is invalid. Name: %s

Solution

Set the authentication method to a valid value (like 'digital-signature' or 'hmac') in your configuration.

DL-COMMON-414017​

Message

The argument format is illegal.

Solution

Provide the argument in the correct format. Check the documentation for the expected format.

DL-COMMON-414018​

Message

The deserialization type is not supported. Type: %s

Solution

Use a supported deserialization type. Check the documentation for valid types.

DL-COMMON-414019​

Message

The namespace name is invalid. Name: %s

Solution

Provide a valid namespace name that meets the naming requirements.

DL-COMMON-414020​

Message

Namespace-aware interfaces are not supported in deprecated contracts.

Solution

Use the non-namespace-aware interfaces or migrate to the newer contract interfaces that support namespaces.

DL-COMMON-414021​

Message

The specified namespace is reserved and cannot be created or deleted. Name: %s

Solution

Use a different namespace name that is not reserved. Reserved namespaces are managed by the system and cannot be modified.

DL-COMMON-415001​

Message

The specified secret is not found.

Solution

Before using the secret, register it by using the register-secret command.

DL-COMMON-416001​

Message

The specified namespace already exists.

Solution

Use the existing namespace or choose a different namespace name.

DL-COMMON-417001​

Message

The specified namespace is not found. Namespace: %s

Solution

Create the namespace first or verify that the namespace name is correct.

DL-COMMON-5xxxx status codes​

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

DL-COMMON-500001​

Message

Binding the certificate failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500002​

Message

Unbinding the certificate failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500003​

Message

Getting the certificate failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500004​

Message

Binding the secret key failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500005​

Message

Unbinding the secret key failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500006​

Message

Getting the secret key failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500007​

Message

Binding the contract failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500008​

Message

Getting the contract failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500009​

Message

Scanning the contracts failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500010​

Message

Creating the namespace table failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500011​

Message

Creating the namespace failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500012​

Message

Scanning the namespaces failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500013​

Message

Dropping the namespace failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500014​

Message

Reading the lease failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500015​

Message

Acquiring or renewing the lease failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500016​

Message

Creating the lease table failed. Details: %s

Solution

Check the database connection and ensure the database is accessible. Review the error details for more information.

DL-COMMON-500017​

Message

The lease table does not exist.

Solution

Create the lease table by running Schema Loader. It is also created automatically on the next coordination round if the database user has permission to create tables.

DL-COMMON-502001​

Message

Serializing the specified json failed. Details: %s

Solution

Check the error details and verify that the data structure is valid for JSON serialization.

DL-COMMON-502002​

Message

Deserializing the specified json string failed. Details: %s

Solution

Check the error details and verify that the JSON string is valid and well-formed.

DL-COMMON-502003​

Message

The required fields are not specified.

Solution

Provide all required fields in your request.

DL-COMMON-502004​

Message

The metadata is not available since the asset has not been committed yet.

Solution

Commit the asset before accessing its metadata.

DL-COMMON-502005​

Message

The specified transaction state is invalid.

Solution

Check the error details in the logs and verify the transaction state.

DL-COMMON-502006​

Message

The contract type or instance is not supported.

Solution

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

DL-COMMON-502007​

Message

The specified lock recovery result is invalid.

Solution

Check the error details in the logs and verify the lock recovery result.