Commit Graph

988 Commits

Author SHA1 Message Date
Moritz Kiefer
7c1fd50469
Bump grunt-browserify (#11026)
Missed it in #11023

changelog_begin
changelog_end
2021-09-27 09:03:35 +00:00
Moritz Kiefer
91be1e1659
Drop matchdep dependency from docs build (#11023)
We really don’t need 600 lines of mostly deprecated and unmaintained
dependencies which get flagged by blackduck & dependabot if we can
inline this into a static array which we never changed since we first
added the docs.

changelog_begin
changelog_end
2021-09-27 09:48:00 +02: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
Samir Talwar
65dfba44c9
docs: Suppress the output from unzip. (#10164)
It's loud.

CHANGELOG_BEGIN
CHANGELOG_END
2021-07-01 14:11:48 +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
Gary Verhaegen
39a5890b50
fix 9_functional redirect (#10067)
CHANGELOG_BEGIN
CHANGELOG_END
2021-06-21 19:11:23 +02: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