@explorins/pers-sdk-react-native 1.5.30 → 1.5.32

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

@@ -1 +1 @@
-{"version":3,"file":"useTransactionSigner.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactionSigner.ts"],"names":[],"mappings":"AAMA,KAAK,gBAAgB,GAAG,OAAO,qCAAqC,EAAE,gBAAgB,CAAC;AACvF,KAAK,iBAAiB,GAAG,OAAO,qCAAqC,EAAE,iBAAiB,CAAC;AACzF,KAAK,wBAAwB,GAAG,OAAO,qCAAqC,EAAE,wBAAwB,CAAC;AAcvG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgLG;AACH,eAAO,MAAM,oBAAoB,QAAO,qBA4LvC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"useTransactionSigner.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactionSigner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,aAAa,EAAkB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI3G,KAAK,gBAAgB,GAAG,OAAO,qCAAqC,EAAE,gBAAgB,CAAC;AACvF,KAAK,iBAAiB,GAAG,OAAO,qCAAqC,EAAE,iBAAiB,CAAC;AACzF,KAAK,wBAAwB,GAAG,OAAO,qCAAqC,EAAE,wBAAwB,CAAC;AAGvG,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAczG;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/G,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgLG;AACH,eAAO,MAAM,oBAAoB,QAAO,qBAoPvC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/hooks/useTransactionSigner.js

@@ -1,4 +1,8 @@
 import { useCallback, useState, useRef, useEffect } from 'react';
+// import { usePersSDK } from '../providers/PersSDKProvider';
+import { SigningStatus } from '@explorins/pers-signer';
+// Re-export signing status types from signer SDK for convenience
+export { SigningStatus };
 // Dynamic import the signer SDK to avoid build issues with static dependencies
 let createPersSignerSDK = null;
 try {
@@ -191,6 +195,8 @@ const DEFAULT_ETHERS_PROVIDER = "https://sepolia.infura.io/v3/2781b4b5242343d5b0
 export const useTransactionSigner = () => {
     // const { isInitialized, isAuthenticated, user } = usePersSDK();
     const [isSignerInitialized, setIsSignerInitialized] = useState(false);
+    const [currentStatus, setCurrentStatus] = useState(null);
+    const [statusMessage, setStatusMessage] = useState(null);
     const signerSDKRef = useRef(null);
     // Auto-initialize signer SDK when PERS SDK is ready
     useEffect(() => {
@@ -239,6 +245,7 @@ export const useTransactionSigner = () => {
      *
      * @param {string} jwt - JWT token containing transaction ID and user information
      *   Must include: `transactionId`, `identifierEmail`, `tenantId`
+     * @param {StatusCallback} [onStatusUpdate] - Optional callback for real-time status updates
      * @returns {Promise<SubmissionResult>} Complete transaction result
      *
      * @throws {Error} 'Transaction signer not initialized' - Hook not ready
@@ -261,6 +268,15 @@ export const useTransactionSigner = () => {
      * ```
      *
      * @example
+     * **With Status Updates:**
+     * ```typescript
+     * const result = await signAndSubmitTransactionWithJWT(jwtToken, (status, message) => {
+     *   console.log(`Status: ${status} - ${message}`);
+     *   setStatusText(message);
+     * });
+     * ```
+     *
+     * @example
      * **With Error Handling:**
      * ```typescript
      * try {
@@ -295,20 +311,30 @@ export const useTransactionSigner = () => {
      *
      * @see {@link SubmissionResult} for detailed result structure
      */
-    const signAndSubmitTransactionWithJWT = useCallback(async (jwt) => {
+    const signAndSubmitTransactionWithJWT = useCallback(async (jwt, onStatusUpdate) => {
         if (!isSignerInitialized || !signerSDKRef.current) {
             throw new Error('Transaction signer not initialized');
         }
         if (!createPersSignerSDK) {
             throw new Error('PERS Signer SDK not available. Blockchain signing is not supported.');
         }
+        // Create status callback wrapper that updates both hook state and calls user callback
+        const statusCallback = {
+            onStatusUpdate: (status, message, data) => {
+                setCurrentStatus(status);
+                setStatusMessage(message);
+                onStatusUpdate?.(status, message, data);
+            }
+        };
         try {
             // Use the actual SDK method that handles the complete sign + submit flow
-            const submissionResult = await signerSDKRef.current.signAndSubmitPersTransaction(jwt);
+            const submissionResult = await signerSDKRef.current.signAndSubmitPersTransaction(jwt, statusCallback);
             return submissionResult;
         }
         catch (error) {
             console.error('[useTransactionSigner] JWT transaction signing failed:', error);
+            setCurrentStatus(SigningStatus.ERROR);
+            setStatusMessage(error instanceof Error ? error.message : 'Transaction failed');
             throw error; // Re-throw to maintain error handling upstream
         }
     }, [isSignerInitialized]);
@@ -320,6 +346,7 @@ export const useTransactionSigner = () => {
          * from authentication to blockchain submission in a single call.
          *
          * @param {string} jwt - JWT token with transaction and user data
+         * @param {StatusCallback} [onStatusUpdate] - Optional callback for real-time status updates
          * @returns {Promise<SubmissionResult>} Transaction result with hash and status
          */
         signAndSubmitTransactionWithJWT,
@@ -365,5 +392,35 @@ export const useTransactionSigner = () => {
          * ```
          */
         isSignerAvailable: isSignerInitialized && !!createPersSignerSDK,
+        /**
+         * Current signing status for UI feedback
+         *
+         * Tracks the current state of the signing process. Use this to show
+         * progress indicators or status messages during transaction signing.
+         *
+         * Possible values: 'initializing', 'authenticating', 'preparing',
+         * 'signing', 'submitting', 'completed', 'error', 'expired'
+         *
+         * @example
+         * ```typescript
+         * const { currentStatus, statusMessage } = useTransactionSigner();
+         *
+         * return (
+         *   <View>
+         *     {currentStatus && (
+         *       <Text>Status: {statusMessage}</Text>
+         *     )}
+         *   </View>
+         * );
+         * ```
+         */
+        currentStatus,
+        /**
+         * Human-readable status message
+         *
+         * Provides a user-friendly description of the current signing status.
+         * Updates in real-time as the transaction progresses.
+         */
+        statusMessage,
     };
 };

package/dist/hooks/useTransactions.d.ts

@@ -1,3 +1,4 @@
+import { OnStatusUpdateFn } from './useTransactionSigner';
 import type { TransactionRequestDTO, TransactionRequestResponseDTO, TransactionDTO, TransactionRole, TransactionPaginationRequestDTO } from '@explorins/pers-shared';
 /**
  * React hook for transaction operations in the PERS SDK
@@ -36,13 +37,15 @@ import type { TransactionRequestDTO, TransactionRequestResponseDTO, TransactionD
  * ```
  */
 export declare const useTransactions: () => {
-    createTransaction: (request: TransactionRequestDTO) => Promise<TransactionRequestResponseDTO>;
+    createTransaction: (request: TransactionRequestDTO, onStatusUpdate?: OnStatusUpdateFn) => Promise<TransactionRequestResponseDTO>;
     getTransactionById: (transactionId: string) => Promise<TransactionDTO | null>;
     getUserTransactionHistory: (role?: TransactionRole) => Promise<TransactionDTO[]>;
     getTenantTransactions: () => Promise<TransactionDTO[]>;
     getPaginatedTransactions: (params: TransactionPaginationRequestDTO) => Promise<any>;
     exportTransactionsCSV: () => Promise<Blob>;
     isAvailable: boolean;
+    signingStatus: import("@explorins/pers-signer").SigningStatus | null;
+    signingStatusMessage: string | null;
 };
 export type TransactionHook = ReturnType<typeof useTransactions>;
 //# sourceMappingURL=useTransactions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,eAAe,EACf,+BAA+B,EAChC,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCA8B4B,qBAAqB,KAAG,QAAQ,6BAA6B,CAAC;wCA8DvD,MAAM,KAAG,QAAQ,cAAc,GAAG,IAAI,CAAC;uCA6BxC,eAAe,KAAG,QAAQ,cAAc,EAAE,CAAC;iCAgBnD,QAAQ,cAAc,EAAE,CAAC;uCAcjB,+BAA+B,KAAG,QAAQ,GAAG,CAAC;iCAetD,QAAQ,IAAI,CAAC;;CAwBlE,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,eAAe,EACf,+BAA+B,EAChC,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCAgC4B,qBAAqB,mBAAmB,gBAAgB,KAAG,QAAQ,6BAA6B,CAAC;wCA2D1F,MAAM,KAAG,QAAQ,cAAc,GAAG,IAAI,CAAC;uCA4BxC,eAAe,KAAG,QAAQ,cAAc,EAAE,CAAC;iCAenD,QAAQ,cAAc,EAAE,CAAC;uCAcjB,+BAA+B,KAAG,QAAQ,GAAG,CAAC;iCActD,QAAQ,IAAI,CAAC;;;;CA0BlE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/hooks/useTransactions.js

@@ -39,7 +39,7 @@ import { useTransactionSigner } from './useTransactionSigner';
  */
 export const useTransactions = () => {
     const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-    const { signAndSubmitTransactionWithJWT, isSignerAvailable } = useTransactionSigner();
+    const { signAndSubmitTransactionWithJWT, isSignerAvailable, currentStatus, statusMessage } = useTransactionSigner();
     if (!isAuthenticated && isInitialized) {
         console.warn('SDK not authenticated. Some transaction operations may fail.');
     }
@@ -61,29 +61,29 @@ export const useTransactions = () => {
      *   recipient: '0x123...',
      *   tokenId: 'token-123'
      * };
-     * const result = await createTransaction(request);
+     * const result = await createTransaction(request, (status, message) => {
+     *   console.log(`Status: ${status} - ${message}`);
+     * });
      * console.log('Transaction created:', result);
      * ```
      */
-    const createTransaction = useCallback(async (request) => {
+    const createTransaction = useCallback(async (request, onStatusUpdate) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
             const result = await sdk.transactions.createTransaction(request);
-            console.log('Transaction created successfully:', result);
             // Check if transaction requires signing (contains actionable authToken)
             // Type assertion needed as TransactionRequestResponseDTO type may not include all dynamic properties
             const txToken = result?.actionable?.authToken;
             if (txToken) {
-                console.log('[useTransactions] Transaction requires signing, attempting automatic signature...');
                 try {
                     if (!isSignerAvailable) {
                         console.warn('[useTransactions] Transaction signer not available, skipping automatic signing');
                         return result;
                     }
                     // Automatically sign the transaction using the authToken
-                    const signingResult = await signAndSubmitTransactionWithJWT(txToken);
+                    const signingResult = await signAndSubmitTransactionWithJWT(txToken, onStatusUpdate);
                     if (signingResult.success) {
                         console.log('[useTransactions] Transaction signed successfully:', signingResult.transactionHash);
                         // Return the original result - the transaction is now signed and will be processed
@@ -128,7 +128,6 @@ export const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.getTransactionById(transactionId);
-            console.log('Transaction fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -156,7 +155,6 @@ export const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.getUserTransactionHistory(role);
-            console.log('Transaction history fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -183,7 +181,6 @@ export const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.getPaginatedTransactions(params);
-            console.log('Paginated transactions fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -197,7 +194,6 @@ export const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.exportTransactionsCSV();
-            console.log('Transactions CSV exported successfully');
             return result;
         }
         catch (error) {
@@ -213,5 +209,8 @@ export const useTransactions = () => {
         getPaginatedTransactions,
         exportTransactionsCSV,
         isAvailable: isInitialized && !!sdk?.transactions,
+        // Expose signing status for UI feedback
+        signingStatus: currentStatus,
+        signingStatusMessage: statusMessage,
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"useUserStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useUserStatus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,eAAO,MAAM,aAAa;8BAGyB,QAAQ,iBAAiB,EAAE,CAAC;+BAe3B,QAAQ,iBAAiB,EAAE,CAAC;2CAmBd,iBAAiB,KAAG,QAAQ,iBAAiB,CAAC;;CAqB/G,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"useUserStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useUserStatus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,eAAO,MAAM,aAAa;8BAGyB,QAAQ,iBAAiB,EAAE,CAAC;+BAc3B,QAAQ,iBAAiB,EAAE,CAAC;2CAkBd,iBAAiB,KAAG,QAAQ,iBAAiB,CAAC;;CAoB/G,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/hooks/useUserStatus.js

@@ -8,7 +8,6 @@ export const useUserStatus = () => {
         }
         try {
             const result = await sdk.userStatus.getUserStatusTypes();
-            console.log('User status types fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -25,7 +24,6 @@ export const useUserStatus = () => {
         }
         try {
             const result = await sdk.userStatus.getEarnedUserStatus();
-            console.log('Earned user status fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -40,7 +38,6 @@ export const useUserStatus = () => {
         }
         try {
             const result = await sdk.userStatus.createUserStatusType(userStatusType);
-            console.log('User status type created successfully:', result);
             return result;
         }
         catch (error) {

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

@@ -1 +1 @@
-{"version":3,"file":"useUsers.d.ts","sourceRoot":"","sources":["../../src/hooks/useUsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,eAAO,MAAM,QAAQ;0BAG0B,QAAQ,OAAO,CAAC;kCAkBN,oBAAoB,KAAG,QAAQ,OAAO,CAAC;0BAkB/C,MAAM,KAAG,QAAQ,OAAO,CAAC;iCAelB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAG,QAAQ,oBAAoB,EAAE,CAAC;uBAgB5E,QAAQ,OAAO,EAAE,CAAC;yBAed,MAAM,YAAY,oBAAoB,KAAG,QAAQ,OAAO,CAAC;6BAerD,OAAO,KAAG,QAAQ,OAAO,CAAC;;CAyB7E,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"useUsers.d.ts","sourceRoot":"","sources":["../../src/hooks/useUsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,eAAO,MAAM,QAAQ;0BAG0B,QAAQ,OAAO,CAAC;kCAiBN,oBAAoB,KAAG,QAAQ,OAAO,CAAC;0BAiB/C,MAAM,KAAG,QAAQ,OAAO,CAAC;iCAclB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAG,QAAQ,oBAAoB,EAAE,CAAC;uBAe5E,QAAQ,OAAO,EAAE,CAAC;yBAcd,MAAM,YAAY,oBAAoB,KAAG,QAAQ,OAAO,CAAC;6BAcrD,OAAO,KAAG,QAAQ,OAAO,CAAC;;CAwB7E,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/hooks/useUsers.js

@@ -11,7 +11,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.getCurrentUser();
-            console.log('Current user fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -28,7 +27,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.updateCurrentUser(userData);
-            console.log('Current user updated successfully:', result);
             return result;
         }
         catch (error) {
@@ -42,7 +40,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.getUserById(userId);
-            console.log('User fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -56,7 +53,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.getAllUsersPublic(filter);
-            console.log('Public users fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -71,7 +67,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.getAllUsers();
-            console.log('All users fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -85,7 +80,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.updateUser(userId, userData);
-            console.log('User updated successfully:', result);
             return result;
         }
         catch (error) {
@@ -99,7 +93,6 @@ export const useUsers = () => {
         }
         try {
             const result = await sdk.users.toggleUserStatus(user);
-            console.log('User status toggled successfully:', result);
             return result;
         }
         catch (error) {

package/dist/hooks/useWeb3.d.ts

@@ -1,65 +1,51 @@
 import type { TokenBalance, TokenBalanceRequest, TokenCollectionRequest, TokenCollection, TokenMetadata } from '@explorins/pers-sdk/web3';
 import type { ChainData } from '@explorins/pers-sdk/web3-chain';
-/**
- * Wallet information interface
- *
- * @interface WalletInfo
- * @property {string | null} address - Wallet address if connected
- * @property {boolean} isConnected - Whether wallet is connected
- */
-export interface WalletInfo {
-    address: string | null;
-    isConnected: boolean;
-}
 /**
  * React hook for Web3 operations in the PERS SDK
  *
  * Provides comprehensive Web3 functionality including token balance queries,
  * metadata retrieval, collection management, IPFS resolution, and blockchain
- * explorer integration. Supports multi-chain operations and wallet management.
+ * explorer integration. Supports multi-chain operations.
+ *
+ * Note: Wallet addresses should be obtained from `user.wallets` via `usePersSDK()`.
  *
  * @returns Web3 hook with methods for blockchain operations
  *
  * @example
  * ```typescript
  * function Web3Component() {
- *   const {
- *     getTokenBalance,
- *     getTokenMetadata,
- *     getWalletInfo,
- *     accountAddress
- *   } = useWeb3();
+ *   const { user } = usePersSDK();
+ *   const { getTokenBalance, getTokenMetadata } = useWeb3();
+ *
+ *   // Get wallet address from user
+ *   const walletAddress = user?.wallets?.[0]?.address;
  *
  *   const loadTokenData = async () => {
- *     try {
- *       if (!accountAddress) {
- *         console.log('No wallet connected');
- *         return;
- *       }
+ *     if (!walletAddress) {
+ *       console.log('No wallet connected');
+ *       return;
+ *     }
  *
- *       const balance = await getTokenBalance({
- *         walletAddress: accountAddress,
- *         contractAddress: '0x123...',
- *         chainId: 1
- *       });
+ *     const balance = await getTokenBalance({
+ *       walletAddress,
+ *       contractAddress: '0x123...',
+ *       chainId: 1
+ *     });
  *
- *       console.log('Token balance:', balance);
- *     } catch (error) {
- *       console.error('Failed to load token data:', error);
- *     }
+ *     console.log('Token balance:', balance);
  *   };
  *
  *   return (
- *     <div>
- *       {accountAddress ? (
- *         <div>
- *           <p>Wallet: {accountAddress}</p>
- *           <button onClick={loadTokenData}>Load Tokens</button>
- *         </div>
+ *     <View>
+ *       {walletAddress ? (
+ *         <View>
+ *           <Text>Wallet: {walletAddress}</Text>
+ *           <Button onPress={loadTokenData} title="Load Tokens" />
+ *         </View>
  *       ) : (
- *         <p>No wallet connected</p>
+ *         <Text>No wallet connected</Text>
  *       )}
- *     </div>
+ *     </View>
  *   );
  * }
  * ```
@@ -72,8 +58,6 @@ export declare const useWeb3: () => {
     fetchAndProcessMetadata: (tokenUri: string, chainId: number) => Promise<TokenMetadata | null>;
     getChainDataById: (chainId: number) => Promise<ChainData | null>;
     getExplorerUrl: (chainId: number, address: string, type: 'address' | 'tx') => Promise<string>;
-    getWalletInfo: () => Promise<WalletInfo | null>;
-    accountAddress: string | null;
     isAvailable: boolean;
 };
 export type Web3Hook = ReturnType<typeof useWeb3>;

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,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,OAAO;+BA0BkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAmC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAejD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAezD,MAAM,WAAW,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAe3B,MAAM,WAAW,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAe/D,MAAM,KAAG,QAAQ,SAAS,GAAG,IAAI,CAAC;8BAepC,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;yBAexE,QAAQ,UAAU,GAAG,IAAI,CAAC;;;CA2BvE,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,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,OAAO;+BA0BkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAiC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAcjD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAczD,MAAM,WAAW,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAc3B,MAAM,WAAW,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAc/D,MAAM,KAAG,QAAQ,SAAS,GAAG,IAAI,CAAC;8BAcpC,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;;CAwBrH,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/hooks/useWeb3.js

@@ -5,56 +5,53 @@ import { usePersSDK } from '../providers/PersSDKProvider';
  *
  * Provides comprehensive Web3 functionality including token balance queries,
  * metadata retrieval, collection management, IPFS resolution, and blockchain
- * explorer integration. Supports multi-chain operations and wallet management.
+ * explorer integration. Supports multi-chain operations.
+ *
+ * Note: Wallet addresses should be obtained from `user.wallets` via `usePersSDK()`.
  *
  * @returns Web3 hook with methods for blockchain operations
  *
  * @example
  * ```typescript
  * function Web3Component() {
- *   const {
- *     getTokenBalance,
- *     getTokenMetadata,
- *     getWalletInfo,
- *     accountAddress
- *   } = useWeb3();
+ *   const { user } = usePersSDK();
+ *   const { getTokenBalance, getTokenMetadata } = useWeb3();
+ *
+ *   // Get wallet address from user
+ *   const walletAddress = user?.wallets?.[0]?.address;
  *
  *   const loadTokenData = async () => {
- *     try {
- *       if (!accountAddress) {
- *         console.log('No wallet connected');
- *         return;
- *       }
+ *     if (!walletAddress) {
+ *       console.log('No wallet connected');
+ *       return;
+ *     }
  *
- *       const balance = await getTokenBalance({
- *         walletAddress: accountAddress,
- *         contractAddress: '0x123...',
- *         chainId: 1
- *       });
+ *     const balance = await getTokenBalance({
+ *       walletAddress,
+ *       contractAddress: '0x123...',
+ *       chainId: 1
+ *     });
  *
- *       console.log('Token balance:', balance);
- *     } catch (error) {
- *       console.error('Failed to load token data:', error);
- *     }
+ *     console.log('Token balance:', balance);
  *   };
  *
  *   return (
- *     <div>
- *       {accountAddress ? (
- *         <div>
- *           <p>Wallet: {accountAddress}</p>
- *           <button onClick={loadTokenData}>Load Tokens</button>
- *         </div>
+ *     <View>
+ *       {walletAddress ? (
+ *         <View>
+ *           <Text>Wallet: {walletAddress}</Text>
+ *           <Button onPress={loadTokenData} title="Load Tokens" />
+ *         </View>
  *       ) : (
- *         <p>No wallet connected</p>
+ *         <Text>No wallet connected</Text>
  *       )}
- *     </div>
+ *     </View>
  *   );
  * }
  * ```
  */
 export const useWeb3 = () => {
-    const { sdk, isInitialized, isAuthenticated, accountAddress } = usePersSDK();
+    const { sdk, isInitialized, isAuthenticated } = usePersSDK();
     if (!isAuthenticated && isInitialized) {
         console.warn('SDK not authenticated. Some web3 operations may fail.');
     }
@@ -78,13 +75,11 @@ export const useWeb3 = () => {
      * ```
      */
     const getTokenBalance = useCallback(async (request) => {
-        console.log('[useWeb3] getTokenBalance called with request:', request);
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
             const result = await sdk.web3.getTokenBalance(request);
-            console.log('Token balance fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -117,7 +112,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.getTokenMetadata(request);
-            console.log('Token metadata fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -131,7 +125,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.getTokenCollection(request);
-            console.log('Token collection fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -145,7 +138,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.resolveIPFSUrl(url, chainId);
-            console.log('IPFS URL resolved successfully:', result);
             return result;
         }
         catch (error) {
@@ -159,7 +151,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.fetchAndProcessMetadata(tokenUri, chainId);
-            console.log('Metadata fetched and processed successfully:', result);
             return result;
         }
         catch (error) {
@@ -173,7 +164,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.getChainDataById(chainId);
-            console.log('Chain data fetched successfully:', result);
             return result;
         }
         catch (error) {
@@ -187,7 +177,6 @@ export const useWeb3 = () => {
         }
         try {
             const result = await sdk.web3.getExplorerUrl(chainId, address, type);
-            console.log('Explorer URL generated successfully:', result);
             return result;
         }
         catch (error) {
@@ -195,19 +184,6 @@ export const useWeb3 = () => {
             throw error;
         }
     }, [sdk, isInitialized]);
-    const getWalletInfo = useCallback(async () => {
-        if (!isInitialized) {
-            throw new Error('SDK not initialized. Call initialize() first.');
-        }
-        if (!accountAddress) {
-            console.warn('No account address available');
-            return null;
-        }
-        return {
-            address: accountAddress,
-            isConnected: !!accountAddress,
-        };
-    }, [isInitialized, accountAddress]);
     return {
         getTokenBalance,
         getTokenMetadata,
@@ -216,8 +192,6 @@ export const useWeb3 = () => {
         fetchAndProcessMetadata,
         getChainDataById,
         getExplorerUrl,
-        getWalletInfo,
-        accountAddress: isInitialized ? accountAddress : null,
         isAvailable: isInitialized && !!sdk?.web3,
     };
 };

package/dist/index.d.ts

@@ -185,7 +185,8 @@ export { PersSDKProvider, usePersSDK, type PersConfig, type PersSDKContext } fro
  * }
  * ```
  */
-export { useAuth, useTokens, useTransactions, useTransactionSigner, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations } from './hooks';
+export { useAuth, useTokens, useTransactions, useTransactionSigner, SigningStatus, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations } from './hooks';
+export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType } from './hooks';
 /**
  * React Native-optimized HTTP client with automatic request/response handling
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAMjB;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;GAeG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMrF;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;GAeG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC"}