commit 3d4e32f3102b06e737e7d500cfa499b8374cad7b
parent a20eac9cf4150d1093df48cae9d01ec7ff0b7bde
Author: Christian Grothoff <christian@grothoff.org>
Date: Wed, 12 Nov 2025 21:52:47 +0100
fix #10590
Diffstat:
1 file changed, 48 insertions(+), 48 deletions(-)
diff --git a/gnu-taler-error-codes/registry.rec b/gnu-taler-error-codes/registry.rec
@@ -25,60 +25,60 @@
# 0 - 99: Reserved for GENERIC error codes
-Value: 0000
+Value: 0
Name: NONE
Description: Special code to indicate success (no error).
HttpStatus: 0
# We could not get the error code.
-Value: 0001
+Value: 1
Name: INVALID
Description: An error response did not include an error code in the format expected by the client. Most likely, the server does not speak the GNU Taler protocol. Check the URL and/or the network connection to the server.
HttpStatus: 0
-Value: 0002
+Value: 2
Name: GENERIC_CLIENT_INTERNAL_ERROR
Description: An internal failure happened on the client side. Details should be in the local logs. Check if you are using the latest available version or file a report with the developers.
HttpStatus: 0
-Value: 0003
+Value: 3
Name: GENERIC_CLIENT_UNSUPPORTED_PROTOCOL_VERSION
Description: The client does not support the protocol version advertised by the server.
HttpStatus: 0
# Fundamental problems detected client-side (10-19)
-Value: 0010
+Value: 10
Name: GENERIC_INVALID_RESPONSE
Description: The response we got from the server was not in the expected format. Most likely, the server does not speak the GNU Taler protocol. Check the URL and/or the network connection to the server.
HttpStatus: 0
-Value: 0011
+Value: 11
Name: GENERIC_TIMEOUT
Description: The operation timed out. Trying again might help. Check the network connection.
HttpStatus: 0
-Value: 0012
+Value: 12
Name: GENERIC_VERSION_MALFORMED
Description: The protocol version given by the server does not follow the required format. Most likely, the server does not speak the GNU Taler protocol. Check the URL and/or the network connection to the server.
HttpStatus: 0
-Value: 0013
+Value: 13
Name: GENERIC_REPLY_MALFORMED
Description: The service responded with a reply that was in the right data format, but the content did not satisfy the protocol. Please file a bug report.
HttpStatus: 0
-Value: 0014
+Value: 14
Name: GENERIC_CONFIGURATION_INVALID
Description: There is an error in the client-side configuration, for example an option is set to an invalid value. Check the logs and fix the local configuration.
HttpStatus: 0
-Value: 0015
+Value: 15
Name: GENERIC_UNEXPECTED_REQUEST_ERROR
Description: The client made a request to a service, but received an error response it does not know how to handle. Please file a bug report.
HttpStatus: 0
-Value: 0016
+Value: 16
Name: GENERIC_TOKEN_PERMISSION_INSUFFICIENT
Description: The token used by the client to authorize the request does not grant the required permissions for the request. Check the requirements and obtain a suitable authorization token to proceed.
HttpStatus: 403
@@ -86,53 +86,53 @@ HttpStatus: 403
# Fundamental client-side protocol problems (20-29)
# (fundamental: cannot be helped, client is very broken)
-Value: 0020
+Value: 20
Name: GENERIC_METHOD_INVALID
Description: The HTTP method used is invalid for this endpoint. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 405
-Value: 0021
+Value: 21
Name: GENERIC_ENDPOINT_UNKNOWN
Description: There is no endpoint defined for the URL provided by the client. Check if you used the correct URL and/or file a report with the developers of the client software.
HttpStatus: 404
-Value: 0022
+Value: 22
Name: GENERIC_JSON_INVALID
Description: The JSON in the client's request was malformed. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 400
-Value: 0023
+Value: 23
Name: GENERIC_HTTP_HEADERS_MALFORMED
Description: Some of the HTTP headers provided by the client were malformed and caused the server to not be able to handle the request. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 400
-Value: 0024
+Value: 24
Name: GENERIC_PAYTO_URI_MALFORMED
Description: The payto:// URI provided by the client is malformed. Check that you are using the correct syntax as of RFC 8905 and/or that you entered the bank account number correctly.
HttpStatus: 400
-Value: 0025
+Value: 25
Name: GENERIC_PARAMETER_MISSING
Description: A required parameter in the request was missing. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 400
-Value: 0026
+Value: 26
Name: GENERIC_PARAMETER_MALFORMED
Description: A parameter in the request was malformed. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 400
-Value: 0027
+Value: 27
Name: GENERIC_RESERVE_PUB_MALFORMED
Description: The reserve public key was malformed.
HttpStatus: 400
FIXME: Fold with 26?
-Value: 0028
+Value: 28
Name: GENERIC_COMPRESSION_INVALID
Description: The body in the request could not be decompressed by the server. This is likely a bug in the client implementation. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 400
-Value: 0029
+Value: 29
Name: GENERIC_PATH_SEGMENT_MALFORMED
Description: A segment in the path of the URL provided by the client is malformed. Check that you are using the correct encoding for the URL.
HttpStatus: 400
@@ -140,81 +140,81 @@ HttpStatus: 400
# Circumstantial client-side protocol problems (30-39)
# (Circumstantial == may work with another server, but not this one)
-Value: 0030
+Value: 30
Name: GENERIC_CURRENCY_MISMATCH
Description: The currency involved in the operation is not acceptable for this server. Check your configuration and make sure the currency specified for a given service provider is one of the currencies supported by that provider.
HttpStatus: 400
-Value: 0031
+Value: 31
Name: GENERIC_URI_TOO_LONG
Description: The URI is longer than the longest URI the HTTP server is willing to parse. If you believe this was a legitimate request, contact the server administrators and/or the software developers to increase the limit.
HttpStatus: 414
-Value: 0032
+Value: 32
Name: GENERIC_UPLOAD_EXCEEDS_LIMIT
Description: The body is too large to be permissible for the endpoint. If you believe this was a legitimate request, contact the server administrators and/or the software developers to increase the limit.
HttpStatus: 413
# 40-49: access control issues
-Value: 0040
+Value: 40
Name: GENERIC_UNAUTHORIZED
Description: The service refused the request due to lack of proper authorization. Accessing this endpoint requires an access token from the account owner.
HttpStatus: 401
-Value: 0041
+Value: 41
Name: GENERIC_TOKEN_UNKNOWN
Description: The service refused the request as the given authorization token is unknown. You should request a valid access token from the account owner.
HttpStatus: 401
-Value: 0042
+Value: 42
Name: GENERIC_TOKEN_EXPIRED
Description: The service refused the request as the given authorization token expired. You should request a fresh authorization token from the account owner.
HttpStatus: 401
-Value: 0043
+Value: 43
Name: GENERIC_TOKEN_MALFORMED
Description: The service refused the request as the given authorization token is invalid or malformed. You should check that you have the right credentials.
HttpStatus: 401
-Value: 0044
+Value: 44
Name: GENERIC_FORBIDDEN
Description: The service refused the request due to lack of proper rights on the resource. You may need different credentials to be allowed to perform this operation.
HttpStatus: 403
# Server-side database problems (50-59)
-Value: 0050
+Value: 50
Name: GENERIC_DB_SETUP_FAILED
Description: The service failed initialize its connection to the database. The system administrator should check that the service has permissions to access the database and that the database is running.
HttpStatus: 500
-Value: 0051
+Value: 51
Name: GENERIC_DB_START_FAILED
Description: The service encountered an error event to just start the database transaction. The system administrator should check that the database is running.
HttpStatus: 500
-Value: 0052
+Value: 52
Name: GENERIC_DB_STORE_FAILED
Description: The service failed to store information in its database. The system administrator should check that the database is running and review the service logs.
HttpStatus: 500
-Value: 0053
+Value: 53
Name: GENERIC_DB_FETCH_FAILED
Description: The service failed to fetch information from its database. The system administrator should check that the database is running and review the service logs.
HttpStatus: 500
-Value: 0054
+Value: 54
Name: GENERIC_DB_COMMIT_FAILED
Description: The service encountered an unrecoverable error trying to commit a transaction to the database. The system administrator should check that the database is running and review the service logs.
HttpStatus: 500
-Value: 0055
+Value: 55
Name: GENERIC_DB_SOFT_FAILURE
Description: The service encountered an error event to commit the database transaction, even after repeatedly retrying it there was always a conflicting transaction. This indicates a repeated serialization error; it should only happen if some client maliciously tries to create conflicting concurrent transactions. It could also be a sign of a missing index. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 500
-Value: 0056
+Value: 56
Name: GENERIC_DB_INVARIANT_FAILURE
Description: The service's database is inconsistent and violates service-internal invariants. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 500
@@ -222,17 +222,17 @@ HttpStatus: 500
# Server-side computational problems (60-69)
-Value: 0060
+Value: 60
Name: GENERIC_INTERNAL_INVARIANT_FAILURE
Description: The HTTP server experienced an internal invariant failure (bug). Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 500
-Value: 0061
+Value: 61
Name: GENERIC_FAILED_COMPUTE_JSON_HASH
Description: The service could not compute a cryptographic hash over some JSON value. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 500
-Value: 0062
+Value: 62
Name: GENERIC_FAILED_COMPUTE_AMOUNT
Description: The service could not compute an amount. Check if you are using the latest available version and/or file a report with the developers.
HttpStatus: 500
@@ -240,46 +240,46 @@ HttpStatus: 500
# Server-side resource problems (70-79)
-Value: 0070
+Value: 70
Name: GENERIC_PARSER_OUT_OF_MEMORY
Description: The HTTP server had insufficient memory to parse the request. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
HttpStatus: 500
-Value: 0071
+Value: 71
Name: GENERIC_ALLOCATION_FAILURE
Description: The HTTP server failed to allocate memory. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
HttpStatus: 500
-Value: 0072
+Value: 72
Name: GENERIC_JSON_ALLOCATION_FAILURE
Description: The HTTP server failed to allocate memory for building JSON reply. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
HttpStatus: 500
-Value: 0073
+Value: 73
Name: GENERIC_CURL_ALLOCATION_FAILURE
Description: The HTTP server failed to allocate memory for making a CURL request. Restarting services periodically can help, especially if Postgres is using excessive amounts of memory. Check with the system administrator to investigate.
HttpStatus: 500
-Value: 0074
+Value: 74
Name: GENERIC_FAILED_TO_LOAD_TEMPLATE
Description: The backend could not locate a required template to generate an HTML reply. The system administrator should check if the resource files are installed in the correct location and are readable to the service.
HttpStatus: 406
-Value: 0075
+Value: 75
Name: GENERIC_FAILED_TO_EXPAND_TEMPLATE
Description: The backend could not expand the template to generate an HTML reply. The system administrator should investigate the logs and check if the templates are well-formed.
HttpStatus: 500
-Value: 0076
+Value: 76
Name: GENERIC_FEATURE_NOT_IMPLEMENTED
Description: The requested feature is not implemented by the server. The system administrator of the server may try to update the software or build it with other options to enable the feature.
HttpStatus: 501
-# 0080-0099: available for future use
+# 80-99: available for future use
-# 0100 - 0999: VERBOTEN due to confusion with HTTP status codes (at least 100-599).
+# 100 - 999: VERBOTEN due to confusion with HTTP status codes (at least 100-599).
# 1000 - 1999: Reserved for exchange
# 1000 - 1099: Reserved for EXCHANGE_GENERIC
