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-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.