diff options
Diffstat (limited to 'wallet/src/main/java/net/taler/wallet/backend')
8 files changed, 4318 insertions, 415 deletions
diff --git a/wallet/src/main/java/net/taler/wallet/backend/ApiResponse.kt b/wallet/src/main/java/net/taler/wallet/backend/ApiResponse.kt new file mode 100644 index 0000000..def4668 --- /dev/null +++ b/wallet/src/main/java/net/taler/wallet/backend/ApiResponse.kt @@ -0,0 +1,63 @@ +/* + * This file is part of GNU Taler + * (C) 2023 Taler Systems S.A. + * + * GNU Taler is free software; you can redistribute it and/or modify it under the + * terms of the GNU General Public License as published by the Free Software + * Foundation; either version 3, or (at your option) any later version. + * + * GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY + * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR + * A PARTICULAR PURPOSE. See the GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along with + * GNU Taler; see the file COPYING. If not, see <http://www.gnu.org/licenses/> + */ + +package net.taler.wallet.backend + +import kotlinx.serialization.SerialName +import kotlinx.serialization.Serializable +import kotlinx.serialization.json.JsonObject +import net.taler.wallet.events.ObservabilityEvent + +@Serializable +sealed class ApiMessage { + + @Serializable + @SerialName("notification") + data class Notification( + val payload: NotificationPayload, + ) : ApiMessage() + +} + +@Serializable +data class NotificationPayload( + val type: String, + val id: String? = null, + val event: ObservabilityEvent? = null, +) + +@Serializable +sealed class ApiResponse : ApiMessage() { + + abstract val id: Int + abstract val operation: String + + @Serializable + @SerialName("response") + data class Response( + override val id: Int, + override val operation: String, + val result: JsonObject, + ) : ApiResponse() + + @Serializable + @SerialName("error") + data class Error( + override val id: Int, + override val operation: String, + val error: JsonObject, + ) : ApiResponse() +} diff --git a/wallet/src/main/java/net/taler/wallet/backend/BackendManager.kt b/wallet/src/main/java/net/taler/wallet/backend/BackendManager.kt new file mode 100644 index 0000000..9292ef5 --- /dev/null +++ b/wallet/src/main/java/net/taler/wallet/backend/BackendManager.kt @@ -0,0 +1,95 @@ +/* + * This file is part of GNU Taler + * (C) 2022 Taler Systems S.A. + * + * GNU Taler is free software; you can redistribute it and/or modify it under the + * terms of the GNU General Public License as published by the Free Software + * Foundation; either version 3, or (at your option) any later version. + * + * GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY + * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR + * A PARTICULAR PURPOSE. See the GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along with + * GNU Taler; see the file COPYING. If not, see <http://www.gnu.org/licenses/> + */ + +package net.taler.wallet.backend + +import android.util.Log +import kotlinx.serialization.json.Json +import net.taler.qtart.TalerWalletCore +import net.taler.wallet.BuildConfig +import org.json.JSONObject +import java.util.concurrent.atomic.AtomicBoolean +import kotlin.coroutines.resume +import kotlin.coroutines.suspendCoroutine + + +fun interface NotificationReceiver { + fun onNotificationReceived(payload: NotificationPayload) +} + +class BackendManager( + private val notificationReceiver: NotificationReceiver, +) { + + companion object { + private const val TAG = "BackendManager" + private const val TAG_CORE = "taler-wallet-embedded" + val json = Json { + ignoreUnknownKeys = true + coerceInputValues = true + } + @JvmStatic + private val initialized = AtomicBoolean(false) + } + + private val walletCore = TalerWalletCore() + private val requestManager = RequestManager() + + init { + // TODO using Dagger/Hilt and @Singleton would be nice as well + if (initialized.getAndSet(true)) error("Already initialized") + walletCore.setMessageHandler { onMessageReceived(it) } + walletCore.setCurlHttpClient() + if (BuildConfig.DEBUG) walletCore.setStdoutHandler { + Log.d(TAG_CORE, it) + } + } + + fun run() { + walletCore.run() + } + + suspend fun send(operation: String, args: JSONObject? = null): ApiResponse = + suspendCoroutine { cont -> + requestManager.addRequest(cont) { id -> + val request = JSONObject().apply { + put("id", id) + put("operation", operation) + if (args != null) put("args", args) + } + Log.d(TAG, "sending message:\n${request.toString(2)}") + walletCore.sendRequest(request.toString()) + } + } + + private fun onMessageReceived(msg: String) { + Log.d(TAG, "message received: $msg") + when (val message = json.decodeFromString<ApiMessage>(msg)) { + is ApiMessage.Notification -> { + notificationReceiver.onNotificationReceived(message.payload) + } + is ApiResponse -> { + val id = message.id + val cont = requestManager.getAndRemoveContinuation(id) + if (cont == null) { + Log.e(TAG, "wallet returned unknown request ID ($id)") + } else { + cont.resume(message) + } + } + } + } +} diff --git a/wallet/src/main/java/net/taler/wallet/backend/InitResponse.kt b/wallet/src/main/java/net/taler/wallet/backend/InitResponse.kt new file mode 100644 index 0000000..7fe1a6b --- /dev/null +++ b/wallet/src/main/java/net/taler/wallet/backend/InitResponse.kt @@ -0,0 +1,84 @@ +/* + * This file is part of GNU Taler + * (C) 2023 Taler Systems S.A. + * + * GNU Taler is free software; you can redistribute it and/or modify it under the + * terms of the GNU General Public License as published by the Free Software + * Foundation; either version 3, or (at your option) any later version. + * + * GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY + * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR + * A PARTICULAR PURPOSE. See the GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along with + * GNU Taler; see the file COPYING. If not, see <http://www.gnu.org/licenses/> + */ + +package net.taler.wallet.backend + +import kotlinx.serialization.Serializable +import net.taler.wallet.exchanges.BuiltinExchange + +@Serializable +data class InitResponse( + val versionInfo: WalletCoreVersion, +) + +@Serializable +data class WalletRunConfig( + val builtin: Builtin? = Builtin(), + val testing: Testing? = Testing(), + val features: Features? = Features(), +) { + /** + * Initialization values useful for a complete startup. + * + * These are values may be overridden by different wallets + */ + @Serializable + data class Builtin( + val exchanges: List<BuiltinExchange> = emptyList(), + ) + + /** + * Unsafe options which it should only be used to create + * testing environment. + */ + @Serializable + data class Testing( + /** + * Allow withdrawal of denominations even though they are about to expire. + */ + val denomselAllowLate: Boolean = false, + val devModeActive: Boolean = false, + val insecureTrustExchange: Boolean = false, + val preventThrottling: Boolean = false, + val skipDefaults: Boolean = false, + val emitObservabilityEvents: Boolean? = false, + ) + + /** + * Configurations values that may be safe to show to the user + */ + @Serializable + data class Features( + val allowHttp: Boolean = false, + ) +} + +fun interface VersionReceiver { + fun onVersionReceived(versionInfo: WalletCoreVersion) +} + +@Serializable +data class WalletCoreVersion( + val implementationSemver: String, + val implementationGitHash: String, + val version: String, + val exchange: String, + val merchant: String, + val bankIntegrationApiRange: String, + val bankConversionApiRange: String, + val corebankApiRange: String, + val devMode: Boolean, +) diff --git a/wallet/src/main/java/net/taler/wallet/backend/RequestManager.kt b/wallet/src/main/java/net/taler/wallet/backend/RequestManager.kt new file mode 100644 index 0000000..041656e --- /dev/null +++ b/wallet/src/main/java/net/taler/wallet/backend/RequestManager.kt @@ -0,0 +1,44 @@ +/* + * This file is part of GNU Taler + * (C) 2023 Taler Systems S.A. + * + * GNU Taler is free software; you can redistribute it and/or modify it under the + * terms of the GNU General Public License as published by the Free Software + * Foundation; either version 3, or (at your option) any later version. + * + * GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY + * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR + * A PARTICULAR PURPOSE. See the GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along with + * GNU Taler; see the file COPYING. If not, see <http://www.gnu.org/licenses/> + */ + +package net.taler.wallet.backend + +import androidx.annotation.GuardedBy +import java.util.concurrent.ConcurrentHashMap +import kotlin.coroutines.Continuation + +class RequestManager { + + @GuardedBy("this") + private val contMap = ConcurrentHashMap<Int, Continuation<ApiResponse>>() + + @Volatile + @GuardedBy("this") + private var currentId = 0 + + @Synchronized + fun addRequest(cont: Continuation<ApiResponse>, block: (Int) -> Unit) { + val id = currentId++ + contMap[id] = cont + block(id) + } + + @Synchronized + fun getAndRemoveContinuation(id: Int): Continuation<ApiResponse>? { + return contMap.remove(id) + } + +} diff --git a/wallet/src/main/java/net/taler/wallet/backend/TalerErrorCode.kt b/wallet/src/main/java/net/taler/wallet/backend/TalerErrorCode.kt new file mode 100644 index 0000000..2242e33 --- /dev/null +++ b/wallet/src/main/java/net/taler/wallet/backend/TalerErrorCode.kt @@ -0,0 +1,3897 @@ +/* + This file is part of GNU Taler + Copyright (C) 2012-2020 Taler Systems SA + + GNU Taler is free software: you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as published + by the Free Software Foundation, either version 3 of the License, + or (at your option) any later version. + + GNU Taler is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public License + along with this program. If not, see <http://www.gnu.org/licenses/>. + + SPDX-License-Identifier: LGPL3.0-or-later + + Note: the LGPL does not apply to all components of GNU Taler, + but it does apply to this file. + */ +package net.taler.wallet.backend + +import kotlinx.serialization.ExperimentalSerializationApi +import kotlinx.serialization.KSerializer +import kotlinx.serialization.Serializable +import kotlinx.serialization.Serializer +import kotlinx.serialization.descriptors.PrimitiveKind +import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder + +@Serializable(TalerErrorCodeSerializer::class) +enum class TalerErrorCode(val code: Int) { + + UNKNOWN(-1), + + + /** + * Special code to indicate success (no error). + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + NONE(0), + + + /** + * A non-integer error code was returned in the JSON response. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + INVALID(1), + + + /** + * An internal failure happened on the client side. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_CLIENT_INTERNAL_ERROR(2), + + + /** + * The response we got from the server was not even in JSON format. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_INVALID_RESPONSE(10), + + + /** + * An operation timed out. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_TIMEOUT(11), + + + /** + * The version string given does not follow the expected CURRENT:REVISION:AGE Format. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_VERSION_MALFORMED(12), + + + /** + * The service responded with a reply that was in JSON but did not satsify the protocol. Note that invalid cryptographic signatures should have signature-specific error codes. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_REPLY_MALFORMED(13), + + + /** + * There is an error in the client-side configuration, for example the base URL specified is malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_CONFIGURATION_INVALID(14), + + + /** + * The client made a request to a service, but received an error response it does not know how to handle. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_UNEXPECTED_REQUEST_ERROR(15), + + + /** + * The HTTP method used is invalid for this endpoint. + * Returned with an HTTP status code of #MHD_HTTP_METHOD_NOT_ALLOWED (405). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_METHOD_INVALID(20), + + + /** + * There is no endpoint defined for the URL provided by the client. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_ENDPOINT_UNKNOWN(21), + + + /** + * The JSON in the client's request was malformed (generic parse error). + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_JSON_INVALID(22), + + + /** + * Some of the HTTP headers provided by the client caused the server to not be able to handle the request. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_HTTP_HEADERS_MALFORMED(23), + + + /** + * The payto:// URI provided by the client is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_PAYTO_URI_MALFORMED(24), + + + /** + * A required parameter in the request was missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_PARAMETER_MISSING(25), + + + /** + * A parameter in the request was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_PARAMETER_MALFORMED(26), + + + /** + * The reserve public key given as part of a /reserves/ endpoint was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_RESERVE_PUB_MALFORMED(27), + + + /** + * The currencies involved in the operation do not match. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_CURRENCY_MISMATCH(30), + + + /** + * The URI is longer than the longest URI the HTTP server is willing to parse. + * Returned with an HTTP status code of #MHD_HTTP_URI_TOO_LONG (414). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_URI_TOO_LONG(31), + + + /** + * The body is too large to be permissible for the endpoint. + * Returned with an HTTP status code of #MHD_HTTP_PAYLOAD_TOO_LARGE (413). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_UPLOAD_EXCEEDS_LIMIT(32), + + + /** + * The service failed initialize its connection to the database. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_SETUP_FAILED(50), + + + /** + * The service encountered an error event to just start the database transaction. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_START_FAILED(51), + + + /** + * The service failed to store information in its database. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_STORE_FAILED(52), + + + /** + * The service failed to fetch information from its database. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_FETCH_FAILED(53), + + + /** + * The service encountered an error event to commit the database transaction (hard, unrecoverable error). + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_COMMIT_FAILED(54), + + + /** + * 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; should only happen if some client maliciously tries to create conflicting concurrent transactions.) + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_SOFT_FAILURE(55), + + + /** + * The service's database is inconsistent and violates service-internal invariants. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_DB_INVARIANT_FAILURE(56), + + + /** + * The HTTP server experienced an internal invariant failure (bug). + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_INTERNAL_INVARIANT_FAILURE(60), + + + /** + * The service could not compute a cryptographic hash over some JSON value. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_FAILED_COMPUTE_JSON_HASH(61), + + + /** + * The service could not compute an amount. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_FAILED_COMPUTE_AMOUNT(62), + + + /** + * The HTTP server had insufficient memory to parse the request. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_PARSER_OUT_OF_MEMORY(70), + + + /** + * The HTTP server failed to allocate memory. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_ALLOCATION_FAILURE(71), + + + /** + * The HTTP server failed to allocate memory for building JSON reply. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_JSON_ALLOCATION_FAILURE(72), + + + /** + * The HTTP server failed to allocate memory for making a CURL request. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_CURL_ALLOCATION_FAILURE(73), + + + /** + * The backend could not locate a required template to generate an HTML reply. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_FAILED_TO_LOAD_TEMPLATE(74), + + + /** + * The backend could not expand the template to generate an HTML reply. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + GENERIC_FAILED_TO_EXPAND_TEMPLATE(75), + + + /** + * Exchange is badly configured and thus cannot operate. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_BAD_CONFIGURATION(1000), + + + /** + * Operation specified unknown for this endpoint. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_OPERATION_UNKNOWN(1001), + + + /** + * The number of segments included in the URI does not match the number of segments expected by the endpoint. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_WRONG_NUMBER_OF_SEGMENTS(1002), + + + /** + * The same coin was already used with a different denomination previously. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_COIN_CONFLICTING_DENOMINATION_KEY(1003), + + + /** + * The public key of given to a "/coins/" endpoint of the exchange was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_COINS_INVALID_COIN_PUB(1004), + + + /** + * The exchange is not aware of the denomination key the wallet requested for the operation. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_DENOMINATION_KEY_UNKNOWN(1005), + + + /** + * The signature of the denomination key over the coin is not valid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DENOMINATION_SIGNATURE_INVALID(1006), + + + /** + * The exchange failed to perform the operation as it could not find the private keys. This is a problem with the exchange setup, not with the client's request. + * Returned with an HTTP status code of #MHD_HTTP_SERVICE_UNAVAILABLE (503). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_KEYS_MISSING(1007), + + + /** + * Validity period of the denomination lies in the future. + * Returned with an HTTP status code of #MHD_HTTP_PRECONDITION_FAILED (412). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_DENOMINATION_VALIDITY_IN_FUTURE(1008), + + + /** + * Denomination key of the coin is past its expiration time for the requested operation. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_DENOMINATION_EXPIRED(1009), + + + /** + * Denomination key of the coin has been revoked. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_DENOMINATION_REVOKED(1010), + + + /** + * An operation where the exchange interacted with a security module timed out. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_SECMOD_TIMEOUT(1011), + + + /** + * The respective coin did not have sufficient residual value for the operation. The "history" in this response provides the "residual_value" of the coin, which may be less than its "original_value". + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_INSUFFICIENT_FUNDS(1012), + + + /** + * The exchange had an internal error reconstructing the transaction history of the coin that was being processed. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_COIN_HISTORY_COMPUTATION_FAILED(1013), + + + /** + * The exchange failed to obtain the transaction history of the given coin from the database while generating an insufficient funds errors. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_HISTORY_DB_ERROR_INSUFFICIENT_FUNDS(1014), + + + /** + * The same coin was already used with a different age hash previously. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_COIN_CONFLICTING_AGE_HASH(1015), + + + /** + * The requested operation is not valid for the cipher used by the selected denomination. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_INVALID_DENOMINATION_CIPHER_FOR_OPERATION(1016), + + + /** + * The provided arguments for the operation use inconsistent ciphers. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_CIPHER_MISMATCH(1017), + + + /** + * The number of denominations specified in the request exceeds the limit of the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_NEW_DENOMS_ARRAY_SIZE_EXCESSIVE(1018), + + + /** + * The time at the server is too far off from the time specified in the request. Most likely the client system time is wrong. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_CLOCK_SKEW(1020), + + + /** + * The specified amount for the coin is higher than the value of the denomination of the coin. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_AMOUNT_EXCEEDS_DENOMINATION_VALUE(1021), + + + /** + * The exchange was not properly configured with global fees. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_GLOBAL_FEES_MISSING(1022), + + + /** + * The exchange was not properly configured with wire fees. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_WIRE_FEES_MISSING(1023), + + + /** + * The purse public key was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_PURSE_PUB_MALFORMED(1024), + + + /** + * The purse is unknown. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_PURSE_UNKNOWN(1025), + + + /** + * The purse has expired. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_PURSE_EXPIRED(1026), + + + /** + * The exchange has no information about the "reserve_pub" that was given. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_RESERVE_UNKNOWN(1027), + + + /** + * The exchange is not allowed to proceed with the operation until the client has satisfied a KYC check. + * Returned with an HTTP status code of #MHD_HTTP_UNAVAILABLE_FOR_LEGAL_REASONS (451). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_KYC_REQUIRED(1028), + + + /** + * Inconsistency between provided age commitment and attest: either none or both must be provided + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_COIN_CONFLICTING_ATTEST_VS_AGE_COMMITMENT(1029), + + + /** + * The provided attestation for the minimum age couldn't be verified by the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_COIN_AGE_ATTESTATION_FAILURE(1030), + + + /** + * The purse was deleted. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GENERIC_PURSE_DELETED(1031), + + + /** + * The exchange did not find information about the specified transaction in the database. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_NOT_FOUND(1100), + + + /** + * The wire hash of given to a "/deposits/" handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_INVALID_H_WIRE(1101), + + + /** + * The merchant key of given to a "/deposits/" handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_INVALID_MERCHANT_PUB(1102), + + + /** + * The hash of the contract terms given to a "/deposits/" handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_INVALID_H_CONTRACT_TERMS(1103), + + + /** + * The coin public key of given to a "/deposits/" handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_INVALID_COIN_PUB(1104), + + + /** + * The signature returned by the exchange in a /deposits/ request was malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_INVALID_SIGNATURE_BY_EXCHANGE(1105), + + + /** + * The signature of the merchant is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_GET_MERCHANT_SIGNATURE_INVALID(1106), + + + /** + * The provided policy data was not accepted + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSITS_POLICY_NOT_ACCEPTED(1107), + + + /** + * The given reserve does not have sufficient funds to admit the requested withdraw operation at this time. The response includes the current "balance" of the reserve as well as the transaction "history" that lead to this balance. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_INSUFFICIENT_FUNDS(1150), + + + /** + * The amount to withdraw together with the fee exceeds the numeric range for Taler amounts. This is not a client failure, as the coin value and fees come from the exchange's configuration. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_AMOUNT_FEE_OVERFLOW(1152), + + + /** + * The exchange failed to create the signature using the denomination key. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_SIGNATURE_FAILED(1153), + + + /** + * The signature of the reserve is not valid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_RESERVE_SIGNATURE_INVALID(1154), + + + /** + * When computing the reserve history, we ended up with a negative overall balance, which should be impossible. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVE_HISTORY_ERROR_INSUFFICIENT_FUNDS(1155), + + + /** + * The reserve did not have sufficient funds in it to pay for a full reserve history statement. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_GET_RESERVE_HISTORY_ERROR_INSUFFICIENT_BALANCE(1156), + + + /** + * Withdraw period of the coin to be withdrawn is in the past. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_DENOMINATION_KEY_LOST(1158), + + + /** + * The client failed to unblind the blind signature. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_UNBLIND_FAILURE(1159), + + + /** + * The client re-used a withdraw nonce, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_NONCE_REUSE(1160), + + + /** + * The batch withdraw included a planchet that was already withdrawn. This is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WITHDRAW_BATCH_IDEMPOTENT_PLANCHET(1175), + + + /** + * The signature made by the coin over the deposit permission is not valid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_COIN_SIGNATURE_INVALID(1205), + + + /** + * The same coin was already deposited for the same merchant and contract with other details. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_CONFLICTING_CONTRACT(1206), + + + /** + * The stated value of the coin after the deposit fee is subtracted would be negative. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_NEGATIVE_VALUE_AFTER_FEE(1207), + + + /** + * The stated refund deadline is after the wire deadline. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_REFUND_DEADLINE_AFTER_WIRE_DEADLINE(1208), + + + /** + * The stated wire deadline is "never", which makes no sense. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_WIRE_DEADLINE_IS_NEVER(1209), + + + /** + * The exchange failed to canonicalize and hash the given wire format. For example, the merchant failed to provide the "salt" or a valid payto:// URI in the wire details. Note that while the exchange will do some basic sanity checking on the wire details, it cannot warrant that the banking system will ultimately be able to route to the specified address, even if this check passed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_INVALID_WIRE_FORMAT_JSON(1210), + + + /** + * The hash of the given wire address does not match the wire hash specified in the proposal data. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_INVALID_WIRE_FORMAT_CONTRACT_HASH_CONFLICT(1211), + + + /** + * The signature provided by the exchange is not valid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_INVALID_SIGNATURE_BY_EXCHANGE(1221), + + + /** + * The deposited amount is smaller than the deposit fee, which would result in a negative contribution. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DEPOSIT_FEE_ABOVE_AMOUNT(1222), + + + /** + * The proof of policy fulfillment was invalid. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_EXTENSIONS_INVALID_FULFILLMENT(1240), + + + /** + * The reserve balance, status or history was requested for a reserve which is not known to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_STATUS_UNKNOWN(1250), + + + /** + * The reserve status was requested with a bad signature. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_STATUS_BAD_SIGNATURE(1251), + + + /** + * The reserve history was requested with a bad signature. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_HISTORY_BAD_SIGNATURE(1252), + + + /** + * The exchange encountered melt fees exceeding the melted coin's contribution. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MELT_FEES_EXCEED_CONTRIBUTION(1302), + + + /** + * The signature made with the coin to be melted is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MELT_COIN_SIGNATURE_INVALID(1303), + + + /** + * The denomination of the given coin has past its expiration date and it is also not a valid zombie (that is, was not refreshed with the fresh coin being subjected to recoup). + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MELT_COIN_EXPIRED_NO_ZOMBIE(1305), + + + /** + * The signature returned by the exchange in a melt request was malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MELT_INVALID_SIGNATURE_BY_EXCHANGE(1306), + + + /** + * The provided transfer keys do not match up with the original commitment. Information about the original commitment is included in the response. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_COMMITMENT_VIOLATION(1353), + + + /** + * Failed to produce the blinded signatures over the coins to be returned. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_SIGNING_ERROR(1354), + + + /** + * The exchange is unaware of the refresh session specified in the request. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_SESSION_UNKNOWN(1355), + + + /** + * The size of the cut-and-choose dimension of the private transfer keys request does not match #TALER_CNC_KAPPA - 1. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_CNC_TRANSFER_ARRAY_SIZE_INVALID(1356), + + + /** + * The number of envelopes given does not match the number of denomination keys given. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_NEW_DENOMS_ARRAY_SIZE_MISMATCH(1358), + + + /** + * The exchange encountered a numeric overflow totaling up the cost for the refresh operation. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_COST_CALCULATION_OVERFLOW(1359), + + + /** + * The exchange's cost calculation shows that the melt amount is below the costs of the transaction. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_AMOUNT_INSUFFICIENT(1360), + + + /** + * The signature made with the coin over the link data is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_LINK_SIGNATURE_INVALID(1361), + + + /** + * The refresh session hash given to a /refreshes/ handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_INVALID_RCH(1362), + + + /** + * Operation specified invalid for this endpoint. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_OPERATION_INVALID(1363), + + + /** + * The client provided age commitment data, but age restriction is not supported on this server. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_AGE_RESTRICTION_NOT_SUPPORTED(1364), + + + /** + * The client provided invalid age commitment data: missing, not an array, or array of invalid size. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFRESHES_REVEAL_AGE_RESTRICTION_COMMITMENT_INVALID(1365), + + + /** + * The coin specified in the link request is unknown to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_LINK_COIN_UNKNOWN(1400), + + + /** + * The public key of given to a /transfers/ handler was malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_TRANSFERS_GET_WTID_MALFORMED(1450), + + + /** + * The exchange did not find information about the specified wire transfer identifier in the database. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_TRANSFERS_GET_WTID_NOT_FOUND(1451), + + + /** + * The exchange did not find information about the wire transfer fees it charged. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_TRANSFERS_GET_WIRE_FEE_NOT_FOUND(1452), + + + /** + * The exchange found a wire fee that was above the total transfer value (and thus could not have been charged). + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_TRANSFERS_GET_WIRE_FEE_INCONSISTENT(1453), + + + /** + * The wait target of the URL was not in the set of expected values. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSES_INVALID_WAIT_TARGET(1475), + + + /** + * The signature on the purse status returned by the exchange was invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSES_GET_INVALID_SIGNATURE_BY_EXCHANGE(1476), + + + /** + * The exchange knows literally nothing about the coin we were asked to refund. But without a transaction history, we cannot issue a refund. This is kind-of OK, the owner should just refresh it directly without executing the refund. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_COIN_NOT_FOUND(1500), + + + /** + * We could not process the refund request as the coin's transaction history does not permit the requested refund because then refunds would exceed the deposit amount. The "history" in the response proves this. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_CONFLICT_DEPOSIT_INSUFFICIENT(1501), + + + /** + * The exchange knows about the coin we were asked to refund, but not about the specific /deposit operation. Hence, we cannot issue a refund (as we do not know if this merchant public key is authorized to do a refund). + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_DEPOSIT_NOT_FOUND(1502), + + + /** + * The exchange can no longer refund the customer/coin as the money was already transferred (paid out) to the merchant. (It should be past the refund deadline.) + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_MERCHANT_ALREADY_PAID(1503), + + + /** + * The refund fee specified for the request is lower than the refund fee charged by the exchange for the given denomination key of the refunded coin. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_FEE_TOO_LOW(1504), + + + /** + * The refunded amount is smaller than the refund fee, which would result in a negative refund. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_FEE_ABOVE_AMOUNT(1505), + + + /** + * The signature of the merchant is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_MERCHANT_SIGNATURE_INVALID(1506), + + + /** + * Merchant backend failed to create the refund confirmation signature. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_MERCHANT_SIGNING_FAILED(1507), + + + /** + * The signature returned by the exchange in a refund request was malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_INVALID_SIGNATURE_BY_EXCHANGE(1508), + + + /** + * The failure proof returned by the exchange is incorrect. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_INVALID_FAILURE_PROOF_BY_EXCHANGE(1509), + + + /** + * Conflicting refund granted before with different amount but same refund transaction ID. + * Returned with an HTTP status code of #MHD_HTTP_FAILED_DEPENDENCY (424). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_REFUND_INCONSISTENT_AMOUNT(1510), + + + /** + * The given coin signature is invalid for the request. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_SIGNATURE_INVALID(1550), + + + /** + * The exchange could not find the corresponding withdraw operation. The request is denied. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_WITHDRAW_NOT_FOUND(1551), + + + /** + * The coin's remaining balance is zero. The request is denied. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_COIN_BALANCE_ZERO(1552), + + + /** + * The exchange failed to reproduce the coin's blinding. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_BLINDING_FAILED(1553), + + + /** + * The coin's remaining balance is zero. The request is denied. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_COIN_BALANCE_NEGATIVE(1554), + + + /** + * The coin's denomination has not been revoked yet. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_NOT_ELIGIBLE(1555), + + + /** + * The given coin signature is invalid for the request. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_REFRESH_SIGNATURE_INVALID(1575), + + + /** + * The exchange could not find the corresponding melt operation. The request is denied. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_REFRESH_MELT_NOT_FOUND(1576), + + + /** + * The exchange failed to reproduce the coin's blinding. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_REFRESH_BLINDING_FAILED(1578), + + + /** + * The coin's denomination has not been revoked yet. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RECOUP_REFRESH_NOT_ELIGIBLE(1580), + + + /** + * This exchange does not allow clients to request /keys for times other than the current (exchange) time. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KEYS_TIMETRAVEL_FORBIDDEN(1600), + + + /** + * A signature in the server's response was malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WIRE_SIGNATURE_INVALID(1650), + + + /** + * No bank accounts are enabled for the exchange. The administrator should enable-account using the taler-exchange-offline tool. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WIRE_NO_ACCOUNTS_CONFIGURED(1651), + + + /** + * The payto:// URI stored in the exchange database for its bank account is malformed. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WIRE_INVALID_PAYTO_CONFIGURED(1652), + + + /** + * No wire fees are configured for an enabled wire method of the exchange. The administrator must set the wire-fee using the taler-exchange-offline tool. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_WIRE_FEES_NOT_CONFIGURED(1653), + + + /** + * This purse was previously created with different meta data. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_CREATE_CONFLICTING_META_DATA(1675), + + + /** + * This purse was previously merged with different meta data. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_MERGE_CONFLICTING_META_DATA(1676), + + + /** + * The reserve has insufficient funds to create another purse. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_CREATE_INSUFFICIENT_FUNDS(1677), + + + /** + * The purse fee specified for the request is lower than the purse fee charged by the exchange at this time. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_FEE_TOO_LOW(1678), + + + /** + * The payment request cannot be deleted anymore, as it either already completed or timed out. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DELETE_ALREADY_DECIDED(1679), + + + /** + * The signature affirming the purse deletion is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DELETE_SIGNATURE_INVALID(1680), + + + /** + * The exchange failed to talk to the process responsible for its private denomination keys. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DENOMINATION_HELPER_UNAVAILABLE(1700), + + + /** + * The response from the denomination key helper process was malformed. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DENOMINATION_HELPER_BUG(1701), + + + /** + * The helper refuses to sign with the key, because it is too early: the validity period has not yet started. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_DENOMINATION_HELPER_TOO_EARLY(1702), + + + /** + * The signature of the exchange on the reply was invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_EXCHANGE_SIGNATURE_INVALID(1725), + + + /** + * The exchange failed to talk to the process responsible for its private signing keys. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_SIGNKEY_HELPER_UNAVAILABLE(1750), + + + /** + * The response from the online signing key helper process was malformed. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_SIGNKEY_HELPER_BUG(1751), + + + /** + * The helper refuses to sign with the key, because it is too early: the validity period has not yet started. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_SIGNKEY_HELPER_TOO_EARLY(1752), + + + /** + * The purse expiration time is in the past at the time of its creation. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_EXPIRATION_BEFORE_NOW(1775), + + + /** + * The purse expiration time is set to never, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_EXPIRATION_IS_NEVER(1776), + + + /** + * The signature affirming the merge of the purse is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_PURSE_MERGE_SIGNATURE_INVALID(1777), + + + /** + * The signature by the reserve affirming the merge is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_RESERVE_MERGE_SIGNATURE_INVALID(1778), + + + /** + * The signature by the reserve affirming the open operation is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_OPEN_BAD_SIGNATURE(1785), + + + /** + * The signature by the reserve affirming the close operation is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_CLOSE_BAD_SIGNATURE(1786), + + + /** + * The signature by the reserve affirming the attestion request is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_ATTEST_BAD_SIGNATURE(1787), + + + /** + * The exchange does not know an origin account to which the remaining reserve balance could be wired to, and the wallet failed to provide one. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_CLOSE_NO_TARGET_ACCOUNT(1788), + + + /** + * The reserve balance is insufficient to pay for the open operation. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_RESERVES_OPEN_INSUFFICIENT_FUNDS(1789), + + + /** + * The auditor that was supposed to be disabled is unknown to this exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_AUDITOR_NOT_FOUND(1800), + + + /** + * The exchange has a more recently signed conflicting instruction and is thus refusing the current change (replay detected). + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_AUDITOR_MORE_RECENT_PRESENT(1801), + + + /** + * The signature to add or enable the auditor does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_AUDITOR_ADD_SIGNATURE_INVALID(1802), + + + /** + * The signature to disable the auditor does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_AUDITOR_DEL_SIGNATURE_INVALID(1803), + + + /** + * The signature to revoke the denomination does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_DENOMINATION_REVOKE_SIGNATURE_INVALID(1804), + + + /** + * The signature to revoke the online signing key does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_SIGNKEY_REVOKE_SIGNATURE_INVALID(1805), + + + /** + * The exchange has a more recently signed conflicting instruction and is thus refusing the current change (replay detected). + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_MORE_RECENT_PRESENT(1806), + + + /** + * The signingkey specified is unknown to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_KEYS_SIGNKEY_UNKNOWN(1807), + + + /** + * The signature to publish wire account does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_DETAILS_SIGNATURE_INVALID(1808), + + + /** + * The signature to add the wire account does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_ADD_SIGNATURE_INVALID(1809), + + + /** + * The signature to disable the wire account does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_DEL_SIGNATURE_INVALID(1810), + + + /** + * The wire account to be disabled is unknown to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_NOT_FOUND(1811), + + + /** + * The signature to affirm wire fees does not validate. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_FEE_SIGNATURE_INVALID(1812), + + + /** + * The signature conflicts with a previous signature affirming different fees. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_WIRE_FEE_MISMATCH(1813), + + + /** + * The signature affirming the denomination key is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_KEYS_DENOMKEY_ADD_SIGNATURE_INVALID(1814), + + + /** + * The signature affirming the signing key is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_KEYS_SIGNKEY_ADD_SIGNATURE_INVALID(1815), + + + /** + * The signature conflicts with a previous signature affirming different fees. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_GLOBAL_FEE_MISMATCH(1816), + + + /** + * The signature affirming the fee structure is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_GLOBAL_FEE_SIGNATURE_INVALID(1817), + + + /** + * The signature affirming the profit drain is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MANAGEMENT_DRAIN_PROFITS_SIGNATURE_INVALID(1818), + + + /** + * The purse was previously created with different meta data. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_CONFLICTING_META_DATA(1850), + + + /** + * The purse was previously created with a different contract. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_CONFLICTING_CONTRACT_STORED(1851), + + + /** + * A coin signature for a deposit into the purse is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_COIN_SIGNATURE_INVALID(1852), + + + /** + * The purse expiration time is in the past. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_EXPIRATION_BEFORE_NOW(1853), + + + /** + * The purse expiration time is "never". + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_EXPIRATION_IS_NEVER(1854), + + + /** + * The purse signature over the purse meta data is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_SIGNATURE_INVALID(1855), + + + /** + * The signature over the encrypted contract is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_ECONTRACT_SIGNATURE_INVALID(1856), + + + /** + * The signature from the exchange over the confirmation is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_CREATE_EXCHANGE_SIGNATURE_INVALID(1857), + + + /** + * The coin was previously deposited with different meta data. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_CONFLICTING_META_DATA(1858), + + + /** + * The encrypted contract was previously uploaded with different meta data. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_ECONTRACT_CONFLICTING_META_DATA(1859), + + + /** + * The deposited amount is less than the purse fee. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CREATE_PURSE_NEGATIVE_VALUE_AFTER_FEE(1860), + + + /** + * The signature using the merge key is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_MERGE_INVALID_MERGE_SIGNATURE(1876), + + + /** + * The signature using the reserve key is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_MERGE_INVALID_RESERVE_SIGNATURE(1877), + + + /** + * The targeted purse is not yet full and thus cannot be merged. Retrying the request later may succeed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_NOT_FULL(1878), + + + /** + * The signature from the exchange over the confirmation is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_MERGE_EXCHANGE_SIGNATURE_INVALID(1879), + + + /** + * The exchange of the target account is not a partner of this exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_MERGE_PURSE_PARTNER_UNKNOWN(1880), + + + /** + * The auditor signature over the denomination meta data is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_AUDITORS_AUDITOR_SIGNATURE_INVALID(1900), + + + /** + * The auditor that was specified is unknown to this exchange. + * Returned with an HTTP status code of #MHD_HTTP_PRECONDITION_FAILED (412). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_AUDITORS_AUDITOR_UNKNOWN(1901), + + + /** + * The auditor that was specified is no longer used by this exchange. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_AUDITORS_AUDITOR_INACTIVE(1902), + + + /** + * The signature affirming the wallet's KYC request was invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_WALLET_SIGNATURE_INVALID(1925), + + + /** + * The exchange received an unexpected malformed response from its KYC backend. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_PROOF_BACKEND_INVALID_RESPONSE(1926), + + + /** + * The backend signaled an unexpected failure. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_PROOF_BACKEND_ERROR(1927), + + + /** + * The backend signaled an authorization failure. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_PROOF_BACKEND_AUTHORIZATION_FAILED(1928), + + + /** + * The exchange is unaware of having made an the authorization request. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_PROOF_REQUEST_UNKNOWN(1929), + + + /** + * The payto-URI hash did not match. Hence the request was denied. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_CHECK_AUTHORIZATION_FAILED(1930), + + + /** + * The request used a logic specifier that is not known to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_LOGIC_UNKNOWN(1931), + + + /** + * The request requires a logic which is no longer configured at the exchange. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_LOGIC_GONE(1932), + + + /** + * The logic plugin had a bug in its interaction with the KYC provider. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_LOGIC_BUG(1933), + + + /** + * The exchange could not process the request with its KYC provider because the provider refused access to the service. This indicates some configuration issue at the Taler exchange operator. + * Returned with an HTTP status code of #MHD_HTTP_NETWORK_AUTHENTICATION_REQUIRED (511). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_PROVIDER_ACCESS_REFUSED(1934), + + + /** + * There was a timeout in the interaction between the exchange and the KYC provider. The most likely cause is some networking problem. Trying again later might succeed. + * Returned with an HTTP status code of #MHD_HTTP_GATEWAY_TIMEOUT (504). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_PROVIDER_TIMEOUT(1935), + + + /** + * The KYC provider responded with a status that was completely unexpected by the KYC logic of the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_PROVIDER_UNEXPECTED_REPLY(1936), + + + /** + * The rate limit of the exchange at the KYC provider has been exceeded. Trying much later might work. + * Returned with an HTTP status code of #MHD_HTTP_SERVICE_UNAVAILABLE (503). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_GENERIC_PROVIDER_RATE_LIMIT_EXCEEDED(1937), + + + /** + * The request to the webhook lacked proper authorization or authentication data. + * Returned with an HTTP status code of #MHD_HTTP_UNAUTHORIZED (401). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_KYC_WEBHOOK_UNAUTHORIZED(1938), + + + /** + * The exchange does not know a contract under the given contract public key. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CONTRACTS_UNKNOWN(1950), + + + /** + * The URL does not encode a valid exchange public key in its path. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CONTRACTS_INVALID_CONTRACT_PUB(1951), + + + /** + * The returned encrypted contract did not decrypt. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CONTRACTS_DECRYPTION_FAILED(1952), + + + /** + * The signature on the encrypted contract did not validate. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CONTRACTS_SIGNATURE_INVALID(1953), + + + /** + * The decrypted contract was malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_CONTRACTS_DECODING_FAILED(1954), + + + /** + * A coin signature for a deposit into the purse is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_COIN_SIGNATURE_INVALID(1975), + + + /** + * It is too late to deposit coins into the purse. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + EXCHANGE_PURSE_DEPOSIT_DECIDED_ALREADY(1976), + + + /** + * The backend could not find the merchant instance specified in the request. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_INSTANCE_UNKNOWN(2000), + + + /** + * The start and end-times in the wire fee structure leave a hole. This is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_HOLE_IN_WIRE_FEE_STRUCTURE(2001), + + + /** + * The merchant was unable to obtain a valid answer to /wire from the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_WIRE_REQUEST_FAILED(2002), + + + /** + * The proposal is not known to the backend. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_ORDER_UNKNOWN(2005), + + + /** + * The order provided to the backend could not be completed, because a product to be completed via inventory data is not actually in our inventory. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_PRODUCT_UNKNOWN(2006), + + + /** + * The tip ID is unknown. This could happen if the tip has expired. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_TIP_ID_UNKNOWN(2007), + + + /** + * The contract obtained from the merchant backend was malformed. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_DB_CONTRACT_CONTENT_INVALID(2008), + + + /** + * The order we found does not match the provided contract hash. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_CONTRACT_HASH_DOES_NOT_MATCH_ORDER(2009), + + + /** + * The exchange failed to provide a valid response to the merchant's /keys request. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_KEYS_FAILURE(2010), + + + /** + * The exchange failed to respond to the merchant on time. + * Returned with an HTTP status code of #MHD_HTTP_GATEWAY_TIMEOUT (504). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_TIMEOUT(2011), + + + /** + * The merchant failed to talk to the exchange. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_CONNECT_FAILURE(2012), + + + /** + * The exchange returned a maformed response. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_REPLY_MALFORMED(2013), + + + /** + * The exchange returned an unexpected response status. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_EXCHANGE_UNEXPECTED_STATUS(2014), + + + /** + * The merchant refused the request due to lack of authorization. + * Returned with an HTTP status code of #MHD_HTTP_UNAUTHORIZED (401). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_UNAUTHORIZED(2015), + + + /** + * The merchant instance specified in the request was deleted. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_INSTANCE_DELETED(2016), + + + /** + * The backend could not find the inbound wire transfer specified in the request. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_TRANSFER_UNKNOWN(2017), + + + /** + * The backend could not find the template(id) because it is not exist. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_TEMPLATE_UNKNOWN(2018), + + + /** + * The backend could not find the webhook(id) because it is not exist. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_WEBHOOK_UNKNOWN(2019), + + + /** + * The backend could not find the webhook(serial) because it is not exist. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GENERIC_PENDING_WEBHOOK_UNKNOWN(2020), + + + /** + * The exchange failed to provide a valid answer to the tracking request, thus those details are not in the response. + * Returned with an HTTP status code of #MHD_HTTP_OK (200). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GET_ORDERS_EXCHANGE_TRACKING_FAILURE(2100), + + + /** + * The merchant backend failed to construct the request for tracking to the exchange, thus tracking details are not in the response. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GET_ORDERS_ID_EXCHANGE_REQUEST_FAILURE(2103), + + + /** + * The merchant backend failed trying to contact the exchange for tracking details, thus those details are not in the response. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GET_ORDERS_ID_EXCHANGE_LOOKUP_START_FAILURE(2104), + + + /** + * The claim token used to authenticate the client is invalid for this order. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GET_ORDERS_ID_INVALID_TOKEN(2105), + + + /** + * The contract terms hash used to authenticate the client is invalid for this order. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_GET_ORDERS_ID_INVALID_CONTRACT_HASH(2106), + + + /** + * The exchange responded saying that funds were insufficient (for example, due to double-spending). + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_INSUFFICIENT_FUNDS(2150), + + + /** + * The denomination key used for payment is not listed among the denomination keys of the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_KEY_NOT_FOUND(2151), + + + /** + * The denomination key used for payment is not audited by an auditor approved by the merchant. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_KEY_AUDITOR_FAILURE(2152), + + + /** + * There was an integer overflow totaling up the amounts or deposit fees in the payment. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_AMOUNT_OVERFLOW(2153), + + + /** + * The deposit fees exceed the total value of the payment. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_FEES_EXCEED_PAYMENT(2154), + + + /** + * After considering deposit and wire fees, the payment is insufficient to satisfy the required amount for the contract. The client should revisit the logic used to calculate fees it must cover. + * Returned with an HTTP status code of #MHD_HTTP_NOT_ACCEPTABLE (406). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_INSUFFICIENT_DUE_TO_FEES(2155), + + + /** + * Even if we do not consider deposit and wire fees, the payment is insufficient to satisfy the required amount for the contract. + * Returned with an HTTP status code of #MHD_HTTP_NOT_ACCEPTABLE (406). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_PAYMENT_INSUFFICIENT(2156), + + + /** + * The signature over the contract of one of the coins was invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_COIN_SIGNATURE_INVALID(2157), + + + /** + * When we tried to find information about the exchange to issue the deposit, we failed. This usually only happens if the merchant backend is somehow unable to get its own HTTP client logic to work. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_LOOKUP_FAILED(2158), + + + /** + * The refund deadline in the contract is after the transfer deadline. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_REFUND_DEADLINE_PAST_WIRE_TRANSFER_DEADLINE(2159), + + + /** + * The order was already paid (maybe by another wallet). + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_ALREADY_PAID(2160), + + + /** + * The payment is too late, the offer has expired. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_OFFER_EXPIRED(2161), + + + /** + * The "merchant" field is missing in the proposal data. This is an internal error as the proposal is from the merchant's own database at this point. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_MERCHANT_FIELD_MISSING(2162), + + + /** + * Failed to locate merchant's account information matching the wire hash given in the proposal. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_WIRE_HASH_UNKNOWN(2163), + + + /** + * The deposit time for the denomination has expired. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_DEPOSIT_EXPIRED(2165), + + + /** + * The exchange of the deposited coin charges a wire fee that could not be added to the total (total amount too high). + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_WIRE_FEE_ADDITION_FAILED(2166), + + + /** + * The contract was not fully paid because of refunds. Note that clients MAY treat this as paid if, for example, contracts must be executed despite of refunds. + * Returned with an HTTP status code of #MHD_HTTP_PAYMENT_REQUIRED (402). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_REFUNDED(2167), + + + /** + * According to our database, we have refunded more than we were paid (which should not be possible). + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_REFUNDS_EXCEED_PAYMENTS(2168), + + + /** + * Legacy stuff. Remove me with protocol v1. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + DEAD_QQQ_PAY_MERCHANT_POST_ORDERS_ID_ABORT_REFUND_REFUSED_PAYMENT_COMPLETE(2169), + + + /** + * The payment failed at the exchange. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_FAILED(2170), + + + /** + * The payment required a minimum age but one of the coins (of a denomination with support for age restriction) did not provide any age_commitment. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_AGE_COMMITMENT_MISSING(2171), + + + /** + * The payment required a minimum age but one of the coins provided an age_commitment that contained a wrong number of public keys compared to the number of age groups defined in the denomination of the coin. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_AGE_COMMITMENT_SIZE_MISMATCH(2172), + + + /** + * The payment required a minimum age but one of the coins provided a minimum_age_sig that couldn't be verified with the given age_commitment for that particular minimum age. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_AGE_VERIFICATION_FAILED(2173), + + + /** + * The payment required no minimum age but one of the coins (of a denomination with support for age restriction) did not provide the required h_age_commitment. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAY_AGE_COMMITMENT_HASH_MISSING(2174), + + + /** + * The contract hash does not match the given order ID. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAID_CONTRACT_HASH_MISMATCH(2200), + + + /** + * The signature of the merchant is not valid for the given contract hash. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_PAID_COIN_SIGNATURE_INVALID(2201), + + + /** + * The merchant failed to send the exchange the refund request. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_EXCHANGE_REFUND_FAILED(2251), + + + /** + * The merchant failed to find the exchange to process the lookup. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_EXCHANGE_LOOKUP_FAILED(2252), + + + /** + * The merchant could not find the contract. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_CONTRACT_NOT_FOUND(2253), + + + /** + * The payment was already completed and thus cannot be aborted anymore. + * Returned with an HTTP status code of #MHD_HTTP_PRECONDITION_FAILED (412). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_REFUND_REFUSED_PAYMENT_COMPLETE(2254), + + + /** + * The hash provided by the wallet does not match the order. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_CONTRACT_HASH_MISSMATCH(2255), + + + /** + * The array of coins cannot be empty. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_ABORT_COINS_ARRAY_EMPTY(2256), + + + /** + * We could not claim the order because the backend is unaware of it. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_CLAIM_NOT_FOUND(2300), + + + /** + * We could not claim the order because someone else claimed it first. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_CLAIM_ALREADY_CLAIMED(2301), + + + /** + * The client-side experienced an internal failure. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_CLAIM_CLIENT_INTERNAL_FAILURE(2302), + + + /** + * The backend failed to sign the refund request. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_ORDERS_ID_REFUND_SIGNATURE_FAILED(2350), + + + /** + * The client failed to unblind the signature returned by the merchant. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_UNBLIND_FAILURE(2400), + + + /** + * The exchange returned a failure code for the withdraw operation. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_EXCHANGE_ERROR(2403), + + + /** + * The merchant failed to add up the amounts to compute the pick up value. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_SUMMATION_FAILED(2404), + + + /** + * The tip expired. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_HAS_EXPIRED(2405), + + + /** + * The requested withdraw amount exceeds the amount remaining to be picked up. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_AMOUNT_EXCEEDS_TIP_REMAINING(2406), + + + /** + * The merchant did not find the specified denomination key in the exchange's key set. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_TIP_PICKUP_DENOMINATION_UNKNOWN(2407), + + + /** + * The backend lacks a wire transfer method configuration option for the given instance. Thus, this instance is unavailable (not findable for creating new orders). + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_INSTANCE_CONFIGURATION_LACKS_WIRE(2500), + + + /** + * The proposal had no timestamp and the backend failed to obtain the local time. Likely to be an internal error. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_NO_LOCALTIME(2501), + + + /** + * The order provided to the backend could not be parsed, some required fields were missing or ill-formed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_PROPOSAL_PARSE_ERROR(2502), + + + /** + * The backend encountered an error: the proposal already exists. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_ALREADY_EXISTS(2503), + + + /** + * The request is invalid: the wire deadline is before the refund deadline. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_REFUND_AFTER_WIRE_DEADLINE(2504), + + + /** + * The request is invalid: a delivery date was given, but it is in the past. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_DELIVERY_DATE_IN_PAST(2505), + + + /** + * The request is invalid: the wire deadline for the order would be "never". + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_WIRE_DEADLINE_IS_NEVER(2506), + + + /** + * One of the paths to forget is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_ORDERS_ID_FORGET_PATH_SYNTAX_INCORRECT(2510), + + + /** + * One of the paths to forget was not marked as forgettable. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_ORDERS_ID_FORGET_PATH_NOT_FORGETTABLE(2511), + + + /** + * The order provided to the backend could not be deleted, our offer is still valid and awaiting payment. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_DELETE_ORDERS_AWAITING_PAYMENT(2520), + + + /** + * The order provided to the backend could not be deleted as the order was already paid. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_DELETE_ORDERS_ALREADY_PAID(2521), + + + /** + * The amount to be refunded is inconsistent: either is lower than the previous amount being awarded, or it is too big to be paid back. In this second case, the fault stays on the business dept. side. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_INCONSISTENT_AMOUNT(2530), + + + /** + * The frontend gave an unpaid order id to issue the refund to. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_ORDER_UNPAID(2531), + + + /** + * The refund delay was set to 0 and thus no refunds are allowed for this order. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_NOT_ALLOWED_BY_CONTRACT(2532), + + + /** + * The exchange says it does not know this transfer. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_EXCHANGE_UNKNOWN(2550), + + + /** + * We internally failed to execute the /track/transfer request. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_REQUEST_ERROR(2551), + + + /** + * The amount transferred differs between what was submitted and what the exchange claimed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_CONFLICTING_TRANSFERS(2552), + + + /** + * The exchange gave conflicting information about a coin which has been wire transferred. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_CONFLICTING_REPORTS(2553), + + + /** + * The exchange charged a different wire fee than what it originally advertised, and it is higher. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_BAD_WIRE_FEE(2554), + + + /** + * We did not find the account that the transfer was made to. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_ACCOUNT_NOT_FOUND(2555), + + + /** + * The backend could not delete the transfer as the echange already replied to our inquiry about it and we have integrated the result. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_DELETE_TRANSFERS_ALREADY_CONFIRMED(2556), + + + /** + * The backend was previously informed about a wire transfer with the same ID but a different amount. Multiple wire transfers with the same ID are not allowed. If the new amount is correct, the old transfer should first be deleted. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TRANSFERS_CONFLICTING_SUBMISSION(2557), + + + /** + * The merchant backend cannot create an instance under the given identifier as one already exists. Use PATCH to modify the existing entry. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_INSTANCES_ALREADY_EXISTS(2600), + + + /** + * The merchant backend cannot create an instance because the authentication configuration field is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_INSTANCES_BAD_AUTH(2601), + + + /** + * The merchant backend cannot update an instance's authentication settings because the provided authentication settings are malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_INSTANCE_AUTH_BAD_AUTH(2602), + + + /** + * The merchant backend cannot create an instance under the given identifier, the previous one was deleted but must be purged first. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_INSTANCES_PURGE_REQUIRED(2603), + + + /** + * The merchant backend cannot update an instance under the given identifier, the previous one was deleted but must be purged first. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_INSTANCES_PURGE_REQUIRED(2625), + + + /** + * The product ID exists. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_PRODUCTS_CONFLICT_PRODUCT_EXISTS(2650), + + + /** + * The update would have reduced the total amount of product lost, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_LOST_REDUCED(2660), + + + /** + * The update would have mean that more stocks were lost than what remains from total inventory after sales, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_LOST_EXCEEDS_STOCKS(2661), + + + /** + * The update would have reduced the total amount of product in stock, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_STOCKED_REDUCED(2662), + + + /** + * The update would have reduced the total amount of product sold, which is not allowed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_SOLD_REDUCED(2663), + + + /** + * The lock request is for more products than we have left (unlocked) in stock. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_PRODUCTS_LOCK_INSUFFICIENT_STOCKS(2670), + + + /** + * The deletion request is for a product that is locked. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_DELETE_PRODUCTS_CONFLICTING_LOCK(2680), + + + /** + * The requested wire method is not supported by the exchange. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_RESERVES_UNSUPPORTED_WIRE_METHOD(2700), + + + /** + * The reserve could not be deleted because it is unknown. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_DELETE_RESERVES_NO_SUCH_RESERVE(2710), + + + /** + * The reserve that was used to fund the tips has expired. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_EXPIRED(2750), + + + /** + * The reserve that was used to fund the tips was not found in the DB. + * Returned with an HTTP status code of #MHD_HTTP_SERVICE_UNAVAILABLE (503). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_UNKNOWN(2751), + + + /** + * The backend knows the instance that was supposed to support the tip, and it was configured for tipping. However, the funds remaining are insufficient to cover the tip, and the merchant should top up the reserve. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_INSUFFICIENT_FUNDS(2752), + + + /** + * The backend failed to find a reserve needed to authorize the tip. + * Returned with an HTTP status code of #MHD_HTTP_SERVICE_UNAVAILABLE (503). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_NOT_FOUND(2753), + + + /** + * The merchant backend encountered a failure in computing the deposit total. + * Returned with an HTTP status code of #MHD_HTTP_OK (200). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_GET_ORDERS_ID_AMOUNT_ARITHMETIC_FAILURE(2800), + + + /** + * The template ID already exists. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_TEMPLATES_CONFLICT_TEMPLATE_EXISTS(2850), + + + /** + * Amount given in the using template and in the template contract. There is a conflict. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_USING_TEMPLATES_AMOUNT_CONFLICT_TEMPLATES_CONTRACT_AMOUNT(2860), + + + /** + * Subject given in the using template and in the template contract. There is a conflict. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_USING_TEMPLATES_SUMMARY_CONFLICT_TEMPLATES_CONTRACT_SUBJECT(2861), + + + /** + * Amount not given in the using template and in the template contract. There is a conflict. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_USING_TEMPLATES_NO_AMOUNT(2862), + + + /** + * Subject not given in the using template and in the template contract. There is a conflict. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_POST_USING_TEMPLATES_NO_SUMMARY(2863), + + + /** + * The webhook ID elready exists. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_WEBHOOKS_CONFLICT_WEBHOOK_EXISTS(2900), + + + /** + * The webhook serial elready exists. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + MERCHANT_PRIVATE_POST_PENDING_WEBHOOKS_CONFLICT_PENDING_WEBHOOK_EXISTS(2910), + + + /** + * The signature from the exchange on the deposit confirmation is invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + AUDITOR_DEPOSIT_CONFIRMATION_SIGNATURE_INVALID(3100), + + + /** + * The exchange key used for the signature on the deposit confirmation was revoked. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + AUDITOR_EXCHANGE_SIGNING_KEY_REVOKED(3101), + + + /** + * Wire transfer attempted with credit and debit party being the same bank account. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_SAME_ACCOUNT(5101), + + + /** + * Wire transfer impossible, due to financial limitation of the party that attempted the payment. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_UNALLOWED_DEBIT(5102), + + + /** + * Negative numbers are not allowed (as value and/or fraction) to instantiate an amount object. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_NEGATIVE_NUMBER_AMOUNT(5103), + + + /** + * A too big number was used (as value and/or fraction) to instantiate an amount object. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_NUMBER_TOO_BIG(5104), + + + /** + * Could not login for the requested operation. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_LOGIN_FAILED(5105), + + + /** + * The bank account referenced in the requested operation was not found. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_UNKNOWN_ACCOUNT(5106), + + + /** + * The transaction referenced in the requested operation (typically a reject operation), was not found. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_TRANSACTION_NOT_FOUND(5107), + + + /** + * Bank received a malformed amount string. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_BAD_FORMAT_AMOUNT(5108), + + + /** + * The client does not own the account credited by the transaction which is to be rejected, so it has no rights do reject it. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_REJECT_NO_RIGHTS(5109), + + + /** + * This error code is returned when no known exception types captured the exception. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_UNMANAGED_EXCEPTION(5110), + + + /** + * This error code is used for all those exceptions that do not really need a specific error code to return to the client. Used for example when a client is trying to register with a unavailable username. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_SOFT_EXCEPTION(5111), + + + /** + * The request UID for a request to transfer funds has already been used, but with different details for the transfer. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_TRANSFER_REQUEST_UID_REUSED(5112), + + + /** + * The withdrawal operation already has a reserve selected. The current request conflicts with the existing selection. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_WITHDRAWAL_OPERATION_RESERVE_SELECTION_CONFLICT(5113), + + + /** + * The wire transfer subject duplicates an existing reserve public key. But wire transfer subjects must be unique. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_DUPLICATE_RESERVE_PUB_SUBJECT(5114), + + + /** + * The client requested a transaction that is so far in the past, that it has been forgotten by the bank. + * Returned with an HTTP status code of #MHD_HTTP_GONE (410). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_ANCIENT_TRANSACTION_GONE(5115), + + + /** + * The client attempted to abort a transaction that was already confirmed. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_ABORT_CONFIRM_CONFLICT(5116), + + + /** + * The client attempted to confirm a transaction that was already aborted. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_CONFIRM_ABORT_CONFLICT(5117), + + + /** + * The client attempted to register an account with the same name. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_REGISTER_CONFLICT(5118), + + + /** + * The client attempted to confirm a withdrawal operation before the wallet posted the required details. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + BANK_POST_WITHDRAWAL_OPERATION_REQUIRED(5119), + + + /** + * The sync service failed find the account in its database. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_ACCOUNT_UNKNOWN(6100), + + + /** + * The SHA-512 hash provided in the If-None-Match header is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_BAD_IF_NONE_MATCH(6101), + + + /** + * The SHA-512 hash provided in the If-Match header is malformed or missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_BAD_IF_MATCH(6102), + + + /** + * The signature provided in the "Sync-Signature" header is malformed or missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_BAD_SYNC_SIGNATURE(6103), + + + /** + * The signature provided in the "Sync-Signature" header does not match the account, old or new Etags. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_INVALID_SIGNATURE(6104), + + + /** + * The "Content-length" field for the upload is not a number. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_MALFORMED_CONTENT_LENGTH(6105), + + + /** + * The "Content-length" field for the upload is too big based on the server's terms of service. + * Returned with an HTTP status code of #MHD_HTTP_PAYLOAD_TOO_LARGE (413). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_EXCESSIVE_CONTENT_LENGTH(6106), + + + /** + * The server is out of memory to handle the upload. Trying again later may succeed. + * Returned with an HTTP status code of #MHD_HTTP_PAYLOAD_TOO_LARGE (413). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_OUT_OF_MEMORY_ON_CONTENT_LENGTH(6107), + + + /** + * The uploaded data does not match the Etag. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_INVALID_UPLOAD(6108), + + + /** + * HTTP server experienced a timeout while awaiting promised payment. + * Returned with an HTTP status code of #MHD_HTTP_REQUEST_TIMEOUT (408). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_PAYMENT_GENERIC_TIMEOUT(6109), + + + /** + * Sync could not setup the payment request with its own backend. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_PAYMENT_CREATE_BACKEND_ERROR(6110), + + + /** + * The sync service failed find the backup to be updated in its database. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_PREVIOUS_BACKUP_UNKNOWN(6111), + + + /** + * The "Content-length" field for the upload is missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_MISSING_CONTENT_LENGTH(6112), + + + /** + * Sync had problems communicating with its payment backend. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_GENERIC_BACKEND_ERROR(6113), + + + /** + * Sync experienced a timeout communicating with its payment backend. + * Returned with an HTTP status code of #MHD_HTTP_GATEWAY_TIMEOUT (504). + * (A value of 0 indicates that the error is generated client-side). + */ + SYNC_GENERIC_BACKEND_TIMEOUT(6114), + + + /** + * The wallet does not implement a version of the exchange protocol that is compatible with the protocol version of the exchange. + * Returned with an HTTP status code of #MHD_HTTP_NOT_IMPLEMENTED (501). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_EXCHANGE_PROTOCOL_VERSION_INCOMPATIBLE(7000), + + + /** + * The wallet encountered an unexpected exception. This is likely a bug in the wallet implementation. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_UNEXPECTED_EXCEPTION(7001), + + + /** + * The wallet received a response from a server, but the response can't be parsed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_RECEIVED_MALFORMED_RESPONSE(7002), + + + /** + * The wallet tried to make a network request, but it received no response. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_NETWORK_ERROR(7003), + + + /** + * The wallet tried to make a network request, but it was throttled. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_HTTP_REQUEST_THROTTLED(7004), + + + /** + * The wallet made a request to a service, but received an error response it does not know how to handle. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_UNEXPECTED_REQUEST_ERROR(7005), + + + /** + * The denominations offered by the exchange are insufficient. Likely the exchange is badly configured or not maintained. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_EXCHANGE_DENOMINATIONS_INSUFFICIENT(7006), + + + /** + * The wallet does not support the operation requested by a client. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CORE_API_OPERATION_UNKNOWN(7007), + + + /** + * The given taler://pay URI is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_INVALID_TALER_PAY_URI(7008), + + + /** + * The signature on a coin by the exchange's denomination key is invalid after unblinding it. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_EXCHANGE_COIN_SIGNATURE_INVALID(7009), + + + /** + * The exchange does not know about the reserve (yet), and thus withdrawal can't progress. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_EXCHANGE_WITHDRAW_RESERVE_UNKNOWN_AT_EXCHANGE(7010), + + + /** + * The wallet core service is not available. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CORE_NOT_AVAILABLE(7011), + + + /** + * The bank has aborted a withdrawal operation, and thus a withdrawal can't complete. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_WITHDRAWAL_OPERATION_ABORTED_BY_BANK(7012), + + + /** + * An HTTP request made by the wallet timed out. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_HTTP_REQUEST_GENERIC_TIMEOUT(7013), + + + /** + * The order has already been claimed by another wallet. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_ORDER_ALREADY_CLAIMED(7014), + + + /** + * A group of withdrawal operations (typically for the same reserve at the same exchange) has errors and will be tried again later. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_WITHDRAWAL_GROUP_INCOMPLETE(7015), + + + /** + * The signature on a coin by the exchange's denomination key (obtained through the merchant via tipping) is invalid after unblinding it. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_TIPPING_COIN_SIGNATURE_INVALID(7016), + + + /** + * The wallet does not implement a version of the bank integration API that is compatible with the version offered by the bank. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_BANK_INTEGRATION_PROTOCOL_VERSION_INCOMPATIBLE(7017), + + + /** + * The wallet processed a taler://pay URI, but the merchant base URL in the downloaded contract terms does not match the merchant base URL derived from the URI. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CONTRACT_TERMS_BASE_URL_MISMATCH(7018), + + + /** + * The merchant's signature on the contract terms is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CONTRACT_TERMS_SIGNATURE_INVALID(7019), + + + /** + * The contract terms given by the merchant are malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CONTRACT_TERMS_MALFORMED(7020), + + + /** + * A pending operation failed, and thus the request can't be completed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_PENDING_OPERATION_FAILED(7021), + + + /** + * A payment was attempted, but the merchant had an internal server error (5xx). + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_PAY_MERCHANT_SERVER_ERROR(7022), + + + /** + * The crypto worker failed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CRYPTO_WORKER_ERROR(7023), + + + /** + * The crypto worker received a bad request. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_CRYPTO_WORKER_BAD_REQUEST(7024), + + + /** + * A KYC step is required before withdrawal can proceed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_WITHDRAWAL_KYC_REQUIRED(7025), + + + /** + * The wallet does not have sufficient balance to create a deposit group. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_DEPOSIT_GROUP_INSUFFICIENT_BALANCE(7026), + + + /** + * The wallet does not have sufficient balance to create a peer push payment. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_PEER_PUSH_PAYMENT_INSUFFICIENT_BALANCE(7027), + + + /** + * The wallet does not have sufficient balance to pay for an invoice. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + WALLET_PEER_PULL_PAYMENT_INSUFFICIENT_BALANCE(7028), + + + /** + * We encountered a timeout with our payment backend. + * Returned with an HTTP status code of #MHD_HTTP_GATEWAY_TIMEOUT (504). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_BACKEND_TIMEOUT(8000), + + + /** + * The backend requested payment, but the request is malformed. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_INVALID_PAYMENT_REQUEST(8001), + + + /** + * The backend got an unexpected reply from the payment processor. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_BACKEND_ERROR(8002), + + + /** + * The "Content-length" field for the upload is missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_MISSING_CONTENT_LENGTH(8003), + + + /** + * The "Content-length" field for the upload is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_MALFORMED_CONTENT_LENGTH(8004), + + + /** + * The backend failed to setup an order with the payment processor. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_ORDER_CREATE_BACKEND_ERROR(8005), + + + /** + * The backend was not authorized to check for payment with the payment processor. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_PAYMENT_CHECK_UNAUTHORIZED(8006), + + + /** + * The backend could not check payment status with the payment processor. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_PAYMENT_CHECK_START_FAILED(8007), + + + /** + * The Anastasis provider could not be reached. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_GENERIC_PROVIDER_UNREACHABLE(8008), + + + /** + * HTTP server experienced a timeout while awaiting promised payment. + * Returned with an HTTP status code of #MHD_HTTP_REQUEST_TIMEOUT (408). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_PAYMENT_GENERIC_TIMEOUT(8009), + + + /** + * The key share is unknown to the provider. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_UNKNOWN(8108), + + + /** + * The authorization method used for the key share is no longer supported by the provider. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_AUTHORIZATION_METHOD_NO_LONGER_SUPPORTED(8109), + + + /** + * The client needs to respond to the challenge. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_CHALLENGE_RESPONSE_REQUIRED(8110), + + + /** + * The client's response to the challenge was invalid. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_CHALLENGE_FAILED(8111), + + + /** + * The backend is not aware of having issued the provided challenge code. Either this is the wrong code, or it has expired. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_CHALLENGE_UNKNOWN(8112), + + + /** + * The backend failed to initiate the authorization process. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_AUTHORIZATION_START_FAILED(8114), + + + /** + * The authorization succeeded, but the key share is no longer available. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_KEY_SHARE_GONE(8115), + + + /** + * The backend forgot the order we asked the client to pay for + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_ORDER_DISAPPEARED(8116), + + + /** + * The backend itself reported a bad exchange interaction. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_BACKEND_EXCHANGE_BAD(8117), + + + /** + * The backend reported a payment status we did not expect. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_UNEXPECTED_PAYMENT_STATUS(8118), + + + /** + * The backend failed to setup the order for payment. + * Returned with an HTTP status code of #MHD_HTTP_BAD_GATEWAY (502). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_PAYMENT_CREATE_BACKEND_ERROR(8119), + + + /** + * The decryption of the key share failed with the provided key. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_DECRYPTION_FAILED(8120), + + + /** + * The request rate is too high. The server is refusing requests to guard against brute-force attacks. + * Returned with an HTTP status code of #MHD_HTTP_TOO_MANY_REQUESTS (429). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_RATE_LIMITED(8121), + + + /** + * A request to issue a challenge is not valid for this authentication method. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_CHALLENGE_WRONG_METHOD(8123), + + + /** + * The backend failed to store the key share because the UUID is already in use. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_UPLOAD_UUID_EXISTS(8150), + + + /** + * The backend failed to store the key share because the authorization method is not supported. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TRUTH_UPLOAD_METHOD_NOT_SUPPORTED(8151), + + + /** + * The provided phone number is not an acceptable number. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_SMS_PHONE_INVALID(8200), + + + /** + * Failed to run the SMS transmission helper process. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_SMS_HELPER_EXEC_FAILED(8201), + + + /** + * Provider failed to send SMS. Helper terminated with a non-successful result. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_SMS_HELPER_COMMAND_FAILED(8202), + + + /** + * The provided email address is not an acceptable address. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_EMAIL_INVALID(8210), + + + /** + * Failed to run the E-mail transmission helper process. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_EMAIL_HELPER_EXEC_FAILED(8211), + + + /** + * Provider failed to send E-mail. Helper terminated with a non-successful result. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_EMAIL_HELPER_COMMAND_FAILED(8212), + + + /** + * The provided postal address is not an acceptable address. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POST_INVALID(8220), + + + /** + * Failed to run the mail transmission helper process. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POST_HELPER_EXEC_FAILED(8221), + + + /** + * Provider failed to send mail. Helper terminated with a non-successful result. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POST_HELPER_COMMAND_FAILED(8222), + + + /** + * The provided IBAN address is not an acceptable IBAN. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_IBAN_INVALID(8230), + + + /** + * The provider has not yet received the IBAN wire transfer authorizing the disclosure of the key share. + * Returned with an HTTP status code of #MHD_HTTP_FORBIDDEN (403). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_IBAN_MISSING_TRANSFER(8231), + + + /** + * The backend did not find a TOTP key in the data provided. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TOTP_KEY_MISSING(8240), + + + /** + * The key provided does not satisfy the format restrictions for an Anastasis TOTP key. + * Returned with an HTTP status code of #MHD_HTTP_CONFLICT (409). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_TOTP_KEY_INVALID(8241), + + + /** + * The given if-none-match header is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_BAD_IF_NONE_MATCH(8301), + + + /** + * The server is out of memory to handle the upload. Trying again later may succeed. + * Returned with an HTTP status code of #MHD_HTTP_PAYLOAD_TOO_LARGE (413). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_OUT_OF_MEMORY_ON_CONTENT_LENGTH(8304), + + + /** + * The signature provided in the "Anastasis-Policy-Signature" header is malformed or missing. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_BAD_SIGNATURE(8305), + + + /** + * The given if-match header is malformed. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_BAD_IF_MATCH(8306), + + + /** + * The uploaded data does not match the Etag. + * Returned with an HTTP status code of #MHD_HTTP_BAD_REQUEST (400). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_INVALID_UPLOAD(8307), + + + /** + * The provider is unaware of the requested policy. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_POLICY_NOT_FOUND(8350), + + + /** + * The given action is invalid for the current state of the reducer. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_ACTION_INVALID(8400), + + + /** + * The given state of the reducer is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_STATE_INVALID(8401), + + + /** + * The given input to the reducer is invalid. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_INPUT_INVALID(8402), + + + /** + * The selected authentication method does not work for the Anastasis provider. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_AUTHENTICATION_METHOD_NOT_SUPPORTED(8403), + + + /** + * The given input and action do not work for the current state. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_INPUT_INVALID_FOR_STATE(8404), + + + /** + * We experienced an unexpected failure interacting with the backend. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_BACKEND_FAILURE(8405), + + + /** + * The contents of a resource file did not match our expectations. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_RESOURCE_MALFORMED(8406), + + + /** + * A required resource file is missing. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_RESOURCE_MISSING(8407), + + + /** + * An input did not match the regular expression. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_INPUT_REGEX_FAILED(8408), + + + /** + * An input did not match the custom validation logic. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_INPUT_VALIDATION_FAILED(8409), + + + /** + * Our attempts to download the recovery document failed with all providers. Most likely the personal information you entered differs from the information you provided during the backup process and you should go back to the previous step. Alternatively, if you used a backup provider that is unknown to this application, you should add that provider manually. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_POLICY_LOOKUP_FAILED(8410), + + + /** + * Anastasis provider reported a fatal failure. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_BACKUP_PROVIDER_FAILED(8411), + + + /** + * Anastasis provider failed to respond to the configuration request. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_PROVIDER_CONFIG_FAILED(8412), + + + /** + * The policy we downloaded is malformed. Must have been a client error while creating the backup. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_POLICY_MALFORMED(8413), + + + /** + * We failed to obtain the policy, likely due to a network issue. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_NETWORK_FAILED(8414), + + + /** + * The recovered secret did not match the required syntax. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_SECRET_MALFORMED(8415), + + + /** + * The challenge data provided is too large for the available providers. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_CHALLENGE_DATA_TOO_BIG(8416), + + + /** + * The provided core secret is too large for some of the providers. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_SECRET_TOO_BIG(8417), + + + /** + * The provider returned in invalid configuration. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_PROVIDER_INVALID_CONFIG(8418), + + + /** + * The reducer encountered an internal error, likely a bug that needs to be reported. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_INTERNAL_ERROR(8419), + + + /** + * The reducer already synchronized with all providers. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + ANASTASIS_REDUCER_PROVIDERS_ALREADY_SYNCED(8420), + + + /** + * A generic error happened in the LibEuFin nexus. See the enclose details JSON for more information. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + LIBEUFIN_NEXUS_GENERIC_ERROR(9000), + + + /** + * An uncaught exception happened in the LibEuFin nexus service. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + LIBEUFIN_NEXUS_UNCAUGHT_EXCEPTION(9001), + + + /** + * A generic error happened in the LibEuFin sandbox. See the enclose details JSON for more information. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + LIBEUFIN_SANDBOX_GENERIC_ERROR(9500), + + + /** + * An uncaught exception happened in the LibEuFin sandbox service. + * Returned with an HTTP status code of #MHD_HTTP_INTERNAL_SERVER_ERROR (500). + * (A value of 0 indicates that the error is generated client-side). + */ + LIBEUFIN_SANDBOX_UNCAUGHT_EXCEPTION(9501), + + + /** + * This validation method is not supported by the service. + * Returned with an HTTP status code of #MHD_HTTP_NOT_FOUND (404). + * (A value of 0 indicates that the error is generated client-side). + */ + TALDIR_METHOD_NOT_SUPPORTED(9600), + + + /** + * Number of allowed attempts for initiating a challenge exceeded. + * Returned with an HTTP status code of #MHD_HTTP_TOO_MANY_REQUESTS (429). + * (A value of 0 indicates that the error is generated client-side). + */ + TALDIR_REGISTER_RATE_LIMITED(9601), + + + /** + * End of error code range. + * Returned with an HTTP status code of #MHD_HTTP_UNINITIALIZED (0). + * (A value of 0 indicates that the error is generated client-side). + */ + END(9999); +} + +@OptIn(ExperimentalSerializationApi::class) +@Serializer(forClass = TalerErrorCode::class) +object TalerErrorCodeSerializer : KSerializer<TalerErrorCode> { + + override val descriptor = + PrimitiveSerialDescriptor("TalerErrorCodeSerializer", PrimitiveKind.INT) + + override fun deserialize(decoder: Decoder): TalerErrorCode { + val code = decoder.decodeInt() + return enumValues<TalerErrorCode>().firstOrNull { + code == it.code + } ?: TalerErrorCode.UNKNOWN + } + + override fun serialize(encoder: Encoder, value: TalerErrorCode) { + error("Not supported") + } +} diff --git a/wallet/src/main/java/net/taler/wallet/backend/WalletBackendApi.kt b/wallet/src/main/java/net/taler/wallet/backend/WalletBackendApi.kt index a2b48b6..fba9885 100644 --- a/wallet/src/main/java/net/taler/wallet/backend/WalletBackendApi.kt +++ b/wallet/src/main/java/net/taler/wallet/backend/WalletBackendApi.kt @@ -17,171 +17,114 @@ package net.taler.wallet.backend import android.app.Application -import android.content.ComponentName -import android.content.Context -import android.content.Intent -import android.content.ServiceConnection -import android.os.Handler -import android.os.IBinder -import android.os.Message -import android.os.Messenger -import android.util.Log +import kotlinx.coroutines.DelicateCoroutinesApi import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.GlobalScope +import kotlinx.coroutines.launch import kotlinx.coroutines.withContext import kotlinx.serialization.KSerializer -import kotlinx.serialization.json.Json -import net.taler.lib.android.CustomClassDiscriminator -import net.taler.wallet.backend.WalletBackendService.Companion.MSG_COMMAND -import net.taler.wallet.backend.WalletBackendService.Companion.MSG_NOTIFY -import net.taler.wallet.backend.WalletBackendService.Companion.MSG_REPLY -import net.taler.wallet.backend.WalletBackendService.Companion.MSG_SUBSCRIBE_NOTIFY +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.JsonObject +import kotlinx.serialization.json.decodeFromJsonElement +import net.taler.wallet.backend.TalerErrorCode.NONE import org.json.JSONObject -import java.lang.ref.WeakReference -import java.util.LinkedList -import java.util.concurrent.ConcurrentHashMap -import java.util.concurrent.atomic.AtomicInteger -import kotlin.coroutines.resume -import kotlin.coroutines.suspendCoroutine -import kotlin.reflect.full.companionObjectInstance +import java.io.File +private const val WALLET_DB = "talerwalletdb.sqlite3" + +@OptIn(DelicateCoroutinesApi::class) class WalletBackendApi( private val app: Application, - private val notificationHandler: ((payload: JSONObject) -> Unit) + private val initialConfig: WalletRunConfig, + private val versionReceiver: VersionReceiver, + notificationReceiver: NotificationReceiver, ) { - private var walletBackendMessenger: Messenger? = null - private val queuedMessages = LinkedList<Message>() - private val handlers = ConcurrentHashMap<Int, (isError: Boolean, message: JSONObject) -> Unit>() - private var nextRequestID = AtomicInteger(0) - private val incomingMessenger = Messenger(IncomingHandler(this)) - private val walletBackendConn = object : ServiceConnection { - override fun onServiceDisconnected(p0: ComponentName?) { - Log.w(TAG, "wallet backend service disconnected (crash?)") - walletBackendMessenger = null - } + private val backendManager = BackendManager(notificationReceiver) - override fun onServiceConnected(componentName: ComponentName?, binder: IBinder?) { - Log.i(TAG, "connected to wallet backend service") - val bm = Messenger(binder) - walletBackendMessenger = bm - pumpQueue(bm) - val msg = Message.obtain(null, MSG_SUBSCRIBE_NOTIFY) - msg.replyTo = incomingMessenger - bm.send(msg) + init { + GlobalScope.launch(Dispatchers.IO) { + backendManager.run() + sendInitMessage() } } - init { - Intent(app, WalletBackendService::class.java).also { intent -> - app.bindService(intent, walletBackendConn, Context.BIND_AUTO_CREATE) + private suspend fun sendInitMessage() { + val db = if (File(app.filesDir, "talerwalletdb.sql").isFile) { + // can be removed after a reasonable migration period (2024-02-02) + "${app.filesDir}/talerwalletdb.sql" + } else { + "${app.filesDir}/${WALLET_DB}" } - } - private class IncomingHandler(strongApi: WalletBackendApi) : Handler() { - private val weakApi = WeakReference(strongApi) - override fun handleMessage(msg: Message) { - val api = weakApi.get() ?: return - when (msg.what) { - MSG_REPLY -> { - val requestID = msg.data.getInt("requestID", 0) - val operation = msg.data.getString("operation", "??") - Log.i(TAG, "got reply for operation $operation ($requestID)") - val h = api.handlers.remove(requestID) - if (h == null) { - Log.e(TAG, "request ID not associated with a handler") - return - } - val response = msg.data.getString("response") - if (response == null) { - Log.e(TAG, "response did not contain response payload") - return - } - val isError = msg.data.getBoolean("isError") - val json = JSONObject(response) - h(isError, json) - } - MSG_NOTIFY -> { - val payloadStr = msg.data.getString("payload") - if (payloadStr == null) { - Log.e(TAG, "Notification had no payload: $msg") - } else { - val payload = JSONObject(payloadStr) - api.notificationHandler.invoke(payload) - } - } - } + request("init", InitResponse.serializer()) { + put("persistentStoragePath", db) + put("logLevel", "INFO") + put("config", JSONObject(BackendManager.json.encodeToString(initialConfig))) + }.onSuccess { response -> + versionReceiver.onVersionReceived(response.versionInfo) + }.onError { error -> + // TODO expose this to the UI as it can happen when using an older DB version + error("Error on init message: $error") } } - private fun pumpQueue(bm: Messenger) { - while (true) { - val msg = queuedMessages.pollFirst() ?: return - bm.send(msg) + suspend fun setWalletConfig(config: WalletRunConfig): WalletResponse<InitResponse> { + return request("initWallet", InitResponse.serializer()) { + put("config", JSONObject(BackendManager.json.encodeToString(config))) } } - fun sendRequest( - operation: String, - args: JSONObject? = null, - onResponse: (isError: Boolean, message: JSONObject) -> Unit = { _, _ -> } - ) { - val requestID = nextRequestID.incrementAndGet() - Log.i(TAG, "sending request for operation $operation ($requestID)") - val msg = Message.obtain(null, MSG_COMMAND) - handlers[requestID] = onResponse - msg.replyTo = incomingMessenger - val data = msg.data - data.putString("operation", operation) - data.putInt("requestID", requestID) - if (args != null) { - data.putString("args", args.toString()) - } - val bm = walletBackendMessenger - if (bm != null) { - bm.send(msg) - } else { - queuedMessages.add(msg) - } + suspend fun sendRequest(operation: String, args: JSONObject? = null): ApiResponse { + return backendManager.send(operation, args) } suspend inline fun <reified T> request( operation: String, serializer: KSerializer<T>? = null, - noinline args: (JSONObject.() -> JSONObject)? = null + noinline args: (JSONObject.() -> JSONObject)? = null, ): WalletResponse<T> = withContext(Dispatchers.Default) { - suspendCoroutine { cont -> - val json = Json { - ignoreUnknownKeys = true - (T::class.companionObjectInstance as? CustomClassDiscriminator)?.let { - classDiscriminator = it.discriminator + val json = BackendManager.json + try { + when (val response = sendRequest(operation, args?.invoke(JSONObject()))) { + is ApiResponse.Response -> { + val t: T = serializer?.let { + json.decodeFromJsonElement(serializer, response.result) + } ?: Unit as T + WalletResponse.Success(t) } - } - sendRequest(operation, args?.invoke(JSONObject())) { isError, message -> - val response = try { - if (isError) { - val error = - json.decodeFromString(TalerErrorInfo.serializer(), message.toString()) - WalletResponse.Error(error) - } else { - val t: T = serializer?.let { - json.decodeFromString(serializer, message.toString()) - } ?: Unit as T - WalletResponse.Success(t) - } - } catch (e: Exception) { - val info = TalerErrorInfo(0, "", e.toString(), null) - WalletResponse.Error(info) + + is ApiResponse.Error -> { + val error: TalerErrorInfo = json.decodeFromJsonElement(response.error) + WalletResponse.Error(error) } - cont.resume(response) } + } catch (e: Exception) { + val info = TalerErrorInfo(NONE, "", e.toString()) + WalletResponse.Error(info) } } - fun destroy() { - // FIXME: implement this! - } + // Returns raw JSON response instead of serialized object + suspend inline fun rawRequest( + operation: String, + noinline args: (JSONObject.() -> JSONObject)? = null, + ): WalletResponse<JsonObject> = withContext(Dispatchers.Default) { + val json = BackendManager.json + try { + when (val response = sendRequest(operation, args?.invoke(JSONObject()))) { + is ApiResponse.Response -> { + WalletResponse.Success(response.result) + } - companion object { - const val TAG = "WalletBackendApi" + is ApiResponse.Error -> { + val error: TalerErrorInfo = json.decodeFromJsonElement(response.error) + WalletResponse.Error(error) + } + } + } catch (e: Exception) { + val info = TalerErrorInfo(NONE, "", e.toString()) + WalletResponse.Error(info) + } } } diff --git a/wallet/src/main/java/net/taler/wallet/backend/WalletBackendService.kt b/wallet/src/main/java/net/taler/wallet/backend/WalletBackendService.kt deleted file mode 100644 index f99f38d..0000000 --- a/wallet/src/main/java/net/taler/wallet/backend/WalletBackendService.kt +++ /dev/null @@ -1,253 +0,0 @@ -/* - * This file is part of GNU Taler - * (C) 2020 Taler Systems S.A. - * - * GNU Taler is free software; you can redistribute it and/or modify it under the - * terms of the GNU General Public License as published by the Free Software - * Foundation; either version 3, or (at your option) any later version. - * - * GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY - * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR - * A PARTICULAR PURPOSE. See the GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License along with - * GNU Taler; see the file COPYING. If not, see <http://www.gnu.org/licenses/> - */ - - -package net.taler.wallet.backend - -import android.app.Service -import android.content.Intent -import android.os.Handler -import android.os.IBinder -import android.os.Message -import android.os.Messenger -import android.os.RemoteException -import android.util.Log -import net.taler.akono.AkonoJni -import net.taler.wallet.BuildConfig.WALLET_CORE_VERSION -import net.taler.wallet.HostCardEmulatorService -import org.json.JSONObject -import java.lang.ref.WeakReference -import java.util.LinkedList -import java.util.concurrent.ConcurrentHashMap -import kotlin.system.exitProcess - -private const val TAG = "taler-wallet-backend" - -class RequestData(val clientRequestId: Int, val messenger: Messenger) - - -class WalletBackendService : Service() { - /** - * Target we publish for clients to send messages to IncomingHandler. - */ - private val messenger: Messenger = Messenger(IncomingHandler(this)) - - private lateinit var akono: AkonoJni - - private var initialized = false - - private var nextRequestID = 1 - - private val requests = ConcurrentHashMap<Int, RequestData>() - - private val subscribers = LinkedList<Messenger>() - - override fun onCreate() { - val talerWalletAndroidCode = - assets.open("taler-wallet-embedded-$WALLET_CORE_VERSION.js").use { - it.readBytes().toString(Charsets.UTF_8) - } - - - Log.i(TAG, "onCreate in wallet backend service") - akono = AkonoJni() - akono.putModuleCode("@gnu-taler/taler-wallet-embedded", talerWalletAndroidCode) - akono.setMessageHandler(object : AkonoJni.MessageHandler { - override fun handleMessage(message: String) { - this@WalletBackendService.handleAkonoMessage(message) - } - }) - //akono.evalNodeCode("require('source-map-support').install();") - akono.evalNodeCode("require('akono');") - akono.evalNodeCode("tw = require('@gnu-taler/taler-wallet-embedded');") - akono.evalNodeCode("tw.installNativeWalletListener();") - sendInitMessage() - super.onCreate() - } - - private fun sendInitMessage() { - val msg = JSONObject() - msg.put("operation", "init") - val args = JSONObject() - msg.put("args", args) - args.put("persistentStoragePath", "${application.filesDir}/talerwalletdb-v30.json") - akono.sendMessage(msg.toString()) - } - - /** - * Handler of incoming messages from clients. - */ - class IncomingHandler( - service: WalletBackendService, - ) : Handler() { - - private val serviceWeakRef = WeakReference(service) - - override fun handleMessage(msg: Message) { - val svc = serviceWeakRef.get() ?: return - if (!svc.initialized) Log.w(TAG, "Warning: Not yet initialized") - when (msg.what) { - MSG_COMMAND -> { - val data = msg.data - val serviceRequestID = svc.nextRequestID++ - val clientRequestID = data.getInt("requestID", 0) - if (clientRequestID == 0) { - Log.e(TAG, "client requestID missing") - return - } - val args = data.getString("args") - val argsObj = if (args == null) { - JSONObject() - } else { - JSONObject(args) - } - val operation = data.getString("operation", "") - if (operation == "") { - Log.e(TAG, "client command missing") - return - } - Log.i(TAG, "got request for operation $operation") - val request = JSONObject() - request.put("operation", operation) - request.put("id", serviceRequestID) - request.put("args", argsObj) - svc.akono.sendMessage(request.toString(2)) - Log.i( - TAG, - "mapping service request ID $serviceRequestID to client request ID $clientRequestID" - ) - svc.requests[serviceRequestID] = RequestData(clientRequestID, msg.replyTo) - } - MSG_SUBSCRIBE_NOTIFY -> { - Log.i(TAG, "subscribing client") - val r = msg.replyTo - if (r == null) { - Log.e( - TAG, - "subscriber did not specify replyTo object in MSG_SUBSCRIBE_NOTIFY" - ) - } else { - svc.subscribers.add(msg.replyTo) - } - } - MSG_UNSUBSCRIBE_NOTIFY -> { - Log.i(TAG, "unsubscribing client") - svc.subscribers.remove(msg.replyTo) - } - else -> { - Log.e(TAG, "unknown message from client") - super.handleMessage(msg) - } - } - } - } - - override fun onBind(p0: Intent?): IBinder? { - return messenger.binder - } - - private fun sendNotify(payload: String) { - var rm: LinkedList<Messenger>? = null - for (s in subscribers) { - val m = Message.obtain(null, MSG_NOTIFY) - val b = m.data - b.putString("payload", payload) - try { - s.send(m) - } catch (e: RemoteException) { - if (rm == null) { - rm = LinkedList() - } - rm.add(s) - subscribers.remove(s) - } - } - if (rm != null) { - for (s in rm) { - subscribers.remove(s) - } - } - } - - private fun handleAkonoMessage(messageStr: String) { - val message = JSONObject(messageStr) - when (val type = message.getString("type")) { - "notification" -> { - val payload = message.getJSONObject("payload") - if (payload.optString("type") != "waiting-for-retry") { - Log.v(TAG, "got back notification: ${message.toString(2)}") - } - sendNotify(payload.toString()) - } - "tunnelHttp" -> { - Log.v(TAG, "got http tunnel request! ${message.toString(2)}") - Intent().also { intent -> - intent.action = HostCardEmulatorService.HTTP_TUNNEL_REQUEST - intent.putExtra("tunnelMessage", messageStr) - application.sendBroadcast(intent) - } - } - "response" -> { - when (message.getString("operation")) { - "init" -> { - Log.d(TAG, "got response for init operation: ${message.toString(2)}") - initialized = true - sendNotify(message.toString(2)) - } - "reset" -> { - Log.v(TAG, "got back message: ${message.toString(2)}") - exitProcess(1) - } - else -> { - Log.v(TAG, "got back response: ${message.toString(2)}") - val payload = message.getJSONObject("result").toString(2) - handleResponse(false, message, payload) - } - } - } - "error" -> { - Log.v(TAG, "got back error: ${message.toString(2)}") - val payload = message.getJSONObject("error").toString(2) - handleResponse(true, message, payload) - } - else -> throw IllegalArgumentException("Unknown message type: $type") - } - } - - private fun handleResponse(isError: Boolean, message: JSONObject, payload: String) { - val id = message.getInt("id") - val rId = requests[id] - if (rId == null) { - Log.e(TAG, "wallet returned unknown request ID ($id)") - return - } - val m = Message.obtain(null, MSG_REPLY) - val b = m.data - b.putInt("requestID", rId.clientRequestId) - b.putBoolean("isError", isError) - b.putString("response", payload) - b.putString("operation", message.getString("operation")) - rId.messenger.send(m) - } - - companion object { - const val MSG_SUBSCRIBE_NOTIFY = 1 - const val MSG_UNSUBSCRIBE_NOTIFY = 2 - const val MSG_COMMAND = 3 - const val MSG_REPLY = 4 - const val MSG_NOTIFY = 5 - } -} diff --git a/wallet/src/main/java/net/taler/wallet/backend/WalletResponse.kt b/wallet/src/main/java/net/taler/wallet/backend/WalletResponse.kt index ab1ac80..3946457 100644 --- a/wallet/src/main/java/net/taler/wallet/backend/WalletResponse.kt +++ b/wallet/src/main/java/net/taler/wallet/backend/WalletResponse.kt @@ -19,26 +19,31 @@ package net.taler.wallet.backend import kotlinx.serialization.KSerializer import kotlinx.serialization.SerialName import kotlinx.serialization.Serializable -import kotlinx.serialization.descriptors.PrimitiveKind.STRING -import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor +import kotlinx.serialization.builtins.MapSerializer +import kotlinx.serialization.builtins.serializer +import kotlinx.serialization.descriptors.SerialDescriptor import kotlinx.serialization.encoding.Decoder import kotlinx.serialization.encoding.Encoder import kotlinx.serialization.json.JsonDecoder +import kotlinx.serialization.json.JsonElement import kotlinx.serialization.json.JsonObject -import org.json.JSONObject +import kotlinx.serialization.json.JsonPrimitive +import kotlinx.serialization.json.buildJsonObject +import kotlinx.serialization.json.jsonObject +import kotlinx.serialization.json.jsonPrimitive @Serializable sealed class WalletResponse<T> { @Serializable @SerialName("response") data class Success<T>( - val result: T + val result: T, ) : WalletResponse<T>() @Serializable @SerialName("error") data class Error<T>( - val error: TalerErrorInfo + val error: TalerErrorInfo, ) : WalletResponse<T>() fun onSuccess(block: (result: T) -> Unit): WalletResponse<T> { @@ -52,53 +57,78 @@ sealed class WalletResponse<T> { } } -@Serializable +@Serializable(with = TalerErrorInfoSerializer::class) data class TalerErrorInfo( // Numeric error code defined defined in the // GANA gnu-taler-error-codes registry. - val code: Int, + val code: TalerErrorCode, // English description of the error code. - val hint: String?, + val hint: String? = null, // English diagnostic message that can give details // for the instance of the error. - val message: String?, + val message: String? = null, - // Error details - @Serializable(JSONObjectDeserializer::class) - val details: JSONObject? + // Error extra details + val extra: Map<String, JsonElement> = mapOf(), ) { val userFacingMsg: String get() { return StringBuilder().apply { - append(code) - hint?.let { append(" (").append(it).append(")") } - message?.let { append(" ").append(it) } - details?.let { details -> - if (details.length() > 0) { - append("\n\n") - details.optJSONObject("errorResponse")?.let { errorResponse -> - append(errorResponse.optString("code")).append(" ") - append(errorResponse.optString("hint")) - } ?: append(details.toString(2)) + // If there's a hint in errorResponse, use it. + if (extra.containsKey("errorResponse")) { + val errorResponse = extra["errorResponse"]!!.jsonObject + if (errorResponse.containsKey("hint")) { + val hint = errorResponse["hint"]!!.jsonPrimitive.content + append(hint) } + } else { + // Otherwise, use the standard ones + hint?.let { append(it) } + message?.let { append(" ").append(it) } } }.toString() } + + fun getStringExtra(key: String): String? = + extra[key]?.jsonPrimitive?.content } -class JSONObjectDeserializer : KSerializer<JSONObject> { +class TalerErrorInfoSerializer : KSerializer<TalerErrorInfo> { + private val stringToJsonElementSerializer = MapSerializer(String.serializer(), JsonElement.serializer()) + + override val descriptor: SerialDescriptor + get() = stringToJsonElementSerializer.descriptor + + override fun deserialize(decoder: Decoder): TalerErrorInfo { + // Decoder -> JsonInput + require(decoder is JsonDecoder) + val json = decoder.json + val filtersMap = decoder.decodeSerializableValue(stringToJsonElementSerializer) + + val code = filtersMap["code"]?.let { + json.decodeFromJsonElement(TalerErrorCode.serializer(), it) + } ?: TalerErrorCode.UNKNOWN + val hint = filtersMap["hint"]?.let { + json.decodeFromJsonElement(String.serializer(), it) + } + val message = filtersMap["message"]?.let { + json.decodeFromJsonElement(String.serializer(), it) + } - override val descriptor = PrimitiveSerialDescriptor("JSONObjectDeserializer", STRING) + val knownKeys = setOf("code", "hint", "message") + val unknownFilters = filtersMap.filter { (key, _) -> !knownKeys.contains(key) } - override fun deserialize(decoder: Decoder): JSONObject { - val input = decoder as JsonDecoder - val tree = input.decodeJsonElement() as JsonObject - return JSONObject(tree.toString()) + return TalerErrorInfo(code, hint, message, unknownFilters) } - override fun serialize(encoder: Encoder, value: JSONObject) { - error("not supported") + override fun serialize(encoder: Encoder, value: TalerErrorInfo) { + encoder.encodeSerializableValue(JsonObject.serializer(), buildJsonObject { + put("code", JsonPrimitive(value.code.code)) + put("hint", JsonPrimitive(value.hint)) + put("message", JsonPrimitive(value.message)) + value.extra.forEach { (key, value) -> put(key, value) } + }) } } |