dexe-mcp 0.5.8 → 0.7.0

package/dist/governor/tally.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Tally GraphQL parity harness — W4 of research/06-execution-plan.md.
+ *
+ * Tally exposes proposal state as a string enum
+ * (PENDING / ACTIVE / CANCELED / DEFEATED / SUCCEEDED / QUEUED / EXPIRED /
+ *  EXECUTED / EXTENDED / ...). We project Tally's string back onto OZ's
+ * numeric enum and compare to our `state()` result. Mismatch on any of the 30
+ * sampled proposals fails the harness — see plan §2 state-parity metric.
+ *
+ * Live runs require TALLY_API_KEY (free at https://www.tally.xyz/user/api-keys).
+ * When unset the test file marks parity tests as skipped — we keep the
+ * comparison logic itself under unit test against synthetic fixtures.
+ */
+export interface TallyProposalSnapshot {
+    /** Tally-side stringly-typed state. */
+    status: string;
+    /** Numeric proposal id on the governor (uint256 decimal string). */
+    onchainId: string;
+}
+export interface ParityCheckRow {
+    proposalId: string;
+    expected: {
+        source: "tally";
+        status: string;
+        mappedIndex: number | null;
+    };
+    actual: {
+        source: "rpc";
+        index: number;
+        name: string;
+    };
+    match: boolean;
+}
+export declare function mapTallyStatusToIndex(status: string): number | null;
+export declare function compareStateEnum(proposalId: string, tally: TallyProposalSnapshot, actualStateIndex: number): ParityCheckRow;
+/**
+ * Tally GraphQL query for governor proposals. Caller passes governor ID in
+ * Tally's `eip155:<chainId>:<address>` form. Returns `limit` most-recent
+ * proposals.
+ */
+export declare const TALLY_PROPOSALS_QUERY = "\n  query Proposals($input: ProposalsInput!) {\n    proposals(input: $input) {\n      nodes {\n        ... on Proposal {\n          onchainId\n          status\n        }\n      }\n    }\n  }\n";
+export interface TallyClient {
+    apiKey: string;
+    endpoint?: string;
+}
+export declare function fetchTallyProposals(client: TallyClient, governorChainAddress: string, limit: number): Promise<TallyProposalSnapshot[]>;
+export declare function tallyGovernorId(chainId: number, address: string): string;
+//# sourceMappingURL=tally.d.ts.map

package/dist/governor/tally.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tally.d.ts","sourceRoot":"","sources":["../../src/governor/tally.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1E,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,EAAE,OAAO,CAAC;CAChB;AAuBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,MAAM,GACvB,cAAc,CAahB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,sMAWjC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,oBAAoB,EAAE,MAAM,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA4BlC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/governor/tally.js

@@ -0,0 +1,103 @@
+/**
+ * Tally GraphQL parity harness — W4 of research/06-execution-plan.md.
+ *
+ * Tally exposes proposal state as a string enum
+ * (PENDING / ACTIVE / CANCELED / DEFEATED / SUCCEEDED / QUEUED / EXPIRED /
+ *  EXECUTED / EXTENDED / ...). We project Tally's string back onto OZ's
+ * numeric enum and compare to our `state()` result. Mismatch on any of the 30
+ * sampled proposals fails the harness — see plan §2 state-parity metric.
+ *
+ * Live runs require TALLY_API_KEY (free at https://www.tally.xyz/user/api-keys).
+ * When unset the test file marks parity tests as skipped — we keep the
+ * comparison logic itself under unit test against synthetic fixtures.
+ */
+import { PROPOSAL_STATE } from "./adapter.js";
+const STATUS_TO_INDEX = {
+    // OZ Governor canonical
+    PENDING: 0,
+    ACTIVE: 1,
+    CANCELED: 2,
+    CANCELLED: 2,
+    DEFEATED: 3,
+    SUCCEEDED: 4,
+    QUEUED: 5,
+    EXPIRED: 6,
+    EXECUTED: 7,
+    // Tally synonyms / extended states we treat as equivalent
+    CALLEXECUTED: 7,
+    CROSSCHAINEXECUTED: 7,
+    // SUBMITTED / DRAFT are pre-Pending Tally states — we map to Pending for
+    // the on-chain comparator because the on-chain `state()` will return Pending
+    // until the snapshot block elapses.
+    SUBMITTED: 0,
+    DRAFT: 0,
+};
+export function mapTallyStatusToIndex(status) {
+    const idx = STATUS_TO_INDEX[status.toUpperCase()];
+    return idx === undefined ? null : idx;
+}
+export function compareStateEnum(proposalId, tally, actualStateIndex) {
+    const mappedIndex = mapTallyStatusToIndex(tally.status);
+    const match = mappedIndex !== null && mappedIndex === actualStateIndex;
+    return {
+        proposalId,
+        expected: { source: "tally", status: tally.status, mappedIndex },
+        actual: {
+            source: "rpc",
+            index: actualStateIndex,
+            name: PROPOSAL_STATE[actualStateIndex] ?? `Unknown(${actualStateIndex})`,
+        },
+        match,
+    };
+}
+/**
+ * Tally GraphQL query for governor proposals. Caller passes governor ID in
+ * Tally's `eip155:<chainId>:<address>` form. Returns `limit` most-recent
+ * proposals.
+ */
+export const TALLY_PROPOSALS_QUERY = `
+  query Proposals($input: ProposalsInput!) {
+    proposals(input: $input) {
+      nodes {
+        ... on Proposal {
+          onchainId
+          status
+        }
+      }
+    }
+  }
+`;
+export async function fetchTallyProposals(client, governorChainAddress, limit) {
+    const endpoint = client.endpoint ?? "https://api.tally.xyz/query";
+    const res = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "api-key": client.apiKey,
+        },
+        body: JSON.stringify({
+            query: TALLY_PROPOSALS_QUERY,
+            variables: {
+                input: {
+                    filters: { governorId: governorChainAddress },
+                    page: { limit },
+                    sort: { sortBy: "id", isDescending: true },
+                },
+            },
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`Tally HTTP ${res.status}: ${await res.text()}`);
+    }
+    const body = (await res.json());
+    if (body.errors)
+        throw new Error(`Tally GraphQL: ${JSON.stringify(body.errors)}`);
+    const nodes = body.data?.proposals?.nodes ?? [];
+    return nodes
+        .filter((n) => n?.onchainId && n?.status)
+        .map((n) => ({ onchainId: String(n.onchainId), status: String(n.status) }));
+}
+export function tallyGovernorId(chainId, address) {
+    return `eip155:${chainId}:${address.toLowerCase()}`;
+}
+//# sourceMappingURL=tally.js.map

package/dist/governor/tally.js.map

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

package/dist/governor/tools/build.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGovernorBuildTools(server: McpServer): void;
+//# sourceMappingURL=build.d.ts.map

package/dist/governor/tools/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/governor/tools/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAMlE"}

package/dist/governor/tools/build.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { resolveGovernor } from "../loader.js";
+import { buildDelegate, buildExecute, buildPropose, buildQueue, buildVoteCast, } from "../encoder.js";
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+const governorIdSchema = z
+    .string()
+    .min(1)
+    .describe("Governor id (e.g. 'uniswap') or 0x-prefixed governor contract address.");
+const uintLikeSchema = z.union([z.string(), z.number()]);
+export function registerGovernorBuildTools(server) {
+    registerPropose(server);
+    registerVoteCast(server);
+    registerQueue(server);
+    registerExecute(server);
+    registerDelegate(server);
+}
+function registerPropose(server) {
+    server.registerTool("dexe_gov_build_propose", {
+        title: "Encode Governor.propose calldata",
+        description: "Returns {to, value, data, selector} for the configured Governor's propose method. OZ v4+ uses (targets, values, calldatas, description); Bravo uses (targets, values, signatures, calldatas, description). On Bravo, signatures defaults to [''...] when omitted.",
+        inputSchema: {
+            governor: governorIdSchema,
+            targets: z.array(z.string()).min(1),
+            values: z.array(uintLikeSchema).min(1).describe("ETH value per target as decimal string or number."),
+            calldatas: z.array(z.string()).min(1).describe("0x-prefixed bytes per target."),
+            description: z.string().describe("Human-readable proposal description; hashed for queue/execute on OZ."),
+            signatures: z
+                .array(z.string())
+                .optional()
+                .describe("Bravo only. Per-target function signature strings. Defaults to empty strings when omitted."),
+        },
+    }, async ({ governor, targets, values, calldatas, description, signatures }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const built = buildPropose(cfg, { targets, values, calldatas, description, signatures });
+            return ok({ governor: cfg.id, governorVersion: cfg.governorVersion, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_propose failed: ${e.message}`);
+        }
+    });
+}
+function registerVoteCast(server) {
+    server.registerTool("dexe_gov_build_vote_cast", {
+        title: "Encode Governor.castVote / castVoteWithReason calldata",
+        description: "Returns {to, value, data, selector}. support: 0=Against, 1=For, 2=Abstain. When reason is provided, uses castVoteWithReason; otherwise castVote. Identical signature on OZ and Bravo.",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: z.string().describe("Proposal id as decimal string (uint256)."),
+            support: z.number().int().min(0).max(2),
+            reason: z.string().optional(),
+        },
+    }, async ({ governor, proposalId, support, reason }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const built = buildVoteCast(cfg, proposalId, support, reason);
+            return ok({ governor: cfg.id, governorVersion: cfg.governorVersion, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_vote_cast failed: ${e.message}`);
+        }
+    });
+}
+function registerQueue(server) {
+    server.registerTool("dexe_gov_build_queue", {
+        title: "Encode Governor.queue calldata",
+        description: "OZ v4+: pass targets/values/calldatas plus either description (we hash it) or descriptionHash. Bravo: pass proposalId only.",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: z.string().optional(),
+            targets: z.array(z.string()).optional(),
+            values: z.array(uintLikeSchema).optional(),
+            calldatas: z.array(z.string()).optional(),
+            description: z.string().optional(),
+            descriptionHash: z.string().optional(),
+        },
+    }, async (args) => {
+        try {
+            const cfg = resolveGovernor(args.governor);
+            const built = buildQueue(cfg, args);
+            return ok({ governor: cfg.id, governorVersion: cfg.governorVersion, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_queue failed: ${e.message}`);
+        }
+    });
+}
+function registerExecute(server) {
+    server.registerTool("dexe_gov_build_execute", {
+        title: "Encode Governor.execute calldata",
+        description: "OZ v4+: pass targets/values/calldatas plus description or descriptionHash. Bravo: pass proposalId only. Optional msgValue passes through as the tx value (sum of proposal target values when calling OZ execute).",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: z.string().optional(),
+            targets: z.array(z.string()).optional(),
+            values: z.array(uintLikeSchema).optional(),
+            calldatas: z.array(z.string()).optional(),
+            description: z.string().optional(),
+            descriptionHash: z.string().optional(),
+            msgValue: uintLikeSchema.optional().describe("Tx value in wei. Defaults to 0."),
+        },
+    }, async (args) => {
+        try {
+            const cfg = resolveGovernor(args.governor);
+            const built = buildExecute(cfg, args, args.msgValue);
+            return ok({ governor: cfg.id, governorVersion: cfg.governorVersion, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_execute failed: ${e.message}`);
+        }
+    });
+}
+function registerDelegate(server) {
+    server.registerTool("dexe_gov_build_delegate", {
+        title: "Encode IVotes.delegate calldata on the configured voting token",
+        description: "Returns {to, value, data, selector}. `to` is the voting token (NOT the Governor). delegatee=zero address self-revokes delegation.",
+        inputSchema: {
+            governor: governorIdSchema,
+            delegatee: z.string(),
+        },
+    }, async ({ governor, delegatee }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const built = buildDelegate(cfg, delegatee);
+            return ok({ governor: cfg.id, votingToken: cfg.votingToken, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_delegate failed: ${e.message}`);
+        }
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/governor/tools/build.js.map

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

package/dist/governor/tools/extras.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RpcProvider } from "../../rpc.js";
+export declare function registerGovernorExtraTools(server: McpServer, rpc: RpcProvider): void;
+//# sourceMappingURL=extras.d.ts.map

package/dist/governor/tools/extras.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extras.d.ts","sourceRoot":"","sources":["../../../src/governor/tools/extras.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwC3C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAOpF"}

package/dist/governor/tools/extras.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+import { isAddress, keccak256, toUtf8Bytes } from "ethers";
+import { resolveGovernor } from "../loader.js";
+import { governorContract, isBravo, stateName } from "../adapter.js";
+import { buildCancel, decodeGovernorWrite, } from "../encoder.js";
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+const governorIdSchema = z
+    .string()
+    .min(1)
+    .describe("Governor id (e.g. 'uniswap') or 0x-prefixed governor contract address.");
+const uintLikeSchema = z.union([z.string(), z.number()]);
+const addressArg = (desc) => z.string().refine((s) => isAddress(s), { message: "must be a 0x-prefixed 20-byte address" }).describe(desc);
+const proposalIdArg = z.string().refine((s) => {
+    try {
+        BigInt(s);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, { message: "must be a uint256 (decimal or 0x-hex) string" });
+export function registerGovernorExtraTools(server, rpc) {
+    registerGetState(server, rpc);
+    registerHasVoted(server, rpc);
+    registerBuildCancel(server);
+    registerDecodeCalldata(server);
+    registerHashDescription(server);
+    registerHashProposal(server, rpc);
+}
+function registerGetState(server, rpc) {
+    server.registerTool("dexe_gov_get_state", {
+        title: "Read Governor.state() — minimal proposal-state lookup",
+        description: "Returns {index, name} for the proposal's current state. Shorthand for the state field of dexe_gov_get_proposal — useful when you only need the state and want a single eth_call.",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: proposalIdArg,
+        },
+    }, async ({ governor, proposalId }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const provider = rpc.requireProvider(cfg.chainId);
+            const c = governorContract(provider, cfg);
+            const idx = Number(await c.getFunction("state").staticCall(BigInt(proposalId)));
+            return ok({
+                governor: cfg.id,
+                governorVersion: cfg.governorVersion,
+                proposalId,
+                state: { index: idx, name: stateName(idx) },
+            });
+        }
+        catch (e) {
+            return err(`dexe_gov_get_state failed: ${e.message}`);
+        }
+    });
+}
+function registerHasVoted(server, rpc) {
+    server.registerTool("dexe_gov_has_voted", {
+        title: "Read Governor.hasVoted(proposalId, account)",
+        description: "Returns true when the account has already cast a vote on this proposal. Identical signature on OZ and Bravo.",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: proposalIdArg,
+            account: addressArg("0x-prefixed account address."),
+        },
+    }, async ({ governor, proposalId, account }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const provider = rpc.requireProvider(cfg.chainId);
+            const c = governorContract(provider, cfg);
+            const voted = await c.getFunction("hasVoted").staticCall(BigInt(proposalId), account);
+            return ok({
+                governor: cfg.id,
+                proposalId,
+                account,
+                hasVoted: voted,
+            });
+        }
+        catch (e) {
+            return err(`dexe_gov_has_voted failed: ${e.message}`);
+        }
+    });
+}
+function registerBuildCancel(server) {
+    server.registerTool("dexe_gov_build_cancel", {
+        title: "Encode Governor.cancel calldata",
+        description: "OZ v4+: pass targets/values/calldatas + description or descriptionHash. Bravo: pass proposalId only. Returns {to, value, data, selector}.",
+        inputSchema: {
+            governor: governorIdSchema,
+            proposalId: z.string().optional(),
+            targets: z.array(z.string()).optional(),
+            values: z.array(uintLikeSchema).optional(),
+            calldatas: z.array(z.string()).optional(),
+            description: z.string().optional(),
+            descriptionHash: z.string().optional(),
+        },
+    }, async (args) => {
+        try {
+            const cfg = resolveGovernor(args.governor);
+            const built = buildCancel(cfg, args);
+            return ok({ governor: cfg.id, governorVersion: cfg.governorVersion, ...built });
+        }
+        catch (e) {
+            return err(`dexe_gov_build_cancel failed: ${e.message}`);
+        }
+    });
+}
+function registerDecodeCalldata(server) {
+    server.registerTool("dexe_gov_decode_calldata", {
+        title: "Decode any Governor write calldata back to its named args",
+        description: "Parses raw 0x-prefixed calldata against the configured Governor's write ABI (family-aware). Returns {method, args}. Useful for auditing a transaction in a wallet before signing, or round-tripping output of dexe_gov_build_* tools.",
+        inputSchema: {
+            governor: governorIdSchema,
+            data: z.string().describe("0x-prefixed calldata."),
+        },
+    }, async ({ governor, data }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            const decoded = decodeGovernorWrite(cfg, data);
+            // bigints → strings for JSON safety
+            const argsOut = decoded.args.map((v) => typeof v === "bigint"
+                ? v.toString()
+                : Array.isArray(v)
+                    ? v.map((x) => (typeof x === "bigint" ? x.toString() : x))
+                    : v);
+            return ok({
+                governor: cfg.id,
+                governorVersion: cfg.governorVersion,
+                family: isBravo(cfg) ? "bravo" : "oz",
+                method: decoded.method,
+                args: argsOut,
+            });
+        }
+        catch (e) {
+            return err(`dexe_gov_decode_calldata failed: ${e.message}`);
+        }
+    });
+}
+function registerHashDescription(server) {
+    server.registerTool("dexe_gov_hash_description", {
+        title: "Compute keccak256(toUtf8Bytes(description))",
+        description: "Returns the 32-byte descriptionHash that OZ Governor queue/execute/cancel use. Lets clients pre-compute the hash, store it, and skip rehashing on every call.",
+        inputSchema: {
+            description: z.string(),
+        },
+    }, async ({ description }) => {
+        try {
+            return ok({ description, descriptionHash: keccak256(toUtf8Bytes(description)) });
+        }
+        catch (e) {
+            return err(`dexe_gov_hash_description failed: ${e.message}`);
+        }
+    });
+}
+function registerHashProposal(server, rpc) {
+    server.registerTool("dexe_gov_hash_proposal", {
+        title: "Call OZ Governor.hashProposal — preview the deterministic proposalId",
+        description: "OZ v4+ only. Computes the on-chain proposalId for a (targets, values, calldatas, descriptionHash) tuple before submission. Lets clients verify the propose calldata matches an expected id. Errors clearly on Bravo (hashProposal is not part of Bravo's ABI).",
+        inputSchema: {
+            governor: governorIdSchema,
+            targets: z.array(z.string()),
+            values: z.array(uintLikeSchema),
+            calldatas: z.array(z.string()),
+            description: z.string().optional(),
+            descriptionHash: z.string().optional(),
+        },
+    }, async ({ governor, targets, values, calldatas, description, descriptionHash }) => {
+        try {
+            const cfg = resolveGovernor(governor);
+            if (isBravo(cfg)) {
+                return err(`dexe_gov_hash_proposal: ${cfg.id} is Bravo (${cfg.governorVersion}); Bravo does not expose hashProposal. Use Bravo's on-chain proposalCount + propose-returned id instead.`);
+            }
+            const provider = rpc.requireProvider(cfg.chainId);
+            const c = governorContract(provider, cfg);
+            const dh = descriptionHash
+                ?? (description !== undefined ? keccak256(toUtf8Bytes(description)) : undefined);
+            if (!dh)
+                throw new Error("either description or descriptionHash is required");
+            const vals = values.map((v) => BigInt(v));
+            const id = await c.getFunction("hashProposal").staticCall(targets, vals, calldatas, dh);
+            return ok({
+                governor: cfg.id,
+                proposalIdHex: "0x" + id.toString(16),
+                proposalIdDecimal: id.toString(),
+                descriptionHash: dh,
+            });
+        }
+        catch (e) {
+            return err(`dexe_gov_hash_proposal failed: ${e.message}`);
+        }
+    });
+}
+//# sourceMappingURL=extras.js.map

package/dist/governor/tools/extras.js.map

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

package/dist/governor/tools/read.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RpcProvider } from "../../rpc.js";
+export declare function registerGovernorReadTools(server: McpServer, rpc: RpcProvider): void;
+//# sourceMappingURL=read.d.ts.map

package/dist/governor/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/governor/tools/read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0C3C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAMnF"}