dexe-mcp 0.1.3 → 0.2.0

package/dist/tools/read.js

@@ -0,0 +1,353 @@
+import { z } from "zod";
+import { Interface, isAddress, ZeroAddress } from "ethers";
+import { RpcProvider } from "../rpc.js";
+import { multicall } from "../lib/multicall.js";
+const GOV_POOL_ABI = [
+    "function getHelperContracts() view returns (address settings, address userKeeper, address validators, address poolRegistry, address votePower)",
+    "function getExpertStatus(address user) view returns (bool)",
+    "function getNftContracts() view returns (address nftMultiplier, address expertNft, address dexeExpertNft, address babt)",
+];
+const GOV_VALIDATORS_ABI = [
+    "function validatorsCount() view returns (uint256)",
+    "function isValidator(address user) view returns (bool)",
+];
+const GOV_SETTINGS_ABI = [
+    "function getDefaultSettings() view returns (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))",
+    "function getInternalSettings() view returns (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))",
+];
+const ERC20_ABI = [
+    "function balanceOf(address) view returns (uint256)",
+    "function symbol() view returns (string)",
+    "function decimals() view returns (uint8)",
+];
+const ERC721_HOLDER_ABI = [
+    "function balanceOf(address) view returns (uint256)",
+];
+const BABT_ABI = [
+    "function balanceOf(address) view returns (uint256)",
+];
+export function registerReadTools(server, ctx) {
+    const rpc = new RpcProvider(ctx.config);
+    registerMulticall(server, rpc);
+    registerTreasury(server, rpc);
+    registerValidators(server, rpc);
+    registerSettings(server, rpc);
+    registerExpertStatus(server, rpc);
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function registerMulticall(server, rpc) {
+    server.registerTool("dexe_read_multicall", {
+        title: "Arbitrary batched eth_call via Multicall3",
+        description: "Execute N independent view calls in a single RPC round-trip. Each call supplies its own ABI signature fragment, target, method, and args. Results are decoded per-call.",
+        inputSchema: {
+            calls: z
+                .array(z.object({
+                target: z.string(),
+                signature: z
+                    .string()
+                    .describe("Full function signature, e.g. 'function balanceOf(address) view returns (uint256)'"),
+                method: z.string().describe("Method name matching the signature"),
+                args: z.array(z.unknown()).default([]),
+                allowFailure: z.boolean().default(true),
+            }))
+                .min(1),
+        },
+        outputSchema: {
+            results: z.array(z.object({
+                success: z.boolean(),
+                value: z.unknown().nullable(),
+                raw: z.string(),
+                error: z.string().optional(),
+            })),
+        },
+    }, async ({ calls }) => {
+        try {
+            const provider = rpc.requireProvider();
+            const batch = calls.map((c) => {
+                if (!isAddress(c.target))
+                    throw new Error(`Invalid target: ${c.target}`);
+                return {
+                    target: c.target,
+                    iface: new Interface([c.signature]),
+                    method: c.method,
+                    args: c.args.map(coerceArg),
+                    allowFailure: c.allowFailure,
+                };
+            });
+            const results = await multicall(provider, batch);
+            const structured = {
+                results: results.map((r) => ({
+                    success: r.success,
+                    value: jsonSafe(r.value),
+                    raw: r.raw,
+                    error: r.error,
+                })),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${results.length} calls: ${results.filter((r) => r.success).length} ok, ${results.filter((r) => !r.success).length} failed`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`read_multicall failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function registerTreasury(server, rpc) {
+    server.registerTool("dexe_read_treasury", {
+        title: "Native + ERC20 balances for a DAO or arbitrary address",
+        description: "Reads native coin balance + one-or-more ERC20 balances (symbol, decimals, balance) in a single multicall. Pass the GovPool address to query DAO treasury.",
+        inputSchema: {
+            holder: z.string().describe("Address whose balances we read"),
+            tokens: z.array(z.string()).default([]).describe("ERC20 contract addresses"),
+        },
+        outputSchema: {
+            holder: z.string(),
+            native: z.string(),
+            tokens: z.array(z.object({
+                token: z.string(),
+                symbol: z.string().nullable(),
+                decimals: z.number().nullable(),
+                balance: z.string().nullable(),
+            })),
+        },
+    }, async ({ holder, tokens = [] }) => {
+        if (!isAddress(holder))
+            return errorResult(`Invalid holder: ${holder}`);
+        try {
+            const provider = rpc.requireProvider();
+            const native = (await provider.getBalance(holder)).toString();
+            const iface = new Interface(ERC20_ABI);
+            const calls = [];
+            for (const t of tokens) {
+                if (!isAddress(t))
+                    throw new Error(`Invalid token: ${t}`);
+                calls.push({ target: t, iface, method: "balanceOf", args: [holder], allowFailure: true });
+                calls.push({ target: t, iface, method: "symbol", args: [], allowFailure: true });
+                calls.push({ target: t, iface, method: "decimals", args: [], allowFailure: true });
+            }
+            const res = await multicall(provider, calls);
+            const tokensOut = tokens.map((t, i) => ({
+                token: t,
+                balance: res[i * 3]?.success ? res[i * 3].value.toString() : null,
+                symbol: res[i * 3 + 1]?.success ? res[i * 3 + 1].value : null,
+                decimals: res[i * 3 + 2]?.success ? Number(res[i * 3 + 2].value) : null,
+            }));
+            const structured = { holder, native, tokens: tokensOut };
+            const text = `Treasury for ${holder}\n  native: ${native}\n` +
+                tokensOut
+                    .map((t) => `  ${t.symbol ?? "?"} (${t.token}): ${t.balance ?? "?"}${t.decimals != null ? ` (decimals=${t.decimals})` : ""}`)
+                    .join("\n");
+            return { content: [{ type: "text", text }], structuredContent: structured };
+        }
+        catch (err) {
+            return errorResult(`read_treasury failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function registerValidators(server, rpc) {
+    server.registerTool("dexe_read_validators", {
+        title: "Validator count + isValidator lookup",
+        description: "Reads `validatorsCount()` and optionally checks `isValidator(candidate)` on the DAO's GovValidators contract.",
+        inputSchema: {
+            govPool: z.string().describe("GovPool address"),
+            candidate: z.string().optional().describe("Optional address to check validator status for"),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            validators: z.string(),
+            count: z.string(),
+            candidate: z.string().nullable(),
+            isValidator: z.boolean().nullable(),
+        },
+    }, async ({ govPool, candidate }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid govPool: ${govPool}`);
+        if (candidate && !isAddress(candidate))
+            return errorResult(`Invalid candidate: ${candidate}`);
+        try {
+            const provider = rpc.requireProvider();
+            const gp = new Interface(GOV_POOL_ABI);
+            const v = new Interface(GOV_VALIDATORS_ABI);
+            const [helpersR] = await multicall(provider, [
+                { target: govPool, iface: gp, method: "getHelperContracts", args: [] },
+            ]);
+            if (!helpersR?.success)
+                return errorResult("getHelperContracts reverted");
+            const validators = helpersR.value.validators;
+            const calls = [
+                { target: validators, iface: v, method: "validatorsCount", args: [] },
+            ];
+            if (candidate) {
+                calls.push({
+                    target: validators,
+                    iface: v,
+                    method: "isValidator",
+                    args: [candidate],
+                    allowFailure: true,
+                });
+            }
+            const res = await multicall(provider, calls);
+            const count = res[0].value.toString();
+            const isVal = candidate ? Boolean(res[1]?.value) : null;
+            const structured = {
+                govPool,
+                validators,
+                count,
+                candidate: candidate ?? null,
+                isValidator: isVal,
+            };
+            const text = `Validators contract ${validators}\n  count: ${count}` +
+                (candidate ? `\n  ${candidate} isValidator: ${isVal}` : "");
+            return { content: [{ type: "text", text }], structuredContent: structured };
+        }
+        catch (err) {
+            return errorResult(`read_validators failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function registerSettings(server, rpc) {
+    server.registerTool("dexe_read_settings", {
+        title: "Default + internal proposal settings for a DAO",
+        description: "Reads `GovSettings.getDefaultSettings()` and `getInternalSettings()` on the DAO's settings contract.",
+        inputSchema: {
+            govPool: z.string(),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            settings: z.string(),
+            defaultSettings: z.unknown(),
+            internalSettings: z.unknown(),
+        },
+    }, async ({ govPool }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid govPool: ${govPool}`);
+        try {
+            const provider = rpc.requireProvider();
+            const gp = new Interface(GOV_POOL_ABI);
+            const s = new Interface(GOV_SETTINGS_ABI);
+            const [helpersR] = await multicall(provider, [
+                { target: govPool, iface: gp, method: "getHelperContracts", args: [] },
+            ]);
+            if (!helpersR?.success)
+                return errorResult("getHelperContracts reverted");
+            const settings = helpersR.value.settings;
+            const [defR, intR] = await multicall(provider, [
+                { target: settings, iface: s, method: "getDefaultSettings", args: [], allowFailure: true },
+                { target: settings, iface: s, method: "getInternalSettings", args: [], allowFailure: true },
+            ]);
+            const structured = {
+                govPool,
+                settings,
+                defaultSettings: jsonSafe(defR?.value ?? null),
+                internalSettings: jsonSafe(intR?.value ?? null),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Settings for ${govPool}\n  contract: ${settings}\n\n` +
+                            `default: ${JSON.stringify(structured.defaultSettings, null, 2)}\n\n` +
+                            `internal: ${JSON.stringify(structured.internalSettings, null, 2)}`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`read_settings failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function registerExpertStatus(server, rpc) {
+    server.registerTool("dexe_read_expert_status", {
+        title: "Expert + BABT status for a user in a DAO",
+        description: "Reads `GovPool.getExpertStatus(user)` and, if a BABT contract is configured on the DAO, `BABT.balanceOf(user) > 0`.",
+        inputSchema: {
+            govPool: z.string(),
+            user: z.string(),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            user: z.string(),
+            isExpert: z.boolean(),
+            babt: z.string(),
+            hasBabt: z.boolean().nullable(),
+        },
+    }, async ({ govPool, user }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid govPool: ${govPool}`);
+        if (!isAddress(user))
+            return errorResult(`Invalid user: ${user}`);
+        try {
+            const provider = rpc.requireProvider();
+            const gp = new Interface(GOV_POOL_ABI);
+            const babt = new Interface(BABT_ABI);
+            const [expertR, nftR] = await multicall(provider, [
+                { target: govPool, iface: gp, method: "getExpertStatus", args: [user], allowFailure: true },
+                { target: govPool, iface: gp, method: "getNftContracts", args: [], allowFailure: true },
+            ]);
+            const isExpert = expertR?.success ? Boolean(expertR.value) : false;
+            const babtAddr = nftR?.success
+                ? nftR.value.babt
+                : ZeroAddress;
+            let hasBabt = null;
+            if (babtAddr && babtAddr !== ZeroAddress && isAddress(babtAddr)) {
+                const [bR] = await multicall(provider, [
+                    { target: babtAddr, iface: babt, method: "balanceOf", args: [user], allowFailure: true },
+                ]);
+                if (bR?.success)
+                    hasBabt = bR.value > 0n;
+            }
+            const structured = { govPool, user, isExpert, babt: babtAddr, hasBabt };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Expert status for ${user} on ${govPool}: expert=${isExpert}, babt=${babtAddr}, hasBabt=${hasBabt}`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`read_expert_status failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+// ---------- helpers ----------
+function coerceArg(a) {
+    // Allow stringified bigints for numeric args.
+    if (typeof a === "string" && /^-?\d+$/.test(a) && a.length > 9) {
+        try {
+            return BigInt(a);
+        }
+        catch {
+            return a;
+        }
+    }
+    return a;
+}
+function jsonSafe(v) {
+    if (v === null || v === undefined)
+        return v;
+    if (typeof v === "bigint")
+        return v.toString();
+    if (Array.isArray(v))
+        return v.map(jsonSafe);
+    if (typeof v === "object") {
+        const out = {};
+        for (const [k, val] of Object.entries(v))
+            out[k] = jsonSafe(val);
+        return out;
+    }
+    return v;
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/vote.d.ts

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

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

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

package/dist/tools/vote.js

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import { Interface, isAddress } from "ethers";
+import { RpcProvider } from "../rpc.js";
+import { multicall } from "../lib/multicall.js";
+import { voteTypeFromString, VOTE_TYPE_NAMES } from "../lib/govEnums.js";
+const GOV_POOL_HELPERS_ABI = [
+    "function getHelperContracts() view returns (address settings, address userKeeper, address validators, address poolRegistry, address votePower)",
+    "function getUserVotes(uint256 proposalId, address voter, uint8 voteType) view returns (tuple(bool isVoteFor, uint256 totalVoted, uint256 tokensVoted, uint256 totalRawVoted, uint256[] nftsVoted))",
+    "function getTotalVotes(uint256 proposalId, address voter, uint8 voteType) view returns (uint256 totalVoted, uint256 totalRawVoted, uint256 votesForNow, bool isVoteFor)",
+];
+const USER_KEEPER_ABI = [
+    "function tokenBalance(address voter, uint8 voteType) view returns (uint256 balance, uint256 ownedBalance)",
+    "function nftBalance(address voter, uint8 voteType) view returns (uint256 balance, uint256 ownedBalance)",
+];
+export function registerVoteTools(server, ctx) {
+    const rpc = new RpcProvider(ctx.config);
+    registerUserPower(server, rpc);
+    registerGetVotes(server, rpc);
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function registerUserPower(server, rpc) {
+    server.registerTool("dexe_vote_user_power", {
+        title: "User staking + delegation power across VoteTypes",
+        description: "Reads `tokenBalance` and `nftBalance` on GovUserKeeper for every VoteType (Personal/Micropool/Delegated/Treasury). One multicall round-trip.",
+        inputSchema: {
+            govPool: z.string().describe("GovPool contract address"),
+            user: z.string().describe("User wallet address"),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            user: z.string(),
+            userKeeper: z.string(),
+            power: z.record(z.object({
+                tokenBalance: z.string(),
+                tokenOwned: z.string(),
+                nftBalance: z.string(),
+                nftOwned: z.string(),
+            })),
+        },
+    }, async ({ govPool, user }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid GovPool: ${govPool}`);
+        if (!isAddress(user))
+            return errorResult(`Invalid user: ${user}`);
+        try {
+            const provider = rpc.requireProvider();
+            const gp = new Interface(GOV_POOL_HELPERS_ABI);
+            const uk = new Interface(USER_KEEPER_ABI);
+            const [helpersR] = await multicall(provider, [
+                { target: govPool, iface: gp, method: "getHelperContracts", args: [] },
+            ]);
+            if (!helpersR?.success)
+                return errorResult("getHelperContracts reverted");
+            const userKeeper = helpersR.value.userKeeper;
+            const calls = [];
+            for (let vt = 0; vt < VOTE_TYPE_NAMES.length; vt++) {
+                calls.push({
+                    target: userKeeper,
+                    iface: uk,
+                    method: "tokenBalance",
+                    args: [user, vt],
+                    allowFailure: true,
+                });
+                calls.push({
+                    target: userKeeper,
+                    iface: uk,
+                    method: "nftBalance",
+                    args: [user, vt],
+                    allowFailure: true,
+                });
+            }
+            const results = await multicall(provider, calls);
+            const power = {};
+            for (let vt = 0; vt < VOTE_TYPE_NAMES.length; vt++) {
+                const tb = results[vt * 2];
+                const nb = results[vt * 2 + 1];
+                const tbv = tb?.success
+                    ? tb.value
+                    : null;
+                const nbv = nb?.success
+                    ? nb.value
+                    : null;
+                const pick = (v) => {
+                    if (!v)
+                        return ["0", "0"];
+                    if (Array.isArray(v))
+                        return [v[0].toString(), v[1].toString()];
+                    return [v.balance.toString(), v.ownedBalance.toString()];
+                };
+                const [tBal, tOwn] = pick(tbv);
+                const [nBal, nOwn] = pick(nbv);
+                power[VOTE_TYPE_NAMES[vt]] = {
+                    tokenBalance: tBal,
+                    tokenOwned: tOwn,
+                    nftBalance: nBal,
+                    nftOwned: nOwn,
+                };
+            }
+            const structured = { govPool, user, userKeeper, power };
+            const lines = VOTE_TYPE_NAMES.map((name) => {
+                const p = power[name];
+                return `  ${name.padEnd(14)} token=${p.tokenBalance} (owned=${p.tokenOwned})  nft=${p.nftBalance} (owned=${p.nftOwned})`;
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Voting power for ${user} on ${govPool}\nUserKeeper: ${userKeeper}\n${lines.join("\n")}`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`vote_user_power failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function registerGetVotes(server, rpc) {
+    server.registerTool("dexe_vote_get_votes", {
+        title: "User's votes on a specific proposal",
+        description: "Reads `GovPool.getUserVotes(proposalId, voter, voteType)` and returns the VoteInfoView. Defaults to PersonalVote.",
+        inputSchema: {
+            govPool: z.string(),
+            proposalId: z.union([z.string(), z.number()]),
+            voter: z.string(),
+            voteType: z
+                .enum(["PersonalVote", "MicropoolVote", "DelegatedVote", "TreasuryVote"])
+                .default("PersonalVote"),
+        },
+        outputSchema: {
+            govPool: z.string(),
+            proposalId: z.string(),
+            voter: z.string(),
+            voteType: z.string(),
+            isVoteFor: z.boolean(),
+            totalVoted: z.string(),
+            tokensVoted: z.string(),
+            totalRawVoted: z.string(),
+            nftsVoted: z.array(z.string()),
+        },
+    }, async ({ govPool, proposalId, voter, voteType = "PersonalVote" }) => {
+        if (!isAddress(govPool))
+            return errorResult(`Invalid govPool: ${govPool}`);
+        if (!isAddress(voter))
+            return errorResult(`Invalid voter: ${voter}`);
+        try {
+            const provider = rpc.requireProvider();
+            const iface = new Interface(GOV_POOL_HELPERS_ABI);
+            const id = BigInt(proposalId);
+            const vtNum = voteTypeFromString(voteType);
+            const [res] = await multicall(provider, [
+                {
+                    target: govPool,
+                    iface,
+                    method: "getUserVotes",
+                    args: [id, voter, vtNum],
+                },
+            ]);
+            if (!res?.success)
+                return errorResult("getUserVotes reverted");
+            const v = res.value;
+            const structured = {
+                govPool,
+                proposalId: id.toString(),
+                voter,
+                voteType,
+                isVoteFor: v.isVoteFor,
+                totalVoted: v.totalVoted.toString(),
+                tokensVoted: v.tokensVoted.toString(),
+                totalRawVoted: v.totalRawVoted.toString(),
+                nftsVoted: v.nftsVoted.map((n) => n.toString()),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Vote by ${voter} on proposal ${id} (${voteType}):\n` +
+                            `  isVoteFor     : ${v.isVoteFor}\n` +
+                            `  totalVoted    : ${v.totalVoted}\n` +
+                            `  tokensVoted   : ${v.tokensVoted}\n` +
+                            `  totalRawVoted : ${v.totalRawVoted}\n` +
+                            `  nftsVoted     : [${structured.nftsVoted.join(", ")}]`,
+                    },
+                ],
+                structuredContent: structured,
+            };
+        }
+        catch (err) {
+            return errorResult(`vote_get_votes failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=vote.js.map

package/dist/tools/vote.js.map

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

package/dist/tools/voteBuild.d.ts

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

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

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