@explorins/pers-sdk-react-native 2.1.19 → 2.1.21

package/dist/hooks/index.d.ts

@@ -7,6 +7,7 @@ export { useBusiness } from './useBusiness';
 export { useCampaigns } from './useCampaigns';
 export { useRedemptions } from './useRedemptions';
 export { useWeb3 } from './useWeb3';
+export { useResolvedUrl, useMetadata, useIPFSUrl } from './useIPFSUrl';
 export { usePurchases } from './usePurchases';
 export { useTenants } from './useTenants';
 export { useUsers } from './useUsers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,IAAI,iBAAiB,EACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrH,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGhI,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGzE,YAAY,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGlF,YAAY,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxF,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,IAAI,iBAAiB,EACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrH,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGhI,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGzE,YAAY,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGlF,YAAY,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxF,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/index.js

@@ -8,6 +8,7 @@ export { useBusiness } from './useBusiness';
 export { useCampaigns } from './useCampaigns';
 export { useRedemptions } from './useRedemptions';
 export { useWeb3 } from './useWeb3';
+export { useResolvedUrl, useMetadata, useIPFSUrl } from './useIPFSUrl';
 export { usePurchases } from './usePurchases';
 export { useTenants } from './useTenants';
 export { useUsers } from './useUsers';

package/dist/hooks/useIPFSUrl.d.ts

@@ -0,0 +1,68 @@
+import type { TokenMetadata } from '@explorins/pers-sdk/web3';
+/**
+ * React hook for resolving media URLs (IPFS or HTTPS).
+ *
+ * Automatically handles IPFS URLs by resolving them to HTTPS via tenant's gateway.
+ * Non-IPFS URLs are returned as-is. Handles loading and error states.
+ *
+ * @param url - The URL to resolve (can be ipfs://, https://, or undefined)
+ * @returns Object with resolved URL, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * function NFTImage({ metadataUri }: { metadataUri?: string }) {
+ *   const { url, isLoading } = useResolvedUrl(metadataUri);
+ *
+ *   if (isLoading) return <ActivityIndicator />;
+ *   return <Image source={{ uri: url }} />;
+ * }
+ * ```
+ */
+export declare function useResolvedUrl(url: string | undefined | null): {
+    /** Resolved HTTPS URL (or original if not IPFS) */
+    url: string | null;
+    /** Whether resolution is in progress */
+    isLoading: boolean;
+    /** Error message if resolution failed */
+    error: string | null;
+};
+/**
+ * React hook for fetching NFT/token metadata from a URI.
+ *
+ * Handles IPFS resolution automatically and returns parsed metadata
+ * with all nested IPFS URLs already resolved to HTTPS.
+ *
+ * @param metadataUri - The metadata URI to fetch (can be ipfs:// or https://)
+ * @returns Object with metadata, loading state, error, and refresh function
+ *
+ * @example
+ * ```tsx
+ * function NFTDetails({ metadataUri }: { metadataUri?: string }) {
+ *   const { metadata, isLoading, error } = useMetadata(metadataUri);
+ *
+ *   if (isLoading) return <ActivityIndicator />;
+ *   if (error) return <Text>Error: {error}</Text>;
+ *   if (!metadata) return null;
+ *
+ *   return (
+ *     <View>
+ *       <Image source={{ uri: metadata.imageUrl }} />
+ *       <Text>{metadata.name}</Text>
+ *       <Text>{metadata.description}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMetadata(metadataUri: string | undefined | null): {
+    /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.) */
+    metadata: TokenMetadata | null;
+    /** Whether fetch is in progress */
+    isLoading: boolean;
+    /** Error message if fetch failed */
+    error: string | null;
+    /** Manually refresh metadata */
+    refresh: () => Promise<void>;
+};
+export { useResolvedUrl as useIPFSUrl };
+//# sourceMappingURL=useIPFSUrl.d.ts.map

package/dist/hooks/useIPFSUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIPFSUrl.d.ts","sourceRoot":"","sources":["../../src/hooks/useIPFSUrl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmCzD,mDAAmD;;IAEnD,wCAAwC;;IAExC,yCAAyC;;EAG5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA+B9D,6EAA6E;;IAE7E,mCAAmC;;IAEnC,oCAAoC;;IAEpC,gCAAgC;;EAGnC;AAGD,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,CAAC"}

package/dist/hooks/useIPFSUrl.js

@@ -0,0 +1,127 @@
+import { useState, useEffect } from 'react';
+import { useWeb3 } from './useWeb3';
+/**
+ * React hook for resolving media URLs (IPFS or HTTPS).
+ *
+ * Automatically handles IPFS URLs by resolving them to HTTPS via tenant's gateway.
+ * Non-IPFS URLs are returned as-is. Handles loading and error states.
+ *
+ * @param url - The URL to resolve (can be ipfs://, https://, or undefined)
+ * @returns Object with resolved URL, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * function NFTImage({ metadataUri }: { metadataUri?: string }) {
+ *   const { url, isLoading } = useResolvedUrl(metadataUri);
+ *
+ *   if (isLoading) return <ActivityIndicator />;
+ *   return <Image source={{ uri: url }} />;
+ * }
+ * ```
+ */
+export function useResolvedUrl(url) {
+    const { resolveIPFSUrl, isAvailable } = useWeb3();
+    const [resolvedUrl, setResolvedUrl] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!url || !isAvailable) {
+            setResolvedUrl(null);
+            return;
+        }
+        // Non-IPFS URLs don't need resolution
+        if (!url.startsWith('ipfs://')) {
+            setResolvedUrl(url);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        resolveIPFSUrl(url)
+            .then((resolved) => {
+            setResolvedUrl(resolved);
+        })
+            .catch((err) => {
+            setError(err instanceof Error ? err.message : 'Failed to resolve URL');
+            setResolvedUrl(null);
+        })
+            .finally(() => {
+            setIsLoading(false);
+        });
+    }, [url, isAvailable, resolveIPFSUrl]);
+    return {
+        /** Resolved HTTPS URL (or original if not IPFS) */
+        url: resolvedUrl,
+        /** Whether resolution is in progress */
+        isLoading,
+        /** Error message if resolution failed */
+        error,
+    };
+}
+/**
+ * React hook for fetching NFT/token metadata from a URI.
+ *
+ * Handles IPFS resolution automatically and returns parsed metadata
+ * with all nested IPFS URLs already resolved to HTTPS.
+ *
+ * @param metadataUri - The metadata URI to fetch (can be ipfs:// or https://)
+ * @returns Object with metadata, loading state, error, and refresh function
+ *
+ * @example
+ * ```tsx
+ * function NFTDetails({ metadataUri }: { metadataUri?: string }) {
+ *   const { metadata, isLoading, error } = useMetadata(metadataUri);
+ *
+ *   if (isLoading) return <ActivityIndicator />;
+ *   if (error) return <Text>Error: {error}</Text>;
+ *   if (!metadata) return null;
+ *
+ *   return (
+ *     <View>
+ *       <Image source={{ uri: metadata.imageUrl }} />
+ *       <Text>{metadata.name}</Text>
+ *       <Text>{metadata.description}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useMetadata(metadataUri) {
+    const { fetchAndProcessMetadata, isAvailable } = useWeb3();
+    const [metadata, setMetadata] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchMetadata = async () => {
+        if (!metadataUri || !isAvailable) {
+            setMetadata(null);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await fetchAndProcessMetadata(metadataUri);
+            setMetadata(result);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to fetch metadata');
+            setMetadata(null);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    };
+    useEffect(() => {
+        fetchMetadata();
+    }, [metadataUri, isAvailable]);
+    return {
+        /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.) */
+        metadata,
+        /** Whether fetch is in progress */
+        isLoading,
+        /** Error message if fetch failed */
+        error,
+        /** Manually refresh metadata */
+        refresh: fetchMetadata,
+    };
+}
+// Re-export with descriptive aliases
+export { useResolvedUrl as useIPFSUrl };

package/dist/hooks/useTransactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,+BAA+B,EAC/B,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCAgC4B,qBAAqB,mBAAmB,gBAAgB,KAAG,QAAQ,6BAA6B,CAAC;wCAmEtI,MAAM,YACX,0BAA0B,EAAE,KACrC,QAAQ,cAAc,GAAG,IAAI,CAAC;0CAoDrB,uBAAuB,KAChC,QAAQ,qBAAqB,cAAc,CAAC,CAAC;wCA2CrC,+BAA+B,GAAG;QACzC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;KACxC,KACA,QAAQ,qBAAqB,cAAc,CAAC,CAAC;iCAcI,QAAQ,IAAI,CAAC;;;;CAyBlE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"useTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,+BAA+B,EAC/B,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCAgC4B,qBAAqB,mBAAmB,gBAAgB,KAAG,QAAQ,6BAA6B,CAAC;wCAmEtI,MAAM,YACX,0BAA0B,EAAE,KACrC,QAAQ,cAAc,GAAG,IAAI,CAAC;0CAmDrB,uBAAuB,KAChC,QAAQ,qBAAqB,cAAc,CAAC,CAAC;wCAyCrC,+BAA+B,GAAG;QACzC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;KACxC,KACA,QAAQ,qBAAqB,cAAc,CAAC,CAAC;iCAcI,QAAQ,IAAI,CAAC;;;;CAyBlE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/hooks/useTransactions.js

@@ -134,8 +134,7 @@ export const useTransactions = () => {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.transactions.getTransactionById(transactionId, include);
-            return result;
+            return await sdk.transactions.getTransactionById(transactionId, include);
         }
         catch (error) {
             console.error('Failed to fetch transaction:', error);
@@ -184,8 +183,7 @@ export const useTransactions = () => {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.transactions.getUserTransactionHistory(options);
-            return result;
+            return await sdk.transactions.getUserTransactionHistory(options);
         }
         catch (error) {
             console.error('Failed to fetch transaction history:', error);

package/dist/hooks/useWeb3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAGtE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,OAAO;+BAmCkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAiC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAcjD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAqBzD,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAoBV,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAc9C,MAAM,KAAG,QAAQ,SAAS,CAAC;8BAc7B,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;6BAiCxE,QAAQ,KAAG,MAAM,EAAE,GAAG,SAAS;wDAuCzD,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,QAAQ,wBAAwB,CAAC;6CAqBlB,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,sBAAsB;;CAqB1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}
+{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAGtE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,OAAO;+BAmCkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAiC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAcjD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BA8BzD,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAoBV,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAc9C,MAAM,KAAG,QAAQ,SAAS,CAAC;8BAc7B,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;6BAiCxE,QAAQ,KAAG,MAAM,EAAE,GAAG,SAAS;wDAuCzD,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,QAAQ,wBAAwB,CAAC;6CAqBlB,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,sBAAsB;;CAqB1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/hooks/useWeb3.js

@@ -145,23 +145,32 @@ export const useWeb3 = () => {
     /**
      * Resolve IPFS URL to HTTP gateway URL
      *
-     * @deprecated Use `sdk.tenant.resolveIPFSUrl()` directly - IPFS is chain-agnostic
+     * Converts an ipfs:// URL to an HTTPS URL using the tenant's configured IPFS gateway.
+     * Non-IPFS URLs are returned unchanged.
+     *
      * @param url - IPFS URL to resolve (ipfs://...)
      * @returns Promise resolving to HTTP gateway URL
+     *
+     * @example
+     * ```typescript
+     * const { resolveIPFSUrl } = useWeb3();
+     * const httpsUrl = await resolveIPFSUrl('ipfs://QmHash...');
+     * // Returns: 'https://gateway.pinata.cloud/ipfs/QmHash...'
+     * ```
      */
     const resolveIPFSUrl = useCallback(async (url) => {
-        if (!isInitialized || !sdk) {
+        if (!isInitialized || !web3) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.tenants.resolveIPFSUrl(url);
+            const result = await web3.resolveIPFSUrl(url);
             return result;
         }
         catch (error) {
             console.error('Failed to resolve IPFS URL:', error);
             throw error;
         }
-    }, [sdk, isInitialized]);
+    }, [web3, isInitialized]);
     /**
      * Fetch and process token metadata from a URI
      *