Daml Python bindings (formerly known as dazl)

Rich Python bindings for accessing Canton 2.x Ledger API-based applications. It is not intended for use with Canton 3.x.

Documentation

The user documentation is available online here.

Installation

If you just want to use the library, you can install it locally with pip:

pip install --user dazl

Requirements

Python 3.10+
Go 1.23
Daml SDK
- Daml 2: 2.10 or later

Examples

All of the examples below assume you imported dazl, and are running a ledger with the default scenario generated with daml new.

Connect to the ledger and submit a single command:

import asyncio
import dazl

async def main():
    async with dazl.connect(url='http://localhost:6865', act_as='Alice') as client:
        contract = { 'issuer' : 'Alice', 'owner' : 'Alice', 'name' : 'hello world!' }
        await client.create('Main:Asset', contract)

asyncio.run(main())

Connect to the ledger as a single party, print all contracts, and close:

import asyncio
import dazl
from dazl.ledgerutil import ACS

async def main():
    async with dazl.connect(url='http://localhost:6865', read_as='Alice') as conn:
        async with ACS(conn, {"*": {}}) as acs:
            snapshot = await acs.read()

    print(snapshot)

asyncio.run(main())

Building locally

You will need additional dependencies to build locally:

Direnv (https://direnv.net/)
Nix (https://nixos.org/download/)

Once you have these prerequisites in place:

make build

Tests

Tests in the Daml Python bindings are written using pytest. You can run them by doing:

make test

Support

The Daml Python bindings library are supported under the Daml Enterprise license. If you do not have a Daml Enterprise license and are in need of support, have questions or just want to engage in friendly conversation anything Daml, contact us on our Daml Community Forum.

Release files for dazl 8.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dazl 8.9.0
File	Size	Uploaded
dazl-8.9.0.tar.gz	743.8 kB	Feb 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dazl 8.9.0
File	Interpreter	ABI	Platform	Reset
dazl-8.9.0-py3-none-any.whl 1.5 MB Feb 5, 2026	Python 3	none	any	Details

Total release size: 2.3 MB

Release files / dazl-8.9.0.tar.gz

Download URL	dazl-8.9.0.tar.gz
Size	743.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`723ecdc80fdc74dac27109e95a6db79a6fe6a82883b95eef7160da65b05b28a7`
BLAKE2b-256 checksum How to use checksums	`8379af8df1b2f544aed3dc2dbe274c57a184e1b90b2f615bc25933dc61f62876`
Upload date	Feb 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.13.11 Darwin/25.2.0`

Release files / dazl-8.9.0-py3-none-any.whl

Download URL	dazl-8.9.0-py3-none-any.whl
Size	1.5 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`6695f06d0b5eddc829ced0fea195fe39419378479e8d9d41d50a2f745313367f`
BLAKE2b-256 checksum How to use checksums	`e278102436c7fcb078be23cc0e7ae7543301b33b2d6e31b73c06f607c7d0b0e0`
Upload date	Feb 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.13.11 Darwin/25.2.0`