taler-docs

commit 98c18ddc2d09df4dff6df7c53f3cad1edc44abd5
parent e4c7785eba4122ff2a841c3fbc2b4ad95ff228c4
Author: bohdan-potuzhnyi <bohdan.potuzhnyi@gmail.com>
Date:   Mon,  7 Sep 2026 20:12:01 +0200

more clarification of docs from current code

Diffstat:
M
core/merchant/get-fountain-info.rst
 | 
1
+
M
core/merchant/post-fountain-withdraw.rst
 | 
5
+++++
M
core/merchant/post-private-fountains.rst
 | 
1
+

3 files changed, 7 insertions(+), 0 deletions(-)
diff --git a/core/merchant/get-fountain-info.rst b/core/merchant/get-fountain-info.rst
@@ -55,6 +55,7 @@
       tokens_per_period_stash: Integer;
 
       // Number of key slots ahead the wallet may withdraw for.
+      // Between 0 and 12 inclusive, in addition to the current slot.
       key_window_size: Integer;
 
       // Token family metadata including the currently valid
diff --git a/core/merchant/post-fountain-withdraw.rst b/core/merchant/post-fountain-withdraw.rst
@@ -31,6 +31,10 @@
 
   The request must be a `FountainWithdrawRequest`.
 
+  At most 64 token envelopes may be submitted in total across all grants
+  in one request. Exceeding this limit returns ``400 Bad Request`` with
+  ``TALER_EC_GENERIC_PARAMETER_MALFORMED``.
+
   **Response:**
 
   :http:statuscode:`200 OK`:
@@ -86,6 +90,7 @@
       // key, as in the pay protocol. The number of envelopes is
       // counted against the grant's ``tokens_per_period_limit``
       // for that slot.
+      // Must be nonempty; the entire request may contain at most 64 envelopes.
       envelopes: TokenEnvelope[];
     }
 
diff --git a/core/merchant/post-private-fountains.rst b/core/merchant/post-private-fountains.rst
@@ -68,6 +68,7 @@
       // Number of key slots ahead of the current one the wallet
       // may withdraw tokens for. Bounds prefetching and the time
       // for which already-withdrawn promotional tokens remain usable.
+      // Must be between 0 and 12 inclusive; 0 allows only the current slot.
       key_window_size: Integer;
     }