levr-sdk 0.0.1

package/dist/types/schema/clanker.schema.d.ts

@@ -0,0 +1,104 @@
+import { Schema } from 'effect';
+export declare const Metadata: Schema.Struct<{
+    description: Schema.optional<typeof Schema.String>;
+    socialMediaUrls: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+        platform: Schema.refine<string, typeof Schema.String>;
+        url: Schema.refine<string, typeof Schema.String>;
+    }>>>>>;
+    auditUrls: Schema.optional<Schema.mutable<Schema.Array$<Schema.refine<string, typeof Schema.String>>>>;
+}>;
+export declare const DevBuy: Schema.Struct<{
+    ethAmount: Schema.SchemaClass<number, number, never>;
+    poolKey: Schema.optional<Schema.mutable<Schema.Struct<{
+        currency0: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        currency1: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        fee: Schema.SchemaClass<number, number, never>;
+        tickSpacing: Schema.SchemaClass<number, number, never>;
+        hooks: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+    }>>>;
+    amountOutMin: Schema.optional<typeof Schema.Number>;
+}>;
+export declare const ClankerDeploymentSchema: Schema.Struct<{
+    name: Schema.refine<string, typeof Schema.String>;
+    symbol: Schema.refine<string, typeof Schema.String>;
+    image: Schema.optional<typeof Schema.String>;
+    chainId: Schema.optional<typeof Schema.Number>;
+    tokenAdmin: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+    vanity: Schema.optional<typeof Schema.Boolean>;
+    metadata: Schema.optional<Schema.Struct<{
+        description: Schema.optional<typeof Schema.String>;
+        socialMediaUrls: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            platform: Schema.refine<string, typeof Schema.String>;
+            url: Schema.refine<string, typeof Schema.String>;
+        }>>>>>;
+        auditUrls: Schema.optional<Schema.mutable<Schema.Array$<Schema.refine<string, typeof Schema.String>>>>;
+    }>>;
+    context: Schema.optional<Schema.mutable<Schema.Struct<{
+        interface: Schema.optional<typeof Schema.String>;
+        platform: Schema.optional<typeof Schema.String>;
+        messageId: Schema.optional<typeof Schema.String>;
+        id: Schema.optional<typeof Schema.String>;
+    }>>>;
+    pool: Schema.optional<Schema.mutable<Schema.Struct<{
+        pairedToken: Schema.optional<Schema.Union<[Schema.Literal<["WETH"]>, Schema.Schema<`0x${string}`, `0x${string}`, never>]>>;
+        tickIfToken0IsClanker: Schema.optional<typeof Schema.Number>;
+        tickSpacing: Schema.optional<typeof Schema.Number>;
+        positions: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            tickLower: Schema.SchemaClass<number, number, never>;
+            tickUpper: Schema.SchemaClass<number, number, never>;
+            positionBps: Schema.SchemaClass<number, number, never>;
+        }>>>>;
+    }>>>;
+    locker: Schema.optional<Schema.mutable<Schema.Struct<{
+        locker: Schema.Union<[Schema.Literal<["Locker"]>, Schema.Schema<`0x${string}`, `0x${string}`, never>]>;
+        lockerData: Schema.optional<Schema.Schema<`0x${string}`, `0x${string}`, never>>;
+    }>>>;
+    vault: Schema.optional<Schema.mutable<Schema.Struct<{
+        percentage: Schema.SchemaClass<number, number, never>;
+        lockupDuration: Schema.SchemaClass<number, number, never>;
+        vestingDuration: Schema.optional<typeof Schema.Number>;
+        recipient: Schema.optional<Schema.Schema<`0x${string}`, `0x${string}`, never>>;
+    }>>>;
+    airdrop: Schema.optional<Schema.mutable<Schema.Struct<{
+        admin: Schema.optional<Schema.Schema<`0x${string}`, `0x${string}`, never>>;
+        merkleRoot: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        lockupDuration: Schema.SchemaClass<number, number, never>;
+        vestingDuration: Schema.optional<typeof Schema.Number>;
+        amount: Schema.SchemaClass<number, number, never>;
+    }>>>;
+    devBuy: Schema.optional<Schema.Struct<{
+        ethAmount: Schema.SchemaClass<number, number, never>;
+        poolKey: Schema.optional<Schema.mutable<Schema.Struct<{
+            currency0: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+            currency1: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+            fee: Schema.SchemaClass<number, number, never>;
+            tickSpacing: Schema.SchemaClass<number, number, never>;
+            hooks: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        }>>>;
+        amountOutMin: Schema.optional<typeof Schema.Number>;
+    }>>;
+    fees: Schema.optional<Schema.mutable<Schema.Union<[Schema.mutable<Schema.Struct<{
+        type: Schema.optional<Schema.Literal<["static"]>>;
+        clankerFee: Schema.SchemaClass<number, number, never>;
+        pairedFee: Schema.SchemaClass<number, number, never>;
+    }>>, Schema.mutable<Schema.Struct<{
+        type: Schema.optional<Schema.Literal<["dynamic"]>>;
+        baseFee: Schema.SchemaClass<number, number, never>;
+        maxFee: Schema.SchemaClass<number, number, never>;
+        referenceTickFilterPeriod: Schema.SchemaClass<number, number, never>;
+        resetPeriod: Schema.SchemaClass<number, number, never>;
+        resetTickFilter: Schema.SchemaClass<number, number, never>;
+        feeControlNumerator: Schema.SchemaClass<number, number, never>;
+        decayFilterBps: Schema.SchemaClass<number, number, never>;
+    }>>]>>>;
+    rewards: Schema.optional<Schema.mutable<Schema.Struct<{
+        recipients: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            admin: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+            recipient: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+            bps: Schema.SchemaClass<number, number, never>;
+            token: Schema.Union<[Schema.Literal<["Both"]>, Schema.Literal<["Paired"]>, Schema.Literal<["Clanker"]>]>;
+        }>>>>;
+    }>>>;
+}>;
+export type ClankerDeploymentSchemaType = typeof ClankerDeploymentSchema.Type;
+//# sourceMappingURL=clanker.schema.d.ts.map

package/dist/types/schema/clanker.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clanker.schema.d.ts","sourceRoot":"","sources":["../../../src/schema/clanker.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAW/B,eAAO,MAAM,QAAQ;;;;;;;EAI6C,CAAA;AAwFlE,eAAO,MAAM,MAAM;;;;;;;;;;EAQjB,CAAA;AA6EF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB4B,CAAA;AAEhE,MAAM,MAAM,2BAA2B,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA"}

package/dist/types/schema/index.d.ts

@@ -0,0 +1,4 @@
+export * from './base.schema';
+export * from './clanker.schema';
+export * from './levr.schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA"}

package/dist/types/schema/levr.schema.d.ts

@@ -0,0 +1,34 @@
+import { Schema } from 'effect';
+export declare const LevrClankerDeploymentSchema: Schema.filter<Schema.filter<Schema.Struct<{
+    metadata: Schema.optional<Schema.Struct<{
+        description: Schema.optional<typeof Schema.String>;
+        telegramLink: Schema.optional<typeof Schema.String>;
+        websiteLink: Schema.optional<typeof Schema.String>;
+        xLink: Schema.optional<typeof Schema.String>;
+        farcasterLink: Schema.optional<typeof Schema.String>;
+    }>>;
+    devBuy: Schema.optional<Schema.Literal<["0.1 ETH", "0.5 ETH", "1 ETH"]>>;
+    airdrop: Schema.optional<Schema.Array$<Schema.Struct<{
+        amount: Schema.SchemaClass<number, number, never>;
+        account: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+    }>>>;
+    treasuryFunding: Schema.Literal<["30%" | "40%" | "50%" | "60%" | "70%" | "80%" | "90%"]>;
+    fees: Schema.Union<[Schema.Struct<{
+        type: Schema.Literal<["static"]>;
+        feeTier: Schema.Literal<["1%" | "2%" | "3%"]>;
+    }>, Schema.Struct<{
+        type: Schema.Literal<["dynamic 3%"]>;
+    }>]>;
+    stakingReward: Schema.optional<Schema.Literal<["70%" | "80%" | "90%" | "100%"]>>;
+    rewards: Schema.optional<Schema.Array$<Schema.Struct<{
+        admin: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        recipient: Schema.Schema<`0x${string}`, `0x${string}`, never>;
+        percentage: Schema.SchemaClass<number, number, never>;
+        token: Schema.Literal<["Both", "Paired", "Clanker"]>;
+    }>>>;
+    symbol: Schema.refine<string, typeof Schema.String>;
+    name: Schema.refine<string, typeof Schema.String>;
+    image: Schema.optional<typeof Schema.String>;
+}>>>;
+export type LevrClankerDeploymentSchemaType = typeof LevrClankerDeploymentSchema.Type;
+//# sourceMappingURL=levr.schema.d.ts.map

package/dist/types/schema/levr.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levr.schema.d.ts","sourceRoot":"","sources":["../../../src/schema/levr.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AA2G/B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+CvC,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAA"}

package/dist/types/stake.d.ts

@@ -0,0 +1,137 @@
+import type { TransactionReceipt } from 'viem';
+import type { PoolKey, PopPublicClient, PopWalletClient } from './types';
+export type StakeConfig = {
+    wallet: PopWalletClient;
+    publicClient: PopPublicClient;
+    stakingAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    tokenDecimals: number;
+    trustedForwarder?: `0x${string}`;
+};
+export type UnstakeParams = {
+    amount: number | string | bigint;
+    to?: `0x${string}`;
+};
+export type ClaimParams = {
+    tokens?: `0x${string}`[];
+    to?: `0x${string}`;
+};
+export declare class Stake {
+    private wallet;
+    private publicClient;
+    private stakingAddress;
+    private tokenAddress;
+    private tokenDecimals;
+    private chainId;
+    private userAddress;
+    private trustedForwarder?;
+    constructor(config: StakeConfig);
+    /**
+     * Approve ERC20 tokens for spending by the staking contract
+     */
+    approve(amount: number | string | bigint): Promise<TransactionReceipt>;
+    /**
+     * Stake tokens in the staking contract
+     */
+    stake(amount: number | string | bigint): Promise<TransactionReceipt>;
+    /**
+     * Unstake tokens from the staking contract
+     */
+    unstake({ amount, to }: UnstakeParams): Promise<TransactionReceipt>;
+    /**
+     * Claim rewards from the staking contract
+     */
+    claimRewards(params: ClaimParams | void): Promise<TransactionReceipt>;
+    /**
+     * Get allowance for a token and spender
+     */
+    getAllowance(): Promise<{
+        raw: bigint;
+        formatted: string;
+    }>;
+    /**
+     * Get pool data from staking contract
+     */
+    getPoolData(): Promise<{
+        totalStaked: {
+            raw: bigint;
+            formatted: string;
+        };
+        escrowBalance: {
+            raw: bigint;
+            formatted: string;
+        };
+        streamParams: {
+            windowSeconds: number;
+            streamStart: bigint;
+            streamEnd: bigint;
+            isActive: boolean;
+        };
+        rewardRatePerSecond: {
+            raw: bigint;
+            formatted: string;
+        };
+    }>;
+    /**
+     * Get user data from staking contract
+     */
+    getUserData(): Promise<{
+        stakedBalance: {
+            raw: bigint;
+            formatted: string;
+        };
+        aprBps: {
+            raw: bigint;
+            percentage: number;
+        };
+    }>;
+    /**
+     * Get outstanding rewards for the token (for accrual purposes)
+     */
+    getOutstandingRewards(tokenAddress?: `0x${string}`): Promise<{
+        available: {
+            raw: bigint;
+            formatted: string;
+        };
+        pending: {
+            raw: bigint;
+            formatted: string;
+        };
+    }>;
+    /**
+     * Get claimable rewards for the current user and token
+     */
+    getClaimableRewards(tokenAddress?: `0x${string}`): Promise<{
+        claimable: {
+            raw: bigint;
+            formatted: string;
+        };
+    }>;
+    /**
+     * Get reward rate per second for a specific token
+     */
+    getRewardRatePerSecond(tokenAddress?: `0x${string}`): Promise<{
+        raw: bigint;
+        formatted: string;
+    }>;
+    /**
+     * Accrue rewards by triggering automatic collection from LP locker and claiming from ClankerFeeLocker
+     */
+    accrueRewards(tokenAddress?: `0x${string}`): Promise<TransactionReceipt>;
+    /**
+     * Accrue rewards for multiple tokens in a single transaction using forwarder multicall
+     */
+    accrueAllRewards(tokenAddresses: `0x${string}`[]): Promise<TransactionReceipt>;
+    /**
+     * Calculate WETH APR using pool price and reward rates
+     * Formula: (wethRewardRatePerSecond * secondsPerYear * wethPriceInUnderlying / totalStaked) * 10000
+     *
+     * @param poolKey - The Uniswap V4 pool key for price discovery
+     * @returns WETH APR in basis points and percentage
+     */
+    calculateWethApr(poolKey: PoolKey): Promise<{
+        raw: bigint;
+        percentage: number;
+    }>;
+}
+//# sourceMappingURL=stake.d.ts.map

package/dist/types/stake.d.ts.map

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

package/dist/types/swap-v4.d.ts

@@ -0,0 +1,97 @@
+import type { PublicClient, TransactionReceipt, WalletClient } from 'viem';
+import type { PoolKey } from './types';
+export type SwapV4Params = {
+    publicClient: PublicClient;
+    wallet: WalletClient;
+    chainId: number;
+    poolKey: PoolKey;
+    zeroForOne: boolean;
+    amountIn: bigint;
+    amountOutMinimum: bigint;
+    /**
+     * Hook data to pass to the pool's hook contract
+     * @remarks
+     * - Standard pools: Use '0x' (default)
+     * - Clanker pools with extensions: May require specific encoded data for pool extension
+     * - Format depends on the specific hook implementation
+     */
+    hookData?: `0x${string}`;
+    onApproveERC20Success?: (receipt: TransactionReceipt) => void;
+    onApproveERC20Error?: (error: unknown) => void;
+    onApprovePermit2Success?: (receipt: TransactionReceipt) => void;
+    onApprovePermit2Error?: (error: unknown) => void;
+};
+export type SwapV4ReturnType = TransactionReceipt;
+/**
+ * @description Execute a Uniswap V4 swap with automatic native ETH handling
+ * @param params Swap parameters including pool key and amounts
+ * @returns Transaction receipt
+ *
+ * @remarks
+ * **Architecture:**
+ * - Uses Universal Router with V4Planner for encoding swap actions
+ * - Automatically handles native ETH ↔ WETH conversions (users never hold WETH)
+ * - ERC20 approvals via Permit2 (only for non-WETH tokens)
+ * - 20-minute deadline from current block timestamp
+ *
+ * **Execution Flow:**
+ *
+ * 1. **Approvals (ERC20 Tokens Only)**:
+ *    - Checks token balance and existing allowances via multicall
+ *    - Token → Permit2: Infinite approval if needed
+ *    - Permit2 → Router: MAX_UINT160 approval with 30-day expiration
+ *    - Native ETH swaps skip this step entirely
+ *
+ * 2. **Action Encoding**:
+ *    - **RoutePlanner Commands**:
+ *      - `WRAP_ETH` (if input is WETH): Wraps msg.value to router's WETH balance
+ *      - `V4_SWAP`: Executes the V4Planner actions (see below)
+ *      - `UNWRAP_WETH` (if output is WETH): Converts router's WETH to native ETH for user
+ *
+ *    - **V4Planner Actions** (nested in V4_SWAP):
+ *      - `SWAP_EXACT_IN_SINGLE`: Execute the swap with specified pool and amounts
+ *      - `SETTLE` or `SETTLE_ALL`: Pay for input tokens
+ *        - `SETTLE(currency, amount, false)`: Router pays from its balance (for WETH input after WRAP_ETH)
+ *        - `SETTLE_ALL(currency, amount)`: User pays from their token balance (for ERC20 input)
+ *      - `TAKE` or `TAKE_ALL`: Receive output tokens
+ *        - `TAKE(currency, routerAddress, 0)`: Router receives WETH (before UNWRAP_WETH)
+ *        - `TAKE_ALL(currency, 0)`: User directly receives tokens
+ *
+ * 3. **Transaction Execution**:
+ *    - Calls `execute(commands, inputs, deadline)` on Universal Router
+ *    - Sends msg.value = amountIn for WETH input (native ETH)
+ *    - Sends msg.value = 0 for ERC20 token input
+ *    - Waits for receipt and validates success
+ *
+ * **Native ETH Flows:**
+ * - **Buy tokens with ETH** (WETH → Token):
+ *   - User sends ETH as msg.value
+ *   - WRAP_ETH wraps it to router's WETH balance
+ *   - SETTLE pays swap from router's WETH (payerIsUser=false)
+ *   - TAKE_ALL sends tokens directly to user
+ *
+ * - **Sell tokens for ETH** (Token → WETH):
+ *   - SETTLE_ALL pays swap from user's token balance (via Permit2)
+ *   - TAKE sends WETH to router
+ *   - UNWRAP_WETH converts router's WETH to native ETH
+ *   - User receives native ETH (sent to MSG_SENDER)
+ *
+ * - **Token ↔ Token**: Standard ERC20 flow, no WRAP/UNWRAP needed
+ *
+ * @example
+ * ```typescript
+ * // Buy tokens with native ETH
+ * const receipt = await swapV4({
+ *   publicClient,
+ *   wallet,
+ *   chainId: base.id,
+ *   poolKey,
+ *   zeroForOne: true,  // WETH → Token
+ *   amountIn: parseEther('0.01'),
+ *   amountOutMinimum: parseUnits('100', tokenDecimals),
+ *   hookData: '0x', // Optional: pool-specific hook data
+ * })
+ * ```
+ */
+export declare const swapV4: ({ publicClient, wallet, chainId, poolKey, zeroForOne, amountIn, amountOutMinimum, hookData, onApproveERC20Success, onApproveERC20Error, onApprovePermit2Success, onApprovePermit2Error, }: SwapV4Params) => Promise<SwapV4ReturnType>;
+//# sourceMappingURL=swap-v4.d.ts.map

package/dist/types/swap-v4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap-v4.d.ts","sourceRoot":"","sources":["../../src/swap-v4.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAY1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IAGxB,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC7D,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC/D,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;AAcjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,eAAO,MAAM,MAAM,GAAU,2LAa1B,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAkNzC,CAAA"}

package/dist/types/types.d.ts

@@ -0,0 +1,20 @@
+import type { Account, Chain, PublicClient, Transport, WalletClient } from 'viem';
+export type PopWalletClient = WalletClient<Transport, Chain, Account>;
+export type PopPublicClient = PublicClient<Transport, Chain>;
+/**
+ * @description Uniswap V4 Pool Key structure
+ */
+export type PoolKey = {
+    currency0: `0x${string}`;
+    currency1: `0x${string}`;
+    fee: number;
+    tickSpacing: number;
+    hooks: `0x${string}`;
+};
+export type CallData = {
+    target: `0x${string}`;
+    allowFailure: boolean;
+    value: bigint;
+    callData: `0x${string}`;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEjF,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AACrE,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;CACxB,CAAA"}

package/dist/types/util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Check if approval is needed for a given amount
+ */
+export declare function needsApproval(currentAllowance: string | number | bigint, requiredAmount: string | number | bigint, decimals?: number): boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/types/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,CAC3B,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAC1C,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EACxC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAiBT"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "levr-sdk",
+  "description": "Leverage your Clanker launch with DAO capabilities",
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/esm/client/index.js",
+      "types": "./dist/types/client/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "devnet": "bash script/devnet.sh",
+    "devnet:redeploy": "bash script/devnet.sh --redeploy",
+    "update-abis": "bun run script/update-abis.ts && prettier --write src/abis/**/*.ts",
+    "watch": "bun run script/tsgo-watch.ts",
+    "type-check": "tsgo --noEmit --pretty",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "lint": "eslint",
+    "fill-placeholders": "sh ./script/fill-placeholders.sh",
+    "warp": "bun -e \"import { warpAnvil } from './test/util.ts'; await warpAnvil(120)\"",
+    "build": "bun build:esm && bun build:types && bun build:cleanup",
+    "build:esm": "tsc --project ./tsconfig.esm.json && tsc-alias --outDir ./dist/esm && ts-add-js-extension --dir=dist/esm --showprogress=false",
+    "build:types": "tsc --project ./tsconfig.types.json && tsc-alias --outDir ./dist/types",
+    "build:cleanup": "rm -f dist/types/abis/*.d.ts.map dist/esm/abis/*.js.map && find dist/esm/abis -name '*.js' -type f -exec sed -i.bak '/^\\/\\/# sourceMappingURL=/d' {} + && find dist/types/abis -name '*.d.ts' -type f -exec sed -i.bak '/^\\/\\/# sourceMappingURL=/d' {} + && find dist -name '*.bak' -type f -delete",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo node_modules bun.lockb",
+    "postinstall": "husky || true",
+    "prepack": "pinst --disable",
+    "package": "bun run build && npm pack",
+    "postpack": "pinst --enable",
+    "release": "standard-version -a",
+    "release:alpha": "standard-version -a --prerelease alpha --skip.changelog",
+    "release:beta": "standard-version -a --prerelease beta --skip.changelog",
+    "release:pub": "git push --follow-tags origin $(git rev-parse --abbrev-ref HEAD)"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,mjs,cjs,json,md,css}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "resolutions": {
+    "eslint": "^9.17.0",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.90.2",
+    "react": "^19.2.0",
+    "viem": "^2.37.11",
+    "wagmi": "^2.17.5"
+  },
+  "dependencies": {
+    "@uniswap/sdk-core": "^7.7.2",
+    "@uniswap/universal-router-sdk": "^4.19.7",
+    "@uniswap/v4-sdk": "^1.21.4",
+    "clanker-sdk": "^4.1.23",
+    "debug": "^4.4.1",
+    "effect": "^3.18.1",
+    "type-fest-4": "npm:type-fest@latest"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@types/bun": "^1.2.22",
+    "@types/debug": "^4.1.12",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "pinst": "^3.0.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-sh": "0.17.4",
+    "standard-version": "^9.5.0",
+    "ts-add-js-extension": "^1.6.6",
+    "tsc-alias": "^1.8.16",
+    "tsc-files": "^1.1.4",
+    "typescript-eslint": "^8.44.0"
+  },
+  "homepage": "https://github.com/quantidexyz/levr-sdk",
+  "repository": "quantidexyz/levr-sdk",
+  "authors": [
+    "quantidexyz"
+  ],
+  "keywords": [
+    "npm",
+    "contracts",
+    "web3",
+    "ethereum",
+    "solidity",
+    "evm"
+  ]
+}