NEXUS-Q Dart SDK

Dart bindings for NEXUS-Q. A thin wrapper over the C SDK using dart:ffi. It does not reimplement anything: every call goes through libnexusq.

Requirements

• Dart 3 or newer.
• The C SDK built (cargo build -p nexusq-c).
• On supported published releases, use scripts/with-runtime.sh to download the version-matched runtime, verify the release and archive checksums, and run Dart with NEXUSQ_LIBRARY configured for Linux x64/ARM64 glibc or macOS ARM64. The Dart package itself does not run install hooks, so this wrapper is required unless you install a compatible library yourself.
• Windows, musl/Alpine, and other unsupported targets require a compatible library built/installed separately. Missing libraries produce an actionable error rather than silently choosing another provider.

Usage

import 'package:nexusq/nexusq.dart';

void main() {
  print('nexusq version: ${version()}');

  final vault = Vault.create('my.nqv', 'password', label: 'my-label');
  print('vault created at ${vault.path}');
  print('format version: ${vault.formatVersion}');
}

Run with:

cd bindings/dart
./scripts/with-runtime.sh dart run your_program.dart

What is available

• version() — returns the library version.
• lastError() — returns the last C SDK error message.
• Vault:
  • Vault.create(path, password, {label}) — creates a new vault.
  • vault.path — returns the vault file path.
  • vault.formatVersion — returns the format version.
• NexusqException — the exception thrown on failures.

More operations land as the C SDK grows.

Testing

Run the smoke test and the unit suite from the repository root:

cd bindings/dart
NEXUSQ_LIBRARY=../../target/debug/libnexusq.so dart run example/smoke.dart
NEXUSQ_LIBRARY=../../target/debug/libnexusq.so dart test

The Dart binding is intentionally a thin wrapper over the C SDK, matching the Go SDK architecture. No cryptography or business logic is duplicated in Dart.