[taler-docs] branch master updated: propose balance API for #6086

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 02507a8  propose balance API for #6086
02507a8 is described below

commit 02507a87fde4d3ef0a4c1a2bac20091aaf693a2b
Author: Christian Grothoff <address@hidden>
AuthorDate: Mon Feb 10 23:44:26 2020 +0100

    propose balance API for #6086
---
 core/api-wire.rst | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 52 insertions(+), 4 deletions(-)

diff --git a/core/api-wire.rst b/core/api-wire.rst
index 3f2b27d..1078a2d 100644
--- a/core/api-wire.rst
+++ b/core/api-wire.rst
@@ -154,7 +154,32 @@ Querying the transaction history
 
   **Response**
 
-  :status 200 OK: JSON object whose field ``incoming_transactions`` is an 
array of type `IncomingBankTransaction`.
+  :status 200 OK: JSON object of type `IncomingHistory`.
+
+  .. ts:def:: IncomingHistory
+
+    interface IncomingHistory {
+
+      // The incoming transactions
+      incoming_transactions : IncomingBankTransaction;
+
+      // Sum of all incoming transactions (ever) after the most
+      // recent transaction reported in the history.
+      total_incoming_end: Amount;
+
+      // Sum of all incoming transactions before the oldest
+      // transaction reported in the history.
+      total_incoming_start: Amount;
+
+      // Total amount that has been outgoing from this account
+      // from the beginning of time until now. Note that this
+      // number is always the latest value and thus independent
+      // of the time region covered by the history.  If the
+      // history includes the latest incoming transactions, this
+      // value can be used to calculate the balance after that
+      // latest transaction.
+      current_outgoing: Amount;
+    }
 
   .. ts:def:: IncomingBankTransaction
 
@@ -224,9 +249,32 @@ Querying the transaction history
 
   **Response**
 
-  :status 200 OK:
-    JSON object whose field ``outgoing_transactions`` is
-    an array of type `OutgoingBankTransaction`.
+  :status 200 OK: JSON object of type `OutgoingHistory`.
+
+  .. ts:def:: OutgoingHistory
+
+    interface OutgoingHistory {
+
+      // The outgoing transactions
+      outgoing_transactions : OutgoingBankTransaction;
+
+      // Sum of all outgoing transactions (ever) after the most
+      // recent transaction reported in the history.
+      total_outgoing_end: Amount;
+
+      // Sum of all outgoing transactions before the oldest
+      // transaction reported in the history.
+      total_outgoing_start: Amount;
+
+      // Total amount that has been incoming into this account
+      // from the beginning of time until now. Note that this
+      // number is always the latest value and thus independent
+      // of the time region covered by the history.  If the
+      // history includes the latest outgoing transactions, this
+      // value can be used to calculate the balance after that
+      // latest transaction.
+      current_incoming: Amount;
+    }
 
   .. ts:def:: OutgoingBankTransaction
 

-- 
To stop receiving notification emails like this one, please contact
address@hidden.