document age restriction fields

1 files changed, 19 insertions, 0 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 7fe88a4a..152e5499 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -391,6 +391,25 @@ Making the payment
 
       // URL of the exchange this coin was withdrawn from.
       exchange_url: string;
+
+      // Signature affirming the posession of the
+      // respective private key proving that the payer
+      // is old enough. Only provided if the paid contract
+      // has an age restriction and the coin is
+      // age-restricted.
+      minimum_age_sig?: EddsaSignature;
+
+      // Age commitment vector of the coin.
+      // Only provided if the paid contract
+      // has an age restriction and the coin is
+      // age-restricted.
+      age_commitment?: Edx25519PublicKey[];
+
+      // Hash over the agge commitment vector of the coin.
+      // Only provided if the paid contract
+      // does NOT have an age restriction and the coin is
+      // age-restricted.
+      h_age_commitment?: AgeCommitmentHash;
     }
 
   .. ts:def:: TokenPaySig