levr-sdk 0.0.1

package/dist/types/constants.d.ts

@@ -0,0 +1,101 @@
+import { BigNumber } from 'ethers';
+/**
+ * Get the LP locker address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The LP locker address
+ */
+export declare const GET_LP_LOCKER_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the factory address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The factory address
+ */
+export declare const GET_FACTORY_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the WETH address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The WETH address
+ */
+export declare const WETH: (chainId?: number) => {
+    address: `0x${string}`;
+    decimals: number;
+    symbol: string;
+    name: string;
+} | undefined;
+/**
+ * Get the Uniswap V4 Permit2 address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Permit2 address
+ */
+export declare const UNISWAP_V4_PERMIT2: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Uniswap V4 Quoter address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Quoter address
+ */
+export declare const UNISWAP_V4_QUOTER: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Uniswap V4 Universal Router address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Uniswap V4 Universal Router address
+ */
+export declare const UNISWAP_V4_UNIVERSAL_ROUTER: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Uniswap V4 Pool Manager address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Pool Manager address
+ */
+export declare const UNISWAP_V4_POOL_MANAGER: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Clanker Factory address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Clanker Factory address (same on Base mainnet and Base Sepolia)
+ */
+export declare const GET_CLANKER_FACTORY_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Clanker Airdrop address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Clanker Airdrop address
+ */
+export declare const GET_CLANKER_AIRDROP_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Contract balance representation, for use in Universal Router
+ */
+export declare const CONTRACT_BALANCE: BigNumber;
+/**
+ * MSG_SENDER representation, for use in Universal Router
+ */
+export declare const MSG_SENDER = "0x0000000000000000000000000000000000000001";
+/**
+ * ADDRESS_THIS representation, for use in Universal Router
+ */
+export declare const ADDRESS_THIS = "0x0000000000000000000000000000000000000002";
+/**
+ * Common treasury airdrop amounts in tokens (not wei)
+ * First value is used as default in deployV4
+ */
+export declare const TREASURY_AIRDROP_AMOUNTS: {
+    readonly '30%': 30000000000;
+    readonly '40%': 40000000000;
+    readonly '50%': 50000000000;
+    readonly '60%': 60000000000;
+    readonly '70%': 70000000000;
+    readonly '80%': 80000000000;
+    readonly '90%': 90000000000;
+};
+/**
+ * Staking rewards in basis points
+ * The amount of rewards that are distributed to the staking contract
+ */
+export declare const STAKING_REWARDS: {
+    readonly '100%': 10000;
+    readonly '90%': 9000;
+    readonly '80%': 8000;
+    readonly '70%': 7000;
+};
+export declare const STATIC_FEE_TIERS: {
+    readonly '1%': 100;
+    readonly '2%': 200;
+    readonly '3%': 300;
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAGlC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAWxE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAOtE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,GACf,UAAU,MAAM,KAEd;IACE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,GACD,SAeH,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQrE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQpE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQ9E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQ1E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAY9E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAW9E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,WAE5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,+CAA+C,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,YAAY,+CAA+C,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAQ3B,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;CAInB,CAAA"}

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

@@ -0,0 +1,13 @@
+import type { Clanker } from 'clanker-sdk/v4';
+import type { TransactionReceipt } from 'viem';
+import type { LevrClankerDeploymentSchemaType } from './schema';
+export type DeployV4Params = {
+    c: LevrClankerDeploymentSchemaType;
+    clanker: Clanker | undefined | null;
+};
+export type DeployV4ReturnType = {
+    receipt: TransactionReceipt;
+    address: `0x${string}`;
+};
+export declare const deployV4: ({ c, clanker }: DeployV4Params) => Promise<DeployV4ReturnType>;
+//# sourceMappingURL=deploy-v4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-v4.d.ts","sourceRoot":"","sources":["../../src/deploy-v4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAK9C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,EAAE,+BAA+B,CAAA;IAClC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,kBAAkB,CAAA;IAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAU,gBAAgB,cAAc,KAAG,OAAO,CAAC,kBAAkB,CA6CzF,CAAA"}

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

@@ -0,0 +1,29 @@
+import type { PopPublicClient, PopWalletClient } from './types';
+export type FeeReceiversParams = {
+    publicClient: PopPublicClient;
+    clankerToken: `0x${string}`;
+    chainId: number;
+    userAddress?: `0x${string}`;
+};
+export type FeeReceiverAdmin = {
+    areYouAnAdmin: boolean;
+    admin: `0x${string}`;
+    recipient: `0x${string}`;
+    percentage: number;
+};
+export type UpdateFeeReceiverParams = {
+    walletClient: PopWalletClient;
+    clankerToken: `0x${string}`;
+    chainId: number;
+    rewardIndex: bigint | number;
+    newRecipient: `0x${string}`;
+};
+/**
+ * Get fee receivers for a clanker token
+ */
+export declare function feeReceivers({ publicClient, clankerToken, chainId, userAddress, }: FeeReceiversParams): Promise<FeeReceiverAdmin[] | undefined>;
+/**
+ * Update fee receiver for a clanker token
+ */
+export declare function updateFeeReceiver({ walletClient, clankerToken, chainId, rewardIndex, newRecipient, }: UpdateFeeReceiverParams): Promise<`0x${string}`>;
+//# sourceMappingURL=fee-receivers.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/governance.d.ts

@@ -0,0 +1,205 @@
+import type { TransactionReceipt } from 'viem';
+import type { PopPublicClient, PopWalletClient } from './types';
+export type GovernanceConfig = {
+    wallet: PopWalletClient;
+    publicClient: PopPublicClient;
+    governorAddress: `0x${string}`;
+    tokenDecimals: number;
+    clankerToken: `0x${string}`;
+    trustedForwarder?: `0x${string}`;
+};
+export type ProposalDetails = {
+    id: bigint;
+    proposalType: number;
+    proposer: `0x${string}`;
+    amount: bigint;
+    recipient: `0x${string}`;
+    description: string;
+    createdAt: bigint;
+    votingStartsAt: bigint;
+    votingEndsAt: bigint;
+    yesVotes: bigint;
+    noVotes: bigint;
+    totalBalanceVoted: bigint;
+    executed: boolean;
+    cycleId: bigint;
+};
+export type FormattedProposalDetails = {
+    id: bigint;
+    proposalType: number;
+    proposer: `0x${string}`;
+    amount: {
+        raw: bigint;
+        formatted: string;
+    };
+    recipient: `0x${string}`;
+    description: string;
+    createdAt: {
+        timestamp: bigint;
+        date: Date;
+    };
+    votingStartsAt: {
+        timestamp: bigint;
+        date: Date;
+    };
+    votingEndsAt: {
+        timestamp: bigint;
+        date: Date;
+    };
+    yesVotes: {
+        raw: bigint;
+        formatted: string;
+    };
+    noVotes: {
+        raw: bigint;
+        formatted: string;
+    };
+    totalBalanceVoted: bigint;
+    executed: boolean;
+    cycleId: bigint;
+};
+export type ProposeTransferConfig = {
+    recipient: `0x${string}`;
+    amount: string;
+    amountDecimals: number;
+    description: string;
+};
+export type ProposeBoostConfig = {
+    amount: string;
+    amountDecimals: number;
+};
+export type ExecuteProposalConfig = {
+    proposalId: number | bigint;
+};
+export declare class Governance {
+    private wallet;
+    private publicClient;
+    private governorAddress;
+    private tokenDecimals;
+    private clankerToken;
+    private userAddress;
+    constructor(config: GovernanceConfig);
+    /**
+     * Propose a transfer from treasury to recipient
+     */
+    proposeTransfer(recipient: `0x${string}`, amount: number | string | bigint, description: string): Promise<{
+        receipt: TransactionReceipt;
+        proposalId: bigint;
+    }>;
+    /**
+     * Propose a boost from treasury to staking rewards
+     */
+    proposeBoost(amount: number | string | bigint): Promise<{
+        receipt: TransactionReceipt;
+        proposalId: bigint;
+    }>;
+    /**
+     * Vote on a proposal
+     */
+    vote(proposalId: number | bigint, support: boolean): Promise<TransactionReceipt>;
+    /**
+     * Execute a proposal by ID
+     * 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
+     */
+    getVoteReceipt(proposalId: number | bigint, voter?: `0x${string}`): Promise<{
+        hasVoted: boolean;
+        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
+     */
+    claimAirdrop(): Promise<TransactionReceipt>;
+}
+//# sourceMappingURL=governance.d.ts.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+export * from './abis';
+export * from './balance';
+export * from './build-calldatas-v4';
+export * from './build-clanker-v4';
+export * from './constants';
+export * from './deploy-v4';
+export * from './fee-receivers';
+export * from './governance';
+export * from './project';
+export * from './projects';
+export * from './proposals';
+export * from './quote-v4';
+export * from './schema';
+export * from './stake';
+export * from './swap-v4';
+export * from './types';
+export * from './util';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/project.d.ts

@@ -0,0 +1,51 @@
+import type { PoolKey, PopPublicClient } from './types';
+export type ProjectParams = {
+    publicClient: PopPublicClient;
+    factoryAddress: `0x${string}`;
+    chainId: number;
+    clankerToken: `0x${string}`;
+};
+export type ProjectMetadata = {
+    description: string;
+    socialMediaUrls: [];
+    auditUrls: [];
+};
+export type PoolInfo = {
+    poolKey: PoolKey;
+    feeDisplay: string;
+    numPositions: bigint;
+};
+export type TreasuryStats = {
+    balance: {
+        raw: bigint;
+        formatted: string;
+    };
+    totalAllocated: {
+        raw: bigint;
+        formatted: string;
+    };
+    utilization: number;
+};
+export type Project = {
+    treasury: `0x${string}`;
+    governor: `0x${string}`;
+    staking: `0x${string}`;
+    stakedToken: `0x${string}`;
+    forwarder: `0x${string}`;
+    token: {
+        address: `0x${string}`;
+        decimals: number;
+        name: string;
+        symbol: string;
+        totalSupply: bigint;
+        metadata: ProjectMetadata | null;
+        imageUrl?: string;
+    };
+    pool?: PoolInfo;
+    treasuryStats?: TreasuryStats;
+};
+/**
+ * Get project data for a clanker token
+ */
+export declare function project({ publicClient, factoryAddress, chainId, clankerToken, }: ProjectParams): Promise<Project | null>;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEvD,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,eAAe,CAAA;IAC7B,cAAc,EAAE,KAAK,MAAM,EAAE,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,EAAE,CAAA;IACnB,SAAS,EAAE,EAAE,CAAA;CACd,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,cAAc,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAClD,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;IACvB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAA;IAC1B,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,KAAK,EAAE;QACL,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;QACtB,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,EAC5B,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,GACb,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA+JzC"}

package/dist/types/projects.d.ts

@@ -0,0 +1,20 @@
+import type { Project } from './project';
+import type { PopPublicClient } from './types';
+export type ProjectsParams = {
+    publicClient: PopPublicClient;
+    factoryAddress: `0x${string}`;
+    chainId: number;
+    fromBlock?: bigint;
+    toBlock?: bigint | 'latest';
+    pageSize?: number;
+};
+export type ProjectsResult = {
+    projects: Omit<Project, 'forwarder'>[];
+    fromBlock: bigint;
+    toBlock: bigint;
+};
+/**
+ * Get multiple projects data
+ */
+export declare function projects({ publicClient, factoryAddress, chainId, fromBlock, toBlock, pageSize, }: ProjectsParams): Promise<ProjectsResult>;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/projects.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAY,OAAO,EAAkC,MAAM,WAAW,CAAA;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,eAAe,CAAA;IAC7B,cAAc,EAAE,KAAK,MAAM,EAAE,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAcD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,YAAY,EACZ,cAAc,EACd,OAAO,EACP,SAAS,EACT,OAAkB,EAClB,QAAc,GACf,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CA+O1C"}

package/dist/types/proposals.d.ts

@@ -0,0 +1,20 @@
+import type { FormattedProposalDetails } from './governance';
+import type { PopPublicClient } from './types';
+export type ProposalsParams = {
+    publicClient: PopPublicClient;
+    governorAddress: `0x${string}`;
+    tokenDecimals?: number;
+    fromBlock?: bigint;
+    toBlock?: bigint | 'latest';
+    pageSize?: number;
+};
+export type ProposalsResult = {
+    proposals: FormattedProposalDetails[];
+    fromBlock: bigint;
+    toBlock: bigint;
+};
+/**
+ * Get multiple proposals data from governor contract
+ */
+export declare function proposals({ publicClient, governorAddress, tokenDecimals, fromBlock, toBlock, pageSize, }: ProposalsParams): Promise<ProposalsResult>;
+//# sourceMappingURL=proposals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../src/proposals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,eAAe,CAAA;IAC7B,eAAe,EAAE,KAAK,MAAM,EAAE,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,wBAAwB,EAAE,CAAA;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAcD;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAC9B,YAAY,EACZ,eAAe,EACf,aAAkB,EAClB,SAAS,EACT,OAAkB,EAClB,QAAa,GACd,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAoH5C"}

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

@@ -0,0 +1,54 @@
+import type { PublicClient } from 'viem';
+import type { PoolKey } from './types';
+export type QuoteV4Params = {
+    publicClient: PublicClient;
+    chainId: number;
+    poolKey: PoolKey;
+    zeroForOne: boolean;
+    amountIn: bigint;
+    hookData?: `0x${string}`;
+};
+export type QuoteV4ReturnType = {
+    amountOut: bigint;
+    gasEstimate: bigint;
+    /**
+     * Fee information from Clanker hooks (if available)
+     * - Static fees: clankerFee and pairedFee in basis points
+     * - Dynamic fees: baseFee and maxLpFee in basis points
+     */
+    hookFees?: {
+        type: 'static' | 'dynamic';
+        clankerFee?: number;
+        pairedFee?: number;
+        baseFee?: number;
+        maxLpFee?: number;
+    };
+};
+/**
+ * @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 declare const quoteV4: ({ publicClient, chainId, poolKey, zeroForOne, amountIn, hookData, }: QuoteV4Params) => Promise<QuoteV4ReturnType>;
+//# sourceMappingURL=quote-v4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quote-v4.d.ts","sourceRoot":"","sources":["../../src/quote-v4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAKxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF,CAAA;AA4HD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,OAAO,GAAU,qEAO3B,aAAa,KAAG,OAAO,CAAC,iBAAiB,CAwC3C,CAAA"}

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

@@ -0,0 +1,5 @@
+import { Schema } from 'effect';
+export declare const NonEmptyString: (message: string) => Schema.refine<string, typeof Schema.String>;
+export declare const UrlString: Schema.refine<string, typeof Schema.String>;
+export declare const EthereumAddress: Schema.Schema<`0x${string}`, `0x${string}`>;
+//# sourceMappingURL=base.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.schema.d.ts","sourceRoot":"","sources":["../../../src/schema/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,gDAG1C,CAAA;AAEJ,eAAO,MAAM,SAAS,6CAEpB,CAAA;AAEF,eAAO,MAAM,eAAe,EAItB,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC,CAAA"}