Skip to content

0.3.0

Choose a tag to compare

@vsima vsima released this 07 Aug 13:34
· 94 commits to main since this release

Full state sync and a better mobile transport. With this release the roadmap for the core SDK is complete: connect, authenticate, submit, stream, decode — with typed errors and value codecs — on both platforms.

New

ACS bootstrap

  • activeContracts(parties:activeAtOffset:) — the active contract set as typed ActiveContract values. Retryable failures restart the snapshot from scratch: results are never partial.
  • activeContractsSnapshot(parties:) — ledger end + ACS in one call. Apply the contracts, then follow updates(beginExclusive: snapshot.offset) for gap-free, duplicate-free deltas. Canton's canonical state-sync pattern as a two-call API.

Network.framework transport (Swift)

  • CantonClient now runs on HTTP2ClientTransport.TransportServices on Apple platforms — better cellular/Wi-Fi handoff and VPN behavior than raw POSIX sockets. No API changes; all live integration tests run over the new transport.

Scope decision

The SDKs are gRPC-only by design. A JSON Ledger API fallback is deliberately out of scope: HTTP/2-hostility is a browser-era problem that native transports don't share, and a second protocol would double the cross-platform parity surface. See the README for the evidence bar that would reopen this.

Install

implementation("io.github.vsima.canton:canton-sdk:0.3.0")
.package(url: "https://github.com/vsima/canton-mobile-sdk.git", from: "0.3.0")

Compatibility: Canton 3.5.11 protos (com.daml.ledger.api.v2). Expect breaking changes before 1.0.