solvoid 1.0.0

package/dist/sdk/semantics/idl-registry.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdlRegistry = void 0;
+const logger_1 = require("../utils/logger");
+const idl_fetcher_1 = require("../registry/idl-fetcher");
+// Mock IDL suitable for System Program transfers
+const SYSTEM_IDL = {
+    version: "0.1.0",
+    name: "system_program",
+    instructions: [
+        {
+            name: "transfer",
+            accounts: [
+                { name: "from", isMut: true, isSigner: true },
+                { name: "to", isMut: true, isSigner: false }
+            ],
+            args: [
+                { name: "lamports", type: "u64" }
+            ],
+            discriminator: [2, 0, 0, 0]
+        }
+    ]
+};
+// Mock IDL for SPL Token
+const SPL_TOKEN_IDL = {
+    version: "0.1.0",
+    name: "spl_token",
+    instructions: [
+        {
+            name: "transfer",
+            accounts: [
+                { name: "source", isMut: true, isSigner: false },
+                { name: "destination", isMut: true, isSigner: false },
+                { name: "authority", isMut: false, isSigner: true }
+            ],
+            args: [
+                { name: "amount", type: "u64" }
+            ],
+            discriminator: [3]
+        }
+    ]
+};
+// Mock IDL for a generic DeFi swap
+const DEFI_SWAP_IDL = {
+    version: "1.0.0",
+    name: "super_swap",
+    instructions: [
+        {
+            name: "swap",
+            accounts: [
+                { name: "user_authority", isMut: false, isSigner: true },
+                { name: "user_source", isMut: true, isSigner: false },
+                { name: "pool_source", isMut: true, isSigner: false },
+                { name: "pool_dest", isMut: true, isSigner: false },
+                { name: "user_dest", isMut: true, isSigner: false }
+            ],
+            args: [
+                { name: "amount_in", type: "u64" },
+                { name: "min_out", type: "u64" }
+            ],
+            discriminator: [100, 100, 100, 100, 100, 100, 100, 100]
+        }
+    ]
+};
+class IdlRegistry {
+    constructor() {
+        this.cache = new Map();
+        this.cache.set("11111111111111111111111111111111", SYSTEM_IDL);
+        this.cache.set("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", SPL_TOKEN_IDL);
+        this.cache.set("DeFi111111111111111111111111111111111111111", DEFI_SWAP_IDL);
+    }
+    async fetchIdl(programId) {
+        if (this.cache.has(programId)) {
+            return this.cache.get(programId);
+        }
+        try {
+            const fetcher = new idl_fetcher_1.OnChainIdlFetcher("https://api.mainnet-beta.solana.com");
+            const idl = await fetcher.fetchIdl(programId);
+            if (idl) {
+                this.cache.set(programId, idl);
+                return idl;
+            }
+        }
+        catch (e) {
+            // Fallback to null
+        }
+        logger_1.logger.debug(`[IdlRegistry] IDL not found on-chain for ${programId}`);
+        return null;
+    }
+    registerIdl(programId, idl) {
+        this.cache.set(programId, idl);
+    }
+}
+exports.IdlRegistry = IdlRegistry;
+//# sourceMappingURL=idl-registry.js.map

package/dist/sdk/semantics/idl-registry.js.map

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

package/dist/sdk/semantics/types.d.ts

@@ -0,0 +1,44 @@
+export interface Idl {
+    version: string;
+    name: string;
+    instructions: IdlInstruction[];
+    accounts?: IdlAccount[];
+    types?: IdlType[];
+    events?: IdlEvent[];
+    errors?: IdlError[];
+}
+export interface IdlInstruction {
+    name: string;
+    accounts: IdlAccountItem[];
+    args: IdlField[];
+}
+export interface IdlAccountItem {
+    name: string;
+    isMut: boolean;
+    isSigner: boolean;
+}
+export interface IdlField {
+    name: string;
+    type: any;
+}
+export interface IdlAccount {
+    name: string;
+    type: {
+        kind: 'struct';
+        fields: IdlField[];
+    };
+}
+export interface IdlType {
+    name: string;
+    type: any;
+}
+export interface IdlEvent {
+    name: string;
+    fields: IdlField[];
+}
+export interface IdlError {
+    code: number;
+    name: string;
+    msg: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/semantics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sdk/semantics/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,GAAG;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,EAAE,QAAQ,EAAE,CAAC;KACtB,CAAC;CACL;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf"}

package/dist/sdk/semantics/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/sdk/semantics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../sdk/semantics/types.ts"],"names":[],"mappings":""}

package/dist/sdk/simulator.d.ts

@@ -0,0 +1,15 @@
+import { VersionedTransaction } from '@solana/web3.js';
+import { GeyserTransactionEvents, TransactionJSON } from './types';
+export declare class ForensicsSimulator {
+    private connection;
+    constructor(rpcUrl?: string);
+    /**
+     * Simulates a transaction and converts the result into forensic events.
+     */
+    simulate(tx: VersionedTransaction, baseTxJson: TransactionJSON): Promise<GeyserTransactionEvents>;
+    /**
+     * Reconstructs the full transaction structure by resolving ALTs.
+     */
+    expandTransaction(tx: VersionedTransaction): Promise<TransactionJSON>;
+}
+//# sourceMappingURL=simulator.d.ts.map

package/dist/sdk/simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.d.ts","sourceRoot":"","sources":["../../sdk/simulator.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,oBAAoB,EAA4D,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAAE,uBAAuB,EAAiB,eAAe,EAAE,MAAM,SAAS,CAAC;AAIlF,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,UAAU,CAAa;gBAEnB,MAAM,GAAE,MAA8C;IAIlE;;OAEG;IACU,QAAQ,CACjB,EAAE,EAAE,oBAAoB,EACxB,UAAU,EAAE,eAAe,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IAwDnC;;OAEG;IACU,iBAAiB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;CA2ErF"}

package/dist/sdk/simulator.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForensicsSimulator = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const logger_1 = require("./utils/logger");
+const p_retry_1 = __importDefault(require("p-retry"));
+class ForensicsSimulator {
+    constructor(rpcUrl = "https://api.mainnet-beta.solana.com") {
+        this.connection = new web3_js_1.Connection(rpcUrl, 'confirmed');
+    }
+    /**
+     * Simulates a transaction and converts the result into forensic events.
+     */
+    async simulate(tx, baseTxJson) {
+        logger_1.logger.debug("Executing RPC Simulation...");
+        const simResult = await (0, p_retry_1.default)(async () => {
+            return await this.connection.simulateTransaction(tx, {
+                replaceRecentBlockhash: true,
+                sigVerify: false,
+                commitment: 'confirmed',
+                accounts: {
+                    encoding: "base64",
+                    addresses: baseTxJson.message.accountKeys
+                }
+            });
+        }, {
+            retries: 3,
+            minTimeout: 1000,
+            onFailedAttempt: error => {
+                logger_1.logger.warn(`RPC attempt ${error.attemptNumber} failed: ${error.message}`);
+            }
+        });
+        if (simResult.value.err) {
+            logger_1.logger.error("Simulation Failed:", simResult.value.err);
+            throw new Error("Transaction Simulation Failed.");
+        }
+        const updates = [];
+        if (simResult.value.accounts) {
+            simResult.value.accounts.forEach((acc, index) => {
+                if (!acc)
+                    return;
+                const address = baseTxJson.message.accountKeys[index];
+                updates.push({
+                    pubkey: address,
+                    owner: acc.owner,
+                    lamports: acc.lamports,
+                    data: acc.data[0],
+                    executable: acc.executable,
+                    rentEpoch: acc.rentEpoch || 0,
+                    writeVersion: 0
+                });
+            });
+        }
+        return {
+            signature: "simulated_state",
+            accountUpdates: updates
+        };
+    }
+    /**
+     * Reconstructs the full transaction structure by resolving ALTs.
+     */
+    async expandTransaction(tx) {
+        const addressLookupTableAccounts = [];
+        const message = tx.message;
+        if (message.version === 0) {
+            const lookups = message.addressTableLookups;
+            if (lookups && lookups.length > 0) {
+                logger_1.logger.debug(`Resolving ${lookups.length} Address Lookup Tables...`);
+                for (const lookup of lookups) {
+                    const res = await this.connection.getAddressLookupTable(lookup.accountKey);
+                    if (res.value) {
+                        addressLookupTableAccounts.push(res.value);
+                    }
+                }
+            }
+        }
+        const decompiled = web3_js_1.TransactionMessage.decompile(message, { addressLookupTableAccounts });
+        const keyMap = new Map();
+        const addKey = (pubkey, isSigner, isWritable) => {
+            const k = pubkey.toBase58();
+            const curr = keyMap.get(k);
+            if (curr) {
+                curr.isSigner = curr.isSigner || isSigner;
+                curr.isWritable = curr.isWritable || isWritable;
+            }
+            else {
+                keyMap.set(k, { isSigner, isWritable });
+            }
+        };
+        addKey(decompiled.payerKey, true, true);
+        for (const ix of decompiled.instructions) {
+            addKey(ix.programId, false, false);
+            for (const meta of ix.keys) {
+                addKey(meta.pubkey, meta.isSigner, meta.isWritable);
+            }
+        }
+        const entries = Array.from(keyMap.entries());
+        const payer = decompiled.payerKey.toBase58();
+        const signersWritable = entries.filter(([, v]) => v.isSigner && v.isWritable).map(([k]) => k)
+            .sort((a, b) => (a === payer ? -1 : b === payer ? 1 : 0));
+        const signersReadonly = entries.filter(([, v]) => v.isSigner && !v.isWritable).map(([k]) => k);
+        const nonSignersWritable = entries.filter(([, v]) => !v.isSigner && v.isWritable).map(([k]) => k);
+        const nonSignersReadonly = entries.filter(([, v]) => !v.isSigner && !v.isWritable).map(([k]) => k);
+        const accountKeys = [
+            ...signersWritable,
+            ...signersReadonly,
+            ...nonSignersWritable,
+            ...nonSignersReadonly
+        ];
+        const instructions = decompiled.instructions.map(ix => ({
+            programIdIndex: accountKeys.indexOf(ix.programId.toBase58()),
+            accounts: ix.keys.map(k => accountKeys.indexOf(k.pubkey.toBase58())),
+            data: ix.data.toString('base64')
+        }));
+        return {
+            message: {
+                accountKeys,
+                header: {
+                    numRequiredSignatures: signersWritable.length + signersReadonly.length,
+                    numReadonlySignedAccounts: signersReadonly.length,
+                    numReadonlyUnsignedAccounts: nonSignersReadonly.length
+                },
+                instructions
+            },
+            signatures: tx.signatures.map(s => Buffer.from(s).toString('base64'))
+        };
+    }
+}
+exports.ForensicsSimulator = ForensicsSimulator;
+//# sourceMappingURL=simulator.js.map

package/dist/sdk/simulator.js.map

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

package/dist/sdk/types.d.ts

@@ -0,0 +1,53 @@
+export type LeakType = "identity" | "metadata" | "state-leak" | "cpi-linkage";
+export type VisibilityScope = "PUBLIC" | "PROGRAM" | "LOCAL";
+export interface Leak {
+    type: LeakType;
+    scope: string;
+    visibility: VisibilityScope;
+    description: string;
+    remediation?: string;
+    severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    programName?: string;
+}
+export interface GovernanceResult {
+    status: "SURFACE_SCAN_PASSED" | "REGRESSION";
+    unacceptedLiabilities: {
+        leak: Leak;
+        reason: string;
+    }[];
+    remediationHints: string[];
+    privacyScore: number;
+}
+export interface TransactionJSON {
+    message: {
+        accountKeys: string[];
+        header: {
+            numRequiredSignatures: number;
+        };
+        instructions: {
+            programIdIndex: number;
+            accounts: number[];
+            data: string;
+        }[];
+    };
+    meta?: {
+        innerInstructions?: {
+            index: number;
+            instructions: {
+                programIdIndex: number;
+                accounts: number[];
+                data: string;
+            }[];
+        }[];
+        logMessages?: string[];
+    };
+    signatures: string[];
+}
+export interface GeyserTransactionEvents {
+    signature: string;
+    accountUpdates: {
+        pubkey: string;
+        data: string;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GACd,UAAU,GACV,UAAU,GACV,YAAY,GACZ,aAAa,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,qBAAqB,GAAG,YAAY,CAAC;IAC7C,qBAAqB,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE;QACL,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE;YACJ,qBAAqB,EAAE,MAAM,CAAC;SACjC,CAAC;QACF,YAAY,EAAE;YACV,cAAc,EAAE,MAAM,CAAC;YACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;SAChB,EAAE,CAAC;KACP,CAAC;IACF,IAAI,CAAC,EAAE;QACH,iBAAiB,CAAC,EAAE;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,YAAY,EAAE;gBACV,cAAc,EAAE,MAAM,CAAC;gBACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC;aAChB,EAAE,CAAC;SACP,EAAE,CAAC;QACJ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACP"}

package/dist/sdk/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../sdk/types.ts"],"names":[],"mappings":""}

package/dist/sdk/utils/config.d.ts

@@ -0,0 +1,15 @@
+import { Keypair } from '@solana/web3.js';
+export interface EnvConfig {
+    rpcUrl: string;
+    walletKey?: string;
+    historyFile?: string;
+    jitoAuthToken?: string;
+}
+export declare class ConfigLoader {
+    private config;
+    constructor();
+    getRpcUrl(): string;
+    getSigner(): Keypair | null;
+    getJitoAuth(): string | undefined;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/sdk/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../sdk/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI1C,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAY;;IAWnB,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,OAAO,GAAG,IAAI;IAkB3B,WAAW,IAAI,MAAM,GAAG,SAAS;CAG3C"}

package/dist/sdk/utils/config.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLoader = void 0;
+const web3_js_1 = require("@solana/web3.js");
+class ConfigLoader {
+    constructor() {
+        this.config = {
+            rpcUrl: process.env.RPC_URL || "https://api.mainnet-beta.solana.com",
+            walletKey: process.env.WALLET_KEY,
+            historyFile: process.env.PRIVACY_HISTORY_FILE,
+            jitoAuthToken: process.env.JITO_AUTH_TOKEN
+        };
+    }
+    getRpcUrl() {
+        return this.config.rpcUrl;
+    }
+    getSigner() {
+        if (!this.config.walletKey)
+            return null;
+        try {
+            // Try different formats
+            // 1. JSON Array "[1,2,3...]"
+            if (this.config.walletKey.startsWith('[')) {
+                return web3_js_1.Keypair.fromSecretKey(Uint8Array.from(JSON.parse(this.config.walletKey)));
+            }
+            // 2. BS58 String
+            const bs58 = require('bs58');
+            return web3_js_1.Keypair.fromSecretKey(bs58.decode(this.config.walletKey));
+        }
+        catch {
+            console.warn("Failed to parse WALLET_KEY from .env");
+            return null;
+        }
+    }
+    getJitoAuth() {
+        return this.config.jitoAuthToken;
+    }
+}
+exports.ConfigLoader = ConfigLoader;
+//# sourceMappingURL=config.js.map

package/dist/sdk/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../sdk/utils/config.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAW1C,MAAa,YAAY;IAGrB;QACI,IAAI,CAAC,MAAM,GAAG;YACV,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,qCAAqC;YACpE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;YACjC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAC7C,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;SAC7C,CAAC;IACN,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAEM,SAAS;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAExC,IAAI,CAAC;YACD,wBAAwB;YACxB,6BAA6B;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,OAAO,iBAAO,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrF,CAAC;YACD,iBAAiB;YACjB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,iBAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAEM,WAAW;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACrC,CAAC;CACJ;AArCD,oCAqCC"}

package/dist/sdk/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/sdk/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../sdk/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,eAAO,MAAM,MAAM,gBAcjB,CAAC"}

package/dist/sdk/utils/logger.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const winston_1 = __importDefault(require("winston"));
+exports.logger = winston_1.default.createLogger({
+    level: process.env.LOG_LEVEL || 'info',
+    format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+    transports: [
+        new winston_1.default.transports.Console({
+            format: winston_1.default.format.combine(winston_1.default.format.colorize(), winston_1.default.format.simple()),
+        }),
+    ],
+});
+//# sourceMappingURL=logger.js.map

package/dist/sdk/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../sdk/utils/logger.ts"],"names":[],"mappings":";;;;;;AACA,sDAA8B;AAEjB,QAAA,MAAM,GAAG,iBAAO,CAAC,YAAY,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC1B,iBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACxB;IACD,UAAU,EAAE;QACR,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC1B,iBAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,iBAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAC1B;SACJ,CAAC;KACL;CACJ,CAAC,CAAC"}

package/dist/tests/unit/idl-registry.test.d.ts

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

package/dist/tests/unit/idl-registry.test.d.ts.map

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

package/dist/tests/unit/idl-registry.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const idl_registry_1 = require("../../sdk/semantics/idl-registry");
+(0, globals_1.describe)('IdlRegistry', () => {
+    let registry;
+    (0, globals_1.beforeEach)(() => {
+        registry = new idl_registry_1.IdlRegistry();
+    });
+    (0, globals_1.it)('should load pre-seeded system program IDL', async () => {
+        const idl = await registry.fetchIdl('11111111111111111111111111111111');
+        (0, globals_1.expect)(idl.name).toBe('system_program');
+    });
+    (0, globals_1.it)('should load pre-seeded SPL token IDL', async () => {
+        const idl = await registry.fetchIdl('TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA');
+        (0, globals_1.expect)(idl.name).toBe('spl_token');
+    });
+    (0, globals_1.it)('should register custom IDLs', () => {
+        const mockIdl = { name: 'mock' };
+        registry.registerIdl('Mock111111111111111111111111111111111', mockIdl);
+        // Using any cast to avoid TS issues in mock test
+        const saved = registry.cache.get('Mock111111111111111111111111111111111');
+        (0, globals_1.expect)(saved.name).toBe('mock');
+    });
+    (0, globals_1.it)('should return null for unknown programs', async () => {
+        const idl = await registry.fetchIdl('Unknown11111111111111111111111111111111');
+        (0, globals_1.expect)(idl).toBeNull();
+    });
+    (0, globals_1.it)('fix parameter implicit any error', () => {
+        // This addresses the "Parameter 'res' implicitly has an 'any' type" error
+        const mockFn = (res) => res;
+        (0, globals_1.expect)(mockFn('test')).toBe('test');
+    });
+});
+//# sourceMappingURL=idl-registry.test.js.map

package/dist/tests/unit/idl-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idl-registry.test.js","sourceRoot":"","sources":["../../../tests/unit/idl-registry.test.ts"],"names":[],"mappings":";;AAAA,2CAAiE;AACjE,mEAA+D;AAE/D,IAAA,kBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IACzB,IAAI,QAAqB,CAAC;IAE1B,IAAA,oBAAU,EAAC,GAAG,EAAE;QACZ,QAAQ,GAAG,IAAI,0BAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAA,YAAE,EAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;QACxE,IAAA,gBAAM,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAA,YAAE,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC;QACnF,IAAA,gBAAM,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAA,YAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,WAAW,CAAC,uCAAuC,EAAE,OAAO,CAAC,CAAC;QACvE,iDAAiD;QACjD,MAAM,KAAK,GAAS,QAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACxF,IAAA,gBAAM,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,YAAE,EAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC;QAC/E,IAAA,gBAAM,EAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,IAAA,YAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,0EAA0E;QAC1E,MAAM,MAAM,GAAG,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC;QACjC,IAAA,gBAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tools/exploit_demonstration.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const privacy_engine_1 = require("../sdk/privacy-engine");
+const web3_js_1 = require("@solana/web3.js");
+// Setup
+const engine = new privacy_engine_1.PrivacyEngine();
+const user = web3_js_1.Keypair.generate();
+const attacker = web3_js_1.Keypair.generate();
+const userPubkey = user.publicKey.toBase58();
+console.log("\n💀 PREDATORY OFFENSIVE SECURITY INTELLECT - SYSTEM ANALYSIS 💀\n");
+console.log(`Target Identity: ${userPubkey.slice(0, 8)}...`);
+// --- EXPLOIT 1: THE KING'S ROBES (System Program Blindness) ---
+console.log("\n[1] Executing Exploit: 'The King's Robes' (System Program Blindness)...");
+// Construct a raw JSON reflecting a SystemProgram.transfer(User, Attacker)
+// In a real tx, AccountKeys = [User (Payer, Signer), Attacker, SystemProgram]
+// Instruction: ProgramIdIndex = 2 (System), Accounts = [0, 1]
+// We expect the engine to SKIP this because ProgramId is SystemProgram (111...)
+const systemProgramId = web3_js_1.SystemProgram.programId.toBase58();
+const txTransfer = {
+    message: {
+        accountKeys: [userPubkey, attacker.publicKey.toBase58(), systemProgramId],
+        header: {
+            numRequiredSignatures: 1,
+            numReadonlySignedAccounts: 0,
+            numReadonlyUnsignedAccounts: 0
+        },
+        instructions: [{
+                programIdIndex: 2, // System Program
+                accounts: [0, 1], // User -> Attacker
+                data: "AgAAAAAAAAA=" // Dummy transfer instruction data
+            }]
+    },
+    signatures: ["dummy_signature"]
+};
+const leaks1 = engine.analyzeTransaction(txTransfer);
+if (leaks1.length === 0) {
+    console.log("❌ RESULT: ZERO LEAKS DETECTED.");
+    console.log("   The engine explicitly ignores 'SystemProgram'.");
+    console.log("   A direct transfer of funds (The ultimate graph link) is INVISIBLE.");
+}
+else {
+    console.log("✅ RESULT: LEAKS DETECTED.", leaks1);
+}
+// --- EXPLOIT 2: THE BROKEN LENS (ALT Blindness) ---
+console.log("\n[2] Executing Exploit: 'The Broken Lens' (Address Lookup Table Blindness)...");
+// Scenario: A V0 transaction using ALTs.
+// The 'accountKeys' array in message ONLY has static keys.
+// The 'loadedAddresses' in meta has the dynamic keys.
+// The user is HIDDEN in the ALT (loadedAddresses).
+const dexProgramId = "Dex1111111111111111111111111111111111111"; // Hypothetical DEX
+const txAlt = {
+    message: {
+        accountKeys: [
+            attacker.publicKey.toBase58(), // Payer (Attacker pays!)
+            dexProgramId // Static Program
+        ],
+        header: {
+            numRequiredSignatures: 1,
+            numReadonlySignedAccounts: 0,
+            numReadonlyUnsignedAccounts: 0
+        },
+        instructions: [{
+                programIdIndex: 1, // Dex Program
+                accounts: [0, 2], // 0=Attacker, 2=User (from ALT!)
+                // Note: In V0, index 2 points to loadedAddresses[0] if static length is 2.
+                data: "dummydata"
+            }]
+    },
+    meta: {
+        loadedAddresses: {
+            writable: [userPubkey], // User is here!
+            readonly: []
+        }
+    },
+    signatures: ["dummy_signature"]
+};
+try {
+    const leaks2 = engine.analyzeTransaction(txAlt);
+    // Check if the user was found
+    const userFound = leaks2.some(l => l.description.includes(userPubkey.slice(0, 8)));
+    if (!userFound) {
+        console.log("❌ RESULT: USER NOT DETECTED.");
+        console.log(`   Internal Engine State Check:`);
+        // The engine logic: ix.accounts.map(idx => accountKeys[idx])
+        // accountKeys has length 2. Index is 2.
+        // accountKeys[2] is UNDEFINED.
+        // [undefined].includes(user) is FALSE.
+        console.log("   The engine fails to look in 'loadedAddresses'.");
+        console.log("   The User is invisible by simply moving them to a Lookup Table.");
+    }
+    else {
+        console.log("✅ RESULT: USER DETECTED.", leaks2);
+    }
+}
+catch (e) {
+    console.log("💥 CRASH: The engine choked on the ALT structure.");
+    console.log("   Error:", e.message);
+}
+console.log("\n💀 DEMONSTRATION COMPLETE 💀");