intent-swap-mcp 0.1.0

package/src/price-feed.ts

@@ -0,0 +1,72 @@
+/**
+ * Price feed — CoinGecko free API, no key required.
+ */
+
+const COINGECKO_IDS: Record<string, string> = {
+  ETH: "ethereum",
+  WETH: "weth",
+  WBTC: "wrapped-bitcoin",
+  BTC: "bitcoin",
+  USDC: "usd-coin",
+  USDT: "tether",
+  DAI: "dai",
+  ARB: "arbitrum",
+  UNI: "uniswap",
+  LINK: "chainlink",
+  MATIC: "matic-network",
+  OP: "optimism",
+  PEPE: "pepe",
+  SHIB: "shiba-inu",
+  AAVE: "aave",
+  CRV: "curve-dao-token",
+};
+
+// Simple in-memory cache (60s TTL)
+const priceCache: Map<string, { price: number; ts: number }> = new Map();
+const CACHE_TTL = 60_000;
+
+export async function getTokenPrice(symbol: string): Promise<number | null> {
+  const id = COINGECKO_IDS[symbol.toUpperCase()];
+  if (!id) return null;
+
+  const cached = priceCache.get(symbol);
+  if (cached && Date.now() - cached.ts < CACHE_TTL) return cached.price;
+
+  try {
+    const res = await fetch(
+      `https://api.coingecko.com/api/v3/simple/price?ids=${id}&vs_currencies=usd`,
+      { signal: AbortSignal.timeout(5000) }
+    );
+    const data = (await res.json()) as Record<string, { usd: number }>;
+    const price = data[id]?.usd ?? null;
+    if (price !== null) priceCache.set(symbol, { price, ts: Date.now() });
+    return price;
+  } catch {
+    return null;
+  }
+}
+
+export async function getSupportedTokens() {
+  const symbols = Object.keys(COINGECKO_IDS);
+  const ids = Object.values(COINGECKO_IDS).join(",");
+
+  let prices: Record<string, number> = {};
+  try {
+    const res = await fetch(
+      `https://api.coingecko.com/api/v3/simple/price?ids=${ids}&vs_currencies=usd`,
+      { signal: AbortSignal.timeout(5000) }
+    );
+    const data = (await res.json()) as Record<string, { usd: number }>;
+    for (const [sym, id] of Object.entries(COINGECKO_IDS)) {
+      if (data[id]?.usd) prices[sym] = data[id].usd;
+    }
+  } catch {
+    // return without prices
+  }
+
+  return symbols.map((sym) => ({
+    symbol: sym,
+    coingeckoId: COINGECKO_IDS[sym],
+    priceUsd: prices[sym] ?? null,
+  }));
+}

package/src/uniswap.ts

@@ -0,0 +1,270 @@
+/**
+ * Uniswap V3 quote + tx builder.
+ * Uses public RPC — no API key required.
+ *
+ * Quote:  calls QuoterV2 on-chain
+ * Build:  generates SwapRouter02 calldata via viem
+ */
+
+import { createPublicClient, http, parseUnits, formatUnits, encodeFunctionData, type Address } from "viem";
+import { mainnet, arbitrum } from "viem/chains";
+
+// ─── Chain config ──────────────────────────────────────────────────────────
+
+const CHAINS = {
+  mainnet: {
+    chain: mainnet,
+    rpc: "https://ethereum.publicnode.com",
+    quoterV2: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e" as Address,
+    swapRouter: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45" as Address,
+  },
+  arbitrum: {
+    chain: arbitrum,
+    rpc: "https://arbitrum-one.publicnode.com",
+    quoterV2: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e" as Address,
+    swapRouter: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45" as Address,
+  },
+};
+
+// ─── Token registry ────────────────────────────────────────────────────────
+
+interface TokenInfo {
+  address: Address;
+  decimals: number;
+  isNative?: boolean;
+}
+
+const TOKENS_MAINNET: Record<string, TokenInfo> = {
+  ETH:  { address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", decimals: 18, isNative: true },
+  WETH: { address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", decimals: 18 },
+  USDC: { address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", decimals: 6 },
+  USDT: { address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", decimals: 6 },
+  DAI:  { address: "0x6B175474E89094C44Da98b954EedeAC495271d0F", decimals: 18 },
+  WBTC: { address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599", decimals: 8 },
+  UNI:  { address: "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984", decimals: 18 },
+  LINK: { address: "0x514910771AF9Ca656af840dff83E8264EcF986CA", decimals: 18 },
+  ARB:  { address: "0xB50721BCf8d664c30412Cfbc6cf7a15145234ad1", decimals: 18 },
+  AAVE: { address: "0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9", decimals: 18 },
+  CRV:  { address: "0xD533a949740bb3306d119CC777fa900bA034cd52", decimals: 18 },
+};
+
+// ─── ABIs (minimal) ────────────────────────────────────────────────────────
+
+const QUOTER_V2_ABI = [
+  {
+    name: "quoteExactInputSingle",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      {
+        name: "params",
+        type: "tuple",
+        components: [
+          { name: "tokenIn", type: "address" },
+          { name: "tokenOut", type: "address" },
+          { name: "amountIn", type: "uint256" },
+          { name: "fee", type: "uint24" },
+          { name: "sqrtPriceLimitX96", type: "uint160" },
+        ],
+      },
+    ],
+    outputs: [
+      { name: "amountOut", type: "uint256" },
+      { name: "sqrtPriceX96After", type: "uint160" },
+      { name: "initializedTicksCrossed", type: "uint32" },
+      { name: "gasEstimate", type: "uint256" },
+    ],
+  },
+] as const;
+
+const SWAP_ROUTER_ABI = [
+  {
+    name: "exactInputSingle",
+    type: "function",
+    stateMutability: "payable",
+    inputs: [
+      {
+        name: "params",
+        type: "tuple",
+        components: [
+          { name: "tokenIn", type: "address" },
+          { name: "tokenOut", type: "address" },
+          { name: "fee", type: "uint24" },
+          { name: "recipient", type: "address" },
+          { name: "amountIn", type: "uint256" },
+          { name: "amountOutMinimum", type: "uint256" },
+          { name: "sqrtPriceLimitX96", type: "uint160" },
+        ],
+      },
+    ],
+    outputs: [{ name: "amountOut", type: "uint256" }],
+  },
+] as const;
+
+// ─── Fee tiers to try ──────────────────────────────────────────────────────
+
+const FEE_TIERS = [500, 3000, 10000] as const; // 0.05%, 0.3%, 1%
+
+// ─── Helpers ───────────────────────────────────────────────────────────────
+
+function getTokenInfo(symbol: string): TokenInfo {
+  const info = TOKENS_MAINNET[symbol.toUpperCase()];
+  if (!info) throw new Error(`Unsupported token: ${symbol}`);
+  return info;
+}
+
+function slippageBpsToMultiplier(bps: number): bigint {
+  // amountOutMinimum = amountOut * (10000 - bps) / 10000
+  return BigInt(10000 - bps);
+}
+
+// ─── Quote ─────────────────────────────────────────────────────────────────
+
+export interface SwapQuote {
+  fromToken: string;
+  toToken: string;
+  amountIn: number;
+  amountOut: number;
+  feeTier: number;
+  priceImpactPct: number | null;
+  gasEstimate: number;
+  rateFormatted: string;
+}
+
+export async function getSwapQuote(params: {
+  fromToken: string;
+  toToken: string;
+  amount: number;
+  slippageBps?: number;
+}): Promise<SwapQuote> {
+  const { fromToken, toToken, amount } = params;
+  const tokenIn = getTokenInfo(fromToken);
+  const tokenOut = getTokenInfo(toToken);
+
+  const client = createPublicClient({
+    chain: CHAINS.mainnet.chain,
+    transport: http(CHAINS.mainnet.rpc),
+  });
+
+  const amountIn = parseUnits(amount.toString(), tokenIn.decimals);
+
+  // Try fee tiers, pick best output
+  let bestOut: bigint | null = null;
+  let bestFee = 3000;
+  let bestGas = 0;
+
+  for (const fee of FEE_TIERS) {
+    try {
+      const result = await client.readContract({
+        address: CHAINS.mainnet.quoterV2,
+        abi: QUOTER_V2_ABI,
+        functionName: "quoteExactInputSingle",
+        args: [
+          {
+            tokenIn: tokenIn.address,
+            tokenOut: tokenOut.address,
+            amountIn,
+            fee,
+            sqrtPriceLimitX96: 0n,
+          },
+        ],
+      });
+      const [amountOut, , , gasEstimate] = result as [bigint, bigint, number, bigint];
+      if (bestOut === null || amountOut > bestOut) {
+        bestOut = amountOut;
+        bestFee = fee;
+        bestGas = Number(gasEstimate);
+      }
+    } catch {
+      // fee tier not available, try next
+    }
+  }
+
+  if (bestOut === null) {
+    throw new Error(`No liquidity found for ${fromToken}→${toToken}`);
+  }
+
+  const amountOut = Number(formatUnits(bestOut, tokenOut.decimals));
+  const rate = amountOut / amount;
+
+  return {
+    fromToken: fromToken.toUpperCase(),
+    toToken: toToken.toUpperCase(),
+    amountIn: amount,
+    amountOut,
+    feeTier: bestFee,
+    priceImpactPct: null, // would need pool state to calculate precisely
+    gasEstimate: bestGas,
+    rateFormatted: `1 ${fromToken.toUpperCase()} = ${rate.toFixed(6)} ${toToken.toUpperCase()}`,
+  };
+}
+
+// ─── Build TX ──────────────────────────────────────────────────────────────
+
+export interface SwapTx {
+  to: Address;
+  data: string;
+  value: string; // hex, ETH value in wei
+  fromToken: string;
+  toToken: string;
+  amountIn: number;
+  estimatedAmountOut: number;
+  feeTier: number;
+  slippageBps: number;
+  summary: string;
+  warning: string;
+}
+
+export async function buildSwapTx(params: {
+  fromToken: string;
+  toToken: string;
+  amount: number;
+  recipientAddress: string;
+  slippageBps?: number;
+}): Promise<SwapTx> {
+  const { fromToken, toToken, amount, recipientAddress, slippageBps = 50 } = params;
+
+  // Get quote first
+  const quote = await getSwapQuote({ fromToken, toToken, amount, slippageBps });
+
+  const tokenIn = getTokenInfo(fromToken);
+  const tokenOut = getTokenInfo(toToken);
+
+  const amountIn = parseUnits(amount.toString(), tokenIn.decimals);
+  const amountOutRaw = parseUnits(quote.amountOut.toString(), tokenOut.decimals);
+  const amountOutMinimum = (amountOutRaw * slippageBpsToMultiplier(slippageBps)) / 10000n;
+
+  const calldata = encodeFunctionData({
+    abi: SWAP_ROUTER_ABI,
+    functionName: "exactInputSingle",
+    args: [
+      {
+        tokenIn: tokenIn.address,
+        tokenOut: tokenOut.address,
+        fee: quote.feeTier,
+        recipient: recipientAddress as Address,
+        amountIn,
+        amountOutMinimum,
+        sqrtPriceLimitX96: 0n,
+      },
+    ],
+  });
+
+  const isNativeIn = tokenIn.isNative === true;
+
+  return {
+    to: CHAINS.mainnet.swapRouter,
+    data: calldata,
+    value: isNativeIn ? `0x${amountIn.toString(16)}` : "0x0",
+    fromToken: fromToken.toUpperCase(),
+    toToken: toToken.toUpperCase(),
+    amountIn: amount,
+    estimatedAmountOut: quote.amountOut,
+    feeTier: quote.feeTier,
+    slippageBps,
+    summary: `Swap ${amount} ${fromToken.toUpperCase()} → ~${quote.amountOut.toFixed(4)} ${toToken.toUpperCase()} (slippage: ${slippageBps / 100}%)`,
+    warning:
+      "This transaction must be signed and broadcast by the user's wallet. " +
+      "If fromToken is an ERC-20 (not ETH), the user must first approve the SwapRouter to spend their tokens.",
+  };
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}