M-Hard 1: Cryptographic Hardening - constantTimeEqual, zeroize, randomUint32 on CryptoProvider - Fix Math.random() → crypto.randomUint32() for registrationId - Zero message keys and chain keys after use in ratchet.ts - Constant-time trust comparison in MemoryStorage + SQLiteStorage - Timing variance test catches early-exit regressions M-Hard 2: Self-Authenticated Prekey Server - Ed25519 signature verification on all write routes - signPayload/verifyPayload with canonical JSON, ±5 min replay window - Address validation (NFKC, alphanumeric + :_-.) - Global ShadeError → HTTP status mapping - ShadeFetchTransport signs requests when signingPrivateKey provided - Anonymous bundle fetches still allowed (read-only) M-Hard 3: Rate Limiting + DoS Protection - Token bucket rate limiter with pluggable store - Per-route limits: register 5/h/IP, fetch 60/min/IP, replenish 10/min/id - 64KB body size limit on POST - Retry-After header on 429 responses M-Hard 4: Auto-replenish + Fingerprints + Session Reset - Safety numbers (12 groups × 5 digits, Signal-style) - ensurePreKeyStock, resetSession, acceptIdentityChange - verifyRemoteIdentity for out-of-band comparison M-Hard 5: Identity Rotation with Grace Period - rotateIdentity archives old identity, generates fresh signed prekey - RetiredIdentity storage with addRetired/getRetired/pruneRetired - 7-day default grace period for decrypting old sessions - pruneExpiredIdentities for cleanup M-Hard 8: Error Hierarchy - New error types: Network, Storage, Validation, Timeout, RateLimit, Configuration, Unauthorized, Replay, IdentityRotation - All errors have stable SHADE_* codes - errorToHttpStatus for consistent HTTP mapping - toJSON() for network serialization 188 tests passing, zero failures. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
85 lines
3.5 KiB
TypeScript
85 lines
3.5 KiB
TypeScript
import { describe, test, expect } from 'bun:test';
|
|
import { SubtleCryptoProvider, MemoryStorage } from '@shade/crypto-web';
|
|
import { ShadeSessionManager } from '@shade/core';
|
|
import { createPrekeyServer, MemoryPrekeyStore } from '@shade/server';
|
|
import { ShadeFetchTransport } from '../src/fetch-transport.js';
|
|
|
|
const crypto = new SubtleCryptoProvider();
|
|
|
|
describe('ShadeFetchTransport', () => {
|
|
test('full flow: register → fetch bundle → establish session → talk', async () => {
|
|
const store = new MemoryPrekeyStore();
|
|
const server = createPrekeyServer({ crypto, store, disableRateLimit: true });
|
|
|
|
const port = 19000 + Math.floor(Math.random() * 1000);
|
|
const handle = Bun.serve({ port, fetch: server.fetch });
|
|
|
|
try {
|
|
const baseUrl = `http://localhost:${port}`;
|
|
|
|
// ─── Bob: set up session manager, register with transport ──
|
|
const bobStorage = new MemoryStorage();
|
|
const bobManager = new ShadeSessionManager(crypto, bobStorage);
|
|
await bobManager.initialize();
|
|
|
|
const bobIdentity = await bobStorage.getIdentityKeyPair();
|
|
const bobTransport = new ShadeFetchTransport({
|
|
baseUrl,
|
|
crypto,
|
|
signingPrivateKey: bobIdentity!.signingPrivateKey,
|
|
});
|
|
|
|
const bobOTPKs = await bobManager.generateOneTimePreKeys(5);
|
|
const bobBundle = await bobManager.createPreKeyBundle();
|
|
|
|
await bobTransport.register(
|
|
'bob',
|
|
bobManager.getPublicIdentity(),
|
|
bobBundle.signedPreKey,
|
|
bobOTPKs,
|
|
);
|
|
|
|
expect(await bobTransport.getKeyCount('bob')).toBe(5);
|
|
|
|
// ─── Alice: anonymous fetch + establish session ───────
|
|
const aliceStorage = new MemoryStorage();
|
|
const aliceManager = new ShadeSessionManager(crypto, aliceStorage);
|
|
await aliceManager.initialize();
|
|
|
|
// Alice doesn't need a signing key to fetch bundles
|
|
const aliceTransport = new ShadeFetchTransport({ baseUrl, crypto });
|
|
|
|
const fetchedBundle = await aliceTransport.fetchBundle('bob');
|
|
expect(fetchedBundle.identityDHKey).toEqual(bobManager.getPublicIdentity().dhKey);
|
|
|
|
expect(await aliceTransport.getKeyCount('bob')).toBe(4);
|
|
|
|
await aliceManager.initSessionFromBundle('bob', fetchedBundle);
|
|
|
|
// ─── Alice → Bob encrypted ───────────────────────────
|
|
const env1 = await aliceManager.encrypt('bob', 'Hello via transport!');
|
|
const plain1 = await bobManager.decrypt('alice', env1);
|
|
expect(plain1).toBe('Hello via transport!');
|
|
|
|
// ─── Bob → Alice reply ───────────────────────────────
|
|
const env2 = await bobManager.encrypt('alice', 'Got it!');
|
|
const plain2 = await aliceManager.decrypt('bob', env2);
|
|
expect(plain2).toBe('Got it!');
|
|
|
|
// ─── Replenish (signed) ──────────────────────────────
|
|
const remaining = await bobTransport.replenish('bob', [
|
|
{ keyId: 200, publicKey: crypto.randomBytes(32) },
|
|
{ keyId: 201, publicKey: crypto.randomBytes(32) },
|
|
]);
|
|
expect(remaining).toBe(6);
|
|
|
|
// ─── Unregister (signed) ─────────────────────────────
|
|
await bobTransport.unregister('bob');
|
|
await expect(aliceTransport.fetchBundle('bob')).rejects.toThrow();
|
|
|
|
} finally {
|
|
handle.stop();
|
|
}
|
|
});
|
|
});
|