Skip to content

0.6.0

Choose a tag to compare

@vsima vsima released this 15 Aug 02:58
· 20 commits to main since this release
v0.6.0
0c7727b

The CIP-0103 dApp connectivity layer lands: a wallet on the native SDK can take connections from dApps and sign their transactions, and a dApp can drive a wallet — plus TLS trust pinning, expiry-aware token handling, an encrypted Android wallet store, and the fee/traffic/history read work merged since v0.5.0.

New — dApp connectivity (CIP-0103)

Four Kotlin artifacts and four Swift products, sitting beside the wallet stack so an app that only talks to a wallet never links the ledger stubs or signing drivers:

  • canton-dapp / CantonDappKit — dApp side: protocol types, JSON-RPC codec, DappClient, the transport seam.
  • canton-dapp-wallet / CantonDappWalletKit — wallet side: DappSession, per-peer account grants, the approval delegate, the prepare → verify → sign → execute pipeline, a ledgerApi read proxy (allowlist policy), and signMessage with domain separation.
  • canton-dapp-lan / CantonDappLanKit — LAN gRPC transport: one CIP-0103 session across a real socket, no relay.
  • canton-dapp-wc / CantonDappWCKit — WalletConnect transport adapter, speaking the ecosystem's canton_ methods; the reference wallets drive it over a live relay (Android on-device, iOS on the simulator).

Both platforms are held to golden vectors from OpenRPC 0.5.0 and live-verified end-to-end on LocalNet. readAs is validated against the peer's grant like actAs, and the approval-request docs describe the actual flow.

Transport security

  • Pluggable TLS trust — pin the Ledger API to an operator's CA, on both platforms.

Auth & token handling

  • Async token provider, expiry-aware caching with a refresh leeway, and stream auth recovery.

Android

  • Encrypted wallet store on Jetpack DataStore (AES-GCM under an Android Keystore key), emulator- and device-verified. Minimum is API 26.

Reads, fees & economics (both SDKs)

  • Transfer-fee preview and synchronizer traffic purchase.
  • ValidatorClient (the LocalNet tap harness promoted to a public client).
  • Scan holdings summaries; transfer-level semantics in holdings history.
  • Hardening: reject duplicate node ids in prepared-transaction hashing; gate stream retry-budget resets on a healthy-connection window.

Dev tooling

  • LocalNet faucet tool; public init for AllocatedExternalParty (restore a persisted identity).

Compatibility

Canton 3.5.11–3.5.12 · Ledger API com.daml.ledger.api.v2.

Artifacts

Maven Central (group io.github.vsima.canton): canton-ledger-api, canton-sdk, canton-wallet-sdk, canton-wallet-android, canton-dapp, canton-dapp-wallet, canton-dapp-lan, canton-dapp-wc.

Swift (SPM, one package canton-mobile-sdk): CantonLedgerAPI, CantonKit, CantonWalletKit, CantonDappKit, CantonDappWalletKit, CantonDappLanKit, CantonDappWCKit.