diff options
author | Özgür Kesim <oec-taler@kesim.org> | 2022-10-04 20:46:58 +0200 |
---|---|---|
committer | Özgür Kesim <oec-taler@kesim.org> | 2022-10-04 20:46:58 +0200 |
commit | 4ea5d93b8bbe6424f0bf484dd9ac986c83d27d00 (patch) | |
tree | f80efe918f2c7e2cd5292a12b8b7471e2aa0b365 /design-documents | |
parent | f4564b57acd04dd34751ced8ecb2bd10974452a6 (diff) | |
download | docs-4ea5d93b8bbe6424f0bf484dd9ac986c83d27d00.tar.gz docs-4ea5d93b8bbe6424f0bf484dd9ac986c83d27d00.tar.bz2 docs-4ea5d93b8bbe6424f0bf484dd9ac986c83d27d00.zip |
added definitions of policies for deposits
Diffstat (limited to 'design-documents')
-rw-r--r-- | design-documents/006-extensions.rst | 5 | ||||
-rw-r--r-- | design-documents/032-auctions.rst | 22 |
2 files changed, 15 insertions, 12 deletions
diff --git a/design-documents/006-extensions.rst b/design-documents/006-extensions.rst index 576809ad..f70b8449 100644 --- a/design-documents/006-extensions.rst +++ b/design-documents/006-extensions.rst @@ -18,6 +18,7 @@ of 2021 and 2022: * Peer-to-peer payments * Anonymous age-restriction * Escrow service for anonymous auctions +* A general escrow service We call a feature an *extension* when it is *optional* for either the exchange, wallet or merchant to enable and support it. (However, enabling @@ -180,7 +181,9 @@ this: AGE_GROUPS = "8:10:12:14:16:18:21" -* TODO: Add examples for p2p. + [exchange-extension-policy_auction] + ENABLED = true + REPLAY_PROGRAM = "/usr/local/bin/taler-exchange-auction_replay" Merchant diff --git a/design-documents/032-auctions.rst b/design-documents/032-auctions.rst index 0f144988..3d8ccf0a 100644 --- a/design-documents/032-auctions.rst +++ b/design-documents/032-auctions.rst @@ -140,19 +140,19 @@ bid. The auction operator then runs the auction protocol with all participants until conclusion. Once the winner and price have been determined, the auction -operator POSTs the resulting transcript to a new ``/extensions/auction`` +operator POSTs the resulting transcript to a new ``/extensions/policy_auction`` endpoint of the exchange. Here, the extension-specific logic stores the transcript in its database (in a new table) and then simulates the auction -again (using libbrandt), again determining the winner and price. The -extension configuration (and thus ``/keys``) may stipendulate some fee(s) -charged by the exchange to handle the ``/extensions/auction`` request. The -fees should be covered by the seller. We note that the transcript inherently -contains the deposit confirmations originally issued by the exchange for the -auction. So, the exchange can identify all of the coins that were escrowed (it -should also double-check that the coins were escrowed for the correct -auction). It then refunds the bids from the loosing bidders, pays the price -to the seller from the winner (minus auction fee), and partially refunds the -winner the difference between the escrowed amount and the winning bid. +again (using libbrandt), again determining the winner and price. The extension +configuration (and thus ``/keys``) may stipendulate some fee(s) charged by the +exchange to handle the ``/extensions/policy_auction`` request. The fees should +be covered by the seller. We note that the transcript inherently contains the +deposit confirmations originally issued by the exchange for the auction. So, +the exchange can identify all of the coins that were escrowed (it should also +double-check that the coins were escrowed for the correct auction). It then +refunds the bids from the loosing bidders, pays the price to the seller from +the winner (minus auction fee), and partially refunds the winner the difference +between the escrowed amount and the winning bid. .. note:: |