@vorionsys/runtime 0.1.0

package/dist/proof-committer/index.js

@@ -0,0 +1,252 @@
+/**
+ * ProofCommitter - Zero-Latency Proof System
+ *
+ * Synchronous hash commitment (<1ms) with async batch processing.
+ * Uses Merkle trees for batch integrity and optional Ed25519 signing.
+ *
+ * @packageDocumentation
+ */
+import * as crypto from 'node:crypto';
+import { createLogger } from '../common/logger.js';
+import { DEFAULT_PROOF_COMMITTER_CONFIG, InMemoryProofStore } from './types.js';
+export * from './types.js';
+const logger = createLogger({ component: 'proof-committer' });
+/**
+ * ProofCommitter - Fast synchronous commitment with async persistence
+ */
+export class ProofCommitter {
+    config;
+    buffer = [];
+    store;
+    flushTimer = null;
+    privateKey = null;
+    isFlushing = false;
+    pendingFlush = null;
+    // Metrics
+    totalCommitments = 0;
+    totalBatches = 0;
+    totalFlushTimeMs = 0;
+    constructor(config, store) {
+        this.config = { ...DEFAULT_PROOF_COMMITTER_CONFIG, ...config };
+        this.store = store ?? new InMemoryProofStore();
+        // Load signing key if provided
+        if (this.config.enableSigning && this.config.privateKey) {
+            try {
+                this.privateKey = crypto.createPrivateKey({
+                    key: Buffer.from(this.config.privateKey, 'base64'),
+                    format: 'der',
+                    type: 'pkcs8',
+                });
+                logger.info('Signing key loaded');
+            }
+            catch (error) {
+                logger.error({ error }, 'Failed to load signing key');
+                throw new Error('Invalid signing key');
+            }
+        }
+        // Start flush timer
+        this.startFlushTimer();
+        logger.info({ config: this.config }, 'ProofCommitter initialized');
+    }
+    /**
+     * Commit an event - MUST complete in <1ms
+     *
+     * This is the HOT PATH - synchronous, fast
+     */
+    commit(event) {
+        const startTime = performance.now();
+        const commitment = {
+            id: crypto.randomUUID(),
+            hash: this.fastHash(event),
+            timestamp: Date.now(),
+            event,
+        };
+        this.buffer.push(commitment);
+        this.totalCommitments++;
+        // Trigger async flush if buffer full
+        if (this.buffer.length >= this.config.maxBufferSize) {
+            setImmediate(() => this.flush());
+        }
+        const latencyMs = performance.now() - startTime;
+        // Warn if we exceeded 1ms
+        if (latencyMs > 1) {
+            logger.warn({ latencyMs, commitmentId: commitment.id }, 'Commitment exceeded 1ms target');
+        }
+        return commitment.id;
+    }
+    /**
+     * Fast hash - SHA-256, no signing, ~0.1ms
+     */
+    fastHash(event) {
+        const hash = crypto.createHash('sha256');
+        hash.update(JSON.stringify(event));
+        return hash.digest('hex');
+    }
+    /**
+     * Flush buffer to proof store (COLD PATH - async)
+     */
+    async flush() {
+        // Prevent concurrent flushes
+        if (this.isFlushing) {
+            return this.pendingFlush ?? Promise.resolve();
+        }
+        if (this.buffer.length === 0) {
+            return;
+        }
+        this.isFlushing = true;
+        const startTime = performance.now();
+        // Take current buffer and reset
+        const batch = this.buffer.splice(0, this.buffer.length);
+        this.pendingFlush = (async () => {
+            try {
+                // Build Merkle tree
+                const merkleRoot = this.buildMerkleRoot(batch.map((c) => c.hash));
+                // Sign if enabled
+                const signature = this.sign(merkleRoot);
+                // Create batch
+                const proofBatch = {
+                    batchId: crypto.randomUUID(),
+                    merkleRoot,
+                    signature,
+                    commitments: batch,
+                    createdAt: new Date(),
+                    eventCount: batch.length,
+                };
+                // Persist to store
+                await this.store.writeBatch(proofBatch);
+                this.totalBatches++;
+                const flushTimeMs = performance.now() - startTime;
+                this.totalFlushTimeMs += flushTimeMs;
+                logger.debug({
+                    batchId: proofBatch.batchId,
+                    eventCount: batch.length,
+                    merkleRoot: merkleRoot.substring(0, 16) + '...',
+                    flushTimeMs,
+                }, 'Batch flushed');
+            }
+            catch (error) {
+                // On error, put events back in buffer (don't lose them)
+                this.buffer.unshift(...batch);
+                logger.error({ error, eventCount: batch.length }, 'Flush failed, events returned to buffer');
+                throw error;
+            }
+            finally {
+                this.isFlushing = false;
+                this.pendingFlush = null;
+            }
+        })();
+        return this.pendingFlush;
+    }
+    /**
+     * Build Merkle root from hashes
+     */
+    buildMerkleRoot(hashes) {
+        if (hashes.length === 0) {
+            return '0'.repeat(64);
+        }
+        if (hashes.length === 1) {
+            return hashes[0];
+        }
+        // Pad to even number
+        const leaves = [...hashes];
+        if (leaves.length % 2 !== 0) {
+            leaves.push(leaves[leaves.length - 1]);
+        }
+        // Build tree bottom-up
+        while (leaves.length > 1) {
+            const newLevel = [];
+            for (let i = 0; i < leaves.length; i += 2) {
+                const left = leaves[i];
+                const right = leaves[i + 1] ?? left;
+                const combined = crypto.createHash('sha256').update(left + right).digest('hex');
+                newLevel.push(combined);
+            }
+            leaves.length = 0;
+            leaves.push(...newLevel);
+        }
+        return leaves[0];
+    }
+    /**
+     * Sign data with Ed25519 (if enabled)
+     */
+    sign(data) {
+        if (!this.privateKey) {
+            return '';
+        }
+        const signature = crypto.sign(null, Buffer.from(data), this.privateKey);
+        return signature.toString('base64');
+    }
+    /**
+     * Start periodic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            if (this.buffer.length > 0) {
+                this.flush().catch((error) => {
+                    logger.error({ error }, 'Periodic flush failed');
+                });
+            }
+        }, this.config.flushIntervalMs);
+        // Don't block process exit
+        this.flushTimer.unref();
+    }
+    /**
+     * Stop the committer (flush remaining and cleanup)
+     */
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Final flush
+        await this.flush();
+        logger.info({
+            totalCommitments: this.totalCommitments,
+            totalBatches: this.totalBatches,
+            avgFlushTimeMs: this.totalBatches > 0 ? this.totalFlushTimeMs / this.totalBatches : 0,
+        }, 'ProofCommitter stopped');
+    }
+    /**
+     * Get current buffer size
+     */
+    getBufferSize() {
+        return this.buffer.length;
+    }
+    /**
+     * Get metrics
+     */
+    getMetrics() {
+        return {
+            totalCommitments: this.totalCommitments,
+            totalBatches: this.totalBatches,
+            avgFlushTimeMs: this.totalBatches > 0 ? this.totalFlushTimeMs / this.totalBatches : 0,
+            bufferSize: this.buffer.length,
+        };
+    }
+    /**
+     * Get commitment by ID (from store)
+     */
+    async getCommitment(commitmentId) {
+        return this.store.getCommitment(commitmentId);
+    }
+    /**
+     * Get all commitments for an entity
+     */
+    async getCommitmentsForEntity(entityId) {
+        return this.store.getCommitmentsForEntity(entityId);
+    }
+    /**
+     * Verify a commitment's hash
+     */
+    verifyCommitment(commitment) {
+        const expectedHash = this.fastHash(commitment.event);
+        return commitment.hash === expectedHash;
+    }
+}
+/**
+ * Create a new ProofCommitter instance
+ */
+export function createProofCommitter(config, store) {
+    return new ProofCommitter(config, store);
+}
+//# sourceMappingURL=index.js.map

package/dist/proof-committer/index.js.map

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

package/dist/proof-committer/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ProofCommitter Types
+ *
+ * Zero-latency proof design with async batching.
+ * Synchronous hash commitment (<1ms) with async batch processing.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Event types that can be recorded in the proof plane
+ */
+export type ProofEventType = 'intent_submitted' | 'decision_made' | 'execution_started' | 'execution_completed' | 'trust_signal' | 'agent_admitted' | 'agent_revoked' | 'parity_violation';
+/**
+ * A proof event to be committed
+ */
+export interface ProofEvent {
+    /** Event type */
+    type: ProofEventType;
+    /** Entity ID (agent, intent, etc.) */
+    entityId: string;
+    /** Event payload */
+    payload: Record<string, unknown>;
+    /** Timestamp */
+    timestamp: number;
+    /** Optional correlation ID for linking events */
+    correlationId?: string;
+}
+/**
+ * A commitment in the buffer
+ */
+export interface ProofCommitment {
+    /** Unique commitment ID */
+    id: string;
+    /** SHA-256 hash of the event */
+    hash: string;
+    /** Timestamp when committed */
+    timestamp: number;
+    /** The original event (held until flushed) */
+    event: ProofEvent;
+}
+/**
+ * A batch of commitments ready for persistence
+ */
+export interface ProofBatch {
+    /** Unique batch ID */
+    batchId: string;
+    /** Merkle root of all commitments */
+    merkleRoot: string;
+    /** Ed25519 signature of merkle root */
+    signature: string;
+    /** All commitments in this batch */
+    commitments: ProofCommitment[];
+    /** When batch was created */
+    createdAt: Date;
+    /** Number of events in batch */
+    eventCount: number;
+}
+/**
+ * Configuration for ProofCommitter
+ */
+export interface ProofCommitterConfig {
+    /** Maximum buffer size before auto-flush */
+    maxBufferSize: number;
+    /** Flush interval in milliseconds */
+    flushIntervalMs: number;
+    /** Enable signing (requires private key) */
+    enableSigning: boolean;
+    /** Private key for signing (base64-encoded Ed25519) */
+    privateKey?: string;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_PROOF_COMMITTER_CONFIG: ProofCommitterConfig;
+/**
+ * Proof store interface for persistence
+ */
+export interface ProofStore {
+    /** Write a batch to storage */
+    writeBatch(batch: ProofBatch): Promise<void>;
+    /** Get a batch by ID */
+    getBatch(batchId: string): Promise<ProofBatch | null>;
+    /** Get commitment by ID */
+    getCommitment(commitmentId: string): Promise<ProofCommitment | null>;
+    /** Get all commitments for an entity */
+    getCommitmentsForEntity(entityId: string): Promise<ProofCommitment[]>;
+}
+/**
+ * In-memory proof store for testing/development
+ */
+export declare class InMemoryProofStore implements ProofStore {
+    private batches;
+    private commitments;
+    private entityIndex;
+    writeBatch(batch: ProofBatch): Promise<void>;
+    getBatch(batchId: string): Promise<ProofBatch | null>;
+    getCommitment(commitmentId: string): Promise<ProofCommitment | null>;
+    getCommitmentsForEntity(entityId: string): Promise<ProofCommitment[]>;
+    /** Get stats for testing */
+    getStats(): {
+        batches: number;
+        commitments: number;
+    };
+    /** Clear all data */
+    clear(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/proof-committer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proof-committer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACtD,2BAA2B;IAC3B,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrE,wCAAwC;IACxC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,WAAW,CAAoC;IAEjD,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIrD,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIpE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK3E,4BAA4B;IAC5B,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAOpD,qBAAqB;IACrB,KAAK,IAAI,IAAI;CAKd"}

package/dist/proof-committer/types.js

@@ -0,0 +1,58 @@
+/**
+ * ProofCommitter Types
+ *
+ * Zero-latency proof design with async batching.
+ * Synchronous hash commitment (<1ms) with async batch processing.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Default configuration
+ */
+export const DEFAULT_PROOF_COMMITTER_CONFIG = {
+    maxBufferSize: 100,
+    flushIntervalMs: 100,
+    enableSigning: false,
+};
+/**
+ * In-memory proof store for testing/development
+ */
+export class InMemoryProofStore {
+    batches = new Map();
+    commitments = new Map();
+    entityIndex = new Map();
+    async writeBatch(batch) {
+        this.batches.set(batch.batchId, batch);
+        for (const commitment of batch.commitments) {
+            this.commitments.set(commitment.id, commitment);
+            // Index by entity
+            const entityCommitments = this.entityIndex.get(commitment.event.entityId) ?? [];
+            entityCommitments.push(commitment.id);
+            this.entityIndex.set(commitment.event.entityId, entityCommitments);
+        }
+    }
+    async getBatch(batchId) {
+        return this.batches.get(batchId) ?? null;
+    }
+    async getCommitment(commitmentId) {
+        return this.commitments.get(commitmentId) ?? null;
+    }
+    async getCommitmentsForEntity(entityId) {
+        const ids = this.entityIndex.get(entityId) ?? [];
+        return ids.map((id) => this.commitments.get(id)).filter(Boolean);
+    }
+    /** Get stats for testing */
+    getStats() {
+        return {
+            batches: this.batches.size,
+            commitments: this.commitments.size,
+        };
+    }
+    /** Clear all data */
+    clear() {
+        this.batches.clear();
+        this.commitments.clear();
+        this.entityIndex.clear();
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/proof-committer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/proof-committer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6EH;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,aAAa,EAAE,GAAG;IAClB,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;AAgBF;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAC7C,WAAW,GAAiC,IAAI,GAAG,EAAE,CAAC;IACtD,WAAW,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEvD,KAAK,CAAC,UAAU,CAAC,KAAiB;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEvC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAEhD,kBAAkB;YAClB,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChF,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,YAAoB;QACtC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,QAAgB;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,4BAA4B;IAC5B,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;SACnC,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/stores/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Persistent Stores
+ *
+ * SQLite-based persistence for proofs and trust data.
+ *
+ * @packageDocumentation
+ */
+export * from './sqlite-proof-store.js';
+export * from './sqlite-trust-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/stores/index.js

@@ -0,0 +1,10 @@
+/**
+ * Persistent Stores
+ *
+ * SQLite-based persistence for proofs and trust data.
+ *
+ * @packageDocumentation
+ */
+export * from './sqlite-proof-store.js';
+export * from './sqlite-trust-store.js';
+//# sourceMappingURL=index.js.map

package/dist/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/stores/sqlite-proof-store.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SQLite Proof Store
+ *
+ * Persistent storage for proof commitments and batches using SQLite.
+ *
+ * @packageDocumentation
+ */
+import type { ProofStore, ProofBatch, ProofCommitment } from '../proof-committer/types.js';
+export interface SQLiteProofStoreConfig {
+    /** Database file path (use ':memory:' for in-memory) */
+    dbPath: string;
+    /** Enable WAL mode for better concurrency (default: true) */
+    walMode?: boolean;
+}
+/**
+ * SQLite implementation of ProofStore
+ */
+export declare class SQLiteProofStore implements ProofStore {
+    private db;
+    private config;
+    private stmts;
+    constructor(config: SQLiteProofStoreConfig);
+    private initializeSchema;
+    private prepareStatements;
+    /**
+     * Write a batch to storage
+     */
+    writeBatch(batch: ProofBatch): Promise<void>;
+    /**
+     * Get a batch by ID
+     */
+    getBatch(batchId: string): Promise<ProofBatch | null>;
+    /**
+     * Get commitment by ID
+     */
+    getCommitment(commitmentId: string): Promise<ProofCommitment | null>;
+    /**
+     * Get all commitments for an entity
+     */
+    getCommitmentsForEntity(entityId: string): Promise<ProofCommitment[]>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        batches: number;
+        commitments: number;
+    };
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+}
+/**
+ * Create a new SQLite proof store
+ */
+export declare function createSQLiteProofStore(config: SQLiteProofStoreConfig): SQLiteProofStore;
+//# sourceMappingURL=sqlite-proof-store.d.ts.map

package/dist/stores/sqlite-proof-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-proof-store.d.ts","sourceRoot":"","sources":["../../src/stores/sqlite-proof-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAA8B,MAAM,6BAA6B,CAAC;AAIvH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAyB;IAGvC,OAAO,CAAC,KAAK,CAMG;gBAEJ,MAAM,EAAE,sBAAsB;IAmB1C,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmD3D;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA6B1E;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA2B3E;;OAEG;IACH,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAUpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAEvF"}