@volr/react 0.1.49 → 0.1.53

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, SignerPort, ExtendedRPCClient, Call, PasskeyProviderPort } from '@volr/sdk-core';
+import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, PasskeyProviderPort } from '@volr/sdk-core';
 export { AuthorizationTuple, Call, MpcTransport, PrecheckInput, PrecheckQuote, PrfInput, RelayInput, RelayMode, RelayResult, SessionAuth, UploadBlobOptions, createMasterKeyProvider, createMpcProvider, createPasskeyProvider, deriveEvmKey, deriveWrapKey, sealMasterSeed, uploadBlob } from '@volr/sdk-core';
 import { Address, Abi, PublicClient } from 'viem';
 
@@ -270,53 +270,6 @@ type VolrProviderProps = {
  */
 declare function VolrProvider({ config, children }: VolrProviderProps): react_jsx_runtime.JSX.Element;
 
-/**
- * useVolr hook - Access Volr context
- */
-/**
- * Get Volr context value
- * @throws Error if used outside VolrProvider
- */
-declare function useVolr(): VolrContextValue;
-
-/**
- * usePrecheck hook - Precheck transaction batch
- */
-
-/**
- * usePrecheck return type
- */
-type UsePrecheckReturn = {
-    precheck: (input: PrecheckInput) => Promise<PrecheckQuote>;
-    isLoading: boolean;
-    error: Error | null;
-};
-/**
- * usePrecheck hook
- */
-declare function usePrecheck(): UsePrecheckReturn;
-
-/**
- * useRelay hook - Relay transaction batch
- */
-
-/**
- * useRelay return type
- */
-type UseRelayReturn = {
-    relay: (input: Omit<RelayInput, "sessionSig" | "authorizationList">, opts?: {
-        signer: SignerPort;
-        rpcClient?: ExtendedRPCClient;
-        idempotencyKey?: string;
-    }) => Promise<RelayResult>;
-    isLoading: boolean;
-    error: Error | null;
-};
-/**
- * useRelay hook
- */
-declare function useRelay(): UseRelayReturn;
-
 /**
  * Call builder utilities for better developer experience
  */
@@ -400,7 +353,7 @@ type SendTxOptions = {
 };
 
 /**
- * useVolrWallet hook - Developer-friendly facade for wallet operations
+ * useVolr hook - Main developer-facing hook for Volr SDK
  */
 
 /**
@@ -468,8 +421,7 @@ type EvmClient = {
      * @example
      * ```ts
      * const result = await evm(1).sendTransaction(
-     *   { to: '0x...', data: '0x...', value: 0n },
-     *   { policyId: '0x...' }
+     *   { to: '0x...', data: '0x...' },
      * );
      * ```
      */
@@ -477,27 +429,67 @@ type EvmClient = {
         to: `0x${string}`;
         data: `0x${string}`;
         value?: bigint;
-    }, opts: SendTxOptions) => Promise<RelayResult>;
+        gasLimit?: bigint;
+    }, opts?: SendTxOptions) => Promise<RelayResult>;
     /**
      * Send a batch of transactions
      */
     sendBatch: SendBatchOverloads;
 };
 /**
- * useVolrWallet hook return type
+ * Volr client interface
  */
-type UseVolrWalletReturn = {
+type VolrClient = {
     /**
      * Get EVM client for a specific chain
      * @param chainId - The chain ID to operate on
      * @returns EVM client interface
      */
     evm: (chainId: number) => EvmClient;
+    /**
+     * User's EVM wallet address
+     */
+    address: `0x${string}` | undefined;
+    /**
+     * User's email (if logged in with email)
+     */
+    email: string | undefined;
+    /**
+     * Whether user is logged in
+     */
+    isLoggedIn: boolean;
+    /**
+     * How the user signs transactions
+     */
+    signerType: SignerType | undefined;
+    /**
+     * Logout the user
+     */
+    logout: () => Promise<void>;
+    /**
+     * Whether SDK is loading
+     */
+    isLoading: boolean;
+    /**
+     * Error if any
+     */
+    error: Error | null;
 };
 /**
- * useVolrWallet hook - Developer-friendly facade
+ * useVolr hook - Main developer-facing hook
+ */
+declare function useVolr(): VolrClient;
+
+/**
+ * useVolrContext hook - Internal access to Volr context
+ * @internal This hook is for SDK internal use only. Use useVolr instead.
+ */
+/**
+ * Get full Volr context value (internal use only)
+ * @throws Error if used outside VolrProvider
+ * @internal
  */
-declare function useVolrWallet(): UseVolrWalletReturn;
+declare function useVolrContext(): VolrContextValue;
 
 /**
  * useVolrLogin hook - Login handlers for various authentication methods
@@ -832,4 +824,4 @@ declare function debugTransactionFailure(publicClient: PublicClient, failingWall
     analysis: string[];
 }>;
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UsePrecheckReturn, type UseRelayReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UseVolrWalletReturn, type UserDto, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, usePrecheck, useRelay, useVolr, useVolrAuthCallback, useVolrLogin, useVolrWallet };
+export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, SignerPort, ExtendedRPCClient, Call, PasskeyProviderPort } from '@volr/sdk-core';
+import { KeyStorageType as KeyStorageType$1, WalletProviderPort, PrecheckInput, PrecheckQuote, RelayInput, RelayResult, Call, PasskeyProviderPort } from '@volr/sdk-core';
 export { AuthorizationTuple, Call, MpcTransport, PrecheckInput, PrecheckQuote, PrfInput, RelayInput, RelayMode, RelayResult, SessionAuth, UploadBlobOptions, createMasterKeyProvider, createMpcProvider, createPasskeyProvider, deriveEvmKey, deriveWrapKey, sealMasterSeed, uploadBlob } from '@volr/sdk-core';
 import { Address, Abi, PublicClient } from 'viem';
 
@@ -270,53 +270,6 @@ type VolrProviderProps = {
  */
 declare function VolrProvider({ config, children }: VolrProviderProps): react_jsx_runtime.JSX.Element;
 
-/**
- * useVolr hook - Access Volr context
- */
-/**
- * Get Volr context value
- * @throws Error if used outside VolrProvider
- */
-declare function useVolr(): VolrContextValue;
-
-/**
- * usePrecheck hook - Precheck transaction batch
- */
-
-/**
- * usePrecheck return type
- */
-type UsePrecheckReturn = {
-    precheck: (input: PrecheckInput) => Promise<PrecheckQuote>;
-    isLoading: boolean;
-    error: Error | null;
-};
-/**
- * usePrecheck hook
- */
-declare function usePrecheck(): UsePrecheckReturn;
-
-/**
- * useRelay hook - Relay transaction batch
- */
-
-/**
- * useRelay return type
- */
-type UseRelayReturn = {
-    relay: (input: Omit<RelayInput, "sessionSig" | "authorizationList">, opts?: {
-        signer: SignerPort;
-        rpcClient?: ExtendedRPCClient;
-        idempotencyKey?: string;
-    }) => Promise<RelayResult>;
-    isLoading: boolean;
-    error: Error | null;
-};
-/**
- * useRelay hook
- */
-declare function useRelay(): UseRelayReturn;
-
 /**
  * Call builder utilities for better developer experience
  */
@@ -400,7 +353,7 @@ type SendTxOptions = {
 };
 
 /**
- * useVolrWallet hook - Developer-friendly facade for wallet operations
+ * useVolr hook - Main developer-facing hook for Volr SDK
  */
 
 /**
@@ -468,8 +421,7 @@ type EvmClient = {
      * @example
      * ```ts
      * const result = await evm(1).sendTransaction(
-     *   { to: '0x...', data: '0x...', value: 0n },
-     *   { policyId: '0x...' }
+     *   { to: '0x...', data: '0x...' },
      * );
      * ```
      */
@@ -477,27 +429,67 @@ type EvmClient = {
         to: `0x${string}`;
         data: `0x${string}`;
         value?: bigint;
-    }, opts: SendTxOptions) => Promise<RelayResult>;
+        gasLimit?: bigint;
+    }, opts?: SendTxOptions) => Promise<RelayResult>;
     /**
      * Send a batch of transactions
      */
     sendBatch: SendBatchOverloads;
 };
 /**
- * useVolrWallet hook return type
+ * Volr client interface
  */
-type UseVolrWalletReturn = {
+type VolrClient = {
     /**
      * Get EVM client for a specific chain
      * @param chainId - The chain ID to operate on
      * @returns EVM client interface
      */
     evm: (chainId: number) => EvmClient;
+    /**
+     * User's EVM wallet address
+     */
+    address: `0x${string}` | undefined;
+    /**
+     * User's email (if logged in with email)
+     */
+    email: string | undefined;
+    /**
+     * Whether user is logged in
+     */
+    isLoggedIn: boolean;
+    /**
+     * How the user signs transactions
+     */
+    signerType: SignerType | undefined;
+    /**
+     * Logout the user
+     */
+    logout: () => Promise<void>;
+    /**
+     * Whether SDK is loading
+     */
+    isLoading: boolean;
+    /**
+     * Error if any
+     */
+    error: Error | null;
 };
 /**
- * useVolrWallet hook - Developer-friendly facade
+ * useVolr hook - Main developer-facing hook
+ */
+declare function useVolr(): VolrClient;
+
+/**
+ * useVolrContext hook - Internal access to Volr context
+ * @internal This hook is for SDK internal use only. Use useVolr instead.
+ */
+/**
+ * Get full Volr context value (internal use only)
+ * @throws Error if used outside VolrProvider
+ * @internal
  */
-declare function useVolrWallet(): UseVolrWalletReturn;
+declare function useVolrContext(): VolrContextValue;
 
 /**
  * useVolrLogin hook - Login handlers for various authentication methods
@@ -832,4 +824,4 @@ declare function debugTransactionFailure(publicClient: PublicClient, failingWall
     analysis: string[];
 }>;
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UsePrecheckReturn, type UseRelayReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UseVolrWalletReturn, type UserDto, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, usePrecheck, useRelay, useVolr, useVolrAuthCallback, useVolrLogin, useVolrWallet };
+export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };

package/dist/index.js

@@ -1,6 +1,6 @@
 import * as nc from 'crypto';
 import { createContext, useRef, useEffect, useMemo, useState, useCallback, useContext } from 'react';
-import { signSession, getAuthNonce, signAuthorization, createPasskeyProvider, createMpcProvider, deriveWrapKey, createMasterKeyProvider, sealMasterSeed, uploadBlob, deriveEvmKey, ZERO_HASH, selectSigner, VolrError } from '@volr/sdk-core';
+import { createPasskeyProvider, createMpcProvider, signSession, getAuthNonce, signAuthorization, deriveWrapKey, createMasterKeyProvider, sealMasterSeed, uploadBlob, deriveEvmKey, ZERO_HASH, selectSigner, VolrError } from '@volr/sdk-core';
 export { createMasterKeyProvider, createMpcProvider, createPasskeyProvider, deriveEvmKey, deriveWrapKey, sealMasterSeed, uploadBlob } from '@volr/sdk-core';
 import axios from 'axios';
 import { jsx } from 'react/jsx-runtime';
@@ -10080,10 +10080,10 @@ function VolrProvider({ config, children }) {
   );
   return /* @__PURE__ */ jsx(VolrContext.Provider, { value: publicValue, children: /* @__PURE__ */ jsx(InternalAuthContext.Provider, { value: internalValue, children }) });
 }
-function useVolr() {
+function useVolrContext() {
   const context = useContext(VolrContext);
   if (!context) {
-    throw new Error("useVolr must be used within VolrProvider");
+    throw new Error("useVolrContext must be used within VolrProvider");
   }
   return context;
 }
@@ -10165,7 +10165,7 @@ function validateRelayInput(input, config = {}) {
 
 // src/hooks/usePrecheck.ts
 function usePrecheck() {
-  const { precheck: precheckContext } = useVolr();
+  const { precheck: precheckContext } = useVolrContext();
   const [isLoading, setIsLoading] = useState(false);
   const [error, setError] = useState(null);
   const precheck = useCallback(
@@ -10199,7 +10199,7 @@ function useInternalAuth() {
   return context;
 }
 function useRelay() {
-  const { relay: relayContext } = useVolr();
+  const { relay: relayContext } = useVolrContext();
   const { client } = useInternalAuth();
   const [isLoading, setIsLoading] = useState(false);
   const [error, setError] = useState(null);
@@ -10255,7 +10255,7 @@ function useRelay() {
           authorizationList: [authorizationTuple]
         };
         validateRelayInput(relayInput);
-        return await relayContext(relayInput, {
+        return relayContext(relayInput, {
           idempotencyKey: opts.idempotencyKey
         });
       } catch (err) {
@@ -18359,9 +18359,9 @@ async function sendCalls(args) {
   }
 }
 
-// src/hooks/useVolrWallet.ts
-function useVolrWallet() {
-  const { user, config, provider, setProvider } = useVolr();
+// src/hooks/useVolr.ts
+function useVolr() {
+  const { user, config, provider, setProvider, logout, isLoading, error } = useVolrContext();
   const { precheck } = usePrecheck();
   const { relay } = useRelay();
   const { client } = useInternalAuth();
@@ -18391,12 +18391,12 @@ function useVolrWallet() {
           const { publicClient: client2 } = await ensureRpcClient();
           return client2.readContract(args);
         },
-        sendTransaction: async (tx, opts) => {
+        sendTransaction: async (tx, opts = {}) => {
           const { publicClient: publicClient2, extendedRpcClient: rpcClient } = await ensureRpcClient();
           const from14 = opts.from ?? user?.evmAddress;
           if (!from14) {
             throw new Error(
-              "from address is required. Provide it in opts.from or set user.evmAddress in VolrProvider. If you haven't set up a wallet provider yet, please complete the onboarding flow."
+              "from address is required. Provide it in opts.from or ensure user is logged in."
             );
           }
           const call2 = {
@@ -18427,7 +18427,7 @@ function useVolrWallet() {
           const from14 = opts.from ?? user?.evmAddress;
           if (!from14) {
             throw new Error(
-              "from address is required. Provide it in opts.from or set user.evmAddress in VolrProvider. If you haven't set up a wallet provider yet, please complete the onboarding flow."
+              "from address is required. Provide it in opts.from or ensure user is logged in."
             );
           }
           const isCallArray = (calls2) => {
@@ -18458,12 +18458,21 @@ function useVolrWallet() {
         })
       };
     },
-    [user, config, provider, precheck, relay, getRpcUrl]
+    [user, config, provider, precheck, relay, getRpcUrl, setProvider, client]
   );
-  return { evm };
+  return {
+    evm,
+    address: user?.evmAddress,
+    email: user?.email,
+    isLoggedIn: user !== null,
+    signerType: user?.signerType,
+    logout,
+    isLoading,
+    error
+  };
 }
 function useVolrLogin() {
-  const { config, setUser } = useVolr();
+  const { config, setUser } = useVolrContext();
   const { setAccessToken, setRefreshToken, client } = useInternalAuth();
   const toVolrUser = useCallback((u) => {
     return {
@@ -18630,7 +18639,7 @@ function createAxiosInstance(baseUrl, apiKey) {
 
 // src/hooks/useVolrAuthCallback.ts
 function useVolrAuthCallback(options = {}) {
-  const { config, setUser } = useVolr();
+  const { config, setUser } = useVolrContext();
   const { refreshAccessToken, setAccessToken, setRefreshToken, client } = useInternalAuth();
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
@@ -18755,7 +18764,7 @@ function balanceOfCalldata(address) {
   return `${selector}${pad32(address).slice(2)}`;
 }
 function useDepositListener(input) {
-  const { config } = useVolr();
+  const { config } = useVolrContext();
   const { client } = useInternalAuth();
   const [status, setStatus] = useState({ state: "idle" });
   const intervalRef = useRef(null);
@@ -19009,7 +19018,7 @@ async function enrollPasskey(params) {
   }
 }
 function usePasskeyEnrollment() {
-  const { config, setProvider, setUser, user } = useVolr();
+  const { config, setProvider, setUser, user } = useVolrContext();
   const { client } = useInternalAuth();
   const [step, setStep] = useState("idle");
   const [isEnrolling, setIsEnrolling] = useState(false);
@@ -19198,7 +19207,7 @@ async function registerWalletProvider(params) {
   });
 }
 function useMpcConnection() {
-  const { setProvider } = useVolr();
+  const { setProvider } = useVolrContext();
   const { client } = useInternalAuth();
   const [step, setStep] = useState("idle");
   const [isConnecting, setIsConnecting] = useState(false);
@@ -19491,6 +19500,6 @@ async function debugTransactionFailure(publicClient, failingWallet, workingWalle
   (*! noble-curves - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, VolrProvider, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, usePrecheck, useRelay, useVolr, useVolrAuthCallback, useVolrLogin, useVolrWallet };
+export { DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, VolrProvider, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map