The Daml smart contract language
Go to file
Rohan Jacob-Rao 0b5762e437
Trigger service: use DB for start and list commands (#6153)
* Insert running trigger to DB when using one

If the DB write fails, the server sends itself a
TriggerInitializationFailure message so that the corresponding trigger
runner is stopped and the table is in sync with the actors.
We still need to retry writes here.

Includes basic test that runs the server with a JDBC config set and adds
a trigger, expecting a new entry to be added to the DB. However does not
check the running trigger table which we can do once reads are
implemented.

changelog_begin
changelog_end

* Await on future in test

* Update to new assertTriggerIds

* Apply scalafmt suggestions

* Create index on party token

* Read db in list command

* Update comment in test script

* Remove outdated comment

* Fix strings in insert and select

* Clean up test

* Add a second trigger in the db test

* Fix comment in test script

* Comment db tables

* Order trigger instances in list command

* Comment about TriggerDao execution context
2020-06-02 16:57:35 +00:00
.github ADD: Change most Slack references to forum references where appropriate (#6071) 2020-05-26 09:26:53 -04:00
.vscode open-sourcing daml 2019-04-04 09:33:38 +01:00
3rdparty update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
bazel_tools disable warts.Any and remove most suppressions (#6132) 2020-05-28 16:53:41 +00:00
build-scripts replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
ci Sort files when calculating CACHE_KEY (#6173) 2020-05-31 22:02:13 +02:00
compatibility Document how to use compatibility sub-dir (#6194) 2020-06-02 16:37:41 +00:00
compiler Handle contract key failures due to visiblity in scenarios (#6165) 2020-05-29 18:35:53 +02:00
daml-assistant language: add an empty template for the daml assistant. (#6102) 2020-05-26 15:27:10 +02:00
daml-lf DAML profiler: Use non-blocking IO for writing profiles (#6184) 2020-06-02 12:55:09 +00:00
daml-script Introduce DAML-LF value caching for transaction service (#6052) 2020-05-26 08:33:53 +00:00
dev-env add find to dev-env (#6175) 2020-06-01 15:11:55 +02:00
docs declare http-json Streaming API as stable (#6152) 2020-05-29 08:33:11 -04:00
extractor disable warts.Any and remove most suppressions (#6132) 2020-05-28 16:53:41 +00:00
ghc-lib update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
infra Macos fix nix installer for build agent servers (#6133) 2020-05-28 14:04:01 +02:00
language-support Remove older isLoading function calls. (#6181) 2020-06-02 16:46:54 +00:00
ledger Enable caching of immutable state values only (#6187) 2020-06-02 16:50:39 +00:00
ledger-api disable warts.Any and remove most suppressions (#6132) 2020-05-28 16:53:41 +00:00
ledger-service disable warts.Any and remove most suppressions (#6132) 2020-05-28 16:53:41 +00:00
libs-haskell Make daml start work with --sandbox-port=0 (#5630) 2020-04-20 17:07:30 +02:00
libs-scala disable warts.Any and remove most suppressions (#6132) 2020-05-28 16:53:41 +00:00
navigator Upgrade puppeteer (#6142) 2020-05-28 21:58:52 +02:00
nix add find to dev-env (#6175) 2020-06-01 15:11:55 +02:00
oss-compliance replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
release tweak release process (#6054) 2020-05-28 00:24:00 +02:00
replacements replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
rules_daml Bazel rule to inspect dar file when compiling daml (#6067) 2020-05-21 11:06:51 +00:00
scala-protoc-plugins Use com.daml as root package (#5343) 2020-04-05 19:49:57 +02:00
templates Upgrade puppeteer (#6142) 2020-05-28 21:58:52 +02:00
triggers Trigger service: use DB for start and list commands (#6153) 2020-06-02 16:57:35 +00:00
.bazelignore Ignore compatibility directory (#5687) 2020-04-23 10:33:38 +00:00
.bazelrc Configure Bazel repository cache for build (#5733) 2020-04-27 10:10:21 +00:00
.dadew Upgrade puppeteer (#6142) 2020-05-28 21:58:52 +02:00
.dockerignore open-sourcing daml 2019-04-04 09:33:38 +01:00
.envrc open-sourcing daml 2019-04-04 09:33:38 +01:00
.gitattributes Remove unreleased.rst (#3547) 2019-11-20 15:16:57 +00:00
.gitignore Include the first feature in compat tests for create-daml-app (#6002) 2020-05-18 14:37:16 +02:00
.hie-bios Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
.hlint.yaml replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
.mergify.yml replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
.scalafmt.conf Revert "Adopt trailingCommas option in scalafmt (#4214)" (#4257) 2020-01-29 11:43:35 +00:00
.sha256 Improve performance of stakeholder retrieval from SQL (#3207) 2019-10-28 14:16:21 +01:00
.watchmanconfig open-sourcing daml 2019-04-04 09:33:38 +01:00
azure-cron.yml add default machine capability (#5912) 2020-05-09 18:21:42 +02:00
azure-pipelines.yml fix fat-jar publish (#6046) 2020-05-20 15:08:53 +02:00
BAZEL-bash.md add Bazel bash help (#2223) 2019-07-19 15:31:45 +00:00
bazel-haskell-deps.bzl WIP: Draft version constraint generation (#5472) 2020-05-20 08:08:18 +02:00
BAZEL-haskell.md Remove bzip2 library (#5105) 2020-03-20 15:05:33 +01:00
bazel-java-deps.bzl use 2.13-style collections library syntax in json-api (#6075) 2020-05-27 22:27:25 +00:00
BAZEL-JVM.md Use com.daml as root package (#5343) 2020-04-05 19:49:57 +02:00
BAZEL.md Document Nix cleanup (#5907) 2020-05-08 11:12:43 +02:00
BUILD Configure python toolchain via nixpkgs_python_configure (#5702) 2020-04-23 17:30:32 +02:00
build.ps1 Publish Bazel logs (#5821) 2020-05-04 11:14:40 +02:00
build.sh remove envsubst from dev-env (#6098) 2020-05-26 12:25:54 +02:00
CHANGELOG Move unreleased user-facing features to its own file (#1762) 2019-06-19 16:32:03 +02:00
CODE_OF_CONDUCT.md open-sourcing daml 2019-04-04 09:33:38 +01:00
CODEOWNERS Make Remy and Martin codeowner of everything interpreter (#5952) 2020-05-13 10:51:28 +00:00
CONTRIBUTING.md Ensure that on first call to ReadService.stateUpdates beginOffset is … (#6103) 2020-05-26 17:36:02 +01:00
COPY replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
daml-logo.png #2785 add daml_logo.png for README (#2787) 2019-09-06 09:35:32 +02:00
deps.bzl Use a custom Scala binary for the sandbox migration tests (#6140) 2020-05-28 15:02:54 +02:00
dotfiles open-sourcing daml 2019-04-04 09:33:38 +01:00
fmt.sh Fix ./fmt.sh check (#5718) 2020-04-24 12:04:14 +00:00
LATEST Release new snapshot (#6154) 2020-05-29 10:58:24 +02:00
LICENSE update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
maven_install.json use 2.13-style collections library syntax in json-api (#6075) 2020-05-27 22:27:25 +00:00
NOTICES remove MissingH (#3948) 2020-01-06 14:36:14 +01:00
package.json Upgrade rules_nodejs to version 1.6.0 (#5539) 2020-04-17 12:03:33 +00:00
README.md update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
release.sh trigger all releases from master (#6016) 2020-05-19 19:18:10 +02:00
report-std-change.sh replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
SECURITY.md Create SECURITY.md (#1357) 2019-05-31 08:58:21 +01:00
stack-snapshot.yaml WIP: Draft version constraint generation (#5472) 2020-05-20 08:08:18 +02:00
tsconfig.json open-sourcing daml 2019-04-04 09:33:38 +01:00
unreleased.rst replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
unreleased.sh replace DAML Authors with DA in copyright headers (#5228) 2020-03-27 01:26:10 +01:00
Upgrading.md Replace Hazel by stack_snapshot (#2743) 2019-11-22 14:24:08 +00:00
WORKSPACE Upgrade puppeteer (#6142) 2020-05-28 21:58:52 +02:00
workspace_status.sh fix sitemap generation (#5775) 2020-04-30 15:02:08 +02:00
yarn.lock Upgrade rules_nodejs to version 1.6.0 (#5539) 2020-04-17 12:03:33 +00:00

DAML logo

Download License Build

Copyright 2020 Digital Asset (Switzerland) GmbH and/or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0

Welcome to the DAML repository!

This repository hosts all code for the DAML smart contract language and SDK, originally created by Digital Asset. DAML is an open-source smart contract language for building future-proof distributed applications on a safe, privacy-aware runtime. The DAML SDK is a set of tools to help you develop applications based on DAML.

Using DAML

To download DAML, follow the installation instructions. Once installed, to try it out, follow the quickstart guide.

If you have questions about how to use DAML or how to build DAML-based solutions, please ask them on StackOverflow using the daml tag.

Contributing to DAML

We warmly welcome contributions. If you are looking for ideas on how to contribute, please browse our issues. To build and test DAML:

1. Clone this repository

git clone git@github.com:digital-asset/daml.git
cd daml

2. Set up the development dependencies

Our builds require various development dependencies (e.g. Java, Bazel, Python), provided by a tool called dev-env.

Linux and Mac

On Linux and Mac dev-env can be installed with:

  1. Install Nix by running: bash <(curl https://nixos.org/nix/install)
  2. Enter dev-env by running: eval "$(dev-env/bin/dade assist)"

If you don't want to enter dev-env manually each time using eval "$(dev-env/bin/dade assist)", you can also install direnv. This repo already provides a .envrc file, with an option to add more in a .envrc.private file.

Windows

On Windows you need to enable long file paths by running the following command in an admin powershell:

Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled -Type DWord -Value 1

Then start dev-env from PowerShell with:

.\dev-env\windows\bin\dadew.ps1 install
.\dev-env\windows\bin\dadew.ps1 sync
.\dev-env\windows\bin\dadew.ps1 enable

In all new PowerShell processes started, you need to repeat the enable step.

3. First build and test

We have a single script to build most targets and run the tests. On Linux and Mac run ./build.sh. On Windows run .\build.ps1. Note that these scripts may take over an hour the first time.

To just build do bazel build //..., and to just test do bazel test //.... To read more about Bazel and how to use it, see the Bazel site.

On Mac if building is causing trouble complaining about missing nix packages, you can try first running nix-build -A tools -A cached nix repeatedly until it completes without error.

4. Installing a local copy

On Linux and Mac run daml-sdk-head which installs a version of the SDK with version number 0.0.0. Set the version: field in any DAML project to 0.0.0 and it will use the locally installed one.

On Windows:

bazel build //release:sdk-release-tarball
tar -vxf .\bazel-bin\release\sdk-release-tarball.tar.gz
cd sdk-*
daml\daml.exe install . --activate

That should tell you what to put in the path, something along the lines of C:\Users\admin\AppData\Roaming\daml\bin. Note that the Windows build is not yet fully functional.

Caching: build speed and disk space considerations

Bazel has a lot of nice properties, but they come at the cost of frequently rebuilding "the world". To make that bearable, we make extensive use of caching. Most artifacts should be cached in our CDN, which is configured in .bazelrc in this project.

However, even then, you may end up spending a lot of time (and bandwidth!) downloading artifacts from the CDN. To alleviate that, by default, our build will create a subfolder .bazel-cache in this project and keep an on-disk cache. This can take about 10GB at the time of writing.

To disable the disk cache, remove the following lines:

build:linux --disk_cache=.bazel-cache
build:darwin --disk_cache=.bazel-cache

from the .bazelrc file.

If you work with multiple copies of this repository, you can point all of them to the same disk cache by overwriting these configs in either a .bazelrc.local file in each copy, or a ~/.bazelrc file in your home directory.

Haskell profiling builds

To build Haskell executables with profiling enabled, pass -c dbg to Bazel, e.g. bazel build -c dbg damlc. If you want to build the whole SDK with profiling enabled use daml-sdk-head --profiling.