@volr/react 0.1.21 → 0.1.22

package/dist/index.d.cts

@@ -397,11 +397,6 @@ type SendTxOptions = {
      * Sender address override. If not provided, uses user.evmAddress.
      */
     from?: `0x${string}`;
-    /**
-     * Run best-effort RPC preflight (eth_estimateGas) before prompting passkey.
-     * Defaults to true.
-     */
-    preflight?: boolean;
 };
 
 /**
@@ -709,4 +704,135 @@ declare function normalizeHex(value: `0x${string}` | string): `0x${string}`;
  */
 declare function normalizeHexArray(values: (`0x${string}` | string)[]): `0x${string}`[];
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type Erc20Token$1 as Erc20Token, type EvmChainOperations, 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, buildCall, buildCalls, createGetNetworkInfo, createPasskeyAdapter, defaultIdempotencyKey, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, usePrecheck, useRelay, useVolr, useVolrAuthCallback, useVolrLogin, useVolrWallet };
+/**
+ * Contract analysis utilities for debugging transaction failures
+ *
+ * These utilities help diagnose why a transaction might fail when executed
+ * through the Volr SDK with EIP-7702, but succeed with a regular wallet.
+ */
+
+/**
+ * Check if an address has EIP-7702 delegation code
+ */
+declare function isEIP7702Delegated(publicClient: PublicClient, address: Address): Promise<boolean>;
+/**
+ * Known patterns that may cause issues with EIP-7702
+ */
+interface ContractAnalysisResult {
+    /** Target contract address */
+    target: Address;
+    /** Whether the target has code (is a contract) */
+    isContract: boolean;
+    /** Code size in bytes */
+    codeSize: number;
+    /** Whether the contract might check msg.sender.code.length */
+    mayCheckSenderCode: boolean;
+    /** Whether the contract might use DelegationGuard pattern */
+    mayUseDelegationGuard: boolean;
+    /** Detected function selector */
+    functionSelector: string;
+    /** Analysis notes */
+    notes: string[];
+}
+/**
+ * Analyze a target contract for potential EIP-7702 compatibility issues
+ *
+ * This is a heuristic analysis and may not catch all cases.
+ * For definitive analysis, review the contract source code.
+ */
+declare function analyzeContractForEIP7702(publicClient: PublicClient, target: Address, calldata?: `0x${string}`): Promise<ContractAnalysisResult>;
+/**
+ * Diagnose potential issues with a transaction that fails
+ *
+ * @param publicClient - Viem public client
+ * @param from - Sender address (user EOA)
+ * @param target - Target contract address
+ * @param calldata - Transaction calldata
+ * @returns Diagnostic information
+ */
+declare function diagnoseTransactionFailure(publicClient: PublicClient, from: Address, target: Address, calldata: `0x${string}`): Promise<{
+    fromAnalysis: {
+        isDelegated: boolean;
+        hasCode: boolean;
+    };
+    targetAnalysis: ContractAnalysisResult;
+    recommendations: string[];
+}>;
+
+/**
+ * Wallet debugging utilities for comparing on-chain state
+ * between different wallet addresses
+ */
+
+/**
+ * Wallet state comparison result
+ */
+interface WalletStateComparison {
+    address: Address;
+    ethBalance: string;
+    ethBalanceWei: bigint;
+    hasCode: boolean;
+    codeLength: number;
+    nonce: number;
+    isEIP7702Delegated: boolean;
+}
+/**
+ * ERC20 balance comparison result
+ */
+interface ERC20BalanceComparison {
+    address: Address;
+    tokenAddress: Address;
+    balance: string;
+    balanceRaw: bigint;
+    decimals: number;
+}
+/**
+ * Get wallet state for comparison
+ */
+declare function getWalletState(publicClient: PublicClient, address: Address): Promise<WalletStateComparison>;
+/**
+ * Get ERC20 balance for a wallet
+ */
+declare function getERC20Balance(publicClient: PublicClient, walletAddress: Address, tokenAddress: Address, decimals?: number): Promise<ERC20BalanceComparison>;
+/**
+ * Compare two wallets' states
+ */
+declare function compareWalletStates(publicClient: PublicClient, address1: Address, address2: Address): Promise<{
+    wallet1: WalletStateComparison;
+    wallet2: WalletStateComparison;
+    differences: string[];
+}>;
+/**
+ * Compare ERC20 balances between two wallets
+ */
+declare function compareERC20Balances(publicClient: PublicClient, address1: Address, address2: Address, tokenAddress: Address, decimals?: number): Promise<{
+    wallet1: ERC20BalanceComparison;
+    wallet2: ERC20BalanceComparison;
+    difference: string;
+    differenceRaw: bigint;
+}>;
+/**
+ * Debug a transaction failure by comparing wallet states
+ *
+ * @param publicClient - Viem public client
+ * @param failingWallet - The wallet that fails through Volr
+ * @param workingWallet - A wallet that succeeds with the same transaction
+ * @param tokenAddress - Optional ERC20 token address to compare balances
+ * @param tokenDecimals - Token decimals (default 18)
+ */
+declare function debugTransactionFailure(publicClient: PublicClient, failingWallet: Address, workingWallet: Address, tokenAddress?: Address, tokenDecimals?: number): Promise<{
+    stateComparison: {
+        wallet1: WalletStateComparison;
+        wallet2: WalletStateComparison;
+        differences: string[];
+    };
+    tokenComparison?: {
+        wallet1: ERC20BalanceComparison;
+        wallet2: ERC20BalanceComparison;
+        difference: string;
+        differenceRaw: bigint;
+    };
+    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 EvmChainOperations, 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 };

package/dist/index.d.ts

@@ -397,11 +397,6 @@ type SendTxOptions = {
      * Sender address override. If not provided, uses user.evmAddress.
      */
     from?: `0x${string}`;
-    /**
-     * Run best-effort RPC preflight (eth_estimateGas) before prompting passkey.
-     * Defaults to true.
-     */
-    preflight?: boolean;
 };
 
 /**
@@ -709,4 +704,135 @@ declare function normalizeHex(value: `0x${string}` | string): `0x${string}`;
  */
 declare function normalizeHexArray(values: (`0x${string}` | string)[]): `0x${string}`[];
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type Erc20Token$1 as Erc20Token, type EvmChainOperations, 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, buildCall, buildCalls, createGetNetworkInfo, createPasskeyAdapter, defaultIdempotencyKey, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, usePrecheck, useRelay, useVolr, useVolrAuthCallback, useVolrLogin, useVolrWallet };
+/**
+ * Contract analysis utilities for debugging transaction failures
+ *
+ * These utilities help diagnose why a transaction might fail when executed
+ * through the Volr SDK with EIP-7702, but succeed with a regular wallet.
+ */
+
+/**
+ * Check if an address has EIP-7702 delegation code
+ */
+declare function isEIP7702Delegated(publicClient: PublicClient, address: Address): Promise<boolean>;
+/**
+ * Known patterns that may cause issues with EIP-7702
+ */
+interface ContractAnalysisResult {
+    /** Target contract address */
+    target: Address;
+    /** Whether the target has code (is a contract) */
+    isContract: boolean;
+    /** Code size in bytes */
+    codeSize: number;
+    /** Whether the contract might check msg.sender.code.length */
+    mayCheckSenderCode: boolean;
+    /** Whether the contract might use DelegationGuard pattern */
+    mayUseDelegationGuard: boolean;
+    /** Detected function selector */
+    functionSelector: string;
+    /** Analysis notes */
+    notes: string[];
+}
+/**
+ * Analyze a target contract for potential EIP-7702 compatibility issues
+ *
+ * This is a heuristic analysis and may not catch all cases.
+ * For definitive analysis, review the contract source code.
+ */
+declare function analyzeContractForEIP7702(publicClient: PublicClient, target: Address, calldata?: `0x${string}`): Promise<ContractAnalysisResult>;
+/**
+ * Diagnose potential issues with a transaction that fails
+ *
+ * @param publicClient - Viem public client
+ * @param from - Sender address (user EOA)
+ * @param target - Target contract address
+ * @param calldata - Transaction calldata
+ * @returns Diagnostic information
+ */
+declare function diagnoseTransactionFailure(publicClient: PublicClient, from: Address, target: Address, calldata: `0x${string}`): Promise<{
+    fromAnalysis: {
+        isDelegated: boolean;
+        hasCode: boolean;
+    };
+    targetAnalysis: ContractAnalysisResult;
+    recommendations: string[];
+}>;
+
+/**
+ * Wallet debugging utilities for comparing on-chain state
+ * between different wallet addresses
+ */
+
+/**
+ * Wallet state comparison result
+ */
+interface WalletStateComparison {
+    address: Address;
+    ethBalance: string;
+    ethBalanceWei: bigint;
+    hasCode: boolean;
+    codeLength: number;
+    nonce: number;
+    isEIP7702Delegated: boolean;
+}
+/**
+ * ERC20 balance comparison result
+ */
+interface ERC20BalanceComparison {
+    address: Address;
+    tokenAddress: Address;
+    balance: string;
+    balanceRaw: bigint;
+    decimals: number;
+}
+/**
+ * Get wallet state for comparison
+ */
+declare function getWalletState(publicClient: PublicClient, address: Address): Promise<WalletStateComparison>;
+/**
+ * Get ERC20 balance for a wallet
+ */
+declare function getERC20Balance(publicClient: PublicClient, walletAddress: Address, tokenAddress: Address, decimals?: number): Promise<ERC20BalanceComparison>;
+/**
+ * Compare two wallets' states
+ */
+declare function compareWalletStates(publicClient: PublicClient, address1: Address, address2: Address): Promise<{
+    wallet1: WalletStateComparison;
+    wallet2: WalletStateComparison;
+    differences: string[];
+}>;
+/**
+ * Compare ERC20 balances between two wallets
+ */
+declare function compareERC20Balances(publicClient: PublicClient, address1: Address, address2: Address, tokenAddress: Address, decimals?: number): Promise<{
+    wallet1: ERC20BalanceComparison;
+    wallet2: ERC20BalanceComparison;
+    difference: string;
+    differenceRaw: bigint;
+}>;
+/**
+ * Debug a transaction failure by comparing wallet states
+ *
+ * @param publicClient - Viem public client
+ * @param failingWallet - The wallet that fails through Volr
+ * @param workingWallet - A wallet that succeeds with the same transaction
+ * @param tokenAddress - Optional ERC20 token address to compare balances
+ * @param tokenDecimals - Token decimals (default 18)
+ */
+declare function debugTransactionFailure(publicClient: PublicClient, failingWallet: Address, workingWallet: Address, tokenAddress?: Address, tokenDecimals?: number): Promise<{
+    stateComparison: {
+        wallet1: WalletStateComparison;
+        wallet2: WalletStateComparison;
+        differences: string[];
+    };
+    tokenComparison?: {
+        wallet1: ERC20BalanceComparison;
+        wallet2: ERC20BalanceComparison;
+        difference: string;
+        differenceRaw: bigint;
+    };
+    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 EvmChainOperations, 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 };