clodds 1.1.0

package/dist/evm/uniswap.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * Uniswap V3 Integration for EVM Trading
+ *
+ * Supports swaps on Ethereum mainnet, Arbitrum, Optimism, Base, Polygon
+ * Uses Uniswap Universal Router for optimal execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEE_TIERS = exports.COMMON_TOKENS = exports.CHAIN_CONFIG = void 0;
+exports.resolveToken = resolveToken;
+exports.getTokenInfo = getTokenInfo;
+exports.getUniswapQuote = getUniswapQuote;
+exports.executeUniswapSwap = executeUniswapSwap;
+exports.getEvmBalance = getEvmBalance;
+const ethers_1 = require("ethers");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const CHAIN_CONFIG = {
+    ethereum: {
+        chainId: 1,
+        rpc: 'https://eth.llamarpc.com',
+        quoterV2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        swapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        weth: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+    },
+    arbitrum: {
+        chainId: 42161,
+        rpc: 'https://arb1.arbitrum.io/rpc',
+        quoterV2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        swapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        weth: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+    },
+    optimism: {
+        chainId: 10,
+        rpc: 'https://mainnet.optimism.io',
+        quoterV2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        swapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        weth: '0x4200000000000000000000000000000000000006',
+    },
+    base: {
+        chainId: 8453,
+        rpc: 'https://mainnet.base.org',
+        quoterV2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+        swapRouter: '0x2626664c2603336E57B271c5C0b26F421741e481',
+        weth: '0x4200000000000000000000000000000000000006',
+    },
+    polygon: {
+        chainId: 137,
+        rpc: 'https://polygon-rpc.com',
+        quoterV2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+        swapRouter: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        weth: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270', // WMATIC
+    },
+};
+exports.CHAIN_CONFIG = CHAIN_CONFIG;
+const QUOTER_V2_ABI = [
+    'function quoteExactInputSingle(tuple(address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96) params) external returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)',
+    'function quoteExactInput(bytes path, uint256 amountIn) external returns (uint256 amountOut, uint160[] sqrtPriceX96AfterList, uint32[] initializedTicksCrossedList, uint256 gasEstimate)',
+];
+const SWAP_ROUTER_ABI = [
+    'function exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) external payable returns (uint256 amountOut)',
+    'function exactInput(tuple(bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum) params) external payable returns (uint256 amountOut)',
+    'function multicall(uint256 deadline, bytes[] calldata data) external payable returns (bytes[] memory results)',
+];
+const ERC20_ABI = [
+    'function approve(address spender, uint256 amount) external returns (bool)',
+    'function allowance(address owner, address spender) external view returns (uint256)',
+    'function balanceOf(address account) external view returns (uint256)',
+    'function decimals() external view returns (uint8)',
+    'function symbol() external view returns (string)',
+    'function name() external view returns (string)',
+];
+// Common tokens
+const COMMON_TOKENS = {
+    USDC: {
+        ethereum: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        arbitrum: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        optimism: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+        base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        polygon: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    },
+    USDT: {
+        ethereum: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
+        arbitrum: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
+        optimism: '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58',
+        base: '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2',
+        polygon: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
+    },
+    WETH: {
+        ethereum: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+        arbitrum: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+        optimism: '0x4200000000000000000000000000000000000006',
+        base: '0x4200000000000000000000000000000000000006',
+        polygon: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619',
+    },
+};
+exports.COMMON_TOKENS = COMMON_TOKENS;
+// Fee tiers to try (in basis points * 100)
+const FEE_TIERS = [500, 3000, 10000]; // 0.05%, 0.3%, 1%
+exports.FEE_TIERS = FEE_TIERS;
+// =============================================================================
+// WALLET MANAGEMENT
+// =============================================================================
+function getEvmProvider(chain) {
+    const config = CHAIN_CONFIG[chain];
+    const customRpc = process.env[`${chain.toUpperCase()}_RPC_URL`];
+    return new ethers_1.JsonRpcProvider(customRpc || config.rpc);
+}
+function getEvmWallet(chain) {
+    const privateKey = process.env.EVM_PRIVATE_KEY;
+    if (!privateKey) {
+        throw new Error('EVM_PRIVATE_KEY environment variable not set');
+    }
+    const provider = getEvmProvider(chain);
+    return new ethers_1.Wallet(privateKey, provider);
+}
+// =============================================================================
+// TOKEN UTILITIES
+// =============================================================================
+function resolveToken(symbol, chain) {
+    const upper = symbol.toUpperCase();
+    // Check common tokens
+    if (COMMON_TOKENS[upper]) {
+        return COMMON_TOKENS[upper][chain];
+    }
+    // Native token aliases
+    if (upper === 'ETH' || upper === 'NATIVE') {
+        return CHAIN_CONFIG[chain].weth;
+    }
+    // Already an address
+    if (symbol.startsWith('0x') && symbol.length === 42) {
+        return symbol;
+    }
+    return undefined;
+}
+async function getTokenInfo(address, chain) {
+    const provider = getEvmProvider(chain);
+    const token = new ethers_1.Contract(address, ERC20_ABI, provider);
+    const [symbol, decimals, name] = await Promise.all([
+        token.symbol().catch(() => 'UNKNOWN'),
+        token.decimals().catch(() => 18),
+        token.name().catch(() => ''),
+    ]);
+    return { address, symbol, decimals: Number(decimals), name };
+}
+// =============================================================================
+// QUOTING
+// =============================================================================
+async function getUniswapQuote(params) {
+    const { chain, inputToken, outputToken, amount, slippageBps = 50 } = params;
+    const config = CHAIN_CONFIG[chain];
+    const provider = getEvmProvider(chain);
+    const quoter = new ethers_1.Contract(config.quoterV2, QUOTER_V2_ABI, provider);
+    // Resolve token addresses
+    const tokenIn = resolveToken(inputToken, chain) || inputToken;
+    const tokenOut = resolveToken(outputToken, chain) || outputToken;
+    // Get token decimals
+    const inputInfo = await getTokenInfo(tokenIn, chain);
+    const amountIn = (0, ethers_1.parseUnits)(amount, inputInfo.decimals);
+    // Try each fee tier to find best quote
+    let bestQuote = null;
+    for (const fee of FEE_TIERS) {
+        try {
+            const result = await quoter.quoteExactInputSingle.staticCall({
+                tokenIn,
+                tokenOut,
+                amountIn,
+                fee,
+                sqrtPriceLimitX96: 0n,
+            });
+            const amountOut = result[0];
+            const gasEstimate = result[3];
+            if (!bestQuote || amountOut > bestQuote.amountOut) {
+                bestQuote = { amountOut, fee, gasEstimate };
+            }
+        }
+        catch {
+            // Fee tier not available for this pair
+            continue;
+        }
+    }
+    if (!bestQuote) {
+        throw new Error(`No Uniswap V3 pool found for ${inputToken} -> ${outputToken} on ${chain}`);
+    }
+    const outputInfo = await getTokenInfo(tokenOut, chain);
+    const outputAmount = (0, ethers_1.formatUnits)(bestQuote.amountOut, outputInfo.decimals);
+    // Clamp slippage to valid range (0-10000 bps)
+    const clampedSlippage = Math.max(0, Math.min(slippageBps, 10000));
+    // Calculate minimum output with slippage
+    const minOut = (bestQuote.amountOut * BigInt(10000 - clampedSlippage)) / 10000n;
+    const outputAmountMin = (0, ethers_1.formatUnits)(minOut, outputInfo.decimals);
+    // Estimate price impact from input/output ratio vs spot
+    const inputFloat = parseFloat(amount);
+    const outputFloat = parseFloat(outputAmount);
+    const priceImpact = inputFloat > 0 && outputFloat > 0
+        ? 0 // Accurate impact requires pool sqrtPrice; 0 is honest placeholder
+        : 0;
+    logger_1.logger.debug({ chain, inputToken, outputToken, amount, outputAmount, fee: bestQuote.fee }, 'Uniswap quote');
+    return {
+        inputToken: tokenIn,
+        outputToken: tokenOut,
+        inputAmount: amount,
+        outputAmount,
+        outputAmountMin,
+        priceImpact,
+        route: [tokenIn, tokenOut],
+        gasEstimate: bestQuote.gasEstimate.toString(),
+        feeTier: bestQuote.fee,
+    };
+}
+// =============================================================================
+// SWAP EXECUTION
+// =============================================================================
+async function executeUniswapSwap(params) {
+    const { chain, inputToken, outputToken, amount, slippageBps = 50, deadline = Math.floor(Date.now() / 1000) + 1800, // 30 min default
+     } = params;
+    const config = CHAIN_CONFIG[chain];
+    try {
+        // Get quote first
+        const quote = await getUniswapQuote({
+            chain,
+            inputToken,
+            outputToken,
+            amount,
+            slippageBps,
+        });
+        const wallet = getEvmWallet(chain);
+        const recipient = params.recipient || wallet.address;
+        const inputInfo = await getTokenInfo(quote.inputToken, chain);
+        const outputInfo = await getTokenInfo(quote.outputToken, chain);
+        const amountIn = (0, ethers_1.parseUnits)(amount, inputInfo.decimals);
+        const amountOutMin = (0, ethers_1.parseUnits)(quote.outputAmountMin, outputInfo.decimals);
+        // Check if input is native ETH
+        const isNativeIn = quote.inputToken.toLowerCase() === config.weth.toLowerCase() &&
+            inputToken.toUpperCase() === 'ETH';
+        // Approve token if not native
+        if (!isNativeIn) {
+            const token = new ethers_1.Contract(quote.inputToken, ERC20_ABI, wallet);
+            const allowance = await token.allowance(wallet.address, config.swapRouter);
+            if (allowance < amountIn) {
+                logger_1.logger.info({ token: quote.inputToken, router: config.swapRouter }, 'Approving token');
+                const approveTx = await token.approve(config.swapRouter, ethers_1.MaxUint256);
+                await approveTx.wait();
+            }
+        }
+        // Build swap transaction
+        const router = new ethers_1.Contract(config.swapRouter, SWAP_ROUTER_ABI, wallet);
+        // Use the best fee tier found during quoting
+        const fee = quote.feeTier || 3000;
+        const swapParams = {
+            tokenIn: quote.inputToken,
+            tokenOut: quote.outputToken,
+            fee,
+            recipient,
+            amountIn,
+            amountOutMinimum: amountOutMin,
+            sqrtPriceLimitX96: 0n,
+        };
+        logger_1.logger.info({ chain, inputToken, outputToken, amount, amountOutMin: quote.outputAmountMin }, 'Executing Uniswap swap');
+        // Use gas estimate from quote with 30% buffer, fallback to 500k
+        const gasEstimate = quote.gasEstimate ? BigInt(quote.gasEstimate) : 0n;
+        const gasLimit = gasEstimate > 0n ? (gasEstimate * 130n) / 100n : 500000n;
+        const tx = await router.exactInputSingle(swapParams, {
+            value: isNativeIn ? amountIn : 0n,
+            gasLimit,
+        });
+        const receipt = await tx.wait();
+        logger_1.logger.info({ txHash: receipt.hash, gasUsed: receipt.gasUsed.toString() }, 'Swap complete');
+        return {
+            success: true,
+            txHash: receipt.hash,
+            inputAmount: amount,
+            outputAmount: quote.outputAmount,
+            gasUsed: receipt.gasUsed.toString(),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logger_1.logger.error({ chain, inputToken, outputToken, amount, error: message }, 'Swap failed');
+        return {
+            success: false,
+            inputAmount: amount,
+            error: message,
+        };
+    }
+}
+// =============================================================================
+// BALANCE UTILITIES
+// =============================================================================
+async function getEvmBalance(token, chain, address) {
+    const provider = getEvmProvider(chain);
+    const owner = address || getEvmWallet(chain).address;
+    const tokenAddress = resolveToken(token, chain) || token;
+    if (token.toUpperCase() === 'ETH' || token.toUpperCase() === 'NATIVE') {
+        const balance = await provider.getBalance(owner);
+        return (0, ethers_1.formatUnits)(balance, 18);
+    }
+    const tokenContract = new ethers_1.Contract(tokenAddress, ERC20_ABI, provider);
+    const [balance, decimals] = await Promise.all([
+        tokenContract.balanceOf(owner),
+        tokenContract.decimals(),
+    ]);
+    return (0, ethers_1.formatUnits)(balance, Number(decimals));
+}
+//# sourceMappingURL=uniswap.js.map

package/dist/evm/uniswap.js.map

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

package/dist/evm/virtuals.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Virtuals Protocol Trading & Agent Creation Integration
+ *
+ * Buy and sell AI agent tokens on Base chain via bonding curves
+ * Supports:
+ * - Agent token creation (100 VIRTUAL minimum)
+ * - Bonding curve trading (pre-graduation)
+ * - DEX trading via Uniswap V2 (post-graduation)
+ * - Graduation status tracking (42K VIRTUAL threshold)
+ *
+ * Docs: https://whitepaper.virtuals.io
+ * App: https://app.virtuals.io / https://fun.virtuals.io
+ */
+import type { TokenInfo } from './uniswap';
+export declare const BASE_CHAIN_ID = 8453;
+export declare const BASE_RPC_DEFAULT = "https://mainnet.base.org";
+export declare const VIRTUAL_TOKEN = "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b";
+export declare const GRADUATION_THRESHOLD: bigint;
+export declare const AGENT_CREATION_COST: bigint;
+export declare const AGENT_TOKEN_SUPPLY: bigint;
+export declare const VIRTUALS_CONTRACTS: {
+    bondingProxy: string;
+    sellExecutor: string;
+    creatorVault: string;
+    sellWallet: string;
+    veVirtual: string;
+    taxManager: string;
+};
+export declare const UNISWAP_V2_ROUTER = "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24";
+export declare const UNISWAP_V2_FACTORY = "0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6";
+export interface VirtualsQuoteParams {
+    agentToken: string;
+    amount: string;
+    side: 'buy' | 'sell';
+    slippageBps?: number;
+}
+export interface VirtualsQuote {
+    agentToken: TokenInfo;
+    virtualToken: TokenInfo;
+    inputAmount: string;
+    outputAmount: string;
+    outputAmountMin: string;
+    priceImpact: number;
+    currentPrice: number;
+    newPrice: number;
+    isGraduated: boolean;
+    route: 'bonding' | 'uniswap';
+}
+export interface VirtualsSwapParams extends VirtualsQuoteParams {
+    recipient?: string;
+}
+export interface VirtualsSwapResult {
+    success: boolean;
+    txHash?: string;
+    inputAmount: string;
+    outputAmount?: string;
+    gasUsed?: string;
+    error?: string;
+    route?: 'bonding' | 'uniswap';
+}
+export interface AgentTokenInfo {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: string;
+    isGraduated: boolean;
+    bondingCurve?: {
+        virtualReserve: string;
+        tokenReserve: string;
+        currentPrice: string;
+        progressToGraduation: number;
+    };
+    uniswapPair?: string;
+    creator: string;
+    createdAt?: number;
+}
+export interface AgentCreationParams {
+    name: string;
+    symbol: string;
+    description?: string;
+    initialVirtualAmount?: string;
+    prePurchaseAmount?: string;
+}
+export interface AgentCreationResult {
+    success: boolean;
+    txHash?: string;
+    agentTokenAddress?: string;
+    error?: string;
+}
+export type AgentStatus = 'prototype' | 'sentient' | 'graduated';
+/**
+ * Check if an agent token has graduated from bonding curve to Uniswap
+ */
+export declare function isAgentGraduated(tokenAddress: string): Promise<boolean>;
+/**
+ * Get graduation progress (0-100%)
+ */
+export declare function getGraduationProgress(tokenAddress: string): Promise<number>;
+/**
+ * Get agent status: prototype, sentient, or graduated
+ */
+export declare function getAgentStatus(tokenAddress: string): Promise<AgentStatus>;
+/**
+ * Get detailed info about an agent token
+ */
+export declare function getAgentTokenInfo(tokenAddress: string): Promise<AgentTokenInfo>;
+/**
+ * Get quote for buying/selling agent tokens
+ * Automatically routes to bonding curve or Uniswap based on graduation status
+ */
+export declare function getVirtualsQuote(params: VirtualsQuoteParams): Promise<VirtualsQuote>;
+/**
+ * Buy agent tokens with VIRTUAL
+ * Automatically routes to bonding curve or Uniswap
+ */
+export declare function buyAgentToken(params: VirtualsSwapParams): Promise<VirtualsSwapResult>;
+/**
+ * Sell agent tokens for VIRTUAL
+ * Automatically routes to bonding curve or Uniswap
+ */
+export declare function sellAgentToken(params: VirtualsSwapParams): Promise<VirtualsSwapResult>;
+/**
+ * Get VIRTUAL token balance
+ */
+export declare function getVirtualBalance(address?: string): Promise<string>;
+/**
+ * Get agent token balance
+ */
+export declare function getAgentTokenBalance(agentToken: string, address?: string): Promise<string>;
+/**
+ * Get all agent token balances for an address
+ */
+export declare function getAgentTokenBalances(agentTokens: string[], address?: string): Promise<Map<string, string>>;
+export interface VirtualsApiAgent {
+    id: string;
+    name: string;
+    symbol: string;
+    tokenAddress: string;
+    description?: string;
+    image?: string;
+    marketCap: number;
+    price: number;
+    priceChange24h?: number;
+    volume24h: number;
+    holders: number;
+    status: 'prototype' | 'sentient' | 'graduated';
+    createdAt: string;
+}
+/**
+ * Search for agents via Virtuals API
+ */
+export declare function searchAgents(query: string, limit?: number): Promise<VirtualsApiAgent[]>;
+/**
+ * Get trending agents
+ */
+export declare function getTrendingAgents(limit?: number): Promise<VirtualsApiAgent[]>;
+/**
+ * Get newly launched agents
+ */
+export declare function getNewAgents(limit?: number): Promise<VirtualsApiAgent[]>;
+/**
+ * Get agent by token address
+ */
+export declare function getAgentByToken(tokenAddress: string): Promise<VirtualsApiAgent | null>;
+export interface StakeParams {
+    amount: string;
+    receiver?: string;
+    delegatee?: string;
+}
+export interface StakeResult {
+    success: boolean;
+    txHash?: string;
+    amount: string;
+    error?: string;
+}
+/**
+ * Stake VIRTUAL tokens for veVIRTUAL
+ */
+export declare function stakeVirtual(params: StakeParams): Promise<StakeResult>;
+/**
+ * Get veVIRTUAL balance
+ */
+export declare function getVeVirtualBalance(address?: string): Promise<string>;
+/**
+ * Delegate voting power
+ */
+export declare function delegateVotingPower(delegatee: string): Promise<StakeResult>;
+/**
+ * Note: Agent creation requires:
+ * 1. 100 VIRTUAL tokens minimum
+ * 2. Metadata (name, symbol, description, image)
+ * 3. Interaction with fun.virtuals.io frontend or API
+ *
+ * The on-chain AgentFactory requires MINTER_ROLE which is restricted.
+ * For programmatic agent creation, use the Virtuals API.
+ */
+export interface CreateAgentViaApiParams {
+    name: string;
+    symbol: string;
+    description: string;
+    imageUrl?: string;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+}
+/**
+ * Create agent via Virtuals API (requires API key)
+ * Note: This is a placeholder - actual API may require authentication
+ */
+export declare function createAgentViaApi(params: CreateAgentViaApiParams, apiKey?: string): Promise<AgentCreationResult>;
+/**
+ * Check if user has enough VIRTUAL for agent creation
+ */
+export declare function canCreateAgent(address?: string): Promise<{
+    canCreate: boolean;
+    balance: string;
+    required: string;
+    shortfall: string;
+}>;