summaryrefslogtreecommitdiff
path: root/api-mint.rst
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2015-04-09 19:22:06 +0200
committerChristian Grothoff <christian@grothoff.org>2015-04-09 19:22:06 +0200
commit45ad7e9e66a500b5ce6a398589e4e505eebd213d (patch)
treef796d08d7f0cdbd1f6f0cef321552c64754ca3a3 /api-mint.rst
parent25f101af4c2e21f6213811d57a2d595bd9b603af (diff)
downloaddocs-45ad7e9e66a500b5ce6a398589e4e505eebd213d.tar.gz
docs-45ad7e9e66a500b5ce6a398589e4e505eebd213d.tar.bz2
docs-45ad7e9e66a500b5ce6a398589e4e505eebd213d.zip
older edits
Diffstat (limited to 'api-mint.rst')
-rw-r--r--api-mint.rst29
1 files changed, 5 insertions, 24 deletions
diff --git a/api-mint.rst b/api-mint.rst
index ea7a6b17..4b0be86a 100644
--- a/api-mint.rst
+++ b/api-mint.rst
@@ -160,6 +160,7 @@ In order group multipe coins, the customer generates a refreshing session key.
The request body must contain a JSON object with the following fields:
+ :<json int kappa: dimension `kappa` for the cut-and-choose protocol
:<json array new_denoms: List of `n` new denominations to order.
:<json string session_pub: Session public key
:<json string session_sig: Signature over the whole commitment
@@ -189,37 +190,17 @@ In order group multipe coins, the customer generates a refreshing session key.
:status 400 Bad Request: A request parameter is missing or malformed.
- :status 401 Gone: A coin `coin` has insufficient funds. Request body contains a JSON object with
- the following fields:
-
- :<fixme: Details showing that `coin` has insufficient funds to satisfy the request.
-
:status 403 Forbidden: Either a `coin_sig` or the `session_sig` is invalid.
:status 404 Not Found: The mint does not know one of the denomination keys `denom_pub` given in the request.
+ :status 409 Conflict: A coin `coin` has insufficient funds. Request body contains a JSON object with
+ the following fields:
- .. http:post:: /refresh/reveal
-
-.. http:post:: /refresh/commit
-
- Commit values for the cut-and-choose in the refreshing protocol.
- The request body must be a JSON object with the following fields:
-
-
- **Success Response**
-
- :status 202 Accepted: The mint accepted the commitment, but still needs more commitments.
-
- The response body contains a JSON object with the following fields:
- TODO..
+ :<fixme: Details showing that `coin` has insufficient funds to satisfy the request.
- **Error Response**
+ :status 412 Precondition failed: The client's choice of `kappa` is outside of the acceptable range.
- :status 400 Bad Request: A request parameter is missing or malformed.
- :status 403 Forbidden: The signature `sig` is invalid.
- :status 404 Not Found: The mint does not know the blind key `blindkey` given
- in the request.
.. http:post:: /refresh/reveal