@clawnch/clawncher-sdk 0.1.3 → 0.3.0

package/dist/uniswap-chains.js

@@ -0,0 +1,362 @@
+/**
+ * Multi-chain Uniswap contract address registry.
+ *
+ * Covers all chains supported by Uniswap V4, V3, and the Trading API.
+ * Derived from Uniswap AI's uniswap-driver chain references and
+ * swap-integration Universal Router deployment addresses.
+ *
+ * @see https://github.com/Uniswap/uniswap-ai
+ * @see https://docs.uniswap.org/contracts/v4/deployments
+ */
+import { getUniswapV4Addresses, getCommonAddresses } from './uniswap-addresses.js';
+// ============================================================================
+// Permit2 — same on all chains
+// ============================================================================
+const PERMIT2 = '0x000000000022D473030F116dDEE9F6B43aC78BA3';
+const ZERO = '0x0000000000000000000000000000000000000000';
+// ============================================================================
+// Chain Configs
+// ============================================================================
+const CHAINS = {
+    // Ethereum
+    1: {
+        chainId: 1,
+        name: 'Ethereum',
+        slug: 'ethereum',
+        v4: true, v3: true, v2: true,
+        tradingApi: true,
+        blockTimeSeconds: 12,
+        explorer: 'https://etherscan.io',
+        dexScreenerId: 'ethereum',
+        weth: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+        usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x66a9893cc07d91d95644aedd05d03f95e1dba8af',
+        v4PoolManager: '0x000000000004444c5dc75cB358380D2e3dE08A90',
+        v4StateView: ZERO, // TODO: add when available
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Base — canonical addresses from uniswap-addresses.ts (single source of truth)
+    8453: (() => {
+        const v4 = getUniswapV4Addresses('mainnet');
+        const common = getCommonAddresses('mainnet');
+        return {
+            chainId: 8453,
+            name: 'Base',
+            slug: 'base',
+            v4: true, v3: true, v2: false,
+            tradingApi: true,
+            blockTimeSeconds: 2,
+            explorer: 'https://basescan.org',
+            dexScreenerId: 'base',
+            weth: common.weth,
+            usdc: common.usdc,
+            permit2: PERMIT2,
+            v4UniversalRouter: v4.universalRouter,
+            v4PoolManager: v4.poolManager,
+            v4StateView: v4.stateView,
+            v4Quoter: v4.quoter,
+            v4PositionManager: v4.positionManager,
+        };
+    })(),
+    // Arbitrum
+    42161: {
+        chainId: 42161,
+        name: 'Arbitrum',
+        slug: 'arbitrum',
+        v4: true, v3: true, v2: true,
+        tradingApi: true,
+        blockTimeSeconds: 0.25,
+        explorer: 'https://arbiscan.io',
+        dexScreenerId: 'arbitrum',
+        weth: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+        usdc: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0xa51afafe0263b40edaef0df8781ea9aa03e381a3',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Optimism
+    10: {
+        chainId: 10,
+        name: 'Optimism',
+        slug: 'optimism',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://optimistic.etherscan.io',
+        dexScreenerId: 'optimism',
+        weth: '0x4200000000000000000000000000000000000006',
+        usdc: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x851116d9223fabed8e56c0e6b8ad0c31d98b3507',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Polygon
+    137: {
+        chainId: 137,
+        name: 'Polygon',
+        slug: 'polygon',
+        v4: false, v3: true, v2: true,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://polygonscan.com',
+        dexScreenerId: 'polygon',
+        weth: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270', // WMATIC
+        usdc: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x1095692a6237d83c6a72f3f5efedb9a670c49223',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // BNB Chain
+    56: {
+        chainId: 56,
+        name: 'BNB Chain',
+        slug: 'bnb',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 3,
+        explorer: 'https://bscscan.com',
+        dexScreenerId: 'bsc',
+        weth: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c', // WBNB
+        usdc: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x1906c1d672b88cd1b9ac7593301ca990f94eae07',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Unichain
+    130: {
+        chainId: 130,
+        name: 'Unichain',
+        slug: 'unichain',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 1,
+        explorer: 'https://unichain.blockscout.com',
+        dexScreenerId: 'unichain',
+        weth: '0x4200000000000000000000000000000000000006',
+        usdc: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0xef740bf23acae26f6492b10de645d6b98dc8eaf3',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Avalanche
+    43114: {
+        chainId: 43114,
+        name: 'Avalanche',
+        slug: 'avalanche',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://snowtrace.io',
+        dexScreenerId: 'avalanche',
+        weth: '0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7', // WAVAX
+        usdc: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x94b75331ae8d42c1b61065089b7d48fe14aa73b7',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Celo
+    42220: {
+        chainId: 42220,
+        name: 'Celo',
+        slug: 'celo',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 5,
+        explorer: 'https://celoscan.io',
+        dexScreenerId: 'celo',
+        weth: '0x471EcE3750Da237f93B8E339c536989b8978a438', // CELO
+        usdc: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+        permit2: PERMIT2,
+        v4UniversalRouter: '0xcb695bc5d3aa22cad1e6df07801b061a05a0233a',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Blast
+    81457: {
+        chainId: 81457,
+        name: 'Blast',
+        slug: 'blast',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://blastscan.io',
+        dexScreenerId: 'blast',
+        weth: '0x4300000000000000000000000000000000000004',
+        usdc: ZERO,
+        permit2: PERMIT2,
+        v4UniversalRouter: '0xeabbcb3e8e415306207ef514f660a3f820025be3',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Zora
+    7777777: {
+        chainId: 7777777,
+        name: 'Zora',
+        slug: 'zora',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://explorer.zora.energy',
+        dexScreenerId: 'zora',
+        weth: '0x4200000000000000000000000000000000000006',
+        usdc: ZERO,
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x3315ef7ca28db74abadc6c44570efdf06b04b020',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // World Chain
+    480: {
+        chainId: 480,
+        name: 'World Chain',
+        slug: 'worldchain',
+        v4: true, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://worldchain-mainnet.explorer.alchemy.com',
+        dexScreenerId: 'worldchain',
+        weth: '0x4200000000000000000000000000000000000006',
+        usdc: ZERO,
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x8ac7bee993bb44dab564ea4bc9ea67bf9eb5e743',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Soneium
+    1868: {
+        chainId: 1868,
+        name: 'Soneium',
+        slug: 'soneium',
+        v4: true, v3: false, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 2,
+        explorer: 'https://soneium.blockscout.com',
+        dexScreenerId: 'soneium',
+        weth: '0x4200000000000000000000000000000000000006',
+        usdc: ZERO,
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x4cded7edf52c8aa5259a54ec6a3ce7c6d2a455df',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // zkSync
+    324: {
+        chainId: 324,
+        name: 'zkSync Era',
+        slug: 'zksync',
+        v4: false, v3: true, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 1,
+        explorer: 'https://explorer.zksync.io',
+        dexScreenerId: 'zksync',
+        weth: '0x5AEa5775959fBC2557Cc8789bC1bf90A239D9a91',
+        usdc: '0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4',
+        permit2: PERMIT2,
+        v4UniversalRouter: ZERO,
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+    // Monad
+    143: {
+        chainId: 143,
+        name: 'Monad',
+        slug: 'monad',
+        v4: true, v3: false, v2: false,
+        tradingApi: true,
+        blockTimeSeconds: 1,
+        explorer: 'https://monad.blockscout.com',
+        dexScreenerId: 'monad',
+        weth: ZERO,
+        usdc: ZERO,
+        permit2: PERMIT2,
+        v4UniversalRouter: '0x0d97dc33264bfc1c226207428a79b26757fb9dc3',
+        v4PoolManager: ZERO,
+        v4StateView: ZERO,
+        v4Quoter: ZERO,
+        v4PositionManager: ZERO,
+    },
+};
+// ============================================================================
+// Getters
+// ============================================================================
+/** Get config for a specific chain ID. Returns undefined if not supported. */
+export function getUniswapChain(chainId) {
+    return CHAINS[chainId];
+}
+/** Get all supported chain configs. */
+export function getAllUniswapChains() {
+    return Object.values(CHAINS);
+}
+/** Get chains that support the Uniswap Trading API. */
+export function getTradingApiChains() {
+    return Object.values(CHAINS).filter(c => c.tradingApi);
+}
+/** Get chains that have V4 deployed. */
+export function getV4Chains() {
+    return Object.values(CHAINS).filter(c => c.v4);
+}
+/** Get chains that have V3 deployed. */
+export function getV3Chains() {
+    return Object.values(CHAINS).filter(c => c.v3);
+}
+/** Get chain ID from a slug (e.g. 'base' -> 8453). */
+export function chainIdFromSlug(slug) {
+    const chain = Object.values(CHAINS).find(c => c.slug === slug);
+    return chain?.chainId;
+}
+/** Get chain slug from a chain ID (e.g. 8453 -> 'base'). */
+export function chainSlugFromId(chainId) {
+    return CHAINS[chainId]?.slug;
+}
+/** All supported chain IDs. */
+export const SUPPORTED_CHAIN_IDS = Object.keys(CHAINS).map(Number);
+/** Uniswap deep link base URL. */
+export const UNISWAP_APP_URL = 'https://app.uniswap.org';
+export const FEE_TIERS = [
+    { fee: 100, tickSpacing: 1, label: '0.01%', description: 'Stablecoins (USDC/USDT)' },
+    { fee: 500, tickSpacing: 10, label: '0.05%', description: 'Correlated pairs (ETH/stETH)' },
+    { fee: 3000, tickSpacing: 60, label: '0.30%', description: 'Most pairs (default)' },
+    { fee: 10000, tickSpacing: 200, label: '1.00%', description: 'Exotic / volatile pairs' },
+];
+/** Get the default fee tier for a given pair type. */
+export function getDefaultFeeTier(pairType = 'major') {
+    switch (pairType) {
+        case 'stable': return FEE_TIERS[0];
+        case 'correlated': return FEE_TIERS[1];
+        case 'major': return FEE_TIERS[2];
+        case 'volatile': return FEE_TIERS[3];
+    }
+}
+//# sourceMappingURL=uniswap-chains.js.map

package/dist/uniswap-chains.js.map

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

package/dist/uniswap-quoter.d.ts

@@ -0,0 +1,178 @@
+/**
+ * UniswapQuoter — On-chain V4 quote simulation + price impact estimation.
+ *
+ * Uses the deployed V4 Quoter contract to simulate swaps without executing
+ * them. This works even without a Trading API key — it's purely on-chain.
+ *
+ * Supports:
+ *   - Single-pool exact input/output quotes
+ *   - Price impact calculation
+ *   - Pool discovery for Clawncher tokens
+ *   - Multi-chain via uniswap-chains registry
+ *
+ * @see https://docs.uniswap.org/contracts/v4/reference/periphery/interfaces/IQuoter
+ */
+import { type Address, type PublicClient } from 'viem';
+import type { NetworkName } from './addresses.js';
+import { type TokenRewardInfo } from './reader.js';
+export interface QuoterConfig {
+    /** Public client for the target chain */
+    publicClient: PublicClient;
+    /** Chain ID (default: 8453 = Base) */
+    chainId?: number;
+    /** Network name for Base-specific address lookups (default: 'mainnet') */
+    network?: NetworkName;
+}
+export interface PoolKey {
+    currency0: Address;
+    currency1: Address;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+}
+export interface QuoteParams {
+    /** Pool key to quote through */
+    poolKey: PoolKey;
+    /** Whether selling currency0 for currency1 (true) or vice versa (false) */
+    zeroForOne: boolean;
+    /** Amount to swap (raw units) */
+    amount: bigint;
+    /** Optional sqrt price limit (default: 0 = no limit) */
+    sqrtPriceLimitX96?: bigint;
+    /** Hook data (default: '0x') */
+    hookData?: `0x${string}`;
+}
+export interface QuoteResult {
+    /** Quoted output amount (for exact input) or input amount (for exact output) */
+    quotedAmount: bigint;
+    /** Estimated gas for the swap */
+    gasEstimate: bigint;
+    /** Computed price impact (requires pool state read) */
+    priceImpact: number | null;
+    /** Current pool price (token1/token0 ratio) before the swap */
+    currentPrice: number | null;
+    /** Estimated price after the swap */
+    priceAfterSwap: number | null;
+}
+export interface PoolState {
+    sqrtPriceX96: bigint;
+    tick: number;
+    liquidity: bigint;
+    protocolFee: number;
+    lpFee: number;
+}
+export declare class UniswapQuoter {
+    private readonly publicClient;
+    private readonly chainId;
+    private readonly network;
+    private readonly chainConfig;
+    constructor(config: QuoterConfig);
+    /** Get the V4 Quoter address for the current chain */
+    private getQuoterAddress;
+    /** Get the StateView address for the current chain */
+    private getStateViewAddress;
+    /**
+     * Read current pool state from StateView.
+     */
+    getPoolState(poolKey: PoolKey): Promise<PoolState>;
+    /**
+     * Compute pool ID from pool key (keccak256 of abi-encoded key).
+     */
+    computePoolId(poolKey: PoolKey): Promise<`0x${string}`>;
+    /**
+     * Quote an exact input swap (sell a fixed amount, get variable output).
+     *
+     * Uses the V4 Quoter's `quoteExactInputSingle` via `eth_call` simulation.
+     * The Quoter intentionally reverts with the result — viem handles this
+     * via `simulateContract` or we catch the revert.
+     */
+    quoteExactInput(params: QuoteParams): Promise<QuoteResult>;
+    /**
+     * Quote an exact output swap (buy a fixed amount, pay variable input).
+     */
+    quoteExactOutput(params: QuoteParams): Promise<QuoteResult>;
+    /**
+     * Calculate price impact for a swap.
+     *
+     * Price impact = (executionPrice - marketPrice) / marketPrice
+     *
+     * For exact input: executionPrice = amountOut / amountIn
+     * Market price comes from current pool sqrtPriceX96.
+     */
+    private calculatePriceImpact;
+    /**
+     * Get estimated price impact without executing a full quote.
+     *
+     * Uses the simplified formula:
+     *   impact ≈ amountIn / (2 * liquidityInPool)
+     *
+     * This is a rough estimate — use quoteExactInput for precision.
+     */
+    estimatePriceImpact(poolKey: PoolKey, amountIn: bigint): Promise<number>;
+    /** Convert sqrtPriceX96 to a float price (token1/token0) */
+    sqrtPriceX96ToPrice(sqrtPriceX96: bigint): number;
+    /** Convert a float price to sqrtPriceX96 */
+    priceToSqrtPriceX96(price: number): bigint;
+    /**
+     * Check if a pool exists and has liquidity.
+     */
+    isPoolActive(poolKey: PoolKey): Promise<boolean>;
+    /**
+     * Get the WETH address for the current chain.
+     */
+    getWethAddress(): Address;
+    /**
+     * Build a pool key for a token paired with WETH.
+     *
+     * Automatically sorts currency0/currency1 (lower address first).
+     */
+    buildWethPoolKey(token: Address, fee?: number, tickSpacing?: number, hooks?: Address): PoolKey;
+    /**
+     * Determine if selling token for WETH requires zeroForOne or oneForZero.
+     */
+    isTokenCurrency0(token: Address): boolean;
+    /**
+     * Build a pool key for a Clawnch token by reading its deployment data
+     * from the LP locker contract.
+     *
+     * This is the SDK's killer feature — Clawnch tokens have their pool key
+     * (including the correct hook address) stored on-chain in the LP locker.
+     * No manual configuration needed. This works for ANY token deployed
+     * through Clawnch, including tokens with MEV hooks, custom fee tiers,
+     * and non-standard tick spacings.
+     *
+     * Falls back to `buildWethPoolKey()` (zero hook, 3000 fee) if the token
+     * is not a Clawnch token.
+     *
+     * @param token - Token address (must be on Base)
+     * @returns Pool key with correct hook, fee, and tick spacing
+     */
+    buildPoolKeyFromToken(token: Address): Promise<PoolKey>;
+    /**
+     * Get the full token reward info from the Clawnch LP locker.
+     *
+     * Returns null if the token wasn't deployed through Clawnch.
+     */
+    getTokenRewards(token: Address): Promise<TokenRewardInfo | null>;
+    /**
+     * One-call quote for any Clawnch token: auto-discovers pool key,
+     * determines swap direction, and returns the quote.
+     *
+     * This replaces the 3-step manual flow of:
+     *   1. Get pool key from LP locker
+     *   2. Determine zeroForOne from WETH position
+     *   3. Call quoteExactInput
+     *
+     * @param token - Clawnch token address
+     * @param ethAmount - ETH amount to swap (raw units)
+     * @param direction - 'buy' (ETH→Token) or 'sell' (Token→ETH)
+     */
+    quoteClawnchToken(token: Address, ethAmount: bigint, direction?: 'buy' | 'sell'): Promise<QuoteResult & {
+        poolKey: PoolKey;
+    }>;
+    /**
+     * Try to parse a quoter revert (the V4 quoter reverts with encoded results).
+     */
+    private parseQuoterRevert;
+}
+//# sourceMappingURL=uniswap-quoter.d.ts.map

package/dist/uniswap-quoter.d.ts.map

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