Skip to content

Releases

0.4.0-alpha.3 — Atomic exercise receipts

Choose a tag to compare

@kunal171 kunal171 released this 21 Nov 17:26
3ab2715

Changes

  • Add opt-in schema041 exercise receipts through exercise_source: "pqs041_ledger_effects".
  • Commit complete selected transactions atomically with contract/model effects, private receipt outbox and checkpoints. Limit: 64 combined records and 1 MiB.
  • Preserve exercise witnesses separately from controllers and stakeholders. Archives remain the sole lifecycle owner.
  • Add a commented Daml fixture, four-scope PQS/Ledger Effects comparison and real LocalNet worker checks.

Upgrade

Run cantongrid storage init --database-env CANTONGRID_DESTINATION_URL to apply migration 009. Migrations 001–008 are unchanged. Old binaries reject 009; rollback requires a pre-upgrade backup and the previous binary.

Tree mode requires a separately prepared source and new explicit generation. Default create/archive polling and public APIs retain their behavior. Coordinate all ten crates at this version.

Verification

98 workspace tests, 60 PostgreSQL storage tests, 3 API privacy/revocation/outage tests, 5 other database controls, 2 source/visibility controls and 42 Python checks pass. All ten package dry runs and archive inspections pass. Registry checksums, READMEs and source commit match the merged release; CLI installation, help and project initialization succeed outside the checkout with Rust 1.100.0.

The authorized LocalNet worker recorded four exercise receipts/outbox entries, three consuming exercises, two unindexed targets and one lifecycle archive. An idle restart added no receipts. Source failure/lease/model rollback controls include synthetic authority where documented.

Limits

No public exercise/lineage API, general immediate-parent proof, interface-choice support, receipt-stream package handoff, redaction/history completeness or remote production acceptance.

PR #28 · Rollout · Verification

0.4.0-alpha.2 — DAR metadata, compound sorting, upgrades, remote HTTPS and schema sync

Choose a tag to compare

@kunal171 kunal171 released this 21 Nov 09:59
bd8d0f1

Changes

  • Offline DAR Metadata Inspection (#23):
    • Extract versioned LF 2.1 contract metadata with verified payload hashes and qualified signatures without Ledger, JVM, or database dependencies.
    • New cantongrid-metadata crate and cantongrid metadata inspect <artifact.dar> CLI command.
  • Compound Model Sorting (#21):
    • Support compound row sorting in model definitions, SQL projections, and REST/GraphQL orderBy with exact tuple pagination for price-time priority order books.
  • Reviewed Additive Package Upgrades (#25):
    • Add reviewed additive package upgrades with private durable snapshot staging, gated publication/cancellation, immutable source checkpoints, and model rollback.
    • Destination migrations 007–008.
  • Verified Remote HTTPS Transport Policy (#22):
    • Support explicit remote HTTPS Ledger and PQS health endpoints with Rustls certificate verification, redirect refusal, connection timeouts, and identity-provider/issuer checking.
  • Command-Driven Schema Synchronization (#24):
    • New cantongrid-sync crate for deterministic comparison of verified DAR signatures against explicit model projections.
    • Generates full review bundles: models, SQL DDL, GraphQL, TypeScript, and upgrade manifests.
    • New CLI commands: cantongrid sync plan and cantongrid sync bundle.

Compatibility and limits

  • Existing destinations require explicit storage init for migrations 007–008 before using this release.
  • Older row cursors must be restarted across package handoffs.
  • Staged publication temporarily gates reads and ingestion for the affected stream during activation.
  • This is a source prerelease targeting 0.4.0-alpha.2; crates.io publication is an explicit operator action.

Validation

  • All workspace Rust tests pass (cargo test --workspace --locked).
  • All Python test suites pass (python3 -m unittest discover -s scripts/tests and examples/poc).
  • Clippy, rustfmt, security scans, and release metadata checks pass.

PR #26 · PR #27 · Closes #21, #22, #23, #24, #25.

0.4.0-alpha.1 — Declarative grouped aggregates

Choose a tag to compare

@kunal171 kunal171 released this 20 Nov 15:26
1f1e64b

Changes

  • Declare grouped counts and exact sums in model definitions.
  • Generate SQL plans, REST/GraphQL queries and TypeScript interfaces.
  • Keep totals consistent with creates, archives, replay, rollback and model revisions.
  • Add Outcomia/Visibility examples and a read-only LocalNet aggregate check.

Access and compatibility

Aggregate callers must cover the complete configured source-party scope. Totals are calculated on reads over maintained contribution rows. Existing row queries retain their scopes.

Existing declarations keep their fingerprints; migrations 001–006 are unchanged. Upgrade every worker/API before activating aggregate declarations. Model GraphQL resolver failures now clear the complete operation's data.

This is a source prerelease. Build tag v0.4.0-alpha.1; crates.io remains at 0.3.0.

Validation

67 Rust tests, 62 PostgreSQL/API checks and 30 Python controls passed. Strict generated TypeScript compilation, Clippy, security checks and packaging dry runs passed for all eight crates.

LocalNet totals matched an independent Ledger snapshot of seven existing PoC contracts in two groups. The check sent no ledger transactions and restored the original model revision. Outcomia aggregate checks used owned PostgreSQL fixtures.

Limits

No partial-scope aggregates, joins, independently maintained totals cache or public streams. Remote/devnet and production acceptance remain unverified.

Aggregate guide · Verification · PR #19

Crates.io

All eight crates are published at 0.4.0-alpha.1, with rendered READMEs and release-commit provenance verified. Registry CLI installation and fixture/aggregate generation checks passed.

cargo install cantongrid-cli --version 0.4.0-alpha.1 --locked

CLI package. Stable 0.3.0 remains available; this is a prerelease.

CantonGrid 0.3.0

Choose a tag to compare

@kunal171 kunal171 released this 20 Nov 07:24
0b600b0

Changes

  • Verified LocalNet contracts ingestion, generated models and authenticated REST/GraphQL as the regular 0.3.0 release.
  • Pinned PQS/destination fixtures to PostgreSQL 17.12 in new volumes.
  • Added reproducible 261-contract staged rebuild acceptance: fresh-process resume, actual source revocation, concurrent events, stale-activation rejection, promotion and rollback.
  • Updated package READMEs, installation docs and sanitized acceptance records.

Install

cargo install cantongrid-cli --version 0.3.0 --locked

Compatibility

Runtime APIs and migrations 001–006 are unchanged from alpha.5. Existing PostgreSQL 14 fixture volumes require an explicit logical restore into the new 17.x volumes. Original volumes are retained; up does not migrate them. Read the upgrade guide.

Validation

  • Logical restores matched 983 application-table row counts/hashes across three databases.
  • 64 credential-free Rust, 57 database/mock-runtime and 29 Python controls passed.
  • Standalone PoC, large real-ledger rebuild and Outcomia acceptance passed on PostgreSQL 17.12.
  • Strict TypeScript, security scans, workspace publication dry run and source archive checks passed.
  • PR #18 passed CI and merged with the focused commits preserved.

Scope

This release covers the verified loopback LocalNet contracts profile with snapshot-forward partial history. Funded trading, joins/aggregates, streams, remote/TLS and production acceptance remain outside its scope.

Developer guide

CantonGrid 0.3.0-alpha.5

Pre-release

Choose a tag to compare

@kunal171 kunal171 released this 19 Nov 17:12
33565c2

Changes

  • Resumable model rebuilds: bounded backfill, transactional change reconciliation, explicit activation, cancellation and old-row cleanup.
  • models rebuild start|step|status|activate|cancel commands. The current model keeps serving; staged rows remain private.
  • Stronger database ACL checks, HTTP admission/cancellation limits and final authorization checks. Complete responses are capped at 2 MiB; canonical payloads are encoded after pagination.
  • Consolidated developer docs and comments covering the PoC, authorization, exact values and recovery.

Upgrade

Initialize the owned destination explicitly:

cantongrid storage init --database-env CANTONGRID_DESTINATION_URL

This applies migration 006. Migrations 001–005 are unchanged; older binaries reject the new schema. No new external runtime dependency.

Atomic binding retains its 128-row cap. Staged steps handle 1–64 rows (default 32), with an 8 MiB evaluation budget. Promotion invalidates old model cursors.

Validation

64 credential-free Rust tests, 57 owned-PostgreSQL/mock-source HTTP checks and 27 Python tests passed. Formatting, Clippy, Rust documentation, security scans and eight-crate packaging checks passed. See PR #16 for CI and verification for the tested scope.

The optimized CLI build and fixture/model smoke checks passed. Merged-main Rust/PostgreSQL and security CI passed.

Limits

Large staged LocalNet acceptance and a supported PostgreSQL upgrade remain pending. No funded trading or production acceptance is claimed. This is a source prerelease; crate uploads and prebuilt binaries are separate.

Install from crates.io

All eight packages are published with per-crate READMEs. Install the CLI:

cargo install cantongrid-cli --version 0.3.0-alpha.5 --locked

Registry installation and fixture replay outside the checkout passed. Package documentation and publication checks are merged.

Developer guide

CantonGrid 0.3.0-alpha.4 — exact model queries and Outcomia acceptance

Choose a tag to compare

@kunal171 kunal171 released this 19 Nov 12:05
0c17e26

Changes

  • Add eq/ne, numeric ranges and optional-field null predicates, with exact string arguments and at most eight ANDed predicates.
  • Sort one output field with native PostgreSQL types, nulls last and contract-ID tie breaking.
  • Bind pagination to normalized filters, sorting, model revision, namespace, principal and source/caller authorization.
  • Discover models at GET /v1/models or GET /v1/models/{namespace}/{name}; query at POST /v1/models/{namespace}/{name}/query or /models/graphql.
  • Generate GraphQL filter/sort inputs and TypeScript query interfaces from model declarations.
  • Extend the LocalNet PoC and actual Outcomia runner with privacy, revision, recovery and exact-value controls.
  • Include the source-only crate packaging checks introduced after alpha.2.

Examples: API, PoC, Outcomia.

Verification

Two standalone LocalNet runs passed 54 model page sequences each. The expanded
Outcomia run passed 60 sequences, matched 25 submitted create/archive identities
and seven active records, and verified caller revocation plus optional-field
promotion/rollback. Exporter outage/recovery was verified in the standalone PoC.
Generated TypeScript compiled. Nineteen development-helper and four PoC helper
tests pass. The PR's CI covers Rust, owned PostgreSQL, source packaging and security.
See recorded verification for tested commits and scope.

Compatibility and limits

Restart alpha.2 model pagination: older model cursors are invalid. Exact financial
values remain strings. No destination migration, automatic indexes or new external
runtime dependency is added. Initialize destinations explicitly through migration 005.

This is a GitHub source prerelease. Only the alpha.3 core crate has been published
on crates.io; the CLI must be built from source. No binaries or new crate uploads
are included. The tested profile is Canton 3.5.7, Scribe 3.5.4/schema041 and owned
PostgreSQL 14.25 on disposable LocalNet, with snapshot-forward partial history.
Staged large backfills, joins/aggregates, durable streams, funded trading projection
acceptance and remote/devnet/production verification remain pending. Phase 4 is
still in progress.

Implementation: #14

CantonGrid 0.3.0-alpha.2 — runnable LocalNet PoC

Choose a tag to compare

@kunal171 kunal171 released this 18 Nov 18:07
53a016e

CantonGrid 0.3.0-alpha.2

Source prerelease.
This release adds a runnable Daml LocalNet PoC and generated model queries/client types.

Changes

  • Generate TypeScript transport interfaces and GraphQL SDL from reviewed model declarations.
  • Serve authenticated typed model queries at /models/graphql, with canonical visibility before counts/pages and revision-scoped cursors.
  • Add the standalone Draft/Open/Resolved Daml contract, DAR deployment/transaction runner, local viewer and sanitized evidence under examples/poc.
  • Document repeat runs, exact values, privacy, revocation and indexer recovery.

Follow the PoC guide. The maintained example is on
main; check out
v0.3.0-alpha.2 to reproduce this release.

Verification

57 credential-free Rust tests, 45 owned-PostgreSQL checks and 15 Python tests
passed. Formatting, Clippy, security and release checks passed. Two complete
LocalNet runs matched seven initial and thirteen accumulated event identities,
including party privacy, exact values, cursor isolation, caller revocation,
offline catch-up and restart without duplicates. Generated TypeScript compiled;
Chromium rendered the local viewer. PR #11 and its merge commit passed CI.
See verification and the
sanitized artifact.
The artifact retains its original prerelease test metadata.

Compatibility

No new destination migration or external runtime dependency since 0.3.0-alpha.1.
Fresh/older destinations still need explicit storage init through migration 005.
Existing /graphql continues to serve generic contracts/history; generated model
queries use /models/graphql. Financial Int64/Numeric values remain strings in
GraphQL/TypeScript. Document formats remain version 1. No schema/API changes are
introduced by this release-notes update.

Limits

The tested profile is loopback-only Canton 3.5.7 with Scribe 3.5.4/schema041.
Types are generated from model declarations, not arbitrary DAR schemas. The
viewer uses local fixture identities; the contract has no custody or trading.
History is snapshot-forward partial. Model queries support at most 25 rows/page,
two model resolvers/operation and a 2 MiB response. Existing backfill/work limits
remain. Advanced model filtering, staged rebuilds, durable streams, remote/TLS,
devnet and production acceptance remain later work. This is a source prerelease;
prebuilt binaries and Cargo publication are not included.

CantonGrid 0.3.0-alpha.1 — declarative model projections

Choose a tag to compare

@kunal171 kunal171 released this 18 Nov 15:43
3e994a9

CantonGrid 0.3.0-alpha.1

Source prerelease.
This alpha delivers the model storage/lifecycle subset of Phase 4.

Changes

  • Declarative typed fields, filters and checked exact arithmetic; offline validation, preview and SQL planning.
  • Immutable model registry and guarded installation of private PostgreSQL tables.
  • models bind with current source checks, bounded atomic backfill, expected-revision promotion and rollback.
  • Live creation/archive projections in the canonical history/outbox/checkpoint transaction.
  • Outcomia and unrelated Visibility examples; developer guide and pinned Rust toolchain.

Compatibility

Run cantongrid storage init --database-env CANTONGRID_DESTINATION_URL before
opening an older destination. This release adds migrations 003–005; applied
migrations 001–002 are unchanged. Migration 005 also leaves 003–004 unchanged.
Older binaries reject unknown migration sets; downgrade needs a reviewed plan.
Fixture/runtime/model document formats remain version 1. Model bindings leave
source plan/checkpoint identity unchanged. No new runtime dependencies were added
for live model projections.

Verification

56 credential-free Rust tests, 44 owned-PostgreSQL checks and 13 Python helper
tests passed, along with formatting, Clippy, security and release checks.
Projection tests use synthetic source authority, not live Canton. The earlier
0.2 LocalNet ingestion/API acceptance remains separate evidence. Three
source-dependent tests were not rerun for this release. See verification.

Limits

Atomic backfill/cleanup is capped at 128 rows, with an 8 MiB work budget and at
most 16 bindings per stream. Larger staged rebuilds, generated model queries,
revision-bound model cursors and actual LocalNet model lifecycle acceptance are
still pending. Snapshot-forward coverage does not recover pre-snapshot history.
Durable streams, remote/TLS, devnet and production acceptance remain outside this
release. Binary packaging and Cargo publication are not included.

Developer guide: https://shady-3.gitbook.io/cantongrid/

CantonGrid 0.2.0-alpha.1 — LocalNet contracts runtime

Choose a tag to compare

@kunal171 kunal171 released this 17 Nov 17:04
9e4f338

Changes

  • Read-only PQS snapshot/update ingestion with current source grants and same-offset paging.
  • Atomic owned PostgreSQL lifecycle state, history, checkpoints and outbox; checksummed migration 002.
  • Authenticated REST/GraphQL, independent caller grants, scoped cursors and coverage/freshness metadata.
  • Actual Outcomia and unrelated Visibility examples through the same Rust engine.
  • Bounded development logs, security CI, contributor and runtime documentation.

Verification

61 Rust tests and 13 Python tests passed locally, including all environment-dependent tests. Formatting, Clippy, RustSec, dependency policy, secret scanning, actionlint and release checks passed.

LocalNet checks verified all eight controlled Outcomia lifecycle identities across a paged snapshot and worker restarts. Visibility verified A/B/AB isolation, exact values, pagination, local revocation and source outage/recovery. GitHub PR checks passed before merging.

Upgrade and scope

Run explicit destination initialization to apply migration 002. Fixture and runtime formats remain version 1. Source/selection changes require a reviewed new generation.

Supported profile: loopback LocalNet, exact template projections, raw JSON and snapshot-forward partial history. Generated models, streams, remote/TLS, devnet and production certification remain outside this release. Source prerelease only; Cargo publication is disabled.

Runtime guide · Acceptance evidence · PR #5

Merged commit: 9e4f338. Post-merge tests and security checks passed.

CantonGrid 0.1.0-alpha.1 — reference ingestion

Choose a tag to compare

@kunal171 kunal171 released this 17 Nov 16:59
5d19acc

CantonGrid 0.1.0-alpha.1

Status: source prerelease candidate. This release covers reference ingestion,
query foundations and developer/security tooling. It does not complete the live
Phase 3 pipeline or claim production readiness.

Included

  • Strict Rust project configuration, exact tagged values and deterministic lifecycle fixtures.
  • Owned local PostgreSQL state/history/checkpoint/outbox transactions, recovery and writer exclusion.
  • Durable fixture index/status/query workflows and explicit destination initialization.
  • Shared SQL reads that apply caller/source visibility before totals and keyset pages,
    with source-lease rechecks and conjunctive lifecycle dependencies.
  • Read-only PQS schema-041 inspection, machine-readable uncertainty/pruning reasons
    and retained-window consistency verification.
  • Nodejumper SDK v0.3.2 row compatibility evaluated against installed Scribe 3.5.4;
    no SDK runtime dependency adopted.
  • Pinned security CI: RustSec, dependency license/source policy, full-history and
    eligible-tree secret scanning with redaction, and GitHub Actions linting.
  • Contributor guide, PR template, security-reporting guidance, version/notice/license
    consistency checks, Apache-2.0 license and workspace prerelease versioning.

Verification

Local checks: 49 Rust tests (including owned-Postgres and existing LocalNet source
checks), 11 Python tests, formatting, Clippy, YAML/link checks and security tooling.
Remote CI results are recorded on the release PR; source-dependent LocalNet checks
are explicitly separate from credential-free CI.

The retained source interval 80→943 reconciled 11 baseline rows + 115 creates −
116 archives = 10 active rows, with zero missing/unexpected identities. This is
historical retained-window evidence, not a controlled concurrent handoff proof.
The SDK probe decoded 3 create/3 archive rows and 11 historical active rows, with
no payload/party output or ledger writes.

Limits and compatibility

  • Real source-grant verification, caller token authentication, REST/GraphQL and the
    live indexing worker remain incomplete. Fixture grants are simulated.
  • The schema-041 archive interface omits witnesses. Archive authorization/current
    grants, dynamic metadata, handoff/pagination and retention remain live gates.
  • Raw backend page keys are not public API cursors; transport-level scope/integrity
    protection is required before exposure.
  • Reference ingestion retains its explicit 256-batch/16-MiB journal, 1000-event/
    1-MiB batch limits and loopback-only database transport.
  • Existing project format version 1 and destination migration 001 remain unchanged.
    Rust workspace version is independent of configuration/schema versions.
  • Outcomia has synthetic and artifact-validation evidence, not actual live Rust
    indexing proof. Additional tracks, generated business models and SSE stay deferred.
  • Source distribution only; binary packaging and third-party notice bundling require
    a separate reviewed release workflow. Cargo packages remain non-publishable.