Commit Graph

1224 Commits

Author SHA1 Message Date
Stefano Baghino
0b662a77bd
Fix typo in HTTP JSON API Service docs (#13331)
Addresses https://github.com/digital-asset/daml/pull/13330/files#r829985080

changelog_begin
changelog_end
2022-03-18 15:29:46 +01:00
Stefano Baghino
a4abb4ef9e
Remove mentions of the token for package retrieval (#13330)
It has been removed some time ago.

changelog_begin
changelog_end
2022-03-18 12:53:30 +00:00
Stefano Baghino
24d3da70e8
Do not point at a milestone from the HTTP JSON API docs (#13281)
We recently started to use a project board to prioritize our work.

As such, we will soon remove our milestones and move relevant tickets
to the board after ensuring that all items that belong to us are
tracked by the appropriate team label (`team/app-runtime`).

changelog_begin
changelog_end
2022-03-14 16:31:35 +01:00
Stefano Baghino
4b864854a8
Improve description of the HTTP JSON API in the Ledger API docs (#13271)
Improve description of the HTTP JSON API in the Ledger API docs

changelog_begin
changelog_end

Fixes #13029
2022-03-14 14:59:20 +00:00
pbatko-da
92e3e9e2df
Add unit tests for ErrorCode [DPP-799] (#13236)
changelog_begin
changelog_end
2022-03-14 12:38:23 +01:00
Remy
851fb53083
add milli/micro-seconds to RelTime and fix doc (#13217)
CHANGELOG_BEGIN
CHANGELOG_END
2022-03-09 19:09:10 +00:00
Simon Maxen
cad7928220
Metering cleanup [DPP-937] (#13210)
* Make no-op metering logging debug

* Address statistic defaulting TODOs

* TODO replaced with ticket

* Switch to using assertLedgerMeteringEnd when ledgering end must be populated

* Note in docs that ledger metering is not affected by participant pruning

* Address review comments leftover from DPP-819

* Switch to using cSQL for options and offsets

changelog_begin
changelog_end
2022-03-09 19:06:04 +00:00
Simon Maxen
1d40c55177
Add metering report http endpoint [DPP-855] (#13147)
* Added metering report http endpoint

changelog_begin
Added metering report http endpoint
changelog_end

* Update with review comments
2022-03-09 14:59:08 +00:00
Moritz Kiefer
212bc9fdf3
Drop more controller can from the docs (#13215)
* Drop more controller can from the docs

changelog_begin
changelog_end

* .

changelog_begin
changelog_end
2022-03-09 11:35:54 +01:00
Moritz Kiefer
4e004e0a88
Replace scenario messages with script (#13207)
* Replace scenario messages with script

In theory we could try to be clever and print the "right" thing. In
practice, scenarios are almost dead so the complexity for that doesn’t
seem worth it.

fixes #13178

changelog_begin
changelog_end

* .
2022-03-09 11:35:37 +01:00
Gary Verhaegen
dfa648f585
hunt down DAML better (#13195)
Process:

- `git ls-files -z | xargs -0 -n 100 sed -i --follow-symlinks 's/DAML/Daml/g'`
- `git add -p`
- `git restore -p`
- Check there is no unstaged change left.

To review:

- Check for false positives by carefully reviewing the diff in this PR.
- Check for false negatives with `git grep DAML`.
- Quicker check for fals positives:

```
git grep DAML | grep -v migration | grep -v DAML_
```

Fixes #13190

Note: This is the "second half" of #13191, which failed to cover all the
remaining DAMLs because of:

```
$ git ls-files | grep "'"
compiler/damlc/tests/daml-test-files/MangledScenario'.daml
```

CHANGELOG_BEGIN
CHANGELOG_END
2022-03-08 17:04:58 +01:00
pbatko-da
96029b7cf3
[Docs] Expand User Management service section (and remove a duplicate section) [DPP-943] (#13108) 2022-03-02 18:59:40 +01:00
Stefano Baghino
f5c4755b76
Improve docs of auth middleware and trigger service (#13111)
* Improve docs of auth middleware and trigger service

changelog_begin
changelog_end

Fix #13049
Fix #13048

Several improvements to the documentation for these two services. The main aim was
to add, where needed, references to the new user management service. Ultimately,
only the auth middleware really needed to add a note about it, since to the trigger
service this is (so far) completely transparent.

For the rest, I took advantage of the chance to polish the docs a bit and make a few
improvements (that I will describe more in depth in a self-review).

* Prevent copy-pasting drama.

Thanks @S11001001

Co-authored-by: Stephen Compall <stephen.compall@daml.com>

* Address https://github.com/digital-asset/daml/pull/13111#discussion_r816967559

* Address https://github.com/digital-asset/daml/pull/13111#discussion_r816970609

* Address https://github.com/digital-asset/daml/pull/13111#discussion_r816973727

Co-authored-by: Stephen Compall <stephen.compall@daml.com>
2022-03-02 11:51:58 +00:00
Stefano Baghino
ef8a0e662d
Describe the behavior of different token formats in the HTTP JSON API (#13082)
Fixes #12440

changelog_begin
changelog_end
2022-02-28 17:15:21 +00:00
davidrichards-da
23dd7c3303
Removed two links (#13092)
CHANGELOG_BEGIN
CHANGELOG_END

Removed two links from identity and package management and overview.
2022-02-25 16:05:10 +00:00
davidrichards-da
585f695eb8
Adding an installing daml enterprise link (#13088)
CHANGELOG_BEGIN
CHANGELOG_END

Adding an installing daml enterprise link to help with the Canton Docs
2022-02-25 15:20:07 +00:00
Moritz Kiefer
c09e1d4b96
Document user management support in Navigator (#13085)
* Document user management support in Navigator

fixes #12934

changelog_begin
changelog_end
2022-02-25 16:11:51 +01:00
davidrichards-da
5dd6accb08
Adding a link to Daml Intro (#13074)
* Adding a link to Daml Intro

Adding a link to Daml Intro for Canton to link to.  Canton changes being made to link to this in the same docs, rather than the external links.

* Blank commit

CHANGELOG_BEGIN
CHANGELOG_END
2022-02-25 13:05:20 +00:00
Moritz Kiefer
5dfc2e4a98
Fix GSG to account for login requirement (#13073)
* Fix GSG to account for login requirement

You can only follow a user after they logged in so the previous order
did no longer work.

changelog_begin
changelog_end

* Update docs/source/getting-started/index.rst

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Update docs/source/getting-started/index.rst

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Update docs/source/getting-started/index.rst

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* fix borked sentence

changelog_begin
changelog_end

* Update docs/source/getting-started/index.rst

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

* Update docs/source/getting-started/index.rst

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>

Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
2022-02-25 13:07:56 +01:00
Simon Maxen
728f03c855
Participant metering documentation (#13070)
* Participant metering documentation

changelog_begin
Participant metering added to Daml operating insturctions documentation
changelog_end
2022-02-25 10:59:20 +00:00
carrielaben-da
55590d916b
Update app-architecture.rst (#12993)
* Update app-architecture.rst

Second-iteration changes to the App Architecture page, addressing User Management and the Alias contract.

[CHANGELOG_BEGIN]
[CHANGELOG_END]

* Update app-architecture - edits - 1

Which/ how many additional details about the public party do you want to include here? Or as another option, should it be explained in-depth elsewhere?

[CHANGELOG_BEGIN]
[CHANGELOG_END]

* Update docs/source/getting-started/app-architecture.rst

Adding Moritz's suggested changes

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/app-architecture.rst

Changed to Moritz's suggested wording.

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/app-architecture.rst

Adding Moritz's suggestion w/link.

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-24 10:18:40 -05:00
davidrichards-da
0ed1e0526b
Moving the 'testing your web app' page to the GSG (#13060)
* Moving the 'testing your web app' page to the GSG

CHANGELOG_BEGIN
CHANGELOG_END

Moving the 'testing your web app' page to the GSG

* Updating paths after moving the file

Updating paths after moving the file

* Adding the testing page to the pdf file too.

* Adding a link to the user management description

CHANGELOG_BEGIN
CHANGELOG_END

Adding a link to the user management description

* fixing link in first-feature linking to the moved page

fixing link in first-feature linking to the moved page

* Updating a link to the testing file

Updating a link to the testing file
2022-02-24 13:00:48 +00:00
davidrichards-da
0583b1879f
Updating the GSG architecture diagram (#13067)
CHANGELOG_BEGIN
CHANGELOG_END

Updating the GSG architecture diagram
2022-02-24 12:02:24 +00:00
Stefano Baghino
21769eaff5
Move Daml Helm Chart and Auth0 setup pages to early access (#13052)
Add a disclaimer that these pages do not work with Daml 2.0
but are under active development.

Closes #13038
Closes #13039

changelog_begin
changelog_end
2022-02-24 10:51:08 +00:00
Jennifer Whyte
2f86d8d37c
Update ledger overview list (#13030)
* Update ledger overview list

CHANGELOG_BEGIN
CHANGELOG_END

* Update deploying.rst

CHANGELOG_BEGIN
CHANGELOG_END

* Update deploying.rst

fixing typo

CHANGELOG_BEGIN
CHANGELOG_END

* Update app-arch.rst

Remove link to deleted page

* Update packages.rst

Remove more links to deploy page

CHANGELOG_BEGIN
CHANGELOG_END

* Update authorization.rst

changelog_begin
changelog_end

* Update packages.rst

Adding links back

CHANGELOG_BEGIN
CHANGELOG_END

* Update packages.rst

link fix

CHANGELOG_BEGIN
CHANGELOG_END

* Update docs/source/daml/reference/packages.rst

changelog_begin
changelog_end

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-23 16:03:23 -05:00
davidrichards-da
e33c8aa8a0
Replacing the Application Architecture Image (#13054)
* Replacing the Application Architecture Image

CHANGELOG_BEGIN
CHANGELOG_END

Replacing the Application Architecture Image for an updated version and making a few small changes in to the copy.

* Update docs/source/app-dev/app-arch.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Adding the path from the daml model to the DAR

Adding the missing path from the daml model to the DAR to the architecture image

* Update docs/source/app-dev/app-arch.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-23 19:48:31 +00:00
carrielaben-da
e4ba32dfe1
Releases and Versioning typo fix (#13058)
To address a typo in line 27

[CHANGELOG_BEGIN]
[CHANGELOG_END]

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
2022-02-23 14:12:32 -05:00
davidrichards-da
0153a4084f
Removing the 'ledger topologies' page (#13025)
* Removing the 'ledger topologies' page

Removing the 'ledger topologies' page as much of the content is wrong and Canton's 'Architecture in depth' section goes into this in much more detail.  Also removing links to this page.

* Removing links to the removed page

Removing links to the removed topology page

* Removing another link to the page being removed

* Removing another link no longer needed

* Removing another link to the deleted file.

CHANGELOG_BEGIN
CHANGELOG_END

Removing another link

* Remove references to topologies

CHANGELOG_BEGIN
CHANGELOG_END

* Correcting a spelling mistake

Correcting a spelling mistake

* Updating Daml for VMware Blockchain

Updating Daml for VMware Blockchain

Co-authored-by: bame-da <bernhard.elsner@digitalasset.com>
2022-02-23 16:07:26 +00:00
Simon Meier
7d0fadc3ca
user management: document limits (#13040)
* user management: document limits

CHANGELOG_BEGIN
CHANGELOG_END

Co-authored-by: Pawel Batko <pawel.batko@digitalasset.com>
2022-02-23 14:55:05 +01:00
Bernhard Elsner
0b38882505
Update the component statuses page (#13021)
* Update the component statuses page

CHANGELOG_BEGIN
CHANGELOG_END

* Update docs/source/support/component-statuses.rst
2022-02-23 12:41:07 +00:00
Bernhard Elsner
1af680cd55
Document the required node version for the JS Bindings (#13011)
* Document the required node version for the JS Bindings

CHANGELOG_BEGIN
CHANGELOG_END

* Update docs/source/ops/requirements.rst
2022-02-22 20:05:19 +01:00
Bernhard Elsner
cdd120dab9
Bump SDK version numbers to 2.0 where appropriate (#13013)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-22 16:47:35 +01:00
davidrichards-da
8afd7e4231
Updated the concepts and merged Cantons key concepts (#13010)
* Updated the concepts and merged Cantons key concepts

CHANGELOG_BEGIN
CHANGELOG_END

Updated the concepts in the glossary to, hopefully, agreeable terms and explanations.  I also merged Cantons key concepts into this file and I have removed Canton's concepts.rst file in this PR - https://github.com/DACH-NY/canton/pull/8658

* Made changes based on the comments left by Moritz

Made multiple changes based on the comments left by Moritz

* Removed two terms based on Mortiz feedback

Removed dalf clarification and part about parties interacting with the ledger.

* Updating the ledger definition

Updating the ledger definition to make the distinction between a ledger and a canton ledger for the inclusion of VMBC.

* Update docs/source/concepts/glossary.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/concepts/glossary.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/concepts/glossary.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/concepts/glossary.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Adding the links to the ledger description

Adding the links that I missed previously to the ledger description

* Removing the Atomic transaction description

Removing the Atomic transaction description - it's not needed in our docs & there are better definitions.

* Moved the participant node out of the Canton section

Moved the participant node out of the Canton section and removed the 'todos' at the top

* Fix missing new line after comment

Fixing due to build failing

* Adding trust domain back in

Adding 'trust domain' back in as we use it to link to from elsewhere.

* Update docs/source/concepts/glossary.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2022-02-22 14:39:07 +00:00
Moritz Kiefer
8a966bfaf3
Upgrade sphinx (#12968)
* Upgrade sphinx

Don’t want to be stuck on 1.8.3 forever. The current version is
4.4.0 (this upgrades to 4.3.1 which is the latest in nixpkgs).

I did had to drop footnotebackref. This runs into the same issue as
https://tex.stackexchange.com/questions/137594/hyperref-footnotebackref-in-longtable
but just copying the fix doesn’t work and I don’t understand enough
about the details here to fix this myself.

We have 7 footnotes in the Daml docs + some in the Canton docs. That
does not seem worth sticking on a sphinx version from 2018 for just to
get backreferences from footnotes to the link on the same page.

changelog_begin
changelog_end

* turns out you need fonts maybe

* .

changelog_begin
changelog_end

* suppport :force: in daml-docs

changelog_begin
changelog_end
2022-02-22 14:30:15 +00:00
mziolekda
61b09dc786
Mention error codes in the compatibility page of the daml documentation (#12981)
* Mention error codes in the compatibility paged of the daml documentation

CHANGELOG_BEGIN
CHANGELOG_END

* Rephrase the text
2022-02-21 16:30:47 +00:00
Moritz Kiefer
71fc3529e6
Improve --help ux for Canton sandbox (#12990)
* Improve --help ux for Canton sandbox

fixes #12985

changelog_begin
changelog_end

* .
2022-02-21 10:33:50 +01:00
Stephen Compall
fceb9c1118
document Java 11 is needed; small release instruction problems found today (#12978)
In docs:

* doc that we require Java 11, not 8

In release instructions:

* mention everywhere that all-lowercase party entries should be made

* wrong line number for variable go-to-defn check

CHANGELOG_BEGIN
CHANGELOG_END
2022-02-16 20:38:31 +00:00
mziolekda
f645641acf
Bump ledger api version to 2.0 (#12956)
CHANGELOG_BEGIN
Ledger API version 2.0
CHANGELOG_END
2022-02-16 11:55:49 +01:00
nicu-da
55fef9cf6a
[ledger-api] - Rename max deduplication time to max deduplication duration [KVL-1311] (#12939)
changelog_begin
ledger-api - rename ledger configuration max_deduplication_time to max_deduplication_duration
changelog_end
2022-02-15 21:14:26 +01:00
carrielaben-da
040c92f382
Getting Started Guide Update - First Draft (#12752)
* Update app-architecture.rst

* Update first-feature.rst

* Update index.rst

* Update installation.rst

* Update manual-download.rst

* Update path-variables.rst

* Revert "Update path-variables.rst"

This reverts commit 62f5554f2e.

* Revert "Update manual-download.rst"

This reverts commit e1cf0248a4.

* Revert "Update installation.rst"

This reverts commit ba229215ab.

* Revert "Update index.rst"

This reverts commit 052be7dc19.

* Revert "Update first-feature.rst"

This reverts commit 120d894ad6.

* Revert "Update app-architecture.rst"

This reverts commit 78ffa6d2c1.

* Getting Started Guide first draft updates

Changes to the individual pages of the Getting Started Guide

[CHANGELOG_BEGIN]
app-architecture.rst content and style edits
first-feature.rst style edits
index.rst style edits
installation.rst style edits
manual-download.rst style edits
path-variables.rst style edits
[CHANGELOG_END]

* Revert "Update path-variables.rst"

This reverts commit 62f5554f2e.

* Revert "Revert "Update path-variables.rst""

This reverts commit 674ca81999.

CHANGELOG_BEGIN
CHANGELOG_END

* Update docs/source/getting-started/index.rst

Accepting correction of type

[CHANGELOG_BEGIN]
"mke" to "make"
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/installation.rst

Changing header separation line (?)

[CHANGELOG_BEGIN]
Accepted line 70 comment
CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Addressing reviewer comments for PR "Getting Started Guide Update - First Draft"

Addressing comments related to the text. Screenshot updates to follow.

[CHANGELOG_BEGIN]
Line 97: New user name requirements
Lines 105-106: Adjusted terminology
[CHANGELOG_END]

* Update first-feature.rst to address comments in the Getting Started Guide Update - First Draft PR

Addressing @cocreature 's feedback

[CHANGELOG_BEGIN]
Line 23: Removed redundant instruction.
Line 85: Tense issue.
[CHANGELOG_END]

* Update app-architecture.rst for PR Getting Started Guide Update - First Draft

Incorporating suggested changes

[CHANGELOG_BEGIN]
Line 54: Adjusted description of naming terminology and behavior
[CHANGELOG_END]

* GSG changes attempt 3

Addresses existing comments; checks for heading formatting; updated screenshots.

[CHANGELOG_BEGIN]
Addresses existing comments; checks for heading formatting; updated screenshots.
[CHANGELOG_END]

* Update docs/source/getting-started/installation.rst

Formatting fix
[CHANGELOG_BEGIN]
Formatting fix
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* fix more formatting

changelog_begin
changelog_end

* Update docs/source/getting-started/index.rst

Further clarification of alias vs id
[CHANGELOG_BEGIN]
UI by their alias instead of their user id,
[CHANGELOG_END]

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Jennifer <jennifer.whyte@digitalasset.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-15 17:48:27 +00:00
Moritz Kiefer
6ed6ea36e8
Drop parties from daml templates (#12953)
Complements #12952 which drops it from create-daml-app by also
dropping it from the rest.

Couldn’t find any docs or other stuff that is broken by this.

changelog_begin
changelog_end
2022-02-15 17:21:32 +00:00
Jennifer Whyte
4df4db11e8
Add new toctrees in daml docs (#12880)
* Add toctrees in daml docs

CHANGELOG_BEGIN
CHANGELOG_END

* Update operating-daml.rst

Remove wrong link (ops/index>

CHANGELOG_BEGIN
CHANGELOG_END

* Making toc visible on new pages

Making toctrees visible so new pages aren't empty

* Update docs/source/building-applications.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Fix underlines

CHANGELOG_BEGIN
CHANGELOG_END

* Fix missing from toctree messages

CHANGELOG_BEGIN
CHANGELOG_END

* Fix pdf docs

changelog_begin
changelog_end

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-15 07:34:29 +00:00
Moritz Kiefer
8e32842f57
Switch docs for upgrade automation to Canton Sandbox (#12908)
changelog_begin
changelog_end
2022-02-14 14:08:32 +00:00
Moritz Kiefer
d6e6c568fe
Fold daml test-script under daml script --all (#12895)
I tried to keep the changes somewhat minimal and reuse what is already
there. I think there is a fair amount of cleanup we can do afterwards
but hopefully this way it’s easier to review.

fixes #12837

changelog_begin

- [Daml Script] `daml test-script` has been replaced by `daml script
  --all`. The option to spin up a ledger automatically has been
  removed and you always have to specify one.

changelog_end
2022-02-14 14:23:21 +01:00
Moritz Kiefer
a30c5c2ebc
Switch upgrade docs to Canton sandbox (#12904)
* Switch upgrade docs to Canton sandbox

Mainly requires explicitly allocating parties & users and dealing with
Navigator being annoying.

changelog_begin
changelog_end

* .

changelog_begin
changelog_end
2022-02-14 13:55:53 +01:00
mziolekda
d9d8083451
Remove references to pre-canton sandbox from documentation (#12888)
* Remove references to pre-canton sandbox from documentation

CHANGELOG_BEGIN
CHANGELOG_END

* address review comments
2022-02-11 13:57:44 +01:00
Kamil Bozek
9785101254
Remove references to the legacy error codes from docs (#12749)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-11 13:23:07 +01:00
mziolekda
42ff83d456
Remove daml on sql artifacts and docs (#12870)
* stop publishing daml on sql aka Daml Driver for PotgreSQL

CHANGELOG_BEGIN
Stop publishing Daml Driver for PostgreSQL
CHANGELOG_END
2022-02-10 18:01:18 +00:00
Raymond Roestenburg
0c08c1cb01
Create users in quickstart template. (#12868)
changelog_begin
changelog_end
2022-02-10 15:25:26 +01:00
Stefano Baghino
0fbf76599a
Restore comment about keeping Helm Chart docs in sync (#12862)
As noted by @garyverhaegen-da in https://github.com/digital-asset/daml/pull/12859#issuecomment-1034744480

Double checked that the comment syntax is used correctly and doesn't get
rendered on our docs.

changelog_begin
changelog_end
2022-02-10 10:58:04 +00:00
Stefano Baghino
1f247b0d40
Remove unnecessary comment from Helm Chart docs (#12859)
changelog_begin
changelog_end
2022-02-10 10:12:40 +00:00
Moisés Ackerman
e5c00c4dea
Replace quickstart scenarios with daml script (#12827)
* Replace references to scenarios with script in quickstart guide

* ensure initial part of trade_test matches initialize script

* update transaction view result

changelog_begin
changelog_end
2022-02-09 18:48:09 +01:00
Moritz Kiefer
eb19df6cd8
Setup infrastructure to cross-link to Canton docs (#12824)
* Setup infrastructure to cross-link to Canton docs

fixes #12811

changelog_begin
changelog_end

* .

changelog_begin
changelog_end
2022-02-09 16:21:56 +01:00
Moritz Kiefer
54e5e66e0b
Update Sandbox docs for Canton sandbox (#12796)
I tried finding some sensible balance between inlining things to make
them easily accessible for common stuff and referencing the upstream
docs but open to suggestions to shift that in either direction.

changelog_begin
changelog_end
2022-02-08 17:10:38 +01:00
Robert Autenrieth
f964c5d3c5
Use correct auth word (#12810)
changelog_begin
changelog_end
2022-02-08 13:42:01 +01:00
Moisés Ackerman
f0dd2de506
Remove scenarios from daml-studio docs (#12750)
* remove scenario from daml-studio Abort example

* remove scenario from daml-studio CreateAuthFailure example

* remove scenario from daml-studio ExerciseAuthFailure example

* remove scenario from daml-studio NotVisibleFailure example

* replace references to 'scenario' with 'script'

* update Iou copyright notice

* update daml-studio docs pictures

changelog_begin
changelog_end
2022-02-07 11:53:37 +01:00
matevarga-da
83b9d5ab0b
Fixing repetition by mistake in the docs of JSON API > Production Setup > Data Continuity (#12780)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-07 08:36:55 +01:00
Sergey Kisel
ce5030fc9a
Align Daml Script intro section of the docs with picture (#12742)
CHANGELOG_BEGIN
CHANGELOG_END
2022-02-04 12:36:52 +01:00
pbatko-da
6926e9adb4
Deprecate user identity service [DPP-862] (#12694)
changelog_begin
Ledger API Specification: Ledger Identity service is now deprecated.
changelog_end
2022-02-04 10:32:09 +01:00
Moritz Kiefer
486c869986
Replace most scenario references in the docs by Daml script (#12741)
* Replace most scenario references in the docs by Daml script

There are still some left in the Daml studio docs (should be updated)
and in quickstart-java (should be updated but probably not by us
🤷) but I’ll leave those for separate PRs.

changelog_begin
changelog_end

* delete unused code

changelog_begin
changelog_end
2022-02-03 15:55:55 +00:00
Moritz Kiefer
609537bd0d
Make gsg-trigger docs work with Canton (#12709)
Sadly most of these changes are not actually related to Canton but the
previous docs were already broken primarily because of the patch file
not making all the required changes.

I got the patch file as close as possible to the `messaging.patch` to
make it easier to keep them in sync. The fact that we have two patch
files that duplicate most of the code is something that we really need
to fix but not in this PR.

changelog_begin
changelog_end
2022-02-03 15:22:45 +01:00
Sergey Kisel
de444b29d7
Fix broken link in First Feature (#12735)
* Fix broken link in First Feature 

changelog_begin
changelog_end
2022-02-03 14:23:45 +01:00
Moritz Kiefer
7a5172c025
Make daml-script docs work with a Canton sandbox (#12695)
* Make daml-script docs work with a Canton sandbox

This addresses a few issues:

1. The `--wallclock-time` option does not work.
2. Display names are garbage so dropped the "solution" for
`listKnownParties`.
3. We cannot allocate fixed parties even with
`allocatePartyWithHint`. Switched to `--output-file` and user mgmt.

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* debug windows

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* debug scriptexample

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* .

changelog_begin
changelog_end

* Update docs/source/daml-script/index.rst
2022-02-02 21:01:44 +00:00
davidrichards-da
b4ed15bab7
Changed product names in the documentation (#12668)
* Changes to product names

CHANGELOG_BEGIN
CHANGELOG_END

Terminology changes made:
- Removing reference to 'Connect'
- Changing the product names

* Update docs/source/support/overview.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/getting-started/installation.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/auth0.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/auth0.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/helm.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/helm.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/ops/connect/index.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/support/compatibility.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/support/compatibility.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Update docs/source/tools/trigger-service/auth0_example.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2022-02-01 15:15:12 +01:00
Moisés Ackerman
e4764cc426
Upgrade to GHC 9.0.2 (#12300)
changelog_begin
changelog_end

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2022-02-01 11:27:11 +01:00
Moritz Kiefer
1238e1b66b
Update profiling documentation to Canton sandbox (#12680)
changelog_begin
changelog_end
2022-02-01 10:00:53 +01:00
Victor Peter Rouven Müller
100c59fc24
[JSON-API] Docs for user management endpoints (#12432)
* Update user-endpoint docs to newest implementation changes

* Add the missing star!

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>

* More stars!

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>

* Remove reference and shorten endpoint descriptions

* Use the right rule for capitalizing in titles

* Update docs/source/json-api/index.rst

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* Use user ID instead of user id

changelog_begin

- [HTTP-JSON] Added documentation for the new user management endpoints

changelog_end

* Apply suggestions from code review

Co-authored-by: Simon Meier <meiersi-da@users.noreply.github.com>

* Update docs for endpoint adjustments & address review comments

* Fix build error

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
Co-authored-by: Simon Meier <meiersi-da@users.noreply.github.com>
2022-01-31 18:05:21 +01:00
nicu-da
c1afabe653
[participant-state] Add earliest_offset metadata to pruned data error [kvl-1270] (#12546) 2022-01-31 16:54:24 +00:00
Moisés Ackerman
dcd721da99
Drop scenarios (#12484)
* Remove scenarios from user examples

* Remove scenarios from tests

* implicitly enable scenario service for doctests

changelog_begin
changelog_end
2022-01-24 18:42:42 +01:00
Simon Meier
01447fd489
docs: typos and minor clarification for authz docs (#12534)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-24 10:42:30 +01:00
Andreas Lochbihler
20cda0181a
specify that deduplication offsets are exclusive (#12488)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-21 09:52:33 +01:00
Simon Meier
0f8e40c92d
user management: add reference docs (#12398)
CHANGELOG_BEGIN
CHANGELOG_END
2022-01-20 10:32:28 +00:00
mziolekda
82534f9155
Remove the reset service from the ledger api and the documentation [DPP-804] (#12472)
* Remove reset service from grpc and documentation [DPP-804]

CHANGELOG_BEGIN
Remove reset service from the ledger api protocol and the documentation
CHANGELOG_END

* remove reset service from two left-over places

* remove reset service from the protobuf structure test
2022-01-19 14:46:50 +01:00
Sofia Faro
b2a7f9e640
Change default sandbox to canton (#12438)
* Change default sandbox to canton.

Some progress on #11831

* made `daml start` use canton sandbox by default
  * changed the non-ledger api ports to use free ports by default
    (still haven't tried using port 0 instead of `getFreePort`).
* renamed `daml sandbox-canton` to `daml sandbox`
* implement a `--static-time` option for `daml sandbox` that sets the
  canton clock type parameter to `sim-clock`
* moved the quickstart-java integration test to use the new sandbox
  * the test uses `--static-time`, but doesn't really depend on it

changelog_begin
changelog_end

* fix parens

* fix hot reload test

* reinstant --sandbox-kv in create-daml-app test for now

* fix damlStart test
2022-01-18 09:10:58 +00:00
Moritz Kiefer
2005068e3e
Drop platform-version support from daml.yaml (#12397)
* Drop `platform-version` support from `daml.yaml`

Doesn’t work properly with Canton sandbox, nobody uses it and product
agreed to deleting it.

changelog_begin
changelog_end

* drop run-platform-jar

changelog_begin
changelog_end

* fix run-jar commands

changelog_begin
changelog_end
2022-01-13 16:32:24 +00:00
akshayshirahatti-da
50de6e3639
[JSON-API] HOCON config json api (#12236)
* Change heartBeatPer to more intuitive naming of heartbeatPeriod

CHANGELOG_BEGIN
CHANGELOG_END

* Initial changes to add HOCON config for json_api

CHANGELOG_BEGIN
CHANGELOG_END

* avoid IllegalArgumentException noise

* use named arguments in big config conversion

* Changes include
 - tests for a full http-json-api config file
 - logging config and non-repudiation config is still specified via cli args.
 - config readers for MetricsReporter

* Add defaults to WebsocketConfig case class to allow partially specifying fields on typeconf file

* changes to the JwtVerifierBase config reader and equivalent test

* message already describes the value

* replace manual succeed/fails with scalatest combinators

* use qualified imports for WebsocketConfig defaults

* add back autodeleted empty lines

* collapse two lists of token verifiers into one

* add new line to config files

* rename dbStartupMode to startMode to keep consistent with cli option and for easy documentation

* Changes to daml docs to specify ways to run JSON-API by supplying a HOCON config file.

CHANGELOG_BEGIN
JSON-API can now be started supplying a HOCON application config file using the `--config` option.
All CLI flags except `logging` and `non-repudiation` one's are now deprecated and will be cleaned up in some future releases.
CHANGELOG_END

Co-authored-by: Stephen Compall <stephen.compall@daml.com>
2022-01-10 23:07:07 +00:00
akshayshirahatti-da
4f4d18829b
[Trigger-Service] Changes to use a typeconfig conf for trigger-service when provided. (#12217)
* Changes to add the option of starting trigger service with typeconf/HOCON config

CHANGELOG_BEGIN
CHANGELOG_END

* add tests for authorization config and fail on both config file and cli args

* refactor and cleanup config loading and tests

* Changes based on code review comments

* Daml doc changes and making sure that we have defaults for most fields to mirror cli args

CHANGELOG_BEGIN
Trigger Service can now be configured with HOCON config file.
 - If a config file is provided we will choose to start the service using that, else we will fallback to cli arguments.
 - If both config file and cli args are provided we will error out.
CHANGELOG_END

* addressing some more code review comments

* use scalatest inside properly
2022-01-06 00:12:47 +00:00
Gary Verhaegen
d2e2c21684
update copyright headers (#12240)
New year, new copyright, new expected unknown issues with various files
that won't be covered by the script and/or will be but shouldn't change.

I'll do the details on Jan 1, but would appreciate this being
preapproved so I can actually get it merged by then.

CHANGELOG_BEGIN
CHANGELOG_END
2022-01-03 16:36:51 +00:00
Stefano Baghino
52110e31a3
Remove Extractor (#12188)
* Remove Extractor

Extractor is being removed after a long time being in Labs status.

This should improve the flakiness on CI.

🔥

changelog_begin
Extractor has been removed from the SDK
changelog_end

* Remove Extractor documentation

* Remove Extractor from CODEOWNERS

* Remove Extractor references in Daml-LF build files

* Remove Extractor references in the Daml SDK assistant

* Remove Extractor from the SDK

* Remove Extractor reference from CONTRIBUTING.md
2021-12-17 13:43:23 +00:00
Stefano Baghino
42adfdc857
Get rid of deprecated components (#12167)
* Get rid of deprecated components

Removes:
- mentions of the Node.js bindings
- mentions of the Scala bindings
- usage of the Scala codegen as an SDK tool
- Java bindings "reactive components"

changelog_begin
The Node.js bindings are no longer supported as part of the Daml SDK
The Scala bindings are no longer supported as part of the Daml SDK
The Java bindings reactive components are no longer supported as part of the Daml SDK
The `daml codegen` command has dropped support for Scala
changelog_end

* Fix typo noticed by @cocreature

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Address https://github.com/digital-asset/daml/pull/12167#issuecomment-995714093

* Remove quickstart-scala from the SDK tarballs

* Fix failing codegen test

* Address https://github.com/digital-asset/daml/pull/12167#pullrequestreview-833991243

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-12-16 16:55:19 +00:00
akshayshirahatti-da
4745768ad4
[Oauth2-Middleware] Changes to introduce HOCON+pureconfig for oauth2-middleware (#12061)
* Changes to introduce HOCON+pureconfig for oauth2-middleware

CHANGELOG_BEGIN
CHANGELOG_END

* remove Cli arg parsing code + cleanup based on code review

* addition of a minimal config and changes to README.md

* keep existing cli args, but load from config file if provided

* fix broken docs build

* make tests OS independent

* Fail/error on supplying both config file and cli opts for startup, address code review comments
2021-12-16 16:36:32 +00:00
Simon Meier
64e228b72b
integration-kit: remove all its docs (#12157)
CHANGELOG_BEGIN
- [Daml Integration Kit]: removed from Daml 2.0
CHANGELOG_END
2021-12-16 10:30:19 +01:00
Andreas Lochbihler
9a931854b2
add docs for command dedup (#11928)
CHANGELOG_BEGIN
Documentation on the new command deduplication mechanism
CHANGELOG_END
2021-12-14 09:36:32 +01:00
Bernhard Elsner
78a0677fb1
Fix command in triggers docs (#12123)
CHANGELOG_BEGIN
CHANGELOG_END
2021-12-13 15:35:33 +01:00
pbatko-da
25ae69eb01
[DPP-657] Make error codes docs nicer (#12079)
Changes:
1. Limit local table of contents depth in HTML view.
2. Move some subsections higher up in the hierarchy.
3. Move error categories inventory right before error codes inventory.

CHANGELOG_BEGIN
CHANGELOG_END
2021-12-10 17:24:27 +01:00
pbatko-da
99091db18c
[DPP-771][Error codes] Add readme.md and supplement docs with a concrete error handling example. (#11990)
CHANGELOG_BEGIN
CHANGELOG_END
2021-12-08 13:09:21 +01:00
Bernhard Elsner
80768427d0
Add Java and database compatibility docs. (#11979)
* Add Java and database compatibility docs.
CHANGELOG_BEGIN
CHANGELOG_END
* Update the versions we test on to match reality
2021-12-06 12:15:33 +00:00
Moisés Ackerman
0b79d8ae7c
Deprecate 'controller ... can' syntax (#11363)
Closes #11317

* Add warning for uses of 'controller ... can' syntax

* Remove uses of 'controller ... can' syntax

* Add test cases for -W{,no-}controller-can

* Update docs to reflect 'controller ... can' syntax deprecation

changelog_begin
* Deprecate 'controller ... can' syntax.
  * It will be removed in a future version of Daml.
  * Instead, use 'choice ... with ... controller' syntax. Note that this does not implictly add the controller as an observer, so it must be added explictly as one (or as a signatory).
changelog_end
2021-12-01 13:36:04 +01:00
pbatko-da
5641948410
[Docs] Add labels to error codes to support references to them (#11913)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-30 14:30:58 +01:00
Andreas Lochbihler
5a9481f9d8
unify heading markup according to README.md (#11919)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-30 11:32:09 +01:00
pbatko-da
c27406cdcf
[DPP-762][Self-service error codes] Automate generation of inventory of error categories. #11879
Other changes:
- Fix ErrorCodeDocumentationGeneratorSpec not being in any bazel target.
- (partially) Fix inconsistent usage of deprecated, Deprecation and DeprecatedDocs annotation.

CHANGELOG_BEGIN
CHANGELOG_END
2021-11-26 10:22:14 +01:00
Sofia Faro
2f8f69e7cb
Drop DA.Next.Set and DA.Next.Map (#11864)
* Drop DA.Next.Set and DA.Next.Map

Fixes #11527. Also removed a bunch of unnecessary CPP, though there's
still a lot more CPP to remove.

changelog_begin

- [Daml Standard Library] DA.Next.Map and DA.Next.Set have been removed
  after being deprecated since Daml-LF 1.11

changelog_end

* Drop a deriving MapKey

* update unstable-types test
2021-11-25 13:02:08 +00:00
pbatko-da
5f3a4d2067
[Self-service error codes] Fix section numbering in pdf for error codes section by moving it a level higher. (#11867)
Also make section header markers consistent docs' reamde.

CHANGELOG_BEGIN
CHANGELOG_END
2021-11-25 13:46:12 +01:00
pbatko-da
066da4f30c
[Self-service error codes] Small fixes for docs/scripts/live-preview.sh (#11856)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-24 19:23:06 +01:00
Stefano Baghino
258fb65d1c
Document how to deal with HTTP JSON API schema changes (#11336)
* Document how to deal with HTTP JSON API schema changes

changelog_begin
[HTTP JSON API] [Docs] Document lack of data continuity guarantees and how to deal with schema changes
changelog_end

Furthermore: uses HTTP JSON API instead of HTTP-JSON API consistently,
drops the capitalization of query store in the documentation and fixes
hyphening in a few places

* Fix title markup
2021-11-24 18:05:30 +00:00
pbatko-da
9461702309
[DPP-673][Self-service error codes] Split one narrow migration table into multiple narrower ones to fit in the generated pdf's pages. (#11803)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-23 17:38:31 +01:00
pbatko-da
55191847cd
[DPP-673][Self-service error-codes] Generate error code directory compatible with both pdf and html docs (#11794)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-23 15:30:48 +01:00
Stephen Compall
e6c8229594
port #11798 documentation changes to json-api HTTP codes documentation (#11823)
- see c4b6a17da1

CHANGELOG_BEGIN
CHANGELOG_END
2021-11-23 13:16:46 +00:00
tudor-da
c4b6a17da1
[Self-service error codes] Update existing error code references [DPP-593] (#11798)
* Updated Ledger API services protobuf definitions

CHANGELOG_BEGIN
CHANGELOG_END

* Adapted Building Applications / Ledger API / gRPC section

* Moved Error Codes under Building Applications / Ledger API / gRPC

* Small rewording Error codes page

* Updated outdated LedgerAPI / gRPC page

* Apply suggestions from code review

Co-authored-by: pbatko-da <pawel.batko@digitalasset.com>

* Moved Error Codes under Building Applications / Ledger API / gRPC

* Updated outdated LedgerAPI / gRPC page

* Addressed review comments

* Addressed review comments

* Remove unnecessary link to error-codes

* `Ledger API` changed to `Common Ledger API change`

Co-authored-by: pbatko-da <pawel.batko@digitalasset.com>
2021-11-22 18:39:25 +00:00
tudor-da
8e31e8e6a8
[Self-service error codes] Enabled by default [DPP-691] (#11685)
* [Self-service error codes] Enabled by default
* Flag changed to `use-pre-1.18-error-codes` (disabled by default)

CHANGELOG_BEGIN
[Ledger API Specification] The Ledger API returns enriched error codes (see https://docs.daml.com/error-codes/self-service/index.html)
For backwards-compatibility, a new API flag `--use-pre-1.18-error-codes` is introduced for preserving the legacy behavior for
clients that want to migrate incrementally to the changed gRPC status code responses and error details format.
CHANGELOG_END

* Adapted HttpServiceIntegrationTest

* Renamed `Feature Flag` to `Configuration` in docs

* Fix Daml Script tests

changelog_begin
changelog_end

* Fix Repl functests

changelog_begin
changelog_end

* Fix haskell binding tests

changelog_begin
changelog_end

* Fix CommandClientIT test

* Fixed Sandbox and CommandServiceBackpressureIT tests
 Please enter the commit message for your changes. Lines starting

* Adapt //compiler/damlc/tests:repl-functests again

* Fix more tests and address Miklos' comments
* Flag name changed to `grpc-status-codes-compatibility-mode`

* Remove useless flags sandbox-classic

* Sandbox-classic tests fix for ContractKeysIT and ExceptionsIT
* Created 2 deprecated test suites that have the more generic assertions as returned
by the deprecated in-memory backend

* More fixes for CommandServiceIT
* Fixes compilation issue with the deprecated exceptionsIT class for Sandbox-classic in-memory

* Compatibility mode for old test tools

* Change flag name to `use-pre-1.18-error-codes`

* Apply suggestions from code review

Co-authored-by: Miklos <57664299+miklos-da@users.noreply.github.com>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Miklos <57664299+miklos-da@users.noreply.github.com>
2021-11-22 12:26:48 +00:00
pbatko-da
2e789ddf37
[DPP-417][Self-service error codes][Docs] Add more complete information for forking gRPC status codes. (#11739)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-18 17:03:10 +01:00
Miklos
4106222ab8
Fix docs regarding deduplication periods [KVL-1194] (#11738)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-18 11:45:01 +01:00
tudor-da
b0a1bf79df
More missing error codes (#11749)
* Missing error codes in Sandbox classic

CHANGELOG_BEGIN
CHANGELOG_END

* Covering more errors above the persistence layer

* Fix wrong contextualizedErrorLoggers

* Compilation fixes
2021-11-18 10:00:43 +00:00
Stephen Compall
7e4acf97fc
link to doc detailing gRPC-to-HTTP code mapping (#11742)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-17 15:44:08 +00:00
tudor-da
a05a40aeec
[Self-service error codes] Adapt ResetService in Sandbox classic (#11731)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-17 11:11:54 +01:00
pbatko-da
122a4ccd0d
[DPP-417][Self-service error codes][Docs] Mention that correlation id is usually submission id. (#11728)
CHANGELOG_BEGING
CHANGELOG_END
2021-11-17 08:07:44 +00:00
mziolekda
ccbf714078
expand the text about errors in the log [DPP-755] (#11723)
* expand the text about errors in the log

* scrap the entire logging section
2021-11-16 22:21:35 +00:00
tudor-da
fbc436d70a
[DPP-739][Self-service error codes] Adapt QueueBackedTracker error codes (#11719)
* [Self-service error codes] Adapt QueueBasedTracker

CHANGELOG_BEGIN
CHANGELOG_END

* Added changed error codes to migration guide

* Fixed ErrorFactoriesSpec

* Update ledger/error/src/main/scala/com/daml/error/definitions/LedgerApiErrors.scala

Co-authored-by: mziolekda <marcin.ziolek@digitalasset.com>

Co-authored-by: Pawel Batko <pawel.batko@digitalasset.com>
Co-authored-by: mziolekda <marcin.ziolek@digitalasset.com>
2021-11-16 22:21:29 +00:00
pbatko-da
07cff7cdb7
[DPP-417][Self-service error-codes] Document error categories. (#11727)
* [Self-service error-codes] Docs intro WIP

* CHANGELOG_BEGIN
CHANGELOG_END

* 1

* Fix rst

CHANGELOG_BEGIN
CHANGELOG_END

* [DPP-417][Self-service error-codes] Document error categories.

CHANGELOG_BEGIN
CHANGELOG_END

* 1

* Fix
2021-11-16 22:55:35 +01:00
tudor-da
c1f4beb328
Ledger ID mismatch does not change error codes. (#11720)
* Remains NOT_FOUND

CHANGELOG_BEGIN
CHANGELOG_END
2021-11-16 17:05:09 +00:00
pbatko-da
a29fee925c
[Self-service error-codes] Add introductory section to self-service error codes page. (#11712) 2021-11-16 16:41:41 +01:00
tudor-da
05f604d672
[Self-service error codes] Enrich migration guide [DPP-755] (#11711)
* Adapted migration guide to include changes from https://github.com/digital-asset/daml/pull/11686

CHANGELOG_BEGIN
CHANGELOG_END

* Enriched migration guide with Sandbox-classic changed gRPC error codes

* Added migration guide for error codes changed in KV committer

* Extract the KV and Sandbox-classic migration guides

* Hierarchical order of error codes docs

* Added back full grpc error code description to columns
* Using "gRPC status code" instead of "gRPC error code"
* Addressed review comments from Hubert

* Apply suggestions from code review

Co-authored-by: Miklos <57664299+miklos-da@users.noreply.github.com>

* Addressed review comments
* Use 'Error codes' instead of 'Self-service error codes'

Co-authored-by: Miklos <57664299+miklos-da@users.noreply.github.com>
2021-11-16 14:25:53 +00:00
pbatko-da
81e24504d4
[DDP-596][Self-service error codes] Add migration guide (#11632)
CHANGELOG_BEGIN
CHANGELOG_END
2021-11-12 10:07:37 +01:00
Stephen Compall
22d916baed
party-set arguments for JSON API (#11454)
* add actAs, readAs to `meta` for create, exercise, createAndExercise endpoints

* use meta actAs, readAs to control how contract IDs are looked up for exercise

* outdated comments on JwtWritePayload and JwtPayload

* toSet1 operator to clean up some NEL manipulation

* take optional readAs argument for query endpoint

* use readAs for query POST

* check whether readAs is safe in query endpoint

* missed CommandMeta args in tests

* FetchRequest, a domain model to layer on "fetch" endpoint's ContractLocator

- ContractLocator was overloaded as a domain request model *and* a component
  of other domain request models; the addition of new arguments means it can
  no longer exactly meet the former, and adding "readAs" to it would poison it
  for the latter cases.

* take readAs argument from fetch endpoint

* add readAs security check from query to fetch

* move jwt parties functions to util

* testing the party-set/JWT functions

* missing headers

* caught boolean blindness in readAs security checks

* test that meta params are used for commands

* make resolveRefParties do a subset check, too

* Revert "make resolveRefParties do a subset check, too"

This reverts commit 40a66f102c.

* test that the readAs auth check actually applies

* test that command service uses meta readAs, actAs

* note on test coverage

* add changelog

CHANGELOG_BEGIN
- [JSON API] ``actAs`` and ``readAs`` may be specified for create, exercise,
  create-and-exercise, non-WS fetch, and non-WS query.
  See `issue #11454 <https://github.com/digital-asset/daml/pull/11454>`__.
CHANGELOG_END

* no saving mallocs

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* untabify

Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>

* move design comment to comment from function name

- suggested by @cocreature; thanks

* remove unneeded variable

* refactor single-key callers of requestJsonReader

- suggested by @cocreature; thanks

* build error in ce

* diagnose Windows failure

* add missed http-json-testing requirement

* use readers as fetch/query party-set name

- suggested by @cocreature and @realvictorprm, thanks

* extra import

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
2021-11-12 02:10:15 +00:00
Gary Verhaegen
f4689691ca
document helm chart (#11648)
CHANGELOG_BEGIN

* There is now an Early Access Helm chart to start all of the Connect components on a Kubernetes cluster.

CHANGELOG_END
2021-11-11 13:31:02 +01:00
Moritz Kiefer
3588284fad
Fix screenshots in daml intro 2 (#11617)
The screenshots use a different module name.

fixes #9644

changelog_begin
changelog_end
2021-11-09 18:44:43 +00:00
Gary Verhaegen
a3195fd62d
fix link to blog (#11570)
I'm not entirely sure that this is the intended link (v. say
`https://daml.com/blog`), but the current one is dead so presumably this
is better.

CHANGELOG_BEGIN
CHANGELOG_END
2021-11-08 10:38:37 +01:00
Stefano Baghino
6c45f099bb
Remove TODO (#11446)
Fixes #11425

changelog_begin
changelog_end
2021-10-28 11:11:07 +00:00
carrielaben-da
54c400a341
Update wording in Deploying to a generic Daml ledger (#11327)
* Update generic_ledger.rst

* Changelog

Additional wording changes for grammar and style.

CHANGELOG_BEGIN

CHANGELOG_END

Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
2021-10-25 17:12:25 +00:00
Gerolf Seitz
ab8a863734
[docs] Add Daml Driver for VMBC to the commercial integrations section (#11360)
CHANGELOG_BEGIN
CHANGELOG_END
2021-10-22 15:44:11 +00:00
Moritz Kiefer
07ad3e0d9a
Suport multi-party readAs in triggers (#11299)
* Suport multi-party readAs in triggers

fixes #7640

This does not yet include the trigger service. We’ll tackle that separately.

changelog_begin

- [Daml Triggers] Triggers now support readAs parties. They can be
  specified via `--ledger-readas a,b,c`. As part of this change
  ``testRule`` gained an extra argument to specify the `readAs`
  parties. If you previously used

  ```
  testRule trigger party acsBuilder commandsInFlight s
  ```

  you now need to use

  ```
  testRule trigger party [] acsBuilder commandsInFlight s
  ```

changelog_end

* Update triggers/tests/src/test/scala/com/digitalasset/daml/lf/engine/trigger/test/AbstractFuncTests.scala

Co-authored-by: Andreas Herrmann <42969706+aherrmann-da@users.noreply.github.com>

Co-authored-by: Andreas Herrmann <42969706+aherrmann-da@users.noreply.github.com>
2021-10-20 18:17:15 +00:00
Moritz Kiefer
728296575b
Fix component status for triggers (#11311)
changelog_begin
changelog_end
2021-10-20 15:28:13 +02:00
pbatko-da
d3dad75d00
[DPP-592] Generate docs for self-service error codes. (#11129)
Adding `Daml Documentation >> Building applications >> "Self-Service Error Codes (Experimental)` section in the HTML documentation. 

The section is populated automatically with error code information retrieved from the classpath.
The process of generating documentation for error codes looks like this:
- first we find error codes information from the classpath,
- then we save it to a json file,
- then the json file is made available to a custom Sphinx extension,
- then the custom Sphinx extension generates documentation wherever we put a new custom Sphinx directive.

Try it out with
`./docs/scripts/live-preview.sh`
or
`./docs/scripts/preview.sh`


CHANGELOG_BEGIN
CHANGELOG_END
2021-10-20 08:47:54 +02:00
Stephen Compall
f4df1cc4d0
converting server errors to proper client errors (#11184)
* a model for trapping client errors in Scala bindings shim and reporting correctly

* clean up some nesting with an alias

* filter out client-side command service errors

* fix flattening error propagation of CommandService errors in endpoints

* remove todo

* Daml evaluation triggers INVALID_ARGUMENT; handle this for creates/exercises

* clean up lookupResult

* remove stripLeft utility; it is unused

* proper error propagation for /parties endpoint

* map grpc status codes to HTTP error codes

* add a case to pass-through gRPC errors in Endpoints errors

* handle gRPC status in all explicit top-level catches

* pass through gRPC errors in CommandService as well

* treat a gRPC status anywhere in the causal chain as indicating participant-server error

* propagate ContractsService errors without assuming they will always be ServerErrors

* filter ServerErrors' contents when rendering errorful streams

* log errors from websocket output instead of rendering full messages

* hide message in ServerError case

* remove Aborted

* transfer with bad contract ID now returns 409

* mention new error codes

* add changelog

CHANGELOG_BEGIN
- [JSON API] Several kinds of gRPC server errors are now reported with
  associated HTTP statuses; for example, a Daml-LF interpreter error now
  returns a 400 instead of a 500, and an exercise on an archived contract
  returns a 409 Conflict instead of a 500.  Errors internal to JSON API
  (e.g. internal assertion failures) are no longer detailed in the HTTP
  response; their details are only logged.
  See `issue #11184 <https://github.com/digital-asset/daml/pull/11184>`__.
CHANGELOG_END

* remove unused Show and liftErr utility

* adapt daml-script to new error codes

* adapt typescript tests to new error codes

* adapt json-api failure tests to new error codes
2021-10-19 13:54:29 -04:00
Artúr Poór
0f265fd715
[Docs] Improve manual-download.html phrasing. (#11084)
Emphasize that SDK version 1.4.0 was the latest at the time
of writing instructions, and is outdated now.

changelog_begin
changelog_end
2021-10-11 08:40:50 +02:00
fabiotudone-da
63ab3f3e50
Fix change ID references in services.rst (#11130)
CHANGELOG_BEGIN
CHANGELOG_END
2021-10-05 17:44:49 +00:00
Richard Kapolnai
e0587bcdd2
Add a bit of detail to RegisteredTemplates documentation, motivated by: (#10962)
https://discuss.daml.com/t/does-the-registeredtemplates-field-in-a-daml-trigger-affect-the-acs-which-is-threaded-through-my-rule/145
https://discuss.daml.com/t/do-triggers-get-full-acs-or-prefiltered/403

CHANGELOG_BEGIN
CHANGELOG_END
2021-09-21 15:36:40 +00:00
akshayshirahatti-da
b8533d50e9
[JSON-API] Production/HA documentation. (#10903)
* Initial draft documentation for JSON API production recommendations

CHANGELOG_BEGIN
CHANGELOG_END

* changes based on draft review

* changes based on code-review

* more changes based on review comments

* add note on performance impact for rebuilding query store
2021-09-20 17:41:18 +00:00
Stefano Baghino
9093c6c7b3
Improve wording for the active contracts service description (#10880)
* Improve wording for the active contracts service description

This should eliminate sources of confusion as mentioned here: https://discuss.daml.com/t/offset-is-null-while-getting-active-contracts/3118

changelog_begin
[Docs] Improved description of the purpose and usage of the active contracts service
changelog_end

* Address https://github.com/digital-asset/daml/pull/10880#pullrequestreview-754078207

* Remove sand-which.
2021-09-15 10:27:40 +02:00
Stefano Baghino
c12f546774
Document #10780 (#10781)
changelog_begin
[Docs/JSON API] documented 256B limitation of Oracle query store
changelog_end
2021-09-15 10:26:28 +02:00
Gary Verhaegen
6c1c02aeea
document complete authorized auth0 setup (#10881)
CHANGELOG_BEGIN
CHANGELOG_END
2021-09-14 19:11:21 +00:00
Moisés Ackerman
9e918c37a3
Update trigger-service docs to use --dar option in the corresponding example (#10877)
changelog_begin
changelog_end
2021-09-14 14:46:31 +02:00
Miklos
6faddc90c8
Update Daml Documentation to reflect command deduplication related changes [KVL-1094] (#10852)
* Minor tweaks.

* Use deduplication period instead of deduplication time.

* Introduced change ID and consistent use of deduplication duration/period.

* Consistent use of deduplication duration/period.

* Added ALREADY_EXISTS to the described gRPC errors.

* Minor tweak.

CHANGELOG_BEGIN
CHANGELOG_END

* Emphasize that applications should not change the deduplication time upon a resubmission

* Fix definition of change ID and always refer to it

* Try to clarify "Application-specific IDs"

* Make command deduplication explanation unspecific w.r.t. direction

Co-authored-by: Fabio Tudone <fabio.tudone@digitalasset.com>
2021-09-14 11:28:27 +02:00
akshayshirahatti-da
99f0362aac
[JSON-API] drop package token doc changes (#10865)
* Update daml documentation to reflect the deprecation of the package/internal access token

CHANGELOG_BEGIN
CHANGELOG_END

* drop the whole internal access token section
2021-09-13 16:53:19 +00:00
Moritz Kiefer
842c5b1605
Drop early access notice from profiler docs (#10856)
changelog_begin
changelog_end
2021-09-13 09:07:00 +00:00
Gary Verhaegen
567fe43cc6
tweak trigger-service docs (#10845)
CHANGELOG_BEGIN
CHANGELOG_END
2021-09-10 16:06:20 +02:00
Adriaan Moors
7225c0415c
[docs] Replace AdoptOpenJDK suggestion by Adoptium (#10837)
* [docs] Replace AdoptOpenJDK suggestion by Adoptium

In the installation instructions, suggest Adoptium as JDK source

[AdoptOpenJDK has moved to the Eclipse foundation](
https://blog.adoptopenjdk.net/2021/08/goodbye-adoptopenjdk-hello-adoptium/)

* Without changelog entry

CHANGELOG_BEGIN
CHANGELOG_END
2021-09-10 13:45:03 +00:00
Gerolf Seitz
648acf52f8
Fix typo in app-arch.rst (#10798)
CHANGELOG_BEGIN
CHANGELOG_END
2021-09-09 14:11:35 +00:00
tudor-da
deb8a8b740
[Divulgence pruning] Daml SDK docs update [DPP-536] (#10764)
* [Divulgence pruning] Minor update to participant_pruning_service.proto divulgence docs

CHANGELOG_BEGIN
[Ledger API Specification] Participant pruning of all divulged contracts is fully implemented: Participant operators can choose to prune all immediately and retroactively divulged contracts, by setting the newly-added prune_all_divulged_contracts flag in the ParticipantPruningService/Prune request.
CHANGELOG_END

* Enrich `Daml Participant Pruning` in the `Operating Daml` docs section

* Apply suggestions from code review

Co-authored-by: mziolekda <marcin.ziolek@digitalasset.com>

Co-authored-by: mziolekda <marcin.ziolek@digitalasset.com>
2021-09-08 07:58:55 +00:00
Leonid Rozenberg
bb908d04fb
Create a link to party management service in main Ledger API page. (#10138)
CHANGELOG_BEGIN
CHANGELOG_END
2021-09-02 23:03:19 -04:00
Victor Peter Rouven Müller
ff1308ee3d
[Docs] Add info on logs on Kubernetes & metrics in the ops section (#10525)
* [Docs] Add info on logs on Kubernetes & metrics in the ops section

changelog_begin

- [Docs] Information was added in the `Operating Daml` section on how to aggregate logs on Kubernetes in conjuction with Daml services & what options exists for exporting metrics from daml services (not Kubernetes specific)

changelog_end

* Move the new docs into a seperate section 'Operating Daml Connect'

* Move section again, now it's a subsection under Operating Daml

* Update docs/source/ops/connect/content.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Apply suggestions from code review

Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>

* Rename file

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
2021-09-02 14:52:27 +00:00
pbatko-da
b28afcf7ae
[DPP-438] Update docs on metrics that no longer use <party_name> in their name (#10728)
CHANGELOG_BEGIN
CHANGELOG_END
2021-09-02 10:07:36 +02:00
Gary Verhaegen
f8c0a35940
rewrite trigger docs to follow gsg (#10509)
* rewrite trigger docs to follow gsg

Per #10419 point 4, I've rewritten the Triggers section to build upon
the Getting Started Guide instead of inventing its own example.

Compared to #10395, this has a lot more explanations as this page must
now serve the dual purpose of being a possible "next step" from the GSG
and being the main reference page for triggers. It's also lost the "next
steps" section, which I think is a bit of a shame, but it doesn't really
make sense here.

There's also no easy way for people not interested in the GSG to follow
along; should we expose the "completed GSG" as a tempate?

CHANGELOG_BEGIN
CHANGELOG_END

* keep copy-trigger as a template

* fix copy-trigger project name

* make up gsg-trigger template

* remove awkward sentence, fix existing typo

* update code to use when{,Some}

* add  to

* swap emitCommands and getCommandsInFlight

* typo

* insist on state-correction perspective

* fix copy-trigger tests

* add back copy-trigger to whitelist

* add gsg-trigger to whitelist
2021-08-17 13:28:07 +00:00
Andreas Herrmann
d92440471c
daml ledger export: export all parties (#10588)
* Add test-case to ConfigSpec for output type

changelog_begin
changelog_end

* Add an --all-parties flag to ledger export

changelog_begin
* [Daml export] You can now set the ``--all-parties`` option to generate
  a ledger export as seen by all known parties.
changelog_end

* Update docs

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-08-17 14:12:28 +02:00
Gary Verhaegen
313110c702
correct JSON API upper date bound (#10489)
* correct JSON API upper date bound

As reported by @quid-agis. Fixes #10449.

CHANGELOG_BEGIN
CHANGELOG_END

* add tests

* test error messages

* more specific catch
2021-08-06 12:46:59 +00:00
Andreas Lochbihler
73b6596447
replace DA ledger with Daml ledger in the ledger model (#10491)
CHANGELOG_BEGIN
CHANGELOG_END
2021-08-05 13:48:42 +02:00
Gary Verhaegen
185f888b44
move e2e testing to app-dev (#10479)
* move e2e testing to app-dev

This should take care of step 1 in #10419.

CHANGELOG_BEGIN
CHANGELOG_END

* change title
2021-08-05 11:28:46 +02:00
Victor Peter Rouven Müller
55392a5570
[Docs] Update to a newer gpg keyserver because the old one is deprecated / not reachable anymore (#10452)
changelog_begin

- [Docs] The manual install instructions now use a different gpg keyserver because the old one is deprecated / not reachable anymore

changelog_end
2021-08-03 15:14:53 +02:00
Remy
41009f79cc
Compiler: Make LF 1.14 the default output (#10394)
CHANGELOG_BEGIN

- [Compiler] Default compiler output LF version is now 1.14

CHANGELOG_END
2021-07-28 12:14:56 +02:00
Andreas Herrmann
7df9758c2f
Daml export: make paths relative to daml.yaml (#10388)
Previously data-dependencies in the generated daml.yaml file had a path
including the output-dir path itself. E.g.

```
data-dependencies:
- /some/out/path/deps/some.dalf
```

This worked fine so long as the output path was absolute. However, if
the output path is a relative path, then it might lead to "no such file"
errors during daml build.

This change always makes the generated data-dependencies paths relative
to the daml.yaml file.

changelog_begin
- [Daml export] The generated paths to data-dependencies DALFs are now
  relative to the generated daml.yaml. Fixes
  https://github.com/digital-asset/daml/issues/10378.
changelog_end

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-07-23 09:53:35 +00:00
Gary Verhaegen
1a723149d4
fix broken triggers link (#10336)
CHANGELOG_BEGIN
CHANGELOG_END
2021-07-20 15:49:57 +00:00
Gary Verhaegen
f59951b755
document min npm version (#10330)
We're currently using 12.22.1 in dev-env and 12 is the oldest
still-supported version.

CHANGELOG_BEGIN
CHANGELOG_END
2021-07-20 15:30:56 +02:00
Gary Verhaegen
d982e16e99
fix besu listing (#10328)
The current entry has been moved from "open-source integrations" to
"commercial integrations" in 73b38f8add. However, the move was done
verbatim, while the format for the two tables is different, making the
Besu listing stick out a bit. Moreover, since the listing was added the
URL of the press release has changed, landing people on the front page
of the DA blog (from which it is possible to find the relevant press
release, but quite frankly googling for it is faster).

For the record, I still think this page should be hosted elsewhere as
the docs release cycle doesn't offer enough dynamism for it.

CHANGELOG_BEGIN
CHANGELOG_END
2021-07-20 13:15:17 +00:00
Victor Peter Rouven Müller
80b65f6def
[DOCS] Add documentation for the JSON API metrics (#10312)
* [DOCS] Add documentation for the JSON API metrics

changelog_begin

- [JSON-API] You can now find a section `Metrics` in the http-json api documentation explaining how to enable metrics and which are available

changelog_end

* Fix rst build warnings

* Update docs/source/json-api/metrics.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Adapt metrics doc to state that it IS an exhaustive list and remove wrong copy pasta text & add info about prometheus

* Update the legal values for the metrics reporter cli option

* shorten the description, the change prior was unnecessary ._.

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-07-19 17:32:23 +02:00
Moritz Kiefer
d96b54eb23
Use Text not String in exception docs (#10287)
changelog_begin
changelog_end
2021-07-15 15:02:37 +02:00
Moritz Kiefer
c92c67832f
Mark Daml profiler as stable (#10203)
Nobody reported any issues and we’re not planning breaking changes so
ship it!

changelog_begin

- [Daml Profiler] The Daml profiler is now a stable feature.

changelog_end
2021-07-07 12:54:18 +00:00
Stefano Baghino
c8faed8a17
Deduplicate Java codegen running instructions (#10185)
Fixes #10183.

changelog_begin
changelog_end
2021-07-07 08:37:42 +02:00
Stefano Baghino
0d881f5e2b
Improvements to the documentation with regards to offsets (#10180)
* Improvements to the documentation with regards to offsets

changelog_begin
[Docs] Improvements to the documentation with regards to offsets
changelog_end

- Simplify wording to explain the usage of `blockingForEach` in the Java
bindings quickstart page
- Describe offsets in prose in the page about the Ledger API services
- Suggest how to perform crash recovery with offsets on the application
architecture page
- Link to the relevant Protobuf reference docs where approriate

* Apply suggestions from code review

Thanks @cocreature

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Addresses https://github.com/digital-asset/daml/pull/10180#discussion_r664001785

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-07-07 07:51:37 +02:00
Sofia Faro
582aa5f08c
Fix a typo in an exceptions example. (#10188)
changelog_begin
changelog_end
2021-07-06 14:03:18 +00:00
Stefano Baghino
6c49619565
Document how to run the Java codegen from the Daml assistant (#10181)
Downloading and running the JAR manually is so 2019.

changelog_begin
[Docs] Document how to use the Java codegen using the Daml assistant
changelog_end

Fixes #8817
2021-07-05 17:53:04 +02:00
Remy
62aabcc478
Ledger API: bump version for LF 1.14 (#10175)
* Ledger API: bump version for LF 1.14

CHANGELOG_BEGIN

* Ledger API: bump version for LF1.14

CHANGELOG_END

* Update docs/source/support/compatibility.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/support/compatibility.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-07-05 13:54:25 +00:00
Stefano Baghino
f1ffd52e08
Java bindings: add DamlRecord, deprecate Record (#10132)
* Java bindings: add DamlRecord, deprecate Record

Fixes #10130

changelog_begin
[Java bindings] In order to avoid clashing with `java.lang.Record` (introduced
in Java 14), `com.daml.ledger.javaapi.data.Record` has been renamed to
`com.daml.ledger.javaapi.data.DamlRecord`. The old name has been used to
denote a sub-type of the newly renamed one, so it can still be used, but it has
been marked as deprecated.
[Java codegen] The Java codegen now uses the `DamlRecord` type wherever `Record`
was used before.
changelog_end

Boy-scout rule:
- removed references to ~old~ ancient versioning
- used `@deprecated` Javadoc annotation wherever meaningful
- some import re-arrangement performed by the linter

* Address https://github.com/digital-asset/daml/pull/10132#discussion_r659705929
2021-06-28 12:08:51 +00:00
Victor Peter Rouven Müller
9498d1509b
[DOCS] Let jwt.io link to an already filled in working payload (#10026)
changelog_begin
changelog_end
2021-06-24 14:35:33 +02:00
Remy
a6b536f3c4
Compiler: Make LF 1.13 the default output (#9907)
* Compiler: Roll LF Version

Fix #8591

CHANGELOG_BEGIN
- [Compiler] Default ouput LF version is now 1.13
CHANGELOG_END
2021-06-24 11:58:50 +02:00
Stephen Compall
ecc2d11536
recommend some daml compiler warnings to enable (#10082)
- based upon @cocreature's
  https://discuss.daml.com/t/making-the-most-out-of-daml-compiler-warnings/739

CHANGELOG_BEGIN
CHANGELOG_END
2021-06-23 14:20:59 +00:00
Stephen Compall
d867d90400
define query offset semantics solely in terms of #9847 per-query offsets (#10071)
Since per-request offset can be described strictly as a special case of the new
per-query offset semantics, go ahead and describe it that way, so that really
only one model needs to be understood to fully comprehend the query request
semantics.

CHANGELOG_BEGIN
CHANGELOG_END
2021-06-22 12:32:48 -04:00
Stefano Baghino
b796695768
Add per-query offsets to HTTP-JSON API (#9847)
* Add per-query offsets to HTTP-JSON API

changelog_begin
[HTTP/JSON API] The streaming query endpoint now accepts to override the
offset for each query using the `offset` field. You can read more
about it on the documentation.
changelog_end

* Replace mapValues and filterKeys with something that compiles with both 2.12 and 2.13

* Refactor offset comparison

- Addresses https://github.com/digital-asset/daml/pull/9847/files#r642363229
- Addresses https://github.com/digital-asset/daml/pull/9847/files#r642363848

* Add tests (failing), fix definition of starting offset

* Fix failing test

* More tests

* Add tests for verify older behavior still works

* Fix regression

* Remove debug prints

- Addresses https://github.com/digital-asset/daml/pull/9847#discussion_r642362683
- Addresses https://github.com/digital-asset/daml/pull/9847#discussion_r642362774

* Failed attempt at ACS call integration

* Revert "Failed attempt at ACS call integration"

This reverts commit 879e0cfbdb579362674120f93a9c93388ed81bc1.

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r647019447

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r647019965

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r647020825

* Integrate with ACS calls

* Fix three broken tests

* Fix one regression

* Fix last regression

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651586811

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651668995

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651669134

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651669691

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651670134

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651676902

* Fix Scala 2.12 compilation error

* Fix compilation issues on Scala 2.13 and 2.12

* Remove unnecessary dependency

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651824658

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651831880

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651833646

* Address two comments:

- https://github.com/digital-asset/daml/pull/9847#discussion_r651841615
- https://github.com/digital-asset/daml/pull/9847#discussion_r651842951

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651838831

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651949821

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r651943962

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r652492756

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r652537652

* query_offset -> queryOffset

* Document per-query offsets

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r655117581

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r655119961

* Apply suggestions from code review

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r655233517

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r655266806

* Address https://github.com/digital-asset/daml/pull/9847#discussion_r655265717

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-06-21 16:38:07 +02:00
Gary Verhaegen
e12a449c81
s/DABL/Daml Hub/ (#10062)
It's been long enough.

CHANGELOG_BEGIN
CHANGELOG_END
2021-06-21 16:37:17 +02:00
Bernhard Elsner
b79e739196
Fix Type (#10004)
CHANGELOG_BEGIN
CHANGELOG_END
2021-06-15 10:22:01 +00:00
Gary Verhaegen
e4258e61b1
docs: tweak Exception intro (#9967)
* docs: tweak Exception intro

CHANGELOG_BEGIN
CHANGELOG_END

* review comments
2021-06-11 11:30:29 +00:00
Gerolf Seitz
cc7af93afc
[docs] Remove link to the #daml-contributors (#9928)
CHANGELOG_BEGIN
CHANGELOG_END
2021-06-10 22:16:39 +02:00
Moritz Kiefer
3cb8d5c2a7
Deprecate use of divulged contracts (#9930)
changelog_begin

- [Ledger API] Use of divulged contracts in later transactions is
deprecated. Divulged contracts were already incompatible with
pruning. We are working on features to handle the cases currently
covered by divulgence.

changelog_end
2021-06-08 18:47:15 +00:00
Rafael Guglielmetti
1dc8472017
Fix variable name (#9927)
Fix typos

CHANGELOG_BEGIN
Small fixes to the doc
CHANGELOG_END
2021-06-08 19:15:07 +02:00
Gerolf Seitz
2da94c3149
Add warning about using divulged contracts in pruning doc (#9883)
[docs] Add warning about using divulged contracts to the pruning doc

CHANGELOG_BEGIN
[ledger api] Add warning about incompatibility between pruning and
divulged contracts to pruning docs.
CHANGELOG_END
2021-06-03 17:03:38 +02:00
Nemanja
c7b3bd7484
Renamed project:DABL to Dam Hub in the deployments section (#9843)
* Renamed project:DABL to Dam Hub in the deployments section

* CHANGELOG_BEGIN
CHANGELOG_END

* Empty changelog
CHANGELOG_BEGIN
CHANGELOG_END
2021-06-02 10:05:32 +02:00
Sofia Faro
2d49939360
Fix the notion of transaction equivalence in the ledger model for exceptions. (#9850)
* Fix the notion of transaction equivalence in the ledger model for exceptions.

@andreaslochbihler-da found that our normalization rules don't normalize rollbacks across exercises, which our notion of transaction equivalence expects them to. For example, the transactions

```
rollback [ exercise [ rollback [ create ]]]
```

and

```
rollback [ exercise [ create ] ]
```

are considered equivalent under the old definition, but do not normalize to each other.

This PR is one possible solution, where we keep our current normalization rules but change the definition of transaction equivalence. In particular, instead of just requiring that the set of rolled back actions to be the same, we require that the set of "rollback roots" be the same, where a "rollback root" is an action that has a rollback node as its parent. This prevents normalization across exercises because that would eliminate some rollback roots.

The idea here is that the set of "rollback roots" encodes the set of "rolled back actions" relative to each action's subtree, unlike before where we only looked at the set of "rolled back actions" relative to the whole transaction. The set of "rollback roots" encodes all that information, but with a simple definition.

A completely different solution is to introduce new normalization rules that work across exercise nodes. Unfortunately these rules would be non-local, and that seems very difficult to do correctly & efficiently.

Part of #8020

changelog_begin
changelog_end

* rollback root -> rollback child
2021-06-01 16:14:53 +01:00
Moritz Kiefer
dcd33a7b4b
Add a section on exceptions to the Daml intro (#9832)
* Shuffle intro to make space for exceptions

changelog_begin
changelog_end

* Add a section on exceptions to the Daml intro

changelog_begin
changelog_end

* Update docs/source/daml/intro/8_Exceptions.rst

Co-authored-by: Sofia Faro <sofia.faro@digitalasset.com>

* Update docs/source/daml/intro/8_Exceptions.rst

Co-authored-by: Sofia Faro <sofia.faro@digitalasset.com>

Co-authored-by: Sofia Faro <sofia.faro@digitalasset.com>
2021-05-28 14:48:34 +00:00
Sofia Faro
a0373c4855
Ledger model section on transaction normalization. (#9816)
* Ledger model section on transaction normalization.

changelog_begin
changelog_end

* update diagrams

* Review comments
2021-05-28 11:50:46 +00:00
Moritz Kiefer
0c7b149068
Add reference docs for exceptions (#9807)
* Add reference docs for exceptions

Not that these are reference-style docs so they are deliberately brief
and don’t focus on usecases. I’ll add a section to the Daml intro for
that in a separate PR.

changelog_begin
changelog_end

* Apply suggestions from code review

Co-authored-by: Sofia Faro <sofia.faro@digitalasset.com>

* review comments

changelog_begin
changelog_end

Co-authored-by: Sofia Faro <sofia.faro@digitalasset.com>
2021-05-26 16:17:31 +00:00
Andreas Herrmann
fa0815bc11
Example export (#9756)
* Pretty print daml.yaml in Daml ledger export

changelog_begin
changelog_end

* Use dynamic port in example-export generation

* Add daml.yaml to Daml ledger export golden test

* Sort data-dependencies for reproducibility

* Replace hashes in data-dependencies with a placeholder

To avoid test failure when any of these change.

* normalize data-dependencies path in scala client

So that the bazel build action is more reproducible itself.

* Fix Scala 2.12 build

* Factor out deleteRecursively

changelog_begin
changelog_end

* Generate ledger export in temp-dir

Build actions are not sandboxed in Windows. The ledger export will also
created a directory `deps` to store all the DALFs in. On Windows this
directory may persist across Bazel builds and may cause errors due to
attempts to overwrite an existing directory.

To avoid these issues the ledger export is generated into a temporary
directory and only the wanted files are moved to the expected output
locations in the bazel execroot afterwards.

* Close source

* Use replace instead of replaceFirst

The latter matches regex pattern instead of just substring matching
which fails with Windows paths due to `\` being interpreted as an escape
character.

* Normalize Windows \ to Unix /

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-05-21 09:36:25 +02:00
Andreas Herrmann
10177d239e
Add golden test for example Daml ledger export (#9732)
* client_server_build - user defined outputs

Let the user define a list of output files on client_server_build.

changelog_begin
changelog_end

* daml-script runner expose main(config)

changelog_begin
changelog_end

* Add an example Daml ledger export to the docs

* Build Daml ledger export

changelog_begin
changelog_end

* sh_inline_test

Support toolchain arguments to sh_inline_test. Usefuly for make variable
expansion, e.g. for the POSIX toolchain.

* Add a golden test for Daml ledger export

* Test args files as well

* Use sed from POSIX toolchain

* Add normalization comment to top-level comment

* Ignore trailing CR on Windows

The JSON formatting of the args file uses Windows line endings on
Windows. Therefore, the args.json output technically differs from the
expected output. We're happy to ignore the difference in CRLF here.

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-05-19 12:02:14 +00:00
Sofia Faro
3209188fcc
Add a ledger model page for exceptions. (#9396)
* Add a ledger model page for exceptions.

This page describes the changes to the ledger model as part of the exceptions feature. The changes should be kept separate for now, but once exceptions are stable and out for a while, they should probably be incorporated into the rest of the daml ledger model.

Part of #8020. **This PR is to be merged only when we start releasing exceptions.**

changelog_begin

- [docs] The Daml ledger model has been updated to describe the changes introduced by the new exceptions feature. See  here: https://docs.daml.com/concepts/ledger-model/ledger-exceptions.html

changelog_end

* Apply suggestions from code review

Co-authored-by: Ognjen Maric <ognjen.maric@digitalasset.com>

* Round 2

* Fix and simplify "after" relation!

* Easy fixes

* Diagrams for structure and integrity sections.

* Add missing diagrams :)

* clarify consistency section

* Authorization.

* Editing.

* fix label reference

Co-authored-by: Ognjen Maric <ognjen.maric@digitalasset.com>
2021-05-19 09:43:18 +00:00
Remy
679ce3b7d3
LF: Release LF 1.13 (#9705)
CHANGELOG_BEGIN

- LF: make LF 1.13 stable
   Add support for BigNumeric

- Ledger API: Bump Ledger API version for LF 1.12

CHANGELOG_END
2021-05-18 17:30:34 +02:00
Andreas Herrmann
f51145cb88
Support mapping from old to new party ids in daml exports (#9591)
* Factor out all encoding components

* Provide TextMap party mapping instead of record

This allows users to customize the mapping from old party names to new
party names.

* Emit bindings for parties at beginning of export

For better readability, to avoid `getParty "Alice" parties` all over the
place.

* getParty --> lookupParty to avoid conflict with Prelude

* Use DA.Traversable.mapA over TextMap

* Update integration test

* Update args.json

* Update the daml export docs

changelog_begin
* [Daml export] Users can now define a mapping from parties in the
  original ledger state to parties to be used when recontructing the
  ledger state. The ``parties`` component of the argument to the
  generated export script now takes a mapping from old party name to new
  party name.
changelog_end

* getContract --> lookupContract for consistency with lookupParty

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-05-07 15:44:40 +02:00
Andreas Herrmann
e8d25b255e
Handle references to missing contracts (#9553)
* Take user defined mappings for unknown contracts

* Remove unused `allocateParties` helper

These are now provided in `args.json`.

* No longer fail on missing contract ids

* Generate a default args.json

* Configure daml start to run the export

Configures init-script and script-options such that `daml start` will
execute the export script with the default `args.json` input.

Configures navigator to display the default parties.

* Update daml export integration test

Input format has changed.

* Update documentation for daml ledger export

changelog_begin
* [Daml export] Daml ledger export now handles references to missing
  contracts. The generated export script takes a mapping from unknown
  contract ids to replacement contract ids as a parameter. Users can
  prepopulate the ledger with replacements of missing contracts and
  configure the export script to reference these replacements.
  The generated export script no longer exposes ``testExport`` as an
  entry point, instead Daml export generates a default input file
  ``args.json`` that can be used to execute the ``export`` function from
  ``daml script`` or ``daml start``.
changelog_end

* Reinstante testExport & allocateParties

Convenient for testing in Daml IDE or on ledgers that don't have
automatic party allocation.

* Add docstrings to the generated Daml export script

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-05-03 15:52:40 +00:00
Gary Verhaegen
e39c20ecbc
update GPG public key (#9488)
The existing public key is set to expire in May, so we've changed it.

Note: this _should_ require no other change as the private key is
unchanged (i.e. the new public key can be used to verify old
signatures), but my understanding of GPG is somewhat limited so 🤷.

CHANGELOG_BEGIN
CHANGELOG_END
2021-04-27 13:40:02 +02:00
Andreas Herrmann
e525382dc2
Optionally emit setTime actions in daml export (#9469)
* Add setTime flag

changelog_begin
* [Daml export] Enable the ``--set-time`` flag on
  ``daml ledger export script`` to replicate transaction time stamps.
  This only works on ledgers operating in static time mode.
changelog_end

* Dump.scala --> Export.scala

So that the file name and class name match.

This was forgotten in 5e652bb2f8.

* Implement optional setTime actions

* Define Action type encompassing SetTime and Submit

Factor out construction of submit actions interleaved with setTime
actions.

This makes it easier to test the corresponding functionality in
isolation.

* EncodeSetTimeSpec

* ActionsFromTreesSpec

* update docs on daml ledger export

* Enable --set-time in integration test

To ensure that the generated code actually compiles

* Fix date/time encoding

Requires additional imports for DA.Time and DA.Date.
Requires qualified references to DA.Time.time, DA.Date.date, and
DA.Date.MONTH.

* Fix Scala 2.13

* Move setTime parameter to Action.fromTrees

* Move export transaction time docs out of caveats

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-04-22 12:10:05 +00:00
Nemanja
7c6fac25ca
Hint for loading Daml Script example code (#9466)
Closes #9462
CHANGELOG_BEGIN
CHANGELOG_END
2021-04-22 13:41:46 +02:00
Andreas Herrmann
7644844fae
Document daml ledger export script (#9446)
* Document daml ledger export script

changelog_begin
* [Daml export] Refer to the "Ledger Export" chapter under the "Early
  Access Features" for a description of the new Daml ledger export
  command. This is an early access feature.
changelog_end

* Fix reference formatting

* Update docs/source/tools/export.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Mark as alpha

* Clarify issue around archived contracts

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-04-20 08:44:12 +00:00
anthonylusardi-da
11e5dd37e7
link to postgres docs (#9353)
* link to postgres docs

* CHANGELOG_BEGIN
CHANGELOG_END
2021-04-09 09:28:58 +02:00
Robin Krom
f84b6abc05
daml build: add a --access-token-file for remote dependencies (#9358)
* daml build: add a --access-token-file for remote dependencies

This adds a `ledger.access-token-file` field in the `daml.yaml` project
file and a `--access-token-file` flag to `daml build` to authorize
querying/fetching of remote dependencies.

CHANGELOG_BEGIN
[daml build] A new flag `--access-token-file` is added for the `daml
build` command. It allows the specify the path to an access token to
authenticate against the ledger API. This is needed if the project
depends on a remote Daml package hosted on such a ledger. Alternatively,
the path to the token can also be specified in the `daml.yaml` project
file under the `ledger.access-token-file` field.
CHANGELOG_END
2021-04-08 23:20:52 +02:00
Moritz Kiefer
0303017343
Delete "testing with scenarios" section (#9360)
This is superseded by
https://docs.daml.com/daml/intro/2_DamlScript.html which seems much
nicer and I don’t see what we gain by having both.

fixes #8839

changelog_begin
changelog_end
2021-04-08 14:50:33 +02:00
Nemanja
69ecf577b8
Removing Git as a prerequisit from the GSG (#9202)
* Removing Git as a prerequisit from GSG

* CHANGELOG_BEGIN
CHANGELOG_END
2021-04-08 06:30:34 +00:00
Sofia Faro
06701f7d5e
Expose rounding modes as constructors + add BigNumeric docs. (#9336)
* Expose rounding modes as constructors.

This PR exposes the rounding modes as constructors for RoundingMode. Pattern matching for RoundingMode is not implemented and not critical (will open a separate issue).

This PR also adds documentation for BigNumeric.

changelog_begin
changelog_end

* Fix rounding mode literals

* Update data-types.rst

* expose constructors

* expose constructors (part 2)

* Update compiler/damlc/daml-prim-src/GHC/Types.daml

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Try to improve `Numeric n` description.

* Add message for RoundingMode match and a test.

* Restrict RoundingMode test to 1.dev

* Update version numbers to 1.13

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-04-07 14:58:31 +00:00
anthonylusardi-da
960134dd54
Fix typo in profiler docs, file name starts with profile (not profiler) (#9338)
* fix typo, file name starts with profile (not profiler)

* CHANGELOG_BEGIN
CHANGELOG_END
2021-04-07 08:50:21 +02:00
Moritz Kiefer
0eac00f343
Avoid deprecated forHostWithLedgerIdDiscovery in quickstart-java (#9337)
fixes #9319

changelog_begin
changelog_end
2021-04-06 22:38:35 +02:00
Moritz Kiefer
8f7ef05765
Avoid mention of scenarios in Sandbox docs (#9335)
fixes #9331 
changelog_begin
changelog_end
2021-04-06 18:21:36 +02:00
Robin Krom
b4bda47e7d
remote pkgs: resolve package names in data dependencies via ledger (#9270)
* remote pkgs: resolve package names in data dependencies via ledger

This implements part 3) of #8976.

This adds the ability to specify package names/versions in daml.yaml in
the data-dependencies stanza. They are being resolved via the project
ledger and a daml.lock lock file.

CHANGELOG_BEGIN
  [remote dependencies] Package names and versions, as well as package
  ID's are allowed in the `data-dependencies` list of `daml.yaml`. These
  packages are fetched from the project ledger. The auto-generated
  `daml.lock` file keeps track of the package name/version to package
  ID's resolution and should be checked in to version control of the
  project.
CHANGELOG_END

* added docs

* Update compiler/damlc/lib/DA/Cli/Damlc/DependencyDb.hs

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/daml/reference/packages.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* suggestions

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-03-31 15:37:36 +02:00
Stefano Baghino
b98a3881e5
Non-repudiation: documentation (#9288)
* Non-repudiation: documentation

changelog_begin
[Runtime Components] New feature: the non-repudiation middleware is now available
as an early access feature, please have a look at its page in the early access
section of the documentation to learn more
changelog_end

Closes #8659

* Remove exceprt from Wikipedia

* Fix typo

* Fix naming

* Address https://github.com/digital-asset/daml/pull/9288#discussion_r604647664

* Address https://github.com/digital-asset/daml/pull/9288#discussion_r604651195

* Address https://github.com/digital-asset/daml/pull/9288#discussion_r604792871
2021-03-31 11:30:54 +00:00
Moritz Kiefer
6c9679f511
Add documentation for the Daml Profiler (#9174)
* Add documentation for the Daml Profiler

changelog_begin

- [Daml Profiler] Daml Connect EE now includes a profiler which can be
used to profile Daml execution time.

changelog_end

* Update docs/source/tools/profiler.rst

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>

* Make sphinx happy

changelog_begin
changelog_end

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>
2021-03-18 09:48:10 +01:00
Moritz Kiefer
98c2651998
Support fetching SDK EE tarball in the assistant (#9146)
* Support fetching SDK EE tarball in the assistant

This PR adds an `artifactory-api-key` field to `daml-config.yaml`. If
this is set, we will download the SDK EE tarball if it exists, falling
back to GH releases on 404s (for old releases).

changelog_begin

- [Daml Assistant] The assistant now supports an `artifactory-api-key`
  field in `daml-config.yaml`. If you have a license for Daml Connect
  EE you can specify this and the assistant will automatically fetch
  the EE edition which provides additional functionality.

changelog_end

* Hardcode first EE snapshot

changelog_begin
changelog_end
2021-03-16 14:17:50 +01:00
Moritz Kiefer
d4bdb12862
Add pruning stabilization to ledger API changelog (#9126)
* Add pruning stabilization to ledger API changelog

changelog_begin
changelog_end

* also can’t type outside of backport

changelog_begin
changelog_end

* I give up

changelog_begin
changelog_end
2021-03-12 16:49:12 +00:00
Gerolf Seitz
9320a213db
[Integration Kit, Ledger API] Remove hint about early access for participant pruning. (#9120)
CHANGELOG_BEGIN
[Integration Kit, Ledger API] Remove hint about early access for participant pruning. It's stable now.
CHANGELOG_END
2021-03-12 13:43:39 +00:00
Moritz Kiefer
1c5e64cb82
Fix release notes link in docs (#9122)
changelog_begin
changelog_end
2021-03-12 13:39:23 +00:00
Andreas Herrmann
c7ee410fa3
Use DA.Map in triggers if available (#9023)
* Use DA.Map in triggers if available

Replaces DA.Next.Map by DA.Map in the trigger library if the DAML-LF
version supports it, i.e. above 1.11.
Selects on `DAML_GENMAP` and `DAML_GENERIC_COMPARISON` using `CPP`.

changelog_begin
- [Triggers] The trigger library now uses `DA.Map` instead of the
  deprecated `DA.Next.Map` if the targeted Daml-LF version supports it.
  This is a breaking change: Code that interfaced with the triggers
  library using `DA.Next.Map`, e.g. with
  `Daml.Trigger.getCommandsInFlight` or `Daml.Trigger.Assert.testRule`,
  will need to be changed to use `DA.Map` instead.
changelog_end

* Deduplicate GMap imports in triggers

* DA.Next.Map --> DA.Map in carbon-upgrade-trigger

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-03-04 14:15:01 +01:00
Moritz Kiefer
576d0cb758
Bump Ledger API version for LF 1.12 (#8972)
changelog_begin
changelog_end
2021-03-01 12:42:33 +00:00
Moritz Kiefer
71116b053c
Add a Ledger API changelog (#8974)
* Add a Ledger API changelog

changelog_begin
changelog_end

* Update docs/source/support/compatibility.rst

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>
2021-03-01 12:42:27 +00:00
Andreas Lochbihler
00bffd2281
correct the causaility definition for non-stakeholder actors and choice observers (#8892)
CHANGELOG_BEGIN
aligned the formal causality guarantees for non-stakeholder actors and choice observers to the given examples
CHANGELOG_END
2021-02-19 10:16:07 +01:00
Moritz Kiefer
4aded7151c
Update compatibility docs for Ledger API version 1.9 (#8828)
Also adds a comment to make sure we don’t forget it in the
future. Note for reviewers: Our code already only looks at the first
line, so the comment in the second line does not break anything.

changelog_begin
changelog_end
2021-02-12 10:45:11 +00:00
Shaul Kfir
94262e9f9a
Fix docs typo in local-ledger.rst (#8825)
CHANGELOG_BEGIN
CHANGELOG_END
2021-02-12 08:50:36 +01:00
Gary Verhaegen
7c671037de
try to improve macOS install instructions (#8764)
* try to improve macOS install instructions

Based on [feedback from Khuram] on the forum.

[feedback from Khuram]: https://discuss.daml.com/t/my-feedback-on-daml-in-general-and-documentation-as-a-non-coder/2043/6?u=gary_verhaegen

CHANGELOG_BEGIN
CHANGELOG_END

* .

* .

* mention code is not required

* undo changes to vscode install docs

* remove echo $0
2021-02-11 14:04:41 +00:00
Bernhard Elsner
a1b4db86f3
Turn all Daml Intro templates into full projects (#8814)
* Turn all Daml Intro templates into full projects

CHANGELOG_BEGIN
CHANGELOG_END

* Fix paths
2021-02-11 13:07:50 +00:00
Gary Verhaegen
bdf4095735
docs: remove references to create-daml-app repo (#8805)
* docs: remove references to create-daml-app repo

Hopefully that's all of them. Thanks to Alexander Bernauer for reporting
on [the forum].

[the forum]: https://discuss.daml.com/t/type-script-support-dropped-with-sdk-1-9-0/2054/6?u=gary_verhaegen

CHANGELOG_BEGIN
CHANGELOG_END

* remove template link
2021-02-10 11:45:59 +00:00
Moritz Kiefer
e196a7cc73
Clarify documentation around --project-root (#8790)
fixes #8783

changelog_begin
changelog_end
2021-02-10 12:03:59 +01:00
Gary Verhaegen
8c13dab5cc
docs: try to improve script --input-file (#8793)
CHANGELOG_BEGIN
CHANGELOG_END
2021-02-09 14:14:35 +00:00
Moritz Kiefer
9bf6935774
Clarify docs around --contract-id-seeding=no (#8796)
changelog_begin
changelog_end
2021-02-09 14:02:12 +00:00
Stefano Baghino
2dbeb7e27c
Fix typos in docs (#8761)
Originally reported in https://discuss.daml.com/t/my-feedback-on-daml-in-general-and-documentation-as-a-non-coder/2043

Standardise (sic) to US English spelling. ;-)

Typos

acessToken -> accessToken
assignement -> assignment
calulated -> calculated
certicates -> certificates
comitted -> committed
commited -> committed
conctract -> contract
corrseponding -> corresponding
couteroffer -> counteroffer
Decmial -> Decimal
desireable -> desirable (archaic)
Distpute -> Dispute
encoutered -> encountered
enviroment -> environment
Exercse -> Exercise
exeuction -> execution
familiarise -> familiarize (British spelling)
fistName -> firstName
follwing -> following
fullfil -> fulfill (fulfil would be British spelling)
intepretation -> interpretation
leger -> ledger
lookupBeyKey -> lookupByKey
Messsaging -> Messaging
mimick -> mimic
Modelling -> Modeling (British spelling)
occured -> occurred
Partipant -> Participant
partiuclarly -> particularly
possibiy -> possibly
PostreSQL -> PostgreSQL
preceed -> precede
preceeding -> preceding
preferrable -> preferable
programatically -> programmatically
prohibitied -> prohibited
readyness -> readiness
Readyness -> Readiness
resepond -> respond
similiar -> similar
snipppets -> snippets
somone -> someone
succintly -> succinctly
transacion -> transaction
transfering -> transferring
transferrable -> transferable

I was surprised by the last two.

I hope this commit message does not contain any typo.

changelog_begin
changelog_end
2021-02-04 19:44:15 +01:00
Moritz Kiefer
b07ab07fc1
Drop early access marker from choice observers (#8713)
changelog_begin
changelog_end
2021-02-02 10:44:47 +01:00
Stefano Baghino
ecf5f9b9c4
Enforce Java formatting style with google-java-format (#8686)
* Amend fmt.sh to check Java formatting with javafmt

changelog_begin
changelog_end

* Address https://github.com/digital-asset/daml/pull/8686#issuecomment-769740615

* Apply new formatting style to main code

* Apply new code style to docs code
2021-01-29 16:50:18 +00:00
Andreas Herrmann
a226324afa
Use cliopts.Http for OAuth 2.0 middleware (#8671)
* Use cliopts.Http for OAuth 2.0 middleware

changelog_begin
- [OAuth 2.0 Middleware] You can now configure the address that the
  middleware listens to using the ``--address`` flag.
  The port that the middleware listens to is now configured using the
  ``--http-port`` flag, use 0 to dynamically choose a free port.
  You can now configure a port file where the chosen port will be
  written to using the ``--port-file`` flag.
changelog_end

* Add test-case for OAuth 2.0 middleware port file

* Don't forget to close source

* Fix integration test

* Update triggers/service/auth/src/main/scala/com/daml/auth/middleware/oauth2/Config.scala

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-01-29 09:32:07 +00:00
Andreas Herrmann
6bfbaf021d
Auth0 example configuration (#8622)
* Auth0 example configuration

changelog_begin
changelog_end

* Update docs/source/tools/trigger-service/auth0_example.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Disclaimer that rule doesn't validate

https://github.com/digital-asset/daml/pull/8622#discussion_r564341409

* Explain access to Alice in code

https://github.com/digital-asset/daml/pull/8622#discussion_r564341821

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-01-26 17:38:56 +00:00
Moritz Kiefer
6326822907
Upgrade grpc and protobuf libraries (#8558)
* Upgrade grpc and protobuf libraries

changelog_begin

- [Dependencies] Upgrade
  iou.grpc:grpc-(api|core|netty|protobuf|services|stub) to
  1.35.0.

- [Dependencies] Upgrade
  io.netty:netty-(codec-http2|handler|handler-proxy|resolver)
  to 4.1.58.Final.

- [Dependencies] Upgrade
  io.netty:netty-tcnative-boringssl-static to 2.0.36.Final.

- [Dependencies] Upgrade com.google.protobuf:protobuf-java to 3.14.0.

changelog_end

* Factor out netty and grpc version

changelog_begin
changelog_end
2021-01-26 14:17:18 +00:00
Andreas Herrmann
5706f5e15d
Drop early access tag on trigger service and auth middleware (#8611)
* add livez endpoint to auth middleware

* Add OAuth 2.0 middleware to Daml SDK

* unhide trigger service auth flags

changelog_begin
- [Triggers] The trigger service now supports authorization through an
  auth middleware. The feature is enabled using the `--auth` and
  `--auth-callback` command-line flags. Please refer to the
  Authorization chapter of the trigger service documentation for further
  instructions.
- [OAuth 2.0 middleware] Daml Connect now includes an implementation of
  the auth middleware API that supports OAuth 2.0 Authorization Code
  Grant. Please refer to the Auth Middleware and OAuth 2.0 Auth
  Middleware chapters of the documentation.
changelog_end

* drop early access flag on triggers

Daml triggers, the trigger service, and the auth middleware are no
longer marked as early access features.

changelog_begin
- [Triggers] Daml Triggers and the Trigger Service are no longer in
  early access status.
changelog_end

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
2021-01-22 17:02:24 +01:00
Andreas Herrmann
7543c6fdc0
Document authorization with trigger service (#8581)
* Docs for trigger-service auth and auth middleware

changelog_begin
changelog_end

* Document OAuth 2.0 authorization middleware

* Explain 401 Unauthorized resonse

* Add JS frontend example

* Update docs/source/tools/auth-middleware/index.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/tools/auth-middleware/index.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/tools/auth-middleware/index.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/tools/auth-middleware/index.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/tools/auth-middleware/oauth2.rst

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* trigger service don't redirect by default

3a5dba7a70 (r562497928)

* Call it Auth Middleware

https://github.com/digital-asset/daml/pull/8581#discussion_r562442571

Co-authored-by: Andreas Herrmann <andreas.herrmann@tweag.io>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2021-01-22 11:53:26 +01:00
Sofia Faro
c1a736efd1
Add choice observers in the ledger model. (#8576)
* Add choice observers in the ledger model.

To keep the distinction between "observer" and "choice observer"
clear I'm trying to always refer to the former as "contract observer".

The section on divulgence should probably be reworked to favor choice
observers at some point, but I'm not sure how to do that.

changelog_begin
changelog_end

* s/observer/contract observer

* Separate out the choice observer case of informees

* apply suggestion from @oggy-

* specifying choice observers in DAML contract model
2021-01-20 13:16:45 +00:00
Gary Verhaegen
71a1260e56
fix typo in docs (#8502)
CHANGELOG_BEGIN
CHANGELOG_END
2021-01-14 19:46:44 +00:00
arne-da
b398a55780
Fixing typos in documentation (#8163)
CHANGELOG_BEGIN
Fixed minor typos in documentation
CHANGELOG_END
2021-01-12 13:11:12 +01:00
Ognjen Maric
7171cb38fa
Allow multiple requesters for a commit in the ledger model (#8471)
CHANGELOG_BEGIN
- Adjust the ledger model to account for multi-party submissions
CHANGELOG_END
2021-01-12 11:49:52 +00:00
Bernhard Elsner
5cfa6d71f8
Add table correlating Connect and Ledger API version (#8456)
* Add table correlating Connect and Ledger API version

CHANGELOG_BEGIN
CHANGELOG_END

* Use a legal character for header underlining

* Flip columns

* Remove empty line
2021-01-11 15:09:53 +00:00
Richard Kapolnai
592e794adf
Doc minor issues (#8451)
* fix typos in docs
CHANGELOG_BEGIN
CHANGELOG_END

* minor corrections

* revert a change

* update structure doc based on comments
2021-01-11 15:52:43 +01:00
Bernhard Elsner
cda93db944
Daml case and logo (#8433)
* Replace many occurrences of DAML with Daml

* Update docs logo

* A few more CLI occurrences

CHANGELOG_BEGIN
- Change DAML capitalization and docs logo
CHANGELOG_END

* Fix some over-eager replacements

* A few mor occurrences in md files

* Address comments in *.proto files

* Change case in comments and strings in .ts files

* Revert changes to frozen proto files

* Also revert LF 1.11

* Update get-daml.sh

* Update windows installer

* Include .py files

* Include comments in .daml files

* More instances in the assistant CLI

* some more help texts
2021-01-08 12:50:15 +00:00
Gary Verhaegen
427179ab27
fix (some) copyright headers (#8422)
This commit fixes a few copyright headers that have been missed in the
automatic update on Jan 1, as well as the generation code in the compat
workspace so it generates the right headers.

CHANGELOG_BEGIN
CHANGELOG_END
2021-01-07 11:48:59 +01:00
Richard Kapolnai
bee1fbcaa9
Doc: mention ledger offset in transaction service too (#8418)
* Mention ledger offset in Transaction service as well, not just in Active contracts service

* typo

* CHANGELOG_BEGIN
CHANGELOG_END
2021-01-07 08:02:07 +00:00
Moritz Kiefer
df35aed5bb
Remove Navigator console (#8392)
* Remove Navigator console

This was a labs feature so we can remove it without a deprecation
cycle. It doesn’t have any known users and is almost completely
superseded by DAML REPL.

@bame-da agreed to the removal.

This also has the nice side effect of eliminating 1 of our 2
dependencies that were not Scala 2.13 compatible.

changelog_begin

- [Navigator Console] The labs feature Navigator Console has been
  removed. Users are encouraged to use DAML REPL instead.

changelog_end

* Kill Navigator database docs completely

changelog_begin
changelog_end
2021-01-05 13:20:48 +01:00
Sofia Faro
2c248a411c
Add LF version 1.11 in damlc (#8371)
* Add LF version 1.11 in damlc

This maintains the default as 1.8 for now.

CHANGELOG_BEGIN
CHANGELOG_END

* Fix version1_11 doc
2021-01-04 14:53:00 +00:00
Gary Verhaegen
a925f0174c
update copyright notices for 2021 (#8257)
* update copyright notices for 2021

To be merged on 2021-01-01.

CHANGELOG_BEGIN
CHANGELOG_END

* patch-bazel-windows & da-ghc-lib
2021-01-01 19:49:51 +01:00
Gary Verhaegen
93f449d245
rename master to main (#8245)
As we strive for more inclusiveness, we are becoming less comfortable
with historically-charged terms being used in our everyday work.

This is targeted for merge on Dec 26, _after_ the necessary
corresponding changes at both the GitHub and Azure Pipelines levels.

CHANGELOG_BEGIN

- DAML Connect development is now conducted from the `main` branch,
  rather than the `master` one. If you had any dependency on the
  digital-asset/daml repository, you will need to update this parameter.

CHANGELOG_END
2020-12-27 14:19:07 +01:00
Moritz Kiefer
df98ee0107
Support multi-party submissions in DAML Script over JSON API (#8339)
* Support multi-party submissions in DAML Script over JSON API

changelog_begin

- [DAML Script] Multi-party submissions are now also supported over
  the JSON API.

changelog_end

* Fix outdated comment

changelog_begin
changelog_end
2020-12-18 12:45:34 +01:00
Moritz Kiefer
494077cb3d
Support multi-party submissions in the JSON API (#8328)
* Support multi-party submissions in the JSON API

changelog_begin

- [JSON API] Add support for multi-party submissions by allowing for
multiple actAs parties in the token and passing on readAs to the
ledger.

changelog_end

* Update ledger-service/http-json/src/main/scala/com/digitalasset/http/EndpointsCompanion.scala

Co-authored-by: Stephen Compall <stephen.compall@daml.com>

Co-authored-by: Stephen Compall <stephen.compall@daml.com>
2020-12-17 21:10:09 +00:00
Moritz Kiefer
9447fdadca
Clarify DAML Script docs (#8198)
"UI testing" has caused some confusion since DAML Script clearly
doesn’t replace something like puppeteer.

changelog_begin
changelog_end
2020-12-08 12:54:15 +00:00
Richard Kapolnai
158e866f24
Improve consistency of describing consuming and nonconsuming choices (#8179)
* slightly improve consistency of describing consuming and nonconsuming choices

* CHANGELOG_BEGIN
CHANGELOG_END
2020-12-07 14:33:56 +01:00
Moritz Kiefer
4e8a7f420e
Deprecate Sandbox persistence (#8181)
* Deprecate Sandbox persistence

changelog_begin
changelog_end

* Update docs/source/tools/sandbox.rst

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>

* Include in component statuses

changelog_begin
changelog_end

* Fix daml on sql Name param

changelog_begin
changelog_end

* make it compile

changelog_begin
changelog_end

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>
2020-12-07 12:08:36 +00:00
Richard Kapolnai
78f2fed0ad
Doc fix minor issues in intro (#8174)
* fix referring to a transaction
CHANGELOG_BEGIN
CHANGELOG_END

* fix typo

* remove ambiguous statement

* rename setupResults to setupResult

* typo

* Reformat the two principles.

* typo

* revert removal
2020-12-07 09:44:10 +00:00
Richard Kapolnai
49d1f1c37f
typo: doubling words (#8173)
CHANGELOG_BEGIN
CHANGELOG_END
2020-12-07 09:53:21 +01:00
Richard Kapolnai
9d2dd51684
Doc: fix minor issues in intro 2 (#8175)
* remove inadequate picture

* simplify example

* fix format in comment

* typo

* add signature screenshot

* dummy whitespace
CHANGELOG_BEGIN
CHANGELOG_END

* revert dummy whitespace
2020-12-05 16:23:12 +01:00
fabiotudone-da
29dd5909b8
Document participant pruning for operators [KVL-421] (#8138)
* Document participant pruning for operators

CHANGELOG_BEGIN
CHANGELOG_END

* Add references

* Add references and authorization info

* Address review comments

* Keep paragraphs on the same line

* Fix link to Pruning Service

* Add services section for Pruning Service

* Add Pruning Service to service diagrams

* Fix leftover

* How to determine a suitable pruning offset

* Expand determining a suitable offset

* Expand API impacts

* Expand limitations

* Address review comments

* Address review comments
2020-12-04 19:35:31 +01:00
Richard Kapolnai
6a9a32fb97
Rename scenarios to scripts (#8147)
* Rename scenarios to scripts
CHANGELOG_BEGIN
CHANGELOG_END

* Refer to test scripts

* avoid referring to RT and LT in tests

* remove obsolete restrictions

* fix underline

* revert accidental type annotation

* fix typo

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* Update docs/source/daml/intro/5_Restrictions.rst

Co-authored-by: Richard Kapolnai <richard.kapolnai@digitalasset.com>

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2020-12-04 10:02:10 +00:00
Gary Verhaegen
0e0b9ab8a4
JSON API: document encoding flags (#8157)
CHANGELOG_BEGIN
CHANGELOG_END
2020-12-03 17:40:32 +00:00
Richard Kapolnai
f899a3e19c
Fixing minor documentation errors (#8144)
* fix minor typos
CHANGELOG_BEGIN
CHANGELOG_END

* Remove notes and comments on pragma

* minor fix: remove "again" again

* fix various typos

* remove unexplained "bank" references

* replace LET with LT

* fix typo

* remove "again"

* fix grammar

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>

* adjust line numbers to include

Co-authored-by: Bernhard Elsner <40762178+bame-da@users.noreply.github.com>
2020-12-03 15:28:34 +00:00
Moritz Kiefer
94578bd2fd
Fix docs for Java quickstart (#8129)
Noticed this while using it to test Navigator changes. Not sure for
how long this has been outdated but definitely for quite a while.

changelog_begin
changelog_end
2020-12-02 12:47:58 +01:00