dexe-mcp 0.1.0

package/dist/bootstrap.js

@@ -0,0 +1,83 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+import { execSync } from "node:child_process";
+const REPO_URL = "https://github.com/dexe-network/DeXe-Protocol.git";
+const CACHE_DIR_NAME = "dexe-mcp";
+const CHECKOUT_DIR = "DeXe-Protocol";
+/**
+ * Returns the platform-appropriate cache directory for dexe-mcp.
+ *
+ * - Windows: %LOCALAPPDATA%/dexe-mcp
+ * - macOS:   ~/Library/Caches/dexe-mcp
+ * - Linux:   ~/.cache/dexe-mcp (XDG_CACHE_HOME if set)
+ */
+function getCacheDir() {
+    const os = platform();
+    if (os === "win32") {
+        const base = process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
+        return join(base, CACHE_DIR_NAME);
+    }
+    if (os === "darwin") {
+        return join(homedir(), "Library", "Caches", CACHE_DIR_NAME);
+    }
+    // Linux / others — respect XDG_CACHE_HOME
+    const base = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
+    return join(base, CACHE_DIR_NAME);
+}
+function log(msg) {
+    process.stderr.write(`[dexe-mcp] ${msg}\n`);
+}
+function runSync(cmd, cwd) {
+    execSync(cmd, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+}
+/**
+ * Ensures a DeXe-Protocol checkout is available, returning its absolute path.
+ *
+ * Priority:
+ *  1. `DEXE_PROTOCOL_PATH` env var (power-user override)
+ *  2. Auto-managed clone in the platform cache directory
+ *
+ * On first run the clone + npm install may take a few minutes.
+ * Progress is logged to stderr (stdout is the MCP protocol channel).
+ */
+export async function ensureProtocolCheckout() {
+    // ---- explicit override ----
+    const explicit = process.env.DEXE_PROTOCOL_PATH?.trim();
+    if (explicit)
+        return explicit;
+    // ---- auto-managed clone ----
+    const cacheDir = getCacheDir();
+    const protocolPath = join(cacheDir, CHECKOUT_DIR);
+    if (!existsSync(cacheDir)) {
+        mkdirSync(cacheDir, { recursive: true });
+    }
+    const gitDir = join(protocolPath, ".git");
+    if (!existsSync(gitDir)) {
+        log(`Cloning DeXe-Protocol (shallow, ~200 MB) into ${protocolPath} …`);
+        log("This only happens once. Subsequent launches will be instant.");
+        try {
+            runSync(`git clone --depth 1 ${REPO_URL} "${CHECKOUT_DIR}"`, cacheDir);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to clone DeXe-Protocol. Make sure git is installed and you have internet access.\n${msg}`);
+        }
+        log("Clone complete.");
+    }
+    // Ensure npm dependencies are installed
+    const nodeModules = join(protocolPath, "node_modules");
+    if (!existsSync(nodeModules)) {
+        log("Installing DeXe-Protocol npm dependencies (first run only) …");
+        try {
+            runSync("npm install", protocolPath);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`npm install failed in DeXe-Protocol checkout.\n${msg}`);
+        }
+        log("Dependencies installed.");
+    }
+    return protocolPath;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+export interface DexeConfig {
+    /** Absolute, normalized path to the DeXe-Protocol checkout. */
+    protocolPath: string;
+    /** Optional JSON-RPC endpoint for on-chain gov tools. */
+    rpcUrl?: string;
+    /** Optional fork block pin (Phase B). */
+    forkBlock?: number;
+}
+/**
+ * Validates environment and returns a frozen config.
+ *
+ * If `DEXE_PROTOCOL_PATH` is set, uses it directly (power-user override).
+ * Otherwise, auto-clones DeXe-Protocol into a platform cache directory.
+ *
+ * Exported primarily for the MCP entrypoint; tests can construct their own
+ * config objects directly.
+ */
+export declare function loadConfig(): Promise<DexeConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CA4BtD"}

package/dist/config.js

@@ -0,0 +1,40 @@
+import { existsSync, statSync } from "node:fs";
+import { resolve, join } from "node:path";
+import { ensureProtocolCheckout } from "./bootstrap.js";
+/**
+ * Validates environment and returns a frozen config.
+ *
+ * If `DEXE_PROTOCOL_PATH` is set, uses it directly (power-user override).
+ * Otherwise, auto-clones DeXe-Protocol into a platform cache directory.
+ *
+ * Exported primarily for the MCP entrypoint; tests can construct their own
+ * config objects directly.
+ */
+export async function loadConfig() {
+    const raw = await ensureProtocolCheckout();
+    const protocolPath = resolve(raw);
+    if (!existsSync(protocolPath) || !statSync(protocolPath).isDirectory()) {
+        fatal(`DeXe-Protocol path does not exist or is not a directory: ${protocolPath}`);
+    }
+    const hardhatConfig = join(protocolPath, "hardhat.config.js");
+    const hardhatConfigTs = join(protocolPath, "hardhat.config.ts");
+    if (!existsSync(hardhatConfig) && !existsSync(hardhatConfigTs)) {
+        fatal(`DeXe-Protocol path is not a Hardhat project — no hardhat.config.{js,ts} found at ${protocolPath}`);
+    }
+    const rpcUrl = process.env.DEXE_RPC_URL?.trim() || undefined;
+    let forkBlock;
+    if (process.env.DEXE_FORK_BLOCK) {
+        const n = Number(process.env.DEXE_FORK_BLOCK);
+        if (!Number.isFinite(n) || n < 0) {
+            fatal(`DEXE_FORK_BLOCK must be a non-negative integer, got: ${process.env.DEXE_FORK_BLOCK}`);
+        }
+        forkBlock = n;
+    }
+    return Object.freeze({ protocolPath, rpcUrl, forkBlock });
+}
+function fatal(msg) {
+    // stderr only — stdout is the MCP protocol channel.
+    process.stderr.write(`[dexe-mcp] fatal: ${msg}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAWxD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,GAAG,GAAG,MAAM,sBAAsB,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACvE,KAAK,CAAC,4DAA4D,YAAY,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/D,KAAK,CACH,oFAAoF,YAAY,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAE7D,IAAI,SAA6B,CAAC;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,wDAAwD,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,oDAAoD;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/hardhat.d.ts

@@ -0,0 +1,26 @@
+import type { DexeConfig } from "./config.js";
+/** Result of a shelled-out hardhat/npm invocation. */
+export interface RunResult {
+    exitCode: number;
+    /** Full captured stdout (uncapped — tools surface `stdoutTail` publicly). */
+    stdout: string;
+    stderr: string;
+    /** Last ~200 lines of stdout, joined with newlines. */
+    stdoutTail: string;
+    /** Last ~100 lines of stderr, joined with newlines. */
+    stderrTail: string;
+    /** Absolute path to a tmp file holding the full stdout+stderr log. */
+    logFile: string;
+    durationMs: number;
+    timedOut: boolean;
+}
+export declare class HardhatRunner {
+    private readonly config;
+    constructor(config: DexeConfig);
+    /** Run `npm run <script>` in the protocol directory. */
+    runNpmScript(script: string, extraArgs?: string[]): Promise<RunResult>;
+    /** Run `npx hardhat <subcommand> <args...>` in the protocol directory. */
+    runHardhat(subcommand: string, args?: string[]): Promise<RunResult>;
+    private run;
+}
+//# sourceMappingURL=hardhat.d.ts.map

package/dist/hardhat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardhat.d.ts","sourceRoot":"","sources":["../src/hardhat.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,sDAAsD;AACtD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAiBD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ1E,0EAA0E;IAC1E,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAIvE,OAAO,CAAC,GAAG;CAuDZ"}

package/dist/hardhat.js

@@ -0,0 +1,87 @@
+import { execa } from "execa";
+import pLimit from "p-limit";
+import { writeFileSync, mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const HARDHAT_TIMEOUT_MS = 10 * 60 * 1000;
+const STDOUT_TAIL_LINES = 200;
+const STDERR_TAIL_LINES = 100;
+// One hardhat invocation at a time per process. Hardhat doesn't parallelize well
+// across invocations against the same project, and solidity-coverage definitely
+// doesn't.
+const limit = pLimit(1);
+let tmpRoot = null;
+function getTmpRoot() {
+    if (!tmpRoot)
+        tmpRoot = mkdtempSync(join(tmpdir(), "dexe-mcp-"));
+    return tmpRoot;
+}
+export class HardhatRunner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Run `npm run <script>` in the protocol directory. */
+    runNpmScript(script, extraArgs = []) {
+        const args = ["run", script];
+        if (extraArgs.length > 0) {
+            args.push("--", ...extraArgs);
+        }
+        return this.run("npm", args, `npm-run-${script}`);
+    }
+    /** Run `npx hardhat <subcommand> <args...>` in the protocol directory. */
+    runHardhat(subcommand, args = []) {
+        return this.run("npx", ["hardhat", subcommand, ...args], `hardhat-${subcommand}`);
+    }
+    run(command, args, label) {
+        return limit(async () => {
+            const started = Date.now();
+            let timedOut = false;
+            const subprocess = execa(command, args, {
+                cwd: this.config.protocolPath,
+                timeout: HARDHAT_TIMEOUT_MS,
+                reject: false,
+                all: true,
+                env: { ...process.env, FORCE_COLOR: "0", CI: "1" },
+            });
+            // Best-effort: mirror child stderr to ours in near-real-time so the
+            // user sees progress in the MCP's stderr logs. The return value still
+            // captures everything.
+            subprocess.stderr?.on("data", (chunk) => {
+                process.stderr.write(chunk);
+            });
+            const result = await subprocess;
+            const durationMs = Date.now() - started;
+            const stdout = result.stdout ?? "";
+            const stderr = result.stderr ?? "";
+            if (result.timedOut)
+                timedOut = true;
+            const logFile = join(getTmpRoot(), `${label}-${started}.log`);
+            try {
+                writeFileSync(logFile, `$ ${command} ${args.join(" ")}\n(cwd: ${this.config.protocolPath})\n\n--- stdout ---\n${stdout}\n\n--- stderr ---\n${stderr}\n`);
+            }
+            catch {
+                // tmp write failure shouldn't fail the tool; the caller still gets tails.
+            }
+            return {
+                exitCode: typeof result.exitCode === "number" ? result.exitCode : -1,
+                stdout,
+                stderr,
+                stdoutTail: tailLines(stdout, STDOUT_TAIL_LINES),
+                stderrTail: tailLines(stderr, STDERR_TAIL_LINES),
+                logFile,
+                durationMs,
+                timedOut,
+            };
+        });
+    }
+}
+function tailLines(text, n) {
+    if (!text)
+        return "";
+    const lines = text.split(/\r?\n/);
+    if (lines.length <= n)
+        return lines.join("\n");
+    return lines.slice(-n).join("\n");
+}
+//# sourceMappingURL=hardhat.js.map

package/dist/hardhat.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { registerAll } from "./tools/index.js";
+async function main() {
+    const config = await loadConfig();
+    const server = new McpServer({ name: "dexe-mcp", version: "0.1.0" }, {
+        instructions: "Tools for the DeXe Protocol governance-DAO codebase. Before calling any dexe_get_* / dexe_list_contracts / dexe_find_selector tool, ensure artifacts exist by calling dexe_compile once per session. dexe_decode_proposal and dexe_read_gov_state require DEXE_RPC_URL to be set.",
+    });
+    registerAll(server, config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log-only, not protocol. stdout is the MCP channel.
+    process.stderr.write(`[dexe-mcp] connected on stdio. DEXE_PROTOCOL_PATH=${config.protocolPath}${config.rpcUrl ? " (rpc enabled)" : ""}\n`);
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.stack || err.message : String(err);
+    process.stderr.write(`[dexe-mcp] unhandled error:\n${msg}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC;QACE,YAAY,EACV,mRAAmR;KACtR,CACF,CAAC;IAEF,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qDAAqD,MAAM,CAAC,YAAY,GACtE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EACrC,IAAI,CACL,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/decoders.d.ts

@@ -0,0 +1,51 @@
+import type { Artifacts } from "../artifacts.js";
+import type { SelectorIndex } from "./selectors.js";
+export interface DecodedCall {
+    /** Which contract's ABI produced this decode. May be `null` if we used a bare selector match. */
+    contract: string | null;
+    sourceName: string | null;
+    signature: string;
+    selector: string;
+    /** Arguments as a plain object keyed by parameter name (falls back to positional `arg_0` keys). */
+    args: Record<string, unknown>;
+    /** Raw positional args — useful for agents that want the tuple directly. */
+    argsArray: unknown[];
+}
+export interface DecodedProposalAction {
+    side: "for" | "against";
+    executor: string;
+    value: string;
+    data: string;
+    /** Decoded call against the executor's ABI. `null` if we couldn't match. */
+    decoded: DecodedCall | null;
+}
+export declare class CalldataDecoder {
+    private readonly artifacts;
+    private readonly selectors;
+    constructor(artifacts: Artifacts, selectors: SelectorIndex);
+    /**
+     * Decode raw calldata. If `contractName` is given, only that contract's ABI
+     * is tried. Otherwise every artifact whose selector matches is tried in
+     * turn; the first successful parse wins (with alternatives in `.alternatives`).
+     */
+    decodeCalldata(data: string, contractName?: string): {
+        primary: DecodedCall | null;
+        alternatives: DecodedCall[];
+    };
+    /**
+     * Given a ProposalAction tuple, find the executor contract and decode `data`
+     * against its ABI. Strategy: try to find an artifact whose runtime bytecode
+     * is "close enough" via name fallback — but in practice we can't easily
+     * reverse-lookup an address to a contract type off-chain without an on-chain
+     * probe. So instead we rely on the selector index: decode purely by selector
+     * match across all loaded ABIs, which works for the DeXe proposal executors
+     * because each one has distinct signatures.
+     */
+    decodeProposalAction(action: {
+        executor: string;
+        value: bigint;
+        data: string;
+        side: "for" | "against";
+    }): DecodedProposalAction;
+}
+//# sourceMappingURL=decoders.d.ts.map

package/dist/lib/decoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoders.d.ts","sourceRoot":"","sources":["../../src/lib/decoders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,iGAAiG;IACjG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,aAAa;IAG3C;;;;OAIG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE;IA4C/D;;;;;;;;OAQG;IACH,oBAAoB,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;KACzB,GAAG,qBAAqB;CAU1B"}

package/dist/lib/decoders.js

@@ -0,0 +1,122 @@
+import { Interface } from "ethers";
+export class CalldataDecoder {
+    artifacts;
+    selectors;
+    constructor(artifacts, selectors) {
+        this.artifacts = artifacts;
+        this.selectors = selectors;
+    }
+    /**
+     * Decode raw calldata. If `contractName` is given, only that contract's ABI
+     * is tried. Otherwise every artifact whose selector matches is tried in
+     * turn; the first successful parse wins (with alternatives in `.alternatives`).
+     */
+    decodeCalldata(data, contractName) {
+        if (!data || data.length < 10 || !data.startsWith("0x")) {
+            return { primary: null, alternatives: [] };
+        }
+        const selector = data.slice(0, 10).toLowerCase();
+        if (contractName) {
+            const record = this.artifacts.get(contractName)[0];
+            if (!record)
+                return { primary: null, alternatives: [] };
+            const hit = tryDecodeWith(record.abi, data);
+            if (hit) {
+                return {
+                    primary: {
+                        contract: record.contractName,
+                        sourceName: record.sourceName,
+                        ...hit,
+                    },
+                    alternatives: [],
+                };
+            }
+            return { primary: null, alternatives: [] };
+        }
+        const candidates = this.selectors.find(selector).filter((h) => h.kind === "function");
+        const decoded = [];
+        const seen = new Set();
+        for (const cand of candidates) {
+            if (seen.has(cand.contract))
+                continue;
+            seen.add(cand.contract);
+            const records = this.artifacts.get(cand.contract);
+            for (const r of records) {
+                const hit = tryDecodeWith(r.abi, data);
+                if (hit) {
+                    decoded.push({ contract: r.contractName, sourceName: r.sourceName, ...hit });
+                    break;
+                }
+            }
+        }
+        if (decoded.length === 0) {
+            return { primary: null, alternatives: [] };
+        }
+        return { primary: decoded[0], alternatives: decoded.slice(1) };
+    }
+    /**
+     * Given a ProposalAction tuple, find the executor contract and decode `data`
+     * against its ABI. Strategy: try to find an artifact whose runtime bytecode
+     * is "close enough" via name fallback — but in practice we can't easily
+     * reverse-lookup an address to a contract type off-chain without an on-chain
+     * probe. So instead we rely on the selector index: decode purely by selector
+     * match across all loaded ABIs, which works for the DeXe proposal executors
+     * because each one has distinct signatures.
+     */
+    decodeProposalAction(action) {
+        const result = this.decodeCalldata(action.data);
+        return {
+            side: action.side,
+            executor: action.executor,
+            value: action.value.toString(),
+            data: action.data,
+            decoded: result.primary,
+        };
+    }
+}
+function tryDecodeWith(abi, data) {
+    let iface;
+    try {
+        iface = new Interface(abi);
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = iface.parseTransaction({ data });
+        if (!parsed)
+            return null;
+        return {
+            signature: parsed.fragment.format("sighash"),
+            selector: parsed.selector,
+            args: resultToObject(parsed.args, parsed.fragment.inputs.map((i) => i.name)),
+            argsArray: [...parsed.args].map(normalize),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function resultToObject(result, names) {
+    const out = {};
+    for (let i = 0; i < result.length; i++) {
+        const key = names[i] && names[i] !== "" ? names[i] : `arg_${i}`;
+        out[key] = normalize(result[i]);
+    }
+    return out;
+}
+function normalize(v) {
+    if (typeof v === "bigint")
+        return v.toString();
+    if (Array.isArray(v))
+        return v.map(normalize);
+    if (v && typeof v === "object") {
+        // ethers Result is an array-like with named keys; treat as array for JSON safety.
+        const asResult = v;
+        if (typeof asResult.toArray === "function") {
+            return asResult.toArray().map(normalize);
+        }
+    }
+    return v;
+}
+//# sourceMappingURL=decoders.js.map

package/dist/lib/decoders.js.map

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

package/dist/lib/govAddresses.d.ts

@@ -0,0 +1,35 @@
+import { type Provider } from "ethers";
+import type { Artifacts } from "../artifacts.js";
+/**
+ * Core helper contracts for a single GovPool instance, as returned by
+ * `GovPool.getHelperContracts()` on-chain.
+ *
+ * Note: proposal executors (DistributionProposal, StakingProposal,
+ * TokenSaleProposal) are NOT helpers of a pool — they're per-proposal targets
+ * referenced by the `executor` field on each ProposalAction. Discover them
+ * from the action itself, not from here.
+ */
+export interface GovHelpers {
+    settings: string;
+    userKeeper: string;
+    validators: string;
+    poolRegistry: string;
+    votePower: string;
+}
+/** Secondary NFT contracts exposed by `GovPool.getNftContracts()`. */
+export interface GovNftContracts {
+    nftMultiplier: string;
+    expertNft: string;
+    dexeExpertNft: string;
+    babt: string;
+}
+export declare class GovAddressResolver {
+    private readonly artifacts;
+    private helperCache;
+    private nftCache;
+    constructor(artifacts: Artifacts);
+    resolveHelpers(govPool: string, provider: Provider): Promise<GovHelpers>;
+    resolveNftContracts(govPool: string, provider: Provider): Promise<GovNftContracts>;
+    private loadGovPoolAbi;
+}
+//# sourceMappingURL=govAddresses.d.ts.map

package/dist/lib/govAddresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"govAddresses.d.ts","sourceRoot":"","sources":["../../src/lib/govAddresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAsC;gBAEzB,SAAS,EAAE,SAAS;IAE3C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAexE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAexF,OAAO,CAAC,cAAc;CASvB"}

package/dist/lib/govAddresses.js

@@ -0,0 +1,51 @@
+import { Contract } from "ethers";
+// Hand-written fragment so this module doesn't require GovPool artifacts to be
+// compiled. If you later want to swap in the real ABI, `artifacts.getOne("GovPool").abi`
+// works the same.
+const HELPER_ABI = [
+    "function getHelperContracts() view returns (address settings, address userKeeper, address validators, address poolRegistry, address votePower)",
+    "function getNftContracts() view returns (address nftMultiplier, address expertNft, address dexeExpertNft, address babt)",
+];
+export class GovAddressResolver {
+    artifacts;
+    helperCache = new Map();
+    nftCache = new Map();
+    constructor(artifacts) {
+        this.artifacts = artifacts;
+    }
+    async resolveHelpers(govPool, provider) {
+        const key = govPool.toLowerCase();
+        const cached = this.helperCache.get(key);
+        if (cached)
+            return cached;
+        const abi = this.loadGovPoolAbi() ?? HELPER_ABI;
+        const pool = new Contract(govPool, abi, provider);
+        const [settings, userKeeper, validators, poolRegistry, votePower] = await pool.getFunction("getHelperContracts")();
+        const helpers = { settings, userKeeper, validators, poolRegistry, votePower };
+        this.helperCache.set(key, helpers);
+        return helpers;
+    }
+    async resolveNftContracts(govPool, provider) {
+        const key = govPool.toLowerCase();
+        const cached = this.nftCache.get(key);
+        if (cached)
+            return cached;
+        const abi = this.loadGovPoolAbi() ?? HELPER_ABI;
+        const pool = new Contract(govPool, abi, provider);
+        const [nftMultiplier, expertNft, dexeExpertNft, babt] = await pool.getFunction("getNftContracts")();
+        const result = { nftMultiplier, expertNft, dexeExpertNft, babt };
+        this.nftCache.set(key, result);
+        return result;
+    }
+    loadGovPoolAbi() {
+        try {
+            this.artifacts.requireArtifactsExist();
+            const records = this.artifacts.get("GovPool");
+            return records[0]?.abi ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=govAddresses.js.map

package/dist/lib/govAddresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"govAddresses.js","sourceRoot":"","sources":["../../src/lib/govAddresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoC,MAAM,QAAQ,CAAC;AA4BpE,+EAA+E;AAC/E,yFAAyF;AACzF,kBAAkB;AAClB,MAAM,UAAU,GAAG;IACjB,gJAAgJ;IAChJ,yHAAyH;CAC1H,CAAC;AAEF,MAAM,OAAO,kBAAkB;IAIA;IAHrB,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,QAAkB;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,IAAK,UAA2B,CAAC;QAClE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CACxF,oBAAoB,CACrB,EAAE,CAAC;QACJ,MAAM,OAAO,GAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QAC1F,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,QAAkB;QAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,IAAK,UAA2B,CAAC;QAClE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAC5E,iBAAiB,CAClB,EAAE,CAAC;QACJ,MAAM,MAAM,GAAoB,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC9C,OAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,GAAgC,IAAI,IAAI,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/lib/selectors.d.ts

@@ -0,0 +1,31 @@
+import type { Artifacts } from "../artifacts.js";
+export type SelectorKind = "function" | "event" | "error";
+export interface SelectorHit {
+    contract: string;
+    sourceName: string;
+    signature: string;
+    selector: string;
+    kind: SelectorKind;
+}
+/**
+ * Lazy, memoized selector index over all loaded contract artifacts.
+ * Built on first query; invalidated when the underlying artifact cache is.
+ * Supports collisions — the same 4-byte selector can appear in multiple contracts.
+ */
+export declare class SelectorIndex {
+    private readonly artifacts;
+    private built;
+    private byFunctionSelector;
+    private byEventTopic;
+    private byErrorSelector;
+    private lastCacheStamp;
+    constructor(artifacts: Artifacts);
+    /** Build the index (idempotent). Called automatically by find/forContract. */
+    private ensureBuilt;
+    private indexContract;
+    /** Look up a selector or event topic. Accepts function selector (4B), error selector (4B), or event topic (32B). */
+    find(selector: string): SelectorHit[];
+    /** All selectors exposed by a single contract. */
+    forContract(contractName: string): SelectorHit[];
+}
+//# sourceMappingURL=selectors.d.ts.map

package/dist/lib/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/lib/selectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IAOZ,OAAO,CAAC,QAAQ,CAAC,SAAS;IANtC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,cAAc,CAAiB;gBAEV,SAAS,EAAE,SAAS;IAEjD,8EAA8E;IAC9E,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;IA0CrB,oHAAoH;IACpH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAUrC,kDAAkD;IAClD,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE;CAcjD"}