From 454cfe38028263d68058f694ca7bf1b2cffbc290 Mon Sep 17 00:00:00 2001
From: Florian Dold <florian.dold@gmail.com>
Date: Fri, 31 Jul 2020 20:43:58 +0530
Subject: wallet api

---
 taler-wallet.rst | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

(limited to 'taler-wallet.rst')

diff --git a/taler-wallet.rst b/taler-wallet.rst
index 78daad1a..2ac95df6 100644
--- a/taler-wallet.rst
+++ b/taler-wallet.rst
@@ -86,6 +86,69 @@ APIs and Data Formats
 
   These APIs are still a work in progress and *not* final.
 
+Envelope Format
+---------------
+
+All API responses and notifications are returned in the
+following envelope:
+
+.. ts:def:: WalletCoreResponseEnvelope
+
+   type WalletCoreResponseEnvelope =
+    | WalletCoreSuccess
+    | WalletCoreError
+    | WalletCoreNotification
+
+.. ts:def:: WalletCoreSuccess
+
+   export interface WalletCoreSuccess {
+     type: "response";
+     operation: string,
+     // ID to correlate success response to request
+     id: string;
+     // Result type depends on operation
+     result: unknown;
+   }
+
+.. ts:def:: WalletCoreError
+
+   export interface WalletCoreError {
+     type: "error";
+     operation: string,
+     // ID to correlate success response to request
+     id: string;
+     error: WalletCoreErrorInfo;
+   }
+
+.. ts:def:: WalletCoreNotification
+
+   export interface WalletCoreSuccess {
+     type: "notification";
+
+     // actual type is WalletNotification,
+     // to be documented here
+     payload: any;
+   }
+
+.. ts:def:: WalletCoreErrorInfo
+
+   export interface WalletCoreErrorInfo {
+     // Numeric error code defined defined in the
+     // GANA gnu-taler-error-codes registry.
+     talerErrorCode: number;
+
+     // English description of the error code.
+     talerErrorHint: string;
+
+     // English diagnostic message that can give details
+     // for the instance of the error.
+     message: string;
+
+     // Error details, type depends
+     // on talerErrorCode
+     details: unknown;
+   }
+
 Balances
 --------
 
-- 
cgit v1.2.3