* #13766 initial implementation of choice metadata for templates
* #13766 initial implementation of choice metadata for interfaces
* #13766 Add marker type to ContractTypeCompanion
* #13766 Minor type fix
* Cleanup after merge with main
* Temporary fix for package prefixes
* Format java files, rename Maker -> ContractType in ContractTypeCompanion
* Add documentation and tests
* Complete choice metadata implementation
CHANGELOG_BEGIN
- Add new representation of a choice, ChoiceMetadata.
- Generated templates and interfaces now include fields for each available choice. These fields will have a ChoiceMetadata type and will be called CHOICE_N, where N represents the choices' name.
CHANGELOG_END
* Update docs and cleanup tests
* Add link to support page (and indirectly to the support portal)
changelog_begin
changelog_end
* Update docs/source/support/support.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>
* Documentation for ledgerApiError in json api
CHANGELOG_BEGIN
Added docs for "ledgerApiError" field in json api response when the error is originated from JSON API
CHANGELOG_END
* Update docs/source/json-api/index.rst
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
* Update docs/source/json-api/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>
changelog_begin
[Ledger API Specification]:
1. Add 'is_deactivated' attribute to participant users.
2. Introduce participant server's local metadata for parties and participant users consisting of:
- a resource version for optional concurrent change control,
- modifiable key-value based annotations.
3. Add experimental update RPCs for parties and participant users:
- participant user's modifiable fields are: 'primary_party', 'is_deactivated', 'metadata.annotations',
- party's modifiable fields are 'local_metadata.annotations'.
4. Discourage use of 'party_details.display_name' in favor of using party's metadata annotations.
changelog_end
Other notes:
- no-op updates are allowed,
- update paths are resource relative,
- as annotation deletion is by providing an key with the empty string value,
- as a corollary, only non-empty strings are valid annotation values.
Correcting the folder names in the first two sections of the Basic Contracts tutorial to reflect what the user will actually see.
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Add "Next steps" page to "An introduction to Daml"
The idea is that of offering a comprehensive set of possible next steps after learning how to write Daml.
The page suggests certifications and points to existing examples as the previous final line on the last page,
as well as adding suggestions on where to learn more about building off-ledger services, how to install,
operate and maintain a ledger, where to learn about proven design patterns and the availability of Daml Hub
to get started without having to run your own ledger.
changelog_begin
changelog_end
* Apply suggestions from code review
Thank you @carrielaben-da, great suggestions as always!
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
* Add abstract class parents to generated ordinary records and variants
* Add common supertype for generated enums
* Add abstract class parents to generated ordinary records and variants
CHANGELOG_BEGIN
- Ordinary Records and Variants now have a super class defining toValue()
- Generated enums now have a common supertype, DamlEnum<T>
CHANGELOG_END
This removes the index.rst files from the repo, and instead generates a
placeholder index that just includes all the rst files at build time.
The reason for this change is that the ToC is defined in docs.daml.com,
and having one on both sides is both confusing and error-prone.
CHANGELOG_BEGIN
CHANGELOG_END
* Update quickstart.rst
Updated installation instructions
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Update quickstart.rst
To address Moritz's comment re: line 164
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Update docs/source/app-dev/bindings-java/quickstart.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Update quickstart.rst
Another attempted update. As I walk through this, it's not clear to me that we need any step beyond step 3 ("In the browser, log in as alice...") for a beginning user working through the tutorial locally?
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Update docs/source/app-dev/bindings-java/quickstart.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Quickstart.rst Maven edits
Hopefully final edits to this branch
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Integration w ledger update fix (#14983)
* fix Sphinx build
* update tree output
* remove non-existing ui-backend.conf reference
* update daml build output
* run through the whole thing
Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Correct error message for not found templates/interfaces in stream subscription
changelog_begin
When subscribing to Ledger API transaction streams with unknown template or interface ids
filter, a client is served with a NOT_FOUND/TEMPLATES_OR_INTERFACES_NOT_FOUND error code.
changelog_end
* Temporarily create a custom preview and dev conformance test for Canton
in order to allow the changed test exclusion
* Added documentation for interface support in json-api
CHANGELOG_BEGIN
Added documentation for interface support in json-api
CHANGELOG_END
* Added documentation for interface support in json-api
CHANGELOG_BEGIN
Added documentation for interface support in json-api
CHANGELOG_END
* Update docs/source/json-api/index.rst
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
* Update docs/source/json-api/index.rst
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
* Update docs/source/json-api/index.rst
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
* Update docs/source/json-api/index.rst
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
* Update docs/source/json-api/index.rst
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
CHANGELOG_BEGIN
Added new error category "SecurityAlert".
Corrected documentation of GRPC status codes for error categories MaliciousOrFaultyBehavior, AuthInterceptorInvalidAuthenticationCredentials, and InsufficientPermission.
CHANGELOG_END
changelog_begin
changelog_end
1. Document that the fetch-by-contract-ID endpoint can take a template ID
2. Reinforce the point made in #14601 and always specify the package ID
* document how to enable dev on both Daml and Canton
changelog_begin
changelog_end
* Update docs/source/daml/reference/interfaces.rst
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
* Update docs/source/daml/reference/interfaces.rst
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
* Update docs/source/daml/reference/interfaces.rst
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Update docs/source/daml/reference/interfaces.rst
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* change the link reference to a ref
Co-authored-by: carrielaben-da <91496516+carrielaben-da@users.noreply.github.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Update reference docs for interfaces and interface instances
* Rename subsection on empty interface instance clauses
* Move empty interface instance example below explanation
* Split 'interface instance in the interface' into its own subsection
* Add code example for interface instance in the interface
* Rephrase docs on interface method types
* Move docs on required interfaces to the bottom
* Add section on interface values
* Explain result of applying a method, highlight 'this' binding
changelog_begin
changelog_end
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Extract qualifyLocally in LFConversion
* Update ghc rev
* Add parent type argument to interface instance desugaring types
* Check interface instance parent in LFConversion
* Convert interface instances in interface declarations
* Update daml-test-files to use 'interface instance' syntax
* Update other tests to use 'interface instance' syntax
* Update interface reference docs to use 'interface instance' syntax
* Update other files to use 'interface instance' syntax
* Add todo in DA.Daml.LF.Ast.Pretty
* Add daml-test-files for retroactive interface instances
changelog_begin
changelog_end
Setting the font weight to 500 makes it effectively invisible, at least
in certain configurations (my setup is an Ubuntu 20.04 with Chrome 103).
In my experiments, 600 is the minimal font weight that makes the difference
visible on my setup. In order to keep the appearance of links unchanged,
I also decreased the font weight for links to the same as the body.
Another possibility to make a compromise that could work for different
setups could be to lower the font weight for bold to 600 and have a weight
specific for links at 500. This allows emphasis to appear clearly on setups
with less sophisticated font management but not to exagerated it for links.
changelog_begin
changelog_end
* Add DA_Internal_Interface to convertTypeDef exclusion check
* Move desugared types/values for interface views into DA.Internal.Desugar
* Convert viewtype and view method declarations
* Typecheck view types and view declarations
* Add unit viewtypes to InterfaceChoiceCollision tests
* Add unit viewtypes to more compiler/damlc tests
* Modify empty interfaces/implements to have viewtypes/views
* Add unit viewtypes to remaining Interface tests
* Test for error thrown when viewtype not specified
* Fix daml-lf/ interface tests to use new syntax / unit views
* Add placeholder view of type Unit to TestInterfaces
CHANGELOG_BEGIN
CHANGELOG_END
* Fix typescript interface tests with unit viewtype
* Add unit viewtype to Java & Scala codegen
* Add unit viewtype to triggers tests interface
* Add unit viewtypes to ledger/test-common
* Add unit viewtypes to ledger-service/http-json
* Fix some damlc tests
* Use viewtype syntax in InterfaceViewNonSerializable test
* Remove HasInferfaceView instances in convertBind
* Add unit view to QualifiedInterface.daml test
* Generate HasInterfaceView instances in DataDependencies
* Add unit viewtypes and views to compiler/damlc/tests
* Document reconstruction of HasInterfaceView
* Move desugared types/values for interface views into DA.Internal.Desugar
* Add desugarable function view w/ EViewInterface desugaring
* Remove templateName and viewtype from generated EViewInterface
* Update desugared-daml
* Proof of concept: use _view -> EViewInterface prim via HasInterfaceView
* Move view, HasInterfaceView to DA.Internal.Interface
* Update desugared-daml tests
* Stop removing and re-generating HasInterfaceView instances
* Do not generate docs for generated "_view_" methods
* Report errors with interface TypeConNames prettily
* Fix InterfaceViewNotSpecified @ERROR to reflect new error text
* Don't import magic `view` method from Prelude to avoid name clash
* Update shake interface goto definition test locations
* Temp disable view spec tests, will re-implement views in speedy
* Add unit viewtype to Java code snippet docs
* Update Interface syntax docs for views
* Add unit viewtype to Transferrable.daml
* Add back "empty" interface implementation to interfaces.rst
* Re-enable view tests by having _view methods on InterfaceViews.daml file
* Remove deprecated commented-out view desugaring code
* Clarify resolution of templates without package ID
In particular, with regards to the HTTP JSON API service.
changelog_begin
changelog_end
* Emphasize use case for package ID resolution
Suggested by @garyverhaegen-da
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Emphasize further
* Fix RST formatting
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Improve the documentation to run Daml script on Canton
CHANGELOG_BEGIN
CHANGELOG_END
* hints to synchronize contracts
* Fixup sphinx syntax in Daml Script on Canton docs
Annoyingly sphinx links are kinda confusing made worse by the fact
that we need to reference stuff defined in the Canton repo docs.
changelog_begin
changelog_end
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
A couple snippets seemed to have drifted. Rather than fix the line
numbers and risk having them drift again, this PR switches the references
to using comments instead, which should hopefully be more future-proof.
CHANGELOG_BEGIN
CHANGELOG_END
CHANGELOG_BEGIN
- [JSON API] For exercise endpoints, when multiple choices with the same
name are defined, the one directly defined on the ``templateId``,
which may be a template or interface ID, will be selected; if a
template ID is specified that only inherits the choices with the same
name, the new ``choiceInterfaceId`` option must be specified to select
the source of the choice.
CHANGELOG_END
