dexe-mcp 0.3.0 → 0.5.0

package/dist/tools/inbox.js

@@ -0,0 +1,251 @@
+import { z } from "zod";
+import { Interface, isAddress, getAddress } from "ethers";
+import { RpcProvider } from "../rpc.js";
+import { multicall } from "../lib/multicall.js";
+import { gqlRequest } from "../lib/subgraph.js";
+import { proposalStateLabel } from "../lib/govEnums.js";
+/**
+ * dexe_user_inbox — multi-DAO attention aggregator.
+ *
+ * Per DAO, surfaces three kinds of pending items for `user`:
+ *   1. unvotedProposal — proposal in Voting state where user has zero personal vote
+ *   2. claimableRewards — proposals user voted on with a positive pendingRewards balance
+ *   3. lockedDeposit — UserKeeper.tokenBalance(user, PersonalVote).balance > 0
+ *      (i.e. tokens still parked in the DAO and reclaimable)
+ *
+ * When `daos` is omitted on mainnet, the pools subgraph is queried for DAOs
+ * the user has a `voterInPool` row in (limit 50). On testnet (no subgraph),
+ * `daos[]` is required.
+ */
+// ---------- ABI ----------
+const GOV_POOL_ABI = new Interface([
+    "function getHelperContracts() view returns (address settings, address userKeeper, address validators, address poolRegistry, address votePower)",
+    "function getProposals(uint256 offset, uint256 limit) view returns (tuple(tuple(tuple(bool earlyCompletion, bool delegatedVotingAllowed, bool validatorsVote, uint64 duration, uint64 durationValidators, uint64 executionDelay, uint128 quorum, uint128 quorumValidators, uint256 minVotesForVoting, uint256 minVotesForCreating, tuple(address rewardToken, uint256 creationReward, uint256 executionReward, uint256 voteRewardsCoefficient) rewardsInfo, string executorDescription) settings, uint64 voteEnd, uint64 executeAfter, bool executed, uint256 votesFor, uint256 votesAgainst, uint256 rawVotesFor, uint256 rawVotesAgainst, uint256 givenRewards) core, string descriptionURL, tuple(address executor, uint256 value, bytes data)[] actionsOnFor, tuple(address executor, uint256 value, bytes data)[] actionsOnAgainst)[] proposals, tuple(uint256 proposalId, uint256 executeAfter, uint256 quorum, uint256 rawVotesFor, uint256 rawVotesAgainst, bool executed, tuple(bool earlyCompletion, bool delegatedVotingAllowed, bool validatorsVote, uint64 duration, uint64 durationValidators, uint64 executionDelay, uint128 quorum, uint128 quorumValidators, uint256 minVotesForVoting, uint256 minVotesForCreating, tuple(address rewardToken, uint256 creationReward, uint256 executionReward, uint256 voteRewardsCoefficient) rewardsInfo, string executorDescription) settings)[] validatorProposals, uint8[] proposalStates, uint256[] requiredQuorums, uint256[] requiredValidatorsQuorums)",
+    "function getTotalVotes(uint256 proposalId, address voter, uint8 voteType) view returns (uint256 totalVoted, uint256 totalRawVoted, uint256 votesForNow, bool isVoteFor)",
+    "function getPendingRewards(address user, uint256[] proposalIds) view returns (tuple(address[] tokens, uint256[] amounts, uint256[] proposalIds))",
+]);
+const USER_KEEPER_ABI = new Interface([
+    "function tokenAddress() view returns (address)",
+    "function tokenBalance(address voter, uint8 voteType) view returns (uint256 balance, uint256 ownedBalance)",
+]);
+// Tries to read pendingRewards using the canonical ABI; if the contract
+// version doesn't expose it, we silently skip and only surface unvoted +
+// lockedDeposit. The subgraph would be the next-best signal.
+const PENDING_REWARDS_ABI = new Interface([
+    "function getPendingRewards(address user, uint256[] proposalIds) view returns (tuple(address[] tokens, uint256[] amounts, uint256[] proposalIds) rewards)",
+]);
+// ---------- subgraph ----------
+const USER_DAOS_QUERY = /* GraphQL */ `
+  query UserDaos($user: String!, $first: Int!) {
+    voterInPools(where: { voter_: { id: $user } }, first: $first) {
+      pool {
+        id
+      }
+    }
+  }
+`;
+// ---------- helpers ----------
+function err(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function ok(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, (_k, v) => (typeof v === "bigint" ? v.toString() : v), 2),
+            },
+        ],
+    };
+}
+// ---------- register ----------
+export function registerInboxTools(server, ctx) {
+    const rpc = new RpcProvider(ctx.config);
+    server.registerTool("dexe_user_inbox", {
+        title: "Multi-DAO attention aggregator",
+        description: "Aggregates pending items across N DAOs for a user: unvoted proposals in Voting state, claimable rewards, and locked deposits. " +
+            "Mainnet: omits `daos` to auto-discover via the pools subgraph (limit 50). Testnet: `daos[]` required (no subgraph). " +
+            "Read-only.",
+        inputSchema: {
+            user: z.string().describe("User wallet address"),
+            daos: z
+                .array(z.string())
+                .optional()
+                .describe("Optional explicit DAO list. Required on testnet (chain 97)."),
+            proposalScanLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe("Per-DAO recent-proposal scan window for unvoted/rewards detection"),
+        },
+    }, async ({ user, daos, proposalScanLimit = 20 }) => {
+        if (!isAddress(user))
+            return err(`Invalid user: ${user}`);
+        const provider = rpc.requireProvider();
+        const userAddr = getAddress(user);
+        // ----- DAO list resolution -----
+        let resolvedDaos = [];
+        if (daos && daos.length > 0) {
+            for (const d of daos) {
+                if (!isAddress(d))
+                    return err(`Invalid dao: ${d}`);
+                resolvedDaos.push(getAddress(d));
+            }
+        }
+        else {
+            const url = ctx.config.subgraphPoolsUrl;
+            if (!url) {
+                return err("No `daos` supplied and DEXE_SUBGRAPH_POOLS_URL is not set (testnet has no subgraph). Pass `daos: [...]` explicitly.");
+            }
+            try {
+                const data = await gqlRequest(url, USER_DAOS_QUERY, {
+                    user: userAddr.toLowerCase(),
+                    first: 50,
+                });
+                resolvedDaos = data.voterInPools.map((v) => getAddress(v.pool.id));
+            }
+            catch (e) {
+                return err(`Subgraph DAO discovery failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        const pendingItems = [];
+        let daosWithItems = 0;
+        // ----- per-DAO scan -----
+        for (const dao of resolvedDaos) {
+            const items = [];
+            try {
+                // Step 1: fetch helpers + recent proposals in one multicall.
+                const [helpersR, proposalsR] = await multicall(provider, [
+                    { target: dao, iface: GOV_POOL_ABI, method: "getHelperContracts", args: [], allowFailure: true },
+                    {
+                        target: dao,
+                        iface: GOV_POOL_ABI,
+                        method: "getProposals",
+                        args: [0n, BigInt(proposalScanLimit)],
+                        allowFailure: true,
+                    },
+                ]);
+                if (!helpersR?.success)
+                    continue;
+                const helpers = helpersR.value;
+                const userKeeper = helpers.userKeeper;
+                // Step 2: read deposit balance + token address.
+                const [tokenAddrR, balanceR] = await multicall(provider, [
+                    { target: userKeeper, iface: USER_KEEPER_ABI, method: "tokenAddress", args: [], allowFailure: true },
+                    {
+                        target: userKeeper,
+                        iface: USER_KEEPER_ABI,
+                        method: "tokenBalance",
+                        args: [userAddr, 0],
+                        allowFailure: true,
+                    },
+                ]);
+                const govToken = tokenAddrR?.success ? tokenAddrR.value : undefined;
+                if (balanceR?.success) {
+                    const bal = balanceR.value;
+                    if (bal.balance > 0n) {
+                        items.push({
+                            dao,
+                            type: "lockedDeposit",
+                            amount: bal.balance.toString(),
+                            govToken,
+                        });
+                    }
+                }
+                // Step 3: walk recent proposals for unvoted in Voting state, and for
+                // claimable rewards on already-voted proposals.
+                if (proposalsR?.success) {
+                    const raw = proposalsR.value;
+                    const proposalIds = [];
+                    const votingIds = [];
+                    for (let i = 0; i < raw.proposals.length; i++) {
+                        const id = String(i + 1);
+                        proposalIds.push(id);
+                        const stateIdx = Number(raw.proposalStates[i] ?? 9);
+                        const stateName = proposalStateLabel(stateIdx);
+                        if (stateName === "Voting" || stateName === "ValidatorVoting") {
+                            votingIds.push({ id, deadline: raw.proposals[i].core.voteEnd.toString() });
+                        }
+                    }
+                    // For each voting proposal, ask getTotalVotes → if voter has zero,
+                    // surface as unvoted.
+                    if (votingIds.length > 0) {
+                        const calls = votingIds.map((p) => ({
+                            target: dao,
+                            iface: GOV_POOL_ABI,
+                            method: "getTotalVotes",
+                            args: [BigInt(p.id), userAddr, 0],
+                            allowFailure: true,
+                        }));
+                        const res = await multicall(provider, calls);
+                        for (let i = 0; i < votingIds.length; i++) {
+                            const r = res[i];
+                            if (!r?.success)
+                                continue;
+                            const v = r.value;
+                            if (v.totalVoted === 0n) {
+                                items.push({
+                                    dao,
+                                    type: "unvotedProposal",
+                                    proposalId: votingIds[i].id,
+                                    deadline: votingIds[i].deadline,
+                                });
+                            }
+                        }
+                    }
+                    // Pending rewards across all scanned proposals (best-effort —
+                    // contracts that don't expose `getPendingRewards` will silently
+                    // produce an empty list).
+                    if (proposalIds.length > 0) {
+                        const [rewardsR] = await multicall(provider, [
+                            {
+                                target: dao,
+                                iface: PENDING_REWARDS_ABI,
+                                method: "getPendingRewards",
+                                args: [userAddr, proposalIds.map((s) => BigInt(s))],
+                                allowFailure: true,
+                            },
+                        ]);
+                        if (rewardsR?.success) {
+                            const rw = rewardsR.value;
+                            const r = rw.rewards;
+                            if (r.amounts && r.amounts.length > 0) {
+                                let total = 0n;
+                                for (const a of r.amounts)
+                                    total += a;
+                                if (total > 0n) {
+                                    items.push({
+                                        dao,
+                                        type: "claimableRewards",
+                                        proposalIds: r.proposalIds.map((p) => p.toString()),
+                                        totalAmount: total.toString(),
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // Best-effort per DAO — skip on failure, don't poison the inbox.
+                continue;
+            }
+            if (items.length > 0)
+                daosWithItems++;
+            pendingItems.push(...items);
+        }
+        const criticalCount = pendingItems.filter((i) => i.type === "unvotedProposal").length;
+        return ok({
+            user: userAddr,
+            pendingItems,
+            summary: {
+                totalDaos: resolvedDaos.length,
+                daosWithItems,
+                criticalCount,
+            },
+        });
+    });
+}
+//# sourceMappingURL=inbox.js.map

package/dist/tools/inbox.js.map

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

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

@@ -1 +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;AAyB/C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA0BvE"}
+{"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;AA8B/C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA+BvE"}

package/dist/tools/index.js

@@ -19,6 +19,11 @@ import { registerDaoDeployTools } from "./daoDeploy.js";
 import { registerSubgraphTools } from "./subgraph.js";
 import { registerTxTools } from "./txSend.js";
 import { registerFlowTools } from "./flow.js";
+import { registerMerkleTools } from "./merkle.js";
+import { registerOtcTools } from "./otc.js";
+import { registerSimulateTools } from "./simulate.js";
+import { registerInboxTools } from "./inbox.js";
+import { registerPredictTools } from "./predict.js";
 import { SignerManager } from "../lib/signer.js";
 /**
  * Wire every dexe-mcp tool onto the given server instance. Builds the shared
@@ -46,8 +51,13 @@ export function registerAll(server, config) {
     registerVoteBuildTools(server, ctx);
     registerDaoDeployTools(server, ctx);
     registerSubgraphTools(server, ctx);
+    registerMerkleTools(server, ctx);
+    registerInboxTools(server, ctx);
+    registerPredictTools(server, ctx);
     const signer = new SignerManager(config);
     registerTxTools(server, config, signer);
     registerFlowTools(server, ctx, signer);
+    registerOtcTools(server, ctx, signer);
+    registerSimulateTools(server, ctx, signer);
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/merkle.d.ts

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

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

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

package/dist/tools/merkle.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+import { isAddress, getAddress } from "ethers";
+import { buildAddressMerkleTree, buildMerkleTree, computeLeafHash, verifyProof, } from "../lib/merkleTree.js";
+/**
+ * Merkle utility tools — produce roots and proofs compatible with
+ * OpenZeppelin's `StandardMerkleTree` and the on-chain verifier in
+ * `TokenSaleProposalBuy.sol::_checkMerkleProofs`.
+ *
+ * Default leaf encoding is `["address"]` (the only shape used by the
+ * frontend's OTC token-sale flow). Set `leafEncoding` + `entries` for
+ * advanced trees (e.g. `["address","uint256"]`).
+ */
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function jsonResult(value) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+        structuredContent: value,
+    };
+}
+function normaliseAddresses(addresses) {
+    const seen = new Set();
+    const result = [];
+    for (const raw of addresses) {
+        if (!isAddress(raw))
+            throw new Error(`Invalid address: ${raw}`);
+        const checksummed = getAddress(raw);
+        if (seen.has(checksummed.toLowerCase()))
+            continue;
+        seen.add(checksummed.toLowerCase());
+        result.push(checksummed);
+    }
+    return result;
+}
+export function registerMerkleTools(server, _ctx) {
+    server.registerTool("dexe_merkle_build", {
+        title: "Build a merkle tree (OZ StandardMerkleTree compatible)",
+        description: "Builds a merkle tree compatible with OpenZeppelin StandardMerkleTree (used by DeXe's TokenSaleProposal merkle whitelists). Default leaf shape is a single address; pass `leafEncoding` + `entries` for richer leaves (e.g. address + amount). Returns root, leaf hashes, and per-input-index proofs.",
+        inputSchema: {
+            addresses: z
+                .array(z.string())
+                .min(1)
+                .optional()
+                .describe("Convenience: addresses for an `address`-only merkle whitelist. Mutually exclusive with `entries`."),
+            entries: z
+                .array(z.array(z.union([z.string(), z.number()])))
+                .min(1)
+                .optional()
+                .describe("Advanced: per-leaf raw values matching `leafEncoding` order. Mutually exclusive with `addresses`."),
+            leafEncoding: z
+                .array(z.string())
+                .min(1)
+                .default(["address"])
+                .describe("ABI types for each leaf column. Default `['address']` matches the OTC frontend."),
+        },
+        outputSchema: {
+            root: z.string(),
+            leafHashes: z.array(z.string()),
+            proofs: z.array(z.array(z.string())),
+            addresses: z.array(z.string()).optional(),
+        },
+    }, async ({ addresses, entries, leafEncoding = ["address"] }) => {
+        try {
+            if (!addresses && !entries) {
+                return errorResult("Must provide either `addresses` or `entries`.");
+            }
+            if (addresses && entries) {
+                return errorResult("Provide either `addresses` or `entries`, not both.");
+            }
+            if (addresses) {
+                const normalised = normaliseAddresses(addresses);
+                const result = buildAddressMerkleTree(normalised);
+                return jsonResult({
+                    root: result.root,
+                    leafHashes: result.leafHashes,
+                    proofs: result.proofs,
+                    addresses: normalised,
+                });
+            }
+            const result = buildMerkleTree(entries, leafEncoding);
+            return jsonResult({
+                root: result.root,
+                leafHashes: result.leafHashes,
+                proofs: result.proofs,
+            });
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+    });
+    server.registerTool("dexe_merkle_proof", {
+        title: "Compute a merkle proof for one address (or leaf)",
+        description: "Builds the same tree as `dexe_merkle_build` and returns the proof for a single target. Useful for buyer-side flows where the full whitelist is known but only one proof is needed. Default shape: address-only.",
+        inputSchema: {
+            addresses: z
+                .array(z.string())
+                .min(1)
+                .optional()
+                .describe("Address-only whitelist (mutually exclusive with `entries`)."),
+            entries: z
+                .array(z.array(z.union([z.string(), z.number()])))
+                .min(1)
+                .optional(),
+            leafEncoding: z.array(z.string()).min(1).default(["address"]),
+            target: z.string().describe("Address (when using `addresses`)."),
+            targetEntry: z
+                .array(z.union([z.string(), z.number()]))
+                .optional()
+                .describe("Raw leaf values when using `entries`."),
+        },
+        outputSchema: {
+            root: z.string(),
+            leaf: z.string(),
+            proof: z.array(z.string()),
+            verified: z.boolean(),
+        },
+    }, async ({ addresses, entries, leafEncoding = ["address"], target, targetEntry }) => {
+        try {
+            if (!addresses && !entries) {
+                return errorResult("Must provide either `addresses` or `entries`.");
+            }
+            if (addresses) {
+                if (!isAddress(target))
+                    return errorResult(`Invalid target address: ${target}`);
+                const normalised = normaliseAddresses(addresses);
+                const checksummed = getAddress(target);
+                const idx = normalised.findIndex((a) => a.toLowerCase() === checksummed.toLowerCase());
+                if (idx === -1) {
+                    return errorResult(`Target ${checksummed} not present in whitelist.`);
+                }
+                const tree = buildAddressMerkleTree(normalised);
+                const leaf = computeLeafHash([checksummed], ["address"]);
+                const proof = tree.proofs[idx] ?? [];
+                return jsonResult({
+                    root: tree.root,
+                    leaf,
+                    proof,
+                    verified: verifyProof(proof, tree.root, leaf),
+                });
+            }
+            if (!entries) {
+                return errorResult("Must provide `entries` when not using `addresses`.");
+            }
+            if (!targetEntry) {
+                return errorResult("Provide `targetEntry` when using `entries`.");
+            }
+            const tree = buildMerkleTree(entries, leafEncoding);
+            const leaf = computeLeafHash(targetEntry, leafEncoding);
+            const idx = tree.leafHashes.findIndex((h) => h.toLowerCase() === leaf.toLowerCase());
+            if (idx === -1) {
+                return errorResult("Target entry leaf not in tree.");
+            }
+            let proof = [];
+            for (let i = 0; i < entries.length; i++) {
+                const candidateLeaf = computeLeafHash(entries[i], leafEncoding);
+                if (candidateLeaf.toLowerCase() === leaf.toLowerCase()) {
+                    proof = tree.proofs[i] ?? [];
+                    break;
+                }
+            }
+            return jsonResult({
+                root: tree.root,
+                leaf,
+                proof,
+                verified: verifyProof(proof, tree.root, leaf),
+            });
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=merkle.js.map

package/dist/tools/merkle.js.map

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

package/dist/tools/otc.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"otc.d.ts","sourceRoot":"","sources":["../../src/tools/otc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAgEjD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI,CA+iBN"}