@oasisprotocol/privana-sdk 0.2.1 → 0.3.0

package/dist/index.d.cts

@@ -663,6 +663,32 @@ interface SignWithdrawFromLockParams {
 }
 declare function signWithdrawFromLockMessage({ walletClient, chainId, verifyingContract, message, }: SignWithdrawFromLockParams): Promise<`0x${string}`>;
 
+type SiweAuthSession = {
+    address: Address;
+};
+type SiweAuthTokens = Pick<SiweLoginResponse, 'siwe_token' | 'jwt_access_token' | 'jwt_refresh_token' | 'address'>;
+interface SiweAuthContextValue {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    session: SiweAuthSession | null;
+    accessToken: string | undefined;
+    tokens: SiweAuthTokens | null;
+    login: () => Promise<void>;
+    logout: () => Promise<void>;
+}
+interface SiweAuthConfig {
+    autoLogin?: boolean;
+    statement?: string;
+}
+interface SiweAuthProviderProps extends SiweAuthConfig {
+    children: ReactNode;
+    client: PrivanaClient;
+    networkConfig: NetworkConfig;
+}
+declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, statement, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSiweAuth(): SiweAuthContextValue;
+
 type TokensStatus = 'loading' | 'ready' | 'error';
 interface PrivanaContextValue {
     client: PrivanaClient;
@@ -711,8 +737,16 @@ interface PrivanaProviderProps {
      * Optional hosted redirect auth configuration for cross-domain browser apps.
      */
     hostedAuth?: HostedAuthConfig;
+    /**
+     * Optional direct (in-app) SIWE auth. When provided, the connected wallet
+     * signs an EIP-4361 message in-app and `useSiweAuth()` becomes available.
+     * Mutually exclusive with `hostedAuth`: providing both throws, because
+     * `usePrivateReadRequest()` prefers `hostedAuthConfig` and would otherwise
+     * ignore the SIWE login.
+     */
+    siweAuth?: SiweAuthConfig;
 }
-declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
+declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePrivanaContext(): PrivanaContextValue;
 declare function useSafePrivanaContext(): PrivanaContextValue | null;
 
@@ -963,9 +997,11 @@ interface UseHistoryResult {
 }
 declare function useHistory(options?: UseHistoryOptions): UseHistoryResult;
 
+type AccountStatus = 'connecting' | 'reconnecting' | 'connected' | 'disconnected';
 interface SafeAccountResult {
     address: Address$1 | undefined;
     isConnected: boolean;
+    status: AccountStatus;
 }
 declare function useSafeAccount(): SafeAccountResult;
 
@@ -1057,4 +1093,4 @@ declare function Skeleton({ className, ...props }: React.ComponentProps<'div'>):
 declare function getTokenIcon(symbol: string, size?: number): react_jsx_runtime.JSX.Element;
 declare function getChainIcon(chainId: number, size?: number): react_jsx_runtime.JSX.Element;
 
-export { AccountingApiError, type Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, type Bytes32, type ChainConfig, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, type HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, type HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, type IntegerLike, type JwtLogoutRequest, type JwtLogoutResponse, type JwtRefreshRequest, type JwtRefreshResponse, LOCK_TYPES, type LockFundsParams, type LockFundsRequest, type LockInfo, type LockMessage, type LockNonceResponse, type LockedFundsResponse, MODIFY_LOCK_TYPES, type MinDepositAmounts, type ModifyLockMessage, type ModifyLockNonceResponse, type ModifyLockParams, type ModifyLockRequest, NETWORK_CONFIG, type Network, type NetworkConfig, NetworkError, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, type SignTransferLockedParams, type SignTransferParams, type SignWithdrawFromLockParams, type SignWithdrawParams, type SiweDomainResponse, type SiweLoginRequest, type SiweLoginResponse, type SiweNonceResponse, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, type TokenBalance, type TokenConfig, type TokenInfoResponse, type TokenListResponse, type TokensStatus, type TotalLockedBalanceResponse, type TransactionSubmissionResponse, type TransferFundsRequest, type TransferLockedFundsRequest, type TransferLockedMessage, type TransferLockedNonceResponse, type TransferLockedParams, type TransferMessage, type TransferNonceResponse, type TransferParams, type UnlockAllExpiredRequest, type UnlockFundsParams, type UnlockFundsRequest, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseExpiredLocksOptions, type UseExpiredLocksResult, type UseHistoryOptions, type UseHistoryResult, type UseHostedRedirectAuthResult, type UseLockFundsOptions, type UseLockFundsResult, type UseLockedFundsOptions, type UseLockedFundsResult, type UseModifyLockOptions, type UseModifyLockResult, type UsePendingWithdrawalsOptions, type UsePendingWithdrawalsResult, type UseTokenInfoOptions, type UseTokenInfoResult, type UseTokenListOptions, type UseTokenListResult, type UseTotalLockedBalanceOptions, type UseTotalLockedBalanceResult, type UseTransferOptions, type UseTransferResult, type UseUnlockFundsOptions, type UseUnlockFundsResult, type UseWithdrawOptions, type UseWithdrawResult, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, type WithdrawFromLockMessage, type WithdrawFromLockRequest, type WithdrawMessage, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
+export { AccountingApiError, type Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, type Bytes32, type ChainConfig, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, type HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, type HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, type IntegerLike, type JwtLogoutRequest, type JwtLogoutResponse, type JwtRefreshRequest, type JwtRefreshResponse, LOCK_TYPES, type LockFundsParams, type LockFundsRequest, type LockInfo, type LockMessage, type LockNonceResponse, type LockedFundsResponse, MODIFY_LOCK_TYPES, type MinDepositAmounts, type ModifyLockMessage, type ModifyLockNonceResponse, type ModifyLockParams, type ModifyLockRequest, NETWORK_CONFIG, type Network, type NetworkConfig, NetworkError, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, type SignTransferLockedParams, type SignTransferParams, type SignWithdrawFromLockParams, type SignWithdrawParams, type SiweAuthConfig, type SiweAuthContextValue, SiweAuthProvider, type SiweAuthProviderProps, type SiweAuthSession, type SiweAuthTokens, type SiweDomainResponse, type SiweLoginRequest, type SiweLoginResponse, type SiweNonceResponse, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, type TokenBalance, type TokenConfig, type TokenInfoResponse, type TokenListResponse, type TokensStatus, type TotalLockedBalanceResponse, type TransactionSubmissionResponse, type TransferFundsRequest, type TransferLockedFundsRequest, type TransferLockedMessage, type TransferLockedNonceResponse, type TransferLockedParams, type TransferMessage, type TransferNonceResponse, type TransferParams, type UnlockAllExpiredRequest, type UnlockFundsParams, type UnlockFundsRequest, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseExpiredLocksOptions, type UseExpiredLocksResult, type UseHistoryOptions, type UseHistoryResult, type UseHostedRedirectAuthResult, type UseLockFundsOptions, type UseLockFundsResult, type UseLockedFundsOptions, type UseLockedFundsResult, type UseModifyLockOptions, type UseModifyLockResult, type UsePendingWithdrawalsOptions, type UsePendingWithdrawalsResult, type UseTokenInfoOptions, type UseTokenInfoResult, type UseTokenListOptions, type UseTokenListResult, type UseTotalLockedBalanceOptions, type UseTotalLockedBalanceResult, type UseTransferOptions, type UseTransferResult, type UseUnlockFundsOptions, type UseUnlockFundsResult, type UseWithdrawOptions, type UseWithdrawResult, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, type WithdrawFromLockMessage, type WithdrawFromLockRequest, type WithdrawMessage, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };

package/dist/index.d.ts

@@ -663,6 +663,32 @@ interface SignWithdrawFromLockParams {
 }
 declare function signWithdrawFromLockMessage({ walletClient, chainId, verifyingContract, message, }: SignWithdrawFromLockParams): Promise<`0x${string}`>;
 
+type SiweAuthSession = {
+    address: Address;
+};
+type SiweAuthTokens = Pick<SiweLoginResponse, 'siwe_token' | 'jwt_access_token' | 'jwt_refresh_token' | 'address'>;
+interface SiweAuthContextValue {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    session: SiweAuthSession | null;
+    accessToken: string | undefined;
+    tokens: SiweAuthTokens | null;
+    login: () => Promise<void>;
+    logout: () => Promise<void>;
+}
+interface SiweAuthConfig {
+    autoLogin?: boolean;
+    statement?: string;
+}
+interface SiweAuthProviderProps extends SiweAuthConfig {
+    children: ReactNode;
+    client: PrivanaClient;
+    networkConfig: NetworkConfig;
+}
+declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, statement, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSiweAuth(): SiweAuthContextValue;
+
 type TokensStatus = 'loading' | 'ready' | 'error';
 interface PrivanaContextValue {
     client: PrivanaClient;
@@ -711,8 +737,16 @@ interface PrivanaProviderProps {
      * Optional hosted redirect auth configuration for cross-domain browser apps.
      */
     hostedAuth?: HostedAuthConfig;
+    /**
+     * Optional direct (in-app) SIWE auth. When provided, the connected wallet
+     * signs an EIP-4361 message in-app and `useSiweAuth()` becomes available.
+     * Mutually exclusive with `hostedAuth`: providing both throws, because
+     * `usePrivateReadRequest()` prefers `hostedAuthConfig` and would otherwise
+     * ignore the SIWE login.
+     */
+    siweAuth?: SiweAuthConfig;
 }
-declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
+declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePrivanaContext(): PrivanaContextValue;
 declare function useSafePrivanaContext(): PrivanaContextValue | null;
 
@@ -963,9 +997,11 @@ interface UseHistoryResult {
 }
 declare function useHistory(options?: UseHistoryOptions): UseHistoryResult;
 
+type AccountStatus = 'connecting' | 'reconnecting' | 'connected' | 'disconnected';
 interface SafeAccountResult {
     address: Address$1 | undefined;
     isConnected: boolean;
+    status: AccountStatus;
 }
 declare function useSafeAccount(): SafeAccountResult;
 
@@ -1057,4 +1093,4 @@ declare function Skeleton({ className, ...props }: React.ComponentProps<'div'>):
 declare function getTokenIcon(symbol: string, size?: number): react_jsx_runtime.JSX.Element;
 declare function getChainIcon(chainId: number, size?: number): react_jsx_runtime.JSX.Element;
 
-export { AccountingApiError, type Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, type Bytes32, type ChainConfig, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, type HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, type HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, type IntegerLike, type JwtLogoutRequest, type JwtLogoutResponse, type JwtRefreshRequest, type JwtRefreshResponse, LOCK_TYPES, type LockFundsParams, type LockFundsRequest, type LockInfo, type LockMessage, type LockNonceResponse, type LockedFundsResponse, MODIFY_LOCK_TYPES, type MinDepositAmounts, type ModifyLockMessage, type ModifyLockNonceResponse, type ModifyLockParams, type ModifyLockRequest, NETWORK_CONFIG, type Network, type NetworkConfig, NetworkError, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, type SignTransferLockedParams, type SignTransferParams, type SignWithdrawFromLockParams, type SignWithdrawParams, type SiweDomainResponse, type SiweLoginRequest, type SiweLoginResponse, type SiweNonceResponse, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, type TokenBalance, type TokenConfig, type TokenInfoResponse, type TokenListResponse, type TokensStatus, type TotalLockedBalanceResponse, type TransactionSubmissionResponse, type TransferFundsRequest, type TransferLockedFundsRequest, type TransferLockedMessage, type TransferLockedNonceResponse, type TransferLockedParams, type TransferMessage, type TransferNonceResponse, type TransferParams, type UnlockAllExpiredRequest, type UnlockFundsParams, type UnlockFundsRequest, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseExpiredLocksOptions, type UseExpiredLocksResult, type UseHistoryOptions, type UseHistoryResult, type UseHostedRedirectAuthResult, type UseLockFundsOptions, type UseLockFundsResult, type UseLockedFundsOptions, type UseLockedFundsResult, type UseModifyLockOptions, type UseModifyLockResult, type UsePendingWithdrawalsOptions, type UsePendingWithdrawalsResult, type UseTokenInfoOptions, type UseTokenInfoResult, type UseTokenListOptions, type UseTokenListResult, type UseTotalLockedBalanceOptions, type UseTotalLockedBalanceResult, type UseTransferOptions, type UseTransferResult, type UseUnlockFundsOptions, type UseUnlockFundsResult, type UseWithdrawOptions, type UseWithdrawResult, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, type WithdrawFromLockMessage, type WithdrawFromLockRequest, type WithdrawMessage, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
+export { AccountingApiError, type Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, type Bytes32, type ChainConfig, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, type HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, type HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, type IntegerLike, type JwtLogoutRequest, type JwtLogoutResponse, type JwtRefreshRequest, type JwtRefreshResponse, LOCK_TYPES, type LockFundsParams, type LockFundsRequest, type LockInfo, type LockMessage, type LockNonceResponse, type LockedFundsResponse, MODIFY_LOCK_TYPES, type MinDepositAmounts, type ModifyLockMessage, type ModifyLockNonceResponse, type ModifyLockParams, type ModifyLockRequest, NETWORK_CONFIG, type Network, type NetworkConfig, NetworkError, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, type SignTransferLockedParams, type SignTransferParams, type SignWithdrawFromLockParams, type SignWithdrawParams, type SiweAuthConfig, type SiweAuthContextValue, SiweAuthProvider, type SiweAuthProviderProps, type SiweAuthSession, type SiweAuthTokens, type SiweDomainResponse, type SiweLoginRequest, type SiweLoginResponse, type SiweNonceResponse, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, type TokenBalance, type TokenConfig, type TokenInfoResponse, type TokenListResponse, type TokensStatus, type TotalLockedBalanceResponse, type TransactionSubmissionResponse, type TransferFundsRequest, type TransferLockedFundsRequest, type TransferLockedMessage, type TransferLockedNonceResponse, type TransferLockedParams, type TransferMessage, type TransferNonceResponse, type TransferParams, type UnlockAllExpiredRequest, type UnlockFundsParams, type UnlockFundsRequest, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseExpiredLocksOptions, type UseExpiredLocksResult, type UseHistoryOptions, type UseHistoryResult, type UseHostedRedirectAuthResult, type UseLockFundsOptions, type UseLockFundsResult, type UseLockedFundsOptions, type UseLockedFundsResult, type UseModifyLockOptions, type UseModifyLockResult, type UsePendingWithdrawalsOptions, type UsePendingWithdrawalsResult, type UseTokenInfoOptions, type UseTokenInfoResult, type UseTokenListOptions, type UseTokenListResult, type UseTotalLockedBalanceOptions, type UseTotalLockedBalanceResult, type UseTransferOptions, type UseTransferResult, type UseUnlockFundsOptions, type UseUnlockFundsResult, type UseWithdrawOptions, type UseWithdrawResult, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, type WithdrawFromLockMessage, type WithdrawFromLockRequest, type WithdrawMessage, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };

package/dist/index.js

@@ -1,13 +1,13 @@
 "use client";
-import { createContext, useMemo, useState, useEffect, useRef, useCallback, useContext, useSyncExternalStore, useId } from 'react';
+import { createContext, useContext, useRef, useCallback, useSyncExternalStore, useState, useEffect, useMemo, useId } from 'react';
 import { zeroAddress, erc20Abi, hexToString } from 'viem';
+import { createSiweMessage } from 'viem/siwe';
+import { WagmiContext, useAccount, useWalletClient, useConfig, useWriteContract, useSendTransaction, useChainId, useSwitchChain, useBalance as useBalance$1, useReadContract } from 'wagmi';
+import { watchAccount, getAccount, getWalletClient } from 'wagmi/actions';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { QueryClientContext, useQuery, useQueryClient, useMutation, keepPreviousData } from '@tanstack/react-query';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
-import { createSiweMessage } from 'viem/siwe';
-import { WagmiContext, useAccount, useWalletClient, useConfig, useWriteContract, useSendTransaction, useChainId, useSwitchChain, useBalance as useBalance$1, useReadContract } from 'wagmi';
-import { watchAccount, getAccount, getWalletClient } from 'wagmi/actions';
 import { getTransactionReceipt as getTransactionReceipt$1, waitForTransactionReceipt as waitForTransactionReceipt$1, getTransaction, call } from 'viem/actions';
 import { Slot } from '@radix-ui/react-slot';
 import { cva } from 'class-variance-authority';
@@ -769,6 +769,235 @@ async function signWithdrawFromLockMessage({
   });
   return signature;
 }
+var defaultResult = {
+  address: void 0,
+  isConnected: false,
+  status: "disconnected"
+};
+function useSafeAccount() {
+  const context = useContext(WagmiContext);
+  const cacheRef = useRef(defaultResult);
+  const subscribe = useCallback(
+    (onChange) => {
+      if (!context) return () => {
+      };
+      return watchAccount(context, { onChange });
+    },
+    [context]
+  );
+  const getSnapshot = useCallback(() => {
+    if (!context) return defaultResult;
+    const account = getAccount(context);
+    if (cacheRef.current.address !== account.address || cacheRef.current.isConnected !== account.isConnected || cacheRef.current.status !== account.status) {
+      cacheRef.current = {
+        address: account.address,
+        isConnected: account.isConnected,
+        status: account.status
+      };
+    }
+    return cacheRef.current;
+  }, [context]);
+  const getServerSnapshot = useCallback(() => defaultResult, []);
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+
+// src/sdk/hooks/private-read-token-store.ts
+var AUTH_CLOCK_SKEW_MS = 3e4;
+var cache = /* @__PURE__ */ new Map();
+function createScopeKey(apiUrl, chainId, address) {
+  return `${apiUrl.replace(/\/$/, "")}:${chainId}:${address.toLowerCase()}`;
+}
+function getCachedPrivateReadToken(scopeKey) {
+  const cached = cache.get(scopeKey);
+  if (!cached) return null;
+  if (cached.expiresAt <= Date.now() + AUTH_CLOCK_SKEW_MS) {
+    cache.delete(scopeKey);
+    return null;
+  }
+  return cached.token;
+}
+function setCachedPrivateReadToken(scopeKey, token, expiresAt) {
+  cache.set(scopeKey, { token, expiresAt });
+}
+function deleteCachedPrivateReadToken(scopeKey) {
+  cache.delete(scopeKey);
+}
+var DEFAULT_SIWE_VALIDITY_MS = 24 * 60 * 60 * 1e3;
+var DEFAULT_STATEMENT = "Sign in to access your private account data.";
+var AUTH_REFRESH_SKEW_MS = 3e4;
+var SiweAuthContext = createContext(null);
+function SiweAuthProvider({
+  children,
+  client,
+  networkConfig,
+  autoLogin = true,
+  statement
+}) {
+  const wagmiContext = useContext(WagmiContext);
+  const { address, isConnected, status } = useSafeAccount();
+  const [session, setSession] = useState(null);
+  const [tokens, setTokens] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [accessTokenExpiresAt, setAccessTokenExpiresAt] = useState(null);
+  const loginInFlight = useRef(false);
+  const autoAttemptedAddress = useRef(null);
+  const refreshInFlight = useRef(false);
+  const refreshDataRef = useRef(null);
+  const clearSession = useCallback(() => {
+    refreshDataRef.current = null;
+    setAccessTokenExpiresAt(null);
+    client.clearPrivateReadToken();
+    client.clearBearerToken();
+    setSession(null);
+    setTokens(null);
+    setError(null);
+    autoAttemptedAddress.current = null;
+  }, [client]);
+  const logout = useCallback(async () => {
+    setError(null);
+    const refreshToken = refreshDataRef.current?.refreshToken;
+    try {
+      if (refreshToken) {
+        await client.logoutJwtSession({ refresh_token: refreshToken });
+      }
+    } finally {
+      clearSession();
+      autoAttemptedAddress.current = address ?? null;
+    }
+  }, [clearSession, client, address]);
+  const login = useCallback(async () => {
+    if (!wagmiContext) throw new Error("WagmiProvider is required for SIWE auth");
+    if (!address) throw new Error("No wallet connected");
+    if (loginInFlight.current) return;
+    loginInFlight.current = true;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const walletClient = await getWalletClient(wagmiContext);
+      if (!walletClient) throw new Error("No wallet client available");
+      const [{ domain }, nonceRes] = await Promise.all([
+        client.getSiweDomain(),
+        client.getSiweNonce(address)
+      ]);
+      const issuedAt = /* @__PURE__ */ new Date();
+      const expirationTime = new Date(issuedAt.getTime() + DEFAULT_SIWE_VALIDITY_MS);
+      const uri = typeof window !== "undefined" && window.location.origin ? window.location.origin : networkConfig.apiUrl;
+      const message = createSiweMessage({
+        address,
+        chainId: networkConfig.chainId,
+        domain,
+        uri,
+        version: "1",
+        nonce: nonceRes.nonce,
+        statement: statement ?? DEFAULT_STATEMENT,
+        issuedAt,
+        expirationTime
+      });
+      const signature = await walletClient.signMessage({
+        account: walletClient.account ?? address,
+        message
+      });
+      const res = await client.loginWithSiwe({ siwe_message: message, signature });
+      const loggedInAt = Date.now();
+      client.setPrivateReadToken(res.siwe_token);
+      client.setBearerToken(res.jwt_access_token);
+      refreshDataRef.current = {
+        refreshToken: res.jwt_refresh_token,
+        refreshExpiresAt: loggedInAt + res.jwt_refresh_expires_in * 1e3
+      };
+      setCachedPrivateReadToken(
+        createScopeKey(networkConfig.apiUrl, networkConfig.chainId, address),
+        res.siwe_token,
+        expirationTime.getTime()
+      );
+      setSession({ address: res.address });
+      setTokens({
+        siwe_token: res.siwe_token,
+        jwt_access_token: res.jwt_access_token,
+        jwt_refresh_token: res.jwt_refresh_token,
+        address: res.address
+      });
+      setAccessTokenExpiresAt(loggedInAt + res.jwt_expires_in * 1e3);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Sign-in failed"));
+      throw err;
+    } finally {
+      setIsLoading(false);
+      loginInFlight.current = false;
+    }
+  }, [wagmiContext, address, client, networkConfig.chainId, networkConfig.apiUrl, statement]);
+  const refreshAccessToken = useCallback(async () => {
+    const data = refreshDataRef.current;
+    if (!data || refreshInFlight.current) return;
+    if (Date.now() >= data.refreshExpiresAt - AUTH_REFRESH_SKEW_MS) {
+      clearSession();
+      return;
+    }
+    refreshInFlight.current = true;
+    try {
+      const res = await client.refreshJwtSession({ refresh_token: data.refreshToken });
+      const refreshedAt = Date.now();
+      client.setBearerToken(res.token);
+      refreshDataRef.current = {
+        refreshToken: res.refresh_token,
+        refreshExpiresAt: refreshedAt + res.refresh_expires_in * 1e3
+      };
+      setTokens(
+        (prev) => prev ? { ...prev, jwt_access_token: res.token, jwt_refresh_token: res.refresh_token } : prev
+      );
+      setAccessTokenExpiresAt(refreshedAt + res.expires_in * 1e3);
+    } catch {
+      clearSession();
+    } finally {
+      refreshInFlight.current = false;
+    }
+  }, [client, clearSession]);
+  useEffect(() => {
+    if (accessTokenExpiresAt == null) return;
+    const delay = Math.max(accessTokenExpiresAt - AUTH_REFRESH_SKEW_MS - Date.now(), 0);
+    const timer = setTimeout(() => {
+      void refreshAccessToken();
+    }, delay);
+    return () => clearTimeout(timer);
+  }, [accessTokenExpiresAt, refreshAccessToken]);
+  useEffect(() => {
+    if (!autoLogin) return;
+    if (status === "connecting" || status === "reconnecting") return;
+    if (!isConnected && session) {
+      clearSession();
+      return;
+    }
+    if (isConnected && address && session && address.toLowerCase() !== session.address.toLowerCase()) {
+      clearSession();
+      return;
+    }
+    if (isConnected && address && !session && !isLoading && autoAttemptedAddress.current !== address) {
+      autoAttemptedAddress.current = address;
+      void login().catch(() => {
+      });
+    }
+  }, [autoLogin, status, isConnected, address, session, isLoading, login, clearSession]);
+  const value = useMemo(
+    () => ({
+      isAuthenticated: !!session,
+      isLoading,
+      error,
+      session,
+      accessToken: tokens?.jwt_access_token,
+      tokens,
+      login,
+      logout
+    }),
+    [session, isLoading, error, tokens, login, logout]
+  );
+  return /* @__PURE__ */ jsx(SiweAuthContext.Provider, { value, children });
+}
+function useSiweAuth() {
+  const ctx = useContext(SiweAuthContext);
+  if (!ctx) throw new Error("useSiweAuth must be used within SiweAuthProvider");
+  return ctx;
+}
 var PrivanaContext = createContext(null);
 function readStoredHostedAuthSession(storage, hostedAuthStorageKey, now = Date.now()) {
   const raw = storage.getItem(hostedAuthStorageKey);
@@ -809,8 +1038,14 @@ function PrivanaProvider({
   chains,
   pollingInterval = 1e4,
   serviceAddress,
-  hostedAuth
+  hostedAuth,
+  siweAuth
 }) {
+  if (hostedAuth && siweAuth) {
+    throw new Error(
+      "PrivanaProvider: `hostedAuth` and `siweAuth` are mutually exclusive - provide only one. When both are set, private reads use hosted auth and the in-app SIWE login is ignored."
+    );
+  }
   const networkConfig = useMemo(() => {
     const config = {
       ...DEFAULT_NETWORK_CONFIG,
@@ -1045,7 +1280,16 @@ function PrivanaProvider({
       refreshHostedAuthSession
     ]
   );
-  return /* @__PURE__ */ jsx(PrivanaContext.Provider, { value, children });
+  return /* @__PURE__ */ jsx(PrivanaContext.Provider, { value, children: siweAuth ? /* @__PURE__ */ jsx(
+    SiweAuthProvider,
+    {
+      client,
+      networkConfig,
+      autoLogin: siweAuth.autoLogin,
+      statement: siweAuth.statement,
+      children
+    }
+  ) : children });
 }
 function usePrivanaContext() {
   const context = useContext(PrivanaContext);
@@ -1305,40 +1549,10 @@ function formatTimeRemaining(expiryTimestamp) {
   }
   return `${minutes}m left`;
 }
-var defaultResult = {
-  address: void 0,
-  isConnected: false
-};
-function useSafeAccount() {
-  const context = useContext(WagmiContext);
-  const cacheRef = useRef(defaultResult);
-  const subscribe = useCallback(
-    (onChange) => {
-      if (!context) return () => {
-      };
-      return watchAccount(context, { onChange });
-    },
-    [context]
-  );
-  const getSnapshot = useCallback(() => {
-    if (!context) return defaultResult;
-    const account = getAccount(context);
-    if (cacheRef.current.address !== account.address || cacheRef.current.isConnected !== account.isConnected) {
-      cacheRef.current = { address: account.address, isConnected: account.isConnected };
-    }
-    return cacheRef.current;
-  }, [context]);
-  const getServerSnapshot = useCallback(() => defaultResult, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
-}
-
-// src/sdk/hooks/use-private-read-request.ts
-var AUTH_CLOCK_SKEW_MS = 3e4;
 var INITIAL_AUTH_BACKOFF_MS = 5e3;
 var MAX_AUTH_BACKOFF_MS = 6e4;
 var DEFAULT_SIWE_AUTH_VALIDITY_MS = 24 * 60 * 60 * 1e3;
 var PRIVATE_READ_STATEMENT = "Sign in to Privana to access private account data.";
-var privateReadTokenCache = /* @__PURE__ */ new Map();
 var privateReadFailureCache = /* @__PURE__ */ new Map();
 var privateReadInflight = /* @__PURE__ */ new Map();
 async function executeHostedAuthPrivateReadRequest({
@@ -1372,20 +1586,8 @@ async function executeHostedAuthPrivateReadRequest({
     return request();
   }
 }
-function createScopeKey(apiUrl, deploymentChainId, address) {
-  return `${apiUrl.replace(/\/$/, "")}:${deploymentChainId}:${address.toLowerCase()}`;
-}
-function getCachedPrivateReadToken(scopeKey) {
-  const cached = privateReadTokenCache.get(scopeKey);
-  if (!cached) return null;
-  if (cached.expiresAt <= Date.now() + AUTH_CLOCK_SKEW_MS) {
-    privateReadTokenCache.delete(scopeKey);
-    return null;
-  }
-  return cached.token;
-}
 function clearPrivateReadScope(scopeKey, client) {
-  privateReadTokenCache.delete(scopeKey);
+  deleteCachedPrivateReadToken(scopeKey);
   privateReadFailureCache.delete(scopeKey);
   client.clearPrivateReadToken();
 }
@@ -1484,10 +1686,7 @@ function usePrivateReadRequest() {
               siwe_message: message,
               signature
             });
-            privateReadTokenCache.set(scopeKey, {
-              token: login.siwe_token,
-              expiresAt: expirationTime.getTime()
-            });
+            setCachedPrivateReadToken(scopeKey, login.siwe_token, expirationTime.getTime());
             privateReadFailureCache.delete(scopeKey);
             client.setPrivateReadToken(login.siwe_token);
             return login.siwe_token;
@@ -4437,6 +4636,6 @@ function Skeleton({ className, ...props }) {
   );
 }
 
-export { AccountingApiError, Button, HOSTED_AUTH_CLOCK_SKEW_MS, HostedAuthError, HostedAuthRequiredError, HostedAuthStateMismatchError, HttpClient, LOCK_TYPES, MODIFY_LOCK_TYPES, NETWORK_CONFIG, NetworkError, PrivanaButton, PrivanaClient, PrivanaInlineModal, PrivanaModal, PrivanaProvider, SUPPORTED_CHAINS, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
+export { AccountingApiError, Button, HOSTED_AUTH_CLOCK_SKEW_MS, HostedAuthError, HostedAuthRequiredError, HostedAuthStateMismatchError, HttpClient, LOCK_TYPES, MODIFY_LOCK_TYPES, NETWORK_CONFIG, NetworkError, PrivanaButton, PrivanaClient, PrivanaInlineModal, PrivanaModal, PrivanaProvider, SUPPORTED_CHAINS, SiweAuthProvider, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, ValidationError, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, applyRefreshResponse, buildHostedAuthSession, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getAccountingContract, getApiUrl, getChainById, getChainIcon, getChainId, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, normalizeAddress, normalizeHex, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map