ScalarDL Common Error Codes
This page provides a list of error codes common across ScalarDL.
Error code classes and descriptions​
| Class | Description |
|---|---|
DL-COMMON-3xxxx | Errors for the validation error category |
DL-COMMON-4xxxx | Errors for the user error category |
DL-COMMON-5xxxx | Errors 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.