levr-sdk 0.0.1

package/dist/esm/project.js

@@ -0,0 +1,146 @@
+import { erc20Abi, formatUnits, zeroAddress } from "viem";
+import { IClankerLPLocker, IClankerToken, LevrFactory_v1 } from "./abis/index.js";
+import { GET_LP_LOCKER_ADDRESS } from "./constants.js";
+/**
+ * Get project data for a clanker token
+ */
+export async function project({ publicClient, factoryAddress, chainId, clankerToken, }) {
+    if (Object.values({ publicClient, factoryAddress, chainId, clankerToken }).some((value) => !value)) {
+        throw new Error("Invalid project params");
+    }
+    const { treasury, governor, staking, stakedToken } = await publicClient.readContract({
+        address: factoryAddress,
+        abi: LevrFactory_v1,
+        functionName: "getProjectContracts",
+        args: [clankerToken],
+    });
+    if ([treasury, governor, staking, stakedToken].some((a) => a === zeroAddress))
+        return null;
+    // Fetch token metadata, forwarder, and treasury stats using multicall
+    const [decimals, name, symbol, totalSupply, metadata, imageUrl, forwarder, treasuryBalance, stakingBalance,] = await publicClient.multicall({
+        contracts: [
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "decimals",
+            },
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "name",
+            },
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "symbol",
+            },
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "totalSupply",
+            },
+            {
+                address: clankerToken,
+                abi: IClankerToken,
+                functionName: "metadata",
+            },
+            {
+                address: clankerToken,
+                abi: IClankerToken,
+                functionName: "imageUrl",
+            },
+            {
+                address: factoryAddress,
+                abi: LevrFactory_v1,
+                functionName: "trustedForwarder",
+            },
+            // Treasury stats
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "balanceOf",
+                args: [treasury],
+            },
+            {
+                address: clankerToken,
+                abi: erc20Abi,
+                functionName: "balanceOf",
+                args: [staking],
+            },
+        ],
+    });
+    // Parse metadata JSON
+    let parsedMetadata = null;
+    if (metadata.result && typeof metadata.result === "string") {
+        try {
+            parsedMetadata = JSON.parse(metadata.result);
+        }
+        catch {
+            // If parsing fails, leave as null
+        }
+    }
+    // Extract pool information from LP locker
+    let poolInfo;
+    try {
+        const lpLockerAddress = GET_LP_LOCKER_ADDRESS(chainId);
+        if (lpLockerAddress) {
+            // Get actual pool key from token rewards in LP locker
+            const tokenRewards = await publicClient.readContract({
+                address: lpLockerAddress,
+                abi: IClankerLPLocker,
+                functionName: "tokenRewards",
+                args: [clankerToken],
+            });
+            const poolKey = tokenRewards.poolKey;
+            poolInfo = {
+                poolKey,
+                feeDisplay: poolKey.fee === 8388608 ? "Dynamic" : `${(poolKey.fee / 10000).toFixed(2)}%`,
+                numPositions: tokenRewards.numPositions,
+            };
+        }
+    }
+    catch {
+        // If reading fails (e.g., token not deployed through Clanker), poolInfo remains undefined
+    }
+    // Calculate treasury stats
+    const tokenDecimals = decimals.result;
+    const treasuryBalanceRaw = treasuryBalance.result;
+    const stakingBalanceRaw = stakingBalance.result;
+    const totalSupplyRaw = totalSupply.result;
+    // Total allocated = treasury + staking balances (protocol-controlled tokens)
+    const totalAllocatedRaw = treasuryBalanceRaw + stakingBalanceRaw;
+    // Utilization = (total allocated / total supply) * 100
+    const utilization = totalSupplyRaw > 0n
+        ? Number((totalAllocatedRaw * 10000n) / totalSupplyRaw) / 100 // Convert to percentage
+        : 0;
+    const treasuryStats = {
+        balance: {
+            raw: treasuryBalanceRaw,
+            formatted: formatUnits(treasuryBalanceRaw, tokenDecimals),
+        },
+        totalAllocated: {
+            raw: totalAllocatedRaw,
+            formatted: formatUnits(totalAllocatedRaw, tokenDecimals),
+        },
+        utilization,
+    };
+    return {
+        treasury,
+        governor,
+        staking,
+        stakedToken,
+        forwarder: forwarder.result,
+        token: {
+            address: clankerToken,
+            decimals: tokenDecimals,
+            name: name.result,
+            symbol: symbol.result,
+            totalSupply: totalSupplyRaw,
+            metadata: parsedMetadata,
+            imageUrl: imageUrl.result,
+        },
+        pool: poolInfo,
+        treasuryStats,
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/esm/project.js.map

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

package/dist/esm/projects.js

@@ -0,0 +1,212 @@
+import { erc20Abi, formatUnits, zeroAddress } from "viem";
+import { IClankerToken, LevrFactory_v1 } from "./abis/index.js";
+import { WETH } from "./constants.js";
+const registeredEvent = LevrFactory_v1.find((item) => item.type === "event" && item.name === "Registered");
+/**
+ * Get multiple projects data
+ */
+export async function projects({ publicClient, factoryAddress, chainId, fromBlock, toBlock = "latest", pageSize = 100, }) {
+    if (Object.values({ publicClient, factoryAddress, chainId }).some((value) => !value)) {
+        throw new Error("Invalid projects params");
+    }
+    // Determine block range
+    const latestBlock = await publicClient.getBlockNumber();
+    const from = fromBlock ?? latestBlock - latestBlock / 10n; // Default to last 10% of blocks
+    const to = toBlock === "latest" ? latestBlock : toBlock;
+    // Fetch Registered events - indexed events are efficient even across large ranges
+    const allLogs = (await publicClient.getLogs({
+        address: factoryAddress,
+        event: registeredEvent,
+        fromBlock: from,
+        toBlock: to,
+    }));
+    // Sort by block number descending (most recent first)
+    const logs = allLogs.sort((a, b) => {
+        if (a.blockNumber > b.blockNumber)
+            return -1;
+        if (a.blockNumber < b.blockNumber)
+            return 1;
+        return 0;
+    });
+    // Limit to pageSize
+    const limitedLogs = logs.slice(0, pageSize);
+    if (limitedLogs.length === 0) {
+        return {
+            projects: [],
+            fromBlock: from,
+            toBlock: to,
+        };
+    }
+    // Extract unique clanker tokens
+    const clankerTokens = limitedLogs.map((log) => log.args.clankerToken);
+    // First, get project contracts for all tokens
+    const projectContracts = await publicClient.multicall({
+        contracts: clankerTokens.map((token) => ({
+            address: factoryAddress,
+            abi: LevrFactory_v1,
+            functionName: "getProjectContracts",
+            args: [token],
+        })),
+    });
+    // Filter out unregistered projects and prepare valid tokens with their contracts
+    const validTokensWithContracts = clankerTokens
+        .map((token, index) => {
+        const projectResult = projectContracts[index].result;
+        if ([
+            projectResult.treasury,
+            projectResult.governor,
+            projectResult.staking,
+            projectResult.stakedToken,
+        ].some((a) => a === zeroAddress)) {
+            return null;
+        }
+        return { token, contracts: projectResult };
+    })
+        .filter(Boolean);
+    if (validTokensWithContracts.length === 0) {
+        return {
+            projects: [],
+            fromBlock: from,
+            toBlock: to,
+        };
+    }
+    // Batch fetch all token metadata and treasury stats
+    const contracts = validTokensWithContracts.flatMap(({ token, contracts }) => [
+        // Token metadata
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "decimals",
+        },
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "name",
+        },
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "symbol",
+        },
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "totalSupply",
+        },
+        {
+            address: token,
+            abi: IClankerToken,
+            functionName: "metadata",
+        },
+        {
+            address: token,
+            abi: IClankerToken,
+            functionName: "imageUrl",
+        },
+        // Treasury stats
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [contracts.treasury],
+        },
+        {
+            address: token,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [contracts.staking],
+        },
+    ]);
+    const results = await publicClient.multicall({ contracts });
+    // Parse results into Project objects
+    const projects = [];
+    const callsPerProject = 8; // Updated to include treasury and staking balance
+    for (let i = 0; i < validTokensWithContracts.length; i++) {
+        const { token, contracts: projectContracts } = validTokensWithContracts[i];
+        const offset = i * callsPerProject;
+        const decimals = results[offset].result;
+        const name = results[offset + 1].result;
+        const symbol = results[offset + 2].result;
+        const totalSupply = results[offset + 3].result;
+        const metadataStr = results[offset + 4].result;
+        const imageUrl = results[offset + 5].result;
+        const treasuryBalance = results[offset + 6].result;
+        const stakingBalance = results[offset + 7].result;
+        // Parse metadata JSON
+        let parsedMetadata = null;
+        if (metadataStr) {
+            try {
+                parsedMetadata = JSON.parse(metadataStr);
+            }
+            catch {
+                // If parsing fails, leave as null
+            }
+        }
+        // Calculate treasury stats
+        const totalAllocated = treasuryBalance + stakingBalance;
+        const utilization = totalSupply > 0n
+            ? Number((totalAllocated * 10000n) / totalSupply) / 100 // Convert to percentage
+            : 0;
+        const treasuryStats = {
+            balance: {
+                raw: treasuryBalance,
+                formatted: formatUnits(treasuryBalance, decimals),
+            },
+            totalAllocated: {
+                raw: totalAllocated,
+                formatted: formatUnits(totalAllocated, decimals),
+            },
+            utilization,
+        };
+        // Extract pool information
+        // Clanker V4 tokens are always paired with WETH and use the token as the hook
+        let poolInfo;
+        try {
+            const wethAddress = WETH(chainId)?.address;
+            if (wethAddress) {
+                // Determine currency ordering (currency0 < currency1)
+                const isTokenCurrency0 = token.toLowerCase() < wethAddress.toLowerCase();
+                // Standard Clanker V4 pool configuration
+                const fee = 3000; // 0.3% fee
+                const tickSpacing = 60;
+                poolInfo = {
+                    poolKey: {
+                        currency0: isTokenCurrency0 ? token : wethAddress,
+                        currency1: isTokenCurrency0 ? wethAddress : token,
+                        fee,
+                        tickSpacing,
+                        hooks: token, // Token acts as the hook in Clanker V4
+                    },
+                    feeDisplay: `${(fee / 10000).toFixed(2)}%`,
+                    numPositions: 0n, // Would need separate query for actual count
+                };
+            }
+        }
+        catch {
+            // If construction fails, poolInfo remains undefined
+        }
+        projects.push({
+            treasury: projectContracts.treasury,
+            governor: projectContracts.governor,
+            staking: projectContracts.staking,
+            stakedToken: projectContracts.stakedToken,
+            token: {
+                address: token,
+                decimals,
+                name,
+                symbol,
+                totalSupply,
+                metadata: parsedMetadata,
+                imageUrl,
+            },
+            pool: poolInfo,
+            treasuryStats,
+        });
+    }
+    return {
+        projects,
+        fromBlock: from,
+        toBlock: to,
+    };
+}
+//# sourceMappingURL=projects.js.map

package/dist/esm/projects.js.map

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

package/dist/esm/proposals.js

@@ -0,0 +1,98 @@
+import { formatUnits } from "viem";
+import { LevrGovernor_v1 } from "./abis/index.js";
+const proposalCreatedEvent = LevrGovernor_v1.find((item) => item.type === "event" && item.name === "ProposalCreated");
+/**
+ * Get multiple proposals data from governor contract
+ */
+export async function proposals({ publicClient, governorAddress, tokenDecimals = 18, fromBlock, toBlock = "latest", pageSize = 50, }) {
+    if (Object.values({ publicClient, governorAddress }).some((value) => !value)) {
+        throw new Error("Invalid proposals params");
+    }
+    // Determine block range
+    const latestBlock = await publicClient.getBlockNumber();
+    const from = fromBlock ?? latestBlock - latestBlock / 10n; // Default to last 10% of blocks
+    const to = toBlock === "latest" ? latestBlock : toBlock;
+    // Fetch ProposalCreated events - indexed events are efficient even across large ranges
+    const allLogs = (await publicClient.getLogs({
+        address: governorAddress,
+        event: proposalCreatedEvent,
+        fromBlock: from,
+        toBlock: to,
+    }));
+    // Sort by block number descending (most recent first)
+    const logs = allLogs.sort((a, b) => {
+        if (a.blockNumber > b.blockNumber)
+            return -1;
+        if (a.blockNumber < b.blockNumber)
+            return 1;
+        return 0;
+    });
+    // Limit to pageSize
+    const limitedLogs = logs.slice(0, pageSize);
+    if (limitedLogs.length === 0) {
+        return {
+            proposals: [],
+            fromBlock: from,
+            toBlock: to,
+        };
+    }
+    // Extract proposal IDs from events
+    const proposalIds = limitedLogs.map((log) => log.args.proposalId);
+    // Batch fetch all proposal details
+    const contracts = proposalIds.map((proposalId) => ({
+        address: governorAddress,
+        abi: LevrGovernor_v1,
+        functionName: "getProposal",
+        args: [proposalId],
+    }));
+    const results = await publicClient.multicall({ contracts });
+    // Parse results into FormattedProposalDetails objects
+    const proposals = [];
+    for (let i = 0; i < proposalIds.length; i++) {
+        const result = results[i].result;
+        // Skip if proposal data is invalid
+        if (!result) {
+            continue;
+        }
+        proposals.push({
+            id: result.id,
+            proposalType: result.proposalType,
+            proposer: result.proposer,
+            amount: {
+                raw: result.amount,
+                formatted: formatUnits(result.amount, tokenDecimals),
+            },
+            recipient: result.recipient,
+            description: result.description,
+            createdAt: {
+                timestamp: result.createdAt,
+                date: new Date(Number(result.createdAt) * 1000),
+            },
+            votingStartsAt: {
+                timestamp: result.votingStartsAt,
+                date: new Date(Number(result.votingStartsAt) * 1000),
+            },
+            votingEndsAt: {
+                timestamp: result.votingEndsAt,
+                date: new Date(Number(result.votingEndsAt) * 1000),
+            },
+            yesVotes: {
+                raw: result.yesVotes,
+                formatted: formatUnits(result.yesVotes, tokenDecimals),
+            },
+            noVotes: {
+                raw: result.noVotes,
+                formatted: formatUnits(result.noVotes, tokenDecimals),
+            },
+            totalBalanceVoted: result.totalBalanceVoted,
+            executed: result.executed,
+            cycleId: result.cycleId,
+        });
+    }
+    return {
+        proposals,
+        fromBlock: from,
+        toBlock: to,
+    };
+}
+//# sourceMappingURL=proposals.js.map

package/dist/esm/proposals.js.map

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

package/dist/esm/quote-v4.js

@@ -0,0 +1,169 @@
+import { encodeAbiParameters, keccak256 } from "viem";
+import { IClankerHookDynamicFee, IClankerHookStaticFee, V4Quoter } from "./abis/index.js";
+import { UNISWAP_V4_QUOTER } from "./constants.js";
+/**
+ * @description Try to get static fees from a Clanker hook using multicall
+ * @param publicClient Public client
+ * @param hookAddress Hook address
+ * @param poolId Pool ID
+ * @returns Static fees or undefined
+ */
+const tryGetStaticFees = async (publicClient, hookAddress, poolId) => {
+    try {
+        const results = await publicClient.multicall({
+            contracts: [
+                {
+                    address: hookAddress,
+                    abi: IClankerHookStaticFee,
+                    functionName: "clankerFee",
+                    args: [poolId],
+                },
+                {
+                    address: hookAddress,
+                    abi: IClankerHookStaticFee,
+                    functionName: "pairedFee",
+                    args: [poolId],
+                },
+            ],
+        });
+        if (results[0].status === "success" && results[1].status === "success") {
+            return {
+                clankerFee: Number(results[0].result),
+                pairedFee: Number(results[1].result),
+            };
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * @description Try to get dynamic fee configuration from a Clanker hook
+ * @param publicClient Public client
+ * @param hookAddress Hook address
+ * @param poolId Pool ID
+ * @returns Dynamic fee config or undefined
+ */
+const tryGetDynamicFees = async (publicClient, hookAddress, poolId) => {
+    try {
+        const config = await publicClient.readContract({
+            address: hookAddress,
+            abi: IClankerHookDynamicFee,
+            functionName: "poolConfigVars",
+            args: [poolId],
+        });
+        return {
+            baseFee: Number(config.baseFee),
+            maxLpFee: Number(config.maxLpFee),
+        };
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * @description Get hook fee information from Clanker hooks
+ * @param publicClient Public client
+ * @param poolKey Pool key containing hook address
+ * @returns Hook fee information or undefined
+ */
+const getHookFees = async (publicClient, poolKey) => {
+    // Generate pool ID for hook queries (keccak256 of abi.encode(PoolKey))
+    const poolId = keccak256(encodeAbiParameters([
+        {
+            type: "tuple",
+            components: [
+                { name: "currency0", type: "address" },
+                { name: "currency1", type: "address" },
+                { name: "fee", type: "uint24" },
+                { name: "tickSpacing", type: "int24" },
+                { name: "hooks", type: "address" },
+            ],
+        },
+    ], [poolKey]));
+    // Try static fees first
+    const staticFees = await tryGetStaticFees(publicClient, poolKey.hooks, poolId);
+    if (staticFees) {
+        return {
+            type: "static",
+            clankerFee: staticFees.clankerFee,
+            pairedFee: staticFees.pairedFee,
+        };
+    }
+    // Try dynamic fees
+    const dynamicFees = await tryGetDynamicFees(publicClient, poolKey.hooks, poolId);
+    if (dynamicFees) {
+        return {
+            type: "dynamic",
+            baseFee: dynamicFees.baseFee,
+            maxLpFee: dynamicFees.maxLpFee,
+        };
+    }
+    return undefined;
+};
+/**
+ * @description Get a swap quote from Uniswap V4 Quoter
+ * @param params Quote parameters including pool key and amount
+ * @returns Quote result with output amount, gas estimate, and hook fees
+ *
+ * @remarks
+ * The V4Quoter uses state-changing calls that are simulated via static call.
+ * The quoter returns the expected output amount for the given input.
+ *
+ * This function works for both native ETH and ERC20 swaps:
+ * - Native ETH → Token: Quote uses WETH address, swap router handles wrapping
+ * - Token → Native ETH: Quote uses WETH address, swap router handles unwrapping
+ *
+ * @example
+ * ```typescript
+ * const quote = await quoteV4({
+ *   publicClient,
+ *   chainId: base.id,
+ *   poolKey,
+ *   zeroForOne: true,
+ *   amountIn: parseEther('1'),
+ * })
+ * console.log(`Output: ${formatEther(quote.amountOut)}`)
+ * console.log(`Fees:`, quote.hookFees)
+ * ```
+ */
+export const quoteV4 = async ({ publicClient, chainId, poolKey, zeroForOne, amountIn, hookData = "0x", }) => {
+    const quoterAddress = UNISWAP_V4_QUOTER(chainId);
+    if (!quoterAddress)
+        throw new Error("V4 Quoter address not found for chain");
+    // Always fetch hook fee information (in parallel with quote)
+    const hookFeesPromise = getHookFees(publicClient, poolKey);
+    // Call the quoter using simulateContract (static call simulation)
+    // This is equivalent to ethers.js callStatic
+    const [{ result }, hookFees] = await Promise.all([
+        publicClient.simulateContract({
+            address: quoterAddress,
+            abi: V4Quoter,
+            functionName: "quoteExactInputSingle",
+            args: [
+                {
+                    poolKey: {
+                        currency0: poolKey.currency0,
+                        currency1: poolKey.currency1,
+                        fee: poolKey.fee,
+                        tickSpacing: poolKey.tickSpacing,
+                        hooks: poolKey.hooks,
+                    },
+                    zeroForOne,
+                    exactAmount: amountIn,
+                    hookData,
+                },
+            ],
+        }),
+        hookFeesPromise,
+    ]);
+    // The quoter returns [amountOut: bigint, gasEstimate: bigint]
+    const [amountOut, gasEstimate] = result;
+    return {
+        amountOut,
+        gasEstimate,
+        hookFees,
+    };
+};
+//# sourceMappingURL=quote-v4.js.map

package/dist/esm/quote-v4.js.map

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

package/dist/esm/schema/base.schema.js

@@ -0,0 +1,11 @@
+import { Schema } from 'effect';
+export const NonEmptyString = (message) => Schema.String.pipe(Schema.nonEmptyString({ description: message })).annotations({
+    description: 'Non-empty string value',
+});
+export const UrlString = Schema.String.pipe(Schema.pattern(/^\w+:\/\/.+/)).annotations({
+    description: 'URL string (http(s), ipfs, etc.)',
+});
+export const EthereumAddress = Schema.String.pipe(Schema.pattern(/^0x[a-fA-F0-9]{40}$/)).annotations({
+    description: 'Ethereum address (0x...)',
+});
+//# sourceMappingURL=base.schema.js.map