taler-docs

commit 1496bf96e48eeef5dd25c601420c0f234a79d481
parent 5f6334a60612c93acd6eb09bed2b7610e10586ac
Author: Torsten Grote <t@grobox.de>
Date:   Mon,  4 May 2020 14:50:05 -0300

clarify wallet transactions API sorting

Diffstat:
M
taler-wallet.rst
 | 
7
++++++-

1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/taler-wallet.rst b/taler-wallet.rst
@@ -102,7 +102,10 @@ Transactions are all operations or events that are affecting the balance.
   .. ts:def:: TransactionsResponse
 
     interface TransactionsResponse {
-      // a list of past and pending transactions
+      // a list of past and pending transactions sorted by pending, timestamp and transactionId.
+      // In case two events are both pending and have the same timestamp,
+      // they are sorted by the transactionId
+      // (lexically ascending and locale-independent comparison).
       transactions: Transaction[];
     }
 
@@ -120,6 +123,8 @@ Transactions are all operations or events that are affecting the balance.
       timestamp: Timestamp;
 
       // true if the transaction is still pending, false otherwise
+      // If a transaction is not longer pending, its timestamp will be updated,
+      // but its transactionId will remain unchanged
       pending: boolean;
 
       // Raw amount of the transaction (exclusive of fees or other extra costs)