levr-sdk 0.0.1 → 0.1.0

package/dist/esm/usd-price.js

@@ -0,0 +1,149 @@
+import { formatUnits, parseUnits } from "viem";
+import { GET_USDC_ADDRESS, UNISWAP_V3_QUOTER_V2, WETH } from "./constants.js";
+import { createPoolKey } from "./pool-key.js";
+import { quote } from "./quote/index.js";
+/**
+ * @description Get the USD price of WETH from a WETH/USDC pool using Uniswap V3
+ *
+ * @param params Parameters for WETH/USD price oracle
+ * @returns WETH price in USD and raw quote data
+ *
+ * @remarks
+ * This function queries Uniswap V3 WETH/USDC pools for accurate pricing.
+ * V3 is used instead of V4 because V3 has much deeper liquidity on most chains.
+ *
+ * The function:
+ * 1. Tries common V3 fee tiers (0.3%, 0.05%, 1%) in order of preference
+ * 2. Quotes 1 WETH to get USDC output
+ * 3. Returns the first successful quote
+ *
+ * This is commonly used as a price oracle for other token pricing calculations.
+ *
+ * @example
+ * ```typescript
+ * // Get current WETH price on Base mainnet
+ * const { priceUsd, fee } = await getWethUsdPrice({
+ *   publicClient: baseMainnetClient,
+ * })
+ * console.log(`WETH price: $${priceUsd} (from ${fee/10000}% pool)`)
+ * ```
+ */
+export const getWethUsdPrice = async ({ publicClient, }) => {
+    // Get chain ID from client
+    const chainId = publicClient.chain?.id;
+    if (!chainId) {
+        throw new Error("Chain ID not found on public client");
+    }
+    // Get V3 Quoter address
+    const quoterAddress = UNISWAP_V3_QUOTER_V2(chainId);
+    if (!quoterAddress) {
+        throw new Error(`V3 Quoter address not found for chain ID ${chainId}`);
+    }
+    // Get WETH and USDC addresses
+    const wethData = WETH(chainId);
+    const usdcAddress = GET_USDC_ADDRESS(chainId);
+    if (!wethData) {
+        throw new Error(`WETH address not found for chain ID ${chainId}`);
+    }
+    if (!usdcAddress) {
+        throw new Error(`USDC address not found for chain ID ${chainId}`);
+    }
+    // V3 fee tiers (in order of preference for WETH/USDC)
+    const V3_FEE_TIERS = [3000, 500, 10000]; // 0.3%, 0.05%, 1%
+    // Try each V3 fee tier
+    for (const fee of V3_FEE_TIERS) {
+        try {
+            const oneWeth = parseUnits("1", wethData.decimals);
+            const quoteResult = await quote.v3.read({
+                publicClient,
+                quoterAddress,
+                tokenIn: wethData.address,
+                tokenOut: usdcAddress,
+                amountIn: oneWeth,
+                fee,
+            });
+            if (quoteResult.amountOut > 0n) {
+                const priceUsd = formatUnits(quoteResult.amountOut, 6);
+                return {
+                    priceUsd,
+                    wethPerUsdc: quoteResult.amountOut,
+                    fee,
+                };
+            }
+        }
+        catch (error) {
+            // This fee tier doesn't work, try next
+            continue;
+        }
+    }
+    throw new Error("No liquid WETH/USDC V3 pool found");
+};
+/**
+ * @description Get the USD price of a token paired with WETH
+ *
+ * @param params Parameters including token addresses and chain config
+ * @returns USD price and intermediate price ratios
+ *
+ * @remarks
+ * This function calculates the USD price of a token by:
+ * 1. Auto-discovering and querying a liquid WETH/USDC pool (oracle chain)
+ * 2. Getting the price of the token in WETH (quote chain)
+ * 3. Multiplying them together to get token price in USD
+ *
+ * The paired token must be WETH, otherwise an error is thrown.
+ * USD pricing always uses USDC as the stable reference.
+ *
+ * This design allows you to:
+ * - Use mainnet for accurate WETH/USDC prices (oracle auto-discovers pool)
+ * - Quote tokens from any chain (testnet, L2, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Get testnet token price using mainnet oracle
+ * const { priceUsd } = await getUsdPrice({
+ *   oraclePublicClient: mainnetClient,
+ *   quotePublicClient: testnetClient,
+ *   tokenAddress: '0x123...',
+ * })
+ * console.log(`Token price: $${priceUsd}`)
+ * ```
+ */
+export const getUsdPrice = async ({ oraclePublicClient, quotePublicClient, tokenAddress, quoteFee, quoteTickSpacing, quoteHooks, }) => {
+    // Get chain ID from quote client
+    const quoteChainId = quotePublicClient.chain?.id;
+    if (!quoteChainId) {
+        throw new Error("Chain ID not found on quote public client");
+    }
+    // Get WETH address for quote chain (token is always paired with WETH)
+    const quoteWethData = WETH(quoteChainId);
+    if (!quoteWethData) {
+        throw new Error(`WETH address not found for quote chain ID ${quoteChainId}`);
+    }
+    // Get WETH/USD price from oracle (automatically discovers best pool)
+    const wethUsdPriceData = await getWethUsdPrice({
+        publicClient: oraclePublicClient,
+    });
+    // Create pool key for token/WETH
+    const tokenWethPoolKey = createPoolKey(tokenAddress, quoteWethData.address, quoteFee, quoteTickSpacing, quoteHooks);
+    // Determine trade direction based on sorted currencies
+    const tokenIsToken0InTokenWethPool = tokenAddress.toLowerCase() < quoteWethData.address.toLowerCase();
+    // Quote 1 token unit -> WETH to get token price in WETH (on quote chain)
+    // Using token decimals (assume 18 if not available)
+    const oneToken = parseUnits("1", 18);
+    const tokenWethQuote = await quote.v4.read({
+        publicClient: quotePublicClient,
+        poolKey: tokenWethPoolKey,
+        zeroForOne: tokenIsToken0InTokenWethPool,
+        amountIn: oneToken,
+    });
+    // WETH has 18 decimals
+    const tokenPriceInWeth = formatUnits(tokenWethQuote.amountOut, 18);
+    // Calculate USD price: (token/WETH) * (WETH/USD) = token/USD
+    const tokenPriceInUsd = parseFloat(tokenPriceInWeth) * parseFloat(wethUsdPriceData.priceUsd);
+    return {
+        priceUsd: tokenPriceInUsd.toFixed(6),
+        tokenPerWeth: tokenWethQuote.amountOut,
+        wethPerUsdc: wethUsdPriceData.wethPerUsdc,
+    };
+};
+//# sourceMappingURL=usd-price.js.map

package/dist/esm/usd-price.js.map

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

package/dist/esm/user.js

@@ -0,0 +1,153 @@
+import { erc20Abi } from "viem";
+import { LevrStaking_v1 } from "./abis/index.js";
+import { formatBalanceWithUsd } from "./balance.js";
+import { WETH } from "./constants.js";
+// ========================================
+// HELPER UTILS (for composition in larger multicalls)
+// ========================================
+/**
+ * Helper: Get balance contracts for multicall composition
+ */
+export function balanceContracts(params) {
+    const contracts = [
+        {
+            address: params.clankerToken,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [params.userAddress],
+        },
+    ];
+    if (params.wethAddress) {
+        contracts.push({
+            address: params.wethAddress,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [params.userAddress],
+        });
+    }
+    return contracts;
+}
+/**
+ * Helper: Get user-specific staking contracts for multicall composition
+ * Pool-level stats (totalStaked, apr, outstandingRewards) now in project.ts
+ */
+export function stakingContracts(params) {
+    const contracts = [
+        {
+            address: params.stakingAddress,
+            abi: LevrStaking_v1,
+            functionName: "stakedBalanceOf",
+            args: [params.userAddress],
+        },
+        {
+            address: params.clankerToken,
+            abi: erc20Abi,
+            functionName: "allowance",
+            args: [params.userAddress, params.stakingAddress],
+        },
+        {
+            address: params.stakingAddress,
+            abi: LevrStaking_v1,
+            functionName: "claimableRewards",
+            args: [params.userAddress, params.clankerToken],
+        },
+        {
+            address: params.stakingAddress,
+            abi: LevrStaking_v1,
+            functionName: "getVotingPower",
+            args: [params.userAddress],
+        },
+    ];
+    if (params.wethAddress) {
+        contracts.push({
+            address: params.stakingAddress,
+            abi: LevrStaking_v1,
+            functionName: "claimableRewards",
+            args: [params.userAddress, params.wethAddress],
+        });
+    }
+    return contracts;
+}
+// ========================================
+// MAIN USER DATA FUNCTION
+// ========================================
+/**
+ * Get all user-related data in a single efficient multicall
+ * Composes balances, staking, and governance data with USD values
+ */
+export async function getUser({ publicClient, userAddress, project }) {
+    if (Object.values({ publicClient, userAddress, project }).some((value) => !value)) {
+        throw new Error("Invalid user params");
+    }
+    const chainId = publicClient.chain?.id;
+    if (!chainId)
+        throw new Error("Chain ID not found on public client");
+    const wethAddress = WETH(chainId)?.address;
+    const { clankerToken, stakingAddress, tokenDecimals, pricing } = {
+        clankerToken: project.token.address,
+        stakingAddress: project.staking,
+        tokenDecimals: project.token.decimals,
+        pricing: project.pricing,
+    };
+    // Build single comprehensive multicall for ALL user data
+    const contracts = [
+        // Balances
+        {
+            address: clankerToken,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [userAddress],
+        },
+    ];
+    if (wethAddress) {
+        contracts.push({
+            address: wethAddress,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [userAddress],
+        });
+    }
+    // Add staking contracts
+    contracts.push(...stakingContracts({ userAddress, stakingAddress, clankerToken, wethAddress }));
+    // Execute single multicall + native balance
+    const [nativeBalance, ...multicallResults] = await Promise.all([
+        publicClient.getBalance({ address: userAddress }),
+        publicClient.multicall({ contracts }),
+    ]);
+    const results = multicallResults[0];
+    // Parse balance results
+    const stakingDataStartIndex = wethAddress ? 2 : 1;
+    const tokenBalanceRaw = results[0].result;
+    const wethBalanceRaw = wethAddress ? results[1].result : 0n;
+    // Parse user-specific staking results (pool stats now in project)
+    const stakedBalance = results[stakingDataStartIndex + 0].result;
+    const allowance = results[stakingDataStartIndex + 1].result;
+    const claimableRewardsToken = results[stakingDataStartIndex + 2].result;
+    const votingPower = results[stakingDataStartIndex + 3].result;
+    // Parse WETH claimable rewards if available
+    const claimableRewardsWeth = wethAddress
+        ? results[stakingDataStartIndex + 4].result
+        : null;
+    // Calculate USD values
+    const tokenPrice = pricing ? parseFloat(pricing.tokenUsd) : null;
+    const wethPrice = pricing ? parseFloat(pricing.wethUsd) : null;
+    return {
+        balances: {
+            token: formatBalanceWithUsd(tokenBalanceRaw, tokenDecimals, tokenPrice),
+            weth: formatBalanceWithUsd(wethBalanceRaw, 18, wethPrice),
+            eth: formatBalanceWithUsd(nativeBalance, 18, wethPrice),
+        },
+        staking: {
+            stakedBalance: formatBalanceWithUsd(stakedBalance, tokenDecimals, tokenPrice),
+            allowance: formatBalanceWithUsd(allowance, tokenDecimals, tokenPrice),
+            claimableRewards: {
+                staking: formatBalanceWithUsd(claimableRewardsToken, tokenDecimals, tokenPrice),
+                weth: claimableRewardsWeth !== null && wethAddress
+                    ? formatBalanceWithUsd(claimableRewardsWeth, 18, wethPrice)
+                    : null,
+            },
+        },
+        votingPower: formatBalanceWithUsd(votingPower, tokenDecimals, tokenPrice),
+    };
+}
+//# sourceMappingURL=user.js.map

package/dist/esm/user.js.map

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

package/dist/esm/util.js

@@ -1,4 +1,48 @@
-import { parseUnits } from 'viem';
+import { createPublicClient, http, parseUnits } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+/**
+ * Default public RPC URLs for common chains
+ */
+const DEFAULT_RPC_URLS = {
+    [base.id]: 'https://mainnet.base.org',
+    [baseSepolia.id]: 'https://sepolia.base.org',
+};
+/**
+ * Get a configured public client for a given chain
+ * @param chainId - The chain ID to connect to
+ * @param rpcUrl - Optional custom RPC URL (falls back to public endpoints)
+ * @returns Configured public client
+ *
+ * @example
+ * ```typescript
+ * // Use default public RPC
+ * const client = getPublicClient(8453)
+ *
+ * // Use custom RPC
+ * const client = getPublicClient(8453, 'https://my-rpc.com')
+ * ```
+ */
+export function getPublicClient(chainId, rpcUrl) {
+    const url = rpcUrl || DEFAULT_RPC_URLS[chainId];
+    if (!url) {
+        throw new Error(`No RPC URL available for chain ID ${chainId}. Please provide rpcUrl parameter.`);
+    }
+    // Get chain config
+    let chain;
+    if (chainId === base.id) {
+        chain = base;
+    }
+    else if (chainId === baseSepolia.id) {
+        chain = baseSepolia;
+    }
+    else {
+        throw new Error(`Unsupported chain ID ${chainId}`);
+    }
+    return createPublicClient({
+        chain,
+        transport: http(url),
+    });
+}
 /**
  * Check if approval is needed for a given amount
  */

package/dist/esm/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAEjC;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,gBAA0C,EAC1C,cAAwC,EACxC,QAAiB;IAEjB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC/E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,MAAM,sBAAsB,GAC1B,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAS,CAAC,CAAA;IACxD,MAAM,oBAAoB,GACxB,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,QAAS,CAAC,CAAA;IAEtD,OAAO,sBAAsB,GAAG,oBAAoB,CAAA;AACtD,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAC3D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI/C;;GAEG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,0BAA0B;IACrC,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,0BAA0B;CAC7C,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAe;IAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,qCAAqC,OAAO,oCAAoC,CACjF,CAAA;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,KAAK,CAAA;IACT,IAAI,OAAO,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,KAAK,WAAW,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,GAAG,WAAW,CAAA;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;KACrB,CAAoB,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,gBAA0C,EAC1C,cAAwC,EACxC,QAAiB;IAEjB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC/E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,MAAM,sBAAsB,GAC1B,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAS,CAAC,CAAA;IACxD,MAAM,oBAAoB,GACxB,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,QAAS,CAAC,CAAA;IAEtD,OAAO,sBAAsB,GAAG,oBAAoB,CAAA;AACtD,CAAC"}

package/dist/types/abis/LevrFactory_v1.d.ts

@@ -141,6 +141,54 @@ declare const _default: readonly [{
         }];
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getProjects";
+    readonly inputs: readonly [{
+        readonly name: "offset";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "limit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "projects";
+        readonly type: "tuple[]";
+        readonly internalType: "struct ILevrFactory_v1.ProjectInfo[]";
+        readonly components: readonly [{
+            readonly name: "clankerToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "project";
+            readonly type: "tuple";
+            readonly internalType: "struct ILevrFactory_v1.Project";
+            readonly components: readonly [{
+                readonly name: "treasury";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "governor";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "staking";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "stakedToken";
+                readonly type: "address";
+                readonly internalType: "address";
+            }];
+        }];
+    }, {
+        readonly name: "total";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "isTrustedForwarder";

package/dist/types/abis/LevrGovernor_v1.d.ts

@@ -138,6 +138,18 @@ declare const _default: readonly [{
             readonly name: "cycleId";
             readonly type: "uint256";
             readonly internalType: "uint256";
+        }, {
+            readonly name: "state";
+            readonly type: "uint8";
+            readonly internalType: "enum ILevrGovernor_v1.ProposalState";
+        }, {
+            readonly name: "meetsQuorum";
+            readonly type: "bool";
+            readonly internalType: "bool";
+        }, {
+            readonly name: "meetsApproval";
+            readonly type: "bool";
+            readonly internalType: "bool";
         }];
     }];
     readonly stateMutability: "view";
@@ -186,24 +198,6 @@ declare const _default: readonly [{
         }];
     }];
     readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "getVotingPowerSnapshot";
-    readonly inputs: readonly [{
-        readonly name: "proposalId";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "user";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "getWinner";

package/dist/types/abis/LevrStaking_v1.d.ts

@@ -322,7 +322,11 @@ declare const _default: readonly [{
         readonly type: "address";
         readonly internalType: "address";
     }];
-    readonly outputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "newVotingPower";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "event";