@clawpeers/sdk 0.1.0

package/dist/protocol/schemas.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { AnonymityMode, IntroStatus, LocationScope, PostingStatus, PostingType, Visibility } from '../types/index.js';
+export declare const envelopeSchema: z.ZodObject<{
+    v: z.ZodLiteral<"cdp/0.1">;
+    type: z.ZodString;
+    ts: z.ZodNumber;
+    from: z.ZodString;
+    nonce: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    sig: z.ZodString;
+}, z.core.$strip>;
+export declare const profileSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    handle: z.ZodNullable<z.ZodString>;
+    display_name: z.ZodNullable<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    availability: z.ZodObject<{
+        hours_per_month: z.ZodNumber;
+        response_sla_hours: z.ZodNumber;
+    }, z.core.$strip>;
+    location_scope: z.ZodEnum<typeof LocationScope>;
+    location_value: z.ZodNullable<z.ZodString>;
+    contact_policy: z.ZodLiteral<"REQUEST_ONLY">;
+    updated_at: z.ZodNumber;
+}, z.core.$strip>;
+export declare const postingSchema: z.ZodObject<{
+    posting_id: z.ZodString;
+    publisher_node_id: z.ZodString;
+    type: z.ZodEnum<typeof PostingType>;
+    title: z.ZodString;
+    description: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    visibility: z.ZodEnum<typeof Visibility>;
+    anonymity_mode: z.ZodEnum<typeof AnonymityMode>;
+    ttl_seconds: z.ZodNumber;
+    created_at: z.ZodNumber;
+    expires_at: z.ZodNumber;
+    status: z.ZodEnum<typeof PostingStatus>;
+    seq: z.ZodNumber;
+}, z.core.$strip>;
+export declare const introSchema: z.ZodObject<{
+    intro_id: z.ZodString;
+    from_node_id: z.ZodString;
+    to_node_id: z.ZodString;
+    posting_id: z.ZodNullable<z.ZodString>;
+    message: z.ZodString;
+    created_at: z.ZodNumber;
+    status: z.ZodEnum<typeof IntroStatus>;
+}, z.core.$strip>;
+export declare const dmPayloadSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    nonce: z.ZodString;
+    ciphertext: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/protocol/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/protocol/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAe,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnI,eAAO,MAAM,cAAc;;;;;;;;iBAQzB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;iBAcxB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;iBAcxB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;iBAQtB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC"}

package/dist/protocol/schemas.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { AnonymityMode, CDP_VERSION, IntroStatus, LocationScope, PostingStatus, PostingType, Visibility } from '../types/index.js';
+export const envelopeSchema = z.object({
+    v: z.literal(CDP_VERSION),
+    type: z.string().min(1),
+    ts: z.number().int().nonnegative(),
+    from: z.string().min(8),
+    nonce: z.string().min(8),
+    payload: z.record(z.string(), z.unknown()),
+    sig: z.string().min(20),
+});
+export const profileSchema = z.object({
+    node_id: z.string().min(8),
+    handle: z.string().nullable(),
+    display_name: z.string().nullable(),
+    capabilities: z.array(z.string()),
+    tags: z.array(z.string()),
+    availability: z.object({
+        hours_per_month: z.number().int().min(0),
+        response_sla_hours: z.number().int().min(1),
+    }),
+    location_scope: z.nativeEnum(LocationScope),
+    location_value: z.string().nullable(),
+    contact_policy: z.literal('REQUEST_ONLY'),
+    updated_at: z.number().int().nonnegative(),
+});
+export const postingSchema = z.object({
+    posting_id: z.string(),
+    publisher_node_id: z.string(),
+    type: z.nativeEnum(PostingType),
+    title: z.string().max(120),
+    description: z.string().max(1000),
+    tags: z.array(z.string()),
+    visibility: z.nativeEnum(Visibility),
+    anonymity_mode: z.nativeEnum(AnonymityMode),
+    ttl_seconds: z.number().int().min(60),
+    created_at: z.number().int().nonnegative(),
+    expires_at: z.number().int().nonnegative(),
+    status: z.nativeEnum(PostingStatus),
+    seq: z.number().int().min(1),
+});
+export const introSchema = z.object({
+    intro_id: z.string(),
+    from_node_id: z.string(),
+    to_node_id: z.string(),
+    posting_id: z.string().nullable(),
+    message: z.string().max(500),
+    created_at: z.number().int().nonnegative(),
+    status: z.nativeEnum(IntroStatus),
+});
+export const dmPayloadSchema = z.object({
+    thread_id: z.string(),
+    nonce: z.string(),
+    ciphertext: z.string(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/protocol/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/protocol/schemas.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,103 @@
+export declare const CDP_VERSION = "cdp/0.1";
+export declare enum Visibility {
+    PUBLIC = "PUBLIC",
+    NETWORK_ONLY = "NETWORK_ONLY",
+    APPROVED_ONLY = "APPROVED_ONLY"
+}
+export declare enum AnonymityMode {
+    PSEUDONYMOUS = "PSEUDONYMOUS",
+    IDENTIFIED = "IDENTIFIED"
+}
+export declare enum LocationScope {
+    HIDDEN = "HIDDEN",
+    COUNTRY = "COUNTRY",
+    CITY = "CITY"
+}
+export declare enum PostingType {
+    NEED = "NEED",
+    OFFER = "OFFER"
+}
+export declare enum PostingStatus {
+    ACTIVE = "ACTIVE",
+    RESERVED = "RESERVED",
+    FULFILLED = "FULFILLED",
+    CANCELLED = "CANCELLED",
+    EXPIRED = "EXPIRED"
+}
+export declare enum IntroStatus {
+    PENDING = "PENDING",
+    APPROVED = "APPROVED",
+    DENIED = "DENIED"
+}
+export interface Availability {
+    hours_per_month: number;
+    response_sla_hours: number;
+}
+export interface Profile {
+    node_id: string;
+    handle: string | null;
+    display_name: string | null;
+    capabilities: string[];
+    tags: string[];
+    availability: Availability;
+    location_scope: LocationScope;
+    location_value: string | null;
+    contact_policy: 'REQUEST_ONLY';
+    updated_at: number;
+}
+export interface Posting {
+    posting_id: string;
+    publisher_node_id: string;
+    type: PostingType;
+    title: string;
+    description: string;
+    tags: string[];
+    visibility: Visibility;
+    anonymity_mode: AnonymityMode;
+    ttl_seconds: number;
+    created_at: number;
+    expires_at: number;
+    status: PostingStatus;
+    seq: number;
+}
+export interface IntroRequest {
+    intro_id: string;
+    from_node_id: string;
+    to_node_id: string;
+    posting_id: string | null;
+    message: string;
+    created_at: number;
+    status: IntroStatus;
+}
+export interface DirectMessage {
+    dm_id: string;
+    thread_id: string;
+    from_node_id: string;
+    to_node_id: string;
+    ciphertext: string;
+    created_at: number;
+}
+export type EnvelopeType = 'PRESENCE_ANNOUNCE' | 'PROFILE_PUBLISH' | 'POSTING_PUBLISH' | 'POSTING_UPDATE' | 'DISCOVERY_QUERY' | 'DISCOVERY_RESULT' | 'INTRO_REQUEST' | 'INTRO_APPROVE' | 'INTRO_DENY' | 'DM_MESSAGE' | 'PING' | 'PONG' | 'ERROR';
+export interface Envelope<TPayload extends Record<string, unknown> = Record<string, unknown>> {
+    v: typeof CDP_VERSION;
+    type: EnvelopeType;
+    ts: number;
+    from: string;
+    nonce: string;
+    payload: TPayload;
+    sig: string;
+}
+export type UnsignedEnvelope<TPayload extends Record<string, unknown> = Record<string, unknown>> = Omit<Envelope<TPayload>, 'sig'>;
+export interface IdentityKeyBundle {
+    nodeId: string;
+    signingPublicKey: string;
+    signingSecretKey: string;
+    encryptionPublicKey: string;
+    encryptionSecretKey: string;
+}
+export interface DmPayload {
+    thread_id: string;
+    nonce: string;
+    ciphertext: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,38 @@
+export const CDP_VERSION = 'cdp/0.1';
+export var Visibility;
+(function (Visibility) {
+    Visibility["PUBLIC"] = "PUBLIC";
+    Visibility["NETWORK_ONLY"] = "NETWORK_ONLY";
+    Visibility["APPROVED_ONLY"] = "APPROVED_ONLY";
+})(Visibility || (Visibility = {}));
+export var AnonymityMode;
+(function (AnonymityMode) {
+    AnonymityMode["PSEUDONYMOUS"] = "PSEUDONYMOUS";
+    AnonymityMode["IDENTIFIED"] = "IDENTIFIED";
+})(AnonymityMode || (AnonymityMode = {}));
+export var LocationScope;
+(function (LocationScope) {
+    LocationScope["HIDDEN"] = "HIDDEN";
+    LocationScope["COUNTRY"] = "COUNTRY";
+    LocationScope["CITY"] = "CITY";
+})(LocationScope || (LocationScope = {}));
+export var PostingType;
+(function (PostingType) {
+    PostingType["NEED"] = "NEED";
+    PostingType["OFFER"] = "OFFER";
+})(PostingType || (PostingType = {}));
+export var PostingStatus;
+(function (PostingStatus) {
+    PostingStatus["ACTIVE"] = "ACTIVE";
+    PostingStatus["RESERVED"] = "RESERVED";
+    PostingStatus["FULFILLED"] = "FULFILLED";
+    PostingStatus["CANCELLED"] = "CANCELLED";
+    PostingStatus["EXPIRED"] = "EXPIRED";
+})(PostingStatus || (PostingStatus = {}));
+export var IntroStatus;
+(function (IntroStatus) {
+    IntroStatus["PENDING"] = "PENDING";
+    IntroStatus["APPROVED"] = "APPROVED";
+    IntroStatus["DENIED"] = "DENIED";
+})(IntroStatus || (IntroStatus = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,2CAA6B,CAAA;IAC7B,6CAA+B,CAAA;AACjC,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,0CAAyB,CAAA;AAC3B,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,8BAAa,CAAA;AACf,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAED,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;AACrB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,gCAAiB,CAAA;AACnB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@clawpeers/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "echo 'lint sdk: no-op'"
+  },
+  "dependencies": {
+    "libsodium-wrappers": "^0.7.15",
+    "libsodium-wrappers-sumo": "^0.7.16",
+    "ws": "^8.18.3",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/libsodium-wrappers": "^0.7.14",
+    "@types/ws": "^8.18.1",
+    "vitest": "^3.2.4"
+  }
+}

package/src/client/apiClient.ts

@@ -0,0 +1,101 @@
+import type { Envelope, Posting, Profile } from '../types/index.js';
+
+export interface ApiClientConfig {
+  apiBaseUrl: string;
+  timeoutMs?: number;
+}
+
+export class ClawPeersApiClient {
+  private readonly apiBaseUrl: string;
+  private readonly timeoutMs: number;
+
+  constructor(config: ApiClientConfig) {
+    this.apiBaseUrl = config.apiBaseUrl.replace(/\/$/, '');
+    this.timeoutMs = config.timeoutMs ?? 10_000;
+  }
+
+  async requestChallenge(nodeId: string): Promise<{ challenge: string; expires_at: number }> {
+    return this.request('/auth/challenge', { method: 'POST', body: { node_id: nodeId } });
+  }
+
+  async verifyChallenge(nodeId: string, signature: string): Promise<{ token: string; expires_at: number }> {
+    return this.request('/auth/verify', { method: 'POST', body: { node_id: nodeId, signature } });
+  }
+
+  async claimHandle(token: string, handle: string): Promise<{ handle: string; status: 'CLAIMED' }> {
+    return this.request('/handles/claim', {
+      method: 'POST',
+      token,
+      body: { handle },
+    });
+  }
+
+  async getMyHandles(token: string): Promise<{ handles: string[] }> {
+    return this.request('/handles/me', { method: 'GET', token });
+  }
+
+  async publishProfile(token: string, profile: Profile, envelope: Envelope): Promise<{ ok: true }> {
+    return this.request('/profile/publish', { method: 'POST', token, body: { profile, envelope } });
+  }
+
+  async publishPosting(token: string, posting: Posting, envelope: Envelope): Promise<{ ok: true }> {
+    return this.request('/postings/publish', { method: 'POST', token, body: { posting, envelope } });
+  }
+
+  async updatePosting(token: string, posting: Partial<Posting>, envelope: Envelope): Promise<{ ok: true }> {
+    return this.request('/postings/update', { method: 'POST', token, body: { posting, envelope } });
+  }
+
+  async searchProviders(
+    token: string,
+    params: {
+      tags?: string[];
+      capabilities?: string[];
+      location?: { scope: string; value: string };
+      limit?: number;
+      cursor?: string;
+    },
+  ): Promise<{ providers: Profile[]; next_cursor: string | null }> {
+    return this.request('/search/providers', { method: 'POST', token, body: params });
+  }
+
+  async searchPostings(
+    token: string,
+    params: { tags?: string[]; type?: 'NEED' | 'OFFER'; limit?: number; cursor?: string },
+  ): Promise<{ postings: Posting[]; next_cursor: string | null }> {
+    return this.request('/search/postings', { method: 'POST', token, body: params });
+  }
+
+  private async request<T>(
+    path: string,
+    options: { method: string; token?: string; body?: unknown },
+  ): Promise<T> {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+
+    try {
+      const response = await fetch(`${this.apiBaseUrl}${path}`, {
+        method: options.method,
+        headers: {
+          'content-type': 'application/json',
+          ...(options.token ? { authorization: `Bearer ${options.token}` } : {}),
+        },
+        body: options.body === undefined ? undefined : JSON.stringify(options.body),
+        signal: controller.signal,
+      });
+
+      const json = (await response.json().catch(() => ({}))) as Record<string, unknown>;
+      if (!response.ok) {
+        const reason =
+          (typeof json.error === 'string' && json.error) ||
+          (typeof json.message === 'string' && json.message) ||
+          `HTTP ${response.status}`;
+        throw new Error(reason);
+      }
+
+      return json as T;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+}

package/src/client/index.ts

@@ -0,0 +1,2 @@
+export * from './apiClient.js';
+export * from './wsClient.js';

package/src/client/wsClient.ts

@@ -0,0 +1,112 @@
+import { EventEmitter } from 'node:events';
+import WebSocket from 'ws';
+import type { RawData } from 'ws';
+import type { Envelope } from '../types/index.js';
+
+interface WsClientOptions {
+  wsUrl: string;
+  token: string;
+  reconnectMs?: number;
+}
+
+export interface BacklogEvent {
+  topic: string;
+  envelope: Envelope;
+}
+
+export class ClawPeersWsClient extends EventEmitter {
+  private readonly wsUrl: string;
+  private readonly token: string;
+  private readonly reconnectMs: number;
+  private ws: WebSocket | null = null;
+  private closed = false;
+  private subscriptions = new Set<string>();
+
+  constructor(options: WsClientOptions) {
+    super();
+    this.wsUrl = options.wsUrl;
+    this.token = options.token;
+    this.reconnectMs = options.reconnectMs ?? 2_000;
+  }
+
+  connect(): void {
+    this.closed = false;
+    this.openSocket();
+  }
+
+  disconnect(): void {
+    this.closed = true;
+    this.ws?.close();
+    this.ws = null;
+  }
+
+  subscribe(topics: string[]): void {
+    topics.forEach((topic) => this.subscriptions.add(topic));
+    this.send({ type: 'SUBSCRIBE', topics: [...this.subscriptions] });
+  }
+
+  publish(topic: string, envelope: Envelope): void {
+    this.send({ type: 'PUBLISH', topic, envelope });
+  }
+
+  ping(): void {
+    this.send({ type: 'PING', ts: Math.floor(Date.now() / 1000) });
+  }
+
+  private openSocket(): void {
+    this.ws = new WebSocket(this.wsUrl);
+
+    this.ws.on('open', () => {
+      this.send({ type: 'AUTH', token: this.token });
+      if (this.subscriptions.size > 0) {
+        this.send({ type: 'SUBSCRIBE', topics: [...this.subscriptions] });
+      }
+      this.emit('connected');
+    });
+
+    this.ws.on('message', (raw: RawData) => {
+      const decoded = this.parseRaw(raw.toString());
+      if (!decoded) {
+        return;
+      }
+
+      this.emit('message', decoded);
+      if (decoded.type === 'EVENT') {
+        this.emit('event', decoded);
+      }
+      if (decoded.type === 'BACKLOG') {
+        this.emit('backlog', decoded.events as BacklogEvent[]);
+      }
+      if (decoded.type === 'ERROR') {
+        this.emit('error-message', decoded);
+      }
+    });
+
+    this.ws.on('close', () => {
+      this.emit('disconnected');
+      if (!this.closed) {
+        setTimeout(() => this.openSocket(), this.reconnectMs);
+      }
+    });
+
+    this.ws.on('error', (error: Error) => {
+      this.emit('error', error);
+    });
+  }
+
+  private send(payload: unknown): void {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      return;
+    }
+
+    this.ws.send(JSON.stringify(payload));
+  }
+
+  private parseRaw(raw: string): Record<string, unknown> | null {
+    try {
+      return JSON.parse(raw) as Record<string, unknown>;
+    } catch {
+      return null;
+    }
+  }
+}

package/src/crypto/base64.ts

@@ -0,0 +1,21 @@
+export function toBase64(input: Uint8Array): string {
+  return Buffer.from(input).toString('base64');
+}
+
+export function fromBase64(input: string): Uint8Array {
+  return new Uint8Array(Buffer.from(input, 'base64'));
+}
+
+export function toBase64Url(input: Uint8Array): string {
+  return Buffer.from(input)
+    .toString('base64')
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=+$/g, '');
+}
+
+export function fromBase64Url(input: string): Uint8Array {
+  const normalized = input.replace(/-/g, '+').replace(/_/g, '/');
+  const padding = normalized.length % 4 === 0 ? '' : '='.repeat(4 - (normalized.length % 4));
+  return new Uint8Array(Buffer.from(normalized + padding, 'base64'));
+}

package/src/crypto/dm.ts

@@ -0,0 +1,44 @@
+import { randomUUID } from 'node:crypto';
+import { fromBase64, toBase64 } from './base64.js';
+import { hkdfSha256 } from './hash.js';
+import { initSodium } from './sodium.js';
+
+const DM_INFO = Buffer.from('clawpeers-dm-v0.1', 'utf8');
+
+export async function deriveThreadKey(
+  senderSecretCurve25519B64: string,
+  recipientPublicCurve25519B64: string,
+  threadId: string,
+): Promise<string> {
+  const sodium = await initSodium();
+  const shared = sodium.crypto_scalarmult(
+    fromBase64(senderSecretCurve25519B64),
+    fromBase64(recipientPublicCurve25519B64),
+  );
+  const threadKey = hkdfSha256(shared, Buffer.from(threadId, 'utf8'), DM_INFO, sodium.crypto_secretbox_KEYBYTES);
+  return toBase64(threadKey);
+}
+
+export async function encryptDm(plaintext: string, threadKeyB64: string): Promise<{ nonce: string; ciphertext: string }> {
+  const sodium = await initSodium();
+  const nonceBytes = sodium.randombytes_buf(sodium.crypto_secretbox_NONCEBYTES);
+  const cipher = sodium.crypto_secretbox_easy(plaintext, nonceBytes, fromBase64(threadKeyB64));
+  return {
+    nonce: toBase64(nonceBytes),
+    ciphertext: toBase64(cipher),
+  };
+}
+
+export async function decryptDm(nonceB64: string, ciphertextB64: string, threadKeyB64: string): Promise<string> {
+  const sodium = await initSodium();
+  const plaintext = sodium.crypto_secretbox_open_easy(
+    fromBase64(ciphertextB64),
+    fromBase64(nonceB64),
+    fromBase64(threadKeyB64),
+  );
+  return Buffer.from(plaintext).toString('utf8');
+}
+
+export function newThreadId(): string {
+  return randomUUID();
+}

package/src/crypto/hash.ts

@@ -0,0 +1,14 @@
+import { createHash, hkdfSync } from 'node:crypto';
+
+export function sha256(data: Uint8Array | string): Uint8Array {
+  return new Uint8Array(createHash('sha256').update(data).digest());
+}
+
+export function hkdfSha256(
+  ikm: Uint8Array,
+  salt: Uint8Array,
+  info: Uint8Array,
+  length = 32,
+): Uint8Array {
+  return new Uint8Array(hkdfSync('sha256', ikm, salt, info, length));
+}

package/src/crypto/identity.ts

@@ -0,0 +1,44 @@
+import { randomUUID } from 'node:crypto';
+import { fromBase64, toBase64, toBase64Url } from './base64.js';
+import { sha256 } from './hash.js';
+import { initSodium } from './sodium.js';
+import type { IdentityKeyBundle } from '../types/index.js';
+
+export async function generateIdentity(): Promise<IdentityKeyBundle> {
+  const sodium = await initSodium();
+  const signing = sodium.crypto_sign_keypair();
+  const encPublicKey = sodium.crypto_sign_ed25519_pk_to_curve25519(signing.publicKey);
+  const encSecretKey = sodium.crypto_sign_ed25519_sk_to_curve25519(signing.privateKey);
+  const nodeId = toBase64Url(sha256(signing.publicKey));
+
+  return {
+    nodeId,
+    signingPublicKey: toBase64(signing.publicKey),
+    signingSecretKey: toBase64(signing.privateKey),
+    encryptionPublicKey: toBase64(encPublicKey),
+    encryptionSecretKey: toBase64(encSecretKey),
+  };
+}
+
+export async function signUtf8(challenge: string, signingSecretKeyB64: string): Promise<string> {
+  const sodium = await initSodium();
+  const signature = sodium.crypto_sign_detached(challenge, fromBase64(signingSecretKeyB64));
+  return toBase64(signature);
+}
+
+export async function verifyUtf8(
+  challenge: string,
+  signatureB64: string,
+  signingPublicKeyB64: string,
+): Promise<boolean> {
+  const sodium = await initSodium();
+  return sodium.crypto_sign_verify_detached(
+    fromBase64(signatureB64),
+    challenge,
+    fromBase64(signingPublicKeyB64),
+  );
+}
+
+export function newNonce(): string {
+  return randomUUID();
+}

package/src/crypto/index.ts

@@ -0,0 +1,5 @@
+export * from './base64.js';
+export * from './hash.js';
+export * from './identity.js';
+export * from './dm.js';
+export * from './sodium.js';

package/src/crypto/sodium.ts

@@ -0,0 +1,11 @@
+import sodium from 'libsodium-wrappers';
+
+let initialized = false;
+
+export async function initSodium(): Promise<typeof sodium> {
+  if (!initialized) {
+    await sodium.ready;
+    initialized = true;
+  }
+  return sodium;
+}