dexe-mcp 0.5.8 → 0.6.0

package/dist/governor/configs/uniswap.json

@@ -0,0 +1,32 @@
+{
+    "id": "uniswap",
+    "chainId": 1,
+    "governorAddress": "0x408ED6354d4973f66138C91495F2f2FCbd8724C3",
+    "governorVersion": "bravo-v3",
+    "votingToken": {
+        "type": "ERC20VotesComp",
+        "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
+        "symbol": "UNI",
+        "decimals": 18
+    },
+    "timelock": {
+        "address": "0x1a9C8182C09F50355CeA8fFF4b7E1649A535498a",
+        "minDelay": 172800
+    },
+    "votingParams": {
+        "votingDelay": 1,
+        "votingPeriod": 50400,
+        "proposalThreshold": "2500000000000000000000000",
+        "quorumNumerator": 4,
+        "quorumDenominator": 100
+    },
+    "executor": {
+        "type": "timelock",
+        "id": null
+    },
+    "explorer": {
+        "etherscanBase": "https://etherscan.io",
+        "tallyOrgSlug": "uniswap"
+    },
+    "notes": "Uniswap GovernorBravoDelegate (proxy). Bravo signatures: propose has signatures[], queue/execute take proposalId, quorum is fixed quorumVotes(), snapshot/deadline via proposals(uint256). ProposalState enum matches OZ canonical order."
+}

package/dist/governor/encoder.d.ts

@@ -0,0 +1,59 @@
+import type { GovernorConfig } from "./loader.js";
+/**
+ * Write-side ABI fragments per governor family. The exact selectors differ
+ * between OZ v4+ and Bravo for propose / queue / execute, so build tools
+ * MUST encode against the correct family. `castVote` and `castVoteWithReason`
+ * share signatures across families.
+ */
+export declare const GOVERNOR_OZ_WRITE_ABI: readonly ["function propose(address[] targets, uint256[] values, bytes[] calldatas, string description) returns (uint256)", "function castVote(uint256 proposalId, uint8 support) returns (uint256)", "function castVoteWithReason(uint256 proposalId, uint8 support, string reason) returns (uint256)", "function queue(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) returns (uint256)", "function execute(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) payable returns (uint256)", "function cancel(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) returns (uint256)", "function hashProposal(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) pure returns (uint256)"];
+export declare const GOVERNOR_BRAVO_WRITE_ABI: readonly ["function propose(address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, string description) returns (uint256)", "function castVote(uint256 proposalId, uint8 support)", "function castVoteWithReason(uint256 proposalId, uint8 support, string reason)", "function queue(uint256 proposalId)", "function execute(uint256 proposalId) payable", "function cancel(uint256 proposalId)"];
+export declare const IVOTES_WRITE_ABI: readonly ["function delegate(address delegatee)"];
+export interface BuiltTx {
+    to: string;
+    value: string;
+    data: string;
+    selector: string;
+    method: string;
+    args: unknown;
+    family: "oz" | "bravo";
+}
+/** Upper bound on a proposal's action count. Guards the calldata builders
+ * against pathological array sizes; well above any real governance proposal. */
+export declare const MAX_ACTIONS = 50;
+export interface ProposeArgs {
+    targets: string[];
+    values: (string | number | bigint)[];
+    calldatas: string[];
+    description: string;
+    /** Bravo only: per-target function signature strings (e.g. "transfer(address,uint256)"). Defaults to []. */
+    signatures?: string[];
+}
+export declare function buildPropose(cfg: GovernorConfig, args: ProposeArgs): BuiltTx;
+export type Support = 0 | 1 | 2;
+export declare function buildVoteCast(cfg: GovernorConfig, proposalId: string | bigint, support: Support, reason?: string): BuiltTx;
+export interface QueueExecuteArgs {
+    /** Bravo: proposalId. OZ: hash will be recomputed from the rest. */
+    proposalId?: string | bigint;
+    /** OZ only. */
+    targets?: string[];
+    /** OZ only. */
+    values?: (string | number | bigint)[];
+    /** OZ only. */
+    calldatas?: string[];
+    /** OZ only. Either the raw description (we hash it) or descriptionHash. */
+    description?: string;
+    descriptionHash?: string;
+}
+export declare function buildQueue(cfg: GovernorConfig, args: QueueExecuteArgs): BuiltTx;
+export declare function buildExecute(cfg: GovernorConfig, args: QueueExecuteArgs, msgValue?: string | bigint): BuiltTx;
+export declare function buildCancel(cfg: GovernorConfig, args: QueueExecuteArgs): BuiltTx;
+export declare function buildDelegate(cfg: GovernorConfig, delegatee: string): BuiltTx;
+/**
+ * Round-trip helper exposed for tests: decode calldata back into named args
+ * for selector-validity + arg-roundtrip assertions.
+ */
+export declare function decodeGovernorWrite(cfg: GovernorConfig, data: string): {
+    method: string;
+    args: unknown[];
+};
+//# sourceMappingURL=encoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/governor/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;GAKG;AAEH,eAAO,MAAM,qBAAqB,qxBAQxB,CAAC;AAEX,eAAO,MAAM,wBAAwB,wZAO3B,CAAC;AAEX,eAAO,MAAM,gBAAgB,mDAEnB,CAAC;AAEX,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;CACxB;AAmDD;gFACgF;AAChF,eAAO,MAAM,WAAW,KAAK,CAAC;AAwB9B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CA+B5E;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhC,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAmBT;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe;IACf,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACtC,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAeD,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CA+B/E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAgC7G;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CA+BhF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAa7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAK1G"}

package/dist/governor/encoder.js

@@ -0,0 +1,290 @@
+import { Interface, isAddress, keccak256, toUtf8Bytes } from "ethers";
+import { isBravo } from "./adapter.js";
+/**
+ * Write-side ABI fragments per governor family. The exact selectors differ
+ * between OZ v4+ and Bravo for propose / queue / execute, so build tools
+ * MUST encode against the correct family. `castVote` and `castVoteWithReason`
+ * share signatures across families.
+ */
+export const GOVERNOR_OZ_WRITE_ABI = [
+    "function propose(address[] targets, uint256[] values, bytes[] calldatas, string description) returns (uint256)",
+    "function castVote(uint256 proposalId, uint8 support) returns (uint256)",
+    "function castVoteWithReason(uint256 proposalId, uint8 support, string reason) returns (uint256)",
+    "function queue(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) returns (uint256)",
+    "function execute(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) payable returns (uint256)",
+    "function cancel(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) returns (uint256)",
+    "function hashProposal(address[] targets, uint256[] values, bytes[] calldatas, bytes32 descriptionHash) pure returns (uint256)",
+];
+export const GOVERNOR_BRAVO_WRITE_ABI = [
+    "function propose(address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, string description) returns (uint256)",
+    "function castVote(uint256 proposalId, uint8 support)",
+    "function castVoteWithReason(uint256 proposalId, uint8 support, string reason)",
+    "function queue(uint256 proposalId)",
+    "function execute(uint256 proposalId) payable",
+    "function cancel(uint256 proposalId)",
+];
+export const IVOTES_WRITE_ABI = [
+    "function delegate(address delegatee)",
+];
+function governorIface(cfg) {
+    return new Interface((isBravo(cfg) ? GOVERNOR_BRAVO_WRITE_ABI : GOVERNOR_OZ_WRITE_ABI));
+}
+function family(cfg) {
+    return isBravo(cfg) ? "bravo" : "oz";
+}
+function selectorOf(iface, method) {
+    const fn = iface.getFunction(method);
+    if (!fn)
+        throw new Error(`encoder: method ${method} missing from ABI`);
+    return fn.selector;
+}
+function ensureAddressArray(label, xs) {
+    if (!Array.isArray(xs))
+        throw new Error(`${label} must be an array`);
+    for (const a of xs)
+        if (typeof a !== "string" || !isAddress(a))
+            throw new Error(`${label} has invalid address: ${String(a)}`);
+    return xs;
+}
+function ensureBytesArray(label, xs) {
+    if (!Array.isArray(xs))
+        throw new Error(`${label} must be an array`);
+    for (const b of xs) {
+        if (typeof b !== "string" || !/^0x([a-fA-F0-9]{2})*$/.test(b)) {
+            throw new Error(`${label} has invalid 0x-prefixed hex: ${String(b)}`);
+        }
+    }
+    return xs;
+}
+function ensureUintArray(label, xs) {
+    if (!Array.isArray(xs))
+        throw new Error(`${label} must be an array`);
+    return xs.map((v, i) => {
+        try {
+            return BigInt(v);
+        }
+        catch {
+            throw new Error(`${label}[${i}] is not a valid uint: ${String(v)}`);
+        }
+    });
+}
+function ensureStringArray(label, xs) {
+    if (!Array.isArray(xs))
+        throw new Error(`${label} must be an array`);
+    for (const s of xs)
+        if (typeof s !== "string")
+            throw new Error(`${label} must be string[]`);
+    return xs;
+}
+/** Upper bound on a proposal's action count. Guards the calldata builders
+ * against pathological array sizes; well above any real governance proposal. */
+export const MAX_ACTIONS = 50;
+/**
+ * Validates the OZ action tuple: equal lengths, non-empty (Governor reverts on
+ * empty proposals), and within MAX_ACTIONS. Shared by propose/queue/execute/cancel
+ * so every OZ path enforces the same shape.
+ */
+function ensureActionParity(label, targets, values, calldatas) {
+    if (targets.length !== values.length || targets.length !== calldatas.length) {
+        throw new Error(`${label}: target/value/calldata length mismatch (targets=${targets.length}, values=${values.length}, calldatas=${calldatas.length})`);
+    }
+    if (targets.length === 0)
+        throw new Error(`${label}: at least one action is required`);
+    if (targets.length > MAX_ACTIONS) {
+        throw new Error(`${label}: too many actions (${targets.length} > ${MAX_ACTIONS})`);
+    }
+}
+export function buildPropose(cfg, args) {
+    const iface = governorIface(cfg);
+    const targets = ensureAddressArray("targets", args.targets);
+    const values = ensureUintArray("values", args.values);
+    const calldatas = ensureBytesArray("calldatas", args.calldatas);
+    if (typeof args.description !== "string")
+        throw new Error("description must be a string");
+    ensureActionParity("propose", targets, values, calldatas);
+    let data;
+    let argsOut;
+    if (isBravo(cfg)) {
+        const signatures = args.signatures
+            ? ensureStringArray("signatures", args.signatures)
+            : new Array(targets.length).fill("");
+        if (signatures.length !== targets.length) {
+            throw new Error(`bravo propose: signatures length ${signatures.length} != targets length ${targets.length}`);
+        }
+        data = iface.encodeFunctionData("propose", [targets, values, signatures, calldatas, args.description]);
+        argsOut = { targets, values: values.map(String), signatures, calldatas, description: args.description };
+    }
+    else {
+        data = iface.encodeFunctionData("propose", [targets, values, calldatas, args.description]);
+        argsOut = { targets, values: values.map(String), calldatas, description: args.description };
+    }
+    return {
+        to: cfg.governorAddress,
+        value: "0",
+        data,
+        selector: data.slice(0, 10),
+        method: "propose",
+        args: argsOut,
+        family: family(cfg),
+    };
+}
+export function buildVoteCast(cfg, proposalId, support, reason) {
+    if (![0, 1, 2].includes(support))
+        throw new Error(`support must be 0|1|2, got ${support}`);
+    const iface = governorIface(cfg);
+    const pid = BigInt(proposalId);
+    const method = reason !== undefined ? "castVoteWithReason" : "castVote";
+    const data = reason !== undefined
+        ? iface.encodeFunctionData("castVoteWithReason", [pid, support, reason])
+        : iface.encodeFunctionData("castVote", [pid, support]);
+    return {
+        to: cfg.governorAddress,
+        value: "0",
+        data,
+        selector: data.slice(0, 10),
+        method,
+        args: reason !== undefined
+            ? { proposalId: pid.toString(), support, reason }
+            : { proposalId: pid.toString(), support },
+        family: family(cfg),
+    };
+}
+function computeDescHash(args) {
+    if (args.descriptionHash) {
+        if (!/^0x[a-fA-F0-9]{64}$/.test(args.descriptionHash)) {
+            throw new Error(`descriptionHash must be 32-byte hex; got ${args.descriptionHash}`);
+        }
+        return args.descriptionHash;
+    }
+    if (typeof args.description !== "string") {
+        throw new Error("OZ queue/execute: either description or descriptionHash is required");
+    }
+    return keccak256(toUtf8Bytes(args.description));
+}
+export function buildQueue(cfg, args) {
+    const iface = governorIface(cfg);
+    if (isBravo(cfg)) {
+        if (args.proposalId === undefined)
+            throw new Error("bravo queue: proposalId required");
+        const pid = BigInt(args.proposalId);
+        const data = iface.encodeFunctionData("queue", [pid]);
+        return {
+            to: cfg.governorAddress,
+            value: "0",
+            data,
+            selector: data.slice(0, 10),
+            method: "queue",
+            args: { proposalId: pid.toString() },
+            family: "bravo",
+        };
+    }
+    const targets = ensureAddressArray("targets", args.targets);
+    const values = ensureUintArray("values", args.values);
+    const calldatas = ensureBytesArray("calldatas", args.calldatas);
+    ensureActionParity("queue", targets, values, calldatas);
+    const descriptionHash = computeDescHash(args);
+    const data = iface.encodeFunctionData("queue", [targets, values, calldatas, descriptionHash]);
+    return {
+        to: cfg.governorAddress,
+        value: "0",
+        data,
+        selector: data.slice(0, 10),
+        method: "queue",
+        args: { targets, values: values.map(String), calldatas, descriptionHash },
+        family: "oz",
+    };
+}
+export function buildExecute(cfg, args, msgValue) {
+    const iface = governorIface(cfg);
+    const value = msgValue === undefined ? "0" : BigInt(msgValue).toString();
+    if (isBravo(cfg)) {
+        if (args.proposalId === undefined)
+            throw new Error("bravo execute: proposalId required");
+        const pid = BigInt(args.proposalId);
+        const data = iface.encodeFunctionData("execute", [pid]);
+        return {
+            to: cfg.governorAddress,
+            value,
+            data,
+            selector: data.slice(0, 10),
+            method: "execute",
+            args: { proposalId: pid.toString() },
+            family: "bravo",
+        };
+    }
+    const targets = ensureAddressArray("targets", args.targets);
+    const values = ensureUintArray("values", args.values);
+    const calldatas = ensureBytesArray("calldatas", args.calldatas);
+    ensureActionParity("execute", targets, values, calldatas);
+    const descriptionHash = computeDescHash(args);
+    const data = iface.encodeFunctionData("execute", [targets, values, calldatas, descriptionHash]);
+    return {
+        to: cfg.governorAddress,
+        value,
+        data,
+        selector: data.slice(0, 10),
+        method: "execute",
+        args: { targets, values: values.map(String), calldatas, descriptionHash },
+        family: "oz",
+    };
+}
+export function buildCancel(cfg, args) {
+    const iface = governorIface(cfg);
+    if (isBravo(cfg)) {
+        if (args.proposalId === undefined)
+            throw new Error("bravo cancel: proposalId required");
+        const pid = BigInt(args.proposalId);
+        const data = iface.encodeFunctionData("cancel", [pid]);
+        return {
+            to: cfg.governorAddress,
+            value: "0",
+            data,
+            selector: data.slice(0, 10),
+            method: "cancel",
+            args: { proposalId: pid.toString() },
+            family: "bravo",
+        };
+    }
+    const targets = ensureAddressArray("targets", args.targets);
+    const values = ensureUintArray("values", args.values);
+    const calldatas = ensureBytesArray("calldatas", args.calldatas);
+    ensureActionParity("cancel", targets, values, calldatas);
+    const descriptionHash = computeDescHash(args);
+    const data = iface.encodeFunctionData("cancel", [targets, values, calldatas, descriptionHash]);
+    return {
+        to: cfg.governorAddress,
+        value: "0",
+        data,
+        selector: data.slice(0, 10),
+        method: "cancel",
+        args: { targets, values: values.map(String), calldatas, descriptionHash },
+        family: "oz",
+    };
+}
+export function buildDelegate(cfg, delegatee) {
+    if (!isAddress(delegatee))
+        throw new Error(`delegate: invalid delegatee address ${delegatee}`);
+    const iface = new Interface(IVOTES_WRITE_ABI);
+    const data = iface.encodeFunctionData("delegate", [delegatee]);
+    return {
+        to: cfg.votingToken.address,
+        value: "0",
+        data,
+        selector: data.slice(0, 10),
+        method: "delegate",
+        args: { delegatee },
+        family: family(cfg),
+    };
+}
+/**
+ * Round-trip helper exposed for tests: decode calldata back into named args
+ * for selector-validity + arg-roundtrip assertions.
+ */
+export function decodeGovernorWrite(cfg, data) {
+    const iface = governorIface(cfg);
+    const decoded = iface.parseTransaction({ data });
+    if (!decoded)
+        throw new Error(`decodeGovernorWrite: could not parse calldata for ${cfg.id}`);
+    return { method: decoded.name, args: decoded.args.toArray() };
+}
+//# sourceMappingURL=encoder.js.map

package/dist/governor/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/governor/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,gHAAgH;IAChH,wEAAwE;IACxE,iGAAiG;IACjG,mHAAmH;IACnH,6HAA6H;IAC7H,oHAAoH;IACpH,+HAA+H;CACvH,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qIAAqI;IACrI,sDAAsD;IACtD,+EAA+E;IAC/E,oCAAoC;IACpC,8CAA8C;IAC9C,qCAAqC;CAC7B,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sCAAsC;CAC9B,CAAC;AAYX,SAAS,aAAa,CAAC,GAAmB;IACxC,OAAO,IAAI,SAAS,CAClB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,qBAAqB,CAAwB,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,GAAmB;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,KAAgB,EAAE,MAAc;IAClD,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,mBAAmB,CAAC,CAAC;IACvE,OAAO,EAAE,CAAC,QAAQ,CAAC;AACrB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,EAAW;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yBAAyB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9H,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,EAAW;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iCAAiC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,EAAW;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,CAA6B,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,0BAA0B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa,EAAE,EAAW;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;gFACgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B;;;;GAIG;AACH,SAAS,kBAAkB,CACzB,KAAa,EACb,OAAkB,EAClB,MAAiB,EACjB,SAAoB;IAEpB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,oDAAoD,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,eAAe,SAAS,CAAC,MAAM,GAAG,CACtI,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uBAAuB,OAAO,CAAC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,YAAY,CAAC,GAAmB,EAAE,IAAiB;IACjE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC1F,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,IAAY,CAAC;IACjB,IAAI,OAAgB,CAAC;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU;YAChC,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC;YAClD,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,CAAC,MAAM,sBAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACvG,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1G,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3F,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,eAAe;QACvB,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;KACpB,CAAC;AACJ,CAAC;AAID,MAAM,UAAU,aAAa,CAC3B,GAAmB,EACnB,UAA2B,EAC3B,OAAgB,EAChB,MAAe;IAEf,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS;QAC/B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,eAAe;QACvB,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM;QACN,IAAI,EAAE,MAAM,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;YACjD,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE;QAC3C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;KACpB,CAAC;AACJ,CAAC;AAgBD,SAAS,eAAe,CAAC,IAAsB;IAC7C,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAmB,EAAE,IAAsB;IACpE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACvF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,eAAe;YACvB,KAAK,EAAE,GAAG;YACV,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE;YACpC,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC9F,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,eAAe;QACvB,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE;QACzE,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAmB,EAAE,IAAsB,EAAE,QAA0B;IAClG,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,eAAe;YACvB,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE;YACpC,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAChG,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,eAAe;QACvB,KAAK;QACL,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE;QACzE,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAmB,EAAE,IAAsB;IACrE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,eAAe;YACvB,KAAK,EAAE,GAAG;YACV,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE;YACpC,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC/F,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,eAAe;QACvB,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE;QACzE,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAmB,EAAE,SAAiB;IAClE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,gBAAuC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC,OAAO;QAC3B,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,EAAE,SAAS,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAmB,EAAE,IAAY;IACnE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;AAChE,CAAC"}

package/dist/governor/index.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DexeConfig } from "../config.js";
+/**
+ * External Governor MCP surface (research/06-execution-plan.md).
+ *
+ * Independent from DeXe Protocol tools — no dependency on DeXe contracts being
+ * deployed on the target chain (AC #11). Tools live under the `dexe_gov_*`
+ * namespace.
+ */
+export declare function registerGovernorTools(server: McpServer, config: DexeConfig): void;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/governor/index.js

@@ -0,0 +1,20 @@
+import { RpcProvider } from "../rpc.js";
+import { registerGovernorReadTools } from "./tools/read.js";
+import { registerGovernorBuildTools } from "./tools/build.js";
+import { registerGovernorSimulateTools } from "./tools/simulate.js";
+import { registerGovernorExtraTools } from "./tools/extras.js";
+/**
+ * External Governor MCP surface (research/06-execution-plan.md).
+ *
+ * Independent from DeXe Protocol tools — no dependency on DeXe contracts being
+ * deployed on the target chain (AC #11). Tools live under the `dexe_gov_*`
+ * namespace.
+ */
+export function registerGovernorTools(server, config) {
+    const rpc = new RpcProvider(config);
+    registerGovernorReadTools(server, rpc);
+    registerGovernorBuildTools(server);
+    registerGovernorSimulateTools(server, rpc);
+    registerGovernorExtraTools(server, rpc);
+}
+//# sourceMappingURL=index.js.map

package/dist/governor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governor/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAkB;IACzE,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,6BAA6B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/governor/loader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Per-DAO Governor config. Source of truth lives in src/governor/configs/*.json
+ * and is imported here so `tsc` bundles the JSON into dist without an extra
+ * copy step. To add a new DAO: drop a JSON file in configs/, add an import
+ * line below, and append to ALL_CONFIGS.
+ */
+export interface GovernorConfig {
+    id: string;
+    chainId: number;
+    governorAddress: string;
+    governorVersion: "oz-v4" | "oz-v5" | "bravo-v3";
+    votingToken: {
+        type: "ERC20Votes" | "ERC20VotesComp";
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    timelock?: {
+        address: string;
+        minDelay: number;
+    };
+    votingParams: {
+        votingDelay: number;
+        votingPeriod: number;
+        proposalThreshold?: string;
+        quorumNumerator: number;
+        quorumDenominator: number;
+    };
+    executor: {
+        type: "timelock" | "governor-self";
+        id?: string | null;
+    };
+    explorer?: {
+        etherscanBase?: string;
+        tallyOrgSlug?: string;
+    };
+    notes?: string;
+}
+export declare function validateGovernorConfig(raw: unknown, source: string): GovernorConfig;
+export declare function loadGovernorConfigs(): Map<string, GovernorConfig>;
+export declare function resolveGovernor(idOrAddress: string): GovernorConfig;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/governor/loader.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD,WAAW,EAAE;QACX,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,EAAE;QAAE,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAgEnF;AAID,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAWjE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAQnE"}

package/dist/governor/loader.js

@@ -0,0 +1,103 @@
+import uniswap from "./configs/uniswap.json" with { type: "json" };
+import compound from "./configs/compound.json" with { type: "json" };
+import optimism from "./configs/optimism.json" with { type: "json" };
+const RAW_CONFIGS = [uniswap, compound, optimism];
+const ADDR_RE = /^0x[a-fA-F0-9]{40}$/;
+function assertAddress(label, v) {
+    if (typeof v !== "string" || !ADDR_RE.test(v)) {
+        throw new Error(`governor config: ${label} must be a 0x-prefixed 20-byte address, got ${String(v)}`);
+    }
+}
+export function validateGovernorConfig(raw, source) {
+    if (!raw || typeof raw !== "object") {
+        throw new Error(`governor config ${source}: root must be an object`);
+    }
+    const o = raw;
+    if (typeof o.id !== "string" || !/^[a-z0-9-]+$/.test(o.id)) {
+        throw new Error(`governor config ${source}: id must match /^[a-z0-9-]+$/`);
+    }
+    if (typeof o.chainId !== "number" || o.chainId < 1) {
+        throw new Error(`governor config ${source}: chainId must be a positive integer`);
+    }
+    assertAddress(`${source}.governorAddress`, o.governorAddress);
+    const version = o.governorVersion ?? "oz-v4";
+    if (!["oz-v4", "oz-v5", "bravo-v3"].includes(version)) {
+        throw new Error(`governor config ${source}: governorVersion must be oz-v4|oz-v5|bravo-v3`);
+    }
+    const vt = o.votingToken;
+    if (!vt || typeof vt !== "object")
+        throw new Error(`${source}: votingToken missing`);
+    assertAddress(`${source}.votingToken.address`, vt.address);
+    if (!["ERC20Votes", "ERC20VotesComp"].includes(vt.type)) {
+        throw new Error(`${source}: votingToken.type must be ERC20Votes|ERC20VotesComp`);
+    }
+    if (typeof vt.symbol !== "string")
+        throw new Error(`${source}: votingToken.symbol missing`);
+    const decimals = typeof vt.decimals === "number" ? vt.decimals : 18;
+    if (o.timelock !== undefined) {
+        assertAddress(`${source}.timelock.address`, o.timelock?.address);
+        if (typeof o.timelock?.minDelay !== "number") {
+            throw new Error(`${source}: timelock.minDelay must be a number (seconds)`);
+        }
+    }
+    const vp = o.votingParams;
+    if (!vp || typeof vp !== "object")
+        throw new Error(`${source}: votingParams missing`);
+    if (typeof vp.votingDelay !== "number")
+        throw new Error(`${source}: votingParams.votingDelay missing`);
+    if (typeof vp.votingPeriod !== "number")
+        throw new Error(`${source}: votingParams.votingPeriod missing`);
+    if (typeof vp.quorumNumerator !== "number") {
+        throw new Error(`${source}: votingParams.quorumNumerator missing`);
+    }
+    const ex = o.executor;
+    if (!ex || typeof ex !== "object")
+        throw new Error(`${source}: executor missing`);
+    if (!["timelock", "governor-self"].includes(ex.type)) {
+        throw new Error(`${source}: executor.type must be timelock|governor-self`);
+    }
+    return {
+        id: o.id,
+        chainId: o.chainId,
+        governorAddress: o.governorAddress,
+        governorVersion: version,
+        votingToken: { type: vt.type, address: vt.address, symbol: vt.symbol, decimals },
+        timelock: o.timelock,
+        votingParams: {
+            votingDelay: vp.votingDelay,
+            votingPeriod: vp.votingPeriod,
+            proposalThreshold: vp.proposalThreshold,
+            quorumNumerator: vp.quorumNumerator,
+            quorumDenominator: typeof vp.quorumDenominator === "number" ? vp.quorumDenominator : 100,
+        },
+        executor: { type: ex.type, id: ex.id ?? null },
+        explorer: o.explorer,
+        notes: o.notes,
+    };
+}
+let cache = null;
+export function loadGovernorConfigs() {
+    if (cache)
+        return cache;
+    const out = new Map();
+    for (const raw of RAW_CONFIGS) {
+        const id = typeof raw?.id === "string" ? raw.id : "<anonymous>";
+        const cfg = validateGovernorConfig(raw, `configs/${id}.json`);
+        if (out.has(cfg.id))
+            throw new Error(`governor config: duplicate id "${cfg.id}"`);
+        out.set(cfg.id, cfg);
+    }
+    cache = out;
+    return cache;
+}
+export function resolveGovernor(idOrAddress) {
+    const configs = loadGovernorConfigs();
+    const lower = idOrAddress.toLowerCase();
+    for (const cfg of configs.values()) {
+        if (cfg.id === idOrAddress || cfg.governorAddress.toLowerCase() === lower)
+            return cfg;
+    }
+    const known = [...configs.keys()].join(", ") || "(none)";
+    throw new Error(`unknown governor "${idOrAddress}"; known ids: [${known}]`);
+}
+//# sourceMappingURL=loader.js.map

package/dist/governor/loader.js.map

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