solvoid 1.0.0 → 1.1.0

package/dist/crypto/poseidon.js

@@ -0,0 +1,293 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoseidonUtils = exports.SecureSalts = exports.PoseidonHasher = void 0;
+const circomlibjs_1 = require("circomlibjs");
+const buffer_1 = require("buffer");
+/**
+ * Poseidon hash wrapper with type safety and BN254 compatibility
+ * Matches Rust implementation parameters for cryptographic consistency
+ */
+class PoseidonHasher {
+    /**
+     * Initialize Poseidon with BN254 field parameters
+     * Width: 3 (2 inputs + 1 output for binary Merkle tree)
+     * Security: 128-bit (standard for zk-SNARK applications)
+     */
+    static async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Build Poseidon instance with parameters matching Rust implementation
+            this.poseidon = await (0, circomlibjs_1.buildPoseidon)();
+            // Configure for BN254 field with width=3 (2 inputs + 1 output)
+            // This matches the Rust Poseidon<Bn254, 3> setup
+            await this.poseidon.ready();
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize Poseidon: ${error}`);
+        }
+    }
+    /**
+     * Ensure Poseidon is initialized before use
+     */
+    static async ensureInitialized() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+    }
+    /**
+     * Convert Buffer to BigInt for Poseidon input
+     * FIXED: Handles little-endian conversion consistently with Rust ark-ff
+     */
+    static bufferToBigInt(buffer) {
+        // Reverse buffer for little-endian conversion
+        const leBuffer = buffer_1.Buffer.from(buffer).reverse();
+        return BigInt('0x' + leBuffer.toString('hex'));
+    }
+    /**
+     * Convert BigInt output to Buffer (32 bytes, little-endian)
+     * FIXED: Ensures compatibility with Rust field element format (little-endian)
+     */
+    static bigIntToBuffer(value) {
+        // Convert to hex string and pad to 64 characters (32 bytes)
+        const hex = value.toString(16).padStart(64, '0');
+        // Convert hex to Buffer and reverse for little-endian
+        const buffer = buffer_1.Buffer.from(hex, 'hex').reverse();
+        // Ensure exactly 32 bytes
+        if (buffer.length !== 32) {
+            throw new Error(`Poseidon output must be 32 bytes, got ${buffer.length}`);
+        }
+        return buffer;
+    }
+    /**
+     * Hash with salt for commitment derivation
+     * Matches Rust: hash_commitment_with_salt
+     */
+    static async hashWithSalt(left, right, saltValue) {
+        await this.ensureInitialized();
+        if (left.length !== 32 || right.length !== 32 || saltValue.length !== 32) {
+            throw new Error('All inputs must be exactly 32 bytes');
+        }
+        const l = this.bufferToBigInt(left);
+        const r = this.bufferToBigInt(right);
+        const s = this.bufferToBigInt(saltValue);
+        // Matches Rust: sponge.absorb(&l); sponge.absorb(&r); sponge.absorb(&s);
+        const resultBigInt = this.poseidon([l, r, s]);
+        return this.bigIntToBuffer(resultBigInt);
+    }
+    /**
+     * Hash two 32-byte inputs using Poseidon(2)
+     * MATCHES MerkleTreeChecker circuit: Poseidon(2)
+     */
+    static async hashTwoInputs(left, right) {
+        await this.ensureInitialized();
+        if (left.length !== 32 || right.length !== 32) {
+            throw new Error('All inputs must be exactly 32 bytes');
+        }
+        const l = this.bufferToBigInt(left);
+        const r = this.bufferToBigInt(right);
+        // Strict Poseidon(2) for Merkle Tree consistency
+        const resultBigInt = this.poseidon([l, r]);
+        return this.bigIntToBuffer(resultBigInt);
+    }
+    /**
+     * Hash single input with zero for nullifier hash
+     * MATCHES circuit: Poseidon(nullifier, 1)
+     */
+    static async hashWithZero(input) {
+        await this.ensureInitialized();
+        const n = this.bufferToBigInt(input);
+        const resultBigInt = this.poseidon([n, BigInt(1)]);
+        return this.bigIntToBuffer(resultBigInt);
+    }
+    /**
+     * Compute commitment from secret, nullifier, and amount
+     * FIXED: Includes amount to prevent value inflation
+     * Matches circuit: Poseidon(secret, nullifier, amount)
+     */
+    static async computeCommitment(secret, nullifier, amount) {
+        await this.ensureInitialized();
+        const s = this.bufferToBigInt(secret);
+        const n = this.bufferToBigInt(nullifier);
+        const a = amount;
+        const resultBigInt = this.poseidon([s, n, a]);
+        return this.bigIntToBuffer(resultBigInt);
+    }
+    /**
+     * Compute nullifier hash from nullifier
+     * FIXED: Uses constant domain salt matching the circuit
+     * Matches circuit: Poseidon(nullifier, 1)
+     */
+    static async computeNullifierHash(nullifier) {
+        await this.ensureInitialized();
+        const n = this.bufferToBigInt(nullifier);
+        const salt = BigInt(1);
+        const resultBigInt = this.poseidon([n, salt]);
+        return this.bigIntToBuffer(resultBigInt);
+    }
+    /**
+     * Compute Merkle root from leaf and proof path
+     * @param leaf - 32-byte leaf value
+     * @param proof - Array of 32-byte proof elements
+     * @param indices - Array of indices (0 for left, 1 for right)
+     * @returns 32-byte Merkle root
+     */
+    static async computeMerkleRoot(leaf, proof, indices) {
+        if (proof.length !== indices.length) {
+            throw new Error('Proof and indices arrays must have same length');
+        }
+        let current = leaf;
+        for (let i = 0; i < proof.length; i++) {
+            const sibling = proof[i];
+            const index = indices[i];
+            if (index === 0) {
+                // Current is left sibling
+                current = await this.hashTwoInputs(current, sibling);
+            }
+            else {
+                // Current is right sibling
+                current = await this.hashTwoInputs(sibling, current);
+            }
+        }
+        return current;
+    }
+    /**
+     * Verify hash output is within BN254 field constraints
+     * Ensures compatibility with zk-SNARK circuit requirements
+     */
+    static verifyFieldCompatibility(hash) {
+        if (hash.length !== 32)
+            return false;
+        try {
+            // Convert to BigInt and check it's within BN254 field
+            const value = this.bufferToBigInt(hash);
+            // BN254 prime field modulus (p)
+            const BN254_PRIME = BigInt('21888242871839275222246405745257275088548364400416034343698204186575808495617');
+            return value < BN254_PRIME;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get Poseidon instance for advanced usage
+     * @returns The underlying circomlibjs Poseidon instance
+     */
+    static async getPoseidonInstance() {
+        await this.ensureInitialized();
+        return this.poseidon;
+    }
+    /**
+     * Reset the Poseidon instance (useful for testing)
+     */
+    static reset() {
+        this.poseidon = null;
+        this.initialized = false;
+    }
+}
+exports.PoseidonHasher = PoseidonHasher;
+PoseidonHasher.poseidon = null;
+PoseidonHasher.initialized = false;
+/**
+ * FIXED: Secure salt generation for cryptographic domain separation
+ * Matches Rust implementation in poseidon.rs
+ */
+class SecureSalts {
+    static generateSecureSalts(transactionContext) {
+        const commitmentSalt = crypto.createHash('sha256')
+            .update(transactionContext)
+            .update(buffer_1.Buffer.from("commitment_domain"))
+            .digest();
+        const nullifierSalt = crypto.createHash('sha256')
+            .update(transactionContext)
+            .update(buffer_1.Buffer.from("nullifier_domain"))
+            .digest();
+        const pathSalt = crypto.createHash('sha256')
+            .update(transactionContext)
+            .update(buffer_1.Buffer.from("path_domain"))
+            .digest();
+        return {
+            commitmentSalt,
+            nullifierSalt,
+            pathSalt
+        };
+    }
+    static fromTransactionComponents(root, nullifier, recipient, amount) {
+        const amountBuf = buffer_1.Buffer.alloc(8);
+        amountBuf.writeBigUInt64LE(amount);
+        const context = buffer_1.Buffer.concat([root, nullifier, recipient, amountBuf]);
+        return this.generateSecureSalts(context);
+    }
+}
+exports.SecureSalts = SecureSalts;
+/**
+ * Utility functions for working with Poseidon hashes
+ */
+class PoseidonUtils {
+    /**
+     * Convert hex string to Buffer (32 bytes)
+     */
+    static hexToBuffer(hex) {
+        if (!/^[0-9a-fA-F]{64}$/.test(hex)) {
+            throw new Error('Hex must be exactly 64 characters (32 bytes)');
+        }
+        return buffer_1.Buffer.from(hex, 'hex');
+    }
+    /**
+     * Convert Buffer to hex string
+     */
+    static bufferToHex(buffer) {
+        return buffer.toString('hex');
+    }
+    /**
+     * Validate Buffer is 32 bytes
+     */
+    static validate32Bytes(buffer) {
+        if (buffer.length !== 32) {
+            throw new Error(`Buffer must be exactly 32 bytes, got ${buffer.length}`);
+        }
+    }
+    /**
+     * Create zero Buffer (32 bytes of zeros)
+     */
+    static zeroBuffer() {
+        return buffer_1.Buffer.alloc(32, 0);
+    }
+}
+exports.PoseidonUtils = PoseidonUtils;
+const crypto = __importStar(require("crypto"));
+//# sourceMappingURL=poseidon.js.map

package/dist/crypto/poseidon.js.map

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

package/dist/events/bus.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SolVoid Event Bus
+ * Central event system for real-time forensic telemetry across the SDK.
+ */
+type EventType = 'SCAN_START' | 'SCAN_COMPLETE' | 'LEAK_DETECTED' | 'TRANSACTION_PARSED' | 'PROOF_GENERATED' | 'RELAY_BROADCAST' | 'COMMITMENT_CREATED' | 'WITHDRAWAL_COMPLETE' | 'ERROR' | 'INFO' | 'WARNING';
+export interface ForensicEvent {
+    type: EventType;
+    timestamp: Date;
+    message: string;
+    data?: Record<string, unknown>;
+    hex?: string;
+}
+type EventCallback = (event: ForensicEvent) => void;
+declare class EventBusClass {
+    private listeners;
+    private globalListeners;
+    /**
+     * Subscribe to a specific event type
+     */
+    on(type: EventType, callback: EventCallback): () => void;
+    /**
+     * Subscribe to ALL events (for terminal/logging)
+     */
+    onAll(callback: EventCallback): () => void;
+    /**
+     * Emit an event to all subscribers
+     */
+    emit(type: EventType, message: string, data?: Record<string, unknown>, hex?: string): void;
+    /**
+     * Helper methods for common event types
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    scanStart(address: string): void;
+    scanComplete(address: string, leakCount: number, score: number): void;
+    leakDetected(type: string, severity: string, description: string, txSignature?: string): void;
+    transactionParsed(signature: string, programId: string): void;
+    proofGenerated(proofType: string): void;
+    relayBroadcast(nodeCount: number, txid: string): void;
+}
+export declare const EventBus: EventBusClass;
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../events/bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,SAAS,GACR,YAAY,GACZ,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,OAAO,GACP,MAAM,GACN,SAAS,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEpD,cAAM,aAAa;IACf,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,eAAe,CAAiC;IAExD;;OAEG;IACH,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAWxD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAO1C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB1F;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIrD,SAAS,CAAC,OAAO,EAAE,MAAM;IAIzB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI9D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAItF,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAItD,cAAc,CAAC,SAAS,EAAE,MAAM;IAIhC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAGjD;AAGD,eAAO,MAAM,QAAQ,eAAsB,CAAC"}

package/dist/events/bus.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * SolVoid Event Bus
+ * Central event system for real-time forensic telemetry across the SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBus = void 0;
+class EventBusClass {
+    constructor() {
+        this.listeners = new Map();
+        this.globalListeners = new Set();
+    }
+    /**
+     * Subscribe to a specific event type
+     */
+    on(type, callback) {
+        if (!this.listeners.has(type)) {
+            this.listeners.set(type, new Set());
+        }
+        this.listeners.get(type).add(callback);
+        return () => {
+            this.listeners.get(type)?.delete(callback);
+        };
+    }
+    /**
+     * Subscribe to ALL events (for terminal/logging)
+     */
+    onAll(callback) {
+        this.globalListeners.add(callback);
+        return () => {
+            this.globalListeners.delete(callback);
+        };
+    }
+    /**
+     * Emit an event to all subscribers
+     */
+    emit(type, message, data, hex) {
+        const event = {
+            type,
+            timestamp: new Date(),
+            message,
+            data,
+            hex
+        };
+        // Notify type-specific listeners
+        this.listeners.get(type)?.forEach(cb => cb(event));
+        // Notify global listeners
+        this.globalListeners.forEach(cb => cb(event));
+    }
+    /**
+     * Helper methods for common event types
+     */
+    info(message, data) {
+        this.emit('INFO', message, data);
+    }
+    warn(message, data) {
+        this.emit('WARNING', message, data);
+    }
+    error(message, data) {
+        this.emit('ERROR', message, data);
+    }
+    scanStart(address) {
+        this.emit('SCAN_START', `Initiating forensic scan for ${address.slice(0, 8)}...`, { address });
+    }
+    scanComplete(address, leakCount, score) {
+        this.emit('SCAN_COMPLETE', `Scan complete. ${leakCount} leaks detected. Privacy score: ${score}`, { address, leakCount, score });
+    }
+    leakDetected(type, severity, description, txSignature) {
+        this.emit('LEAK_DETECTED', `${severity} ${type} leak: ${description}`, { type, severity }, txSignature);
+    }
+    transactionParsed(signature, programId) {
+        this.emit('TRANSACTION_PARSED', `Parsed transaction from ${programId.slice(0, 8)}...`, { signature, programId }, signature);
+    }
+    proofGenerated(proofType) {
+        this.emit('PROOF_GENERATED', `ZK-${proofType} proof generated successfully`, { proofType });
+    }
+    relayBroadcast(nodeCount, txid) {
+        this.emit('RELAY_BROADCAST', `Transaction broadcast via ${nodeCount} shadow nodes`, { nodeCount, txid }, txid);
+    }
+}
+// Singleton export
+exports.EventBus = new EventBusClass();
+//# sourceMappingURL=bus.js.map

package/dist/events/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../events/bus.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAyBH,MAAM,aAAa;IAAnB;QACY,cAAS,GAAoC,IAAI,GAAG,EAAE,CAAC;QACvD,oBAAe,GAAuB,IAAI,GAAG,EAAE,CAAC;IAmF5D,CAAC;IAjFG;;OAEG;IACH,EAAE,CAAC,IAAe,EAAE,QAAuB;QACvC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExC,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAuB;QACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAe,EAAE,OAAe,EAAE,IAA8B,EAAE,GAAY;QAC/E,MAAM,KAAK,GAAkB;YACzB,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,IAAI;YACJ,GAAG;SACN,CAAC;QAEF,iCAAiC;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnD,0BAA0B;QAC1B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAA8B;QAChD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAChD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,OAAe;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,gCAAgC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,YAAY,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAa;QAC1D,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,SAAS,mCAAmC,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACrI,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,WAAmB,EAAE,WAAoB;QAClF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,QAAQ,IAAI,IAAI,UAAU,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC;IAC5G,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,SAAiB;QAClD,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,2BAA2B,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;IAChI,CAAC;IAED,cAAc,CAAC,SAAiB;QAC5B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,SAAS,+BAA+B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,IAAY;QAC1C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,6BAA6B,SAAS,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACnH,CAAC;CACJ;AAED,mBAAmB;AACN,QAAA,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/{sdk/index.d.ts → index.d.ts}

@@ -1,10 +1,9 @@
 export * from './types';
+export { DataOrigin, DataTrust, Unit, RelayRequestSchema, RelayResponseSchema, OnionLayerSchema, enforce, DataMetadata, RelayResponse, RelayRequest, OnionLayer } from './integrity';
 export { PrivacyEngine } from './privacy-engine';
 export { PrivacyPipeline } from './pipeline';
 export { PrivacyShield } from './privacy/shield';
-export { PrivacyRelayer } from './privacy/relayer';
 export { SolVoidClient, SolVoidConfig } from './client';
-export { OnChainIdlFetcher } from './registry/idl-fetcher';
 export { KNOWN_PROGRAMS, identifyProgram, isSwapProgram } from './registry/programs';
-export { ConfigLoader, EnvConfig } from './utils/config';
+export { EventBus, ForensicEvent } from './events/bus';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,SAAS,EACT,IAAI,EACJ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGrF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/{sdk/index.js → index.js}

@@ -14,30 +14,40 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigLoader = exports.isSwapProgram = exports.identifyProgram = exports.KNOWN_PROGRAMS = exports.OnChainIdlFetcher = exports.SolVoidClient = exports.PrivacyRelayer = exports.PrivacyShield = exports.PrivacyPipeline = exports.PrivacyEngine = void 0;
+exports.EventBus = exports.isSwapProgram = exports.identifyProgram = exports.KNOWN_PROGRAMS = exports.SolVoidClient = exports.PrivacyShield = exports.PrivacyPipeline = exports.PrivacyEngine = exports.enforce = exports.OnionLayerSchema = exports.RelayResponseSchema = exports.RelayRequestSchema = exports.Unit = exports.DataTrust = exports.DataOrigin = void 0;
 // Export all public types
 __exportStar(require("./types"), exports);
+// Export integrity module (server-side) - specific exports to avoid conflicts
+var integrity_1 = require("./integrity");
+Object.defineProperty(exports, "DataOrigin", { enumerable: true, get: function () { return integrity_1.DataOrigin; } });
+Object.defineProperty(exports, "DataTrust", { enumerable: true, get: function () { return integrity_1.DataTrust; } });
+Object.defineProperty(exports, "Unit", { enumerable: true, get: function () { return integrity_1.Unit; } });
+Object.defineProperty(exports, "RelayRequestSchema", { enumerable: true, get: function () { return integrity_1.RelayRequestSchema; } });
+Object.defineProperty(exports, "RelayResponseSchema", { enumerable: true, get: function () { return integrity_1.RelayResponseSchema; } });
+Object.defineProperty(exports, "OnionLayerSchema", { enumerable: true, get: function () { return integrity_1.OnionLayerSchema; } });
+Object.defineProperty(exports, "enforce", { enumerable: true, get: function () { return integrity_1.enforce; } });
 // Export privacy engine (core scanning & remediation detection)
 var privacy_engine_1 = require("./privacy-engine");
 Object.defineProperty(exports, "PrivacyEngine", { enumerable: true, get: function () { return privacy_engine_1.PrivacyEngine; } });
 var pipeline_1 = require("./pipeline");
 Object.defineProperty(exports, "PrivacyPipeline", { enumerable: true, get: function () { return pipeline_1.PrivacyPipeline; } });
-// Export Privacy Core (Production)
+// Export Privacy Core (browser-safe)
 var shield_1 = require("./privacy/shield");
 Object.defineProperty(exports, "PrivacyShield", { enumerable: true, get: function () { return shield_1.PrivacyShield; } });
-var relayer_1 = require("./privacy/relayer");
-Object.defineProperty(exports, "PrivacyRelayer", { enumerable: true, get: function () { return relayer_1.PrivacyRelayer; } });
-// Export client (main entry point)
+// Export client (main entry point - browser safe)
 var client_1 = require("./client");
 Object.defineProperty(exports, "SolVoidClient", { enumerable: true, get: function () { return client_1.SolVoidClient; } });
-// Export registry utilities (needed for decoding for the pipeline)
-var idl_fetcher_1 = require("./registry/idl-fetcher");
-Object.defineProperty(exports, "OnChainIdlFetcher", { enumerable: true, get: function () { return idl_fetcher_1.OnChainIdlFetcher; } });
+// Export registry utilities
 var programs_1 = require("./registry/programs");
 Object.defineProperty(exports, "KNOWN_PROGRAMS", { enumerable: true, get: function () { return programs_1.KNOWN_PROGRAMS; } });
 Object.defineProperty(exports, "identifyProgram", { enumerable: true, get: function () { return programs_1.identifyProgram; } });
 Object.defineProperty(exports, "isSwapProgram", { enumerable: true, get: function () { return programs_1.isSwapProgram; } });
-// Export configuration utilities
-var config_1 = require("./utils/config");
-Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_1.ConfigLoader; } });
+// Export event system (browser-safe)
+var bus_1 = require("./events/bus");
+Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return bus_1.EventBus; } });
+// Note: The following are server-side only and should be imported directly:
+// - PrivacyRelayer from './privacy/relayer'
+// - ShadowRPC from './network/shadow-rpc'
+// - ConfigLoader from './utils/config'
+// - OnChainIdlFetcher from './registry/idl-fetcher'
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,0CAAwB;AAExB,8EAA8E;AAC9E,yCAYqB;AAXnB,uGAAA,UAAU,OAAA;AACV,sGAAA,SAAS,OAAA;AACT,iGAAA,IAAI,OAAA;AACJ,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAChB,oGAAA,OAAO,OAAA;AAOT,gEAAgE;AAChE,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,uCAA6C;AAApC,2GAAA,eAAe,OAAA;AAExB,qCAAqC;AACrC,2CAAiD;AAAxC,uGAAA,aAAa,OAAA;AAEtB,kDAAkD;AAClD,mCAAwD;AAA/C,uGAAA,aAAa,OAAA;AAEtB,4BAA4B;AAC5B,gDAAqF;AAA5E,0GAAA,cAAc,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEvD,qCAAqC;AACrC,oCAAuD;AAA9C,+FAAA,QAAQ,OAAA;AAEjB,4EAA4E;AAC5E,4CAA4C;AAC5C,0CAA0C;AAC1C,uCAAuC;AACvC,oDAAoD"}