NostrNet.Marmot.Mls.Native 0.1.0-preview8

<p align="center"> <img src="https://raw.githubusercontent.com/Galaxoid-Labs/NostrNet/main/logo.png" alt="NostrNet" width="320" /> </p>

NostrNet.Marmot.Mls.Native

OpenMLS-backed IMarmotMlsProvider implementation for NostrNet.Marmot. Wire bytes are RFC 9420 compliant by construction — the package wraps OpenMLS (Rust) via an in-tree FFI bridge.

Install

dotnet add package NostrNet.Marmot.Mls.Native --prerelease

--prerelease is required while the current releases are tagged -previewN; drop it once a stable v0.1.0 ships.

The package ships pre-built native binaries for the supported runtime identifiers. No Rust toolchain required at consume time.

Supported RIDs:

• linux-x64, linux-arm64
• osx-x64, osx-arm64
• win-x64, win-arm64

(Mobile RIDs ios-arm64 / android-arm64 aren't shipped yet — iOS needs static linking + .NET workload integration; Android needs NDK packaging. Tracking separately.)

Quickstart

using NostrNet.Marmot;
using NostrNet.Marmot.Mls.Native;

// In-memory state (lost on dispose):
using var provider = new OpenMlsProvider();

// — or — persisted across process restarts:
//   using var provider = OpenMlsProvider.OpenAtPath("/var/app/marmot.sqlite");

// Use the MarmotChat helpers exactly as documented in NostrNet.Marmot:
var ev = await MarmotChat.BuildKeyPackageEventAsync(provider, myKey, "default", relays);
// ... StartConversationAsync, StartGroupAsync, AddPeerAsync, RemovePeerAsync,
//     RotateKeysAsync, EncryptMessageAsync, TryDecryptMessageAsync, ...

See NostrNet.Marmot's README for the full API walkthrough including group operations.

What's inside the box

Building from source

The Rust crate lives at nostrnet-marmot-native/. A source build of this package requires cargo on PATH plus a C compiler (used by the cc crate to build rusqlite's bundled SQLite). See the main README's Development setup for per-platform prerequisites.

The NostrNet.Marmot.Mls.Native.csproj invokes cargo build before the .NET build via an MSBuild target, so a normal dotnet build from the repo root is all you need locally.

Testing the pack pipeline locally

The prebuilt/ directory inside this project is gitignored — CI populates it during release builds, and you can populate it yourself to dry-run the pack:

# Build the host's release artifact.
cd nostrnet-marmot-native
cargo build --release

# Stage it under the host's RID slot.
# (Substitute the path/name for your platform: .so on Linux, .dll on Windows.)
mkdir -p ../src/NostrNet.Marmot.Mls.Native/prebuilt/osx-arm64
cp target/release/libnostrnet_marmot_native.dylib \
   ../src/NostrNet.Marmot.Mls.Native/prebuilt/osx-arm64/

# Pack.
cd ..
dotnet pack NostrNet.slnx -c Release -o ./local-nupkgs

# Inspect.
unzip -l local-nupkgs/NostrNet.Marmot.Mls.Native.*.nupkg

The resulting .nupkg will ship only the RID you populated. The full multi-RID release happens through .github/workflows/release.yml.

Status

Pre-1.0 preview. Wire format is RFC 9420 (= what other MLS implementations produce). Cross-implementation interop is verified against White Noise and the upstream mdk-core reference — bidirectional 1:1 chat (KeyPackage publish + Welcome + send/receive of MIP-03 kind-9 chat rumors) works end-to-end. API may still change before 1.0; bump the ABI version in nostrnet-marmot-native/src/lib.rs and the matching test whenever the FFI surface changes.