Skip to content

0.1.8-preview.1 — first public release

Pre-release
Pre-release

Choose a tag to compare

@monsieurleberre monsieurleberre released this 11 Jun 17:44
Immutable release. Only release title and notes can be modified.
2f2fcae

First public release of the Daml C# code generator: strongly-typed C# from Daml DARs, targeting the Canton JSON Ledger API.

What's included

Package Purpose
Daml.Codegen.CSharp the C# emitter library
Daml.Runtime runtime types referenced by generated code
Daml.Ledger.Abstractions transport-agnostic ILedgerClient submission/subscription interface
Daml.Codegen.Testing.Conformance compiled conformance corpus + embedded DAR for live-ledger round-trip tests

The four packages are versioned in lockstep. The codegen CLI itself ships separately as a multi-arch OCI component for dpm — oci://ghcr.io/peacefulstudio/dpm-codegen-cs (linux/amd64, linux/arm64, darwin/arm64, windows/amd64) — and the .nupkg files built by this release are available from the publish run's artifacts and on NuGet.org.

Versioning and stability

This project is pre-1.0: under SemVer 0.x, any release may change the public API without a major-version bump. The 0.1.00.1.7 sections in the changelog record internal development milestones whose packages were never published to a public feed — 0.1.8-preview.1 is the first release on NuGet.org.

Getting started

Add the codegen component to your daml.yaml (set DPM_AUTO_INSTALL=true so dpm fetches it on first use):

components:
  - oci://ghcr.io/peacefulstudio/dpm-codegen-cs:0.1.8-preview.1

Add the runtime package to your C# project:

dotnet add package Daml.Runtime --prerelease

Then generate from your DAR with dpm codegen-cs — the README Quick Start walks through the full DAR-to-NuGet pipeline, the CLI flags, and the MSBuild integration.

Full changelog

See the 0.1.8-preview.1 section of CHANGELOG.md for the complete record, including the API-freeze breaking changes relative to the internal milestones.