Documentation

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/conformanceprobe/Conformance/Probe.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module Conformance.Probe where import Conformance.Kit template ProbeContract with owner : Party amount : Num

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/contractkeys/ContractKeys.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module ContractKeys where import KeyBuilders (ScheduleKey, ScheduleView(..), toScheduleKey) data AccountKey = Account

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/contractkeys/Disclosure.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module Disclosure where template Offer with issuer : Party price : Int where signatory issuer nonconsuming choice Inspe

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/contractkeys/KeyBuilders.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module KeyBuilders where data ScheduleView = ScheduleView with issuer : Party reference : Text deriving (Eq, Show) dat

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/crossmodulecollision/CollisionA.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module CollisionA where template Agreement with operator : Party where signatory operator choice Retag : Contra

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/crossmodulecollision/CollisionB.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module CollisionB where template Offer with owner : Party memo : Text where signatory owner choice Retag : Cont

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/defaulttarget/DefaultTarget.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 {-# LANGUAGE AllowAmbiguousTypes #-} module DefaultTarget where import DA.Date template Note with owner : Party bod

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/nonserializable/NonSerializable.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 {-# LANGUAGE RankNTypes #-} {-# LANGUAGE ConstraintKinds #-} module NonSerializable where type ShowEq a = (Show

nonserializable corpus Declares data Fn = Fn with f : Int -> Int — a non-serializable data type whose only field is a function arrow — beside the Ledger template that uses it in a choice body. Daml-LF keeps Fn as a data type with serializable = false; the JVM helper's SignatureErasure

Conformance corpus DAML models that define the type shapes codegen claims to support. Three corpora are shipped (compiled + embedded) in Daml.Codegen.Testing.Conformance: richtypes below, plus the contract-key and default-target corpora described further down. The committed .dar is the sourc

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/richtypes/RichTypes.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module RichTypes where import DA.Time () import DA.TextMap (TextMap) import qualified DA.TextMap as TextMap import DA.Map (

Daml contract source - peacefulstudio/canton-dotnet-sdk/conformance/richtypes/SubmitShapes.daml -- Copyright 2026 Peaceful Studio OÜ -- SPDX-License-Identifier: Apache-2.0 module SubmitShapes where template Ephemeral with owner : Party tag : Text where signatory owner template EphemeralFacto

Vendored Daml stable packages The .dalf files under lf-v2/ are the stable packages of the Daml SDK 3.7.1 (damlc component 3.7.0) (daml-prim and daml-stdlib), copied unmodified from ~/.dpm/cache/components/damlc/3.7.0/damlc-dist-dpm/resources/stable-packages/lf-v2/. They feed scripts/reg

Contributing to daml-codegen-csharp Thanks for your interest. This document covers everything you need to send a patch — from cloning the repo to getting your PR merged. Code of Conduct By participating in this project you agree to abide by the Code of Conduct. Getting

Architecture Overview This document describes how the Canton .NET SDK fits together: the code-generation pipeline that turns a Daml archive (.dar) into C# bindings, the Daml.Runtime library those bindings depend on, and the Canton.Ledger.* client packages that talk to a Canton participant no

Streaming Benchmarks This page covers the end-to-end benchmarks for the Canton.Ledger.* client packages. They measure submission latency, stream delivery latency and read throughput over the three transports: the gRPC Ledger API, the JSON Ledger API (REST) and the Participant Query Store (PQS).

Environment | | | | --- | --- | | Started (UTC) | 2026-09-24 12:21:18Z | | Commit | eb33befba4efa9e637e7339d604ca87005f7b2e7 | | Runner | local workstation: Apple Silicon laptop, LocalNet on Docker Desktop | | OS / arch / CPUs | macOS 27.0.0 / Arm64 / 12 | | .NET runtime | .NET 10.0.9 | | Clien

Building from source Prerequisites, build and test commands, and the repository layout, for contributors and anyone building the SDK locally. Back to the README. Prerequisites - .NET 10.0 SDK — the exact pinned version is i

CLI reference The dpm codegen-cs bundle, the emitter CLI and the standalone DAR-to-proto tool, with every flag. Back to the README. Two layers share one flag surface: - dpm codegen-cs — the OCI bundle. Takes a .dar, decodes it to an IntermediateDar proto with its bundl

Code generation What dpm codegen-cs emits from a Daml .dar, how to run it, what a generated template looks like, and how to assemble commands by hand. Back to the README. Features - Strongly-typed contracts: Generated record types for all Daml templates and data types

Configuration Reference How the Canton.Ledger.* clients are configured: the canonical configuration sections, every bindable option with its default, how authentication registration is resolved, where to hook PostConfigure, and how to register the health checks. All registration paths validate

Canton cross-version compatibility matrix The Canton ledger clients are exercised against more than one Canton release. The Cross-version matrix workflow (.github/workflows/cross-version-matrix.yaml) boots a LocalNet per Canton release and runs the live-ledger suites against it. It runs weekly

DAR to NuGet pipeline Turn a DAR, with its dependencies, into a NuGet package of generated C# bindings, then publish and consume it. Back to the README. The code generator supports creating NuGet packages from DAR files, including proper handling of dependencies. This enables yo

Intermediate DAR The Intermediate DAR is the protobuf message that sits between a Daml .dar archive and any downstream code generator: a JVM tool decodes a DAR into this format, and a consumer (today, this repository's C# emitter) reads the format instead of the DAR. If you are building your own

Ledger clients What the Canton.Ledger.* client libraries offer and how to use them: ledger and admin clients, PQS, generated types and authentication. Back to the README. Client Features Ledger Client (Canton.Ledger.Grpc.Client, Canton.Ledger.Rest.Client) - Create c

Observability The Canton Ledger API clients emit distributed tracing spans using the BCL's System.Diagnostics.Activity/ActivitySource types. The clients themselves take no OpenTelemetry package reference — wiring an exporter is entirely opt-in. Activity sources Five well-known ActivitySour

Proposal Appendix A, as shipped The 2026-03 grant proposal's Appendix A illustrated the developer experience this SDK would deliver, ahead of any of it existing. Some of it un

Talking to the Ledger API directly How the runtime types map onto the JSON and gRPC Ledger API wire formats when you skip the high-level clients. Back to the README. The highest-level path is the generated extension methods (IouSubmissionExtensions.TryCreateAsync, IouExtensio

API reference Public types of every packaged assembly, grouped by namespace. Start from the articles if you are new. Generated Ledger API wire types are not listed; see Wire-level types.

Getting started The SDK takes a Daml .dar archive to strongly-typed C# bindings, then submits them to a Canton ledger. This page is the short route; each step links to the full text. 1. Install the tools You need the .NET SDK 10.0.100 or later, a JDK 17 or later (for dpm codegen-cs), and dp