The Daml smart contract language
Go to file
2019-05-07 09:27:38 -04:00
.github add note about security issues in issue template (#503) 2019-04-16 10:20:17 +02:00
.vscode open-sourcing daml 2019-04-04 09:33:38 +01:00
3rdparty Shorten data-default-instances-dlist target name (#908) 2019-05-04 11:06:23 +00:00
bazel_tools Hazel: ./configure in build step (#848) 2019-05-03 13:51:43 +00:00
build-scripts correct jq in dev-env (#463) 2019-04-12 16:44:15 -04:00
ci Upgrade to nixpkgs 19.03 (again) (#962) 2019-05-07 13:55:30 +02:00
compiler Clean up UtilGHC (#963) 2019-05-07 12:42:48 +01:00
da-assistant Delete modules that appear entirely unused (#909) 2019-05-04 11:54:27 +00:00
daml-assistant Fix getDispatchEnv / getDamlEnv re-entrancy. (#951) 2019-05-06 19:25:30 +00:00
daml-foundations Clean up UtilGHC (#963) 2019-05-07 12:42:48 +01:00
daml-lf Daml lf type safty (Party & PackageId) (#761) 2019-05-06 20:40:43 +02:00
dev-env add sbt to dev-env (#964) 2019-05-07 09:27:38 -04:00
docs Java Codegen: Generate types with multiple name components (#946) 2019-05-07 11:12:42 +02:00
extractor Daml lf type safty (Party & PackageId) (#761) 2019-05-06 20:40:43 +02:00
ghc-lib Add to ghc-lib developer documentation (#467) 2019-04-15 05:58:33 -04:00
hazel Upgrade to new Stackage snapshot (#941) 2019-05-06 15:45:31 +02:00
infra install StackDriver on build machines (#905) 2019-05-04 22:55:51 +00:00
language-support Java Codegen: Removing some dead/unused code (#971) 2019-05-07 14:59:20 +02:00
ledger Extend test durations on CI for Ledger API Test Tool driven test. (#944) 2019-05-07 14:52:49 +02:00
ledger-api add result of exercise to transaction -- fixes #479 (#583) 2019-05-06 14:33:44 +02:00
libs-haskell Fix getDispatchEnv / getDamlEnv re-entrancy. (#951) 2019-05-06 19:25:30 +00:00
navigator Daml lf type safty (Party & PackageId) (#761) 2019-05-06 20:40:43 +02:00
nix add sbt to dev-env (#964) 2019-05-07 09:27:38 -04:00
notices-gen Update rules_haskell - now generates Haskell version macros (#769) 2019-04-30 11:44:11 +00:00
oss-compliance Update version in Pipfile.lock (#867) 2019-05-02 23:38:45 +00:00
rattle Prototype to accelerate Windows development (#411) 2019-04-12 10:45:11 +01:00
release Simplify daml new template release process and add a simpler default template. (#850) 2019-05-03 08:17:15 +00:00
replacements open-sourcing daml 2019-04-04 09:33:38 +01:00
rules_daml Remove damli completely (#481) 2019-04-15 14:47:59 +02:00
scala-protoc-plugins Enforce consistent formatting of BUILD files. (#412) 2019-04-12 13:10:16 +02:00
sdk Enforce consistent formatting of BUILD files. (#412) 2019-04-12 13:10:16 +02:00
templates Simplify daml new template release process and add a simpler default template. (#850) 2019-05-03 08:17:15 +00:00
web-ide webide: add vscode settings to disable telementry (#825) 2019-05-03 12:04:30 -04:00
.bazelignore open-sourcing daml 2019-04-04 09:33:38 +01:00
.bazelrc Do not pass --remote_http_cache to Bazel on Windows (#714) 2019-04-26 09:52:50 +02:00
.dadew Add a windows installer for the SDK (#738) 2019-04-29 10:16:11 +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 Merge conflicting release-notes.rst changes automatically (#893) 2019-05-03 17:15:18 +02:00
.gitignore Prototype to accelerate Windows development (#411) 2019-04-12 10:45:11 +01:00
.hlint.yaml GHC 8.6 compat for the IDE (#955) 2019-05-06 21:29:22 +01:00
.mergify.yml strictify mergify (#576) 2019-04-17 14:25:36 +01:00
.scalafmt.conf open-sourcing daml 2019-04-04 09:33:38 +01:00
.stylish-haskell.yaml open-sourcing daml 2019-04-04 09:33:38 +01:00
.watchmanconfig open-sourcing daml 2019-04-04 09:33:38 +01:00
azure-pipelines.yml don't annoy people with broken master (#936) 2019-05-06 16:15:40 +00:00
BAZEL-haskell.md Update rules_haskell - now generates Haskell version macros (#769) 2019-04-30 11:44:11 +00:00
BAZEL-JVM.md open-sourcing daml 2019-04-04 09:33:38 +01:00
BAZEL.md Remove pipeline samples (#773) 2019-04-29 20:07:23 +02:00
BUILD Update rules_haskell and don't use nixpkgs c2hs (#525) 2019-04-16 13:42:52 +02:00
build.ps1 Remove pipeline samples (#773) 2019-04-29 20:07:23 +02:00
build.sh run perf tests separately (#605) 2019-04-18 16:46:02 +00:00
CHANGELOG open-sourcing daml 2019-04-04 09:33:38 +01:00
CODE_OF_CONDUCT.md open-sourcing daml 2019-04-04 09:33:38 +01:00
CONTRIBUTING.md Clean up the guidelines for PR title/description (#427) 2019-04-12 11:33:11 +01:00
COPY HOTFIX rename COPYRIGHT so github correctly shows apache2 license for repo (#274) 2019-04-05 22:10:47 -04:00
daml-logo.png open-sourcing daml 2019-04-04 09:33:38 +01:00
dependencies.yaml adding Metrics around Ledger operations (#646) 2019-04-24 16:51:20 +02:00
deps.bzl Hazel: ./configure in build step (#848) 2019-05-03 13:51:43 +00:00
dotfiles open-sourcing daml 2019-04-04 09:33:38 +01:00
fmt.sh Fix "unbound variable" error in fmt.sh (#933) 2019-05-06 12:06:41 +02:00
LICENSE open-sourcing daml 2019-04-04 09:33:38 +01:00
NOTICES open-sourcing daml 2019-04-04 09:33:38 +01:00
package.json Remove //language-support/js (#691) 2019-04-25 14:30:25 +02:00
README.md Update the README with instructions to install and use a local version (#688) 2019-04-25 12:10:44 +01:00
scalafmt.sh open-sourcing daml 2019-04-04 09:33:38 +01:00
tsconfig.json open-sourcing daml 2019-04-04 09:33:38 +01:00
Upgrading.md Upgrade to new Stackage snapshot (#941) 2019-05-06 15:45:31 +02:00
util.bzl Add lsp deps (#724) 2019-04-26 14:00:15 +02:00
VERSION Release 0.12.15 (#925) 2019-05-06 09:57:15 +02:00
WORKSPACE Upgrade to nixpkgs 19.03 (again) (#962) 2019-05-07 13:55:30 +02:00
yarn.lock open-sourcing daml 2019-04-04 09:33:38 +01: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.

Contribuing 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

Note that the Windows build is not yet fully functional and is not supported.

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.

4. Installing a local copy

On Linux and Mac run da-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.z
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.