dexe-mcp 0.11.0 → 0.14.0

package/dist/tools/gate.js

@@ -0,0 +1,295 @@
+/**
+ * Toolset gating (Phase 2 / v0.13.0). Registering all 156 tools unconditionally
+ * costs ~50K tokens (~206 KB) of `tools/list` per session. `DEXE_TOOLSETS`
+ * selects named profiles so a default session loads a slim subset.
+ *
+ * `TOOLSETS` maps a profile name → the exact tool names it enables. Sets may
+ * overlap; the active allowlist is their union. `full` is special — it bypasses
+ * filtering entirely (registers everything). The union of all named sets equals
+ * the full 156-tool surface (asserted in tests/tools/gate.test.ts), so every
+ * tool is reachable under at least one non-`full` profile.
+ *
+ * Applied as a one-line wrap in `registerAll()` — the wrapped server proxies
+ * `registerTool`/`tool`, dropping any name not in the active allowlist. The 30+
+ * register files are unchanged.
+ */
+// ── core: the everyday flow surface (~one session's worth) ──────────────────
+const CORE = [
+    "dexe_context",
+    "dexe_doctor",
+    "dexe_get_config",
+    // composite signing flows
+    "dexe_proposal_create",
+    "dexe_proposal_vote_and_execute",
+    "dexe_dao_create",
+    // OTC composites
+    "dexe_otc_dao_open_sale",
+    "dexe_otc_buyer_status",
+    "dexe_otc_buyer_buy",
+    "dexe_otc_buyer_claim_all",
+    "dexe_otc_list_sales_for_dao",
+    // broadcast + walletconnect
+    "dexe_tx_send",
+    "dexe_tx_status",
+    "dexe_wc_status",
+    "dexe_wc_connect",
+    "dexe_wc_disconnect",
+    // key vote builders (deposit/withdraw/vote/execute/approve) + power read
+    "dexe_vote_build_deposit",
+    "dexe_vote_build_withdraw",
+    "dexe_vote_build_vote",
+    "dexe_vote_build_execute",
+    "dexe_vote_build_erc20_approve",
+    "dexe_vote_user_power",
+    // IPFS upload essentials + avatar
+    "dexe_ipfs_upload_file",
+    "dexe_ipfs_upload_avatar",
+    "dexe_ipfs_upload_proposal_metadata",
+    "dexe_dao_generate_avatar",
+    // common reads
+    "dexe_read_treasury",
+    "dexe_read_settings",
+    "dexe_proposal_state",
+    "dexe_proposal_list",
+    "dexe_proposal_catalog",
+    "dexe_dao_info",
+    "dexe_dao_registry_lookup",
+    "dexe_dao_predict_addresses",
+];
+// ── proposals: every builder + the offchain/auth surface + proposal IPFS ────
+const PROPOSALS = [
+    // proposalBuild.ts
+    "dexe_proposal_catalog",
+    "dexe_proposal_build_external",
+    "dexe_proposal_build_internal",
+    "dexe_proposal_build_custom_abi",
+    "dexe_proposal_build_offchain",
+    "dexe_proposal_build_token_transfer",
+    // proposalBuildComplex.ts
+    "dexe_proposal_build_token_distribution",
+    "dexe_proposal_build_token_sale_multi",
+    "dexe_proposal_build_token_sale",
+    "dexe_proposal_build_token_sale_whitelist",
+    "dexe_proposal_build_token_sale_recover",
+    "dexe_proposal_build_create_staking_tier",
+    "dexe_proposal_build_change_math_model",
+    "dexe_proposal_build_modify_dao_profile",
+    "dexe_proposal_build_blacklist",
+    "dexe_proposal_build_reward_multiplier",
+    "dexe_proposal_build_apply_to_dao",
+    "dexe_proposal_build_new_proposal_type",
+    // proposalBuildInternal.ts
+    "dexe_proposal_build_change_validator_balances",
+    "dexe_proposal_build_change_validator_settings",
+    "dexe_proposal_build_monthly_withdraw",
+    "dexe_proposal_build_offchain_internal_proposal",
+    // proposalBuildMore.ts
+    "dexe_proposal_build_change_voting_settings",
+    "dexe_proposal_build_manage_validators",
+    "dexe_proposal_build_add_expert",
+    "dexe_proposal_build_remove_expert",
+    "dexe_proposal_build_withdraw_treasury",
+    "dexe_proposal_build_delegate_to_expert",
+    "dexe_proposal_build_revoke_from_expert",
+    // proposalBuildOffchain.ts (+ backend auth)
+    "dexe_auth_request_nonce",
+    "dexe_auth_login_request",
+    "dexe_proposal_build_offchain_single_option",
+    "dexe_proposal_build_offchain_multi_option",
+    "dexe_proposal_build_offchain_for_against",
+    "dexe_proposal_build_offchain_settings",
+    "dexe_offchain_build_vote",
+    "dexe_offchain_build_cancel_vote",
+    // IPFS writes proposals need
+    "dexe_ipfs_upload_proposal_metadata",
+    "dexe_ipfs_upload_dao_metadata",
+    "dexe_ipfs_upload_file",
+    "dexe_ipfs_update_dao_metadata",
+];
+// ── read: chain + subgraph reads, inbox/forecast/risk, IPFS reads ───────────
+const READ = [
+    // read.ts
+    "dexe_read_multicall",
+    "dexe_read_treasury",
+    "dexe_read_validators",
+    "dexe_read_settings",
+    "dexe_read_expert_status",
+    "dexe_read_token_sale_tiers",
+    "dexe_read_token_sale_user",
+    "dexe_read_distribution_status",
+    "dexe_read_staking_info",
+    "dexe_read_privacy_policy_status",
+    // subgraph.ts
+    "dexe_read_dao_list",
+    "dexe_read_dao_members",
+    "dexe_read_delegation_map",
+    "dexe_read_validator_list",
+    "dexe_read_user_activity",
+    "dexe_read_dao_experts",
+    "dexe_otc_list_sales_for_dao",
+    // proposal.ts
+    "dexe_proposal_state",
+    "dexe_proposal_list",
+    "dexe_proposal_voters",
+    // inbox / predict / risk
+    "dexe_user_inbox",
+    "dexe_proposal_forecast",
+    "dexe_proposal_risk_assess",
+    // dao.ts
+    "dexe_dao_info",
+    "dexe_dao_registry_lookup",
+    "dexe_dao_predict_addresses",
+    // IPFS reads
+    "dexe_ipfs_fetch",
+    "dexe_ipfs_cid_info",
+    "dexe_ipfs_cid_for_json",
+];
+// ── vote: every direct vote/stake/delegate/execute/claim builder ────────────
+const VOTE = [
+    "dexe_vote_build_erc20_approve",
+    "dexe_vote_build_deposit",
+    "dexe_vote_build_withdraw",
+    "dexe_vote_build_delegate",
+    "dexe_vote_build_undelegate",
+    "dexe_vote_build_vote",
+    "dexe_vote_build_cancel_vote",
+    "dexe_vote_build_validator_vote",
+    "dexe_vote_build_validator_cancel_vote",
+    "dexe_vote_build_move_to_validators",
+    "dexe_vote_build_execute",
+    "dexe_vote_build_claim_rewards",
+    "dexe_vote_build_claim_micropool_rewards",
+    "dexe_vote_build_nft_multiplier_lock",
+    "dexe_vote_build_nft_multiplier_unlock",
+    "dexe_vote_build_token_sale_buy",
+    "dexe_vote_build_token_sale_claim",
+    "dexe_vote_build_token_sale_vesting_withdraw",
+    "dexe_vote_build_distribution_claim",
+    "dexe_vote_build_staking_stake",
+    "dexe_vote_build_staking_claim",
+    "dexe_vote_build_staking_claim_all",
+    "dexe_vote_build_staking_reclaim",
+    "dexe_vote_build_privacy_policy_sign",
+    "dexe_vote_build_privacy_policy_agree",
+    "dexe_vote_build_multicall",
+    "dexe_vote_user_power",
+    "dexe_vote_get_votes",
+];
+// ── governor: external OpenZeppelin/Bravo Governor surface ───────────────────
+const GOVERNOR = [
+    "dexe_gov_build_propose",
+    "dexe_gov_build_vote_cast",
+    "dexe_gov_build_queue",
+    "dexe_gov_build_execute",
+    "dexe_gov_build_delegate",
+    "dexe_gov_get_state",
+    "dexe_gov_has_voted",
+    "dexe_gov_build_cancel",
+    "dexe_gov_decode_calldata",
+    "dexe_gov_hash_description",
+    "dexe_gov_hash_proposal",
+    "dexe_gov_list_governors",
+    "dexe_gov_get_proposal",
+    "dexe_gov_get_voting_power",
+    "dexe_gov_get_quorum",
+    "dexe_gov_get_proposal_threshold",
+    "dexe_gov_simulate_proposal",
+    "dexe_gov_simulate_vote_impact",
+];
+// ── dev: Solidity dev tooling, introspection, decode, sim, merkle, safe, deploy
+const DEV = [
+    // build.ts
+    "dexe_compile",
+    "dexe_test",
+    "dexe_coverage",
+    "dexe_lint",
+    // introspect.ts
+    "dexe_list_contracts",
+    "dexe_get_abi",
+    "dexe_get_methods",
+    "dexe_get_selectors",
+    "dexe_find_selector",
+    "dexe_get_natspec",
+    "dexe_get_source",
+    // gov.ts (decode + gov-state read + introspection)
+    "dexe_decode_calldata",
+    "dexe_decode_proposal",
+    "dexe_read_gov_state",
+    "dexe_list_gov_contract_types",
+    // simulate.ts
+    "dexe_sim_calldata",
+    "dexe_sim_proposal",
+    "dexe_sim_buy",
+    // merkle.ts
+    "dexe_merkle_build",
+    "dexe_merkle_proof",
+    // safe.ts
+    "dexe_safe_info",
+    "dexe_safe_propose_tx",
+    // low-level deploy (dexe_dao_create is the recommended composite in `core`)
+    "dexe_dao_build_deploy",
+];
+export const TOOLSETS = {
+    core: new Set(CORE),
+    proposals: new Set(PROPOSALS),
+    read: new Set(READ),
+    vote: new Set(VOTE),
+    governor: new Set(GOVERNOR),
+    dev: new Set(DEV),
+};
+/** Default profiles when `DEXE_TOOLSETS` is unset (breaking change in v0.13.0). */
+export const DEFAULT_TOOLSETS = ["core", "proposals"];
+/**
+ * Resolve the requested profiles into a concrete allowlist. An explicit `full`
+ * OR any unknown set name → `full` (register everything) so a typo never
+ * silently strips the toolset. Pure — no side effects.
+ */
+export function resolveToolsets(requested) {
+    const req = requested.length > 0 ? [...requested] : [...DEFAULT_TOOLSETS];
+    const unknown = req.filter((s) => s !== "full" && !(s in TOOLSETS));
+    if (req.includes("full") || unknown.length > 0) {
+        return { names: null, unknown, full: true, requested: req };
+    }
+    const names = new Set();
+    for (const s of req)
+        for (const n of TOOLSETS[s])
+            names.add(n);
+    return { names, unknown, full: false, requested: req };
+}
+/**
+ * Wrap `server` so tool registrations for names outside the active allowlist
+ * are dropped. Returns the original server unchanged when the active profile is
+ * `full`. Emits a one-line stderr banner. Call once in `registerAll`.
+ */
+export function applyToolGate(server, config) {
+    const resolved = resolveToolsets(config.toolsets ?? [...DEFAULT_TOOLSETS]);
+    if (resolved.unknown.length > 0) {
+        process.stderr.write(`[dexe-mcp] unknown DEXE_TOOLSETS: [${resolved.unknown.join(", ")}] — loading all tools (full). ` +
+            `Valid sets: ${Object.keys(TOOLSETS).join(", ")}, full.\n`);
+    }
+    if (resolved.full) {
+        process.stderr.write(`[dexe-mcp] toolsets: full — all tools loaded.\n`);
+        return server;
+    }
+    const allow = resolved.names;
+    process.stderr.write(`[dexe-mcp] toolsets: [${resolved.requested.join(", ")}] → ${allow.size} tools loaded ` +
+        `(set DEXE_TOOLSETS=full to load all, or add sets: ${Object.keys(TOOLSETS).join(", ")}).\n`);
+    const wrap = (fn) => (name, ...rest) => {
+        if (typeof name === "string" && !allow.has(name))
+            return undefined;
+        return fn(name, ...rest);
+    };
+    return new Proxy(server, {
+        get(target, prop, receiver) {
+            if (prop === "registerTool" || prop === "tool") {
+                const original = Reflect.get(target, prop, receiver);
+                if (typeof original !== "function")
+                    return original;
+                return wrap(original.bind(target));
+            }
+            const v = Reflect.get(target, prop, receiver);
+            return typeof v === "function" ? v.bind(target) : v;
+        },
+    });
+}
+//# sourceMappingURL=gate.js.map

package/dist/tools/gate.js.map

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

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

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

package/dist/tools/index.js

@@ -22,6 +22,9 @@ import { registerGetConfigTool } from "./getConfig.js";
 import { registerDoctorTool } from "./doctor.js";
 import { registerWalletConnectTools } from "./walletconnectStatus.js";
 import { registerFlowTools } from "./flow.js";
+import { registerDaoCreateTools } from "./daoCreate.js";
+import { registerOperationalContextTools } from "./operationalContext.js";
+import { StateStore } from "../lib/stateStore.js";
 import { registerMerkleTools } from "./merkle.js";
 import { registerOtcTools } from "./otc.js";
 import { registerSafeTools } from "./safe.js";
@@ -32,12 +35,18 @@ import { registerRiskTools } from "./risk.js";
 import { SignerManager } from "../lib/signer.js";
 import { WalletConnectManager } from "../lib/walletconnect.js";
 import { registerGovernorTools } from "../governor/index.js";
+import { applyToolGate } from "./gate.js";
 /**
  * Wire every dexe-mcp tool onto the given server instance. Builds the shared
  * ToolContext (artifacts cache, hardhat runner, selector index) once so all
  * tools share state.
  */
 export function registerAll(server, config) {
+    // Phase 2: gate tool registration by the active DEXE_TOOLSETS profile. The
+    // wrapped server drops any tool name not in the active allowlist; `full`
+    // returns the server unchanged. Every register* call below sees the gate, so
+    // no register file changes. Reassigning the param keeps it a one-line wrap.
+    server = applyToolGate(server, config);
     const artifacts = new Artifacts(config);
     const runner = new HardhatRunner(config);
     const selectors = new SelectorIndex(artifacts);
@@ -64,12 +73,16 @@ export function registerAll(server, config) {
     registerRiskTools(server, ctx);
     const signer = new SignerManager(config);
     const wc = new WalletConnectManager(config);
+    // Phase 3 — persistent operational state (known DAOs / recent proposals).
+    const state = new StateStore(config.statePath);
     registerTxTools(server, config, signer, wc);
     registerGetConfigTool(server, config, signer);
     // Diagnostics — call dexe_doctor first when env-related failures show up.
     registerDoctorTool(server, config);
     registerWalletConnectTools(server, config, signer, wc);
-    registerFlowTools(server, ctx, signer);
+    registerFlowTools(server, ctx, signer, state);
+    registerDaoCreateTools(server, ctx, signer, state);
+    registerOperationalContextTools(server, config, signer, state);
     registerOtcTools(server, ctx, signer);
     registerSafeTools(server, ctx, signer);
     registerSimulateTools(server, ctx, signer);

package/dist/tools/index.js.map

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

package/dist/tools/operationalContext.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DexeConfig } from "../config.js";
+import type { SignerManager } from "../lib/signer.js";
+import type { StateStore } from "../lib/stateStore.js";
+export declare function registerOperationalContextTools(server: McpServer, config: DexeConfig, signer: SignerManager, state: StateStore): void;
+//# sourceMappingURL=operationalContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operationalContext.d.ts","sourceRoot":"","sources":["../../src/tools/operationalContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAC;AAsEjE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,GAChB,IAAI,CAqEN"}

package/dist/tools/operationalContext.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { Contract } from "ethers";
+import { RpcProvider } from "../rpc.js";
+import { maskUrl } from "../lib/redact.js";
+/**
+ * `dexe_context` (Phase 3 / v0.14.0) — the "who/where am I" call. One read that
+ * orients an agent at session start: signer + mode, active/configured chains,
+ * env readiness, and the persisted operational state (DAOs deployed and
+ * proposals broadcast in prior sessions) so work doesn't start from zero.
+ *
+ * `context.ts` is taken by the ToolContext type, hence `operationalContext.ts`.
+ */
+const CHAIN_NAMES = {
+    1: "Ethereum mainnet",
+    56: "BSC mainnet",
+    97: "BSC testnet",
+    137: "Polygon mainnet",
+    8453: "Base mainnet",
+    42161: "Arbitrum One",
+};
+const GOV_HELPERS_ABI = [
+    "function getHelperContracts() view returns (address settings, address userKeeper, address validators, address poolRegistry, address votePower)",
+];
+const USER_KEEPER_ABI = [
+    "function tokenBalance(address voter, uint8 voteType) view returns (uint256 balance, uint256 ownedBalance)",
+];
+function signerMode(config, signer) {
+    const safeServiceUrl = process.env.DEXE_SAFE_TX_SERVICE_URL?.trim() || undefined;
+    return signer.hasSigner()
+        ? safeServiceUrl
+            ? "safe"
+            : "eoa"
+        : config.walletConnectProjectId
+            ? "walletconnect"
+            : "readonly";
+}
+/**
+ * Best-effort deposited voting power for a DAO: getHelperContracts → userKeeper
+ * → tokenBalance(user,0).balance − ownedBalance. Returns null on any failure
+ * (no RPC, unregistered pool, revert) — this is a convenience readout, never a
+ * hard dependency.
+ */
+async function depositedPowerFor(rpc, dao, user) {
+    try {
+        const pr = rpc.tryProvider(dao.chainId);
+        if ("error" in pr)
+            return null;
+        const provider = pr.ok;
+        const keeper = dao.userKeeper ??
+            (await new Contract(dao.govPool, GOV_HELPERS_ABI, provider)
+                .getFunction("getHelperContracts")
+                .staticCall())[1];
+        if (!keeper)
+            return null;
+        const [balance, owned] = (await new Contract(keeper, USER_KEEPER_ABI, provider)
+            .getFunction("tokenBalance")
+            .staticCall(user, 0));
+        return (balance - owned).toString();
+    }
+    catch {
+        return null;
+    }
+}
+export function registerOperationalContextTools(server, config, signer, state) {
+    const rpc = new RpcProvider(config);
+    server.tool("dexe_context", "Operational context for the current session — CALL THIS FIRST. Returns the signer address + mode, " +
+        "the active/configured chains, env-readiness (RPC/IPFS/subgraph/signer), and the persisted state: DAOs you " +
+        "deployed and proposals you broadcast in prior sessions (via dexe_dao_create / dexe_proposal_create), plus your " +
+        "deposited voting power in the most recent DAO. Read-only; never writes.", {
+        includeDepositedPower: z
+            .boolean()
+            .default(true)
+            .describe("Read deposited voting power for the most recent DAO (one extra RPC call). Set false to skip."),
+    }, async ({ includeDepositedPower = true }) => {
+        const st = state.getState();
+        const chains = [...config.chains.values()]
+            .sort((a, b) => a.chainId - b.chainId)
+            .map((c) => ({
+            chainId: c.chainId,
+            name: CHAIN_NAMES[c.chainId] ?? `chain ${c.chainId}`,
+            rpcUrl: maskUrl(c.rpcUrl),
+            isDefault: c.chainId === config.defaultChainId,
+        }));
+        const mode = signerMode(config, signer);
+        const address = signer.hasSigner() ? signer.getAddress() : null;
+        // Deposited power for the last DAO (best-effort, opt-out).
+        let lastDaoPower = null;
+        const last = st.knownDaos[0];
+        if (includeDepositedPower && last && address) {
+            lastDaoPower = {
+                govPool: last.govPool,
+                chainId: last.chainId,
+                depositedPower: await depositedPowerFor(rpc, last, address),
+            };
+        }
+        const result = {
+            signer: { mode, address },
+            chain: {
+                defaultChainId: config.defaultChainId,
+                defaultChainName: CHAIN_NAMES[config.defaultChainId] ?? `chain ${config.defaultChainId}`,
+                configured: chains,
+                lastUsedChainId: st.lastChainId ?? null,
+            },
+            env: {
+                rpcConfigured: config.chains.size > 0,
+                ipfsUploads: !!config.pinataJwt,
+                subgraphReads: !!config.subgraphPoolsUrl,
+                backendOffchain: !!process.env.DEXE_BACKEND_API_URL?.trim(),
+                toolsets: config.toolsets,
+            },
+            knownDaos: st.knownDaos,
+            recentProposals: st.recentProposals,
+            walletLabels: st.walletLabels,
+            lastDaoPower,
+            hint: st.knownDaos.length === 0
+                ? "No DAOs recorded yet. Deploy one with dexe_dao_create (testnet chain 97) or pass a govPool explicitly."
+                : `Most recent DAO: ${st.knownDaos[0].name} (${st.knownDaos[0].govPool}) on chain ${st.knownDaos[0].chainId}.`,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=operationalContext.js.map

package/dist/tools/operationalContext.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"otc.d.ts","sourceRoot":"","sources":["../../src/tools/otc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA6BpD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,QAKvB,CAAC;AAEN,eAAO,MAAM,uBAAuB,8xBAAuG,CAAC;AAoC5I;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,+CAA+C,CAAC;AAE7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,SAAS,CAQX;AA8DD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI,CAypBN"}
+{"version":3,"file":"otc.d.ts","sourceRoot":"","sources":["../../src/tools/otc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA8BpD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,QAKvB,CAAC;AAEN,eAAO,MAAM,uBAAuB,8xBAAuG,CAAC;AAoC5I;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,+CAA+C,CAAC;AAE7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,SAAS,CAQX;AA8DD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI,CA2pBN"}

package/dist/tools/otc.js

@@ -9,6 +9,7 @@ import { PinataClient } from "../lib/ipfs.js";
 import { buildAddressMerkleTree, computeLeafHash, verifyProof, } from "../lib/merkleTree.js";
 import { simulateCalldata } from "./simulate.js";
 import { parseUintString } from "../lib/amount.js";
+import { unixToUtc } from "../lib/time.js";
 function errorResult(message) {
     return { content: [{ type: "text", text: message }], isError: true };
 }
@@ -386,6 +387,8 @@ export function registerOtcTools(server, ctx, signer) {
                     saleTokenAddress: tier.saleTokenAddress,
                     saleStartTime: tier.saleStartTime,
                     saleEndTime: tier.saleEndTime,
+                    saleStartTimeUTC: unixToUtc(tier.saleStartTime),
+                    saleEndTimeUTC: unixToUtc(tier.saleEndTime),
                     totalTokenProvided: tier.totalTokenProvided,
                     totalSold: tv.tierInfo.totalSold,
                     isOff: tv.tierInfo.isOff,