levr-sdk 0.2.2 → 0.3.0

package/dist/types/client/hook/use-deploy.d.ts

@@ -1,25 +1,22 @@
 import type { TransactionReceipt } from 'viem';
 export type UseDeployParams = {
     treasuryAirdropAmount?: number;
+    ipfsJsonUploadUrl?: string;
     onSuccess?: (params: {
         receipt: TransactionReceipt;
         address: `0x${string}`;
+        merkleTreeCID?: string;
     }) => void;
     onError?: (error: unknown) => void;
 };
 /**
  * Deploys a Clanker token and registers it with the Levr factory.
- * Returns tx hash and deployed address.
+ * Returns tx hash, deployed address, and merkle tree CID (if IPFS URL provided).
  */
-export declare function useDeploy({ onSuccess, onError }: UseDeployParams): import("@tanstack/react-query").UseMutationResult<import("../..").DeployV4ReturnType, unknown, {
+export declare function useDeploy({ ipfsJsonUploadUrl, onSuccess, onError }: UseDeployParams): import("@tanstack/react-query").UseMutationResult<import("../..").DeployV4ReturnType, unknown, {
     readonly symbol: string;
     readonly name: string;
-    readonly fees: {
-        readonly type: "static";
-        readonly feeTier: "1%" | "2%" | "3%";
-    } | {
-        readonly type: "dynamic 3%";
-    };
+    readonly image: string;
     readonly metadata?: {
         readonly description?: string | undefined;
         readonly telegramLink?: string | undefined;
@@ -27,19 +24,29 @@ export declare function useDeploy({ onSuccess, onError }: UseDeployParams): impo
         readonly xLink?: string | undefined;
         readonly farcasterLink?: string | undefined;
     } | undefined;
-    readonly image: string;
+    readonly fees: {
+        readonly type: "static";
+        readonly feeTier: "1%" | "2%" | "3%";
+    } | {
+        readonly type: "dynamic 3%";
+    };
+    readonly vault?: {
+        readonly percentage: "10%" | "20%" | "30%" | "5%" | "15%" | "25%";
+        readonly lockupPeriod: "30 days" | "90 days" | "180 days";
+        readonly vestingPeriod: "30 days" | "180 days" | "instant";
+    } | undefined;
     readonly airdrop?: readonly {
         readonly account: `0x${string}`;
-        readonly amount: number;
+        readonly percentage: number;
     }[] | undefined;
-    readonly devBuy?: "0.1 ETH" | "0.5 ETH" | "1 ETH" | undefined;
+    readonly devBuy?: "0.1 ETH" | "0.5 ETH" | "1 ETH" | "1.5 ETH" | undefined;
     readonly rewards?: readonly {
-        readonly recipient: `0x${string}`;
         readonly token: "Both" | "Paired" | "Clanker";
+        readonly recipient: `0x${string}`;
         readonly admin: `0x${string}`;
         readonly percentage: number;
     }[] | undefined;
-    readonly treasuryFunding: "30%" | "40%" | "50%" | "60%" | "70%" | "80%" | "90%";
-    readonly stakingReward?: "70%" | "80%" | "90%" | "100%" | undefined;
+    readonly treasuryFunding: "10%" | "20%" | "30%" | "40%" | "50%" | "60%" | "70%" | "80%" | "90%";
+    readonly stakingReward: "40%" | "50%" | "60%" | "70%" | "80%" | "90%" | "100%";
 }, unknown>;
 //# sourceMappingURL=use-deploy.d.ts.map

package/dist/types/client/hook/use-deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-deploy.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAM9C,MAAM,MAAM,eAAe,GAAG;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAQhE"}
+{"version":3,"file":"use-deploy.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAM9C,MAAM,MAAM,eAAe,GAAG;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,kBAAkB,CAAA;QAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,KAAK,IAAI,CAAA;IACV,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YASnF"}

package/dist/types/client/hook/use-factory.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hook to fetch factory configuration directly (used internally by LevrProvider)
+ * @internal
+ */
+export declare function useFactoryConfigQuery(params?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<Readonly<{
+    protocolFeeBps: number;
+    protocolTreasury: import("viem").Address;
+    streamWindowSeconds: number;
+    proposalWindowSeconds: number;
+    votingWindowSeconds: number;
+    maxActiveProposals: number;
+    quorumBps: number;
+    approvalBps: number;
+    minSTokenBpsToSubmit: number;
+    maxProposalAmountBps: number;
+}> | null, Error>;
+/**
+ * Hook to access factory config from LevrProvider
+ */
+export declare function useFactory(): import("@tanstack/react-query").UseQueryResult<Readonly<{
+    protocolFeeBps: number;
+    protocolTreasury: import("viem").Address;
+    streamWindowSeconds: number;
+    proposalWindowSeconds: number;
+    votingWindowSeconds: number;
+    maxActiveProposals: number;
+    quorumBps: number;
+    approvalBps: number;
+    minSTokenBpsToSubmit: number;
+    maxProposalAmountBps: number;
+}> | null>;
+//# sourceMappingURL=use-factory.d.ts.map

package/dist/types/client/hook/use-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-factory.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-factory.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;kBAiBnE;AAED;;GAEG;AACH,wBAAgB,UAAU;;;;;;;;;;;WAEzB"}

package/dist/types/client/hook/use-fee-receivers.d.ts

@@ -7,5 +7,5 @@ export type UseFeeReceiversParams = {
  * Hook to access fee receivers and update mutations
  * Fee receivers come from project.feeReceivers (with areYouAnAdmin already calculated)
  */
-export declare function useFeeReceivers({ onSuccess, onError }?: UseFeeReceiversParams): import("@tanstack/react-query").UseMutationResult<`0x${string}`, unknown, Omit<UpdateFeeReceiverParams, "chainId" | "walletClient">, unknown>;
+export declare function useFeeReceivers({ onSuccess, onError }?: UseFeeReceiversParams): import("@tanstack/react-query").UseMutationResult<import("viem").TransactionReceipt, unknown, Omit<UpdateFeeReceiverParams, "chainId" | "publicClient" | "walletClient">, unknown>;
 //# sourceMappingURL=use-fee-receivers.d.ts.map

package/dist/types/client/hook/use-fee-receivers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-fee-receivers.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-fee-receivers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAUlE,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,GAAE,qBAA0B,iJAmBjF"}
+{"version":3,"file":"use-fee-receivers.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-fee-receivers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAUlE,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,GAAE,qBAA0B,sLAsBjF"}

package/dist/types/client/hook/use-governance.d.ts

@@ -1,6 +1,5 @@
 import type { TransactionReceipt } from 'viem';
 import type { ExecuteProposalConfig, ProposeBoostConfig, ProposeTransferConfig } from '../../governance';
-import type { AirdropStatus } from '../../treasury';
 export type UseGovernanceParams = {
     proposalId?: number | bigint;
     cycleId?: number | bigint;
@@ -34,7 +33,24 @@ export declare function useGovernance({ proposalId, cycleId, userAddress, onProp
         support: boolean;
     }, unknown>;
     executeProposal: import("@tanstack/react-query").UseMutationResult<TransactionReceipt, unknown, ExecuteProposalConfig, unknown>;
-    claimAirdrop: import("@tanstack/react-query").UseMutationResult<TransactionReceipt, unknown, AirdropStatus, unknown>;
+    claimAirdrop: import("@tanstack/react-query").UseMutationResult<TransactionReceipt, unknown, {
+        address: `0x${string}`;
+        allocatedAmount: {
+            raw: bigint;
+        };
+        proof: `0x${string}`[];
+        isAvailable: boolean;
+        error?: string;
+    }, unknown>;
+    claimAirdropBatch: import("@tanstack/react-query").UseMutationResult<TransactionReceipt, unknown, {
+        address: `0x${string}`;
+        allocatedAmount: {
+            raw: bigint;
+        };
+        proof: `0x${string}`[];
+        isAvailable: boolean;
+        error?: string;
+    }[], unknown>;
     buildProposeTransferConfig: ({ recipient, amount, amountDecimals, description, }: {
         recipient: `0x${string}`;
         amount: number | string;

package/dist/types/client/hook/use-governance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-governance.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-governance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAI9C,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAOnD,MAAM,MAAM,mBAAmB,GAAG;IAEhC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IAG3B,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACpF,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEjD,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACjF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAE9C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACrD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAChE,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEjD,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC7D,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,OAAO,EACP,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,GAAE,mBAAwB;;;;;;;;;;oBAuBT,MAAM,GAAG,MAAM;iBAClB,OAAO;;;;sFAyFjB;QACD,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;QACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,WAAW,EAAE,MAAM,CAAA;KACpB,KAAG,qBAAqB;2DAUtB;QACD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,KAAG,kBAAkB;kDAOnB;QACD,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;KAC5B,KAAG,qBAAqB;;;;;;EAwB1B"}
+{"version":3,"file":"use-governance.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-governance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAI9C,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAQzB,MAAM,MAAM,mBAAmB,GAAG;IAEhC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IAG3B,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACpF,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEjD,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACjF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAE9C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACrD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAChE,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEjD,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC7D,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,OAAO,EACP,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,GAAE,mBAAwB;;;;;;;;;;oBAuBT,MAAM,GAAG,MAAM;iBAClB,OAAO;;;;iBAuEP,KAAK,MAAM,EAAE;yBACL;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE;eACzB,KAAK,MAAM,EAAE,EAAE;qBACT,OAAO;gBACZ,MAAM;;;iBAgBL,KAAK,MAAM,EAAE;yBACL;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE;eACzB,KAAK,MAAM,EAAE,EAAE;qBACT,OAAO;gBACZ,MAAM;;sFAoBf;QACD,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;QACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,WAAW,EAAE,MAAM,CAAA;KACpB,KAAG,qBAAqB;2DAUtB;QACD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,KAAG,kBAAkB;kDAOnB;QACD,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;KAC5B,KAAG,qBAAqB;;;;;;EAyB1B"}

package/dist/types/client/hook/use-project.d.ts

@@ -20,7 +20,175 @@ export type UseProjectQueryParams = {
  * Used by LevrProvider
  * Fetches dynamic stats (treasury, staking, governance, pricing) using static data from useStaticProjectQuery
  */
-export declare function useProjectQuery({ clankerToken, oraclePublicClient, enabled: e, }: UseProjectQueryParams): import("@tanstack/react-query").UseQueryResult<import("../..").Project | null, Error>;
+export declare function useProjectQuery({ clankerToken, oraclePublicClient, enabled: e, }: UseProjectQueryParams): {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: import("../..").Project | null;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+} | {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: import("../..").Project | null;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+} | {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+} | {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+} | {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+} | {
+    refetchStatic: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<StaticProject | null, Error>>;
+    data: import("../..").Project | null;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("../..").Project | null, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<import("../..").Project | null>;
+};
 export type UseProjectsParams = {
     enabled?: boolean;
 } & Omit<ProjectsParams, 'publicClient'>;

package/dist/types/client/hook/use-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-project.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,YAAY,EACZ,OAAO,EAAE,CAAQ,GAClB,EAAE,2BAA2B,+EAkB7B;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,kBAAkB,EAAE,eAAe,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,YAAY,EACZ,kBAAkB,EAClB,OAAO,EAAE,CAAQ,GAClB,EAAE,qBAAqB,yFAuBvB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;AAExC,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAE,iBAAsB,yEAiBvF"}
+{"version":3,"file":"use-project.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,YAAY,EACZ,OAAO,EAAE,CAAQ,GAClB,EAAE,2BAA2B,+EAkB7B;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,kBAAkB,EAAE,eAAe,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,YAAY,EACZ,kBAAkB,EAClB,OAAO,EAAE,CAAQ,GAClB,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BvB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;AAExC,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAE,iBAAsB,yEAiBvF"}

package/dist/types/client/hook/use-proposal.d.ts

@@ -1,6 +1,7 @@
 import type { Project } from '../..';
 export type UseProposalsQueryParams = {
     project: Project | null | undefined;
+    cycleId?: bigint;
     enabled?: boolean;
 };
 export type UseProposalParams = {
@@ -10,9 +11,9 @@ export type UseProposalParams = {
 /**
  * Internal: Creates proposals query with all logic
  * Used by LevrProvider
- * Gets all proposals for current cycle with enriched data in single multicall
+ * Gets proposals for specified cycle (or current cycle if not provided) with enriched data in single multicall
  * Includes vote receipts if user is connected
  */
-export declare function useProposalsQuery({ project, enabled: e }: UseProposalsQueryParams): import("@tanstack/react-query").UseQueryResult<import("../..").ProposalsResult, Error>;
+export declare function useProposalsQuery({ project, cycleId, enabled: e, }: UseProposalsQueryParams): import("@tanstack/react-query").UseQueryResult<import("../..").ProposalsResult, Error>;
 export declare function useProposal({ proposalId, enabled: e }: UseProposalParams): import("@tanstack/react-query").UseQueryResult<import("../..").EnrichedProposalDetails, Error>;
 //# sourceMappingURL=use-proposal.d.ts.map

package/dist/types/client/hook/use-proposal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-proposal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAKpC,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAQ,EAAE,EAAE,uBAAuB,0FA0BxF;AAED,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAQ,EAAE,EAAE,iBAAiB,kGAwB/E"}
+{"version":3,"file":"use-proposal.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-proposal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAKpC,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,OAAO,EACP,OAAO,EAAE,CAAQ,GAClB,EAAE,uBAAuB,0FA8BzB;AAED,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAQ,EAAE,EAAE,iBAAiB,kGAwB/E"}

package/dist/types/client/hook/use-vault.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Hook to fetch complete vault data for a token
+ * Returns both allocation and claimable information with computed status
+ * @param token - Token address
+ * @param chainId - Optional chain ID
+ */
+export declare const useVault: (token: `0x${string}` | undefined, chainId?: number) => import("@tanstack/react-query").UseQueryResult<import("../..").VaultStatusData | null, Error>;
+/**
+ * Hook to claim vaulted tokens
+ * Uses the Clanker SDK internally - pass the token to claim
+ */
+export declare const useVaultClaim: () => import("@tanstack/react-query").UseMutationResult<`0x${string}` | import("viem").TransactionReceipt, Error, `0x${string}`, unknown>;
+//# sourceMappingURL=use-vault.d.ts.map

package/dist/types/client/hook/use-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-vault.d.ts","sourceRoot":"","sources":["../../../../src/client/hook/use-vault.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,MAAM,kGAkB1E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,2IAmCzB,CAAA"}

package/dist/types/client/levr-provider.d.ts

@@ -2,6 +2,7 @@ import type { UseQueryResult } from '@tanstack/react-query';
 import React from 'react';
 import type { Address } from 'viem';
 import type { AirdropStatus } from '..';
+import type { FactoryConfig } from '../factory';
 import type { PoolData } from '../pool';
 import type { Project } from '../project';
 import type { ProposalsResult } from '../proposal';
@@ -15,11 +16,14 @@ export type LevrContextValue = {
     setClankerToken: (token: Address | null) => void;
     chainId: number | undefined;
     userAddress: Address | undefined;
+    selectedCycleId: bigint | null;
+    setSelectedCycleId: (cycleId: bigint | null) => void;
     user: UseQueryResult<User | null>;
     project: UseQueryResult<Project | null>;
     pool: UseQueryResult<PoolData | null>;
     proposals: UseQueryResult<ProposalsResult | null>;
     airdropStatus: UseQueryResult<AirdropStatus | null>;
+    factoryConfig: UseQueryResult<FactoryConfig | null>;
     refetch: {
         all: () => Promise<void>;
         user: () => Promise<void>;
@@ -54,12 +58,22 @@ export type LevrProviderProps = {
      * If not provided, uses public RPC endpoints
      */
     oracleRpcUrl?: string;
+    /**
+     * Full URL to /api/ipfs-search endpoint
+     * Required for multi-recipient airdrop proof generation
+     */
+    ipfsSearchUrl?: string;
+    /**
+     * Full URL to /api/ipfs-json endpoint
+     * Required for multi-recipient airdrop proof generation
+     */
+    ipfsJsonUrl?: string;
 };
 /**
  * Centralized provider for all Levr blockchain queries
  * Eliminates query duplication and provides unified refetch management
  */
-export declare function LevrProvider({ children, enabled, oracleChainId, oracleRpcUrl, }: LevrProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function LevrProvider({ children, enabled, oracleChainId, oracleRpcUrl, ipfsSearchUrl, ipfsJsonUrl, }: LevrProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access Levr context
  * @throws Error if used outside LevrProvider

package/dist/types/client/levr-provider.d.ts.map

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

package/dist/types/client/query-keys.d.ts

@@ -5,7 +5,11 @@ import type { Address } from 'viem';
  */
 export declare const queryKeys: {
     /**
-     * Project query key
+     * Static project query key (doesn't change frequently - includes feeSplitter config)
+     */
+    readonly staticProject: (token: Address, chainId: number) => readonly ["static-project", `0x${string}`, number];
+    /**
+     * Project query key (dynamic data - treasury stats, staking stats, etc.)
      */
     readonly project: (token: Address, chainId: number) => readonly ["project", `0x${string}`, number];
     /**
@@ -45,5 +49,13 @@ export declare const queryKeys: {
     readonly swap: {
         readonly quote: (chainId?: number, poolKey?: unknown, zeroForOne?: boolean, amountIn?: string, amountInDecimals?: number) => readonly ["swap", "quote", number | undefined, unknown, boolean | undefined, string | undefined, number | undefined];
     };
+    /**
+     * Factory config query keys (static per chain)
+     */
+    readonly factoryConfig: (chainId?: number) => readonly ["factory-config", number | undefined];
+    /**
+     * Vault query keys
+     */
+    readonly vault: (token?: Address, chainId?: number) => readonly ["vault", `0x${string}` | undefined, number | undefined];
 };
 //# sourceMappingURL=query-keys.d.ts.map

package/dist/types/client/query-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../../src/client/query-keys.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;8BACc,OAAO,WAAW,MAAM;IAEzC;;OAEG;iCACiB,OAAO,SAAS,OAAO,WAAW,OAAO,YAAY,OAAO;IAGhF;;OAEG;8BACc,OAAO;IAExB;;OAEG;iCACiB,MAAM,kBAAkB,OAAO;2CAGrB,OAAO;IAErC;;OAEG;;8CAE4B,OAAO,eAAe,MAAM;uDAEnB,OAAO,YAAY,MAAM;4CAEpC,OAAO,YAAY,MAAM;qDAEhB,OAAO,YAAY,MAAM,gBAAgB,OAAO;;IAItF;;OAEG;mCACmB,MAAM,YAAY,MAAM,gBAAgB,OAAO;kCAGhD,MAAM,YAAY,MAAM,eAAe,MAAM;IAGlE;;OAEG;yCACyB,OAAO,YAAY,MAAM;IAGrD;;OAEG;;mCAGW,MAAM,YACN,OAAO,eACJ,OAAO,aACT,MAAM,qBACE,MAAM;;CAGrB,CAAA"}
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../../src/client/query-keys.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;oCACoB,OAAO,WAAW,MAAM;IAE/C;;OAEG;8BACc,OAAO,WAAW,MAAM;IAEzC;;OAEG;iCACiB,OAAO,SAAS,OAAO,WAAW,OAAO,YAAY,OAAO;IAGhF;;OAEG;8BACc,OAAO;IAExB;;OAEG;iCACiB,MAAM,kBAAkB,OAAO;2CAGrB,OAAO;IAErC;;OAEG;;8CAE4B,OAAO,eAAe,MAAM;uDAEnB,OAAO,YAAY,MAAM;4CAEpC,OAAO,YAAY,MAAM;qDAEhB,OAAO,YAAY,MAAM,gBAAgB,OAAO;;IAItF;;OAEG;mCACmB,MAAM,YAAY,MAAM,gBAAgB,OAAO;kCAGhD,MAAM,YAAY,MAAM,eAAe,MAAM;IAGlE;;OAEG;yCACyB,OAAO,YAAY,MAAM;IAGrD;;OAEG;;mCAGW,MAAM,YACN,OAAO,eACJ,OAAO,aACT,MAAM,qBACE,MAAM;;IAI7B;;OAEG;uCACuB,MAAM;IAEhC;;OAEG;6BACa,OAAO,YAAY,MAAM;CACjC,CAAA"}

package/dist/types/constants.d.ts

@@ -11,6 +11,12 @@ export declare const GET_LP_LOCKER_ADDRESS: (chainId?: number) => `0x${string}`
  * @returns The factory address
  */
 export declare const GET_FACTORY_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the fee splitter factory address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The fee splitter factory address
+ */
+export declare const GET_FEE_SPLITTER_FACTORY_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
 /**
  * Get the WETH address for a given chain ID
  * @param chainId - The chain ID
@@ -70,6 +76,12 @@ export declare const GET_CLANKER_FACTORY_ADDRESS: (chainId?: number) => `0x${str
  * @returns The Clanker Airdrop address
  */
 export declare const GET_CLANKER_AIRDROP_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
+/**
+ * Get the Vault address for a given chain ID
+ * @param chainId - The chain ID
+ * @returns The Vault address
+ */
+export declare const GET_VAULT_ADDRESS: (chainId?: number) => `0x${string}` | undefined;
 /**
  * Contract balance representation, for use in Universal Router
  */
@@ -87,6 +99,8 @@ export declare const ADDRESS_THIS = "0x0000000000000000000000000000000000000002"
  * First value is used as default in deployV4
  */
 export declare const TREASURY_AIRDROP_AMOUNTS: {
+    readonly '10%': 10000000000;
+    readonly '20%': 20000000000;
     readonly '30%': 30000000000;
     readonly '40%': 40000000000;
     readonly '50%': 50000000000;
@@ -95,21 +109,65 @@ export declare const TREASURY_AIRDROP_AMOUNTS: {
     readonly '80%': 80000000000;
     readonly '90%': 90000000000;
 };
+/**
+ * Levr team wallet address that receives LP fees from deployments
+ */
+export declare const LEVR_TEAM_WALLET: "0x5AeeA3DF830529a61695A63ba020F01191E0aECb";
+/**
+ * Percentage of LP fees allocated to Levr team (0-100)
+ * This is automatically included in all deployments via the UI
+ */
+export declare const LEVR_TEAM_LP_FEE_PERCENTAGE: 2;
 /**
  * Staking rewards in basis points
- * The amount of rewards that are distributed to the staking contract
+ * User-facing percentages of LP fees allocated to staking (before team fee is subtracted)
+ * Note: Team fee is automatically deducted in the deployment logic
  */
 export declare const STAKING_REWARDS: {
     readonly '100%': 10000;
     readonly '90%': 9000;
     readonly '80%': 8000;
     readonly '70%': 7000;
+    readonly '60%': 6000;
+    readonly '50%': 5000;
+    readonly '40%': 4000;
 };
 export declare const STATIC_FEE_TIERS: {
     readonly '1%': 100;
     readonly '2%': 200;
     readonly '3%': 300;
 };
+/**
+ * Vault lockup period options (in days)
+ * Tokens are locked for this period and cannot be claimed
+ */
+export declare const VAULT_LOCKUP_PERIODS: {
+    readonly '30 days': 30;
+    readonly '90 days': 90;
+    readonly '180 days': 180;
+};
+/**
+ * Vault vesting period options (in days)
+ * Linear vesting occurs between end of lockup and end of vesting period
+ * 'instant' means tokens are claimable immediately once lockup ends (no vesting period)
+ */
+export declare const VAULT_VESTING_PERIODS: {
+    readonly instant: 0;
+    readonly '30 days': 30;
+    readonly '180 days': 180;
+};
+/**
+ * Vault allocation percentage options
+ * Percentage of total token supply (100B tokens) allocated to vault
+ */
+export declare const VAULT_PERCENTAGES: {
+    readonly '5%': 5;
+    readonly '10%': 10;
+    readonly '15%': 15;
+    readonly '20%': 20;
+    readonly '25%': 25;
+    readonly '30%': 30;
+};
 /**
  * Get the USDC address for a given chain ID
  * @param chainId - The chain ID

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

@@ -1 +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,qBAAqB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQxE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQvE,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;AAEV;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAOnE,CAAA"}
+{"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,SAQtE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQnF,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,qBAAqB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQxE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAQvE,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;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAWpE,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;;;;;;;;;;CAU3B,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAG,4CAAqD,CAAA;AAErF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAA;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;CAQlB,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;CAInB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,KAAK,MAAM,EAAE,GAAG,SAOnE,CAAA"}

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

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

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

@@ -1 +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"}
+{"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;AAO9C,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;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,kBAAkB,CAAA;IAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAU,oCAI5B,cAAc,KAAG,OAAO,CAAC,kBAAkB,CAsG7C,CAAA"}