@mania-labs/mania-sdk 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -411,6 +411,15 @@ declare class ManiaSDK {
      * @param token - Token address
      */
     getTokenInfo(token: Address): Promise<TokenInfo>;
+    /**
+     * Get token name and symbol
+     *
+     * @param token - Token address
+     */
+    getTokenMetadata(token: Address): Promise<{
+        name: string;
+        symbol: string;
+    }>;
     /**
      * Get buy quote from contract
      *
@@ -548,6 +557,36 @@ declare class ManiaSDK {
      * Get the wallet client
      */
     getWalletClient(): WalletClient | null;
+    /**
+     * Get chain config or throw if not found
+     */
+    private getChainConfigOrThrow;
+    /**
+     * Get quote for buying tokens with ETH on Kumbaya DEX (Uniswap V3)
+     * Use this for tokens that have migrated from the bonding curve
+     *
+     * @param token - Token address
+     * @param ethAmount - ETH amount in wei
+     * @returns Token amount out
+     */
+    getMigratedBuyQuote(token: Address, ethAmount: bigint): Promise<bigint>;
+    /**
+     * Get quote for selling tokens for ETH on Kumbaya DEX (Uniswap V3)
+     * Use this for tokens that have migrated from the bonding curve
+     *
+     * @param token - Token address
+     * @param tokenAmount - Token amount to sell
+     * @returns ETH amount out in wei
+     */
+    getMigratedSellQuote(token: Address, tokenAmount: bigint): Promise<bigint>;
+    /**
+     * Get the Uniswap V3 pool address for a token/WETH pair
+     *
+     * @param token - Token address
+     * @returns Pool address
+     * @throws Error if pool not found
+     */
+    getPoolAddress(token: Address): Promise<Address>;
 }
 
 /**
@@ -587,6 +626,7 @@ interface ChainConfig {
     wethAddress: Address;
     nonfungiblePositionManager: Address;
     uniswapV3Factory: Address;
+    quoterV2: Address;
     blockExplorer: string;
 }
 /**
@@ -1026,6 +1066,238 @@ declare const MANIA_FACTORY_ABI: readonly [{
     }];
     readonly anonymous: false;
 }];
+declare const QUOTER_V2_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "_factory";
+        readonly type: "address";
+    }, {
+        readonly internalType: "address";
+        readonly name: "_WETH9";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "constructor";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "WETH9";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "factory";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes";
+        readonly name: "path";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }];
+    readonly name: "quoteExactInput";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint160[]";
+        readonly name: "sqrtPriceX96AfterList";
+        readonly type: "uint160[]";
+    }, {
+        readonly internalType: "uint32[]";
+        readonly name: "initializedTicksCrossedList";
+        readonly type: "uint32[]";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "tokenIn";
+            readonly type: "address";
+        }, {
+            readonly internalType: "address";
+            readonly name: "tokenOut";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "amountIn";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint24";
+            readonly name: "fee";
+            readonly type: "uint24";
+        }, {
+            readonly internalType: "uint160";
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
+        readonly internalType: "struct IQuoterV2.QuoteExactInputSingleParams";
+        readonly name: "params";
+        readonly type: "tuple";
+    }];
+    readonly name: "quoteExactInputSingle";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint160";
+        readonly name: "sqrtPriceX96After";
+        readonly type: "uint160";
+    }, {
+        readonly internalType: "uint32";
+        readonly name: "initializedTicksCrossed";
+        readonly type: "uint32";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes";
+        readonly name: "path";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }];
+    readonly name: "quoteExactOutput";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint160[]";
+        readonly name: "sqrtPriceX96AfterList";
+        readonly type: "uint160[]";
+    }, {
+        readonly internalType: "uint32[]";
+        readonly name: "initializedTicksCrossedList";
+        readonly type: "uint32[]";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "tokenIn";
+            readonly type: "address";
+        }, {
+            readonly internalType: "address";
+            readonly name: "tokenOut";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "amount";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint24";
+            readonly name: "fee";
+            readonly type: "uint24";
+        }, {
+            readonly internalType: "uint160";
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
+        readonly internalType: "struct IQuoterV2.QuoteExactOutputSingleParams";
+        readonly name: "params";
+        readonly type: "tuple";
+    }];
+    readonly name: "quoteExactOutputSingle";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint160";
+        readonly name: "sqrtPriceX96After";
+        readonly type: "uint160";
+    }, {
+        readonly internalType: "uint32";
+        readonly name: "initializedTicksCrossed";
+        readonly type: "uint32";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "int256";
+        readonly name: "amount0Delta";
+        readonly type: "int256";
+    }, {
+        readonly internalType: "int256";
+        readonly name: "amount1Delta";
+        readonly type: "int256";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "path";
+        readonly type: "bytes";
+    }];
+    readonly name: "uniswapV3SwapCallback";
+    readonly outputs: readonly [];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}];
+declare const UNISWAP_V3_FACTORY_ABI: readonly [{
+    readonly inputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "constructor";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "tokenA";
+        readonly type: "address";
+    }, {
+        readonly internalType: "address";
+        readonly name: "tokenB";
+        readonly type: "address";
+    }, {
+        readonly internalType: "uint24";
+        readonly name: "fee";
+        readonly type: "uint24";
+    }];
+    readonly name: "getPool";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}];
 declare const ERC20_ABI: readonly [{
     readonly type: "function";
     readonly name: "name";
@@ -1113,4 +1385,4 @@ declare const ERC20_ABI: readonly [{
     readonly stateMutability: "nonpayable";
 }];
 
-export { BPS_DENOMINATOR, BondingCurve, type BondingCurveState, type BuyParams, type BuyQuote, CHAIN_CONFIGS, CREATOR_FEE_BASIS_POINTS, type ChainConfig, type CompleteEvent, type CreateAndBuyParams, type CreateEvent, type CreateTokenParams, DEFAULT_SLIPPAGE_BPS, ERC20_ABI, type GlobalState, MANIA_FACTORY_ABI, MAX_FEE_BASIS_POINTS, MAX_MIGRATE_FEES, MIGRATION_THRESHOLD, ManiaSDK, type ManiaSDKConfig, type MigrateParams, type MigrationEvent, PROTOCOL_FEE_BASIS_POINTS, type SellParams, type SellQuote, type SetParamsInput, type SlippageConfig, TICK_LOWER, TICK_UPPER, TOKENS_FOR_LP, TOTAL_FEE_BASIS_POINTS, type TokenInfo, type TradeEvent, type TransactionResult, UNISWAP_FEE_TIER, bpsToPercent, calculateBuyAmount, calculateMigrationProgress, calculatePriceImpact, calculateSellAmount, calculateWithSlippage, formatEthValue, formatMarketCap, formatPrice, formatTokenAmount, getChainConfig, isValidAddress, parseEthValue, percentToBps, sleep, truncateAddress, withRetry };
+export { BPS_DENOMINATOR, BondingCurve, type BondingCurveState, type BuyParams, type BuyQuote, CHAIN_CONFIGS, CREATOR_FEE_BASIS_POINTS, type ChainConfig, type CompleteEvent, type CreateAndBuyParams, type CreateEvent, type CreateTokenParams, DEFAULT_SLIPPAGE_BPS, ERC20_ABI, type GlobalState, MANIA_FACTORY_ABI, MAX_FEE_BASIS_POINTS, MAX_MIGRATE_FEES, MIGRATION_THRESHOLD, ManiaSDK, type ManiaSDKConfig, type MigrateParams, type MigrationEvent, PROTOCOL_FEE_BASIS_POINTS, QUOTER_V2_ABI, type SellParams, type SellQuote, type SetParamsInput, type SlippageConfig, TICK_LOWER, TICK_UPPER, TOKENS_FOR_LP, TOTAL_FEE_BASIS_POINTS, type TokenInfo, type TradeEvent, type TransactionResult, UNISWAP_FEE_TIER, UNISWAP_V3_FACTORY_ABI, bpsToPercent, calculateBuyAmount, calculateMigrationProgress, calculatePriceImpact, calculateSellAmount, calculateWithSlippage, formatEthValue, formatMarketCap, formatPrice, formatTokenAmount, getChainConfig, isValidAddress, parseEthValue, percentToBps, sleep, truncateAddress, withRetry };

package/dist/index.js

@@ -32,11 +32,13 @@ __export(index_exports, {
   MIGRATION_THRESHOLD: () => MIGRATION_THRESHOLD,
   ManiaSDK: () => ManiaSDK,
   PROTOCOL_FEE_BASIS_POINTS: () => PROTOCOL_FEE_BASIS_POINTS,
+  QUOTER_V2_ABI: () => QUOTER_V2_ABI,
   TICK_LOWER: () => TICK_LOWER,
   TICK_UPPER: () => TICK_UPPER,
   TOKENS_FOR_LP: () => TOKENS_FOR_LP,
   TOTAL_FEE_BASIS_POINTS: () => TOTAL_FEE_BASIS_POINTS,
   UNISWAP_FEE_TIER: () => UNISWAP_FEE_TIER,
+  UNISWAP_V3_FACTORY_ABI: () => UNISWAP_V3_FACTORY_ABI,
   bpsToPercent: () => bpsToPercent,
   calculateBuyAmount: () => calculateBuyAmount,
   calculateMigrationProgress: () => calculateMigrationProgress,
@@ -83,6 +85,7 @@ var CHAIN_CONFIGS = {
     wethAddress: "0x4200000000000000000000000000000000000006",
     nonfungiblePositionManager: "0xa204A97EF8Bd2E3198f19EB5a804680467BD85f5",
     uniswapV3Factory: "0x619fb6C12c36b57a8bAb05e98F42C43745DCf69f",
+    quoterV2: "0xfb230b93803F90238cB03f254452bA3a3b0Ec38d",
     blockExplorer: "https://megaeth-testnet-v2.blockscout.com"
   },
   // Mega Eth Mainnet
@@ -93,6 +96,7 @@ var CHAIN_CONFIGS = {
     wethAddress: "0x4200000000000000000000000000000000000006",
     nonfungiblePositionManager: "0x2b781C57e6358f64864Ff8EC464a03Fdaf9974bA",
     uniswapV3Factory: "0x68b34591f662508076927803c567Cc8006988a09",
+    quoterV2: "0x1F1a8dC7E138C34b503Ca080962aC10B75384a27",
     blockExplorer: "https://megaeth.blockscout.com/"
   }
 };
@@ -518,6 +522,139 @@ var MANIA_FACTORY_ABI = [
     anonymous: false
   }
 ];
+var QUOTER_V2_ABI = [
+  {
+    inputs: [
+      { internalType: "address", name: "_factory", type: "address" },
+      { internalType: "address", name: "_WETH9", type: "address" }
+    ],
+    stateMutability: "nonpayable",
+    type: "constructor"
+  },
+  {
+    inputs: [],
+    name: "WETH9",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "factory",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes", name: "path", type: "bytes" },
+      { internalType: "uint256", name: "amountIn", type: "uint256" }
+    ],
+    name: "quoteExactInput",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" },
+      { internalType: "uint160[]", name: "sqrtPriceX96AfterList", type: "uint160[]" },
+      { internalType: "uint32[]", name: "initializedTicksCrossedList", type: "uint32[]" },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "uint160", name: "sqrtPriceLimitX96", type: "uint160" }
+        ],
+        internalType: "struct IQuoterV2.QuoteExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "quoteExactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" },
+      { internalType: "uint160", name: "sqrtPriceX96After", type: "uint160" },
+      { internalType: "uint32", name: "initializedTicksCrossed", type: "uint32" },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes", name: "path", type: "bytes" },
+      { internalType: "uint256", name: "amountOut", type: "uint256" }
+    ],
+    name: "quoteExactOutput",
+    outputs: [
+      { internalType: "uint256", name: "amountIn", type: "uint256" },
+      { internalType: "uint160[]", name: "sqrtPriceX96AfterList", type: "uint160[]" },
+      { internalType: "uint32[]", name: "initializedTicksCrossedList", type: "uint32[]" },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint256", name: "amount", type: "uint256" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "uint160", name: "sqrtPriceLimitX96", type: "uint160" }
+        ],
+        internalType: "struct IQuoterV2.QuoteExactOutputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "quoteExactOutputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountIn", type: "uint256" },
+      { internalType: "uint160", name: "sqrtPriceX96After", type: "uint160" },
+      { internalType: "uint32", name: "initializedTicksCrossed", type: "uint32" },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "int256", name: "amount0Delta", type: "int256" },
+      { internalType: "int256", name: "amount1Delta", type: "int256" },
+      { internalType: "bytes", name: "path", type: "bytes" }
+    ],
+    name: "uniswapV3SwapCallback",
+    outputs: [],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+var UNISWAP_V3_FACTORY_ABI = [
+  {
+    inputs: [],
+    stateMutability: "nonpayable",
+    type: "constructor"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "tokenA", type: "address" },
+      { internalType: "address", name: "tokenB", type: "address" },
+      { internalType: "uint24", name: "fee", type: "uint24" }
+    ],
+    name: "getPool",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
 var ERC20_ABI = [
   {
     type: "function",
@@ -737,7 +874,7 @@ var ManiaSDK = class _ManiaSDK {
   }
   /**
    * Get comprehensive token information
-   * 
+   *
    * @param token - Token address
    */
   async getTokenInfo(token) {
@@ -751,6 +888,18 @@ var ManiaSDK = class _ManiaSDK {
       migrationProgress: curve.getMigrationProgress()
     };
   }
+  /**
+   * Get token name and symbol
+   *
+   * @param token - Token address
+   */
+  async getTokenMetadata(token) {
+    const [name, symbol] = await Promise.all([
+      this.publicClient.readContract({ address: token, abi: ERC20_ABI, functionName: "name" }),
+      this.publicClient.readContract({ address: token, abi: ERC20_ABI, functionName: "symbol" })
+    ]);
+    return { name, symbol };
+  }
   /**
    * Get buy quote from contract
    * 
@@ -1105,6 +1254,85 @@ var ManiaSDK = class _ManiaSDK {
   getWalletClient() {
     return this.walletClient;
   }
+  // ========== MIGRATED TOKEN METHODS ==========
+  /**
+   * Get chain config or throw if not found
+   */
+  getChainConfigOrThrow() {
+    const config = getChainConfig(this.chainId);
+    if (!config) {
+      throw new Error(`Chain config not found for chain ID: ${this.chainId}`);
+    }
+    return config;
+  }
+  /**
+   * Get quote for buying tokens with ETH on Kumbaya DEX (Uniswap V3)
+   * Use this for tokens that have migrated from the bonding curve
+   *
+   * @param token - Token address
+   * @param ethAmount - ETH amount in wei
+   * @returns Token amount out
+   */
+  async getMigratedBuyQuote(token, ethAmount) {
+    const chainConfig = this.getChainConfigOrThrow();
+    const { result } = await this.publicClient.simulateContract({
+      address: chainConfig.quoterV2,
+      abi: QUOTER_V2_ABI,
+      functionName: "quoteExactInputSingle",
+      args: [{
+        tokenIn: chainConfig.wethAddress,
+        tokenOut: token,
+        amountIn: ethAmount,
+        fee: UNISWAP_FEE_TIER,
+        sqrtPriceLimitX96: 0n
+      }]
+    });
+    return result[0];
+  }
+  /**
+   * Get quote for selling tokens for ETH on Kumbaya DEX (Uniswap V3)
+   * Use this for tokens that have migrated from the bonding curve
+   *
+   * @param token - Token address
+   * @param tokenAmount - Token amount to sell
+   * @returns ETH amount out in wei
+   */
+  async getMigratedSellQuote(token, tokenAmount) {
+    const chainConfig = this.getChainConfigOrThrow();
+    const { result } = await this.publicClient.simulateContract({
+      address: chainConfig.quoterV2,
+      abi: QUOTER_V2_ABI,
+      functionName: "quoteExactInputSingle",
+      args: [{
+        tokenIn: token,
+        tokenOut: chainConfig.wethAddress,
+        amountIn: tokenAmount,
+        fee: UNISWAP_FEE_TIER,
+        sqrtPriceLimitX96: 0n
+      }]
+    });
+    return result[0];
+  }
+  /**
+   * Get the Uniswap V3 pool address for a token/WETH pair
+   *
+   * @param token - Token address
+   * @returns Pool address
+   * @throws Error if pool not found
+   */
+  async getPoolAddress(token) {
+    const chainConfig = this.getChainConfigOrThrow();
+    const poolAddress = await this.publicClient.readContract({
+      address: chainConfig.uniswapV3Factory,
+      abi: UNISWAP_V3_FACTORY_ABI,
+      functionName: "getPool",
+      args: [token, chainConfig.wethAddress, UNISWAP_FEE_TIER]
+    });
+    if (poolAddress === "0x0000000000000000000000000000000000000000") {
+      throw new Error(`Pool not found for token ${token}`);
+    }
+    return poolAddress;
+  }
 };
 
 // src/utils.ts
@@ -1210,11 +1438,13 @@ async function withRetry(fn, maxRetries = 3, baseDelayMs = 1e3) {
   MIGRATION_THRESHOLD,
   ManiaSDK,
   PROTOCOL_FEE_BASIS_POINTS,
+  QUOTER_V2_ABI,
   TICK_LOWER,
   TICK_UPPER,
   TOKENS_FOR_LP,
   TOTAL_FEE_BASIS_POINTS,
   UNISWAP_FEE_TIER,
+  UNISWAP_V3_FACTORY_ABI,
   bpsToPercent,
   calculateBuyAmount,
   calculateMigrationProgress,