From de576548370947dbb0ac0a905c6c0ddc05476f99 Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Thu, 4 Mar 2021 12:00:56 +0100
Subject: update merchant spec'

---
 anastasis.rst | 44 +++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 41 insertions(+), 3 deletions(-)

(limited to 'anastasis.rst')

diff --git a/anastasis.rst b/anastasis.rst
index fc32343b..7c10d01f 100644
--- a/anastasis.rst
+++ b/anastasis.rst
@@ -1564,24 +1564,62 @@ Expected new state:
 
 **select_challenge:**
 
+Selecting a challenge takes various formats, depending on the method.
+Specifically, in the case of a security question, the answer should
+already be provided.
+
+Arguments (example):
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30"
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "answer": "answer to secure question"
+    }
+
+**pay:**
+
 Arguments (example):
 
 .. code-block:: json
 
     {
-        "challenge_index": 1
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30"
     }
 
 
 **solve_challenge:**
 
+Solving a challenge takes various formats, depending on the method and
+what is known about the answer.
+
 Arguments (example):
 
 .. code-block:: json
 
     {
-        "challenge_index": 1,
-        "solution": "answer to secure question"
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "answer": "answer to secure question"
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "pin": 1234
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "hash": "SOMEBASE32ENCODEDHASHVALUE"
     }
 
 
-- 
cgit v1.2.3