levr-sdk 0.0.1 → 0.1.0

package/dist/types/fee-receivers.d.ts

@@ -2,7 +2,6 @@ import type { PopPublicClient, PopWalletClient } from './types';
 export type FeeReceiversParams = {
     publicClient: PopPublicClient;
     clankerToken: `0x${string}`;
-    chainId: number;
     userAddress?: `0x${string}`;
 };
 export type FeeReceiverAdmin = {
@@ -18,10 +17,38 @@ export type UpdateFeeReceiverParams = {
     rewardIndex: bigint | number;
     newRecipient: `0x${string}`;
 };
+/**
+ * Get tokenRewards from LP locker (shared utility)
+ * Returns pool info and fee receiver data
+ */
+export declare function getTokenRewards(publicClient: PopPublicClient, clankerToken: `0x${string}`): Promise<{
+    token: `0x${string}`;
+    poolKey: {
+        currency0: `0x${string}`;
+        currency1: `0x${string}`;
+        fee: number;
+        tickSpacing: number;
+        hooks: `0x${string}`;
+    };
+    positionId: bigint;
+    numPositions: bigint;
+    rewardBps: readonly number[];
+    rewardAdmins: readonly `0x${string}`[];
+    rewardRecipients: readonly `0x${string}`[];
+}>;
+/**
+ * Parse fee receivers from tokenRewards result
+ * Shared utility to avoid logic duplication
+ */
+export declare function parseFeeReceivers(tokenRewardsResult: {
+    rewardAdmins?: readonly `0x${string}`[];
+    rewardRecipients?: readonly `0x${string}`[];
+    rewardBps?: readonly number[];
+}, userAddress?: `0x${string}`): FeeReceiverAdmin[];
 /**
  * Get fee receivers for a clanker token
  */
-export declare function feeReceivers({ publicClient, clankerToken, chainId, userAddress, }: FeeReceiversParams): Promise<FeeReceiverAdmin[] | undefined>;
+export declare function feeReceivers({ publicClient, clankerToken, userAddress, }: FeeReceiversParams): Promise<FeeReceiverAdmin[] | undefined>;
 /**
  * Update fee receiver for a clanker token
  */

package/dist/types/fee-receivers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fee-receivers.d.ts","sourceRoot":"","sources":["../../src/fee-receivers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,eAAe,CAAA;IAC7B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,EAAE,KAAK,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,eAAe,CAAA;IAC7B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EACjC,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,GACZ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CA8B9D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,GACb,EAAE,uBAAuB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAqBlD"}
+{"version":3,"file":"fee-receivers.d.ts","sourceRoot":"","sources":["../../src/fee-receivers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,eAAe,CAAA;IAC7B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,EAAE,KAAK,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,eAAe,CAAA;IAC7B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE;;;;;;;;;;;;;;GAe/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,kBAAkB,EAAE;IAClB,YAAY,CAAC,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAA;IACvC,gBAAgB,CAAC,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAA;IAC3C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B,EACD,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,GAC1B,gBAAgB,EAAE,CAWpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EACjC,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAO9D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,GACb,EAAE,uBAAuB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAqBlD"}

package/dist/types/governance.d.ts

@@ -1,12 +1,10 @@
 import type { TransactionReceipt } from 'viem';
-import type { PopPublicClient, PopWalletClient } from './types';
+import type { Project } from '.';
+import type { BalanceResult, PopPublicClient, PopWalletClient } from './types';
 export type GovernanceConfig = {
     wallet: PopWalletClient;
     publicClient: PopPublicClient;
-    governorAddress: `0x${string}`;
-    tokenDecimals: number;
-    clankerToken: `0x${string}`;
-    trustedForwarder?: `0x${string}`;
+    project: Project;
 };
 export type ProposalDetails = {
     id: bigint;
@@ -28,10 +26,7 @@ export type FormattedProposalDetails = {
     id: bigint;
     proposalType: number;
     proposer: `0x${string}`;
-    amount: {
-        raw: bigint;
-        formatted: string;
-    };
+    amount: BalanceResult;
     recipient: `0x${string}`;
     description: string;
     createdAt: {
@@ -46,14 +41,8 @@ export type FormattedProposalDetails = {
         timestamp: bigint;
         date: Date;
     };
-    yesVotes: {
-        raw: bigint;
-        formatted: string;
-    };
-    noVotes: {
-        raw: bigint;
-        formatted: string;
-    };
+    yesVotes: BalanceResult;
+    noVotes: BalanceResult;
     totalBalanceVoted: bigint;
     executed: boolean;
     cycleId: bigint;
@@ -74,10 +63,7 @@ export type ExecuteProposalConfig = {
 export declare class Governance {
     private wallet;
     private publicClient;
-    private governorAddress;
-    private tokenDecimals;
-    private clankerToken;
-    private userAddress;
+    private project;
     constructor(config: GovernanceConfig);
     /**
      * Propose a transfer from treasury to recipient
@@ -102,22 +88,6 @@ export declare class Governance {
      * Note: Automatically starts a new cycle after successful execution
      */
     executeProposal(proposalId: number | bigint): Promise<TransactionReceipt>;
-    /**
-     * Get proposal details by ID
-     */
-    getProposal(proposalId: number | bigint): Promise<FormattedProposalDetails>;
-    /**
-     * Get current cycle ID
-     */
-    getCurrentCycleId(): Promise<bigint>;
-    /**
-     * Get all proposal IDs for a specific cycle
-     */
-    getProposalsForCycle(cycleId: number | bigint): Promise<readonly bigint[]>;
-    /**
-     * Get the winner proposal ID for a cycle
-     */
-    getWinner(cycleId: number | bigint): Promise<bigint>;
     /**
      * Get vote receipt for a user on a proposal
      */
@@ -126,79 +96,9 @@ export declare class Governance {
         support: boolean;
         votes: bigint;
     }>;
-    /**
-     * Get voting power snapshot for a user at proposal creation
-     */
-    getVotingPowerSnapshot(proposalId: number | bigint, user?: `0x${string}`): Promise<bigint>;
-    /**
-     * Check if proposal meets quorum
-     */
-    meetsQuorum(proposalId: number | bigint): Promise<boolean>;
-    /**
-     * Check if proposal meets approval threshold
-     */
-    meetsApproval(proposalId: number | bigint): Promise<boolean>;
-    /**
-     * Get proposal state (Pending, Active, Defeated, Succeeded, Executed)
-     */
-    getProposalState(proposalId: number | bigint): Promise<number>;
-    /**
-     * Get active proposal count for a specific proposal type
-     */
-    getActiveProposalCount(proposalType: number): Promise<bigint>;
-    /**
-     * Get factory address
-     */
-    getFactory(): Promise<`0x${string}`>;
-    /**
-     * Get treasury address
-     */
-    getTreasury(): Promise<`0x${string}`>;
-    /**
-     * Get staked token address
-     */
-    getStakedToken(): Promise<`0x${string}`>;
-    /**
-     * Propose transfer and execute in sequence (for testing convenience)
-     */
-    proposeAndExecuteTransfer(recipient: `0x${string}`, amount: number | string | bigint, description: string): Promise<{
-        proposeReceipt: TransactionReceipt;
-        executeReceipt: TransactionReceipt;
-        proposalId: bigint;
-    }>;
-    /**
-     * Propose boost and execute in sequence (for testing convenience)
-     */
-    proposeAndExecuteBoost(amount: number | string | bigint): Promise<{
-        proposeReceipt: TransactionReceipt;
-        executeReceipt: TransactionReceipt;
-        proposalId: bigint;
-    }>;
-    /**
-     * Find treasury airdrop allocation by checking all known amounts using multicall
-     */
-    private findTreasuryAllocation;
-    /**
-     * Get available airdrop amount for treasury using known amounts
-     */
-    getAvailableAirdropAmount(): Promise<bigint>;
-    /**
-     * Get airdrop status for treasury with detailed status information
-     */
-    getAirdropStatus(): Promise<{
-        availableAmount: {
-            raw: bigint;
-            formatted: string;
-        };
-        allocatedAmount: {
-            raw: bigint;
-            formatted: string;
-        };
-        isAvailable: boolean;
-        error?: string;
-    }>;
     /**
      * Claim airdrop for treasury
+     * Uses airdrop data from project that was already fetched
      */
     claimAirdrop(): Promise<TransactionReceipt>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAM9C,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,eAAe,CAAA;IACvB,YAAY,EAAE,eAAe,CAAA;IAC7B,eAAe,EAAE,KAAK,MAAM,EAAE,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;IAC3B,gBAAgB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;IACvB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAA;IAC5C,cAAc,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAA;IACjD,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAA;IAC/C,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B,CAAA;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAe;gBAEtB,MAAM,EAAE,gBAAgB;IAYpC;;OAEG;IACG,eAAe,CACnB,SAAS,EAAE,KAAK,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA+C/D;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA+C/D;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBtF;;;OAGG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoB/E;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA8CjF;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ1C;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAWhF;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1D;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,GACpB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYlE;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhG;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWpE;;OAEG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAQ1C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAQ3C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAQ9C;;OAEG;IACG,yBAAyB,CAC7B,SAAS,EAAE,KAAK,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,cAAc,EAAE,kBAAkB,CAAA;QAClC,cAAc,EAAE,kBAAkB,CAAA;QAClC,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC;IAeF;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACtE,cAAc,EAAE,kBAAkB,CAAA;QAClC,cAAc,EAAE,kBAAkB,CAAA;QAClC,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC;IAWF;;OAEG;YACW,sBAAsB;IAuJpC;;OAEG;IACG,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QAChC,eAAe,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;QACnD,eAAe,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;QACnD,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC;IA2CF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAuClD"}
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/governance.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -6,13 +6,17 @@ export * from './constants';
 export * from './deploy-v4';
 export * from './fee-receivers';
 export * from './governance';
+export * from './pool';
+export * from './pool-key';
 export * from './project';
-export * from './projects';
-export * from './proposals';
-export * from './quote-v4';
+export * from './proposal';
+export * from './quote';
 export * from './schema';
 export * from './stake';
 export * from './swap-v4';
+export * from './treasury';
 export * from './types';
+export * from './usd-price';
+export * from './user';
 export * from './util';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA"}

package/dist/types/pool-key.d.ts

@@ -0,0 +1,121 @@
+import type { PublicClient } from 'viem';
+import type { PoolKey } from './types';
+/**
+ * @description Sort two token addresses for pool key (currency0 < currency1)
+ */
+export declare const sortTokens: (tokenA: `0x${string}`, tokenB: `0x${string}`) => [`0x${string}`, `0x${string}`];
+/**
+ * @description Default pool configuration
+ * 0.3% fee tier is the most common on Uniswap
+ */
+export declare const DEFAULT_POOL_CONFIG: {
+    readonly fee: 3000;
+    readonly tickSpacing: 60;
+    readonly hooks: "0x0000000000000000000000000000000000000000";
+};
+/**
+ * @description Create a pool key for two tokens
+ * @param token0 First token address
+ * @param token1 Second token address
+ * @param fee Fee tier (in hundredths of a bip, e.g. 3000 = 0.3%). Defaults to 3000 (0.3%)
+ * @param tickSpacing Tick spacing. Defaults to 60 (for 0.3% fee tier)
+ * @param hooks Hooks address. Defaults to zero address (no hooks)
+ * @returns Properly sorted PoolKey
+ */
+export declare const createPoolKey: (token0: `0x${string}`, token1: `0x${string}`, fee?: number, tickSpacing?: number, hooks?: `0x${string}`) => PoolKey;
+/**
+ * @description Calculate pool ID from pool key (keccak256 of abi.encode(PoolKey))
+ * @param poolKey Pool key
+ * @returns Pool ID as bytes32
+ */
+export declare const getPoolId: (poolKey: PoolKey) => `0x${string}`;
+/**
+ * @description Common fee tiers and their corresponding tick spacings
+ * Ordered by preference: 0.3% is most common for major pairs, then 0.05%, then 1%
+ * From Uniswap V4 documentation
+ */
+export declare const COMMON_FEE_TIERS: readonly [{
+    readonly fee: 3000;
+    readonly tickSpacing: 60;
+}, {
+    readonly fee: 500;
+    readonly tickSpacing: 10;
+}, {
+    readonly fee: 10000;
+    readonly tickSpacing: 200;
+}];
+/**
+ * @description Parameters for discovering a pool
+ */
+export type DiscoverPoolParams = {
+    publicClient: PublicClient;
+    token0: `0x${string}`;
+    token1: `0x${string}`;
+    hooks?: `0x${string}`;
+    feeTiers?: readonly {
+        fee: number;
+        tickSpacing: number;
+    }[];
+};
+/**
+ * @description Return type for pool discovery
+ */
+export type DiscoverPoolReturnType = {
+    poolKey: PoolKey;
+    sqrtPriceX96: bigint;
+    liquidity: bigint;
+    tick: number;
+} | null;
+/**
+ * @description Discover an existing pool by trying common fee tiers
+ * @param params Discovery parameters
+ * @returns Pool data if found, null otherwise
+ *
+ * @remarks
+ * This function tries to find an initialized pool by:
+ * 1. Trying common fee tiers (0.05%, 0.3%, 1%)
+ * 2. Querying StateView contract to check if pool exists and has liquidity
+ * 3. Returning the first valid pool found
+ *
+ * Uses Uniswap V4's StateView contract to fetch pool state:
+ * - getSlot0(): sqrtPriceX96, tick, protocol/LP fees
+ * - getLiquidity(): pool liquidity
+ *
+ * @example
+ * ```typescript
+ * const pool = await discoverPool({
+ *   publicClient,
+ *   token0: WETH_ADDRESS,
+ *   token1: USDC_ADDRESS,
+ * })
+ * if (pool) {
+ *   console.log('Found pool:', pool.poolKey)
+ *   console.log('Liquidity:', pool.liquidity)
+ * }
+ * ```
+ */
+export declare const discoverPool: ({ publicClient, token0, token1, hooks, feeTiers, }: DiscoverPoolParams) => Promise<DiscoverPoolReturnType>;
+/**
+ * @description Find a liquid pool by discovering pools with liquidity
+ * @param params Discovery parameters
+ * @returns Pool key if found, null otherwise
+ *
+ * @remarks
+ * This is a convenience wrapper around discoverPool that returns just the pool key.
+ * It uses the StateView contract to find pools with actual liquidity.
+ *
+ * @example
+ * ```typescript
+ * const poolKey = await findLiquidPool({
+ *   publicClient,
+ *   token0: WETH_ADDRESS,
+ *   token1: USDC_ADDRESS,
+ * })
+ * if (poolKey) {
+ *   console.log('Found pool with fee tier:', poolKey.fee)
+ * }
+ * ```
+ */
+export type FindLiquidPoolParams = DiscoverPoolParams;
+export declare const findLiquidPool: (params: FindLiquidPoolParams) => Promise<PoolKey | null>;
+//# sourceMappingURL=pool-key.d.ts.map

package/dist/types/pool-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-key.d.ts","sourceRoot":"","sources":["../../src/pool-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAKxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,KAAK,MAAM,EAAE,EACrB,QAAQ,KAAK,MAAM,EAAE,KACpB,CAAC,KAAK,MAAM,EAAE,EAAE,KAAK,MAAM,EAAE,CAE/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAA;AAEV;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,KAAK,MAAM,EAAE,EACrB,QAAQ,KAAK,MAAM,EAAE,EACrB,MAAK,MAAgC,EACrC,cAAa,MAAwC,EACrD,QAAO,KAAK,MAAM,EAA8B,KAC/C,OASF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,OAAO,KAAG,KAAK,MAAM,EAkBvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAInB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACrB,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACrB,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC3D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAAA;AAER;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,YAAY,GAAU,oDAMhC,kBAAkB,KAAG,OAAO,CAAC,sBAAsB,CA0DrD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAA;AAErD,eAAO,MAAM,cAAc,GAAU,QAAQ,oBAAoB,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAGzF,CAAA"}