HexaEight.Bridge 1.0.0-preview6

HexaEight.Bridge

The universal integration layer for HexaEight identity and Dead Drop Encryption (DDE) — one small .NET assembly that lets any language (Node.js, Python, native .NET, and soon Go and Rust via CoreCLR hosting) consume the HexaEight platform with the same API surface.

What it does

HexaEight's cryptographic libraries (HexaEightASKClientLibrary, HexaEightJWTLibrary) are .NET libraries. To call them from Node.js, Python, or any other runtime, you'd normally have to wrap each method, manage the .NET hosting plumbing, and reason about runtime quirks that differ between hosts.

HexaEight.Bridge solves that once. Every HexaEight operation — fetching shared keys, encrypting / decrypting messages, creating and validating encrypted JWT tokens, multi-party encryption — is exposed as a single async, Task-returning method on a Client class. Language hosts that project .NET tasks to their native async type (Node.js maps Task<T> to Promise, Python's pythonnet maps it to an awaitable) get a clean, idiomatic call in their own language with no glue code.

The Bridge is the layer every HexaEight SDK is built on top of.

Installation

dotnet add package HexaEight.Bridge --prerelease

The package multi-targets net8.0, net9.0, net10.0. NuGet picks the right one for your host.

Usage

using HexaEight.Bridge;

var client = new Client();
long kgt = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1)).TotalMinutes;
kgt -= kgt % 15;
string key = await client.FetchSharedKeyDirectAsync("agent01.example.com", kgt);

The same Client class is reachable from Node.js (via node-api-dotnet under dotnet.HexaEight.Bridge.Client) and from Python (via pythonnet in the HexaEight.Bridge namespace). Method names, parameters, and return shapes are identical across languages.

For higher-level developer ergonomics (per-language packaging, ASK caching, transport helpers, CLI activation), consume the language-specific SDK that wraps this package:

• Node.js: @hexaeight/sdk
• Python: hexaeight-sdk (forthcoming)

License

Apache License 2.0. The Bridge is open-source plumbing; the underlying HexaEight cipher implementation (DDE) is delivered as closed-source NuGet packages and is patent-pending.