---
type: Troubleshooting
title: ScalarDL Auditor Error Codes
description: This page provides a list of error codes in ScalarDL Auditor.
resource: https://scalardl.scalar-labs.com/docs/3.10/scalardl-auditor-status-codes/
tags:
- scalardl
- v3.10
- phase:operate
- section:troubleshoot
- edition:enterprise
- unmaintained
status: deprecated
product: scalardl
product_title: ScalarDL
version: '3.10'
patch_version: 3.10.5
doc_id: scalardl-auditor-status-codes
lifecycle_phase: operate
breadcrumb:
- Troubleshoot
editions:
- Enterprise
generated:
  by: process:okf-build/1.0.0
  at: '2026-08-04T23:51:03Z'
sources:
- id: docs-scalardl
  resource: https://github.com/scalar-labs/docs-scalardl/blob/c1dbc91f4c36ec4ce63e7181302c89b7b6669e62/versioned_docs/version-3.10/scalardl-auditor-status-codes.mdx
  title: ScalarDL documentation source (MDX)
  author: process:scalar-labs/docs-scalardl
  last_modified: '2026-08-04T15:05:14Z'
---

# ScalarDL Auditor Error Codes

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

## Error code classes and descriptions

| Class              | Description                              |
|:-------------------|:-----------------------------------------|
| `DL-AUDITOR-3xxxx` | Errors for the validation error category |
| `DL-AUDITOR-4xxxx` | Errors for the user error category       |
| `DL-AUDITOR-5xxxx` | Errors for the internal error category   |

## `DL-AUDITOR-3xxxx` status codes

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

### `DL-AUDITOR-304001`

**Message**

```markdown
The nonce has already been used.
```

**Solution**

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

### `DL-AUDITOR-305001`

**Message**

```markdown
The request has been tampered with.
```

**Solution**

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

### `DL-AUDITOR-305002`

**Message**

```markdown
The specified asset proof doesn't exist in Ledger.
```

**Solution**

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

### `DL-AUDITOR-305003`

**Message**

```markdown
The specified request proof doesn't exist.
```

**Solution**

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

### `DL-AUDITOR-305004`

**Message**

```markdown
Hash validation failed.
```

**Solution**

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

### `DL-AUDITOR-305005`

**Message**

```markdown
The specified lock entry doesn't exist. A bug might exist, or tampering might have occurred.
```

**Solution**

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

### `DL-AUDITOR-305006`

**Message**

```markdown
An invalid asset proof is given for %s.
```

**Solution**

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

### `DL-AUDITOR-305007`

**Message**

```markdown
The expected asset record doesn't exist.
```

**Solution**

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

### `DL-AUDITOR-305008`

**Message**

```markdown
The specified asset and the asset lock are inconsistent.
```

**Solution**

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

### `DL-AUDITOR-305009`

**Message**

```markdown
The specified lock type is not supported. Type: %s
```

**Solution**

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

### `DL-AUDITOR-305010`

**Message**

```markdown
readUnlock is used for unlocked or write-locked assets.
```

**Solution**

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

### `DL-AUDITOR-305011`

**Message**

```markdown
writeUnlock is used for unlocked or read-locked assets.
```

**Solution**

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

## `DL-AUDITOR-4xxxx` status codes

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

### `DL-AUDITOR-407001`

**Message**

```markdown
The lock must be validated before it can be released.
```

**Solution**

```markdown
Validate the lock before attempting to release it.
```

### `DL-AUDITOR-409001`

**Message**

```markdown
The specified asset is not found.
```

**Solution**

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

### `DL-AUDITOR-414001`

**Message**

```markdown
%s must be set if HMAC authentication is used.
```

**Solution**

```markdown
Set 'scalar.dl.auditor.authentication.hmac.cipher_key' in the Auditor configuration file (e.g., auditor.properties). Use an unpredictable and long value for security.
```

### `DL-AUDITOR-414002`

**Message**

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

**Solution**

```markdown
For digital signature authentication, set these properties in auditor.properties: 'scalar.dl.auditor.cert_holder_id' and either 'scalar.dl.auditor.private_key_path' (path to PEM file) or 'scalar.dl.auditor.private_key_pem' (PEM-encoded data). Ensure the authentication method matches the Ledger configuration.
```

### `DL-AUDITOR-414003`

**Message**

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

**Solution**

```markdown
For HMAC authentication between Ledger and Auditor, set 'scalar.dl.auditor.servers.authentication.hmac.secret_key' in auditor.properties with a shared secret. This must match the Ledger's corresponding HMAC secret key.
```

## `DL-AUDITOR-5xxxx` status codes

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

### `DL-AUDITOR-500001`

**Message**

```markdown
Binding the request proof failed. Details: %s
```

**Solution**

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

### `DL-AUDITOR-500002`

**Message**

```markdown
Getting the request proof failed. Details: %s
```

**Solution**

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

### `DL-AUDITOR-500003`

**Message**

```markdown
Binding the asset record failed. Details: %s
```

**Solution**

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

### `DL-AUDITOR-500004`

**Message**

```markdown
Retrieving the asset records failed. Details: %s
```

**Solution**

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

### `DL-AUDITOR-500005`

**Message**

```markdown
Getting the asset lock for %s failed. Details: %s
```

**Solution**

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

### `DL-AUDITOR-504001`

**Message**

```markdown
The specified lock entry is currently held by a writer.
```

**Solution**

```markdown
Retry the operation.
```

### `DL-AUDITOR-504002`

**Message**

```markdown
The specified asset record is in use.
```

**Solution**

```markdown
Retry the operation.
```

### `DL-AUDITOR-504003`

**Message**

```markdown
The entry has already been recovered, or an issue might have occurred.
```

**Solution**

```markdown
Retry the operation. Contact your system administrator to check for any signs of malicious activity if the issue persists.
```
