@xnetjs/crypto

Cryptographic primitives for xNet, built on @noble/hashes and @noble/curves.

Installation

pnpm add @xnetjs/crypto

Features

• BLAKE3 hashing -- hash(), hashHex(), hashBase64()
• Ed25519 signing -- sign(), verify(), key generation
• X25519 key exchange -- generateKeyPair(), deriveSharedSecret()
• XChaCha20-Poly1305 encryption -- encrypt(), decrypt(), generateKey()
• Random bytes -- Cryptographically secure randomBytes()
• Encoding utilities -- hex, base64, base64url conversions

Usage

import { hash, hashHex, hashBase64 } from '@xnetjs/crypto'

// BLAKE3 hashing
const digest = hash(data)
const hex = hashHex(data)
const b64 = hashBase64(data)

import { sign, verify } from '@xnetjs/crypto'

// Ed25519 signing
const signature = sign(message, privateKey)
const isValid = verify(message, signature, publicKey)

import { encrypt, decrypt, generateKey } from '@xnetjs/crypto'

// XChaCha20-Poly1305 symmetric encryption
const key = generateKey()
const ciphertext = encrypt(plaintext, key)
const plaintext = decrypt(ciphertext, key)

import { generateKeyPair, deriveSharedSecret } from '@xnetjs/crypto'

// X25519 key exchange
const alice = generateKeyPair()
const bob = generateKeyPair()
const shared = deriveSharedSecret(alice.privateKey, bob.publicKey)

Modules

| Module | Description | | --------------- | ---------------------------------- | | hashing.ts | BLAKE3 hash functions | | signing.ts | Ed25519 sign/verify | | asymmetric.ts | X25519 key exchange | | symmetric.ts | XChaCha20-Poly1305 encrypt/decrypt | | random.ts | Secure random bytes | | utils.ts | Hex, base64, base64url encoding |

Dependencies

• @noble/hashes -- BLAKE3
• @noble/curves -- Ed25519, X25519
• @xnetjs/core -- Core types

Testing

pnpm --filter @xnetjs/crypto test