core

@xnetjs/core

Core types, content addressing, and permission primitives for xNet. This is the leaf package -- it has no internal @xnetjs/* dependencies.

Installation

pnpm add @xnetjs/core

Features

• Content addressing -- BLAKE3-based CIDs (cid:blake3:{hash}), Merkle trees
• Signed updates -- Vector clocks, signed update types for causal ordering
• Snapshots -- Point-in-time snapshot types for state persistence
• Verification -- Fork detection, update chain verification
• DID resolution -- Pluggable DID resolver interface
• Query federation -- Types for cross-hub federated queries
• Permissions -- Role-based access control (RBAC), capabilities

Usage

import { hashContent, createContentId, verifyContent, buildMerkleTree } from '@xnetjs/core'

// Hash content with BLAKE3
const hash = hashContent(new Uint8Array([1, 2, 3]))

// Create a content-addressed ID
const cid = createContentId(data)

// Verify content integrity
const isValid = verifyContent(cid, data)

// Build a Merkle tree
const tree = buildMerkleTree(chunks)

import { detectFork, verifyUpdateChain } from '@xnetjs/core'

// Verify an update chain
const valid = verifyUpdateChain(updates)

// Detect forks in update history
const fork = detectFork(chain1, chain2)

Modules

Module	Description
content.ts	Content addressing, CID creation
hashing.ts	BLAKE3 hashing, Merkle trees
snapshots.ts	Snapshot types and utilities
updates.ts	Signed updates, vector clocks
verification.ts	Fork detection, chain verification
resolution.ts	DID resolver interface
federation.ts	Federated query types
permissions.ts	Roles, capabilities, RBAC

Testing

pnpm --filter @xnetjs/core test