causalontology 2.0.0

causalontology-csharp

The C# binding of the Causalontology standard — a faithful port of causalontology-py, sharing the same conformance suite.

Zero runtime dependencies. The .NET base class library carries SHA-256 and SHA-512 (System.Security.Cryptography); Ed25519 is not in the BCL, so it is hand-ported from the Python binding onto System.Numerics.BigInteger and gated on the RFC 8032 TEST 1 known answer before any vector runs. Requires the .NET 8 SDK or newer.

Conformance

$ dotnet run --project bindings/csharp/conformance
...
107/107 vectors passed
causalontology-csharp is CONFORMANT to the suite (vectors frozen at specification 2.0.0).

The runner locates the repository root from the CAUSALONTOLOGY_ROOT environment variable when set, otherwise by walking up from the working directory until it finds conformance/vectors; the schemas are read from spec/schema under the same root (overridable with CAUSALONTOLOGY_SPEC).

The vectors are frozen at specification 2.0.0 (2026-07-13): they carry concrete identifiers, real keys, and a real verifying signature. The harness's old normalization now simply passes frozen values through.

Thirty-second taste

using Causalontology;

var store = new InMemoryStore();
var press = store.Put(new JsonMap {
    { "type", "occurrent" }, { "label", "press_button" }, { "category", "action" } });
var light = store.Put(new JsonMap {
    { "type", "occurrent" }, { "label", "light_on" }, { "category", "state_change" } });
var claim = store.Put(new JsonMap {
    { "type", "causal_relation_object" },
    { "causes", new List<object?> { press } },
    { "effects", new List<object?> { light } } });

Console.WriteLine(claim);
Console.WriteLine(store.Gaps("missing_field").Count); // the degenerate claim is a visible invitation

Status

Source complete and ported line-for-line from the Python binding; verified locally with the .NET 8 SDK — dotnet run --project bindings/csharp/conformance prints 107/107 vectors passed — and built and executed by GitHub Actions CI as well, as it is for every binding.

License: "The attribution always; no profit, no problem license." — see the repository LICENSE and NOTICE.