The Daml smart contract language
Go to file
Samir Talwar 7510d0d404
daml-assistant: Add daml sandbox-next. (#5045)
* daml-assistant: Add `daml sandbox-next`.

CHANGELOG_BEGIN
- [DAML Assistant] You can now run a pre-release version of Sandbox with
  ``daml sandbox-next`` so you can test it out and verify everything is
  working as expected. Running this will launch Sandbox rebuilt on a
  more modern architecture. An upcoming release of DAML will switch over
  to the new implementation by default.
CHANGELOG_END

* daml-assistant: Explain that sandbox-next is experimental.

Co-Authored-By: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>

* daml-assistant: Copy-pasta an integration test for `daml sandbox-next`.

Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
2020-03-18 08:25:08 +00:00
.github check for changelog (#3963) 2020-01-07 17:19:50 +01: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 Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
build-scripts update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
ci skip fmt check for release (#5012) 2020-03-16 12:05:26 +01:00
compiler Give repl tests a long timeout (#5034) 2020-03-16 20:43:30 +00:00
daml-assistant daml-assistant: Add daml sandbox-next. (#5045) 2020-03-18 08:25:08 +00:00
daml-lf Engine: Replace SResultMissingDefinition by SResultNeedPackage (#5039) 2020-03-17 19:25:57 +01:00
daml-script sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
dev-env Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
docs sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
extractor DAM-LF minor fixes relative to GenMap (#5028) 2020-03-17 11:00:33 +01:00
ghc-lib update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
infra increase linux nodes to 10 (#4634) 2020-02-20 17:02:41 +00:00
language-support sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
ledger sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
ledger-api Introduce Stable Offsets (#4953) 2020-03-18 08:43:41 +01:00
ledger-service Fetch by parties endpoint to use new getParties gRPC call (#5027) 2020-03-16 16:42:01 -04:00
libs_python Ensure DarReader prevents zip bombs (#4703) 2020-02-26 13:09:58 +01:00
libs-haskell Support authentication and TLS in DAML repl (#4998) 2020-03-16 10:43:57 +01:00
libs-scala Spin-off BuildInfo into its own (micro-)library (#5004) 2020-03-16 09:04:00 +01:00
navigator Bump acorn from 6.3.0 to 6.4.1 in /navigator/frontend (#5007) 2020-03-16 12:31:47 +01:00
nix Generate ssl certs in a genrule instead of checking them in (#4950) 2020-03-12 10:36:40 +01:00
notices-gen update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
oss-compliance update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
release daml-assistant: Add daml sandbox-next. (#5045) 2020-03-18 08:25:08 +00:00
replacements update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
rules_daml New bazel rule -- daml_build_test -- to build a DAML project from its daml.yaml config, and setup a bazel test rule to validate the resulting .dar using daml validate-dar. (#4891) 2020-03-10 14:23:23 +00:00
scala-protoc-plugins Replace NamedLoggerFactory (#4097) 2020-01-21 10:57:28 +01:00
templates sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
triggers sandbox: Fail to start if a time mode is not explicitly specified. (#5033) 2020-03-18 08:25:03 +00:00
.bazelignore Add other node_modules to bazelignore (#4150) 2020-01-22 09:50:32 +00:00
.bazelrc docs cron: more reliable checksums (#4102) 2020-01-20 16:21:34 +01:00
.dadew Generate ssl certs in a genrule instead of checking them in (#4950) 2020-03-12 10:36:40 +01: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 ledger-on-sql: Migrate tables using Flyway. (#4232) 2020-01-28 16:16:23 +00:00
.hie-bios Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
.hlint.yaml Add hlint rule to use whenJust instead of maybe (pure ()) (#4659) 2020-02-24 10:08:44 +01:00
.mergify.yml add copyright headers to yml files (#4407) 2020-02-06 12:54:07 +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 do not send release notes to hubspot (#4956) 2020-03-11 21:41:46 +01:00
azure-pipelines.yml Bump nix version (#4934) 2020-03-11 12:26:29 +00:00
BAZEL-bash.md add Bazel bash help (#2223) 2019-07-19 15:31:45 +00:00
bazel-haskell-deps.bzl Embed shake data-files via TH (#4584) 2020-02-18 17:53:27 +01:00
BAZEL-haskell.md Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
bazel-java-deps.bzl Add first prototype of triggers as a service (TaaS) (#4287) 2020-01-31 12:53:45 +01:00
BAZEL-JVM.md Document @unpinned_maven//:pin (#3288) 2019-10-30 11:19:01 +01:00
BAZEL.md introduce new release process (#4513) 2020-02-25 17:01:23 +01:00
BUILD damlc validate-dar (#4654) 2020-02-27 14:26:14 +00:00
build.ps1 stop producing/publishing the Bazel execution logs (#4527) 2020-02-14 14:34:01 +01:00
build.sh Update rules_haskell (#4751) 2020-03-13 16:49:34 +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 narrow LF codeowners; add ledger-service codeowners (#4704) 2020-02-26 09:13:32 -08:00
CONTRIBUTING.md Document way to check added changelog entries (#3958) 2020-01-08 11:25:40 +00:00
COPY update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
daml-logo.png #2785 add daml_logo.png for README (#2787) 2019-09-06 09:35:32 +02:00
deps.bzl Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
dotfiles open-sourcing daml 2019-04-04 09:33:38 +01:00
fmt.sh saner scalafmt target (#4985) 2020-03-13 17:37:13 +01:00
LATEST retry release (#4914) 2020-03-09 20:46:22 +01:00
LICENSE update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
maven_install.json Add first prototype of triggers as a service (TaaS) (#4287) 2020-01-31 12:53:45 +01:00
NOTICES remove MissingH (#3948) 2020-01-06 14:36:14 +01:00
package.json language: add daml-react package to ts libraries (#4259) 2020-01-29 15:37:47 +01:00
README.md update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
release.sh add commands to extract relevant changelogs (#4905) 2020-03-10 12:45:31 +01:00
report-std-change.sh report-std-change: handle GitHub errors (#4814) 2020-03-05 10:06:58 +01:00
SECURITY.md Create SECURITY.md (#1357) 2019-05-31 08:58:21 +01:00
stack-snapshot.yaml Bump zip library (#4768) 2020-03-02 12:26:28 +01:00
tsconfig.json open-sourcing daml 2019-04-04 09:33:38 +01:00
unreleased.rst update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
unreleased.sh update copyright notices to 2020 (#3939) 2020-01-02 21:21:13 +01:00
Upgrading.md Replace Hazel by stack_snapshot (#2743) 2019-11-22 14:24:08 +00:00
WORKSPACE Generate ssl certs in a genrule instead of checking them in (#4950) 2020-03-12 10:36:40 +01:00
workspace_status.sh docs cron: more reliable checksums (#4102) 2020-01-20 16:21:34 +01:00
yarn.lock Bump acorn from 6.1.1 to 6.4.1 (#5006) 2020-03-16 12:26:08 +01: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.