dexe-mcp 0.1.3 → 0.2.0

package/dist/hardhat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hardhat.d.ts","sourceRoot":"","sources":["../src/hardhat.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,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;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAQhF;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAW7E,OAAO,CAAC,GAAG;CAuDZ"}
+{"version":3,"file":"hardhat.d.ts","sourceRoot":"","sources":["../src/hardhat.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,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;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAchF;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAqB7E,OAAO,CAAC,GAAG;CA+DZ"}

package/dist/hardhat.js

@@ -4,7 +4,7 @@ import { writeFileSync, mkdtempSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ensureBuildReady } from "./bootstrap.js";
-import { hardhatCommand, npmCommand } from "./runtime.js";
+import { envWithNodeBinDir, hardhatCommand, npmCommand } from "./runtime.js";
 const HARDHAT_TIMEOUT_MS = 10 * 60 * 1000;
 const STDOUT_TAIL_LINES = 200;
 const STDERR_TAIL_LINES = 100;
@@ -35,7 +35,7 @@ export class HardhatRunner {
         const args = [...npm.prefixArgs, "run", script];
         if (extraArgs.length > 0)
             args.push("--", ...extraArgs);
-        return this.run(npm.command, args, `npm-run-${script}`);
+        return this.run(npm.command, args, `npm-run-${script}`, npm.needsShell, envWithNodeBinDir(npm.binDir));
     }
     /**
      * Run `hardhat <subcommand> <args...>` in the protocol directory.
@@ -49,9 +49,13 @@ export class HardhatRunner {
         if (!hh) {
             throw new Error(`Hardhat is not installed inside ${this.config.protocolPath}. This should have been fixed by ensureBuildReady — did npm install fail?`);
         }
-        return this.run(hh.command, [...hh.prefixArgs, subcommand, ...args], `hardhat-${subcommand}`);
+        // Hardhat is invoked via `node <cli.js>`, which has zero PATH dependency
+        // for the command itself, but the hardhat task may still spawn helpers
+        // that look for npx on PATH — keep the bin dir prepended to be safe.
+        const npm = npmCommand();
+        return this.run(hh.command, [...hh.prefixArgs, subcommand, ...args], `hardhat-${subcommand}`, false, envWithNodeBinDir(npm.binDir));
     }
-    run(command, args, label) {
+    run(command, args, label, useShell, extraEnv) {
         return limit(async () => {
             const started = Date.now();
             let timedOut = false;
@@ -60,7 +64,8 @@ export class HardhatRunner {
                 timeout: HARDHAT_TIMEOUT_MS,
                 reject: false,
                 all: true,
-                env: { ...process.env, FORCE_COLOR: "0", CI: "1" },
+                env: { ...extraEnv, FORCE_COLOR: "0", CI: "1" },
+                shell: useShell,
             });
             // 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

package/dist/hardhat.js.map

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

package/dist/index.js

@@ -5,7 +5,7 @@ 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.3" }, {
+    const server = new McpServer({ name: "dexe-mcp", version: "0.1.5" }, {
         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);

package/dist/lib/addresses.d.ts

@@ -0,0 +1,57 @@
+import { JsonRpcProvider } from "ethers";
+/**
+ * Per-chain `ContractsRegistry` root addresses. Every other DeXe protocol
+ * contract is resolved through `ContractsRegistry.getContract(name)` at
+ * runtime, so we only need to know the root per chain. Users can override with
+ * `DEXE_CONTRACTS_REGISTRY`.
+ *
+ * NOTE: the BSC mainnet address below matches the value shipped in the DeXe
+ * frontend env. Add more chains as they come online.
+ */
+export declare const CONTRACTS_REGISTRY_BY_CHAIN: Record<number, string>;
+/**
+ * Canonical contract names used as keys inside `ContractsRegistry`. Mirrors
+ * constants in `contracts/core/ContractsRegistry.sol` and
+ * `contracts/factory/PoolRegistry.sol` (DeXe-Protocol).
+ */
+export declare const CONTRACT_NAMES: {
+    readonly POOL_FACTORY: "POOL_FACTORY";
+    readonly POOL_REGISTRY: "POOL_REGISTRY";
+    readonly USER_REGISTRY: "USER_REGISTRY";
+    readonly CORE_PROPERTIES: "CORE_PROPERTIES";
+    readonly NETWORK_PROPERTIES: "NETWORK_PROPERTIES";
+    readonly PRICE_FEED: "PRICE_FEED";
+    readonly TREASURY: "TREASURY";
+    readonly DEXE: "DEXE";
+    readonly WETH: "WETH";
+    readonly USD: "USD";
+    readonly BABT: "BABT";
+    readonly DEXE_EXPERT_NFT: "DEXE_EXPERT_NFT";
+    readonly TOKEN_ALLOCATOR: "TOKEN_ALLOCATOR";
+};
+export type ContractName = (typeof CONTRACT_NAMES)[keyof typeof CONTRACT_NAMES];
+export interface AddressBookConfig {
+    readonly provider: JsonRpcProvider;
+    readonly chainId: number;
+    /** Optional override for the `ContractsRegistry` root. */
+    readonly registryOverride?: string;
+}
+/**
+ * Lazy, cached resolver for DeXe core contract addresses on a given chain.
+ * First call for each name hits RPC; subsequent calls return from the in-memory
+ * cache.
+ */
+export declare class AddressBook {
+    private readonly cfg;
+    private readonly cache;
+    private readonly registry;
+    readonly registryAddress: string;
+    readonly provider: JsonRpcProvider;
+    readonly chainId: number;
+    constructor(cfg: AddressBookConfig);
+    /** Resolve a canonical contract name to its deployed address on this chain. */
+    resolve(name: string): Promise<string>;
+    /** Resolve many at once (sequential — registry getContract is cheap). */
+    resolveMany(names: string[]): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=addresses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../src/lib/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,eAAe,EAAe,MAAM,QAAQ,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAcjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAOhF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,GAAG;IANhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEI,GAAG,EAAE,iBAAiB;IAgBnD,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc5C,yEAAyE;IACnE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAKpE"}

package/dist/lib/addresses.js

@@ -0,0 +1,83 @@
+import { Contract, ZeroAddress } from "ethers";
+/**
+ * Per-chain `ContractsRegistry` root addresses. Every other DeXe protocol
+ * contract is resolved through `ContractsRegistry.getContract(name)` at
+ * runtime, so we only need to know the root per chain. Users can override with
+ * `DEXE_CONTRACTS_REGISTRY`.
+ *
+ * NOTE: the BSC mainnet address below matches the value shipped in the DeXe
+ * frontend env. Add more chains as they come online.
+ */
+export const CONTRACTS_REGISTRY_BY_CHAIN = {
+    56: "0xB1795e79a095c1aa40BA754d74F145Dc07B2Faf5",
+};
+/**
+ * Canonical contract names used as keys inside `ContractsRegistry`. Mirrors
+ * constants in `contracts/core/ContractsRegistry.sol` and
+ * `contracts/factory/PoolRegistry.sol` (DeXe-Protocol).
+ */
+export const CONTRACT_NAMES = {
+    POOL_FACTORY: "POOL_FACTORY",
+    POOL_REGISTRY: "POOL_REGISTRY",
+    USER_REGISTRY: "USER_REGISTRY",
+    CORE_PROPERTIES: "CORE_PROPERTIES",
+    NETWORK_PROPERTIES: "NETWORK_PROPERTIES",
+    PRICE_FEED: "PRICE_FEED",
+    TREASURY: "TREASURY",
+    DEXE: "DEXE",
+    WETH: "WETH",
+    USD: "USD",
+    BABT: "BABT",
+    DEXE_EXPERT_NFT: "DEXE_EXPERT_NFT",
+    TOKEN_ALLOCATOR: "TOKEN_ALLOCATOR",
+};
+const REGISTRY_ABI = [
+    "function getContract(string memory name) external view returns (address)",
+    "function hasContract(string memory name) external view returns (bool)",
+];
+/**
+ * Lazy, cached resolver for DeXe core contract addresses on a given chain.
+ * First call for each name hits RPC; subsequent calls return from the in-memory
+ * cache.
+ */
+export class AddressBook {
+    cfg;
+    cache = new Map();
+    registry;
+    registryAddress;
+    provider;
+    chainId;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.provider = cfg.provider;
+        this.chainId = cfg.chainId;
+        const addr = cfg.registryOverride ?? CONTRACTS_REGISTRY_BY_CHAIN[cfg.chainId];
+        if (!addr) {
+            throw new Error(`No ContractsRegistry address known for chainId=${cfg.chainId}. ` +
+                `Set DEXE_CONTRACTS_REGISTRY or pick a supported chain (${Object.keys(CONTRACTS_REGISTRY_BY_CHAIN).join(", ")}).`);
+        }
+        this.registryAddress = addr;
+        this.registry = new Contract(addr, REGISTRY_ABI, cfg.provider);
+    }
+    /** Resolve a canonical contract name to its deployed address on this chain. */
+    async resolve(name) {
+        const hit = this.cache.get(name);
+        if (hit)
+            return hit;
+        const addr = await this.registry.getFunction("getContract").staticCall(name);
+        if (!addr || addr === ZeroAddress) {
+            throw new Error(`ContractsRegistry has no entry for "${name}" on chainId=${this.cfg.chainId}. ` +
+                `Double-check the name — see CONTRACT_NAMES in src/lib/addresses.ts.`);
+        }
+        this.cache.set(name, addr);
+        return addr;
+    }
+    /** Resolve many at once (sequential — registry getContract is cheap). */
+    async resolveMany(names) {
+        const out = {};
+        for (const n of names)
+            out[n] = await this.resolve(n);
+        return out;
+    }
+}
+//# sourceMappingURL=addresses.js.map

package/dist/lib/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../src/lib/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA2B;IACjE,EAAE,EAAE,4CAA4C;CACjD,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IACxC,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAIX,MAAM,YAAY,GAAG;IACnB,0EAA0E;IAC1E,uEAAuE;CAC/D,CAAC;AASX;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAOO;IANZ,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,QAAQ,CAAW;IAC3B,eAAe,CAAS;IACxB,QAAQ,CAAkB;IAC1B,OAAO,CAAS;IAEzB,YAA6B,GAAsB;QAAtB,QAAG,GAAH,GAAG,CAAmB;QACjD,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,kDAAkD,GAAG,CAAC,OAAO,IAAI;gBAC/D,0DAA0D,MAAM,CAAC,IAAI,CACnE,2BAA2B,CAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,IAAI,GAAW,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,gBAAgB,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI;gBAC7E,qEAAqE,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,WAAW,CAAC,KAAe;QAC/B,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/lib/calldata.d.ts

@@ -0,0 +1,32 @@
+import { Interface } from "ethers";
+/**
+ * Canonical signable payload shape returned by every `*_build_*` tool.
+ * Consumers (agent wallets, Safe, etc.) can feed this straight into
+ * `eth_sendTransaction` / `personal_signTypedData` flows.
+ */
+export interface TxPayload {
+    /** Destination contract address. */
+    to: string;
+    /** ABI-encoded call data (0x-prefixed hex). */
+    data: string;
+    /** Wei value as decimal string ("0" if none). */
+    value: string;
+    /** Target chain id. */
+    chainId: number;
+    /** Human-readable action label, e.g. "GovPool.vote(123, true, 1000000000000000000, [])". */
+    description: string;
+}
+export interface BuildPayloadOpts {
+    to: string;
+    iface: Interface;
+    method: string;
+    args: readonly unknown[];
+    chainId: number;
+    value?: bigint | string | number;
+    /** Optional override; otherwise we auto-generate `Contract.method(args…)`. */
+    description?: string;
+    /** Contract label used in auto-generated description. */
+    contractLabel?: string;
+}
+export declare function buildPayload(opts: BuildPayloadOpts): TxPayload;
+//# sourceMappingURL=calldata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calldata.d.ts","sourceRoot":"","sources":["../../src/lib/calldata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAY9D"}

package/dist/lib/calldata.js

@@ -0,0 +1,28 @@
+export function buildPayload(opts) {
+    const data = opts.iface.encodeFunctionData(opts.method, opts.args);
+    const value = (opts.value ?? 0n).toString();
+    const description = opts.description ?? `${opts.contractLabel ?? "Contract"}.${opts.method}(${formatArgs(opts.args)})`;
+    return {
+        to: opts.to,
+        data,
+        value,
+        chainId: opts.chainId,
+        description,
+    };
+}
+function formatArgs(args) {
+    return args
+        .map((a) => {
+        if (typeof a === "bigint")
+            return a.toString();
+        if (typeof a === "string")
+            return a.length > 42 ? `${a.slice(0, 10)}…` : a;
+        if (Array.isArray(a))
+            return `[${a.length}]`;
+        if (a && typeof a === "object")
+            return "{…}";
+        return String(a);
+    })
+        .join(", ");
+}
+//# sourceMappingURL=calldata.js.map

package/dist/lib/calldata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calldata.js","sourceRoot":"","sources":["../../src/lib/calldata.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,YAAY,CAAC,IAAsB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,aAAa,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACrG,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAwB;IAC1C,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAC7C,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/lib/govEnums.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mirror of `IGovPool.ProposalState` (contracts/interfaces/gov/IGovPool.sol).
+ * Order must match the Solidity enum exactly.
+ */
+export declare const PROPOSAL_STATE_NAMES: readonly ["Voting", "WaitingForVotingTransfer", "ValidatorVoting", "Defeated", "SucceededFor", "SucceededAgainst", "Locked", "ExecutedFor", "ExecutedAgainst", "Undefined"];
+export type ProposalStateName = (typeof PROPOSAL_STATE_NAMES)[number];
+export declare function proposalStateLabel(n: bigint | number): ProposalStateName;
+/** Mirror of `IGovPool.VoteType`. */
+export declare const VOTE_TYPE_NAMES: readonly ["PersonalVote", "MicropoolVote", "DelegatedVote", "TreasuryVote"];
+export type VoteTypeName = (typeof VOTE_TYPE_NAMES)[number];
+export declare function voteTypeFromString(s: string): number;
+//# sourceMappingURL=govEnums.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"govEnums.d.ts","sourceRoot":"","sources":["../../src/lib/govEnums.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6KAWvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAGxE;AAED,qCAAqC;AACrC,eAAO,MAAM,eAAe,6EAKlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQpD"}

package/dist/lib/govEnums.js

@@ -0,0 +1,35 @@
+/**
+ * Mirror of `IGovPool.ProposalState` (contracts/interfaces/gov/IGovPool.sol).
+ * Order must match the Solidity enum exactly.
+ */
+export const PROPOSAL_STATE_NAMES = [
+    "Voting",
+    "WaitingForVotingTransfer",
+    "ValidatorVoting",
+    "Defeated",
+    "SucceededFor",
+    "SucceededAgainst",
+    "Locked",
+    "ExecutedFor",
+    "ExecutedAgainst",
+    "Undefined",
+];
+export function proposalStateLabel(n) {
+    const i = typeof n === "bigint" ? Number(n) : n;
+    return PROPOSAL_STATE_NAMES[i] ?? "Undefined";
+}
+/** Mirror of `IGovPool.VoteType`. */
+export const VOTE_TYPE_NAMES = [
+    "PersonalVote",
+    "MicropoolVote",
+    "DelegatedVote",
+    "TreasuryVote",
+];
+export function voteTypeFromString(s) {
+    const i = VOTE_TYPE_NAMES.indexOf(s);
+    if (i < 0) {
+        throw new Error(`Unknown voteType "${s}". Valid: ${VOTE_TYPE_NAMES.join(", ")}`);
+    }
+    return i;
+}
+//# sourceMappingURL=govEnums.js.map

package/dist/lib/govEnums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"govEnums.js","sourceRoot":"","sources":["../../src/lib/govEnums.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,0BAA0B;IAC1B,iBAAiB;IACjB,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,QAAQ;IACR,aAAa;IACb,iBAAiB;IACjB,WAAW;CACH,CAAC;AAIX,MAAM,UAAU,kBAAkB,CAAC,CAAkB;IACnD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,oBAAoB,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;AAChD,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc;IACd,eAAe;IACf,eAAe;IACf,cAAc;CACN,CAAC;AAIX,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAiB,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,qBAAqB,CAAC,aAAa,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/lib/ipfs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Public IPFS gateways (dweb.link, ipfs.io, cf-ipfs.com, …) are unreliable —
+ * frequent 502s, rate limits, and extended outages in 2025/2026. We do NOT
+ * ship a default public-gateway chain. Callers must configure a dedicated
+ * gateway via `DEXE_IPFS_GATEWAY` (e.g. the user's Pinata dedicated gateway,
+ * Filebase, Quicknode, or a self-hosted one). Public gateways may be
+ * opted-in as a best-effort fallback via `DEXE_IPFS_GATEWAYS_FALLBACK`.
+ */
+export declare const NO_DEFAULT_GATEWAYS: readonly string[];
+export interface IpfsFetchConfig {
+    gateways: readonly string[];
+    /** Per-hop timeout in ms. Default 4000. */
+    perRequestTimeoutMs?: number;
+}
+export interface IpfsFetchResult {
+    cid: string;
+    gateway: string;
+    contentType: string;
+    bytes: Uint8Array;
+    /** JSON-parsed body if content-type is JSON; null otherwise. */
+    json: unknown | null;
+    /** Total attempts made (including failures before success). */
+    attempts: number;
+}
+export declare function fetchIpfs(cid: string, cfg: IpfsFetchConfig): Promise<IpfsFetchResult>;
+export interface CidInfo {
+    cid: string;
+    version: 0 | 1;
+    codec: string;
+    multihash: string;
+    /** Same CID in the other version if conversion is legal (v1 ↔ v0 only for dag-pb/sha-256). */
+    alternate: string | null;
+}
+export declare function parseCid(input: string): CidInfo;
+export declare function stripIpfsPrefix(s: string): string;
+/** Compute the CIDv1 for arbitrary JSON locally — no network. */
+export declare function cidForJson(value: unknown): Promise<string>;
+/** Compute the CIDv1 (raw codec) for arbitrary bytes locally. */
+export declare function cidForBytes(bytes: Uint8Array): Promise<string>;
+export interface PinataPinResult {
+    cid: string;
+    size: number;
+    pinnedAt: string;
+}
+export declare class PinataClient {
+    private readonly jwt;
+    constructor(jwt: string);
+    /** Verify the JWT — cheap sanity check before an upload. */
+    ping(): Promise<void>;
+    pinJson(payload: unknown, opts?: {
+        name?: string;
+        keyvalues?: Record<string, string>;
+    }): Promise<PinataPinResult>;
+    pinFile(bytes: Uint8Array, opts?: {
+        fileName?: string;
+        contentType?: string;
+        name?: string;
+    }): Promise<PinataPinResult>;
+}
+//# sourceMappingURL=ipfs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../../src/lib/ipfs.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAO,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAID,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAoB/C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iEAAiE;AACjE,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhE;AAED,iEAAiE;AACjE,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE;AAyBD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAIxC,4DAA4D;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC3D,OAAO,CAAC,eAAe,CAAC;IA0BrB,OAAO,CACX,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,eAAe,CAAC;CAwB5B"}

package/dist/lib/ipfs.js

@@ -0,0 +1,167 @@
+import { CID } from "multiformats/cid";
+import * as json from "multiformats/codecs/json";
+import * as raw from "multiformats/codecs/raw";
+import { sha256 } from "multiformats/hashes/sha2";
+import { base32 } from "multiformats/bases/base32";
+import { base58btc } from "multiformats/bases/base58";
+/**
+ * Public IPFS gateways (dweb.link, ipfs.io, cf-ipfs.com, …) are unreliable —
+ * frequent 502s, rate limits, and extended outages in 2025/2026. We do NOT
+ * ship a default public-gateway chain. Callers must configure a dedicated
+ * gateway via `DEXE_IPFS_GATEWAY` (e.g. the user's Pinata dedicated gateway,
+ * Filebase, Quicknode, or a self-hosted one). Public gateways may be
+ * opted-in as a best-effort fallback via `DEXE_IPFS_GATEWAYS_FALLBACK`.
+ */
+export const NO_DEFAULT_GATEWAYS = [];
+export async function fetchIpfs(cid, cfg) {
+    const parsed = CID.parse(stripIpfsPrefix(cid));
+    const cidStr = parsed.toString();
+    const timeout = cfg.perRequestTimeoutMs ?? 4000;
+    const errors = [];
+    let attempts = 0;
+    for (const gw of cfg.gateways) {
+        attempts++;
+        const url = `${gw.replace(/\/$/, "")}/ipfs/${cidStr}`;
+        const controller = new AbortController();
+        const t = setTimeout(() => controller.abort(), timeout);
+        try {
+            const res = await fetch(url, { signal: controller.signal });
+            if (!res.ok) {
+                errors.push(`${gw} → HTTP ${res.status}`);
+                continue;
+            }
+            const contentType = res.headers.get("content-type") ?? "application/octet-stream";
+            const bytes = new Uint8Array(await res.arrayBuffer());
+            let parsedJson = null;
+            if (contentType.includes("json") || contentType.includes("text")) {
+                try {
+                    parsedJson = JSON.parse(new TextDecoder().decode(bytes));
+                }
+                catch {
+                    // not JSON — that's fine
+                }
+            }
+            return { cid: cidStr, gateway: gw, contentType, bytes, json: parsedJson, attempts };
+        }
+        catch (err) {
+            errors.push(`${gw} → ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearTimeout(t);
+        }
+    }
+    throw new Error(`IPFS fetch failed for ${cidStr} across ${attempts} gateway(s): ${errors.join("; ")}`);
+}
+export function parseCid(input) {
+    const s = stripIpfsPrefix(input);
+    const cid = CID.parse(s);
+    const version = cid.version;
+    const codec = codecName(cid.code);
+    const multihash = base58btc.encode(cid.multihash.bytes).slice(1);
+    let alternate = null;
+    try {
+        if (version === 0) {
+            alternate = cid.toV1().toString(base32);
+        }
+        else if (version === 1 && cid.code === 0x70) {
+            // only dag-pb v1 is legal to downgrade to v0
+            alternate = cid.toV0().toString();
+        }
+    }
+    catch {
+        alternate = null;
+    }
+    return { cid: cid.toString(), version, codec, multihash, alternate };
+}
+export function stripIpfsPrefix(s) {
+    return s.replace(/^ipfs:\/\//, "").replace(/^\/?ipfs\//, "");
+}
+/** Compute the CIDv1 for arbitrary JSON locally — no network. */
+export async function cidForJson(value) {
+    const bytes = json.encode(value);
+    const hash = await sha256.digest(bytes);
+    return CID.create(1, json.code, hash).toString(base32);
+}
+/** Compute the CIDv1 (raw codec) for arbitrary bytes locally. */
+export async function cidForBytes(bytes) {
+    const hash = await sha256.digest(bytes);
+    return CID.create(1, raw.code, hash).toString(base32);
+}
+function codecName(code) {
+    switch (code) {
+        case 0x55:
+            return "raw";
+        case 0x70:
+            return "dag-pb";
+        case 0x71:
+            return "dag-cbor";
+        case 0x0200:
+            return "json";
+        case 0x0129:
+            return "dag-json";
+        default:
+            return `0x${code.toString(16)}`;
+    }
+}
+// ---------- Pinata upload ----------
+const PINATA_PIN_JSON_URL = "https://api.pinata.cloud/pinning/pinJSONToIPFS";
+const PINATA_PIN_FILE_URL = "https://api.pinata.cloud/pinning/pinFileToIPFS";
+const PINATA_USER_URL = "https://api.pinata.cloud/data/testAuthentication";
+export class PinataClient {
+    jwt;
+    constructor(jwt) {
+        this.jwt = jwt;
+        if (!jwt)
+            throw new Error("Pinata JWT is required");
+    }
+    /** Verify the JWT — cheap sanity check before an upload. */
+    async ping() {
+        const res = await fetch(PINATA_USER_URL, {
+            headers: { Authorization: `Bearer ${this.jwt}` },
+        });
+        if (!res.ok)
+            throw new Error(`Pinata auth failed: HTTP ${res.status} ${await res.text()}`);
+    }
+    async pinJson(payload, opts) {
+        const body = {
+            pinataContent: payload,
+            pinataMetadata: opts?.name || opts?.keyvalues
+                ? { name: opts?.name, keyvalues: opts?.keyvalues }
+                : undefined,
+        };
+        const res = await fetch(PINATA_PIN_JSON_URL, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.jwt}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw new Error(`Pinata pinJSON failed: HTTP ${res.status} ${await res.text()}`);
+        }
+        const data = (await res.json());
+        return { cid: data.IpfsHash, size: data.PinSize, pinnedAt: data.Timestamp };
+    }
+    async pinFile(bytes, opts) {
+        const form = new FormData();
+        const blob = new Blob([bytes], {
+            type: opts?.contentType ?? "application/octet-stream",
+        });
+        form.append("file", blob, opts?.fileName ?? "file");
+        if (opts?.name) {
+            form.append("pinataMetadata", JSON.stringify({ name: opts.name }));
+        }
+        const res = await fetch(PINATA_PIN_FILE_URL, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.jwt}` },
+            body: form,
+        });
+        if (!res.ok) {
+            throw new Error(`Pinata pinFile failed: HTTP ${res.status} ${await res.text()}`);
+        }
+        const data = (await res.json());
+        return { cid: data.IpfsHash, size: data.PinSize, pinnedAt: data.Timestamp };
+    }
+}
+//# sourceMappingURL=ipfs.js.map

package/dist/lib/ipfs.js.map

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

package/dist/lib/multicall.d.ts

@@ -0,0 +1,33 @@
+import { Interface, JsonRpcProvider } from "ethers";
+/**
+ * Multicall3 — deployed at the same address on ~every EVM chain.
+ * https://www.multicall3.com
+ */
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+export interface Call {
+    /** Target contract address. */
+    target: string;
+    /** ABI fragment or full Interface covering `method`. */
+    iface: Interface;
+    /** Method name or full signature. */
+    method: string;
+    /** Positional args (empty array if none). */
+    args: readonly unknown[];
+    /** If true, failures don't revert the whole batch (decoded as `null`). */
+    allowFailure?: boolean;
+}
+export interface CallResult<T = unknown> {
+    success: boolean;
+    value: T | null;
+    /** Hex-encoded raw return data. */
+    raw: string;
+    /** Error message if decoding failed or call reverted with allowFailure. */
+    error?: string;
+}
+/**
+ * Batch `calls` into a single Multicall3 aggregate3 RPC round-trip. Each call
+ * is decoded via its own `iface`. Failed calls with `allowFailure: true`
+ * yield `{ success: false, value: null }` instead of throwing.
+ */
+export declare function multicall(provider: JsonRpcProvider, calls: Call[]): Promise<CallResult[]>;
+//# sourceMappingURL=multicall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../../src/lib/multicall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAM/E,MAAM,WAAW,IAAI;IACnB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC,CAgCvB"}