lens-protocol · cesarenaldi · Aug 25, 2025
diff --git a/packages/react/src/account/useAccount.ts b/packages/react/src/account/useAccount.ts
@@ -28,7 +28,7 @@ export function useAccount(
  * Fetch a single Account.
  *
  * ```tsx
- * const { data, loading } = useAccount({ address: evmAddress('0x…') });
+ * const { data, error, loading } = useAccount({ address: evmAddress('0x…') });
  * ```
  */
 export function useAccount(args: UseAccountArgs): ReadResult<Account | null>;

diff --git a/packages/react/src/account/useAccountFeedsStats.ts b/packages/react/src/account/useAccountFeedsStats.ts
@@ -34,7 +34,7 @@ export function useAccountFeedsStats(
  * Fetch an Account Feed Stats.
  *
  * ```tsx
- * const { data, loading } = useAccountFeedsStats({
+ * const { data, error, loading } = useAccountFeedsStats({
  *   account: evmAddress('0xe2f2a5C287993345a840db3B0845fbc70f5935a5'),
  * );
  * ```

diff --git a/packages/react/src/account/useAccountManagers.ts b/packages/react/src/account/useAccountManagers.ts
@@ -32,7 +32,7 @@ export function useAccountManagers(
  * Fetch Account Managers.
  *
  * ```tsx
- * const { data, loading } = useAccountManagers();
+ * const { data, error, loading } = useAccountManagers();
  * ```
  */
 export function useAccountManagers(

diff --git a/packages/react/src/account/useAccountStats.ts b/packages/react/src/account/useAccountStats.ts
@@ -34,7 +34,7 @@ export function useAccountStats(
  * Fetch an Account Stats.
  *
  * ```tsx
- * const { data, loading } = useAccountStats({
+ * const { data, error, loading } = useAccountStats({
  *   account: evmAddress('0xe2f2a5C287993345a840db3B0845fbc70f5935a5'),
  * );
  * ```

diff --git a/packages/react/src/account/useAccounts.ts b/packages/react/src/account/useAccounts.ts
@@ -39,7 +39,7 @@ export function useAccounts(
  * Fetch accounts available filtered by the given arguments.
  *
  * ```tsx
- * const { data, loading } = useAccounts({
+ * const { data, error, loading } = useAccounts({
  *   filter: {
  *     searchBy: {
  *       localNameQuery: 'wagmi'

diff --git a/packages/react/src/account/useAccountsBlocked.ts b/packages/react/src/account/useAccountsBlocked.ts
@@ -32,7 +32,7 @@ export function useAccountsBlocked(
  * Fetch Blocked Accounts.
  *
  * ```tsx
- * const { data, loading } = useAccountsBlocked();
+ * const { data, error, loading } = useAccountsBlocked();
  * ```
  */
 export function useAccountsBlocked(

diff --git a/packages/react/src/account/useAccountsBulk.ts b/packages/react/src/account/useAccountsBulk.ts
@@ -31,7 +31,7 @@ export function useAccountsBulk(
  * Fetch Accounts in Bulk.
  *
  * ```tsx
- * const { data, loading } = useAccountsBulk({
+ * const { data, error, loading } = useAccountsBulk({
  *   addresses: [evmAddress('0x…'), evmAddress('0x…')]
  * });
  * ```

diff --git a/packages/react/src/account/useBalancesBulk.ts b/packages/react/src/account/useBalancesBulk.ts
@@ -32,7 +32,7 @@ export function useBalancesBulk(
  * Fetch a finite number of balances for the specified address.
  *
  * ```tsx
- * const { data, loading } = useBalancesBulk({
+ * const { data, error, loading } = useBalancesBulk({
  *   address: evmAddress('0x…'),
  *   tokens: [evmAddress("0x1234…"), evmAddress("0x5678…")]
  * });

diff --git a/packages/react/src/account/useWhoExecutedActionOnAccount.ts b/packages/react/src/account/useWhoExecutedActionOnAccount.ts
@@ -36,7 +36,7 @@ export function useWhoExecutedActionOnAccount(
  * Fetch who executed action on an Account.
  *
  * ```tsx
- * const { data, loading } = useWhoExecutedActionOnAccount({
+ * const { data, error, loading } = useWhoExecutedActionOnAccount({
  *   account: evmAddress('0x…'),
  * });
  * ```

diff --git a/packages/react/src/app/useAppUsers.ts b/packages/react/src/app/useAppUsers.ts
@@ -35,7 +35,7 @@ export function useAppUsers(
  * Fetch list of users using an App.
  *
  * ```tsx
- * const { data, loading } = useAppUsers({
+ * const { data, error, loading } = useAppUsers({
  *   app: evmAddress('0x123…'),
  * });
  * ```

diff --git a/packages/react/src/authentication/useAccountsAvailable.ts b/packages/react/src/authentication/useAccountsAvailable.ts
@@ -31,7 +31,7 @@ export function useAccountsAvailable(
  * Fetch the accounts available for a given address.
  *
  * ```tsx
- * const { data, loading } = useAccountsAvailable({ managedBy: evmAddress('0x…') });
+ * const { data, error, loading } = useAccountsAvailable({ managedBy: evmAddress('0x…') });
  * ```
  */
 export function useAccountsAvailable(

diff --git a/packages/react/src/authentication/useAuthenticatedUser.ts b/packages/react/src/authentication/useAuthenticatedUser.ts
@@ -34,7 +34,7 @@ export function useAuthenticatedUser(
  * ```tsx
  * import { useAuthenticatedUser } from '@lens-protocol/react';
  *
- * const { data, loading } = useAuthenticatedUser();
+ * const { data, error, loading } = useAuthenticatedUser();
  * ```
  */
 export function useAuthenticatedUser(): ReadResult<AuthenticatedUser | null>;

diff --git a/packages/react/src/authentication/useMeDetails.ts b/packages/react/src/authentication/useMeDetails.ts
@@ -26,7 +26,7 @@ export function useMeDetails(
  * Fetch the current authenticated user's details.
  *
  * ```tsx
- * const { data, loading } = useMeDetails();
+ * const { data, error, loading } = useMeDetails();
  * ```
  */
 export function useMeDetails(): ReadResult<MeResult | null>;

diff --git a/packages/react/src/authentication/useSessionClient.ts b/packages/react/src/authentication/useSessionClient.ts
@@ -35,7 +35,7 @@ export function useSessionClient(
  * ```tsx
  * import { useSessionClient } from '@lens-protocol/react';
  *
- * const { data, loading } = useSessionClient();
+ * const { data, error, loading } = useSessionClient();
  * ```
  */
 export function useSessionClient(): ReadResult<SessionClient | null>;

diff --git a/packages/react/src/feed/useFeed.ts b/packages/react/src/feed/useFeed.ts
@@ -28,7 +28,7 @@ export function useFeed(
  * Fetch a single Feed.
  *
  * ```tsx
- * const { data, loading } = useFeed({ feed: evmAddress('0x…') });
+ * const { data, error, loading } = useFeed({ feed: evmAddress('0x…') });
  * ```
  */
 export function useFeed(args: UseFeedArgs): ReadResult<Feed | null>;

diff --git a/packages/react/src/feed/useFeeds.ts b/packages/react/src/feed/useFeeds.ts
@@ -37,7 +37,7 @@ export function useFeeds(
  * Fetch a list of Feeds.
  *
  * ```tsx
- * const { data, loading } = useFeeds({
+ * const { data, error, loading } = useFeeds({
  *   filter: {
  *     managedBy: {
  *       address: evmAddress('0xe2f2a5C287993345a840db3B0845fbc70f5935a5')

diff --git a/packages/react/src/follow/useFollowStatus.ts b/packages/react/src/follow/useFollowStatus.ts
@@ -39,7 +39,7 @@ export function useFollowStatus(
  * Fetch follow status.
  *
  * ```tsx
- * const { data, loading } = useFollowStatus({
+ * const { data, error, loading } = useFollowStatus({
  *   pairs: [
  *     {
  *       account: evmAddress('0x…'),

diff --git a/packages/react/src/follow/useFollowers.ts b/packages/react/src/follow/useFollowers.ts
@@ -32,7 +32,7 @@ export function useFollowers(
  * Fetch followers accounts.
  *
  * ```tsx
- * const { data, loading } = useFollowers({ account: evmAddress('0x…') });
+ * const { data, error, loading } = useFollowers({ account: evmAddress('0x…') });
  * ```
  */
 export function useFollowers(

diff --git a/packages/react/src/follow/useFollowersYouKnow.ts b/packages/react/src/follow/useFollowersYouKnow.ts
@@ -36,7 +36,7 @@ export function useFollowersYouKnow(
  * Fetch followers you know.
  *
  * ```tsx
- * const { data, loading } = useFollowersYouKnow({
+ * const { data, error, loading } = useFollowersYouKnow({
  *   observer: evmAddress('0x…'),
  *   target: evmAddress('0x…'),
  * });

diff --git a/packages/react/src/follow/useFollowing.ts b/packages/react/src/follow/useFollowing.ts
@@ -32,7 +32,7 @@ export function useFollowing(
  * Fetch accounts following.
  *
  * ```tsx
- * const { data, loading } = useFollowing({ account: evmAddress('0x…') });
+ * const { data, error, loading } = useFollowing({ account: evmAddress('0x…') });
  * ```
  */
 export function useFollowing(

diff --git a/packages/react/src/graph/useGraph.ts b/packages/react/src/graph/useGraph.ts
@@ -28,7 +28,7 @@ export function useGraph(
  * Fetch a single Graph.
  *
  * ```tsx
- * const { data, loading } = useGraph({ graph: evmAddress('0x…') });
+ * const { data, error, loading } = useGraph({ graph: evmAddress('0x…') });
  * ```
  */
 export function useGraph(args: UseGraphArgs): ReadResult<Graph | null>;

diff --git a/packages/react/src/group/useGroup.ts b/packages/react/src/group/useGroup.ts
@@ -28,7 +28,7 @@ export function useGroup(
  * Fetch a single Group.
  *
  * ```tsx
- * const { data, loading } = useGroup({ group: evmAddress('0x…') });
+ * const { data, error, loading } = useGroup({ group: evmAddress('0x…') });
  * ```
  */
 export function useGroup(args: UseGroupArgs): ReadResult<Group | null>;

diff --git a/packages/react/src/group/useGroupBannedAccounts.ts b/packages/react/src/group/useGroupBannedAccounts.ts
@@ -35,7 +35,7 @@ export function useGroupBannedAccounts(
  * Fetch group banned accounts.
  *
  * ```tsx
- * const { data, loading } = useGroupBannedAccounts({
+ * const { data, error, loading } = useGroupBannedAccounts({
  *   group: evmAddress('0x…'),
  * });
  * ```

diff --git a/packages/react/src/group/useGroupMembers.ts b/packages/react/src/group/useGroupMembers.ts
@@ -35,7 +35,7 @@ export function useGroupMembers(
  * Fetch group members.
  *
  * ```tsx
- * const { data, loading } = useGroupMembers({
+ * const { data, error, loading } = useGroupMembers({
  *   group: evmAddress('0x…'),
  * });
  * ```

diff --git a/packages/react/src/group/useGroupMembershipRequests.ts b/packages/react/src/group/useGroupMembershipRequests.ts
@@ -35,7 +35,7 @@ export function useGroupMembershipRequests(
  * Fetch group membership requests.
  *
  * ```tsx
- * const { data, loading } = useGroupMembershipRequests({
+ * const { data, error, loading } = useGroupMembershipRequests({
  *   group: evmAddress('0x…'),
  * });
  * ```

diff --git a/packages/react/src/group/useGroups.ts b/packages/react/src/group/useGroups.ts
@@ -35,7 +35,7 @@ export function useGroups(
  * Example: Filtered by search query.
  *
  * ```tsx
- * const { data, loading } = useGroups({ filter: { searchQuery: 'test' }});
+ * const { data, error, loading } = useGroups({ filter: { searchQuery: 'test' }});
  * ```
  */
 export function useGroups(args: UseGroupsArgs): ReadResult<Paginated<Group>>;

diff --git a/packages/react/src/ml/useAccountRecommendations.ts b/packages/react/src/ml/useAccountRecommendations.ts
@@ -32,7 +32,7 @@ export function useAccountRecommendations(
  * Fetch a list of recommended accounts for a given account address.
  *
  * ```tsx
- * const { data, loading } = useAccountRecommendations({ account: evmAddress('0x…') });
+ * const { data, error, loading } = useAccountRecommendations({ account: evmAddress('0x…') });
  * ```
  */
 export function useAccountRecommendations(

diff --git a/packages/react/src/ml/usePostsForYou.ts b/packages/react/src/ml/usePostsForYou.ts
@@ -28,7 +28,7 @@ export function usePostsForYou(
  * Fetch a list of recommended posts for the current user's Account.
  *
  * ```tsx
- * const { data, loading } = usePostsForYou();
+ * const { data, error, loading } = usePostsForYou();
  * ```
  */
 export function usePostsForYou(

diff --git a/packages/react/src/ml/usePostsToExplore.ts b/packages/react/src/ml/usePostsToExplore.ts
@@ -28,7 +28,7 @@ export function usePostsToExplore(
  * Fetch a list of recommended posts using Lens's ML algorithms.
  *
  * ```tsx
- * const { data, loading } = usePostsToExplore();
+ * const { data, error, loading } = usePostsToExplore();
  * ```
  */
 export function usePostsToExplore(

diff --git a/packages/react/src/notification/useNotifications.ts b/packages/react/src/notification/useNotifications.ts
@@ -32,7 +32,7 @@ export function useNotifications(
  * Fetch notifications for the authenticated Account.
  *
  * ```tsx
- * const { data, loading } = useNotifications();
+ * const { data, error, loading } = useNotifications();
  * ```
  */
 export function useNotifications(

diff --git a/packages/react/src/post/usePost.ts b/packages/react/src/post/usePost.ts
@@ -28,7 +28,7 @@ export function usePost(
  * Fetch a single post.
  *
  * ```tsx
- * const { data, loading } = usePost({ post: postId('34…') });
+ * const { data, error, loading } = usePost({ post: postId('34…') });
  * ```
  */
 export function usePost(args: UsePostArgs): ReadResult<AnyPost | null>;

diff --git a/packages/react/src/post/usePostBookmarks.ts b/packages/react/src/post/usePostBookmarks.ts
@@ -32,7 +32,7 @@ export function usePostBookmarks(
  * Fetch bookmarked posts.
  *
  * ```tsx
- * const { data, loading } = usePostBookmarks();
+ * const { data, error, loading } = usePostBookmarks();
  * ```
  */
 export function usePostBookmarks(

diff --git a/packages/react/src/post/usePostReactions.ts b/packages/react/src/post/usePostReactions.ts
@@ -35,7 +35,7 @@ export function usePostReactions(
  * Fetch reactions to a post.
  *
  * ```tsx
- * const { data, loading } = usePostReactions({
+ * const { data, error, loading } = usePostReactions({
  *   post: postId('42'),
  * );
  * ```

diff --git a/packages/react/src/post/usePostReferences.ts b/packages/react/src/post/usePostReferences.ts
@@ -36,7 +36,7 @@ export function usePostReferences(
  * Fetch references to a post.
  *
  * ```tsx
- * const { data, loading } = usePostReferences({
+ * const { data, error, loading } = usePostReferences({
  *   referencedTypes: [PostReferenceType.CommentOn],
  *   referencedPost: postId('42'),
  * );

diff --git a/packages/react/src/post/usePostTags.ts b/packages/react/src/post/usePostTags.ts
@@ -37,7 +37,7 @@ export function usePostTags(
  * Fetch post tags.
  *
  * ```tsx
- * const { data, loading } = usePostTags({
+ * const { data, error, loading } = usePostTags({
  *   filter: {
  *     feeds: { globalFeed: true },
  *   },

diff --git a/packages/react/src/post/usePosts.ts b/packages/react/src/post/usePosts.ts
@@ -33,7 +33,7 @@ export function usePosts(
  * Fetch posts available filtered by the given arguments.
  *
  * ```tsx
- * const { data, loading } = usePosts({
+ * const { data, error, loading } = usePosts({
  *   filter: {
  *     searchQuery: 'test',
  *   },

diff --git a/packages/react/src/post/useWhoExecutedActionOnPost.ts b/packages/react/src/post/useWhoExecutedActionOnPost.ts
@@ -35,7 +35,7 @@ export function useWhoExecutedActionOnPost(
  * Fetch who executed action on a post.
  *
  * ```tsx
- * const { data, loading } = useWhoExecutedActionOnPost({
+ * const { data, error, loading } = useWhoExecutedActionOnPost({
  *   post: postId('34…'),
  * });
  * ```

diff --git a/packages/react/src/post/useWhoReferencedPost.ts b/packages/react/src/post/useWhoReferencedPost.ts
@@ -35,7 +35,7 @@ export function useWhoReferencedPost(
  * Fetch who referenced a post.
  *
  * ```tsx
- * const { data, loading } = useWhoReferencedPost({ post: postId('34…') });
+ * const { data, error, loading } = useWhoReferencedPost({ post: postId('34…') });
  * ```
  */
 export function useWhoReferencedPost(

diff --git a/packages/react/src/timeline/useTimeline.ts b/packages/react/src/timeline/useTimeline.ts
@@ -32,7 +32,7 @@ export function useTimeline(
  * Fetch timeline from an account.
  *
  * ```tsx
- * const { data, loading } = useTimeline({ account: evmAddress('0x…') });
+ * const { data, error, loading } = useTimeline({ account: evmAddress('0x…') });
  * ```
  */
 export function useTimeline(

diff --git a/packages/react/src/timeline/useTimelineHighlights.ts b/packages/react/src/timeline/useTimelineHighlights.ts
@@ -32,7 +32,7 @@ export function useTimelineHighlights(
  * Fetch Timeline Highlights for an account.
  *
  * ```tsx
- * const { data, loading } = useTimelineHighlights({ account: evmAddress('0x…') });
+ * const { data, error, loading } = useTimelineHighlights({ account: evmAddress('0x…') });
  * ```
  */
 export function useTimelineHighlights(

diff --git a/packages/react/src/tokenDistribution/useTokenDistributions.ts b/packages/react/src/tokenDistribution/useTokenDistributions.ts
@@ -31,7 +31,7 @@ export function useTokenDistributions(
  * Fetch list of token distributions received by the authenticated account.
  *
  * ```tsx
- * const { data, loading } = useTokenDistributions();
+ * const { data, error, loading } = useTokenDistributions();
  * ```
  */
 export function useTokenDistributions(

diff --git a/packages/react/src/username/useNamespace.ts b/packages/react/src/username/useNamespace.ts
@@ -31,7 +31,7 @@ export function useNamespace(
  * Fetch a single namespace.
  *
  * ```tsx
- * const { data, loading } = useNamespace({ namespace: evmAddress('0x1234…') });
+ * const { data, error, loading } = useNamespace({ namespace: evmAddress('0x1234…') });
  * ```
  */
 export function useNamespace(

diff --git a/packages/react/src/username/useUsernames.ts b/packages/react/src/username/useUsernames.ts
@@ -39,7 +39,7 @@ export function useUsernames(
  * Example: owned by a specific address.
  *
  * ```tsx
- * const { data, loading } = useUsernames({
+ * const { data, error, loading } = useUsernames({
  *   filter: {
  *     owner: evmAddress('0x..'),
  *   },