society-protocol 1.0.0

package/dist/gateway/demand-spawner.js

@@ -0,0 +1,426 @@
+/**
+ * Society Protocol — Demand-Driven Agent Spawner
+ *
+ * Inspired by:
+ * - AutoAgents (arXiv:2309.17288): Dynamic role generation per task
+ * - MaAS (arXiv:2502.04180): Per-query architecture sampling from supernet
+ * - IoA (arXiv:2505.07176): Ephemeral team assembly + dissolution
+ * - DyLAN (arXiv:2310.02170): Agent importance scoring for selection
+ *
+ * Given a request, the DemandSpawner:
+ * 1. Uses CapabilityRouter to determine roles needed
+ * 2. Tries to select existing agents from the SwarmController pool
+ * 3. Spawns ephemeral agents (Ollama, HTTP, Docker) for missing roles
+ * 4. Opens a Chain of Collaboration for the team
+ * 5. Monitors execution and collects results
+ * 6. Dissolves ephemeral agents when done
+ */
+import { EventEmitter } from 'events';
+import { ulid } from 'ulid';
+import { SwarmController } from '../proactive/swarm-controller.js';
+import { CapabilityRouter } from './capability-router.js';
+export const DEFAULT_SPAWN_CONFIG = {
+    defaultRuntime: 'ollama',
+    ollamaUrl: process.env.OLLAMA_URL || 'http://localhost:11434',
+    ollamaModel: process.env.OLLAMA_MODEL || 'qwen3:1.7b',
+    maxSpawnedAgents: 8,
+    taskTimeoutMs: 120_000,
+    autoDissolvе: true,
+    defaultRoom: 'swarm-lobby',
+};
+// ─── Demand Spawner ──────────────────────────────────────────────
+export class DemandSpawner extends EventEmitter {
+    storage;
+    rooms;
+    coc;
+    identity;
+    config;
+    router;
+    swarm;
+    teams = new Map();
+    spawnedAgents = new Map();
+    constructor(storage, rooms, coc, registry, config = {}, identity) {
+        super();
+        this.storage = storage;
+        this.rooms = rooms;
+        this.coc = coc;
+        this.identity = identity;
+        this.config = { ...DEFAULT_SPAWN_CONFIG, ...config };
+        this.router = new CapabilityRouter();
+        this.swarm = new SwarmController(storage, rooms, registry);
+    }
+    /**
+     * Handle an incoming request end-to-end:
+     * Route → Select/Spawn → Execute → Collect → Dissolve
+     */
+    async handleRequest(request) {
+        const teamId = `team_${ulid()}`;
+        const routing = this.router.route(request);
+        const roomId = request.roomId || this.config.defaultRoom;
+        this.emit('request:routed', { teamId, routing });
+        // Ensure room exists — use identity DID to satisfy FK constraints
+        const creatorDid = request.callerDid || this.identity?.did || 'system';
+        this.storage.createRoom(roomId, roomId, creatorDid);
+        const team = {
+            teamId,
+            request,
+            routing,
+            agents: [],
+            roomId,
+            status: 'assembling',
+            results: new Map(),
+            createdAt: Date.now(),
+        };
+        this.teams.set(teamId, team);
+        try {
+            // 1. Resolve or spawn agents for each role
+            const agents = await this.assembleTeam(team, routing);
+            team.agents = agents;
+            this.emit('team:assembled', {
+                teamId,
+                agentCount: agents.length,
+                roles: agents.map(a => a.role.role),
+            });
+            // 2. Open Chain of Collaboration
+            const chainId = await this.openChain(team, routing);
+            team.chainId = chainId;
+            team.status = 'working';
+            // 3. Execute tasks via agents
+            const results = await this.executeTeam(team);
+            team.results = results;
+            team.status = 'completed';
+            team.completedAt = Date.now();
+            this.emit('team:completed', { teamId, chainId });
+            // 4. Dissolve ephemeral agents
+            await this.dissolveTeam(team);
+            return {
+                teamId,
+                chainId,
+                status: 'completed',
+                results: Object.fromEntries(results),
+                agents: agents.map(a => ({
+                    id: a.id,
+                    role: a.role.role,
+                    runtime: a.runtime,
+                    status: a.status,
+                })),
+                durationMs: Date.now() - team.createdAt,
+            };
+        }
+        catch (error) {
+            team.status = 'failed';
+            team.completedAt = Date.now();
+            await this.dissolveTeam(team);
+            this.emit('team:failed', {
+                teamId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                teamId,
+                chainId: team.chainId || '',
+                status: 'failed',
+                results: { error: error instanceof Error ? error.message : String(error) },
+                agents: team.agents.map(a => ({
+                    id: a.id,
+                    role: a.role.role,
+                    runtime: a.runtime,
+                    status: a.status,
+                })),
+                durationMs: Date.now() - team.createdAt,
+            };
+        }
+    }
+    /**
+     * Assemble a team by selecting existing agents or spawning new ones.
+     */
+    async assembleTeam(team, routing) {
+        const agents = [];
+        for (const role of routing.roles) {
+            // Try to find existing agent in swarm
+            const existing = this.swarm.selectAgent(role.taskType, {
+                capabilities: role.capabilities,
+            });
+            if (existing) {
+                agents.push(this.wrapExistingAgent(existing, role));
+                this.emit('agent:selected', {
+                    teamId: team.teamId,
+                    did: existing.did,
+                    role: role.role,
+                    source: 'pool',
+                });
+            }
+            else {
+                // Spawn ephemeral agent
+                const spawned = await this.spawnAgent(team, role);
+                agents.push(spawned);
+                this.emit('agent:spawned', {
+                    teamId: team.teamId,
+                    agentId: spawned.id,
+                    role: role.role,
+                    runtime: spawned.runtime,
+                    source: 'spawned',
+                });
+            }
+            if (agents.length >= routing.maxAgents)
+                break;
+        }
+        return agents;
+    }
+    /**
+     * Wrap an existing swarm agent as a SpawnedAgent.
+     */
+    wrapExistingAgent(agent, role) {
+        return {
+            id: `agent_${ulid()}`,
+            role,
+            runtime: 'http', // Existing agents are accessed via protocol
+            did: agent.did,
+            status: 'ready',
+            createdAt: Date.now(),
+        };
+    }
+    /**
+     * Spawn an ephemeral agent for a role.
+     */
+    async spawnAgent(team, role) {
+        if (this.spawnedAgents.size >= this.config.maxSpawnedAgents) {
+            throw new Error(`Max spawned agents (${this.config.maxSpawnedAgents}) reached`);
+        }
+        const agentId = `agent_${ulid()}`;
+        const did = `did:key:spawned-${agentId}`;
+        const agent = {
+            id: agentId,
+            role,
+            runtime: this.config.defaultRuntime,
+            did,
+            status: 'spawning',
+            createdAt: Date.now(),
+        };
+        // Register with swarm
+        const profile = {
+            did,
+            hostId: `host_${agentId}`,
+            roomId: team.roomId,
+            runtime: this.config.defaultRuntime === 'process' ? 'custom' : this.config.defaultRuntime,
+            specialties: role.specialties,
+            capabilities: role.capabilities,
+            kinds: [role.kind],
+            maxConcurrency: 1,
+            load: 0,
+            health: 'healthy',
+            displayName: `${role.role}-${agentId.slice(-6)}`,
+            lastSeen: Date.now(),
+        };
+        this.swarm.registerAgent(profile);
+        agent.status = 'ready';
+        this.spawnedAgents.set(agentId, agent);
+        return agent;
+    }
+    /**
+     * Open a Chain of Collaboration for the team.
+     */
+    async openChain(team, routing) {
+        const chainId = `coc_${ulid()}`;
+        this.storage.createChain(chainId, team.roomId, team.request.goal, null, team.request.callerDid || 'system', team.request.priority || 'normal');
+        // Create steps for each role
+        for (let i = 0; i < team.agents.length; i++) {
+            const agent = team.agents[i];
+            const stepId = `step_${ulid()}`;
+            this.storage.createStep(stepId, chainId, agent.role.kind, agent.role.role, `${agent.role.taskType} task for ${agent.role.role}`, i > 0 ? [`step_${team.agents[i - 1].id}`] : []);
+        }
+        return chainId;
+    }
+    /**
+     * Execute the team's tasks using Ollama or other runtimes.
+     */
+    async executeTeam(team) {
+        const results = new Map();
+        // Get steps for the chain
+        const chain = this.storage.getChain(team.chainId);
+        if (!chain)
+            throw new Error(`Chain ${team.chainId} not found`);
+        const steps = this.storage.getChainSteps(team.chainId);
+        // Execute steps - sequentially for now (parallel for independent steps later)
+        let previousResult = '';
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const agent = team.agents[i];
+            if (!agent)
+                continue;
+            agent.status = 'working';
+            this.emit('agent:working', {
+                teamId: team.teamId,
+                agentId: agent.id,
+                stepId: step.step_id,
+            });
+            try {
+                const result = await this.executeAgentTask(agent, team.request.goal, step, previousResult);
+                results.set(agent.role.role, result);
+                previousResult = typeof result === 'string' ? result : JSON.stringify(result);
+                agent.status = 'done';
+                // Record success in swarm
+                this.swarm.recordTaskOutcome(agent.did, agent.role.taskType, true);
+                this.emit('agent:done', {
+                    teamId: team.teamId,
+                    agentId: agent.id,
+                    role: agent.role.role,
+                });
+            }
+            catch (error) {
+                agent.status = 'failed';
+                this.swarm.recordTaskOutcome(agent.did, agent.role.taskType, false);
+                results.set(agent.role.role, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                this.emit('agent:failed', {
+                    teamId: team.teamId,
+                    agentId: agent.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute a single agent's task against Ollama or other runtime.
+     */
+    async executeAgentTask(agent, goal, step, previousContext) {
+        const prompt = this.buildAgentPrompt(agent, goal, step, previousContext);
+        switch (agent.runtime) {
+            case 'ollama':
+                return this.callOllama(prompt);
+            case 'http':
+                return this.callHttp(agent, prompt);
+            default:
+                return this.callOllama(prompt);
+        }
+    }
+    /**
+     * Build a prompt for an agent based on its role and context.
+     */
+    buildAgentPrompt(agent, goal, step, previousContext) {
+        const parts = [
+            `You are a specialized AI agent with the role: ${agent.role.role}`,
+            `Your task type: ${agent.role.taskType}`,
+            `Your capabilities: ${agent.role.capabilities.join(', ')}`,
+            '',
+            `## Goal`,
+            goal,
+            '',
+            `## Your Step`,
+            `Title: ${step.title || agent.role.role}`,
+            `Kind: ${step.kind || agent.role.kind}`,
+        ];
+        if (previousContext) {
+            parts.push('', '## Previous Context (from other agents)', previousContext);
+        }
+        parts.push('', '## Instructions', `Complete your part of the task. Be specific and concise.`, `Focus on your role as ${agent.role.role}.`, `Respond with your findings/results directly.`);
+        return parts.join('\n');
+    }
+    /**
+     * Call Ollama API to execute a task.
+     */
+    async callOllama(prompt) {
+        const response = await fetch(`${this.config.ollamaUrl}/api/generate`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: this.config.ollamaModel,
+                prompt,
+                stream: false,
+            }),
+            signal: AbortSignal.timeout(this.config.taskTimeoutMs),
+        });
+        if (!response.ok) {
+            throw new Error(`Ollama error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data?.response || '';
+    }
+    /**
+     * Call an HTTP endpoint for existing agents.
+     */
+    async callHttp(agent, prompt) {
+        if (!agent.endpoint) {
+            // Fallback to Ollama for agents without endpoints
+            return this.callOllama(prompt);
+        }
+        const response = await fetch(agent.endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt, role: agent.role.role }),
+            signal: AbortSignal.timeout(this.config.taskTimeoutMs),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP agent error: ${response.status}`);
+        }
+        const data = await response.json();
+        return data?.result || data?.response || JSON.stringify(data);
+    }
+    /**
+     * Dissolve ephemeral agents after task completion.
+     * IoA-inspired: ephemeral teams are assembled and dissolved per request.
+     */
+    async dissolveTeam(team) {
+        for (const agent of team.agents) {
+            if (this.spawnedAgents.has(agent.id)) {
+                agent.status = 'dissolved';
+                agent.dissolvedAt = Date.now();
+                // Kill process if any
+                if (agent.process) {
+                    agent.process.kill('SIGTERM');
+                }
+                this.spawnedAgents.delete(agent.id);
+                this.emit('agent:dissolved', {
+                    teamId: team.teamId,
+                    agentId: agent.id,
+                    role: agent.role.role,
+                    lifespan: Date.now() - agent.createdAt,
+                });
+            }
+        }
+        team.status = 'dissolved';
+    }
+    // ─── Public API ──────────────────────────────────────────────
+    /** Get the capability router instance */
+    getRouter() {
+        return this.router;
+    }
+    /** Get the swarm controller instance */
+    getSwarm() {
+        return this.swarm;
+    }
+    /** Get active teams */
+    getActiveTeams() {
+        return [...this.teams.values()].filter(t => t.status === 'assembling' || t.status === 'working');
+    }
+    /** Get team by ID */
+    getTeam(teamId) {
+        return this.teams.get(teamId);
+    }
+    /** Get all spawned agents */
+    getSpawnedAgents() {
+        return [...this.spawnedAgents.values()];
+    }
+    /** Get spawn config */
+    getConfig() {
+        return { ...this.config };
+    }
+    /** Update spawn config */
+    updateConfig(updates) {
+        Object.assign(this.config, updates);
+    }
+    /** Clean up */
+    destroy() {
+        for (const agent of this.spawnedAgents.values()) {
+            if (agent.process) {
+                agent.process.kill('SIGTERM');
+            }
+        }
+        this.spawnedAgents.clear();
+        this.teams.clear();
+        this.swarm.destroy();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=demand-spawner.js.map

package/dist/gateway/demand-spawner.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Society Protocol — Identity Module
+ *
+ * Ed25519 keypair generation, did:key derivation, message signing/verification.
+ * Uses @noble/ed25519 for cryptography.
+ */
+export interface Identity {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+    did: string;
+    displayName: string;
+}
+/**
+ * Generate a new Ed25519 identity with a did:key identifier.
+ *
+ * did:key format: did:key:z6Mk<base58btc(0xed01 + pubkey)>
+ * The 0xed01 prefix is the multicodec for Ed25519 public keys.
+ */
+export declare function generateIdentity(displayName: string): Identity;
+/**
+ * Restore an identity from stored keys.
+ */
+export declare function restoreIdentity(privateKeyHex: string, displayName: string): Identity;
+/**
+ * Canonical JSON serialization (sorted keys, no whitespace).
+ * This ensures deterministic serialization for signing.
+ */
+export declare function canonicalJson(obj: unknown): string;
+/**
+ * Deep canonical JSON serialization (recursively sorts all nested objects).
+ */
+export declare function deepCanonicalJson(obj: unknown): string;
+/**
+ * Sign a message (canonical JSON bytes) with the identity's private key.
+ * Returns base64-encoded signature.
+ */
+export declare function sign(identity: Identity, message: string): string;
+/**
+ * Verify a signature against a message and public key.
+ */
+export declare function verify(publicKey: Uint8Array, message: string, signatureBase64: string): boolean;
+/**
+ * Extract public key bytes from a did:key string.
+ */
+export declare function publicKeyFromDid(did: string): Uint8Array;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,QAAQ;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAa9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GACpB,QAAQ,CAYV;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAWtD;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAClB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACxB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAWxD"}

package/dist/identity.js

@@ -0,0 +1,102 @@
+/**
+ * Society Protocol — Identity Module
+ *
+ * Ed25519 keypair generation, did:key derivation, message signing/verification.
+ * Uses @noble/ed25519 for cryptography.
+ */
+import * as ed from '@noble/ed25519';
+import { sha512 } from '@noble/hashes/sha512';
+import { base58btc } from 'multiformats/bases/base58';
+import { toString as uint8ToString, fromString as uint8FromString } from 'uint8arrays';
+// Configure ed25519 to use sha512
+ed.etc.sha512Sync = (...m) => {
+    const h = sha512.create();
+    for (const msg of m)
+        h.update(msg);
+    return h.digest();
+};
+/**
+ * Generate a new Ed25519 identity with a did:key identifier.
+ *
+ * did:key format: did:key:z6Mk<base58btc(0xed01 + pubkey)>
+ * The 0xed01 prefix is the multicodec for Ed25519 public keys.
+ */
+export function generateIdentity(displayName) {
+    const privateKey = ed.utils.randomPrivateKey();
+    const publicKey = ed.getPublicKey(privateKey);
+    // Build did:key: multicodec prefix 0xed01 + public key
+    const multicodecPrefixed = new Uint8Array(2 + publicKey.length);
+    multicodecPrefixed[0] = 0xed;
+    multicodecPrefixed[1] = 0x01;
+    multicodecPrefixed.set(publicKey, 2);
+    const did = `did:key:${base58btc.encode(multicodecPrefixed)}`;
+    return { privateKey, publicKey, did, displayName };
+}
+/**
+ * Restore an identity from stored keys.
+ */
+export function restoreIdentity(privateKeyHex, displayName) {
+    const privateKey = uint8FromString(privateKeyHex, 'base16');
+    const publicKey = ed.getPublicKey(privateKey);
+    const multicodecPrefixed = new Uint8Array(2 + publicKey.length);
+    multicodecPrefixed[0] = 0xed;
+    multicodecPrefixed[1] = 0x01;
+    multicodecPrefixed.set(publicKey, 2);
+    const did = `did:key:${base58btc.encode(multicodecPrefixed)}`;
+    return { privateKey, publicKey, did, displayName };
+}
+/**
+ * Canonical JSON serialization (sorted keys, no whitespace).
+ * This ensures deterministic serialization for signing.
+ */
+export function canonicalJson(obj) {
+    return JSON.stringify(obj, Object.keys(obj).sort());
+}
+/**
+ * Deep canonical JSON serialization (recursively sorts all nested objects).
+ */
+export function deepCanonicalJson(obj) {
+    if (obj === null || obj === undefined)
+        return JSON.stringify(obj);
+    if (typeof obj !== 'object')
+        return JSON.stringify(obj);
+    if (Array.isArray(obj)) {
+        return '[' + obj.map(deepCanonicalJson).join(',') + ']';
+    }
+    const sorted = Object.keys(obj).sort();
+    const pairs = sorted.map((k) => `${JSON.stringify(k)}:${deepCanonicalJson(obj[k])}`);
+    return '{' + pairs.join(',') + '}';
+}
+/**
+ * Sign a message (canonical JSON bytes) with the identity's private key.
+ * Returns base64-encoded signature.
+ */
+export function sign(identity, message) {
+    const msgBytes = new TextEncoder().encode(message);
+    const sig = ed.sign(msgBytes, identity.privateKey);
+    return uint8ToString(sig, 'base64');
+}
+/**
+ * Verify a signature against a message and public key.
+ */
+export function verify(publicKey, message, signatureBase64) {
+    const msgBytes = new TextEncoder().encode(message);
+    const sig = uint8FromString(signatureBase64, 'base64');
+    return ed.verify(sig, msgBytes, publicKey);
+}
+/**
+ * Extract public key bytes from a did:key string.
+ */
+export function publicKeyFromDid(did) {
+    if (!did.startsWith('did:key:z')) {
+        throw new Error(`Invalid did:key format: ${did}`);
+    }
+    const multibase = did.slice('did:key:'.length);
+    const decoded = base58btc.decode(multibase);
+    // Skip 2-byte multicodec prefix (0xed 0x01)
+    if (decoded[0] !== 0xed || decoded[1] !== 0x01) {
+        throw new Error('Not an Ed25519 did:key');
+    }
+    return decoded.slice(2);
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/identity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.test.d.ts.map

package/dist/identity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.d.ts","sourceRoot":"","sources":["../src/identity.test.ts"],"names":[],"mappings":""}

package/dist/identity.test.js

@@ -0,0 +1,45 @@
+import { describe, it, expect } from 'vitest';
+import { generateIdentity, sign, verify, publicKeyFromDid, canonicalJson } from './identity.js';
+describe('Identity Module', () => {
+    it('generates a valid Ed25519 identity and did:key', () => {
+        const id = generateIdentity('Alice');
+        expect(id).toHaveProperty('privateKey');
+        expect(id).toHaveProperty('publicKey');
+        expect(id).toHaveProperty('did');
+        expect(id.displayName).toBe('Alice');
+        expect(id.did.startsWith('did:key:z6Mk')).toBe(true);
+    });
+    it('signs and verifies a string message successfully', () => {
+        const id = generateIdentity('Alice');
+        const message = "Hello World";
+        const signature = sign(id, message);
+        expect(typeof signature).toBe('string');
+        // Should verify correctly
+        const isValid = verify(id.publicKey, message, signature);
+        expect(isValid).toBe(true);
+    });
+    it('validates canonical JSON sorting', () => {
+        const payload1 = { b: 2, a: 1 };
+        const payload2 = { a: 1, b: 2 };
+        expect(canonicalJson(payload1)).toBe(canonicalJson(payload2));
+    });
+    it('rejects an invalid signature or tampered payload', () => {
+        const id = generateIdentity('Alice');
+        const message = "Original";
+        const signature = sign(id, message);
+        // Tamper with payload
+        const tamperedMessage = "Hacked";
+        const isValid = verify(id.publicKey, tamperedMessage, signature);
+        expect(isValid).toBe(false);
+        // Tamper with signature (middle modification keeps valid base64 padding)
+        const badSig = signature.slice(0, 10) + (signature[10] === 'A' ? 'B' : 'A') + signature.slice(11);
+        const isBadSigValid = verify(id.publicKey, message, badSig);
+        expect(isBadSigValid).toBe(false);
+    });
+    it('extracts public key bytes from a did:key', () => {
+        const id = generateIdentity('Alice');
+        const extracted = publicKeyFromDid(id.did);
+        expect(extracted).toEqual(id.publicKey);
+    });
+});
+//# sourceMappingURL=identity.test.js.map

package/dist/identity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.js","sourceRoot":"","sources":["../src/identity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhG,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,aAAa,CAAC;QAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExC,0BAA0B;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAEhC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAEpC,sBAAsB;QACtB,MAAM,eAAe,GAAG,QAAQ,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE5B,yEAAyE;QACzE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}