pepay-streams-sdk 0.1.0

package/dist/react/index.mjs

@@ -0,0 +1,333 @@
+// src/react/index.ts
+function getConfigFromEnv() {
+  if (typeof process === "undefined") {
+    return {};
+  }
+  const config = {
+    chainId: Number(
+      process.env.NEXT_PUBLIC_CHAIN_ID ?? process.env.CHAIN_ID ?? "1"
+    )
+  };
+  const rpcUrl = process.env.NEXT_PUBLIC_RPC_URL ?? process.env.RPC_URL;
+  if (rpcUrl) {
+    config.rpcUrl = rpcUrl;
+  }
+  const diamondAddress = process.env.NEXT_PUBLIC_DIAMOND_ADDRESS ?? process.env.DIAMOND_ADDRESS;
+  if (diamondAddress) {
+    config.diamondAddress = diamondAddress;
+  }
+  const apiBaseUrl = process.env.NEXT_PUBLIC_API_URL ?? process.env.API_URL;
+  if (apiBaseUrl) {
+    config.apiBaseUrl = apiBaseUrl;
+  }
+  return config;
+}
+var CONTEXT_EXAMPLE = `
+// Example usage with wagmi and React
+
+import { createContext, useContext, useState, useEffect, ReactNode } from 'react';
+import { PepayStreamsClient, PepayStreamsClientWithSigner, PepayStreamsConfig } from '@pepay-streams/sdk';
+import { useWalletClient, usePublicClient, useAccount, useChainId } from 'wagmi';
+
+interface PepayStreamsContextValue {
+  client: PepayStreamsClient | PepayStreamsClientWithSigner | null;
+  isConnected: boolean;
+  isLoading: boolean;
+}
+
+const PepayStreamsContext = createContext<PepayStreamsContextValue>({
+  client: null,
+  isConnected: false,
+  isLoading: true,
+});
+
+export function PepayStreamsProvider({
+  children,
+  config,
+}: {
+  children: ReactNode;
+  config: PepayStreamsConfig;
+}) {
+  const { isConnected } = useAccount();
+  const chainId = useChainId();
+  const { data: walletClient, isLoading: walletLoading } = useWalletClient();
+  const [client, setClient] = useState<PepayStreamsClient | null>(null);
+
+  useEffect(() => {
+    const newClient = new PepayStreamsClient({
+      ...config,
+      chainId,
+    });
+
+    if (walletClient && isConnected) {
+      setClient(newClient.withSigner(walletClient));
+    } else {
+      setClient(newClient);
+    }
+  }, [walletClient, isConnected, chainId, config]);
+
+  return (
+    <PepayStreamsContext.Provider
+      value={{
+        client,
+        isConnected,
+        isLoading: walletLoading,
+      }}
+    >
+      {children}
+    </PepayStreamsContext.Provider>
+  );
+}
+
+export function usePepayStreams() {
+  return useContext(PepayStreamsContext);
+}
+
+// Usage in components:
+function ClaimButton({ campaignId }: { campaignId: bigint }) {
+  const { client, isConnected } = usePepayStreams();
+  const [loading, setLoading] = useState(false);
+
+  const handleClaim = async () => {
+    if (!client || !isConnected) return;
+
+    setLoading(true);
+    try {
+      const result = await client.claims.claim({ campaignId });
+      await result.wait();
+      console.log('Claimed!');
+    } catch (error) {
+      console.error('Claim failed:', error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <button onClick={handleClaim} disabled={!isConnected || loading}>
+      {loading ? 'Claiming...' : 'Claim'}
+    </button>
+  );
+}
+`;
+var queryKeys = {
+  // Campaigns
+  campaigns: (params) => ["pepay", "campaigns", params],
+  campaign: (id) => ["pepay", "campaign", String(id)],
+  campaignRecipients: (id, page) => ["pepay", "campaign", String(id), "recipients", page],
+  campaignActivity: (id, page) => ["pepay", "campaign", String(id), "activity", page],
+  // Claims
+  dueAmount: (campaignId, address) => ["pepay", "dueAmount", String(campaignId), address],
+  recipientStatus: (campaignId, address) => ["pepay", "recipientStatus", String(campaignId), address],
+  // Staking
+  stakingPools: (params) => ["pepay", "staking", "pools", params],
+  stakingPool: (id) => ["pepay", "staking", "pool", String(id)],
+  userStake: (poolId, address) => ["pepay", "staking", "userStake", String(poolId), address],
+  pendingRewards: (poolId, address) => ["pepay", "staking", "pendingRewards", String(poolId), address],
+  // Marketplace
+  orders: (params) => ["pepay", "marketplace", "orders", params],
+  order: (id) => ["pepay", "marketplace", "order", String(id)],
+  orderQuote: (id) => ["pepay", "marketplace", "order", String(id), "quote"],
+  // Wallet
+  walletActivity: (address) => ["pepay", "wallet", address, "activity"],
+  walletPositions: (address) => ["pepay", "wallet", address, "positions"],
+  walletClaims: (address, page) => ["pepay", "wallet", address, "claims", page],
+  // Tokens
+  tokenBalance: (token, address) => ["pepay", "token", token, "balance", address],
+  tokenAllowance: (token, owner, spender) => ["pepay", "token", token, "allowance", owner, spender],
+  tokenInfo: (token) => ["pepay", "token", token, "info"],
+  // Automation
+  autoWithdrawStatus: (campaignId) => ["pepay", "automation", "autoWithdraw", String(campaignId)],
+  autoReleaseStatus: (campaignId) => ["pepay", "automation", "autoRelease", String(campaignId)]
+};
+var mutationKeys = {
+  claim: (campaignId) => ["pepay", "mutation", "claim", String(campaignId)],
+  claimBatch: () => ["pepay", "mutation", "claimBatch"],
+  stake: (poolId) => ["pepay", "mutation", "stake", String(poolId)],
+  unstake: (poolId) => ["pepay", "mutation", "unstake", String(poolId)],
+  fillOrder: (orderId) => ["pepay", "mutation", "fillOrder", String(orderId)],
+  cancelOrder: (orderId) => ["pepay", "mutation", "cancelOrder", String(orderId)],
+  approve: (token) => ["pepay", "mutation", "approve", token]
+};
+var HOOK_EXAMPLES = `
+// Custom hooks for common operations
+
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { usePepayStreams, queryKeys, mutationKeys } from '@pepay-streams/sdk/react';
+import { parseEther } from 'viem';
+
+// Hook: Get campaign with due amount
+export function useCampaignWithDue(campaignId: bigint, recipientAddress: Address) {
+  const { client } = usePepayStreams();
+
+  const campaign = useQuery({
+    queryKey: queryKeys.campaign(campaignId),
+    queryFn: () => client!.campaigns.getCampaign(campaignId),
+    enabled: !!client,
+  });
+
+  const dueAmount = useQuery({
+    queryKey: queryKeys.dueAmount(campaignId, recipientAddress),
+    queryFn: () => client!.claims.getDueAmount(campaignId, recipientAddress),
+    enabled: !!client && !!recipientAddress,
+    refetchInterval: 30000, // Refresh every 30s
+  });
+
+  return {
+    campaign: campaign.data,
+    dueAmount: dueAmount.data,
+    isLoading: campaign.isLoading || dueAmount.isLoading,
+  };
+}
+
+// Hook: Claim mutation with optimistic updates
+export function useClaim() {
+  const { client } = usePepayStreams();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ campaignId }: { campaignId: bigint }) => {
+      const result = await client!.claims.claim({ campaignId });
+      return result.wait();
+    },
+    onSuccess: (_, { campaignId }) => {
+      // Invalidate related queries
+      queryClient.invalidateQueries({ queryKey: queryKeys.campaign(campaignId) });
+      queryClient.invalidateQueries({ queryKey: ['pepay', 'dueAmount', String(campaignId)] });
+    },
+  });
+}
+
+// Hook: Stake with approval check
+export function useStake() {
+  const { client } = usePepayStreams();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      poolId,
+      amount,
+      stakeToken,
+    }: {
+      poolId: bigint;
+      amount: bigint;
+      stakeToken: Address;
+    }) => {
+      // Check and approve if needed
+      const approval = await (client as PepayStreamsClientWithSigner).ensureAllowance(stakeToken, amount);
+      if (approval) {
+        await approval.wait();
+      }
+
+      // Stake
+      const result = await client!.staking.stake(poolId, amount);
+      return result.wait();
+    },
+    onSuccess: (_, { poolId }) => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.stakingPool(poolId) });
+      queryClient.invalidateQueries({ queryKey: ['pepay', 'staking', 'userStake', String(poolId)] });
+    },
+  });
+}
+
+// Hook: Fill order with price display
+export function useOrderWithQuote(orderId: bigint) {
+  const { client } = usePepayStreams();
+
+  const order = useQuery({
+    queryKey: queryKeys.order(orderId),
+    queryFn: () => client!.marketplace.getOrder(orderId),
+    enabled: !!client,
+  });
+
+  const quote = useQuery({
+    queryKey: queryKeys.orderQuote(orderId),
+    queryFn: () => client!.marketplace.getQuote(orderId),
+    enabled: !!client && order.data?.status === 'open',
+    refetchInterval: 10000, // Refresh quote every 10s
+  });
+
+  return {
+    order: order.data,
+    quote: quote.data,
+    isLoading: order.isLoading || quote.isLoading,
+    canFill: quote.data?.isValid ?? false,
+  };
+}
+`;
+var formatters = {
+  /**
+   * Format token amount with decimals
+   */
+  formatTokenAmount(amount, decimals = 18, maxDecimals = 4) {
+    const divisor = BigInt(10 ** decimals);
+    const integerPart = amount / divisor;
+    const fractionalPart = amount % divisor;
+    const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+    const trimmedFractional = fractionalStr.slice(0, maxDecimals).replace(/0+$/, "");
+    if (trimmedFractional) {
+      return `${integerPart}.${trimmedFractional}`;
+    }
+    return integerPart.toString();
+  },
+  /**
+   * Format USD amount
+   */
+  formatUsd(amount) {
+    const num = typeof amount === "string" ? parseFloat(amount) : amount;
+    return new Intl.NumberFormat("en-US", {
+      style: "currency",
+      currency: "USD",
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2
+    }).format(num);
+  },
+  /**
+   * Format percentage
+   */
+  formatPercent(value, decimals = 2) {
+    return `${value.toFixed(decimals)}%`;
+  },
+  /**
+   * Format timestamp to date string
+   */
+  formatDate(timestamp) {
+    return new Date(timestamp * 1e3).toLocaleDateString();
+  },
+  /**
+   * Format timestamp to relative time
+   */
+  formatRelativeTime(timestamp) {
+    const now = Math.floor(Date.now() / 1e3);
+    const diff = timestamp - now;
+    if (diff < 0) {
+      const absDiff = Math.abs(diff);
+      if (absDiff < 60) return "just now";
+      if (absDiff < 3600) return `${Math.floor(absDiff / 60)}m ago`;
+      if (absDiff < 86400) return `${Math.floor(absDiff / 3600)}h ago`;
+      return `${Math.floor(absDiff / 86400)}d ago`;
+    }
+    if (diff < 60) return "in < 1m";
+    if (diff < 3600) return `in ${Math.floor(diff / 60)}m`;
+    if (diff < 86400) return `in ${Math.floor(diff / 3600)}h`;
+    return `in ${Math.floor(diff / 86400)}d`;
+  },
+  /**
+   * Format vesting progress
+   */
+  formatVestingProgress(claimed, allocated) {
+    if (allocated === 0n) return "0%";
+    const progress = Number(claimed * 100n / allocated);
+    return `${progress.toFixed(1)}%`;
+  },
+  /**
+   * Shorten address for display
+   */
+  shortenAddress(address, chars = 4) {
+    return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
+  }
+};
+
+export { CONTEXT_EXAMPLE, HOOK_EXAMPLES, formatters, getConfigFromEnv, mutationKeys, queryKeys };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * React Integration Helpers\r\n *\r\n * Provides React-friendly patterns for using the SDK:\r\n * - Context provider\r\n * - Hooks for common operations\r\n * - Type-safe query helpers\r\n */\r\n\r\n// Note: This module provides patterns and helpers, not actual React hooks,\r\n// since we want to avoid React as a hard dependency.\r\n\r\nimport type { Address } from 'viem';\r\nimport type { PepayStreamsConfig } from '../types';\r\nimport { PepayStreamsClient, PepayStreamsClientWithSigner } from '../client';\r\n\r\n/**\r\n * SDK context value type for React context\r\n */\r\nexport interface PepayStreamsContextValue {\r\n  /** SDK client instance */\r\n  client: PepayStreamsClient | PepayStreamsClientWithSigner | null;\r\n  /** Whether the client has a signer */\r\n  isConnected: boolean;\r\n  /** Connected wallet address */\r\n  address: Address | null;\r\n  /** Chain ID */\r\n  chainId: number;\r\n  /** Diamond contract address */\r\n  diamondAddress: Address;\r\n}\r\n\r\n/**\r\n * Configuration for creating SDK context\r\n */\r\nexport interface CreateContextConfig extends PepayStreamsConfig {\r\n  /** Auto-connect on mount */\r\n  autoConnect?: boolean;\r\n}\r\n\r\n/**\r\n * Helper to create SDK client configuration from environment\r\n */\r\nexport function getConfigFromEnv(): Partial<PepayStreamsConfig> {\r\n  if (typeof process === 'undefined') {\r\n    return {};\r\n  }\r\n\r\n  const config: Partial<PepayStreamsConfig> = {\r\n    chainId: Number(\r\n      process.env.NEXT_PUBLIC_CHAIN_ID ?? process.env.CHAIN_ID ?? '1'\r\n    ),\r\n  };\r\n\r\n  const rpcUrl = process.env.NEXT_PUBLIC_RPC_URL ?? process.env.RPC_URL;\r\n  if (rpcUrl) {\r\n    config.rpcUrl = rpcUrl;\r\n  }\r\n\r\n  const diamondAddress = process.env.NEXT_PUBLIC_DIAMOND_ADDRESS ??\r\n    process.env.DIAMOND_ADDRESS;\r\n  if (diamondAddress) {\r\n    config.diamondAddress = diamondAddress as Address;\r\n  }\r\n\r\n  const apiBaseUrl = process.env.NEXT_PUBLIC_API_URL ?? process.env.API_URL;\r\n  if (apiBaseUrl) {\r\n    config.apiBaseUrl = apiBaseUrl;\r\n  }\r\n\r\n  return config;\r\n}\r\n\r\n/**\r\n * Example React context creation pattern\r\n *\r\n * @example\r\n * ```tsx\r\n * // contexts/PepayStreams.tsx\r\n * import { createContext, useContext, useState, useEffect } from 'react';\r\n * import { PepayStreamsClient, PepayStreamsClientWithSigner } from '@pepay-streams/sdk';\r\n * import { useWalletClient, usePublicClient, useAccount } from 'wagmi';\r\n *\r\n * const PepayStreamsContext = createContext<PepayStreamsContextValue | null>(null);\r\n *\r\n * export function PepayStreamsProvider({ children, config }) {\r\n *   const { address, isConnected } = useAccount();\r\n *   const publicClient = usePublicClient();\r\n *   const { data: walletClient } = useWalletClient();\r\n *   const [client, setClient] = useState<PepayStreamsClient | null>(null);\r\n *\r\n *   useEffect(() => {\r\n *     if (!publicClient) return;\r\n *\r\n *     if (walletClient && isConnected) {\r\n *       setClient(new PepayStreamsClient(config).withSigner(walletClient));\r\n *     } else {\r\n *       setClient(new PepayStreamsClient(config));\r\n *     }\r\n *   }, [publicClient, walletClient, isConnected]);\r\n *\r\n *   return (\r\n *     <PepayStreamsContext.Provider value={{ client, isConnected, address, ... }}>\r\n *       {children}\r\n *     </PepayStreamsContext.Provider>\r\n *   );\r\n * }\r\n *\r\n * export function usePepayStreams() {\r\n *   const context = useContext(PepayStreamsContext);\r\n *   if (!context) throw new Error('Must be used within PepayStreamsProvider');\r\n *   return context;\r\n * }\r\n * ```\r\n */\r\nexport const CONTEXT_EXAMPLE = `\r\n// Example usage with wagmi and React\r\n\r\nimport { createContext, useContext, useState, useEffect, ReactNode } from 'react';\r\nimport { PepayStreamsClient, PepayStreamsClientWithSigner, PepayStreamsConfig } from '@pepay-streams/sdk';\r\nimport { useWalletClient, usePublicClient, useAccount, useChainId } from 'wagmi';\r\n\r\ninterface PepayStreamsContextValue {\r\n  client: PepayStreamsClient | PepayStreamsClientWithSigner | null;\r\n  isConnected: boolean;\r\n  isLoading: boolean;\r\n}\r\n\r\nconst PepayStreamsContext = createContext<PepayStreamsContextValue>({\r\n  client: null,\r\n  isConnected: false,\r\n  isLoading: true,\r\n});\r\n\r\nexport function PepayStreamsProvider({\r\n  children,\r\n  config,\r\n}: {\r\n  children: ReactNode;\r\n  config: PepayStreamsConfig;\r\n}) {\r\n  const { isConnected } = useAccount();\r\n  const chainId = useChainId();\r\n  const { data: walletClient, isLoading: walletLoading } = useWalletClient();\r\n  const [client, setClient] = useState<PepayStreamsClient | null>(null);\r\n\r\n  useEffect(() => {\r\n    const newClient = new PepayStreamsClient({\r\n      ...config,\r\n      chainId,\r\n    });\r\n\r\n    if (walletClient && isConnected) {\r\n      setClient(newClient.withSigner(walletClient));\r\n    } else {\r\n      setClient(newClient);\r\n    }\r\n  }, [walletClient, isConnected, chainId, config]);\r\n\r\n  return (\r\n    <PepayStreamsContext.Provider\r\n      value={{\r\n        client,\r\n        isConnected,\r\n        isLoading: walletLoading,\r\n      }}\r\n    >\r\n      {children}\r\n    </PepayStreamsContext.Provider>\r\n  );\r\n}\r\n\r\nexport function usePepayStreams() {\r\n  return useContext(PepayStreamsContext);\r\n}\r\n\r\n// Usage in components:\r\nfunction ClaimButton({ campaignId }: { campaignId: bigint }) {\r\n  const { client, isConnected } = usePepayStreams();\r\n  const [loading, setLoading] = useState(false);\r\n\r\n  const handleClaim = async () => {\r\n    if (!client || !isConnected) return;\r\n\r\n    setLoading(true);\r\n    try {\r\n      const result = await client.claims.claim({ campaignId });\r\n      await result.wait();\r\n      console.log('Claimed!');\r\n    } catch (error) {\r\n      console.error('Claim failed:', error);\r\n    } finally {\r\n      setLoading(false);\r\n    }\r\n  };\r\n\r\n  return (\r\n    <button onClick={handleClaim} disabled={!isConnected || loading}>\r\n      {loading ? 'Claiming...' : 'Claim'}\r\n    </button>\r\n  );\r\n}\r\n`;\r\n\r\n/**\r\n * Query key factories for react-query integration\r\n *\r\n * @example\r\n * ```tsx\r\n * import { useQuery } from '@tanstack/react-query';\r\n * import { queryKeys, usePepayStreams } from '@pepay-streams/sdk/react';\r\n *\r\n * function CampaignDetails({ id }) {\r\n *   const { client } = usePepayStreams();\r\n *\r\n *   const { data: campaign, isLoading } = useQuery({\r\n *     queryKey: queryKeys.campaign(id),\r\n *     queryFn: () => client.campaigns.getCampaign(BigInt(id)),\r\n *     enabled: !!client,\r\n *   });\r\n *\r\n *   if (isLoading) return <div>Loading...</div>;\r\n *   return <div>{campaign?.name}</div>;\r\n * }\r\n * ```\r\n */\r\nexport const queryKeys = {\r\n  // Campaigns\r\n  campaigns: (params?: Record<string, unknown>) =>\r\n    ['pepay', 'campaigns', params] as const,\r\n  campaign: (id: string | bigint) => ['pepay', 'campaign', String(id)] as const,\r\n  campaignRecipients: (id: string | bigint, page?: number) =>\r\n    ['pepay', 'campaign', String(id), 'recipients', page] as const,\r\n  campaignActivity: (id: string | bigint, page?: number) =>\r\n    ['pepay', 'campaign', String(id), 'activity', page] as const,\r\n\r\n  // Claims\r\n  dueAmount: (campaignId: bigint, address: Address) =>\r\n    ['pepay', 'dueAmount', String(campaignId), address] as const,\r\n  recipientStatus: (campaignId: bigint, address: Address) =>\r\n    ['pepay', 'recipientStatus', String(campaignId), address] as const,\r\n\r\n  // Staking\r\n  stakingPools: (params?: Record<string, unknown>) =>\r\n    ['pepay', 'staking', 'pools', params] as const,\r\n  stakingPool: (id: string | bigint) =>\r\n    ['pepay', 'staking', 'pool', String(id)] as const,\r\n  userStake: (poolId: bigint, address: Address) =>\r\n    ['pepay', 'staking', 'userStake', String(poolId), address] as const,\r\n  pendingRewards: (poolId: bigint, address: Address) =>\r\n    ['pepay', 'staking', 'pendingRewards', String(poolId), address] as const,\r\n\r\n  // Marketplace\r\n  orders: (params?: Record<string, unknown>) =>\r\n    ['pepay', 'marketplace', 'orders', params] as const,\r\n  order: (id: string | bigint) =>\r\n    ['pepay', 'marketplace', 'order', String(id)] as const,\r\n  orderQuote: (id: string | bigint) =>\r\n    ['pepay', 'marketplace', 'order', String(id), 'quote'] as const,\r\n\r\n  // Wallet\r\n  walletActivity: (address: Address) =>\r\n    ['pepay', 'wallet', address, 'activity'] as const,\r\n  walletPositions: (address: Address) =>\r\n    ['pepay', 'wallet', address, 'positions'] as const,\r\n  walletClaims: (address: Address, page?: number) =>\r\n    ['pepay', 'wallet', address, 'claims', page] as const,\r\n\r\n  // Tokens\r\n  tokenBalance: (token: Address, address: Address) =>\r\n    ['pepay', 'token', token, 'balance', address] as const,\r\n  tokenAllowance: (token: Address, owner: Address, spender: Address) =>\r\n    ['pepay', 'token', token, 'allowance', owner, spender] as const,\r\n  tokenInfo: (token: Address) => ['pepay', 'token', token, 'info'] as const,\r\n\r\n  // Automation\r\n  autoWithdrawStatus: (campaignId: bigint) =>\r\n    ['pepay', 'automation', 'autoWithdraw', String(campaignId)] as const,\r\n  autoReleaseStatus: (campaignId: bigint) =>\r\n    ['pepay', 'automation', 'autoRelease', String(campaignId)] as const,\r\n};\r\n\r\n/**\r\n * Mutation key factories for react-query\r\n */\r\nexport const mutationKeys = {\r\n  claim: (campaignId: bigint) =>\r\n    ['pepay', 'mutation', 'claim', String(campaignId)] as const,\r\n  claimBatch: () => ['pepay', 'mutation', 'claimBatch'] as const,\r\n  stake: (poolId: bigint) =>\r\n    ['pepay', 'mutation', 'stake', String(poolId)] as const,\r\n  unstake: (poolId: bigint) =>\r\n    ['pepay', 'mutation', 'unstake', String(poolId)] as const,\r\n  fillOrder: (orderId: bigint) =>\r\n    ['pepay', 'mutation', 'fillOrder', String(orderId)] as const,\r\n  cancelOrder: (orderId: bigint) =>\r\n    ['pepay', 'mutation', 'cancelOrder', String(orderId)] as const,\r\n  approve: (token: Address) =>\r\n    ['pepay', 'mutation', 'approve', token] as const,\r\n};\r\n\r\n/**\r\n * Example hook patterns for common operations\r\n */\r\nexport const HOOK_EXAMPLES = `\r\n// Custom hooks for common operations\r\n\r\nimport { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';\r\nimport { usePepayStreams, queryKeys, mutationKeys } from '@pepay-streams/sdk/react';\r\nimport { parseEther } from 'viem';\r\n\r\n// Hook: Get campaign with due amount\r\nexport function useCampaignWithDue(campaignId: bigint, recipientAddress: Address) {\r\n  const { client } = usePepayStreams();\r\n\r\n  const campaign = useQuery({\r\n    queryKey: queryKeys.campaign(campaignId),\r\n    queryFn: () => client!.campaigns.getCampaign(campaignId),\r\n    enabled: !!client,\r\n  });\r\n\r\n  const dueAmount = useQuery({\r\n    queryKey: queryKeys.dueAmount(campaignId, recipientAddress),\r\n    queryFn: () => client!.claims.getDueAmount(campaignId, recipientAddress),\r\n    enabled: !!client && !!recipientAddress,\r\n    refetchInterval: 30000, // Refresh every 30s\r\n  });\r\n\r\n  return {\r\n    campaign: campaign.data,\r\n    dueAmount: dueAmount.data,\r\n    isLoading: campaign.isLoading || dueAmount.isLoading,\r\n  };\r\n}\r\n\r\n// Hook: Claim mutation with optimistic updates\r\nexport function useClaim() {\r\n  const { client } = usePepayStreams();\r\n  const queryClient = useQueryClient();\r\n\r\n  return useMutation({\r\n    mutationFn: async ({ campaignId }: { campaignId: bigint }) => {\r\n      const result = await client!.claims.claim({ campaignId });\r\n      return result.wait();\r\n    },\r\n    onSuccess: (_, { campaignId }) => {\r\n      // Invalidate related queries\r\n      queryClient.invalidateQueries({ queryKey: queryKeys.campaign(campaignId) });\r\n      queryClient.invalidateQueries({ queryKey: ['pepay', 'dueAmount', String(campaignId)] });\r\n    },\r\n  });\r\n}\r\n\r\n// Hook: Stake with approval check\r\nexport function useStake() {\r\n  const { client } = usePepayStreams();\r\n  const queryClient = useQueryClient();\r\n\r\n  return useMutation({\r\n    mutationFn: async ({\r\n      poolId,\r\n      amount,\r\n      stakeToken,\r\n    }: {\r\n      poolId: bigint;\r\n      amount: bigint;\r\n      stakeToken: Address;\r\n    }) => {\r\n      // Check and approve if needed\r\n      const approval = await (client as PepayStreamsClientWithSigner).ensureAllowance(stakeToken, amount);\r\n      if (approval) {\r\n        await approval.wait();\r\n      }\r\n\r\n      // Stake\r\n      const result = await client!.staking.stake(poolId, amount);\r\n      return result.wait();\r\n    },\r\n    onSuccess: (_, { poolId }) => {\r\n      queryClient.invalidateQueries({ queryKey: queryKeys.stakingPool(poolId) });\r\n      queryClient.invalidateQueries({ queryKey: ['pepay', 'staking', 'userStake', String(poolId)] });\r\n    },\r\n  });\r\n}\r\n\r\n// Hook: Fill order with price display\r\nexport function useOrderWithQuote(orderId: bigint) {\r\n  const { client } = usePepayStreams();\r\n\r\n  const order = useQuery({\r\n    queryKey: queryKeys.order(orderId),\r\n    queryFn: () => client!.marketplace.getOrder(orderId),\r\n    enabled: !!client,\r\n  });\r\n\r\n  const quote = useQuery({\r\n    queryKey: queryKeys.orderQuote(orderId),\r\n    queryFn: () => client!.marketplace.getQuote(orderId),\r\n    enabled: !!client && order.data?.status === 'open',\r\n    refetchInterval: 10000, // Refresh quote every 10s\r\n  });\r\n\r\n  return {\r\n    order: order.data,\r\n    quote: quote.data,\r\n    isLoading: order.isLoading || quote.isLoading,\r\n    canFill: quote.data?.isValid ?? false,\r\n  };\r\n}\r\n`;\r\n\r\n/**\r\n * Format helpers for display\r\n */\r\nexport const formatters = {\r\n  /**\r\n   * Format token amount with decimals\r\n   */\r\n  formatTokenAmount(amount: bigint, decimals = 18, maxDecimals = 4): string {\r\n    const divisor = BigInt(10 ** decimals);\r\n    const integerPart = amount / divisor;\r\n    const fractionalPart = amount % divisor;\r\n\r\n    const fractionalStr = fractionalPart.toString().padStart(decimals, '0');\r\n    const trimmedFractional = fractionalStr.slice(0, maxDecimals).replace(/0+$/, '');\r\n\r\n    if (trimmedFractional) {\r\n      return `${integerPart}.${trimmedFractional}`;\r\n    }\r\n    return integerPart.toString();\r\n  },\r\n\r\n  /**\r\n   * Format USD amount\r\n   */\r\n  formatUsd(amount: number | string): string {\r\n    const num = typeof amount === 'string' ? parseFloat(amount) : amount;\r\n    return new Intl.NumberFormat('en-US', {\r\n      style: 'currency',\r\n      currency: 'USD',\r\n      minimumFractionDigits: 2,\r\n      maximumFractionDigits: 2,\r\n    }).format(num);\r\n  },\r\n\r\n  /**\r\n   * Format percentage\r\n   */\r\n  formatPercent(value: number, decimals = 2): string {\r\n    return `${value.toFixed(decimals)}%`;\r\n  },\r\n\r\n  /**\r\n   * Format timestamp to date string\r\n   */\r\n  formatDate(timestamp: number): string {\r\n    return new Date(timestamp * 1000).toLocaleDateString();\r\n  },\r\n\r\n  /**\r\n   * Format timestamp to relative time\r\n   */\r\n  formatRelativeTime(timestamp: number): string {\r\n    const now = Math.floor(Date.now() / 1000);\r\n    const diff = timestamp - now;\r\n\r\n    if (diff < 0) {\r\n      const absDiff = Math.abs(diff);\r\n      if (absDiff < 60) return 'just now';\r\n      if (absDiff < 3600) return `${Math.floor(absDiff / 60)}m ago`;\r\n      if (absDiff < 86400) return `${Math.floor(absDiff / 3600)}h ago`;\r\n      return `${Math.floor(absDiff / 86400)}d ago`;\r\n    }\r\n\r\n    if (diff < 60) return 'in < 1m';\r\n    if (diff < 3600) return `in ${Math.floor(diff / 60)}m`;\r\n    if (diff < 86400) return `in ${Math.floor(diff / 3600)}h`;\r\n    return `in ${Math.floor(diff / 86400)}d`;\r\n  },\r\n\r\n  /**\r\n   * Format vesting progress\r\n   */\r\n  formatVestingProgress(claimed: bigint, allocated: bigint): string {\r\n    if (allocated === 0n) return '0%';\r\n    const progress = Number((claimed * 100n) / allocated);\r\n    return `${progress.toFixed(1)}%`;\r\n  },\r\n\r\n  /**\r\n   * Shorten address for display\r\n   */\r\n  shortenAddress(address: Address, chars = 4): string {\r\n    return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;\r\n  },\r\n};\r\n\r\n// Types are already exported as interfaces above\r\n"]}

package/dist/staking/index.d.mts

@@ -0,0 +1,158 @@
+import { PublicClient, WalletClient, Address } from 'viem';
+import { T as TransactionResult, c as PoolInfo, U as UserStake } from '../index-BTG0TRJt.mjs';
+
+/**
+ * Staking Module
+ *
+ * Provides methods for staking operations:
+ * - Stake tokens
+ * - Unstake tokens
+ * - Claim rewards
+ * - Pool queries
+ */
+
+/**
+ * Staking module for fixed-duration staking pools
+ */
+declare class StakingModule {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly diamondAddress;
+    constructor(publicClient: PublicClient, walletClient: WalletClient | undefined, diamondAddress: Address);
+    /**
+     * Stake tokens in a pool
+     *
+     * Must approve the Diamond contract first.
+     *
+     * @example
+     * ```typescript
+     * await sdk.approve(stakeToken, amount);
+     * const result = await sdk.staking.stake(poolId, amount);
+     * ```
+     */
+    stake(poolId: bigint, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Increase stake in an existing deposit
+     */
+    increaseStake(poolId: bigint, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Unstake all tokens from a pool
+     *
+     * Automatically claims pending rewards.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.staking.unstake(poolId);
+     * ```
+     */
+    unstake(poolId: bigint): Promise<TransactionResult>;
+    /**
+     * Partial unstake - withdraw some tokens but keep position open
+     */
+    partialUnstake(poolId: bigint, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Emergency unstake - forfeit rewards but get principal back
+     *
+     * Use when pool has issues or you need immediate exit.
+     */
+    emergencyUnstake(poolId: bigint): Promise<TransactionResult>;
+    /**
+     * Get pool information
+     *
+     * @example
+     * ```typescript
+     * const pool = await sdk.staking.getPool(1n);
+     * console.log('Total staked:', formatEther(pool.totalStaked));
+     * ```
+     */
+    getPool(poolId: bigint): Promise<PoolInfo>;
+    /**
+     * Get total number of staking pools
+     */
+    getPoolCount(): Promise<bigint>;
+    /**
+     * Get pool stats (runtime state)
+     */
+    getPoolStats(poolId: bigint): Promise<{
+        statusBits: number;
+        rewardRemaining: bigint;
+        totalStaked: bigint;
+        endAt: number;
+        finalized: boolean;
+        rewardRatePerSecond: bigint;
+    }>;
+    /**
+     * Get user's deposit info for a pool
+     *
+     * @example
+     * ```typescript
+     * const stake = await sdk.staking.getUserDeposit(poolId, address);
+     * console.log('Staked:', formatEther(stake.amount));
+     * ```
+     */
+    getUserDeposit(poolId: bigint, user: Address): Promise<{
+        amount: bigint;
+        startAt: number;
+        rewardDebtRay: bigint;
+        claimedReward: bigint;
+        claimedAt: number;
+        active: boolean;
+    }>;
+    /**
+     * Get comprehensive deposit status for a user
+     */
+    getDepositStatus(poolId: bigint, user: Address): Promise<{
+        active: boolean;
+        stakedAmount: bigint;
+        pendingRewards: bigint;
+        canUnstakeNow: boolean;
+        secondsUntilUnstake: number;
+        totalClaimed: bigint;
+    }>;
+    /**
+     * Get pending rewards for a user in a pool
+     */
+    getPendingRewards(poolId: bigint, user: Address): Promise<bigint>;
+    /**
+     * Check if user can unstake from a pool
+     */
+    canUnstake(poolId: bigint, user: Address): Promise<boolean>;
+    /**
+     * Get time until user can unstake
+     */
+    secondsUntilUnstakeable(poolId: bigint, user: Address): Promise<bigint>;
+    /**
+     * Get user's stake info for a pool (convenience wrapper)
+     *
+     * @example
+     * ```typescript
+     * const stake = await sdk.staking.getUserStake(poolId, address);
+     * console.log('Staked:', formatEther(stake.amount));
+     * console.log('Pending rewards:', formatEther(stake.pendingRewards));
+     * ```
+     */
+    getUserStake(poolId: bigint, user: Address): Promise<UserStake>;
+    /**
+     * Get APY preview for a pool
+     */
+    getApyPreview(poolId: bigint): Promise<{
+        ratePerSecond: bigint;
+        totalStaked: bigint;
+    }>;
+    /**
+     * Calculate APY for a pool
+     *
+     * @example
+     * ```typescript
+     * const pool = await sdk.staking.getPool(poolId);
+     * const apy = sdk.staking.calculateApy(pool);
+     * console.log('APY:', apy.toFixed(2), '%');
+     * ```
+     */
+    calculateApy(pool: PoolInfo): number;
+    private requireWallet;
+    private parsePoolInfo;
+    private createTransactionResult;
+}
+
+export { StakingModule, StakingModule as default };