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.
To start using DAML
If you have questions about how to use DAML or how to build DAML-based solutions, please ask
them on StackOverflow using the
To start contributing to the DAML SDK
We warmly welcome contributions. To get set up for contributing to the SDK, follow these instructions:
1. Clone this repository
git clone firstname.lastname@example.org:digital-asset/daml.git.
2. Set up the DA Development Environment ("
dev-env provides dependencies required during the build phase, like Java, Bazel, and Python
for some tooling scripts. The code itself is built using Bazel.
dev-env on Linux or macOS
cd damlto switch into the new
damlrepository you just cloned
- Install Nix by running:
bash <(curl https://nixos.org/nix/install)
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
file, with an option to add more in a
dev-env on Windows
We're working on Windows support (for both end users and developers), but it's not ready yet. Sign up to be notified when it is available.
3. Build the source code
bazel build //...
This builds the code, and will likely take an hour or more.
Now you've built, rebuilding the code after a change will be much faster because Bazel caches unchanged build artefacts. To read more about Bazel and how to use it, see the Bazel site.
To run the tests, run
bazel test //...
If you are looking for ideas on how to contribute, please browse our issues.
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
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
in your home directory.