Skip to content

Commit 2e14fdc

Browse files
rename input divulgence to retroactive divulgence (#21387)
1 parent 400d9ce commit 2e14fdc

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

sdk/docs/manually-written/overview/explanations/ledger-model/ledger-privacy.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ Examine each party's projection in turn:
260260
Yet, the output of this transaction (contract #2) is used
261261
in the last commit of Alice's projection.
262262
Accordingly, contract #2 is shown as an input to the left, outside of the ledger.
263-
This effect is discussed below under :ref:`input divulgence <da-model-divulgence>`.
263+
This effect is discussed below under :ref:`retroactive divulgence <da-model-divulgence>`.
264264

265265
#. Bob's projection is analogous to Alice's:
266266
He sees everything of the second, third, and forth commit,
@@ -295,23 +295,23 @@ Divulgence is a deliberate choice in the design of Canton Ledgers and comes in t
295295
In general, there is no point in hiding the consequences of an action.
296296
Bob could anyway compute the consequences of the actions it is an informee of, because Daml is deterministic.
297297

298-
* **Input divulgence** refers to an input contract being shown to the non-informee witnesses of a node using this contract.
298+
* **Retroactive divulgence** refers to an input contract being shown to the non-informee witnesses of a node using this contract.
299299
For example, the Fetch on Bob's ``SimpleAsset`` (contract #2) is visible to Alice
300300
and Alice's projection therefore references this contract as an input
301301
even though the Create action for #2 is not part of Alice's projection.
302302

303-
Input divulgence enables Alice to validate the transactions in her projection
303+
Retroactive divulgence enables Alice to validate the transactions in her projection
304304
(see :ref:`da-model-consistency` for ledger integrity).
305305
That is, Alice can check that Bob does allocate a suitable ``SimpleAsset`` according to what she specified in her proposal.
306306

307-
Input divulgence does not make Alice a witness of the Create action for Bob's ``SimpleAsset`` (contract #2),
307+
Retroactive divulgence does not make Alice a witness of the Create action for Bob's ``SimpleAsset`` (contract #2),
308308
because an input contract is not the same as its Create action.
309309
In the diagrams, this distinction is visualized via the dashed border for input contracts and them being placed to the left.
310310

311311
Via the Ledger API's :externalref:`update service <com.daml.ledger.api.v2.UpdateService.GetUpdateTrees>`,
312312
a user can see the immediately divulged contracts in the trees of the parties' projection
313313
as these trees contain the Create nodes.
314-
In contrast, the Ledger API currently does not offer a means for a user to look up a contract ID of an input divulgence.
314+
In contrast, the Ledger API currently does not offer a means for a user to look up a contract ID of a retroactive divulgence.
315315

316316

317317

sdk/docs/sharable/overview/explanations/ledger-model/ledger-privacy.rst

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)