@thehoneyjar/sigil-lens 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# @sigil/lens
+
+Address impersonation for testing different user states. View your app as any address.
+
+## Installation
+
+```bash
+pnpm add @sigil/lens
+```
+
+## Usage
+
+### React Hooks
+
+```tsx
+import { useLens, useIsImpersonating, useLensActions } from '@sigil/lens'
+
+function MyComponent() {
+  const { enabled, impersonatedAddress, realAddress } = useLens()
+  const isImpersonating = useIsImpersonating()
+  const { setImpersonatedAddress, clearImpersonation } = useLensActions()
+
+  return (
+    <div>
+      {isImpersonating ? (
+        <p>Viewing as: {impersonatedAddress}</p>
+      ) : (
+        <p>Viewing as: {realAddress}</p>
+      )}
+      <button onClick={() => setImpersonatedAddress('0x...')}>
+        Impersonate
+      </button>
+      <button onClick={clearImpersonation}>
+        Stop
+      </button>
+    </div>
+  )
+}
+```
+
+### Wagmi Integration
+
+```tsx
+import { useLensAwareAccount } from '@sigil/lens/wagmi'
+
+function WalletInfo() {
+  const { address, realAddress, isImpersonating } = useLensAwareAccount()
+
+  // Use `address` for reading data (respects impersonation)
+  const { data: balance } = useBalance({ address })
+
+  // Use `realAddress` for signing transactions
+  return (
+    <div>
+      <p>Viewing: {address}</p>
+      {isImpersonating && <Badge>Lens Active</Badge>}
+    </div>
+  )
+}
+```
+
+### Service API
+
+```typescript
+import { createLensService } from '@sigil/lens'
+
+const lensService = createLensService()
+
+// Impersonate an address
+lensService.setImpersonatedAddress('0x...')
+
+// Get current state
+const state = lensService.getState()
+
+// Save addresses for quick access
+lensService.saveAddress({ address: '0x...', label: 'Whale' })
+
+// Clear impersonation
+lensService.clearImpersonation()
+```
+
+## API
+
+### Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useLens()` | Get full lens state |
+| `useLensContext()` | Get lens context for components |
+| `useIsImpersonating()` | Check if currently impersonating |
+| `useImpersonatedAddress()` | Get impersonated address |
+| `useRealAddress()` | Get real connected address |
+| `useEffectiveAddress()` | Get effective address (impersonated or real) |
+| `useSavedAddresses()` | Get saved addresses and actions |
+| `useLensActions()` | Get lens actions |
+
+### Wagmi Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useLensAwareAccount()` | Wagmi useAccount that respects lens |
+
+### Service
+
+| Method | Description |
+|--------|-------------|
+| `getState()` | Get current state |
+| `setImpersonatedAddress(address)` | Set impersonated address |
+| `clearImpersonation()` | Clear impersonation |
+| `saveAddress(entry)` | Save an address |
+| `removeAddress(address)` | Remove saved address |
+| `getContext()` | Get lens context |
+| `subscribe(listener)` | Subscribe to state changes |
+
+## Persistence
+
+Saved addresses are persisted to localStorage under the key `sigil-lens-storage`.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,227 @@
+import { Address } from 'viem';
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
+
+/**
+ * Lens Service Types
+ *
+ * Types for address impersonation functionality.
+ */
+
+/**
+ * Saved address entry for quick selection
+ */
+interface SavedAddress {
+    address: Address;
+    label: string;
+    addedAt: number;
+}
+/**
+ * Lens state
+ */
+interface LensState {
+    /** Whether lens impersonation is enabled */
+    enabled: boolean;
+    /** Currently impersonated address */
+    impersonatedAddress: Address | null;
+    /** The real connected wallet address */
+    realAddress: Address | null;
+    /** Saved addresses for quick selection */
+    savedAddresses: SavedAddress[];
+}
+/**
+ * Lens context for components
+ */
+interface LensContext {
+    /** Whether currently impersonating */
+    isImpersonating: boolean;
+    /** The impersonated address (if any) */
+    impersonatedAddress: Address | null;
+    /** The real connected address */
+    realAddress: Address | null;
+}
+/**
+ * Lens service interface
+ */
+interface LensService {
+    /** Get current lens state */
+    getState(): LensState;
+    /** Enable lens and set impersonated address */
+    setImpersonatedAddress(address: Address): void;
+    /** Clear impersonation */
+    clearImpersonation(): void;
+    /** Set the real address (from wallet connection) */
+    setRealAddress(address: Address | null): void;
+    /** Save an address for quick access */
+    saveAddress(entry: Omit<SavedAddress, 'addedAt'>): void;
+    /** Remove a saved address */
+    removeAddress(address: Address): void;
+    /** Get lens context */
+    getContext(): LensContext;
+    /** Subscribe to state changes */
+    subscribe(listener: (state: LensState) => void): () => void;
+}
+/**
+ * Lens error
+ */
+declare class LensError extends Error {
+    code: string;
+    recoverable: boolean;
+    constructor(message: string, code: string, recoverable?: boolean);
+}
+/**
+ * Lens error codes
+ */
+declare const LensErrorCodes: {
+    readonly INVALID_ADDRESS: "LENS_INVALID_ADDRESS";
+    readonly NOT_CONNECTED: "LENS_NOT_CONNECTED";
+};
+
+/**
+ * Lens store actions
+ */
+interface LensActions {
+    setImpersonatedAddress: (address: Address) => void;
+    clearImpersonation: () => void;
+    setRealAddress: (address: Address | null) => void;
+    saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) => void;
+    removeAddress: (address: Address) => void;
+    reset: () => void;
+}
+/**
+ * Combined lens store type
+ */
+type LensStore = LensState & LensActions;
+/**
+ * Create the lens store
+ */
+declare const useLensStore: zustand.UseBoundStore<Omit<zustand.StoreApi<LensStore>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<LensStore, {
+            savedAddresses: SavedAddress[];
+        }>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => void | Promise<void>;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: LensStore) => void) => () => void;
+        onFinishHydration: (fn: (state: LensStore) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<LensStore, {
+            savedAddresses: SavedAddress[];
+        }>>;
+    };
+}>;
+/**
+ * Get lens store state (for non-React contexts)
+ */
+declare function getLensState(): LensState;
+
+/**
+ * Lens Service Implementation
+ *
+ * Provides lens functionality for non-React contexts.
+ */
+
+/**
+ * Create a lens service
+ */
+declare function createLensService(): LensService;
+/**
+ * Get the default lens service
+ */
+declare function getLensService(): LensService;
+/**
+ * Reset the default lens service
+ */
+declare function resetLensService(): void;
+
+/**
+ * Lens React Hooks
+ *
+ * React hooks for accessing lens state.
+ */
+
+/**
+ * Hook to get the full lens state
+ *
+ * @example
+ * ```tsx
+ * function LensStatus() {
+ *   const { enabled, impersonatedAddress, realAddress } = useLens()
+ *   return <div>{enabled ? `Impersonating ${impersonatedAddress}` : 'Not impersonating'}</div>
+ * }
+ * ```
+ */
+declare function useLens(): LensState;
+/**
+ * Hook to get lens context for components
+ *
+ * @example
+ * ```tsx
+ * function AddressDisplay() {
+ *   const { isImpersonating, impersonatedAddress, realAddress } = useLensContext()
+ *   return <div>{isImpersonating ? impersonatedAddress : realAddress}</div>
+ * }
+ * ```
+ */
+declare function useLensContext(): LensContext;
+/**
+ * Hook to check if currently impersonating
+ *
+ * @example
+ * ```tsx
+ * function LensBadge() {
+ *   const isImpersonating = useIsImpersonating()
+ *   if (!isImpersonating) return null
+ *   return <Badge variant="warning">Lens Active</Badge>
+ * }
+ * ```
+ */
+declare function useIsImpersonating(): boolean;
+/**
+ * Hook to get the impersonated address (or null if not impersonating)
+ */
+declare function useImpersonatedAddress(): Address | null;
+/**
+ * Hook to get the real connected address
+ */
+declare function useRealAddress(): Address | null;
+/**
+ * Hook to get the effective address (impersonated if active, otherwise real)
+ */
+declare function useEffectiveAddress(): Address | undefined;
+/**
+ * Hook to get saved addresses and actions
+ *
+ * @example
+ * ```tsx
+ * function SavedAddressList() {
+ *   const { savedAddresses, saveAddress, removeAddress, selectAddress } = useSavedAddresses()
+ *   return (
+ *     <ul>
+ *       {savedAddresses.map(({ address, label }) => (
+ *         <li key={address} onClick={() => selectAddress(address)}>
+ *           {label}: {address}
+ *           <button onClick={() => removeAddress(address)}>Remove</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   )
+ * }
+ * ```
+ */
+declare function useSavedAddresses(): {
+    savedAddresses: SavedAddress[];
+    saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) => void;
+    removeAddress: (address: `0x${string}`) => void;
+    selectAddress: (address: `0x${string}`) => void;
+};
+/**
+ * Hook to get lens actions
+ */
+declare function useLensActions(): {
+    setImpersonatedAddress: (address: `0x${string}`) => void;
+    clearImpersonation: () => void;
+    setRealAddress: (address: `0x${string}` | null) => void;
+};
+
+export { type LensContext, LensError, LensErrorCodes, type LensService, type LensState, type SavedAddress, createLensService, getLensService, getLensState, resetLensService, useEffectiveAddress, useImpersonatedAddress, useIsImpersonating, useLens, useLensActions, useLensContext, useLensStore, useRealAddress, useSavedAddresses };

package/dist/index.js

@@ -0,0 +1,203 @@
+// src/types.ts
+var LensError = class extends Error {
+  constructor(message, code, recoverable = true) {
+    super(message);
+    this.code = code;
+    this.recoverable = recoverable;
+    this.name = "LensError";
+  }
+};
+var LensErrorCodes = {
+  INVALID_ADDRESS: "LENS_INVALID_ADDRESS",
+  NOT_CONNECTED: "LENS_NOT_CONNECTED"
+};
+
+// src/store.ts
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+var initialState = {
+  enabled: false,
+  impersonatedAddress: null,
+  realAddress: null,
+  savedAddresses: []
+};
+var useLensStore = create()(
+  persist(
+    (set) => ({
+      ...initialState,
+      setImpersonatedAddress: (address) => set({
+        enabled: true,
+        impersonatedAddress: address
+      }),
+      clearImpersonation: () => set({
+        enabled: false,
+        impersonatedAddress: null
+      }),
+      setRealAddress: (address) => set({ realAddress: address }),
+      saveAddress: (entry) => set((state) => {
+        if (state.savedAddresses.some((a) => a.address === entry.address)) {
+          return state;
+        }
+        return {
+          savedAddresses: [
+            ...state.savedAddresses,
+            { ...entry, addedAt: Date.now() }
+          ]
+        };
+      }),
+      removeAddress: (address) => set((state) => ({
+        savedAddresses: state.savedAddresses.filter((a) => a.address !== address)
+      })),
+      reset: () => set(initialState)
+    }),
+    {
+      name: "sigil-lens-storage",
+      partialize: (state) => ({
+        savedAddresses: state.savedAddresses
+      })
+    }
+  )
+);
+function getLensState() {
+  const state = useLensStore.getState();
+  return {
+    enabled: state.enabled,
+    impersonatedAddress: state.impersonatedAddress,
+    realAddress: state.realAddress,
+    savedAddresses: state.savedAddresses
+  };
+}
+
+// src/service.ts
+function createLensService() {
+  const store = useLensStore;
+  return {
+    getState() {
+      return getLensState();
+    },
+    setImpersonatedAddress(address) {
+      store.getState().setImpersonatedAddress(address);
+    },
+    clearImpersonation() {
+      store.getState().clearImpersonation();
+    },
+    setRealAddress(address) {
+      store.getState().setRealAddress(address);
+    },
+    saveAddress(entry) {
+      store.getState().saveAddress(entry);
+    },
+    removeAddress(address) {
+      store.getState().removeAddress(address);
+    },
+    getContext() {
+      const state = getLensState();
+      return {
+        isImpersonating: state.enabled && state.impersonatedAddress !== null,
+        impersonatedAddress: state.impersonatedAddress,
+        realAddress: state.realAddress
+      };
+    },
+    subscribe(listener) {
+      return store.subscribe((state) => {
+        listener({
+          enabled: state.enabled,
+          impersonatedAddress: state.impersonatedAddress,
+          realAddress: state.realAddress,
+          savedAddresses: state.savedAddresses
+        });
+      });
+    }
+  };
+}
+var defaultLensService = null;
+function getLensService() {
+  if (!defaultLensService) {
+    defaultLensService = createLensService();
+  }
+  return defaultLensService;
+}
+function resetLensService() {
+  if (defaultLensService) {
+    useLensStore.getState().reset();
+  }
+  defaultLensService = null;
+}
+
+// src/hooks.ts
+function useLens() {
+  return useLensStore((state) => ({
+    enabled: state.enabled,
+    impersonatedAddress: state.impersonatedAddress,
+    realAddress: state.realAddress,
+    savedAddresses: state.savedAddresses
+  }));
+}
+function useLensContext() {
+  return useLensStore((state) => ({
+    isImpersonating: state.enabled && state.impersonatedAddress !== null,
+    impersonatedAddress: state.impersonatedAddress,
+    realAddress: state.realAddress
+  }));
+}
+function useIsImpersonating() {
+  return useLensStore(
+    (state) => state.enabled && state.impersonatedAddress !== null
+  );
+}
+function useImpersonatedAddress() {
+  return useLensStore(
+    (state) => state.enabled ? state.impersonatedAddress : null
+  );
+}
+function useRealAddress() {
+  return useLensStore((state) => state.realAddress);
+}
+function useEffectiveAddress() {
+  return useLensStore((state) => {
+    if (state.enabled && state.impersonatedAddress) {
+      return state.impersonatedAddress;
+    }
+    return state.realAddress ?? void 0;
+  });
+}
+function useSavedAddresses() {
+  const savedAddresses = useLensStore((state) => state.savedAddresses);
+  const saveAddress = useLensStore((state) => state.saveAddress);
+  const removeAddress = useLensStore((state) => state.removeAddress);
+  const setImpersonatedAddress = useLensStore((state) => state.setImpersonatedAddress);
+  return {
+    savedAddresses,
+    saveAddress: (entry) => saveAddress(entry),
+    removeAddress,
+    selectAddress: setImpersonatedAddress
+  };
+}
+function useLensActions() {
+  const setImpersonatedAddress = useLensStore((state) => state.setImpersonatedAddress);
+  const clearImpersonation = useLensStore((state) => state.clearImpersonation);
+  const setRealAddress = useLensStore((state) => state.setRealAddress);
+  return {
+    setImpersonatedAddress,
+    clearImpersonation,
+    setRealAddress
+  };
+}
+export {
+  LensError,
+  LensErrorCodes,
+  createLensService,
+  getLensService,
+  getLensState,
+  resetLensService,
+  useEffectiveAddress,
+  useImpersonatedAddress,
+  useIsImpersonating,
+  useLens,
+  useLensActions,
+  useLensContext,
+  useLensStore,
+  useRealAddress,
+  useSavedAddresses
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/store.ts","../src/service.ts","../src/hooks.ts"],"sourcesContent":["/**\n * Lens Service Types\n *\n * Types for address impersonation functionality.\n */\n\nimport type { Address } from 'viem'\n\n/**\n * Saved address entry for quick selection\n */\nexport interface SavedAddress {\n  address: Address\n  label: string\n  addedAt: number\n}\n\n/**\n * Lens state\n */\nexport interface LensState {\n  /** Whether lens impersonation is enabled */\n  enabled: boolean\n  /** Currently impersonated address */\n  impersonatedAddress: Address | null\n  /** The real connected wallet address */\n  realAddress: Address | null\n  /** Saved addresses for quick selection */\n  savedAddresses: SavedAddress[]\n}\n\n/**\n * Lens context for components\n */\nexport interface LensContext {\n  /** Whether currently impersonating */\n  isImpersonating: boolean\n  /** The impersonated address (if any) */\n  impersonatedAddress: Address | null\n  /** The real connected address */\n  realAddress: Address | null\n}\n\n/**\n * Lens service interface\n */\nexport interface LensService {\n  /** Get current lens state */\n  getState(): LensState\n  /** Enable lens and set impersonated address */\n  setImpersonatedAddress(address: Address): void\n  /** Clear impersonation */\n  clearImpersonation(): void\n  /** Set the real address (from wallet connection) */\n  setRealAddress(address: Address | null): void\n  /** Save an address for quick access */\n  saveAddress(entry: Omit<SavedAddress, 'addedAt'>): void\n  /** Remove a saved address */\n  removeAddress(address: Address): void\n  /** Get lens context */\n  getContext(): LensContext\n  /** Subscribe to state changes */\n  subscribe(listener: (state: LensState) => void): () => void\n}\n\n/**\n * Lens error\n */\nexport class LensError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public recoverable: boolean = true\n  ) {\n    super(message)\n    this.name = 'LensError'\n  }\n}\n\n/**\n * Lens error codes\n */\nexport const LensErrorCodes = {\n  INVALID_ADDRESS: 'LENS_INVALID_ADDRESS',\n  NOT_CONNECTED: 'LENS_NOT_CONNECTED',\n} as const\n","/**\n * Lens Store\n *\n * Zustand store for lens state management.\n */\n\nimport { create } from 'zustand'\nimport { persist } from 'zustand/middleware'\nimport type { Address } from 'viem'\nimport type { LensState, SavedAddress } from './types'\n\n/**\n * Lens store actions\n */\ninterface LensActions {\n  setImpersonatedAddress: (address: Address) => void\n  clearImpersonation: () => void\n  setRealAddress: (address: Address | null) => void\n  saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) => void\n  removeAddress: (address: Address) => void\n  reset: () => void\n}\n\n/**\n * Combined lens store type\n */\nexport type LensStore = LensState & LensActions\n\n/**\n * Initial lens state\n */\nconst initialState: LensState = {\n  enabled: false,\n  impersonatedAddress: null,\n  realAddress: null,\n  savedAddresses: [],\n}\n\n/**\n * Create the lens store\n */\nexport const useLensStore = create<LensStore>()(\n  persist(\n    (set) => ({\n      ...initialState,\n\n      setImpersonatedAddress: (address: Address) =>\n        set({\n          enabled: true,\n          impersonatedAddress: address,\n        }),\n\n      clearImpersonation: () =>\n        set({\n          enabled: false,\n          impersonatedAddress: null,\n        }),\n\n      setRealAddress: (address: Address | null) =>\n        set({ realAddress: address }),\n\n      saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) =>\n        set((state) => {\n          // Don't add duplicates\n          if (state.savedAddresses.some((a) => a.address === entry.address)) {\n            return state\n          }\n          return {\n            savedAddresses: [\n              ...state.savedAddresses,\n              { ...entry, addedAt: Date.now() },\n            ],\n          }\n        }),\n\n      removeAddress: (address: Address) =>\n        set((state) => ({\n          savedAddresses: state.savedAddresses.filter((a) => a.address !== address),\n        })),\n\n      reset: () => set(initialState),\n    }),\n    {\n      name: 'sigil-lens-storage',\n      partialize: (state) => ({\n        savedAddresses: state.savedAddresses,\n      }),\n    }\n  )\n)\n\n/**\n * Get lens store state (for non-React contexts)\n */\nexport function getLensState(): LensState {\n  const state = useLensStore.getState()\n  return {\n    enabled: state.enabled,\n    impersonatedAddress: state.impersonatedAddress,\n    realAddress: state.realAddress,\n    savedAddresses: state.savedAddresses,\n  }\n}\n","/**\n * Lens Service Implementation\n *\n * Provides lens functionality for non-React contexts.\n */\n\nimport type { Address } from 'viem'\nimport type { LensService, LensState, LensContext, SavedAddress } from './types'\nimport { useLensStore, getLensState } from './store'\n\n/**\n * Create a lens service\n */\nexport function createLensService(): LensService {\n  const store = useLensStore\n\n  return {\n    getState(): LensState {\n      return getLensState()\n    },\n\n    setImpersonatedAddress(address: Address): void {\n      store.getState().setImpersonatedAddress(address)\n    },\n\n    clearImpersonation(): void {\n      store.getState().clearImpersonation()\n    },\n\n    setRealAddress(address: Address | null): void {\n      store.getState().setRealAddress(address)\n    },\n\n    saveAddress(entry: Omit<SavedAddress, 'addedAt'>): void {\n      store.getState().saveAddress(entry)\n    },\n\n    removeAddress(address: Address): void {\n      store.getState().removeAddress(address)\n    },\n\n    getContext(): LensContext {\n      const state = getLensState()\n      return {\n        isImpersonating: state.enabled && state.impersonatedAddress !== null,\n        impersonatedAddress: state.impersonatedAddress,\n        realAddress: state.realAddress,\n      }\n    },\n\n    subscribe(listener: (state: LensState) => void): () => void {\n      return store.subscribe((state) => {\n        listener({\n          enabled: state.enabled,\n          impersonatedAddress: state.impersonatedAddress,\n          realAddress: state.realAddress,\n          savedAddresses: state.savedAddresses,\n        })\n      })\n    },\n  }\n}\n\n/**\n * Default lens service singleton\n */\nlet defaultLensService: LensService | null = null\n\n/**\n * Get the default lens service\n */\nexport function getLensService(): LensService {\n  if (!defaultLensService) {\n    defaultLensService = createLensService()\n  }\n  return defaultLensService\n}\n\n/**\n * Reset the default lens service\n */\nexport function resetLensService(): void {\n  if (defaultLensService) {\n    useLensStore.getState().reset()\n  }\n  defaultLensService = null\n}\n","/**\n * Lens React Hooks\n *\n * React hooks for accessing lens state.\n */\n\nimport type { Address } from 'viem'\nimport { useLensStore } from './store'\nimport type { LensState, LensContext, SavedAddress } from './types'\n\n/**\n * Hook to get the full lens state\n *\n * @example\n * ```tsx\n * function LensStatus() {\n *   const { enabled, impersonatedAddress, realAddress } = useLens()\n *   return <div>{enabled ? `Impersonating ${impersonatedAddress}` : 'Not impersonating'}</div>\n * }\n * ```\n */\nexport function useLens(): LensState {\n  return useLensStore((state) => ({\n    enabled: state.enabled,\n    impersonatedAddress: state.impersonatedAddress,\n    realAddress: state.realAddress,\n    savedAddresses: state.savedAddresses,\n  }))\n}\n\n/**\n * Hook to get lens context for components\n *\n * @example\n * ```tsx\n * function AddressDisplay() {\n *   const { isImpersonating, impersonatedAddress, realAddress } = useLensContext()\n *   return <div>{isImpersonating ? impersonatedAddress : realAddress}</div>\n * }\n * ```\n */\nexport function useLensContext(): LensContext {\n  return useLensStore((state) => ({\n    isImpersonating: state.enabled && state.impersonatedAddress !== null,\n    impersonatedAddress: state.impersonatedAddress,\n    realAddress: state.realAddress,\n  }))\n}\n\n/**\n * Hook to check if currently impersonating\n *\n * @example\n * ```tsx\n * function LensBadge() {\n *   const isImpersonating = useIsImpersonating()\n *   if (!isImpersonating) return null\n *   return <Badge variant=\"warning\">Lens Active</Badge>\n * }\n * ```\n */\nexport function useIsImpersonating(): boolean {\n  return useLensStore(\n    (state) => state.enabled && state.impersonatedAddress !== null\n  )\n}\n\n/**\n * Hook to get the impersonated address (or null if not impersonating)\n */\nexport function useImpersonatedAddress(): Address | null {\n  return useLensStore((state) =>\n    state.enabled ? state.impersonatedAddress : null\n  )\n}\n\n/**\n * Hook to get the real connected address\n */\nexport function useRealAddress(): Address | null {\n  return useLensStore((state) => state.realAddress)\n}\n\n/**\n * Hook to get the effective address (impersonated if active, otherwise real)\n */\nexport function useEffectiveAddress(): Address | undefined {\n  return useLensStore((state) => {\n    if (state.enabled && state.impersonatedAddress) {\n      return state.impersonatedAddress\n    }\n    return state.realAddress ?? undefined\n  })\n}\n\n/**\n * Hook to get saved addresses and actions\n *\n * @example\n * ```tsx\n * function SavedAddressList() {\n *   const { savedAddresses, saveAddress, removeAddress, selectAddress } = useSavedAddresses()\n *   return (\n *     <ul>\n *       {savedAddresses.map(({ address, label }) => (\n *         <li key={address} onClick={() => selectAddress(address)}>\n *           {label}: {address}\n *           <button onClick={() => removeAddress(address)}>Remove</button>\n *         </li>\n *       ))}\n *     </ul>\n *   )\n * }\n * ```\n */\nexport function useSavedAddresses() {\n  const savedAddresses = useLensStore((state) => state.savedAddresses)\n  const saveAddress = useLensStore((state) => state.saveAddress)\n  const removeAddress = useLensStore((state) => state.removeAddress)\n  const setImpersonatedAddress = useLensStore((state) => state.setImpersonatedAddress)\n\n  return {\n    savedAddresses,\n    saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) => saveAddress(entry),\n    removeAddress,\n    selectAddress: setImpersonatedAddress,\n  }\n}\n\n/**\n * Hook to get lens actions\n */\nexport function useLensActions() {\n  const setImpersonatedAddress = useLensStore((state) => state.setImpersonatedAddress)\n  const clearImpersonation = useLensStore((state) => state.clearImpersonation)\n  const setRealAddress = useLensStore((state) => state.setRealAddress)\n\n  return {\n    setImpersonatedAddress,\n    clearImpersonation,\n    setRealAddress,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/wagmi.d.ts

@@ -0,0 +1,56 @@
+import { Address } from 'viem';
+
+/**
+ * Lens Wagmi Integration
+ *
+ * Wagmi-aware hooks for lens functionality.
+ */
+
+/**
+ * Return type for useLensAwareAccount
+ */
+interface LensAwareAccount {
+    /** Address for reads - impersonated if lens enabled, otherwise real */
+    address: Address | undefined;
+    /** The user's real connected address (always available for signing) */
+    realAddress: Address | undefined;
+    /** Whether currently impersonating another address */
+    isImpersonating: boolean;
+    /** The impersonated address (if any) */
+    impersonatedAddress: Address | null;
+    /** Whether the wallet is connected */
+    isConnected: boolean;
+}
+/**
+ * Hook that returns impersonated address for reads, real address for writes.
+ *
+ * Use this hook in place of wagmi's `useAccount` when you want components
+ * to display data for an impersonated address while still being able to
+ * sign transactions with the real connected wallet.
+ *
+ * @example
+ * ```tsx
+ * function WalletInfo() {
+ *   const { address, realAddress, isImpersonating } = useLensAwareAccount()
+ *
+ *   // Use `address` for reading data (respects impersonation)
+ *   const { data: balance } = useBalance({ address })
+ *
+ *   // Use `realAddress` for signing transactions
+ *   const { writeContract } = useWriteContract()
+ *
+ *   return (
+ *     <div>
+ *       <p>Viewing: {address}</p>
+ *       {isImpersonating && <Badge>Lens Active</Badge>}
+ *       <button onClick={() => writeContract({ ... })}>
+ *         Sign with {realAddress}
+ *       </button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useLensAwareAccount(): LensAwareAccount;
+
+export { type LensAwareAccount, useLensAwareAccount };