dexe-mcp 0.1.0

package/dist/tools/gov.js

@@ -0,0 +1,302 @@
+import { z } from "zod";
+import { Contract, isAddress } from "ethers";
+import { CalldataDecoder } from "../lib/decoders.js";
+import { GovAddressResolver } from "../lib/govAddresses.js";
+import { RpcProvider } from "../rpc.js";
+import { ArtifactsMissingError } from "../artifacts.js";
+export function registerGovTools(server, ctx) {
+    const rpc = new RpcProvider(ctx.config);
+    const decoder = new CalldataDecoder(ctx.artifacts, ctx.selectors);
+    const addresses = new GovAddressResolver(ctx.artifacts);
+    registerDecodeCalldata(server, ctx, decoder);
+    registerDecodeProposal(server, ctx, decoder, addresses, rpc);
+    registerReadGovState(server, ctx, addresses, rpc);
+    registerListGovContractTypes(server);
+}
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+// ---------- dexe_decode_calldata ----------
+function registerDecodeCalldata(server, ctx, decoder) {
+    server.registerTool("dexe_decode_calldata", {
+        title: "Decode ABI-encoded calldata",
+        description: "Decodes a raw '0x…' calldata blob against loaded contract ABIs. If `contract` is given, only that ABI is tried; otherwise every artifact whose selector matches is tried. Useful for understanding captured transactions or proposal action payloads.",
+        inputSchema: {
+            data: z
+                .string()
+                .regex(/^0x[0-9a-fA-F]+$/, "Must be a 0x-prefixed hex string")
+                .describe("Raw calldata including 4-byte selector"),
+            contract: z.string().optional().describe("Optional: restrict to one contract's ABI"),
+        },
+        outputSchema: {
+            matched: z.boolean(),
+            primary: z
+                .object({
+                contract: z.string().nullable(),
+                sourceName: z.string().nullable(),
+                signature: z.string(),
+                selector: z.string(),
+                args: z.record(z.unknown()),
+                argsArray: z.array(z.unknown()),
+            })
+                .nullable(),
+            alternativeCount: z.number(),
+            alternatives: z.array(z.object({
+                contract: z.string().nullable(),
+                signature: z.string(),
+            })),
+        },
+    }, async ({ data, contract }) => {
+        try {
+            ctx.artifacts.requireArtifactsExist();
+        }
+        catch (err) {
+            if (err instanceof ArtifactsMissingError)
+                return errorResult(err.message);
+            throw err;
+        }
+        const result = decoder.decodeCalldata(data, contract);
+        const structured = {
+            matched: result.primary !== null,
+            primary: result.primary,
+            alternativeCount: result.alternatives.length,
+            alternatives: result.alternatives.map((a) => ({ contract: a.contract, signature: a.signature })),
+        };
+        const text = result.primary
+            ? `${result.primary.contract ?? "?"}.${result.primary.signature}\n\nArgs:\n${JSON.stringify(result.primary.args, null, 2).slice(0, 3000)}${result.alternatives.length > 0
+                ? `\n\n${result.alternatives.length} alternative match(es): ${result.alternatives.map((a) => `${a.contract}.${a.signature}`).join(", ")}`
+                : ""}`
+            : `No matching ABI found for selector ${data.slice(0, 10)}. Try dexe_find_selector.`;
+        return {
+            content: [{ type: "text", text }],
+            structuredContent: structured,
+            isError: !result.primary,
+        };
+    });
+}
+// ---------- dexe_decode_proposal ----------
+function registerDecodeProposal(server, ctx, decoder, _addresses, rpc) {
+    server.registerTool("dexe_decode_proposal", {
+        title: "Read and decode a GovPool proposal",
+        description: "Fetches a proposal from an on-chain GovPool via `getProposals(offset, limit)` and decodes every action in BOTH `actionsOnFor` and `actionsOnAgainst` against loaded ABIs. Requires DEXE_RPC_URL.",
+        inputSchema: {
+            govPool: z.string().describe("GovPool contract address"),
+            proposalId: z.number().int().positive().describe("Proposal ID (1-indexed)"),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            proposalId: z.number(),
+            proposalState: z.number(),
+            descriptionURL: z.string(),
+            requiredQuorum: z.string(),
+            requiredValidatorsQuorum: z.string(),
+            core: z.object({
+                voteEnd: z.string(),
+                executeAfter: z.string(),
+                executed: z.boolean(),
+                votesFor: z.string(),
+                votesAgainst: z.string(),
+                rawVotesFor: z.string(),
+                rawVotesAgainst: z.string(),
+                givenRewards: z.string(),
+            }),
+            forActions: z.array(z.unknown()),
+            againstActions: z.array(z.unknown()),
+        },
+    }, async ({ govPool, proposalId }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid GovPool address: ${govPool}`);
+        try {
+            ctx.artifacts.requireArtifactsExist();
+        }
+        catch (err) {
+            if (err instanceof ArtifactsMissingError)
+                return errorResult(err.message);
+            throw err;
+        }
+        let provider;
+        try {
+            provider = rpc.requireProvider();
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+        const abi = ctx.artifacts.get("GovPool")[0]?.abi;
+        if (!abi)
+            return errorResult("GovPool artifact not loaded. Run dexe_compile first.");
+        const pool = new Contract(govPool, abi, provider);
+        let views;
+        try {
+            views = await pool.getFunction("getProposals")(proposalId - 1, 1);
+        }
+        catch (err) {
+            return errorResult(`RPC call to getProposals failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (!views || views.length === 0) {
+            return errorResult(`Proposal ${proposalId} not found at ${govPool}.`);
+        }
+        // ProposalView = [proposal, validatorProposal, proposalState, requiredQuorum, requiredValidatorsQuorum]
+        // proposal = [core, descriptionURL, actionsOnFor, actionsOnAgainst]
+        // core = [settings, voteEnd, executeAfter, executed, votesFor, votesAgainst, rawVotesFor, rawVotesAgainst, givenRewards]
+        const view = views[0];
+        const proposal = view[0];
+        const core = proposal[0];
+        const descriptionURL = proposal[1];
+        const rawForActions = proposal[2];
+        const rawAgainstActions = proposal[3];
+        const proposalState = Number(view[2]);
+        const requiredQuorum = view[3].toString();
+        const requiredValidatorsQuorum = view[4].toString();
+        const forActions = rawForActions.map((a) => decoder.decodeProposalAction({ executor: a[0], value: a[1], data: a[2], side: "for" }));
+        const againstActions = rawAgainstActions.map((a) => decoder.decodeProposalAction({ executor: a[0], value: a[1], data: a[2], side: "against" }));
+        const structured = {
+            govPool,
+            proposalId,
+            proposalState,
+            descriptionURL,
+            requiredQuorum,
+            requiredValidatorsQuorum,
+            core: {
+                voteEnd: core[1].toString(),
+                executeAfter: core[2].toString(),
+                executed: Boolean(core[3]),
+                votesFor: core[4].toString(),
+                votesAgainst: core[5].toString(),
+                rawVotesFor: core[6].toString(),
+                rawVotesAgainst: core[7].toString(),
+                givenRewards: core[8].toString(),
+            },
+            forActions,
+            againstActions,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Proposal ${proposalId} @ ${govPool}\nState: ${PROPOSAL_STATE_NAMES[proposalState] ?? proposalState}\nDescription: ${descriptionURL}\nActions on For: ${forActions.length}\nActions on Against: ${againstActions.length}\n${formatActions(forActions)}${formatActions(againstActions)}`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+const PROPOSAL_STATE_NAMES = [
+    "Voting",
+    "WaitingForVotingTransfer",
+    "ValidatorVoting",
+    "Defeated",
+    "SucceededFor",
+    "SucceededAgainst",
+    "Locked",
+    "ExecutedFor",
+    "ExecutedAgainst",
+    "Undefined",
+];
+function formatActions(actions) {
+    if (actions.length === 0)
+        return "";
+    return (`\n\n--- ${actions[0].side.toUpperCase()} actions ---\n` +
+        actions
+            .map((a, i) => {
+            const decoded = a.decoded
+                ? `${a.decoded.contract ?? "?"}.${a.decoded.signature}`
+                : "(no matching ABI)";
+            return `  ${i}: executor=${a.executor} value=${a.value}\n     ${decoded}`;
+        })
+            .join("\n"));
+}
+// ---------- dexe_read_gov_state ----------
+function registerReadGovState(server, _ctx, addresses, rpc) {
+    server.registerTool("dexe_read_gov_state", {
+        title: "Read aggregate GovPool state",
+        description: "For a given GovPool address, reads `getHelperContracts()` and `getNftContracts()` on-chain and returns the resolved helper + nft addresses. Requires DEXE_RPC_URL.",
+        inputSchema: {
+            govPool: z.string().describe("GovPool contract address"),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            helpers: z.object({
+                settings: z.string(),
+                userKeeper: z.string(),
+                validators: z.string(),
+                poolRegistry: z.string(),
+                votePower: z.string(),
+            }),
+            nftContracts: z.object({
+                nftMultiplier: z.string(),
+                expertNft: z.string(),
+                dexeExpertNft: z.string(),
+                babt: z.string(),
+            }),
+        },
+    }, async ({ govPool }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid GovPool address: ${govPool}`);
+        let provider;
+        try {
+            provider = rpc.requireProvider();
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+        try {
+            const helpers = await addresses.resolveHelpers(govPool, provider);
+            const nftContracts = await addresses.resolveNftContracts(govPool, provider);
+            const structured = { govPool, helpers, nftContracts };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `GovPool ${govPool}\n\nHelpers:\n  settings     : ${helpers.settings}\n  userKeeper   : ${helpers.userKeeper}\n  validators   : ${helpers.validators}\n  poolRegistry : ${helpers.poolRegistry}\n  votePower    : ${helpers.votePower}\n\nNFT contracts:\n  nftMultiplier : ${nftContracts.nftMultiplier}\n  expertNft     : ${nftContracts.expertNft}\n  dexeExpertNft : ${nftContracts.dexeExpertNft}\n  babt          : ${nftContracts.babt}`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`Failed to read gov state: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+// ---------- dexe_list_gov_contract_types ----------
+function registerListGovContractTypes(server) {
+    server.registerTool("dexe_list_gov_contract_types", {
+        title: "Orientation: gov subsystem contract catalog",
+        description: "Static catalog describing the DeXe governance subsystem contracts: what each one does and where its source lives. Cheap orientation tool for agents new to the codebase.",
+        inputSchema: {},
+        outputSchema: {
+            contracts: z.array(z.object({
+                name: z.string(),
+                role: z.string(),
+                sourcePath: z.string(),
+            })),
+        },
+    }, async () => {
+        const catalog = [
+            { name: "GovPool", role: "Per-DAO main contract: proposals, voting, execution", sourcePath: "contracts/gov/GovPool.sol" },
+            { name: "GovSettings", role: "Proposal settings (quorum, voting period, etc.)", sourcePath: "contracts/gov/settings/GovSettings.sol" },
+            { name: "GovUserKeeper", role: "User deposits, delegations, and voting power bookkeeping", sourcePath: "contracts/gov/user-keeper/GovUserKeeper.sol" },
+            { name: "GovValidators", role: "Validator set + second-step validator voting", sourcePath: "contracts/gov/validators/GovValidators.sol" },
+            { name: "DistributionProposal", role: "Proposal executor for reward distribution", sourcePath: "contracts/gov/proposals/DistributionProposal.sol" },
+            { name: "StakingProposal", role: "Proposal executor for staking-related actions", sourcePath: "contracts/gov/proposals/StakingProposal.sol" },
+            { name: "TokenSaleProposal", role: "Proposal executor for token sale tiers", sourcePath: "contracts/gov/proposals/TokenSaleProposal.sol" },
+            { name: "LinearPower", role: "Voting-power formula: linear", sourcePath: "contracts/gov/voting/LinearPower.sol" },
+            { name: "PolynomialPower", role: "Voting-power formula: polynomial", sourcePath: "contracts/gov/voting/PolynomialPower.sol" },
+            { name: "ContractsRegistry", role: "Service locator for global protocol contracts (not per-pool)", sourcePath: "contracts/core/ContractsRegistry.sol" },
+            { name: "PoolRegistry", role: "Tracks all deployed GovPool instances", sourcePath: "contracts/core/PoolRegistry.sol" },
+        ];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: catalog.map((c) => `  ${c.name.padEnd(22)} — ${c.role}\n    ${c.sourcePath}`).join("\n"),
+                },
+            ],
+            structuredContent: { contracts: catalog },
+        };
+    });
+}
+//# sourceMappingURL=gov.js.map

package/dist/tools/gov.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DexeConfig } from "../config.js";
+/**
+ * Wire every dexe-mcp tool onto the given server instance. Builds the shared
+ * ToolContext (artifacts cache, hardhat runner, selector index) once so all
+ * tools share state.
+ */
+export declare function registerAll(server: McpServer, config: DexeConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS/C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CASvE"}

package/dist/tools/index.js

@@ -0,0 +1,21 @@
+import { Artifacts } from "../artifacts.js";
+import { HardhatRunner } from "../hardhat.js";
+import { SelectorIndex } from "../lib/selectors.js";
+import { registerBuildTools } from "./build.js";
+import { registerIntrospectTools } from "./introspect.js";
+import { registerGovTools } from "./gov.js";
+/**
+ * Wire every dexe-mcp tool onto the given server instance. Builds the shared
+ * ToolContext (artifacts cache, hardhat runner, selector index) once so all
+ * tools share state.
+ */
+export function registerAll(server, config) {
+    const artifacts = new Artifacts(config);
+    const runner = new HardhatRunner(config);
+    const selectors = new SelectorIndex(artifacts);
+    const ctx = { config, artifacts, runner, selectors };
+    registerBuildTools(server, ctx);
+    registerIntrospectTools(server, ctx);
+    registerGovTools(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAiB,EAAE,MAAkB;IAC/D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAElE,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/tools/introspect.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerIntrospectTools(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/tools/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/tools/introspect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAOjF"}