The Daml smart contract language
Go to file
Stephen Compall 9ac74e697d
Oracle json-api: websockets and testing (#9278)
* comparison queries

* name the contract primary key constraint

* use ignore_row_on_dupkey_index instead of merge

- suggested by @cocreature in #9286 f7b2f14294fa33d6804251ce841529a1e2bd298d; thanks

* retrySqlStates for oracle

* enable all non-websocket tests

* name the template_id primary key constraint

* clean up concatFragment calls

* add Websocket tests for oracle

* move iouCreateCommand to be usable by oracle integration tests

* work around Scala 2.12 NPE in Source

* multiquery support for Oracle

* matchedQueries, therefore query-stream support for Oracle

* enable websocket tests

* test '& bar' and 5kb strings

- 5kb string fails on Oracle with
  ORA-01704: string literal too long

* refine the long data cases; gets too long at 4000 bytes as expected

- however, the predicate fails for unknown reason before then; possibly a missed
  escape character case

* handle long data with a fallback

- now the predicate fails in all cases instead of a SQL error, which is...better

* only interpolate true, false, null into JSON predicate conditions

- the problem was with JSON-formatted data; it must be SQL-typed instead

* adapt equal's large-data solution for comparison as well

- only works for numbers and strings, but that's all we need to compare

* move Implicits to Queries

* remove stray spaces in output

* test Oracle query expressions alongside Postgresql

* test that bools aren't compared like numbers and strings

* test @> conjunctions and special {}-query handling

* no changelog

CHANGELOG_BEGIN
CHANGELOG_END

* note on PASSING ... AS X

- suggested by @cocreature; thanks

* remove printlns; these functions don't really need scaffolding anymore

- suggested by @stefanobaghino-da; thanks
2021-04-12 17:49:19 +00:00
.github Daml case and logo (#8433) 2021-01-08 12:50:15 +00:00
.vscode Update .vscode/settings.json (#8425) 2021-01-07 14:32:33 +00:00
3rdparty Disable deriving-defaults per file (#8684) 2021-01-29 11:01:55 +00:00
bazel_tools Upgrade Scala 2.12 to v2.12.13. (#9280) 2021-03-30 11:02:18 +00:00
build-scripts Upgrade the LF library build setup (resolver, dependencies, version) (#8865) 2021-02-17 07:07:17 +01:00
ci Publish trigger service EE fat JARs (#9363) 2021-04-09 13:24:18 +02:00
compatibility update compat versions for 1.12.0-snapshot.20210406.6646.0.631db446 (#9332) 2021-04-07 08:50:55 +02:00
compiler daml package: bump timeout for tests (#9377) 2021-04-12 09:45:32 +00:00
daml-assistant daml build: add a --access-token-file for remote dependencies (#9358) 2021-04-08 23:20:52 +02:00
daml-lf Expose rounding modes as constructors + add BigNumeric docs. (#9336) 2021-04-07 14:58:31 +00:00
daml-script Add exception handling to Daml Script (#9324) 2021-04-07 18:48:24 +02:00
dev-env use coreutils date on macos (#9228) 2021-03-24 13:35:02 +01:00
docs link to postgres docs (#9353) 2021-04-09 09:28:58 +02:00
extractor Add new variant to Value.scala for builtin-exceptions. (#9084) 2021-03-16 13:15:33 +00:00
ghc-lib copyright updates (#8610) 2021-01-22 15:03:36 +00:00
infra Patch hoogle binary to include bugfix (#9366) 2021-04-09 14:17:03 +02:00
language-support daml build: add a --access-token-file for remote dependencies (#9358) 2021-04-08 23:20:52 +02:00
ledger Streaming contract state events (on the append-only schema) [DPP-304] (#9365) 2021-04-12 18:14:40 +02:00
ledger-api KVL-810 Report the correct gRPC error code on failures due to concurrent transactions (#9218) 2021-03-26 15:26:33 +01:00
ledger-service Oracle json-api: websockets and testing (#9278) 2021-04-12 17:49:19 +00:00
libs-haskell daml build: add a --access-token-file for remote dependencies (#9358) 2021-04-08 23:20:52 +02:00
libs-scala Add Oracle support in the trigger service (#9286) 2021-03-31 18:39:08 +02:00
navigator Make occurence occur less often (#9258) 2021-03-26 21:17:09 +01:00
nix Run Canton tests with JDK11 (#9355) 2021-04-08 10:42:40 +02:00
release LF: release LF 1.13 archive snapshot (#9348) 2021-04-07 19:12:42 +02:00
replacements update copyright notices for 2021 (#8257) 2021-01-01 19:49:51 +01:00
rules_daml Fix doctests (#9225) 2021-03-24 12:56:37 +01:00
runtime-components Publish non-repudiation-core to Artifactory as well (#9305) 2021-03-31 11:23:24 +00:00
scala-protoc-plugins Upgrade scalafmt and enable trailing commas (#8437) 2021-01-09 11:37:37 +01:00
templates Apply new logo to create-daml-app template (#9105) 2021-03-12 13:20:31 +01:00
triggers Expose Oracle support in the EE trigger service (#9342) 2021-04-08 14:50:47 +02:00
.bazelignore Remove redundant clean --expunge (#6890) 2020-07-28 09:49:36 +02:00
.bazelrc Upgrade to Bazel 4.0 (#8798) 2021-02-11 10:08:47 +01:00
.dadew Update VC redist to 14.28.29325.2 (#8431) 2021-01-07 16:31:25 +00: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 Commit compatibility/.bazelrc (#8955) 2021-02-25 19:53:30 +01:00
.hie-bios Update rules_haskell (#4751) 2020-03-13 16:49:34 +01:00
.hlint.yaml update copyright notices for 2021 (#8257) 2021-01-01 19:49:51 +01:00
.mergify.yml update mergify config for ci split (#8390) 2021-01-05 11:31:48 +01:00
.scalafmt.conf Pin scalafmt version in configuration file (#8447) 2021-01-11 10:05:58 +00:00
azure-cron.yml Clean broken entries from the Bazel cache (#8668) 2021-01-28 17:57:09 +00:00
azure-pipelines.yml fix release job (#9166) 2021-03-17 09:46:02 +00:00
BAZEL-bash.md add Bazel bash help (#2223) 2019-07-19 15:31:45 +00:00
bazel-haskell-deps.bzl pkgid data deps (#9153) 2021-03-18 12:17:38 +01:00
BAZEL-haskell.md Switch to GHC 8.10.3 (#8394) 2021-01-25 11:53:53 +00:00
bazel-java-deps.bzl Implement Prometheus metrics back-end (#9373) 2021-04-12 12:35:37 +00:00
BAZEL-JVM.md Daml case and logo (#8433) 2021-01-08 12:50:15 +00:00
BAZEL.md Enforce Java formatting style with google-java-format (#8686) 2021-01-29 16:50:18 +00:00
BUILD Add Oracle support in the trigger service (#9286) 2021-03-31 18:39:08 +02:00
build.ps1 Move artifact publishing out of yaml files (#9071) 2021-03-11 11:44:02 +01:00
build.sh Allow to clean up more than one process listening on a port (#9293) 2021-03-30 19:21:42 +00: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 Get codeowners for /ledger and /ledger-api in shape (#9266) 2021-03-29 15:45:34 +02:00
CONTRIBUTING.md Daml case and logo (#8433) 2021-01-08 12:50:15 +00:00
COPY update copyright notices for 2021 (#8257) 2021-01-01 19:49:51 +01:00
daml-logo.png Replace Daml logo on README (#8756) 2021-02-04 16:28:52 +01:00
deps.bzl cheat-sheet: update (#9079) 2021-03-11 12:01:16 +01:00
dotfiles open-sourcing daml 2019-04-04 09:33:38 +01:00
fmt.sh Commit compatibility/.bazelrc (#8955) 2021-02-25 19:53:30 +01:00
ghcide_snapshot_windows.json Switch to GHC 8.10.3 (#8394) 2021-01-25 11:53:53 +00:00
ghcide_snapshot.json Switch to GHC 8.10.3 (#8394) 2021-01-25 11:53:53 +00:00
ghcide-snapshot.yaml Switch to GHC 8.10.3 (#8394) 2021-01-25 11:53:53 +00:00
LATEST snapshot to test non-repudiation publish (#9326) 2021-04-06 14:12:52 +00:00
LICENSE copyright updates (#8610) 2021-01-22 15:03:36 +00:00
maven_install_2.12.json Implement Prometheus metrics back-end (#9373) 2021-04-12 12:35:37 +00:00
maven_install_2.13.json Implement Prometheus metrics back-end (#9373) 2021-04-12 12:35:37 +00:00
NOTICES update NOTICES file (#9300) 2021-03-31 13:24:54 +02:00
NOTICES.md cleanup oss-compliance & NOTICES.md (#8242) 2020-12-10 16:45:56 +01:00
package.json Upgrade elliptic dependency to address vulnerabilities (#9055) 2021-03-09 14:44:10 +01:00
Pipfile add blackduck scan to run on master (#6130) (#8161) 2020-12-07 19:59:39 +00:00
README.md Release EE SDK tarballs and installer (#9086) 2021-03-11 14:49:48 +01:00
release.sh Point out where the documentation for release.sh is (#8996) 2021-03-03 11:55:30 +00:00
SECURITY.md Daml case and logo (#8433) 2021-01-08 12:50:15 +00:00
stack-snapshot.yaml Add try-catch syntax. (#9203) 2021-03-25 13:36:09 +00:00
stackage_snapshot_windows.json Add try-catch syntax. (#9203) 2021-03-25 13:36:09 +00:00
stackage_snapshot.json Add try-catch syntax. (#9203) 2021-03-25 13:36:09 +00:00
tsconfig.json open-sourcing daml 2019-04-04 09:33:38 +01:00
unreleased.sh update copyright notices for 2021 (#8257) 2021-01-01 19:49:51 +01:00
Upgrading.md Upgrade rules_haskell and pin stack_snapshot (#6548) 2020-07-02 18:55:09 +02:00
WORKSPACE Update canton tests to pre 0.23.0 release (#9356) 2021-04-08 13:53:49 +02:00
workspace_status.sh update copyright notices for 2021 (#8257) 2021-01-01 19:49:51 +01:00
yarn.lock Upgrade elliptic dependency to address vulnerabilities (#9055) 2021-03-09 14:44:10 +01:00

Daml logo

Download License Build

Copyright (c) 2021 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 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 join us on the Daml forum. Alternatively, if you prefer asking on StackOverflow, please use 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 -sSfL 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-ce.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.

Shared memory segment issues

On macOS at least, it looks like our setup does not always properly close the resources PostgreSQL uses. After a number of test runs, you may encounter an error message along the lines of:

FATAL:  could not create shared memory segment: No space left on device
DETAIL:  Failed system call was shmget(key=5432001, size=56, 03600).
HINT:  This error does *not* mean that you have run out of disk space. It occurs either if all available shared memory IDs have been taken, in which case you need to raise the SHMMNI parameter in your kernel, or because the system's overall limit for shared memory has been reached.
        The PostgreSQL documentation contains more information about shared memory configuration.
child process exited with exit code 1

In this case, this is a memory leak, so increasing SHMNI (or SHMALL etc.) as suggested will only delay the issue. You can look at the existing shared memory segments on your system by running ipcs -mcopt; this will print a line per segment, indicating the process ID of the last process to connect to the segment as well as the last access time and the number of currently connected processes.

If you identify segments with no connected processes, and you are confident you can remove them, you can do so with ipcrm $sid, where $sid is the process ID displayed (as the second column) by ipcs. Not many macOS applications use shared memory segments; if you have verified that all the existing memory segments on your machine need to be deleted, e.g. because they have all been created by PostgreSQL instances that are no longer running, here is a Bash invocation you can use to remove all shared memory segments from your system.

This is a dangerous command. Make sure you understand what it does before running it.

for shmid in $(ipcs -m | sed 1,3d | awk '{print $2}' | sed '$d'); do ipcrm -m $shmid; done

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.