starkfi 0.1.0

package/dist/mcp/handlers.js

@@ -0,0 +1,325 @@
+import { loadSession, requireSession } from "../services/auth/session.js";
+import { initSDKAndWallet } from "../services/starkzap/client.js";
+import { checkFibrousHealth } from "../services/fibrous/health.js";
+import { getBalances } from "../services/fibrous/balances.js";
+import { resolveToken, resolveTokenPreset } from "../services/fibrous/tokens.js";
+import { getCalldata } from "../services/fibrous/route.js";
+import * as stakingService from "../services/staking/staking.js";
+import { getValidators, findValidator } from "../services/staking/validators.js";
+import { ConfigService } from "../services/config/config.js";
+import { Amount, fromAddress } from "starkzap";
+import { FIBROUS_ROUTER_ADDRESS, GASLESS_SUPPORTED_TOKENS } from "../lib/config.js";
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+function jsonResult(data) {
+    return textResult(JSON.stringify(data, null, 2));
+}
+export async function handleGetAuthStatus() {
+    const session = loadSession();
+    const health = await checkFibrousHealth();
+    if (!session) {
+        return jsonResult({
+            authenticated: false,
+            fibrous: health,
+            message: "Not authenticated. Use 'starkfi auth login' or 'starkfi auth import'.",
+        });
+    }
+    return jsonResult({
+        authenticated: true,
+        type: session.type,
+        network: session.network,
+        address: session.address,
+        fibrous: health,
+    });
+}
+export async function handleGetBalance(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    if (args.token) {
+        const tokenType = await resolveTokenPreset(args.token);
+        if (!tokenType) {
+            return textResult(`Token ${args.token} not found.`);
+        }
+        const balanceAmount = await wallet.balanceOf(tokenType);
+        return jsonResult({
+            symbol: tokenType.symbol,
+            name: tokenType.name,
+            balance: balanceAmount.toUnit(),
+        });
+    }
+    const balances = await getBalances(wallet);
+    return jsonResult({
+        network: session.network,
+        address: session.address,
+        balances,
+    });
+}
+export async function handleDeployAccount() {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    const deployed = await wallet.isDeployed();
+    if (deployed) {
+        return jsonResult({
+            alreadyDeployed: true,
+            address: session.address,
+            network: session.network,
+            message: "Account is already deployed. No action needed.",
+        });
+    }
+    const tx = await wallet.deploy();
+    await tx.wait();
+    return jsonResult({
+        alreadyDeployed: false,
+        success: true,
+        address: session.address,
+        network: session.network,
+        txHash: tx.hash,
+        explorerUrl: tx.explorerUrl,
+        message: "Account deployed successfully. You can now send, swap, and stake.",
+    });
+}
+export async function handleSwapTokens(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    await wallet.ensureReady({ deploy: "if_needed" });
+    const tokenIn = await resolveToken(args.from_token);
+    const tokenOut = await resolveToken(args.to_token);
+    const parsedAmount = Amount.parse(args.amount, tokenIn);
+    const rawAmount = parsedAmount.toBase().toString();
+    const calldataResponse = await getCalldata(tokenIn, tokenOut, rawAmount, args.slippage ?? 0.5, session.address);
+    const tx = await wallet
+        .tx()
+        .approve(tokenIn, fromAddress(FIBROUS_ROUTER_ADDRESS), parsedAmount)
+        .add({
+        contractAddress: FIBROUS_ROUTER_ADDRESS,
+        entrypoint: "swap",
+        calldata: calldataResponse.calldata,
+    })
+        .send();
+    await tx.wait();
+    const outputAmount = Amount.fromRaw(calldataResponse.route.outputAmount, tokenOut);
+    const outputFormatted = outputAmount.toUnit();
+    return jsonResult({
+        success: true,
+        txHash: tx.hash,
+        explorerUrl: tx.explorerUrl,
+        amountIn: `${args.amount} ${tokenIn.symbol}`,
+        amountOut: `~${outputFormatted} ${tokenOut.symbol}`,
+        slippage: `${args.slippage ?? 0.5}%`,
+    });
+}
+export async function handleSendTokens(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    await wallet.ensureReady({ deploy: "if_needed" });
+    const token = await resolveTokenPreset(args.token);
+    if (!token) {
+        return textResult(`Token ${args.token} not found.`);
+    }
+    const amount = Amount.parse(args.amount, token);
+    const balance = await wallet.balanceOf(token);
+    if (balance.lt(amount)) {
+        return jsonResult({
+            success: false,
+            error: `Insufficient balance. You have: ${balance.toFormatted()}, attempting to send: ${amount.toFormatted()}`,
+        });
+    }
+    const tx = await wallet.transfer(token, [{ to: fromAddress(args.recipient), amount }]);
+    await tx.wait();
+    return jsonResult({
+        success: true,
+        txHash: tx.hash,
+        explorerUrl: tx.explorerUrl,
+        amount: `${args.amount} ${args.token.toUpperCase()}`,
+        to: args.recipient,
+    });
+}
+export async function handleGetTxStatus(args) {
+    const session = requireSession();
+    const { sdk } = await initSDKAndWallet(session);
+    const provider = sdk.getProvider();
+    const receipt = await provider.getTransactionReceipt(args.hash);
+    const actualFee = "actual_fee" in receipt ? String(receipt.actual_fee) : undefined;
+    const blockNumber = "block_number" in receipt ? receipt.block_number : undefined;
+    return jsonResult({
+        hash: args.hash,
+        status: receipt.statusReceipt,
+        actualFee,
+        blockNumber,
+    });
+}
+export async function handleStakeTokens(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    await wallet.ensureReady({ deploy: "if_needed" });
+    const result = await stakingService.stake(wallet, args.pool, args.amount);
+    return jsonResult({
+        success: true,
+        txHash: result.hash,
+        explorerUrl: result.explorerUrl,
+        amount: `${args.amount} STRK`,
+        pool: args.pool,
+    });
+}
+export async function handleUnstakeTokens(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    await wallet.ensureReady({ deploy: "if_needed" });
+    if (args.action === "intent") {
+        if (!args.amount) {
+            return textResult("Amount is required for exit intent.");
+        }
+        const result = await stakingService.exitPoolIntent(wallet, args.pool, args.amount);
+        return jsonResult({
+            success: true,
+            action: "exit_intent",
+            txHash: result.hash,
+            explorerUrl: result.explorerUrl,
+            message: "Exit intent declared. Wait for cooldown period, then call with action='exit'.",
+        });
+    }
+    // action === "exit"
+    const result = await stakingService.exitPool(wallet, args.pool);
+    return jsonResult({
+        success: true,
+        action: "exit_complete",
+        txHash: result.hash,
+        explorerUrl: result.explorerUrl,
+        message: "Tokens withdrawn from pool.",
+    });
+}
+export async function handleGetStakingInfo(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    const position = await stakingService.getPosition(wallet, args.pool);
+    if (!position) {
+        return jsonResult({
+            isMember: false,
+            pool: args.pool,
+            message: "Not a member of this pool.",
+        });
+    }
+    return jsonResult({
+        isMember: true,
+        pool: args.pool,
+        staked: position.staked,
+        rewards: position.rewards,
+        total: position.total,
+        unpooling: position.unpooling,
+        cooldownEndsAt: position.unpoolTime ? position.unpoolTime.toISOString() : null,
+        commissionPercent: position.commissionPercent,
+    });
+}
+export async function handleListPools(args) {
+    const session = requireSession();
+    const { sdk, wallet } = await initSDKAndWallet(session);
+    const found = findValidator(args.validator, session.network);
+    const stakerAddress = found ? found.stakerAddress.toString() : args.validator;
+    const pools = await stakingService.getValidatorPools(sdk, stakerAddress, wallet);
+    return jsonResult({
+        validator: found ? found.name : args.validator,
+        stakerAddress,
+        pools,
+    });
+}
+export async function handleListValidators() {
+    const session = requireSession();
+    const validators = getValidators(session.network);
+    return jsonResult({
+        network: session.network,
+        count: validators.length,
+        validators: validators.map((v) => ({
+            name: v.name,
+            stakerAddress: v.stakerAddress.toString(),
+        })),
+    });
+}
+export async function handleCompoundRewards(args) {
+    const session = requireSession();
+    const { wallet } = await initSDKAndWallet(session);
+    await wallet.ensureReady({ deploy: "if_needed" });
+    const result = await stakingService.compoundRewards(wallet, args.pool);
+    return jsonResult({
+        success: true,
+        txHash: result.hash,
+        explorerUrl: result.explorerUrl,
+        compounded: result.compounded,
+    });
+}
+export async function handleConfigAction(args) {
+    const configService = ConfigService.getInstance();
+    switch (args.action) {
+        case "set-rpc": {
+            if (!args.value)
+                return textResult("RPC URL value is required.");
+            configService.set("rpcUrl", args.value);
+            return jsonResult({ success: true, rpcUrl: args.value });
+        }
+        case "get-rpc": {
+            const rpcUrl = configService.get("rpcUrl");
+            return jsonResult({ rpcUrl: rpcUrl || "default (Cartridge RPC)" });
+        }
+        case "set-network": {
+            if (!args.value || !["mainnet", "sepolia"].includes(args.value)) {
+                return textResult("Network must be 'mainnet' or 'sepolia'.");
+            }
+            configService.set("network", args.value);
+            return jsonResult({ success: true, network: args.value });
+        }
+        case "set-gasless": // deprecated alias
+        case "set-gasfree": {
+            if (!args.value || !["on", "off"].includes(args.value)) {
+                return textResult("Gasfree mode must be 'on' or 'off'.");
+            }
+            const enabled = args.value === "on";
+            configService.set("gasfreeMode", enabled);
+            if (enabled)
+                configService.delete("gasToken"); // mutually exclusive
+            return jsonResult({
+                success: true,
+                gasfreeMode: enabled,
+                note: enabled
+                    ? "Developer sponsors gas via AVNU Paymaster (requires API key + credits)"
+                    : "Gasfree disabled",
+            });
+        }
+        case "set-gas-token": {
+            if (!args.value)
+                return textResult("Token symbol or 'off' is required.");
+            if (args.value.toLowerCase() === "off") {
+                configService.delete("gasToken");
+                return jsonResult({
+                    success: true,
+                    gasToken: null,
+                    note: "Reverted to default STRK gas",
+                });
+            }
+            const upper = args.value.toUpperCase();
+            if (!GASLESS_SUPPORTED_TOKENS.includes(upper)) {
+                return textResult(`Unsupported token '${args.value}'. Supported: ${GASLESS_SUPPORTED_TOKENS.join(", ")}`);
+            }
+            configService.delete("gasfreeMode"); // mutually exclusive
+            configService.set("gasToken", upper);
+            return jsonResult({
+                success: true,
+                gasToken: upper,
+                note: `Gasless mode: user pays gas in ${upper} (no STRK needed, no API key required)`,
+            });
+        }
+        case "list": {
+            const all = configService.getAll();
+            const gasfreeMode = all.gasfreeMode === true;
+            const gasToken = all.gasToken;
+            let feeMode = "default (pays STRK)";
+            if (gasfreeMode)
+                feeMode = "gasfree (developer-sponsored via AVNU)";
+            else if (gasToken)
+                feeMode = `gasless (user pays in ${gasToken})`;
+            return jsonResult({ ...all, feeMode });
+        }
+        default:
+            return textResult(`Unknown action: ${args.action}`);
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/mcp/handlers.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,2 @@
+export declare function startMcpServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAIA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAUpD"}

package/dist/mcp/server.js

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTools } from "./tools.js";
+export async function startMcpServer() {
+    const server = new McpServer({
+        name: "starkfi",
+        version: "0.1.0",
+    });
+    registerTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc;IACnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KAChB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+DzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgSrD"}

package/dist/mcp/tools.js

@@ -0,0 +1,156 @@
+import { z } from "zod";
+import { handleGetAuthStatus, handleGetBalance, handleDeployAccount, handleGetSwapQuote, handleSwapTokens, handleSendTokens, handleGetTxStatus, handleStakeTokens, handleUnstakeTokens, handleGetStakingInfo, handleGetStakingOverview, handleListPools, handleListValidators, handleCompoundRewards, handleConfigAction, handleListLendingPools, handleGetLendingPosition, handleSupplyAssets, handleWithdrawAssets, handleBorrowAssets, handleRepayDebt, } from "./handlers/index.js";
+import { StarkfiError } from "../lib/errors.js";
+// Standardised error handling wrapper for all MCP tools.
+function withErrorHandling(fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            const isStarkfiError = error instanceof StarkfiError;
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: message,
+                            code: isStarkfiError ? error.code : "UNKNOWN_ERROR",
+                            ...(isStarkfiError && error.details
+                                ? { details: error.details }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    };
+}
+export function registerTools(server) {
+    // --- Auth & Generic Info ---
+    server.tool("get_auth_status", "Check authentication status and Fibrous API health on Starknet. Use this to verify the user's active wallet.", {}, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetAuthStatus));
+    server.tool("get_tx_status", "Check Starknet transaction status by hash. Use this to verify if a recently submitted transaction has been accepted on L2 or L1.", {
+        hash: z.string().describe("Transaction hash (0x...)"),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetTxStatus));
+    // --- Wallet & Assets ---
+    server.tool("get_balance", "Get native token and ERC-20 token balances on Starknet for the authorized user.", {
+        token: z
+            .string()
+            .optional()
+            .describe("Specific token symbol (e.g. 'STRK', 'ETH', 'USDC'). Omit to fetch all balances."),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetBalance));
+    server.tool("deploy_account", "Deploy the Starknet smart contract account on-chain. Required once before sending transactions. Safe to call multiple times (idempotent) — returns status if already deployed.", {}, { readOnlyHint: false, destructiveHint: true, idempotentHint: true }, withErrorHandling(handleDeployAccount));
+    server.tool("send_tokens", "Transfer tokens to a recipient on Starknet. Simulates the transfer before broadcasting to catch insufficient funds early.", {
+        amount: z.string().describe("Amount to send (e.g. '0.1', '100')"),
+        token: z.string().describe("Token symbol (e.g. 'STRK', 'ETH', 'USDC')"),
+        recipient: z.string().describe("Recipient Starknet address (0x...)"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleSendTokens));
+    // --- Trading (Fibrous API) ---
+    server.tool("get_swap_quote", "Get an expected output and route from Fibrous *without* executing the swap. ALWAYS use this BEFORE calling swap_tokens so the user can review the expected output amount and slippage.", {
+        amount: z.string().describe("Amount to swap in (e.g. '0.1', '100')"),
+        from_token: z.string().describe("Source token symbol to sell (e.g. 'ETH', 'USDC')"),
+        to_token: z.string().describe("Destination token symbol to buy (e.g. 'STRK', 'DAI')"),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetSwapQuote));
+    server.tool("swap_tokens", "Execute a token swap on Starknet using Fibrous aggregation. Finds optimal route and simulates before execution. ONLY call this after showing the user a quote via get_swap_quote.", {
+        amount: z.string().describe("Amount to swap in (e.g. '0.1', '100')"),
+        from_token: z.string().describe("Source token symbol to sell (e.g. 'ETH', 'STRK')"),
+        to_token: z.string().describe("Destination token symbol to buy (e.g. 'USDC', 'DAI')"),
+        slippage: z.number().optional().describe("Slippage tolerance % (default: 0.5)"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleSwapTokens));
+    // --- Staking ---
+    server.tool("list_validators", "List all known Starknet staking validators. Use this FIRST to see available validators and their names before trying to find pools.", {}, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleListValidators));
+    server.tool("list_pools", "List delegation pools for a specific validator. Look up a validator name via list_validators first.", {
+        validator: z
+            .string()
+            .describe("Validator name (e.g. 'Karnot', 'Kakarot') or staker address. Supports partial matches."),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleListPools));
+    server.tool("get_staking_info", "Get staking position info (staked balance, unclaimed rewards, total balance, commission, unpooling cooldown) for a specific pool contract.", {
+        pool: z.string().describe("Staking pool contract address (0x...)"),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetStakingInfo));
+    server.tool("get_staking_overview", "Scan ALL known validators and pools to return a consolidated staking dashboard with total staked, total rewards, total value, and per-pool breakdown. Use this to give the user a full picture of their staking portfolio.", {}, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetStakingOverview));
+    server.tool("stake_tokens", "Stake STRK in a delegation pool on Starknet. Smart stake: auto-detects whether the user needs to enter the pool or just add to an existing delegation.", {
+        amount: z.string().describe("Amount of STRK to stake (e.g. '100')"),
+        pool: z.string().describe("Staking pool contract address (0x...)"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleStakeTokens));
+    server.tool("unstake_tokens", "Unstake STRK from a pool. Unstaking is a TWO-STEP process: 1. call with action='intent', 2. wait for cooldown, 3. call with action='exit' to complete withdrawal.", {
+        action: z
+            .enum(["intent", "exit"])
+            .describe("'intent' strictly starts the unstaking process, 'exit' completes withdrawal after cooldown."),
+        pool: z.string().describe("Staking pool contract address (0x...)"),
+        amount: z
+            .string()
+            .optional()
+            .describe("Amount of STRK to unstake in STRK (ONLY required when action='intent')"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleUnstakeTokens));
+    server.tool("compound_rewards", "Atomically claim staking rewards and re-stake them recursively into the same pool in a single transaction (compound interest).", {
+        pool: z.string().describe("Staking pool contract address (0x...)"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleCompoundRewards));
+    // --- Config / Utilities ---
+    server.tool("config_action", "View and modify starkfi global configuration such as active network, RPC URL, and Gas Payment mechanisms.", {
+        action: z
+            .enum([
+            "list",
+            "set-rpc",
+            "get-rpc",
+            "set-network",
+            "set-gasfree",
+            "set-gas-token",
+            "set-gasless",
+        ])
+            .describe("list: view all. set-gasfree: dev pays gas using AVNU credits. set-gas-token: user pays gas in ERC20 token instead of STRK."),
+        value: z
+            .string()
+            .optional()
+            .describe("set-gasfree: 'on'/'off'. set-gas-token: symbol 'USDC'/'ETH' or 'off'. set-rpc: URL string. set-network: 'mainnet'/'sepolia'."),
+    }, { readOnlyHint: false, destructiveHint: false }, withErrorHandling(handleConfigAction));
+    // --- Lending (Vesu V2) ---
+    server.tool("list_lending_pools", "List available Vesu V2 lending pools on Starknet with their supported collateral/debt pairs. Use this FIRST to discover available pools before supplying, borrowing, or checking positions.", {
+        name: z
+            .string()
+            .optional()
+            .describe("Filter pools by name (partial match). Omit to list all."),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleListLendingPools));
+    server.tool("get_lending_position", "Get the user's lending position (supplied collateral and outstanding debt) in a specific Vesu pool.", {
+        pool: z
+            .string()
+            .describe("Pool name (e.g. 'Genesis', 'Re7') or contract address (0x...)"),
+        collateral_token: z.string().describe("Collateral token symbol (e.g. 'ETH', 'STRK')"),
+        debt_token: z.string().describe("Debt token symbol (e.g. 'USDC', 'USDT')"),
+    }, { readOnlyHint: true, destructiveHint: false }, withErrorHandling(handleGetLendingPosition));
+    server.tool("supply_assets", "Supply (lend) tokens into a Vesu V2 pool to earn interest. The tokens are deposited into the pool's ERC-4626 vToken vault.", {
+        pool: z
+            .string()
+            .describe("Pool name (e.g. 'Genesis', 'Re7') or contract address (0x...)"),
+        amount: z.string().describe("Amount to supply (e.g. '100', '0.5')"),
+        token: z.string().describe("Token symbol to supply (e.g. 'STRK', 'ETH', 'USDC')"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleSupplyAssets));
+    server.tool("withdraw_assets", "Withdraw previously supplied tokens from a Vesu V2 lending pool.", {
+        pool: z
+            .string()
+            .describe("Pool name (e.g. 'Genesis', 'Re7') or contract address (0x...)"),
+        amount: z.string().describe("Amount to withdraw (e.g. '100', '0.5')"),
+        token: z.string().describe("Token symbol to withdraw (e.g. 'STRK', 'ETH', 'USDC')"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleWithdrawAssets));
+    server.tool("borrow_assets", "Borrow tokens from a Vesu V2 pool by supplying collateral. Atomically deposits collateral and borrows the debt asset in a single transaction.", {
+        pool: z
+            .string()
+            .describe("Pool name (e.g. 'Genesis', 'Re7') or contract address (0x...)"),
+        collateral_amount: z.string().describe("Collateral amount to deposit (e.g. '1000')"),
+        collateral_token: z.string().describe("Collateral token symbol (e.g. 'STRK', 'ETH')"),
+        borrow_amount: z.string().describe("Amount to borrow (e.g. '100')"),
+        borrow_token: z.string().describe("Token to borrow (e.g. 'USDC', 'USDT')"),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleBorrowAssets));
+    server.tool("repay_debt", "Repay borrowed tokens on an existing Vesu V2 lending position. Approves and repays the specified amount of debt.", {
+        pool: z
+            .string()
+            .describe("Pool name (e.g. 'Genesis', 'Re7') or contract address (0x...)"),
+        amount: z.string().describe("Amount to repay (e.g. '50', '100')"),
+        token: z.string().describe("Debt token to repay (e.g. 'USDC', 'USDT')"),
+        collateral_token: z
+            .string()
+            .describe("Collateral token of the position (e.g. 'ETH', 'STRK'). Needed to identify the position."),
+    }, { readOnlyHint: false, destructiveHint: true, idempotentHint: false }, withErrorHandling(handleRepayDebt));
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/services/api/client.d.ts

@@ -0,0 +1,26 @@
+export declare function apiLogin(email: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+export interface VerifyResponse {
+    userId: string;
+    walletId: string;
+    walletAddress: string;
+    walletPublicKey: string;
+    token: string;
+    isExisting: boolean;
+}
+export declare function apiVerify(email: string, code: string): Promise<VerifyResponse>;
+export declare function apiFindWallet(email: string, token: string): Promise<{
+    wallet: {
+        id: string;
+        address: string;
+    } | null;
+}>;
+export declare function apiCreateWallet(token: string, userId?: string): Promise<{
+    wallet: {
+        id: string;
+        address: string;
+    };
+}>;
+//# sourceMappingURL=client.d.ts.map

package/dist/services/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/services/api/client.ts"],"names":[],"mappings":"AAuEA,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAE5F;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEpF;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,CAAC,CAE7D;AAED,wBAAsB,eAAe,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAEtD"}

package/dist/services/api/client.js

@@ -0,0 +1,59 @@
+import { ErrorCode, StarkfiError } from "../../lib/errors.js";
+import { STARKFI_API_URL_DEFAULT } from "../../lib/config.js";
+const REQUEST_TIMEOUT_MS = 30_000;
+function getBaseUrl() {
+    return process.env.STARKFI_API_URL ?? STARKFI_API_URL_DEFAULT;
+}
+async function request(path, body, options) {
+    const url = `${getBaseUrl()}${path}`;
+    const timeout = options?.timeoutMs ?? REQUEST_TIMEOUT_MS;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (options?.token) {
+        headers.Authorization = `Bearer ${options.token}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const errorBody = await res
+                .json()
+                .catch(() => ({ error: { message: res.statusText } }));
+            const msg = errorBody?.error?.message ??
+                `API error (${res.status})`;
+            throw new StarkfiError(ErrorCode.NETWORK_ERROR, msg);
+        }
+        return (await res.json());
+    }
+    catch (error) {
+        if (error instanceof StarkfiError)
+            throw error;
+        if (error instanceof DOMException && error.name === "AbortError") {
+            throw new StarkfiError(ErrorCode.NETWORK_ERROR, `Request to ${path} timed out after ${timeout / 1000}s. Is starkfi-server running?`);
+        }
+        throw new StarkfiError(ErrorCode.NETWORK_ERROR, `Failed to connect to starkfi-server at ${getBaseUrl()}. Is the server running?`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function apiLogin(email) {
+    return request("/auth/login", { email });
+}
+export async function apiVerify(email, code) {
+    return request("/auth/verify", { email, code });
+}
+export async function apiFindWallet(email, token) {
+    return request("/wallet/find", { email }, { token });
+}
+export async function apiCreateWallet(token, userId) {
+    return request("/wallet/create", { userId }, { token });
+}
+//# sourceMappingURL=client.js.map