@finchagentic/mcp 4.6.1 → 4.6.2

package/dist/tools/stake.js

@@ -1,369 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STAKE_TOOLS = void 0;
-exports.parseStakeAmount = parseStakeAmount;
-exports.handleStakeTool = handleStakeTool;
-const ethers_1 = require("ethers");
-const convex_js_1 = require("../convex.js");
-const config_js_1 = require("../config.js");
-const rh_mcp_js_1 = require("./rh-mcp.js");
-// FINCH staking - MCP wrapper around the EXISTING app/convex staking actions
-// (stake.ts's stakeFINCH/unstakeFINCH, stakeInternal.ts's myStakingStats/
-// globalStats). No staking logic lives here - this only parses a
-// human-friendly amount ("all", "max", "50%", "1m", "100k", a raw number)
-// into wei and calls the backend, exactly like the webapp's Stake page does.
-//
-// IMPORTANT - custodial wallet, not the local signing wallet: unlike
-// base_mcp_swap/rh_mcp_swap (which sign and broadcast with the LOCAL
-// ~/.finch/wallet.json key and need no login), staking moves FINCH from the
-// account's CUSTODIAL wallet (the one shown on the webapp's Wallet page) -
-// stake.ts's actions resolve identity via a real logged-in session, not a
-// wallet signature. Requires `finch login` first; there is no way around
-// this without changing stake.ts's own session-based design, which is out
-// of scope here. The local wallet and the custodial wallet are DIFFERENT
-// addresses with different balances - never conflate them in output.
-//
-// SECURITY: no tool here ever returns a private key or seed phrase, and
-// none ever will - the custodial key stays server-side (Turnkey-enclave /
-// encrypted-at-rest), exactly as it already does for the webapp. "Log in,
-// then stake" is the ceiling of what this integration does; it does not,
-// and must not, add an export path.
-const FINCH_CA = "0xce1981b0431fb495912cab057d2877a290199824";
-const FINCH_DECIMALS = 18;
-const ERC20_BALANCE_ABI = ["function balanceOf(address) view returns (uint256)"];
-// Mirrors app/convex/stake.ts's STAKING_TIERS - fixed constants, not worth a
-// round-trip to the backend to fetch. Keep in sync if the backend tiers change.
-const STAKING_TIERS = {
-    7: { multiplier: 1.0, label: "Flexible" },
-    30: { multiplier: 1.5, label: "Committed" },
-    90: { multiplier: 2.0, label: "Diamond Hands" },
-};
-const VALID_LOCK_TIERS = Object.keys(STAKING_TIERS).map(Number);
-function requireLogin() {
-    const token = (0, config_js_1.getSavedToken)();
-    return token ? { token } : null;
-}
-const NOT_LOGGED_IN_MSG = "Staking needs a logged-in session (not just the local wallet). Run `finch login` first, then retry.";
-async function finchBalanceOf(address) {
-    const provider = await (0, rh_mcp_js_1.rhProviderAsync)();
-    const finch = new ethers_1.ethers.Contract(FINCH_CA, ERC20_BALANCE_ABI, provider);
-    return await finch.balanceOf(address);
-}
-// Parses "all" | "max" | "50%" | "1m" | "100k" | "100000" | "value 100000"
-// against a live balance. Returns wei as a string, or throws with a message
-// the caller can show verbatim.
-function parseStakeAmount(input, balanceWei) {
-    const raw = input.trim().toLowerCase().replace(/^value\s+/, "");
-    if (raw === "all" || raw === "max") {
-        if (balanceWei <= 0n)
-            throw new Error("Wallet has 0 FINCH - nothing to stake.");
-        return balanceWei;
-    }
-    const pctMatch = raw.match(/^(\d+(?:\.\d+)?)\s*%$/);
-    if (pctMatch) {
-        const pct = parseFloat(pctMatch[1]);
-        if (!(pct > 0) || pct > 100)
-            throw new Error("Percentage must be between 0 and 100.");
-        return (balanceWei * BigInt(Math.round(pct * 100))) / 10000n;
-    }
-    const suffixMatch = raw.match(/^(\d+(?:\.\d+)?)\s*([km])$/);
-    if (suffixMatch) {
-        const n = parseFloat(suffixMatch[1]);
-        const mult = suffixMatch[2] === "m" ? 1000000 : 1000;
-        return ethers_1.ethers.parseUnits((n * mult).toString(), FINCH_DECIMALS);
-    }
-    const plainMatch = raw.match(/^(\d+(?:\.\d+)?)$/);
-    if (plainMatch) {
-        return ethers_1.ethers.parseUnits(plainMatch[1], FINCH_DECIMALS);
-    }
-    throw new Error(`Could not parse amount "${input}". Use "all", "max", a percentage like "50%", ` +
-        `a shorthand like "1m" or "100k", or a plain number like "100000".`);
-}
-function fmtFinch(wei) {
-    return `${Number(ethers_1.ethers.formatUnits(wei, FINCH_DECIMALS)).toLocaleString("en-US", { maximumFractionDigits: 4 })} FINCH`;
-}
-exports.STAKE_TOOLS = [
-    {
-        name: "stake_finch_status",
-        description: "View your FINCH staking status - custodial wallet balance available to stake, your active stakes " +
-            "(amount, lock-up remaining, accrued rewards), and pool-wide stats (total staked, daily USDG reward). " +
-            "Requires `finch login` (stakes live on your account's custodial wallet, not the local MCP signing wallet).",
-        inputSchema: { type: "object", properties: {}, required: [] },
-    },
-    {
-        name: "stake_finch",
-        description: "Stake FINCH from your custodial wallet (the one shown on the webapp's Wallet page) to earn USDG " +
-            "rewards. Locks for a fixed period chosen at stake time - unstake is blocked until then, and the " +
-            "tier cannot be changed mid-stake. Longer locks earn a higher reward multiplier: " +
-            "7 days = 1.0x (default) · 30 days = 1.5x · 90 days = 2.0x. " +
-            "Requires `finch login` first and `confirm: true`. Amount accepts \"all\"/\"max\" (entire " +
-            "available balance), a percentage (\"50%\"), a shorthand (\"1m\", \"100k\"), or a plain number " +
-            "(\"100000\").",
-        inputSchema: {
-            type: "object",
-            properties: {
-                amount: {
-                    type: "string",
-                    description: "\"all\" | \"max\" | \"50%\" | \"1m\" | \"100k\" | \"100000\"",
-                },
-                lockTier: {
-                    type: "number",
-                    enum: [7, 30, 90],
-                    description: "Lock period in days: 7 (1.0x, default), 30 (1.5x), or 90 (2.0x). Omit for 7-day/1.0x.",
-                },
-                confirm: {
-                    type: "boolean",
-                    description: "Must be true to stake - this moves real FINCH out of your custodial wallet.",
-                },
-            },
-            required: ["amount", "confirm"],
-        },
-    },
-    {
-        name: "unstake_finch",
-        description: "Unstake FINCH back to your custodial wallet, plus any pending USDG rewards. Only works once the " +
-            "lock-up period has passed (check stake_finch_status for which stakes are unlockable). Requires " +
-            "`finch login` and `confirm: true`. Pass a specific stakeId, or \"all\" to unstake every currently " +
-            "unlockable stake in one call (each processed and reported individually).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                stakeId: { type: "string", description: "A stake ID from stake_finch_status, or \"all\"" },
-                confirm: { type: "boolean", description: "Must be true to unstake." },
-            },
-            required: ["stakeId", "confirm"],
-        },
-    },
-    {
-        name: "claim_vested_rewards",
-        description: "Claim all your fully-vested USDG staking rewards to your custodial wallet. Daily rewards split " +
-            "50% instant / 50% vested over 3 days - this claims whatever portion has finished vesting across " +
-            "ALL your stakes in one call (check stake_finch_status for accrued totals; you'll also get a " +
-            "notification when rewards become claimable). Does nothing to the stake itself - principal stays " +
-            "staked and earning. Requires `finch login` and `confirm: true`.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                confirm: { type: "boolean", description: "Must be true to claim - this moves real USDG into your custodial wallet." },
-            },
-            required: ["confirm"],
-        },
-    },
-    {
-        name: "stake_auto_restake",
-        description: "Turn auto-restake on/off for one of your stakes. When ON, the moment the lock-up ends the stake " +
-            "is automatically renewed for another full period at the SAME tier - no FINCH ever leaves the " +
-            "treasury, no gas, no confirmation needed each cycle (a background job on the Finch backend does " +
-            "this, roughly every 15 minutes). When OFF (default), you instead get a one-time notification that " +
-            "the stake is unlockable and it just sits there earning nothing until you run unstake_finch. " +
-            "Does NOT auto-compound rewards into the stake - that would require signing from your custodial " +
-            "wallet unattended, which this intentionally does not do; claim rewards yourself with " +
-            "claim_vested_rewards (you'll get a notification when they're ready). Requires `finch login`.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                stakeId: { type: "string", description: "A stake ID from stake_finch_status" },
-                enabled: { type: "boolean", description: "true to turn auto-restake on, false to turn it off" },
-            },
-            required: ["stakeId", "enabled"],
-        },
-    },
-];
-async function handleStakeTool(name, args) {
-    if (name === "stake_finch_status") {
-        const login = requireLogin();
-        if (!login)
-            return { content: [{ type: "text", text: NOT_LOGGED_IN_MSG }], isError: true };
-        const data = await (0, convex_js_1.callConvex)("/mcp/stake/status", "GET", undefined, "stake_finch_status");
-        if (data.error)
-            return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
-        const address = data.walletAddress ?? null;
-        let balanceWei = null;
-        if (address) {
-            try {
-                balanceWei = await finchBalanceOf(address);
-            }
-            catch { /* balance is a nice-to-have, don't fail the whole status */ }
-        }
-        const my = data.myStats;
-        const global = data.global;
-        const lines = [
-            `## FINCH Staking Status`,
-            ``,
-            address ? `**Custodial wallet:** \`${address}\` ${balanceWei != null ? `(${fmtFinch(balanceWei)} available to stake)` : ""}` : `_Could not resolve custodial wallet address._`,
-            ``,
-            global ? `**Pool:** ${global.totalStakedHuman.toLocaleString()} FINCH staked by ${global.totalStakers} stakers · ${global.dailyRewardUsdg} USDG/day pool` : "",
-            `**Lock tiers:** ${VALID_LOCK_TIERS.map((t) => `${t}d/${STAKING_TIERS[t].multiplier}x (${STAKING_TIERS[t].label})`).join(" · ")} — pick with \`stake_finch lockTier\`, default 7d/1.0x`,
-            ``,
-            my ? `**Your stakes:** ${my.activeStakes} active · ${my.totalStaked.toLocaleString()} FINCH staked · ${my.totalRewards.toFixed(4)} USDG accrued · ${my.canUnstakeCount} unlockable now` : "",
-        ];
-        if (my?.stakes?.length) {
-            lines.push(``, `**Detail:**`);
-            for (const s of my.stakes) {
-                const unlocked = Date.now() >= s.unlockAt;
-                const tier = STAKING_TIERS[s.lockTier ?? 7] ?? STAKING_TIERS[7];
-                const autoNote = s.status === "staked" ? (s.autoRestake ? " · 🔄 auto-restake ON" : "") : "";
-                lines.push(`- \`${s._id}\` — ${s.amountHuman} FINCH · ${s.lockTier ?? 7}d/${tier.multiplier}x · ${s.status}${s.status === "staked" ? (unlocked ? " · unlockable now" : ` · unlocks ${new Date(s.unlockAt).toISOString().slice(0, 10)}`) : ""}${autoNote}`);
-            }
-        }
-        return { content: [{ type: "text", text: lines.filter(Boolean).join("\n") }] };
-    }
-    if (name === "stake_finch") {
-        const raw = (args ?? {});
-        const { amount, confirm } = raw;
-        // Coerce defensively - MCP clients commonly send numeric args as JSON
-        // strings, and unlike `amount` (a string by design, parsed by
-        // parseStakeAmount) or `confirm` (unambiguous boolean), a stray
-        // "30" here must not silently mismatch the numeric VALID_LOCK_TIERS
-        // check and fall through to the 7-day default with no error.
-        const lockTier = raw.lockTier === undefined || raw.lockTier === null || raw.lockTier === ""
-            ? undefined
-            : Number(raw.lockTier);
-        if (!amount)
-            return { content: [{ type: "text", text: "amount is required" }], isError: true };
-        if (lockTier !== undefined && (!Number.isFinite(lockTier) || !VALID_LOCK_TIERS.includes(lockTier))) {
-            return {
-                content: [{ type: "text", text: `Invalid lockTier ${JSON.stringify(raw.lockTier)} - must be one of ${VALID_LOCK_TIERS.join(", ")} (days).` }],
-                isError: true,
-            };
-        }
-        if (confirm !== true) {
-            return {
-                content: [{ type: "text", text: "Refusing to stake without confirmation - pass `confirm: true` after reviewing the amount." }],
-                isError: true,
-            };
-        }
-        const login = requireLogin();
-        if (!login)
-            return { content: [{ type: "text", text: NOT_LOGGED_IN_MSG }], isError: true };
-        const status = await (0, convex_js_1.callConvex)("/mcp/stake/status", "GET", undefined, "stake_finch_status");
-        if (status.error)
-            return { content: [{ type: "text", text: `Error: ${status.error}` }], isError: true };
-        if (!status.walletAddress)
-            return { content: [{ type: "text", text: "Could not resolve your custodial wallet address." }], isError: true };
-        let balanceWei;
-        try {
-            balanceWei = await finchBalanceOf(status.walletAddress);
-        }
-        catch (e) {
-            return { content: [{ type: "text", text: `Could not read FINCH balance: ${e?.message ?? e}` }], isError: true };
-        }
-        let amountWei;
-        try {
-            amountWei = parseStakeAmount(amount, balanceWei);
-        }
-        catch (e) {
-            return { content: [{ type: "text", text: e.message }], isError: true };
-        }
-        if (amountWei > balanceWei) {
-            return {
-                content: [{ type: "text", text: `Insufficient FINCH. Have ${fmtFinch(balanceWei)}, tried to stake ${fmtFinch(amountWei)}.` }],
-                isError: true,
-            };
-        }
-        const result = await (0, convex_js_1.callConvex)("/mcp/stake/stake", "POST", { amountWei: amountWei.toString(), lockTier }, "stake_finch", 30000, true);
-        if (result.error)
-            return { content: [{ type: "text", text: `Stake failed: ${result.error}` }], isError: true };
-        const tier = STAKING_TIERS[lockTier ?? 7];
-        return {
-            content: [{
-                    type: "text",
-                    text: [
-                        `✅ Staked ${fmtFinch(amountWei)}`,
-                        `Lock: ${lockTier ?? 7} days (${tier.label}, ${tier.multiplier}x rewards)`,
-                        `Stake ID: \`${result.stakeId}\``,
-                        `Tx: \`${result.txHash}\``,
-                        `${rh_mcp_js_1.RH_EXPLORER}/tx/${result.txHash}`,
-                    ].join("\n"),
-                }],
-        };
-    }
-    if (name === "unstake_finch") {
-        const { stakeId, confirm } = (args ?? {});
-        if (!stakeId)
-            return { content: [{ type: "text", text: "stakeId is required (or \"all\")" }], isError: true };
-        if (confirm !== true) {
-            return {
-                content: [{ type: "text", text: "Refusing to unstake without confirmation - pass `confirm: true`." }],
-                isError: true,
-            };
-        }
-        const login = requireLogin();
-        if (!login)
-            return { content: [{ type: "text", text: NOT_LOGGED_IN_MSG }], isError: true };
-        let targetIds;
-        if (stakeId.toLowerCase() === "all") {
-            const status = await (0, convex_js_1.callConvex)("/mcp/stake/status", "GET", undefined, "stake_finch_status");
-            if (status.error)
-                return { content: [{ type: "text", text: `Error: ${status.error}` }], isError: true };
-            const now = Date.now();
-            targetIds = (status.myStats?.stakes ?? [])
-                .filter((s) => s.status === "staked" && now >= s.unlockAt)
-                .map((s) => s._id);
-            if (!targetIds.length) {
-                return { content: [{ type: "text", text: "No stakes are currently unlockable." }] };
-            }
-        }
-        else {
-            targetIds = [stakeId];
-        }
-        const lines = [];
-        for (const id of targetIds) {
-            const result = await (0, convex_js_1.callConvex)("/mcp/stake/unstake", "POST", { stakeId: id }, "unstake_finch", 30000, true);
-            if (result.error) {
-                lines.push(`🔴 \`${id}\`: ${result.error}`);
-            }
-            else {
-                lines.push(`✅ \`${id}\` unstaked — tx \`${result.txHash}\`${result.rewardsTxHash ? ` · rewards tx \`${result.rewardsTxHash}\`` : ""}`);
-            }
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    if (name === "claim_vested_rewards") {
-        const { confirm } = (args ?? {});
-        if (confirm !== true) {
-            return {
-                content: [{ type: "text", text: "Refusing to claim without confirmation - pass `confirm: true`." }],
-                isError: true,
-            };
-        }
-        const login = requireLogin();
-        if (!login)
-            return { content: [{ type: "text", text: NOT_LOGGED_IN_MSG }], isError: true };
-        const result = await (0, convex_js_1.callConvex)("/mcp/stake/claim-rewards", "POST", {}, "claim_vested_rewards", 30000, true);
-        if (result.error)
-            return { content: [{ type: "text", text: `Claim failed: ${result.error}` }], isError: true };
-        return {
-            content: [{
-                    type: "text",
-                    text: [
-                        `✅ Claimed ${(result.claimedAmount ?? 0).toFixed(4)} USDG vested rewards`,
-                        `Tx: \`${result.txHash}\``,
-                        `${rh_mcp_js_1.RH_EXPLORER}/tx/${result.txHash}`,
-                    ].join("\n"),
-                }],
-        };
-    }
-    if (name === "stake_auto_restake") {
-        const { stakeId, enabled } = (args ?? {});
-        if (!stakeId)
-            return { content: [{ type: "text", text: "stakeId is required" }], isError: true };
-        if (typeof enabled !== "boolean")
-            return { content: [{ type: "text", text: "enabled (true/false) is required" }], isError: true };
-        const login = requireLogin();
-        if (!login)
-            return { content: [{ type: "text", text: NOT_LOGGED_IN_MSG }], isError: true };
-        const result = await (0, convex_js_1.callConvex)("/mcp/stake/auto-restake", "POST", { stakeId, enabled }, "stake_auto_restake");
-        if (result.error)
-            return { content: [{ type: "text", text: `Failed: ${result.error}` }], isError: true };
-        return {
-            content: [{
-                    type: "text",
-                    text: enabled
-                        ? `🔄 Auto-restake ON for \`${stakeId}\`. It'll renew itself for another full period at the same tier every time it unlocks - no action needed from you.`
-                        : `⏸️ Auto-restake OFF for \`${stakeId}\`. You'll get a notification when it unlocks instead, and it'll just sit there until you run \`unstake_finch\`.`,
-                }],
-        };
-    }
-    return null;
-}