The Daml smart contract language
Go to file
Moritz Kiefer 5e962a2b61
DAML Triggers V0 (#2762)
This is a first step towards DAML triggers. At the moment, triggers
can consume (very simplified) create and archive events via the Ledger
API, update a state based on that and emit log mesages at each update.

All of this is likely to change significantly in the future, so I
would prefer to not focus too much on minor details for now.

As a test, I added a simple trigger that tracks active contract ids.
2019-09-05 12:56:41 +02:00
.github Include change management checkbox in PR template (#2318) 2019-07-31 17:36:00 +02:00
.vscode open-sourcing daml 2019-04-04 09:33:38 +01:00
3rdparty Start porting the transaction service integration tests (#2713) 2019-09-02 13:45:15 +02:00
bazel_tools Update ghc-lib (v8.8.1.20190830) (#2716) 2019-08-30 21:58:23 +00:00
build-scripts update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
ci update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
compiler Simplify conversion of top level bindings to DAML-LF (#2730) 2019-09-02 19:51:03 +00:00
daml-assistant ledger-api: rename decimal field to numeric in value Proto (#2688) 2019-08-29 22:51:33 +00:00
daml-lf DAML Triggers V0 (#2762) 2019-09-05 12:56:41 +02:00
dev-env dev-env: remove gradle (#2738) 2019-09-04 17:44:51 +01:00
docs Update instructions for publishing documentation (#2757) 2019-09-05 11:57:52 +02:00
extractor daml-lf: adapt interface reader to Numeric (#2666) 2019-09-02 10:02:56 +02:00
ghc-lib Basic docs for generic templates (#2731) 2019-09-03 20:55:24 +00:00
hazel Bump stackage (#2588) 2019-08-19 13:31:10 +02:00
infra update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
language-support daml-lf: adapt interface reader to Numeric (#2666) 2019-09-02 10:02:56 +02:00
ledger First multi-node test (#2737) 2019-09-05 09:37:51 +02:00
ledger-api ledger-api: rename decimal field to numeric in value Proto (#2688) 2019-08-29 22:51:33 +00:00
ledger-service Adding max-inbound-message-size startup parameter (#2746) 2019-09-04 16:28:11 -04:00
libs-haskell replace main file with a pointer to the source root (#2687) 2019-08-29 13:42:33 +02:00
navigator daml-lf: adapt interface reader to Numeric (#2666) 2019-09-02 10:02:56 +02:00
nix dev-env: remove gradle (#2738) 2019-09-04 17:44:51 +01:00
notices-gen update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
oss-compliance update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
release Update instructions for publishing documentation (#2757) 2019-09-05 11:57:52 +02:00
replacements update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
rules_daml update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
scala-protoc-plugins update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
templates replace main file with a pointer to the source root (#2687) 2019-08-29 13:42:33 +02:00
triggers DAML Triggers V0 (#2762) 2019-09-05 12:56:41 +02:00
.bazelignore open-sourcing daml 2019-04-04 09:33:38 +01:00
.bazelrc Default to -c opt in Bazel (#2592) 2019-08-19 17:10:30 +02:00
.dadew Fix curl on Windows (#2643) 2019-08-23 07:48:48 +00: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 Follow up with .gitattributes on #1762 (#1770) 2019-06-19 15:29:13 +00:00
.gitignore dev-env: remove gradle (#2738) 2019-09-04 17:44:51 +01:00
.hie-bios hie-bios: Don't hard-code import-dirs (#2562) 2019-08-15 16:08:35 +00:00
.hlint.yaml Migrate same package name (#2564) 2019-08-20 11:02:41 +02:00
.mergify.yml Rename automerge-dangerous-but-faster to automerge (#1605) 2019-06-12 08:37:07 -04:00
.scalafmt.conf open-sourcing daml 2019-04-04 09:33:38 +01:00
.watchmanconfig open-sourcing daml 2019-04-04 09:33:38 +01:00
azure-cron.yml reduce risk of double posting to hubspot (#2756) 2019-09-05 10:20:38 +01:00
azure-pipelines.yml fix azure (#2750) 2019-09-04 19:54:50 +01:00
BAZEL-bash.md add Bazel bash help (#2223) 2019-07-19 15:31:45 +00:00
BAZEL-haskell.md bazel-docs: Replace references to DACH-NY repo (#2655) 2019-08-26 08:50:11 +00:00
BAZEL-JVM.md bazel-docs: Replace references to DACH-NY repo (#2655) 2019-08-26 08:50:11 +00:00
BAZEL.md bazel-docs: Replace references to DACH-NY repo (#2655) 2019-08-26 08:50:11 +00:00
BUILD Update rules haskell (#2509) 2019-08-13 16:46:31 +02:00
build.ps1 windows: root build (#1894) 2019-06-28 12:55:31 +02:00
build.sh update copyright notices (#2499) 2019-08-13 17:23:03 +01: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 New Ledger API test tool (#2282) 2019-08-09 17:00:37 +02:00
CONTRIBUTING.md Minor Docs fixes (#2277) 2019-07-25 16:02:42 +02:00
COPY update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
dependencies.yaml Start porting the transaction service integration tests (#2713) 2019-09-02 13:45:15 +02:00
deps.bzl Upgrade to gRPC 1.23.0 (#2661) 2019-08-26 16:00:41 +02:00
dotfiles open-sourcing daml 2019-04-04 09:33:38 +01:00
fmt.sh update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
LICENSE Include Digital Asset Copyright in LICENSE file (#1022) 2019-05-08 14:35:21 -04:00
NOTICES open-sourcing daml 2019-04-04 09:33:38 +01:00
package.json Update to bazel-0.27 (#1957) 2019-07-05 14:04:47 +00:00
README.md Minor Docs fixes (#2277) 2019-07-25 16:02:42 +02:00
scalafmt.sh update copyright notices (#2499) 2019-08-13 17:23:03 +01:00
SECURITY.md Create SECURITY.md (#1357) 2019-05-31 08:58:21 +01:00
tsconfig.json open-sourcing daml 2019-04-04 09:33:38 +01:00
unreleased.rst First multi-node test (#2737) 2019-09-05 09:37:51 +02:00
Upgrading.md Switch to nixpkgs-unstable (#1921) 2019-06-27 18:47:42 +02:00
util.bzl Update ghc-lib (v8.8.1.20190830) (#2716) 2019-08-30 21:58:23 +00:00
VERSION Initiate release (#2745) 2019-09-04 15:39:46 -04:00
WORKSPACE Update ghc-lib (v8.8.1.20190830) (#2716) 2019-08-30 21:58:23 +00:00
yarn.lock Bump lodash from 4.17.11 to 4.17.14 (#2099) 2019-07-11 01:35:41 +00:00

DAML logo

Download License Build

Copyright 2019 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-genfiles\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.