[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] 04/04: [reveal] each batch only takes one master seed (inst
From: |
gnunet |
Subject: |
[taler-docs] 04/04: [reveal] each batch only takes one master seed (instead of n) |
Date: |
Thu, 02 Jan 2025 22:31:55 +0100 |
This is an automated email from the git hooks/post-receive script.
oec pushed a commit to branch master
in repository docs.
commit 4978e3a9b0b95ac9e484ac09753f9d6e58d16c11
Author: Özgür Kesim <oec-taler@kesim.org>
AuthorDate: Mon Dec 30 16:59:47 2024 +0100
[reveal] each batch only takes one master seed (instead of n)
---
core/api-exchange.rst | 43 +++++++++++++++++++++++++++----------------
1 file changed, 27 insertions(+), 16 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 3ed10234..60a2b03e 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -2163,34 +2163,45 @@ This endpoint is called by the client
.. ts:def:: RevealRequest
interface RevealRequest {
- // Array of ``n`` of ``(kappa - 1)`` disclosed coin master secrets, from
- // which the coins' private key, blinding, nonce (for Clause-Schnorr),
+ // Array of ``(kappa - 1)`` disclosed batch secrets,
+ // from which for each of the n coins in a batch
+ // their coin master secret is derived,
+ // from which in turn their private key,
+ // blinding, nonce (for Clause-Schnorr),
// transfer private keys (in case of prior ``/melt``) and
- // age-restriction is calculated (in case of prior ``/withdraw``).
- disclosed_coin_secrets: DisclosedCoinSecret[][];
+ // age-restriction is calculated (in case of prior ``/withdraw``).
+ //
+ // TODO: add details about the derivation.
+ disclosed_batch_seeds: DisclosedBatchSeed[];
}
- .. ts:def:: DisclosedCoinSecret
+ .. ts:def:: DisclosedBatchSeed
- type DisclosedCoinSecret = MasterCoinSecret
- | AgeRestrictedCoinSecret
+ // For the reveal of n coins, contains the secret information
+ // from which n coin specific secrets are derived from.
+ // Details of the derivation depend of the specific sum type.
+ type DisclosedBatchSeed = BatchSeed
+ | AgeRestrictedBatchSeed;
- .. ts:def:: MasterCoinSecret
+ .. ts:def:: BatchSeed
- // The master key material from which the coins' private key ``coin_priv``,
- // blinding ``beta``, nonce ``nonce`` (for Clause-Schnorr) and
+ // The master seed material from which for n coins in a batch,
+ // each coins' private key ``coin_priv``, blinding ``beta``,
+ // nonce ``nonce`` (for Clause-Schnorr) and
// the transfer private key (to link the new coin to the previous)
// are derived.
- // TODO: specification of how exactly this derivation works.
- type MasterCoinSecret = string
+ //
+ // TODO: add specification of how exactly this derivation works.
+ type BatchSeed = string;
- .. ts:def:: AgeRestrictedCoinSecret
+ .. ts:def:: AgeRestrictedBatchSeed
- // The master key material from which the coins' private key ``coin_priv``,
- // blinding ``beta`` and nonce ``nonce`` (for Clause-Schnorr) itself are
+ // The master seed material from which for n coins in a batch,
+ // each the coins' private key ``coin_priv``, blinding ``beta``
+ // and nonce ``nonce`` (for Clause-Schnorr) itself are
// derived as usually in wallet-core. Given a coin's master key material,
// the age commitment for the coin MUST be derived from this private key as
// follows:
@@ -2209,7 +2220,7 @@ This endpoint is called by the client
// and calculate the corresponding Edx25519PublicKey as
// q[$AG] = Edx25519_derive_public(`PublishedAgeRestrictionBaseKey`,
f[$AG])
//
- type AgeRestrictedCoinSecret = string;
+ type AgeRestrictedBatchSeed = string;
.. ts:def:: PublishedAgeRestrictionBaseKey
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.