hiero-sdk-utils-react 0.1.0

package/dist/esm/HieroProvider.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { HieroClient } from 'hiero-sdk-utils';
+/**
+ * Props for the HieroProvider component.
+ */
+export interface HieroProviderProps {
+    /** The HieroClient instance to provide to all descendant hooks */
+    client: HieroClient;
+    children: React.ReactNode;
+}
+/**
+ * Provides a HieroClient instance to all descendant hooks.
+ * Place this once at the root of your application.
+ *
+ * @example
+ * ```tsx
+ * const client = new HieroClient({ baseUrl: Networks.mainnet });
+ *
+ * <HieroProvider client={client}>
+ *   <App />
+ * </HieroProvider>
+ * ```
+ */
+export declare function HieroProvider({ client, children }: HieroProviderProps): JSX.Element;
+/**
+ * Returns the HieroClient from the nearest HieroProvider.
+ * Throws a clear error if called outside a HieroProvider.
+ *
+ * @internal
+ */
+export declare function useHieroClient(): HieroClient;
+//# sourceMappingURL=HieroProvider.d.ts.map

package/dist/esm/HieroProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HieroProvider.d.ts","sourceRoot":"","sources":["../../src/HieroProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAMnF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAS5C"}

package/dist/esm/HieroProvider.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// SPDX-License-Identifier: Apache-2.0
+import { createContext, useContext } from 'react';
+const HieroContext = createContext(null);
+/**
+ * Provides a HieroClient instance to all descendant hooks.
+ * Place this once at the root of your application.
+ *
+ * @example
+ * ```tsx
+ * const client = new HieroClient({ baseUrl: Networks.mainnet });
+ *
+ * <HieroProvider client={client}>
+ *   <App />
+ * </HieroProvider>
+ * ```
+ */
+export function HieroProvider({ client, children }) {
+    return (_jsx(HieroContext.Provider, { value: client, children: children }));
+}
+/**
+ * Returns the HieroClient from the nearest HieroProvider.
+ * Throws a clear error if called outside a HieroProvider.
+ *
+ * @internal
+ */
+export function useHieroClient() {
+    const client = useContext(HieroContext);
+    if (client === null) {
+        throw new Error('useHieroClient must be used within a HieroProvider. ' +
+            'Wrap your component tree with <HieroProvider client={client}>.');
+    }
+    return client;
+}
+//# sourceMappingURL=HieroProvider.js.map

package/dist/esm/HieroProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HieroProvider.js","sourceRoot":"","sources":["../../src/HieroProvider.tsx"],"names":[],"mappings":";AAAA,sCAAsC;AAEtC,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGzD,MAAM,YAAY,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAW7D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAsB;IACpE,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YACjC,QAAQ,GACa,CACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,sDAAsD;YACtD,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/hooks/useAccount.d.ts

@@ -0,0 +1,16 @@
+import type { AccountInfo } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Fetches account information by ID from the Hedera Mirror Node.
+ * Pass `null` to skip the fetch (e.g., when the ID is not yet known).
+ *
+ * @param accountId - Account in `0.0.X` format, or null to skip
+ * @returns Query result with AccountInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error } = useAccount('0.0.1234');
+ * ```
+ */
+export declare function useAccount(accountId: string | null): HieroQueryResult<AccountInfo>;
+//# sourceMappingURL=useAccount.d.ts.map

package/dist/esm/hooks/useAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccount.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAccount.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAoClF"}

package/dist/esm/hooks/useAccount.js

@@ -0,0 +1,50 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches account information by ID from the Hedera Mirror Node.
+ * Pass `null` to skip the fetch (e.g., when the ID is not yet known).
+ *
+ * @param accountId - Account in `0.0.X` format, or null to skip
+ * @returns Query result with AccountInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error } = useAccount('0.0.1234');
+ * ```
+ */
+export function useAccount(accountId) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    useEffect(() => {
+        if (accountId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        client.accounts.getById(accountId)
+            .then((result) => {
+            if (!cancelled) {
+                setData(result);
+                setLoading(false);
+            }
+        })
+            .catch((err) => {
+            if (!cancelled) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+                setLoading(false);
+            }
+        });
+        return () => { cancelled = true; };
+    }, [accountId, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useAccount.js.map

package/dist/esm/hooks/useAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccount.js","sourceRoot":"","sources":["../../../src/hooks/useAccount.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;aAC/B,IAAI,CAAC,CAAC,MAAM,EAAQ,EAAE;YACrB,IAAI,CAAC,SAAS,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QACzD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAQ,EAAE;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAE9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/hooks/useAccountTransactions.d.ts

@@ -0,0 +1,17 @@
+import type { TransactionInfo, TransactionsQueryParams } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Fetches the first page of transactions for an account from the Hedera Mirror Node.
+ * The accountId is injected as `account.id` in the query params automatically.
+ *
+ * @param accountId - Account in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters for filtering
+ * @returns Query result with TransactionInfo array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: txs } = useAccountTransactions('0.0.1234', { limit: 10 });
+ * ```
+ */
+export declare function useAccountTransactions(accountId: string | null, params?: TransactionsQueryParams): HieroQueryResult<TransactionInfo[]>;
+//# sourceMappingURL=useAccountTransactions.d.ts.map

package/dist/esm/hooks/useAccountTransactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountTransactions.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAccountTransactions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,CAAC,EAAE,uBAAuB,GAC/B,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAoDrC"}

package/dist/esm/hooks/useAccountTransactions.js

@@ -0,0 +1,67 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches the first page of transactions for an account from the Hedera Mirror Node.
+ * The accountId is injected as `account.id` in the query params automatically.
+ *
+ * @param accountId - Account in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters for filtering
+ * @returns Query result with TransactionInfo array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: txs } = useAccountTransactions('0.0.1234', { limit: 10 });
+ * ```
+ */
+export function useAccountTransactions(accountId, params) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    const limit = params?.limit;
+    useEffect(() => {
+        if (accountId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const effectiveLimit = limit ?? 25;
+        const paramsWithLimit = {
+            ...params,
+            'account.id': accountId,
+            limit: effectiveLimit,
+        };
+        void (async () => {
+            const results = [];
+            try {
+                for await (const tx of client.transactions.list(paramsWithLimit)) {
+                    results.push(tx);
+                    if (results.length >= effectiveLimit)
+                        break;
+                }
+                if (!cancelled) {
+                    setData(results);
+                    setLoading(false);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setLoading(false);
+                }
+            }
+        })();
+        return () => { cancelled = true; };
+        // Only limit is tracked from params — not the full object — to avoid re-render
+        // loops when callers pass inline objects. Other param changes need a new hook call.
+    }, [accountId, limit, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useAccountTransactions.js.map

package/dist/esm/hooks/useAccountTransactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountTransactions.js","sourceRoot":"","sources":["../../../src/hooks/useAccountTransactions.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAwB,EACxB,MAAgC;IAEhC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA2B,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAE5B,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,eAAe,GAA4B;YAC/C,GAAG,MAAM;YACT,YAAY,EAAE,SAAS;YACvB,KAAK,EAAE,cAAc;SACtB,CAAC;QAEF,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC9B,MAAM,OAAO,GAAsB,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;oBACjE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjB,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;wBAAE,MAAM;gBAC9C,CAAC;gBACD,IAAI,CAAC,SAAS,EAAE,CAAC;oBAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,+EAA+E;QAC/E,oFAAoF;IACtF,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAErC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/hooks/useNFTs.d.ts

@@ -0,0 +1,22 @@
+import type { NftInfo, NftsQueryParams } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Hook-specific params: excludes serialnumber (use client.nfts.getByTokenAndSerial for that).
+ */
+type NftsHookParams = Omit<NftsQueryParams, 'serialnumber'>;
+/**
+ * Fetches the first page of NFTs for a token from the Hedera Mirror Node.
+ * Default page size is 25. Pass `limit` in params to change.
+ *
+ * @param tokenId - Token in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters (excludes serialnumber)
+ * @returns Query result with NftInfo array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: nfts } = useNFTs('0.0.5678', { limit: 10 });
+ * ```
+ */
+export declare function useNFTs(tokenId: string | null, params?: NftsHookParams): HieroQueryResult<NftInfo[]>;
+export {};
+//# sourceMappingURL=useNFTs.d.ts.map

package/dist/esm/hooks/useNFTs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNFTs.d.ts","sourceRoot":"","sources":["../../../src/hooks/useNFTs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;GAEG;AACH,KAAK,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,CAAC,EAAE,cAAc,GACtB,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAgD7B"}

package/dist/esm/hooks/useNFTs.js

@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches the first page of NFTs for a token from the Hedera Mirror Node.
+ * Default page size is 25. Pass `limit` in params to change.
+ *
+ * @param tokenId - Token in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters (excludes serialnumber)
+ * @returns Query result with NftInfo array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: nfts } = useNFTs('0.0.5678', { limit: 10 });
+ * ```
+ */
+export function useNFTs(tokenId, params) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    const limit = params?.limit;
+    useEffect(() => {
+        if (tokenId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const effectiveLimit = limit ?? 25;
+        const paramsWithLimit = { ...params, limit: effectiveLimit };
+        void (async () => {
+            const results = [];
+            try {
+                for await (const nft of client.nfts.listByToken(tokenId, paramsWithLimit)) {
+                    results.push(nft);
+                    if (results.length >= effectiveLimit)
+                        break;
+                }
+                if (!cancelled) {
+                    setData(results);
+                    setLoading(false);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setLoading(false);
+                }
+            }
+        })();
+        return () => { cancelled = true; };
+        // Only limit is tracked from params — not the full object — to avoid re-render
+        // loops when callers pass inline objects. Other param changes need a new hook call.
+    }, [tokenId, limit, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useNFTs.js.map

package/dist/esm/hooks/useNFTs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNFTs.js","sourceRoot":"","sources":["../../../src/hooks/useNFTs.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CACrB,OAAsB,EACtB,MAAuB;IAEvB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAmB,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAE5B,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,eAAe,GAAmB,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAE7E,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC9B,MAAM,OAAO,GAAc,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC;oBAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClB,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;wBAAE,MAAM;gBAC9C,CAAC;gBACD,IAAI,CAAC,SAAS,EAAE,CAAC;oBAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,+EAA+E;QAC/E,oFAAoF;IACtF,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/hooks/useToken.d.ts

@@ -0,0 +1,15 @@
+import type { TokenInfo } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Fetches token information by ID from the Hedera Mirror Node.
+ *
+ * @param tokenId - Token in `0.0.X` format, or null to skip
+ * @returns Query result with TokenInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data } = useToken('0.0.5678');
+ * ```
+ */
+export declare function useToken(tokenId: string | null): HieroQueryResult<TokenInfo>;
+//# sourceMappingURL=useToken.d.ts.map

package/dist/esm/hooks/useToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.d.ts","sourceRoot":"","sources":["../../../src/hooks/useToken.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAoC5E"}

package/dist/esm/hooks/useToken.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches token information by ID from the Hedera Mirror Node.
+ *
+ * @param tokenId - Token in `0.0.X` format, or null to skip
+ * @returns Query result with TokenInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data } = useToken('0.0.5678');
+ * ```
+ */
+export function useToken(tokenId) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    useEffect(() => {
+        if (tokenId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        client.tokens.getById(tokenId)
+            .then((result) => {
+            if (!cancelled) {
+                setData(result);
+                setLoading(false);
+            }
+        })
+            .catch((err) => {
+            if (!cancelled) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+                setLoading(false);
+            }
+        });
+        return () => { cancelled = true; };
+    }, [tokenId, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useToken.js.map

package/dist/esm/hooks/useToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../../src/hooks/useToken.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAsB;IAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAmB,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aAC3B,IAAI,CAAC,CAAC,MAAM,EAAQ,EAAE;YACrB,IAAI,CAAC,SAAS,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QACzD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAQ,EAAE;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAE5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/hooks/useTopicMessages.d.ts

@@ -0,0 +1,16 @@
+import type { TopicMessage, TopicMessagesQueryParams } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Fetches the first page of HCS messages for a topic from the Hedera Mirror Node.
+ *
+ * @param topicId - Topic in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters for filtering
+ * @returns Query result with TopicMessage array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: messages } = useTopicMessages('0.0.7777', { limit: 20 });
+ * ```
+ */
+export declare function useTopicMessages(topicId: string | null, params?: TopicMessagesQueryParams): HieroQueryResult<TopicMessage[]>;
+//# sourceMappingURL=useTopicMessages.d.ts.map

package/dist/esm/hooks/useTopicMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTopicMessages.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTopicMessages.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,CAAC,EAAE,wBAAwB,GAChC,gBAAgB,CAAC,YAAY,EAAE,CAAC,CAgDlC"}

package/dist/esm/hooks/useTopicMessages.js

@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches the first page of HCS messages for a topic from the Hedera Mirror Node.
+ *
+ * @param topicId - Topic in `0.0.X` format, or null to skip
+ * @param params - Optional query parameters for filtering
+ * @returns Query result with TopicMessage array, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data: messages } = useTopicMessages('0.0.7777', { limit: 20 });
+ * ```
+ */
+export function useTopicMessages(topicId, params) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    const limit = params?.limit;
+    useEffect(() => {
+        if (topicId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const effectiveLimit = limit ?? 25;
+        const paramsWithLimit = { ...params, limit: effectiveLimit };
+        void (async () => {
+            const results = [];
+            try {
+                for await (const msg of client.topics.listMessages(topicId, paramsWithLimit)) {
+                    results.push(msg);
+                    if (results.length >= effectiveLimit)
+                        break;
+                }
+                if (!cancelled) {
+                    setData(results);
+                    setLoading(false);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setLoading(false);
+                }
+            }
+        })();
+        return () => { cancelled = true; };
+        // Only limit is tracked from params — not the full object — to avoid re-render
+        // loops when callers pass inline objects. Other param changes need a new hook call.
+    }, [topicId, limit, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useTopicMessages.js.map

package/dist/esm/hooks/useTopicMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTopicMessages.js","sourceRoot":"","sources":["../../../src/hooks/useTopicMessages.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAsB,EACtB,MAAiC;IAEjC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAE5B,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,eAAe,GAA6B,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAEvF,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC9B,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC;oBAC7E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClB,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;wBAAE,MAAM;gBAC9C,CAAC;gBACD,IAAI,CAAC,SAAS,EAAE,CAAC;oBAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,+EAA+E;QAC/E,oFAAoF;IACtF,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/hooks/useTransaction.d.ts

@@ -0,0 +1,15 @@
+import type { TransactionInfo } from 'hiero-sdk-utils';
+import type { HieroQueryResult } from '../types.js';
+/**
+ * Fetches a single transaction by ID from the Hedera Mirror Node.
+ *
+ * @param transactionId - Transaction ID in `0.0.X-secs-nanos` format, or null to skip
+ * @returns Query result with TransactionInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTransaction('0.0.1234-1234567890-000000001');
+ * ```
+ */
+export declare function useTransaction(transactionId: string | null): HieroQueryResult<TransactionInfo>;
+//# sourceMappingURL=useTransaction.d.ts.map

package/dist/esm/hooks/useTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTransaction.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTransaction.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAoC9F"}

package/dist/esm/hooks/useTransaction.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { useState, useEffect, useCallback } from 'react';
+import { useHieroClient } from '../HieroProvider.js';
+/**
+ * Fetches a single transaction by ID from the Hedera Mirror Node.
+ *
+ * @param transactionId - Transaction ID in `0.0.X-secs-nanos` format, or null to skip
+ * @returns Query result with TransactionInfo data, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTransaction('0.0.1234-1234567890-000000001');
+ * ```
+ */
+export function useTransaction(transactionId) {
+    const client = useHieroClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refetch = useCallback(() => { setTick(t => t + 1); }, []);
+    useEffect(() => {
+        if (transactionId === null) {
+            setData(null);
+            setLoading(false);
+            setError(null);
+            return () => { };
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        client.transactions.getById(transactionId)
+            .then((result) => {
+            if (!cancelled) {
+                setData(result);
+                setLoading(false);
+            }
+        })
+            .catch((err) => {
+            if (!cancelled) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+                setLoading(false);
+            }
+        });
+        return () => { cancelled = true; };
+    }, [transactionId, client, tick]);
+    return { data, loading, error, refetch };
+}
+//# sourceMappingURL=useTransaction.js.map

package/dist/esm/hooks/useTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTransaction.js","sourceRoot":"","sources":["../../../src/hooks/useTransaction.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,SAAS,CAAC,GAAiB,EAAE;QAC3B,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,GAAS,EAAE,GAA2B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC;aACvC,IAAI,CAAC,CAAC,MAAM,EAAQ,EAAE;YACrB,IAAI,CAAC,SAAS,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QACzD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAQ,EAAE;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,GAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAElC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * hiero-sdk-utils-react — React hooks for the Hedera/Hiero Mirror Node.
+ *
+ * @example
+ * ```tsx
+ * import { HieroClient, Networks } from 'hiero-sdk-utils';
+ * import { HieroProvider, useAccount } from 'hiero-sdk-utils-react';
+ *
+ * const client = new HieroClient({ baseUrl: Networks.mainnet });
+ *
+ * function App() {
+ *   return (
+ *     <HieroProvider client={client}>
+ *       <AccountView />
+ *     </HieroProvider>
+ *   );
+ * }
+ *
+ * function AccountView() {
+ *   const { data, loading, error } = useAccount('0.0.1234');
+ *   if (loading) return <span>Loading...</span>;
+ *   if (error) return <span>Error: {error.message}</span>;
+ *   return <span>{data?.balance.balance} tinybars</span>;
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { HieroProvider } from './HieroProvider.js';
+export type { HieroProviderProps } from './HieroProvider.js';
+export type { HieroQueryResult } from './types.js';
+export { useAccount } from './hooks/useAccount.js';
+export { useTransaction } from './hooks/useTransaction.js';
+export { useToken } from './hooks/useToken.js';
+export { useNFTs } from './hooks/useNFTs.js';
+export { useAccountTransactions } from './hooks/useAccountTransactions.js';
+export { useTopicMessages } from './hooks/useTopicMessages.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * hiero-sdk-utils-react — React hooks for the Hedera/Hiero Mirror Node.
+ *
+ * @example
+ * ```tsx
+ * import { HieroClient, Networks } from 'hiero-sdk-utils';
+ * import { HieroProvider, useAccount } from 'hiero-sdk-utils-react';
+ *
+ * const client = new HieroClient({ baseUrl: Networks.mainnet });
+ *
+ * function App() {
+ *   return (
+ *     <HieroProvider client={client}>
+ *       <AccountView />
+ *     </HieroProvider>
+ *   );
+ * }
+ *
+ * function AccountView() {
+ *   const { data, loading, error } = useAccount('0.0.1234');
+ *   if (loading) return <span>Loading...</span>;
+ *   if (error) return <span>Error: {error.message}</span>;
+ *   return <span>{data?.balance.balance} tinybars</span>;
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { HieroProvider } from './HieroProvider.js';
+export { useAccount } from './hooks/useAccount.js';
+export { useTransaction } from './hooks/useTransaction.js';
+export { useToken } from './hooks/useToken.js';
+export { useNFTs } from './hooks/useNFTs.js';
+export { useAccountTransactions } from './hooks/useAccountTransactions.js';
+export { useTopicMessages } from './hooks/useTopicMessages.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/esm/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Return shape for all Hiero query hooks.
+ *
+ * @typeParam T - The data type returned by the query
+ */
+export interface HieroQueryResult<T> {
+    /** The fetched data, or null while loading or on error */
+    data: T | null;
+    /** True while a network request is in flight */
+    loading: boolean;
+    /** The error thrown by the last failed request, or null */
+    error: Error | null;
+    /** Re-triggers the query without changing parameters */
+    refetch: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,0DAA0D;IAC1D,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/dist/esm/types.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "hiero-sdk-utils-react",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "React hooks for the Hedera/Hiero Mirror Node — built on hiero-sdk-utils",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    }
+  },
+  "files": ["dist/"],
+  "engines": { "node": ">=18.0.0" },
+  "scripts": {
+    "build":          "tsc -p tsconfig.json",
+    "test":           "vitest run",
+    "lint":           "eslint src/ tests/ --max-warnings 0",
+    "typecheck":      "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "hiero-sdk-utils": ">=0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "jsdom": "^24.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": { "access": "public" },
+  "license": "Apache-2.0",
+  "author": "Dmitrij Titarenko <dtytarenko666@gmail.com>",
+  "homepage": "https://github.com/dmitrijtitarenko/hiero-sdk-utils#readme",
+  "bugs": { "url": "https://github.com/dmitrijtitarenko/hiero-sdk-utils/issues" },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dmitrijtitarenko/hiero-sdk-utils.git",
+    "directory": "packages/react"
+  },
+  "keywords": ["hedera", "hiero", "mirror-node", "react", "hooks", "blockchain"]
+}