@ninebix/nmt-system 1.0.0

package/dist/src/services/verify.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Verification Service - Data integrity verification
+ * @module services/verify
+ */
+import type { UUID, MerkleProof, SHA3Hash, IChunkStore, INeuronStore } from '../types/index.js';
+import { MerkleEngine } from '../core/merkle-engine.js';
+/**
+ * Verification result
+ */
+export interface VerificationResult {
+    valid: boolean;
+    neuronId: UUID;
+    merkleRoot: string;
+    errors: string[];
+    details: {
+        chunksVerified: number;
+        chunksFailed: number;
+        merkleValid: boolean;
+        embeddingValid: boolean;
+    };
+}
+/**
+ * Chunk verification result
+ */
+export interface ChunkVerificationResult {
+    hash: SHA3Hash;
+    valid: boolean;
+    exists: boolean;
+    integrityPassed: boolean;
+}
+/**
+ * Proof verification options
+ */
+export interface ProofVerifyOptions {
+    verifyChunkData?: boolean;
+}
+/**
+ * Verification Service
+ */
+export declare class VerificationService {
+    private merkleEngine;
+    private chunkStore;
+    private neuronStore;
+    constructor(merkleEngine: MerkleEngine, chunkStore: IChunkStore, neuronStore: INeuronStore);
+    /**
+     * Verify complete neuron integrity
+     */
+    verifyNeuron(neuronId: UUID): Promise<VerificationResult>;
+    /**
+     * Verify a single chunk
+     */
+    verifyChunk(chunkHash: SHA3Hash): Promise<ChunkVerificationResult>;
+    /**
+     * Verify Merkle root matches chunk hashes
+     */
+    verifyMerkleRoot(chunkHashes: SHA3Hash[], expectedRoot: string): Promise<boolean>;
+    /**
+     * Verify a Merkle proof
+     */
+    verifyProof(proof: MerkleProof): boolean;
+    /**
+     * Verify proof with explicit values
+     */
+    verifyProofWithValues(proof: MerkleProof, expectedRoot: string, expectedLeaf: SHA3Hash): boolean;
+    /**
+     * Generate and verify proof for a specific chunk
+     */
+    generateAndVerifyProof(neuronId: UUID, chunkIndex: number, options?: ProofVerifyOptions): Promise<{
+        proof: MerkleProof | null;
+        valid: boolean;
+        chunkValid?: boolean;
+    }>;
+    /**
+     * Verify all neurons in the store
+     */
+    verifyAll(): Promise<{
+        total: number;
+        valid: number;
+        invalid: number;
+        results: VerificationResult[];
+    }>;
+    /**
+     * Verify chunk store integrity
+     */
+    verifyChunkStore(): Promise<{
+        total: number;
+        valid: number;
+        corrupted: SHA3Hash[];
+        missing: SHA3Hash[];
+    }>;
+    /**
+     * Verify data against expected hash
+     */
+    verifyData(data: Buffer | string, expectedHash: SHA3Hash): boolean;
+    /**
+     * Compute hash for data
+     */
+    computeHash(data: Buffer | string): SHA3Hash;
+    /**
+     * Get verification summary for a neuron
+     */
+    getVerificationSummary(neuronId: UUID): Promise<{
+        exists: boolean;
+        merkleRoot?: string;
+        chunkCount?: number;
+        allChunksExist?: boolean;
+        merkleValid?: boolean;
+    }>;
+}
+/**
+ * Create a VerificationService instance
+ */
+export declare function createVerificationService(merkleEngine: MerkleEngine, chunkStore: IChunkStore, neuronStore: INeuronStore): VerificationService;
+//# sourceMappingURL=verify.d.ts.map

package/dist/src/services/verify.d.ts.map

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

package/dist/src/services/verify.js

@@ -0,0 +1,237 @@
+/**
+ * Verification Service - Data integrity verification
+ * @module services/verify
+ */
+import { hash, verifyHash } from '../utils/hash.js';
+/**
+ * Verification Service
+ */
+export class VerificationService {
+    merkleEngine;
+    chunkStore;
+    neuronStore;
+    constructor(merkleEngine, chunkStore, neuronStore) {
+        this.merkleEngine = merkleEngine;
+        this.chunkStore = chunkStore;
+        this.neuronStore = neuronStore;
+    }
+    /**
+     * Verify complete neuron integrity
+     */
+    async verifyNeuron(neuronId) {
+        const neuron = await this.neuronStore.getNeuron(neuronId);
+        if (!neuron) {
+            return {
+                valid: false,
+                neuronId,
+                merkleRoot: '',
+                errors: ['Neuron not found'],
+                details: {
+                    chunksVerified: 0,
+                    chunksFailed: 0,
+                    merkleValid: false,
+                    embeddingValid: false
+                }
+            };
+        }
+        const errors = [];
+        let chunksVerified = 0;
+        let chunksFailed = 0;
+        // Verify each chunk
+        for (const chunkHash of neuron.chunkHashes) {
+            const result = await this.verifyChunk(chunkHash);
+            if (result.valid) {
+                chunksVerified++;
+            }
+            else {
+                chunksFailed++;
+                if (!result.exists) {
+                    errors.push(`Chunk missing: ${chunkHash}`);
+                }
+                else if (!result.integrityPassed) {
+                    errors.push(`Chunk corrupted: ${chunkHash}`);
+                }
+            }
+        }
+        // Verify Merkle root
+        const merkleValid = await this.verifyMerkleRoot(neuron.chunkHashes, neuron.merkleRoot);
+        if (!merkleValid) {
+            errors.push('Merkle root verification failed');
+        }
+        // Verify embedding exists and has correct dimension
+        const embeddingValid = neuron.embedding instanceof Float32Array &&
+            neuron.embedding.length === 384;
+        if (!embeddingValid) {
+            errors.push('Invalid embedding dimension');
+        }
+        return {
+            valid: errors.length === 0,
+            neuronId,
+            merkleRoot: neuron.merkleRoot,
+            errors,
+            details: {
+                chunksVerified,
+                chunksFailed,
+                merkleValid,
+                embeddingValid
+            }
+        };
+    }
+    /**
+     * Verify a single chunk
+     */
+    async verifyChunk(chunkHash) {
+        const exists = await this.chunkStore.has(chunkHash);
+        if (!exists) {
+            return {
+                hash: chunkHash,
+                valid: false,
+                exists: false,
+                integrityPassed: false
+            };
+        }
+        const chunk = await this.chunkStore.get(chunkHash);
+        if (!chunk) {
+            return {
+                hash: chunkHash,
+                valid: false,
+                exists: true,
+                integrityPassed: false
+            };
+        }
+        const integrityPassed = verifyHash(chunk.data, chunkHash);
+        return {
+            hash: chunkHash,
+            valid: integrityPassed,
+            exists: true,
+            integrityPassed
+        };
+    }
+    /**
+     * Verify Merkle root matches chunk hashes
+     */
+    async verifyMerkleRoot(chunkHashes, expectedRoot) {
+        if (chunkHashes.length === 0)
+            return false;
+        const tree = this.merkleEngine.buildTree(chunkHashes);
+        return tree.root === expectedRoot;
+    }
+    /**
+     * Verify a Merkle proof
+     */
+    verifyProof(proof) {
+        return this.merkleEngine.verifyProof(proof);
+    }
+    /**
+     * Verify proof with explicit values
+     */
+    verifyProofWithValues(proof, expectedRoot, expectedLeaf) {
+        return this.merkleEngine.verifyProofWithValues(proof, expectedRoot, expectedLeaf);
+    }
+    /**
+     * Generate and verify proof for a specific chunk
+     */
+    async generateAndVerifyProof(neuronId, chunkIndex, options = {}) {
+        const neuron = await this.neuronStore.getNeuron(neuronId);
+        if (!neuron || chunkIndex < 0 || chunkIndex >= neuron.chunkHashes.length) {
+            return { proof: null, valid: false };
+        }
+        // Build tree and generate proof
+        const tree = this.merkleEngine.buildTree(neuron.chunkHashes);
+        const proof = this.merkleEngine.generateProof(tree, chunkIndex);
+        // Verify proof
+        const valid = this.merkleEngine.verifyProof(proof);
+        const result = {
+            proof,
+            valid
+        };
+        // Optionally verify chunk data
+        if (options.verifyChunkData) {
+            const chunkHash = neuron.chunkHashes[chunkIndex];
+            const chunkResult = await this.verifyChunk(chunkHash);
+            result.chunkValid = chunkResult.valid;
+        }
+        return result;
+    }
+    /**
+     * Verify all neurons in the store
+     */
+    async verifyAll() {
+        const allIds = await this.neuronStore.getAllNeuronIds();
+        const results = [];
+        let valid = 0;
+        let invalid = 0;
+        for (const id of allIds) {
+            const result = await this.verifyNeuron(id);
+            results.push(result);
+            if (result.valid) {
+                valid++;
+            }
+            else {
+                invalid++;
+            }
+        }
+        return {
+            total: allIds.length,
+            valid,
+            invalid,
+            results
+        };
+    }
+    /**
+     * Verify chunk store integrity
+     */
+    async verifyChunkStore() {
+        const storeResult = await this.chunkStore.verifyIntegrity();
+        return {
+            total: storeResult.valid + storeResult.corrupted.length + storeResult.missing.length,
+            valid: storeResult.valid,
+            corrupted: storeResult.corrupted,
+            missing: storeResult.missing
+        };
+    }
+    /**
+     * Verify data against expected hash
+     */
+    verifyData(data, expectedHash) {
+        return verifyHash(data, expectedHash);
+    }
+    /**
+     * Compute hash for data
+     */
+    computeHash(data) {
+        return hash(data);
+    }
+    /**
+     * Get verification summary for a neuron
+     */
+    async getVerificationSummary(neuronId) {
+        const neuron = await this.neuronStore.getNeuron(neuronId);
+        if (!neuron) {
+            return { exists: false };
+        }
+        let allChunksExist = true;
+        for (const chunkHash of neuron.chunkHashes) {
+            const exists = await this.chunkStore.has(chunkHash);
+            if (!exists) {
+                allChunksExist = false;
+                break;
+            }
+        }
+        const merkleValid = await this.verifyMerkleRoot(neuron.chunkHashes, neuron.merkleRoot);
+        return {
+            exists: true,
+            merkleRoot: neuron.merkleRoot,
+            chunkCount: neuron.chunkHashes.length,
+            allChunksExist,
+            merkleValid
+        };
+    }
+}
+/**
+ * Create a VerificationService instance
+ */
+export function createVerificationService(merkleEngine, chunkStore, neuronStore) {
+    return new VerificationService(merkleEngine, chunkStore, neuronStore);
+}
+//# sourceMappingURL=verify.js.map

package/dist/src/services/verify.js.map

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

package/dist/src/storage/chunk-store.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Chunk Store - Content-Addressable Storage for Chunks
+ * @module storage/chunk-store
+ */
+import type { Chunk, SHA3Hash } from '../types/index.js';
+/**
+ * Chunk storage options
+ */
+export interface ChunkStoreOptions {
+    dataDir: string;
+    useCompression?: boolean;
+}
+/**
+ * Content-Addressable Chunk Store
+ * Uses LevelDB for metadata and file system for chunk data
+ */
+export declare class ChunkStore {
+    private db;
+    private dataDir;
+    private chunkDir;
+    private initialized;
+    constructor(options: ChunkStoreOptions);
+    /**
+     * Initialize the store
+     */
+    init(): Promise<void>;
+    /**
+     * Close the store
+     */
+    close(): Promise<void>;
+    /**
+     * Store a chunk (content-addressable)
+     * @param chunk - Chunk to store
+     * @returns Hash of stored chunk
+     */
+    put(chunk: Chunk): Promise<SHA3Hash>;
+    /**
+     * Store multiple chunks
+     * @param chunks - Chunks to store
+     * @returns Array of stored hashes
+     */
+    putMany(chunks: Chunk[]): Promise<SHA3Hash[]>;
+    /**
+     * Retrieve a chunk by hash
+     * @param chunkHash - Hash of chunk to retrieve
+     * @returns Chunk or null if not found
+     */
+    get(chunkHash: SHA3Hash): Promise<Chunk | null>;
+    /**
+     * Retrieve multiple chunks by hash
+     * @param hashes - Array of chunk hashes
+     * @returns Array of chunks (in order, null for missing)
+     */
+    getMany(hashes: SHA3Hash[]): Promise<(Chunk | null)[]>;
+    /**
+     * Check if a chunk exists
+     * @param chunkHash - Hash to check
+     */
+    has(chunkHash: SHA3Hash): Promise<boolean>;
+    /**
+     * Delete a chunk (decrements reference count)
+     * @param chunkHash - Hash of chunk to delete
+     * @returns true if chunk was deleted, false if not found
+     */
+    delete(chunkHash: SHA3Hash): Promise<boolean>;
+    /**
+     * Get all chunk hashes
+     */
+    getAllHashes(): Promise<SHA3Hash[]>;
+    /**
+     * Get storage statistics
+     */
+    getStats(): Promise<{
+        totalChunks: number;
+        totalSize: number;
+        avgChunkSize: number;
+    }>;
+    /**
+     * Verify integrity of all stored chunks
+     */
+    verifyIntegrity(): Promise<{
+        valid: number;
+        corrupted: SHA3Hash[];
+        missing: SHA3Hash[];
+    }>;
+    /**
+     * Garbage collect unreferenced chunks
+     */
+    gc(): Promise<number>;
+    /**
+     * Get chunk path from hash (sharded by first 2 chars)
+     */
+    private getChunkPath;
+    /**
+     * Get chunk metadata
+     */
+    private getMetadata;
+    /**
+     * Ensure store is initialized
+     */
+    private ensureInitialized;
+}
+/**
+ * Create a ChunkStore instance
+ */
+export declare function createChunkStore(options: ChunkStoreOptions): ChunkStore;
+//# sourceMappingURL=chunk-store.d.ts.map

package/dist/src/storage/chunk-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-store.d.ts","sourceRoot":"","sources":["../../../src/storage/chunk-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAeD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAkB;gBAEzB,OAAO,EAAE,iBAAiB;IAQtC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;OAIG;IACG,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmC1C;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IASnD;;;;OAIG;IACG,GAAG,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA8BrD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IAI5D;;;OAGG;IACG,GAAG,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhD;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BnD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAYzC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAqBF;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,QAAQ,EAAE,CAAC;KACrB,CAAC;IAgCF;;OAEG;IACG,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC;IAqB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;YACW,WAAW;IAYzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAK1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}