dexe-mcp 0.1.5 → 0.2.0

package/dist/lib/addresses.js

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

package/dist/lib/addresses.js.map

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

package/dist/lib/calldata.d.ts

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

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

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

package/dist/lib/calldata.js

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

package/dist/lib/calldata.js.map

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

package/dist/lib/govEnums.d.ts

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

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

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

package/dist/lib/govEnums.js

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

package/dist/lib/govEnums.js.map

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

package/dist/lib/ipfs.d.ts

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

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

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

package/dist/lib/ipfs.js

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

package/dist/lib/ipfs.js.map

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

package/dist/lib/multicall.d.ts

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

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

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

package/dist/lib/multicall.js

@@ -0,0 +1,46 @@
+import { Contract } from "ethers";
+/**
+ * Multicall3 — deployed at the same address on ~every EVM chain.
+ * https://www.multicall3.com
+ */
+export const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+const MULTICALL3_ABI = [
+    "function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)",
+];
+/**
+ * Batch `calls` into a single Multicall3 aggregate3 RPC round-trip. Each call
+ * is decoded via its own `iface`. Failed calls with `allowFailure: true`
+ * yield `{ success: false, value: null }` instead of throwing.
+ */
+export async function multicall(provider, calls) {
+    if (calls.length === 0)
+        return [];
+    const mc = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    const payload = calls.map((c) => ({
+        target: c.target,
+        allowFailure: c.allowFailure ?? false,
+        callData: c.iface.encodeFunctionData(c.method, c.args),
+    }));
+    const results = await mc.getFunction("aggregate3").staticCall(payload);
+    return results.map((r, i) => {
+        const c = calls[i];
+        if (!r.success) {
+            return { success: false, value: null, raw: r.returnData, error: "call reverted" };
+        }
+        try {
+            const decoded = c.iface.decodeFunctionResult(c.method, r.returnData);
+            // Unwrap single-return-value tuples for ergonomic use.
+            const value = decoded.length === 1 ? decoded[0] : decoded;
+            return { success: true, value, raw: r.returnData };
+        }
+        catch (err) {
+            return {
+                success: false,
+                value: null,
+                raw: r.returnData,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    });
+}
+//# sourceMappingURL=multicall.js.map

package/dist/lib/multicall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicall.js","sourceRoot":"","sources":["../../src/lib/multicall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA8B,MAAM,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAE/E,MAAM,cAAc,GAAG;IACrB,kJAAkJ;CAC1I,CAAC;AAwBX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,kBAAkB,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,KAAK;QACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;KACvD,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GACX,MAAM,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACpF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YACrE,uDAAuD;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,CAAC,CAAC,UAAU;gBACjB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/proposalCatalog.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Static catalog of every proposal type the DeXe frontend exposes. Derived
+ * from a full audit of `C:/dev/investing-dashboard` forms + hooks
+ * (2026-04-15). Consumed by `dexe_proposal_catalog` so agents can discover
+ * which builder tool to call for a given user intent.
+ *
+ * `mcpTool` is the name of the dedicated MCP builder tool (when one exists)
+ * or `null` if agents must compose via primitives (`build_external` +
+ * `build_custom_abi`) — flip `implemented` to `true` as each ships.
+ */
+export type ProposalCategory = "external" | "internal" | "offchain";
+export interface ProposalTypeEntry {
+    id: string;
+    category: ProposalCategory;
+    name: string;
+    formPath: string;
+    /** High-level description of the on-chain effect or off-chain action. */
+    effect: string;
+    /** Target contract (on-chain) or backend endpoint (off-chain). */
+    target: string;
+    /** Does this type require an IPFS metadata upload? */
+    needsIpfs: boolean;
+    /** Gating tags: "expert", "validator", "babt", "dao-admin". */
+    gating: string[];
+    /** Dedicated MCP builder tool name, or null. */
+    mcpTool: string | null;
+    /** Shipped? */
+    implemented: boolean;
+}
+export declare const PROPOSAL_CATALOG: ProposalTypeEntry[];
+/** Metadata JSON shape used by the frontend for every external proposal. */
+export declare const EXTERNAL_METADATA_SHAPE: {
+    readonly proposalName: "string (required)";
+    readonly proposalDescription: "string (required, markdown/slate)";
+    readonly category: "string (e.g. 'Token Transfer', 'Manage Validators')";
+    readonly isMeta: "boolean (default false)";
+    readonly changes: "object (type-specific structured payload for indexing, optional)";
+};
+export declare const INTERNAL_METADATA_SHAPE: {
+    readonly proposalName: "string (required)";
+    readonly proposalDescription: "string";
+    readonly category: "string (ValidatorBalances | ValidatorSettings | MonthlyWithdraw | Offchain)";
+    readonly changes: "object (type-specific)";
+};
+//# sourceMappingURL=proposalCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposalCatalog.d.ts","sourceRoot":"","sources":["../../src/lib/proposalCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAkZ/C,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB;;;;;;CAM1B,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC"}