HexaEight.Bridge 1.0.0-preview9

HexaEight.Bridge

Universal integration layer for HexaEight cryptographic identity and Dead Drop Encryption. One small .NET assembly that lets any language (Node.js, Python, .NET native — Go, Rust coming) consume the HexaEight platform with the same API surface.

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

Install

dotnet add package HexaEight.Bridge --prerelease

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

Five-line example

using HexaEight.Bridge;

var client = new Client();
string envelope = await client.EncryptEnvelopeAsync("alice.example.com", "Hello Alice!");
var msg = await client.DecryptEnvelopeAsync(envelope);
Console.WriteLine($"{msg.From}: {msg.Body}");

No key exchange. No PKI. No prior provisioning of the recipient. Just send.

API cheat sheet

For the full reference — parameters, return types, error semantics, performance numbers, wire format spec, and conceptual guides — see hexaeight.com/docs/reference/bridge.

Wire format

Envelope strings come in two variants:

Standard:    {sourceId}|{kgt}|{ciphertext}
Sessioned:   hsha:{sha256(sessionId)}|{ciphertext}

Full spec at hexaeight.com/docs/reference/wire-format.

Identity load order

The Bridge looks for credentials in this order, stopping at the first hit:

1. Azure mode — hexaeightkeys.db (SQLite) in the current working directory.
2. Environment variable — HEXAEIGHT_MACHINETOKEN.
3. Env-file — env-file in the current working directory with a HEXAEIGHT_MACHINETOKEN=… line.

The Bridge is read-only with respect to your environment — it never sets environment variables.

Cross-language use

The same Client class is reachable from:

• Node.js via node-api-dotnet under dotnet.HexaEight.Bridge.Client — packaged as @hexaeight/sdk.
• Python via pythonnet in the HexaEight.Bridge namespace — packaged as hexaeight-sdk (in progress).

Method names, parameters, and return shapes are identical across languages. Each SDK exposes the surface in idiomatic style (camelCase for JS/TS, snake_case for Python).

For AI agents

A flat-text mirror of the full API reference is at hexaeight.com/llms-full.txt. The site-wide index follows the llms.txt convention at hexaeight.com/llms.txt.

Links

• Documentation — https://hexaeight.com/docs
• API Reference — https://hexaeight.com/docs/reference/bridge
• Quickstart — https://hexaeight.com/docs/quickstart
• Wire format spec — https://hexaeight.com/docs/reference/wire-format
• Pricing & licensing — https://hexaeight.com/pricing
• Status — https://status.hexaeight.com
• Support — support@hexaeight.com

License

Apache License 2.0. The Bridge is open-source plumbing; the underlying HexaEight cipher implementation (Dead Drop Encryption) is delivered as closed-source NuGet packages (HexaEightASKClientLibrary, HexaEightJWTLibrary) and is patent-pending.