Night Core™ SDK — Unified Developer Kit

Night Core™ SDK is the official multi-language development kit for secure, verifiable WebAssembly execution inside the Night Core ecosystem.
It provides a unified interface across Rust, Python, and TypeScript for verifying and running Ed25519-signed WASM modules with Wasmtime 37 + WASI P1 or Firecracker microVM backends.

⸻

🔍 What Is the Night Core SDK?

Night Core SDK offers:

• 🦀 Rust core SDK (nightcore-sdk)
• 🐍 Python bindings via PyO3 (nightcore-sdk-py)
• 🟦 TypeScript/Node.js addon via Neon (nightcore-sdk-ts)

All three versions expose identical APIs:

• ✔ verify_module_detailed(path)
• ✔ run_tenant_with_backend(backend, path)
• ✔ Backends:
  • wasmtime
  • firecracker (microVM mode, MVP)

The SDK powers and integrates seamlessly with:

• Night Core Worker
• Night Core Pro
• Night Mesh (future distributed proof layer)

⸻

Architecture

pgsql Copy code ┌────────────────────────────┐ │ TypeScript SDK │ │ (Neon / Native Addon) │ └──────────────┬─────────────┘ ▲ ┌──────────────┴─────────────┐ │ Python SDK │ │ (PyO3 Wrapper) │ └──────────────┬─────────────┘ ▲ ┌──────────────┴─────────────┐ │ Rust SDK │ │ (nightcore-sdk crate root) │ └─────────────────────────────┘ shell Copy code

⸻

Quick Start

1️ Install

Rust cargo add nightcore-sdk Python

pip install nightcore-sdk-py TypeScript

npm install nightcore-sdk-ts 2️ Example Usage Rust

use nightcore_sdk::{verify_module_detailed, run_tenant_with_backend};

fn main() -> anyhow::Result<()> { let proof = verify_module_detailed("modules/tenantA-hello")?; println!("{:#?}", proof);

run_tenant_with_backend("wasmtime", "modules/tenantA-hello")?;
Ok(())

} Python

import nightcore_sdk_py as nc

print(nc.verify_module("modules/tenantA-hello")) nc.run_tenant("firecracker", "modules/tenantB-math") TypeScript

ts

import { verifyModule, runTenant } from "nightcore-sdk-ts";

console.log(await verifyModule("modules/tenantA-hello")); await runTenant("wasmtime", "modules/tenantB-math"); ⸻

Firecracker Backend (SDK Mode) Night Core SDK integrates Firecracker with:

microVM boot

kernel + initrd injection

WASM payload injection

rootfs auto-generation

VM timeout-kill

boot log + audit trail output

This backend mirrors the behavior of Night Core Worker v39.5+.

⸻

🛡 Security Model Layer Mechanism Purpose Authenticity Ed25519 signatures Ensures WASM origin & legitimacy Integrity SHA-256 hashing Tamper detection Metadata manifest.json Versioning + permissions Isolation Wasmtime 37 + WASI P1 Sandboxed execution Hardened Isolation Firecracker microVM High-trust execution path Transparency JSON proof objects Reproducible, auditable results

⸻

Repository Structure

nightcore-sdk/ │ ├── rust/ # Rust core SDK crate ├── python/ # Python bindings (PyO3) └── typescript/ # Neon native addon ⸻

Version Metadata Property Value Version v1.0.0 Runtime Wasmtime 37 + WASI P1 Backend Firecracker (MVP) License MIT Maintainer B106 Labs Trademark Night Core™, B106 Edition

⸻

License & Credits License: MIT Copyright (c) 2025 B106 Labs Trademarks: Night Core™ and B106 Edition are proprietary marks of B106 Labs.

⸻

Night Core™ SDK — Secure • Autonomous • Verified