@oasisprotocol/privana-sdk 0.4.3 → 0.5.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as Address, B as Bytes32, H as HexString, I as IntegerLike, a as HostedAuthResponseMode, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse, P as PendingOnRampsResponse, N as NetworkConfig, T as TokenConfig } from './on-ramp-CdXqJjmm.cjs';
-export { e as NETWORK_CONFIG, f as Network, O as OnRampRecord, g as OnRampStatus, h as getAccountingContract, i as getApiUrl, j as getChainId, n as normalizeAddress, k as normalizeHex } from './on-ramp-CdXqJjmm.cjs';
+import { A as Address, B as Bytes32, H as HexString, I as IntegerLike, a as HostedAuthResponseMode, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse, P as PendingOnRampsResponse, N as NetworkConfig, T as TokenConfig } from './on-ramp-XLXsy0aI.cjs';
+export { e as NETWORK_CONFIG, f as Network, O as OnRampRecord, g as OnRampStatus, h as getAccountingContract, i as getApiUrl, j as getChainId, n as normalizeAddress, k as normalizeHex } from './on-ramp-XLXsy0aI.cjs';
 import { WalletClient, Address as Address$1 } from 'viem';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
@@ -7,6 +7,32 @@ import { ReactNode, ComponentProps, ReactElement } from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
+interface AllowanceTerm {
+    title: string;
+    description: string;
+}
+interface Allowance {
+    /**
+     * Hard cap the service is allowed to lock (`maxAmount`), in the token's base units.
+     * Signed into the deposit-lock authorization.
+     */
+    value: string;
+    /**
+     * Minimum amount the delivered deposit must reach for the lock to be created
+     * (`minAmount`), in the token's base units. Defaults to `0` when omitted.
+     */
+    minAmount?: string;
+    /**
+     * Lock lifetime in seconds. The accounting module adds this to `block.timestamp`
+     * to derive the lock expiry. Defaults to the SDK default (3600) when omitted.
+     */
+    lockDuration?: number;
+    terms?: {
+        permissions?: AllowanceTerm[];
+        restrictions?: AllowanceTerm[];
+    };
+}
+
 interface HostedAuthConfig {
     clientId: string;
     redirectUri: string;
@@ -41,9 +67,11 @@ interface ChainConfig {
     id: number;
     name: string;
     explorerUrl: string;
+    explorerName: string;
 }
 declare const SUPPORTED_CHAINS: ChainConfig[];
 declare function getChainById(chainId: number): ChainConfig | undefined;
+declare function getExplorerLabel(chainId: number): string;
 declare function getExplorerAddressUrl(chainId: number, address: string): string | undefined;
 
 interface DepositAddressRequest {
@@ -324,6 +352,8 @@ declare function applyRefreshResponse(session: HostedAuthSession, response: JwtR
 declare function isHostedAuthSessionActive(session: HostedAuthSession, now?: number, skewMs?: number): boolean;
 declare function isHostedAuthRefreshActive(session: HostedAuthSession, now?: number, skewMs?: number): boolean;
 
+declare function buildSiweStatement(chainId: number): string;
+
 interface HttpClientConfig {
     baseUrl: string;
     timeout?: number;
@@ -624,16 +654,16 @@ interface SiweAuthContextValue {
     login: () => Promise<void>;
     logout: () => Promise<void>;
 }
-interface SiweAuthConfig {
+type SiweAuthConfig = boolean | {
     autoLogin?: boolean;
-    statement?: string;
-}
-interface SiweAuthProviderProps extends SiweAuthConfig {
+};
+interface SiweAuthProviderProps {
     children: ReactNode;
     client: PrivanaClient;
     networkConfig: NetworkConfig;
+    autoLogin?: boolean;
 }
-declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, statement, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
 declare function useSiweAuth(): SiweAuthContextValue;
 
 type TokensStatus = 'loading' | 'ready' | 'error';
@@ -649,6 +679,8 @@ interface PrivanaContextValue {
     tokensError?: Error;
     pollingInterval: number;
     serviceAddress?: Address;
+    serviceName?: string;
+    serviceIcon?: ReactNode;
     hostedAuthConfig: HostedAuthConfig | null;
     hostedAuthSession: HostedAuthSession | null;
     setHostedAuthSession: (session: HostedAuthSession | null) => void;
@@ -680,6 +712,15 @@ interface PrivanaProviderProps {
      * The service address for lock operations.
      */
     serviceAddress?: Address;
+    /**
+     * Display name of the host application/service. Shown as the title in
+     * Privana modals (e.g. the deposit modal header). Defaults to "Privana".
+     */
+    serviceName?: string;
+    /**
+     * Optional icon/logo for the host application/service.
+     */
+    serviceIcon?: ReactNode;
     /**
      * Optional hosted redirect auth configuration for cross-domain browser apps.
      */
@@ -693,7 +734,7 @@ interface PrivanaProviderProps {
      */
     siweAuth?: SiweAuthConfig;
 }
-declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
+declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, serviceName, serviceIcon, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePrivanaContext(): PrivanaContextValue;
 declare function useSafePrivanaContext(): PrivanaContextValue | null;
 
@@ -787,6 +828,25 @@ interface UseDepositResult {
 }
 declare function useDeposit(options?: UseDepositOptions): UseDepositResult;
 
+interface UseDepositAddressOptions {
+    enabled?: boolean;
+}
+interface UseDepositAddressResult {
+    depositAddress: string | null;
+    isReady: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Fetches the user's Privana deposit address via the SIWE private-read flow
+ * (`POST /v1/accounting/deposits/address`) — the same authenticated path used
+ * by `useFiatOnRamp`. Used by the external-wallet deposit view to show a QR
+ * code / copyable address to send funds to.
+ */
+declare function useDepositAddress(options?: UseDepositAddressOptions): UseDepositAddressResult;
+
 interface VerificationContext {
     /** On-chain transfer that funded the user's Privana deposit address. */
     hash: `0x${string}`;
@@ -1096,9 +1156,77 @@ declare function PrivanaInlineModal({ className, showLockedFunds, defaultTab, on
     onDepositSuccess?: () => void;
 }): react_jsx_runtime.JSX.Element;
 
+type DepositMethodTab = 'crypto' | 'credit-card';
+type DepositSource = 'connected' | 'external' | 'credit-card';
+interface DepositMethodHandlers {
+    defaultTab?: DepositMethodTab;
+    /** Allowance (shown as a "policy") the host service requests. */
+    allowance?: Allowance;
+    onSelectConnectedWallet?: () => void;
+    onSelectExternalWallet?: () => void;
+    onSelectCreditCard?: () => void;
+    onConnectWallet?: () => void;
+    /** Called when the user confirms the amount on the deposit view. */
+    onDeposit?: (args: {
+        source: DepositSource;
+        tokenId: string;
+        amount: string;
+    }) => void;
+    onDepositSuccess?: () => void;
+}
+interface DepositModalProps extends DepositMethodHandlers {
+    open: boolean;
+    onClose: () => void;
+}
+declare function DepositModal({ open, onClose, ...handlers }: DepositModalProps): react_jsx_runtime.JSX.Element;
+interface DepositInlineModalProps extends DepositMethodHandlers {
+    className?: string;
+}
+declare function DepositInlineModal({ className, ...handlers }: DepositInlineModalProps): react_jsx_runtime.JSX.Element;
+
+interface WithdrawModalProps {
+    open: boolean;
+    onClose: () => void;
+}
+declare function WithdrawModal({ open, onClose }: WithdrawModalProps): react_jsx_runtime.JSX.Element;
+interface WithdrawInlineModalProps {
+    className?: string;
+}
+declare function WithdrawInlineModal({ className }: WithdrawInlineModalProps): react_jsx_runtime.JSX.Element;
+
+interface WalletSession {
+    /** Funds committed to the active session, in the display token's base units. */
+    inUse: string | bigint;
+    /** Unix timestamp (seconds) when the session lock expires; shows the countdown. */
+    expiry?: number;
+}
+interface WalletModalHandlers extends DepositMethodHandlers {
+    session?: WalletSession;
+    onPlay?: (args: {
+        tokenId: string;
+        amount: string;
+    }) => void;
+    onEndSession?: () => Promise<void>;
+}
+interface WalletModalProps extends WalletModalHandlers {
+    open: boolean;
+    onClose: () => void;
+}
+declare function WalletModal({ open, onClose, ...handlers }: WalletModalProps): react_jsx_runtime.JSX.Element;
+interface WalletInlineModalProps extends WalletModalHandlers {
+    className?: string;
+}
+declare function WalletInlineModal({ className, ...handlers }: WalletInlineModalProps): react_jsx_runtime.JSX.Element;
+
 declare function Skeleton({ className, ...props }: React.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 
 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, Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, Bytes32, type ChainConfig, CreateOnRampIntentRequest, CreateOnRampIntentResponse, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, 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, NetworkConfig, NetworkError, PendingOnRampsResponse, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, SignOnRampUrlRequest, SignOnRampUrlResponse, 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, 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, UpdateOnRampRequest, UpdateOnRampResponse, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseDepositVerificationOptions, type UseDepositVerificationResult, 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, type VerificationContext, 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, getChainById, getChainIcon, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useDepositVerification, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
+interface PrivanaIconProps {
+    className?: string;
+    size?: number;
+}
+declare function PrivanaIcon({ className, size }: PrivanaIconProps): react_jsx_runtime.JSX.Element;
+
+export { AccountingApiError, Address, type Allowance, type AllowanceTerm, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, Bytes32, type ChainConfig, CreateOnRampIntentRequest, CreateOnRampIntentResponse, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, DepositInlineModal, type DepositInlineModalProps, type DepositMethodHandlers, DepositModal, type DepositModalProps, type DepositParams, type DepositSource, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, 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, NetworkConfig, NetworkError, PendingOnRampsResponse, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaIcon, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, SignOnRampUrlRequest, SignOnRampUrlResponse, 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, 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, UpdateOnRampRequest, UpdateOnRampResponse, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositAddressOptions, type UseDepositAddressResult, type UseDepositOptions, type UseDepositResult, type UseDepositVerificationOptions, type UseDepositVerificationResult, 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, type VerificationContext, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, WalletInlineModal, type WalletInlineModalProps, WalletModal, type WalletModalHandlers, type WalletModalProps, type WalletSession, type WithdrawFromLockMessage, type WithdrawFromLockRequest, WithdrawInlineModal, type WithdrawInlineModalProps, type WithdrawMessage, WithdrawModal, type WithdrawModalProps, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buildSiweStatement, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getChainById, getChainIcon, getExplorerAddressUrl, getExplorerLabel, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useDepositAddress, useDepositVerification, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as Address, B as Bytes32, H as HexString, I as IntegerLike, a as HostedAuthResponseMode, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse, P as PendingOnRampsResponse, N as NetworkConfig, T as TokenConfig } from './on-ramp-CdXqJjmm.js';
-export { e as NETWORK_CONFIG, f as Network, O as OnRampRecord, g as OnRampStatus, h as getAccountingContract, i as getApiUrl, j as getChainId, n as normalizeAddress, k as normalizeHex } from './on-ramp-CdXqJjmm.js';
+import { A as Address, B as Bytes32, H as HexString, I as IntegerLike, a as HostedAuthResponseMode, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse, P as PendingOnRampsResponse, N as NetworkConfig, T as TokenConfig } from './on-ramp-XLXsy0aI.js';
+export { e as NETWORK_CONFIG, f as Network, O as OnRampRecord, g as OnRampStatus, h as getAccountingContract, i as getApiUrl, j as getChainId, n as normalizeAddress, k as normalizeHex } from './on-ramp-XLXsy0aI.js';
 import { WalletClient, Address as Address$1 } from 'viem';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
@@ -7,6 +7,32 @@ import { ReactNode, ComponentProps, ReactElement } from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
+interface AllowanceTerm {
+    title: string;
+    description: string;
+}
+interface Allowance {
+    /**
+     * Hard cap the service is allowed to lock (`maxAmount`), in the token's base units.
+     * Signed into the deposit-lock authorization.
+     */
+    value: string;
+    /**
+     * Minimum amount the delivered deposit must reach for the lock to be created
+     * (`minAmount`), in the token's base units. Defaults to `0` when omitted.
+     */
+    minAmount?: string;
+    /**
+     * Lock lifetime in seconds. The accounting module adds this to `block.timestamp`
+     * to derive the lock expiry. Defaults to the SDK default (3600) when omitted.
+     */
+    lockDuration?: number;
+    terms?: {
+        permissions?: AllowanceTerm[];
+        restrictions?: AllowanceTerm[];
+    };
+}
+
 interface HostedAuthConfig {
     clientId: string;
     redirectUri: string;
@@ -41,9 +67,11 @@ interface ChainConfig {
     id: number;
     name: string;
     explorerUrl: string;
+    explorerName: string;
 }
 declare const SUPPORTED_CHAINS: ChainConfig[];
 declare function getChainById(chainId: number): ChainConfig | undefined;
+declare function getExplorerLabel(chainId: number): string;
 declare function getExplorerAddressUrl(chainId: number, address: string): string | undefined;
 
 interface DepositAddressRequest {
@@ -324,6 +352,8 @@ declare function applyRefreshResponse(session: HostedAuthSession, response: JwtR
 declare function isHostedAuthSessionActive(session: HostedAuthSession, now?: number, skewMs?: number): boolean;
 declare function isHostedAuthRefreshActive(session: HostedAuthSession, now?: number, skewMs?: number): boolean;
 
+declare function buildSiweStatement(chainId: number): string;
+
 interface HttpClientConfig {
     baseUrl: string;
     timeout?: number;
@@ -624,16 +654,16 @@ interface SiweAuthContextValue {
     login: () => Promise<void>;
     logout: () => Promise<void>;
 }
-interface SiweAuthConfig {
+type SiweAuthConfig = boolean | {
     autoLogin?: boolean;
-    statement?: string;
-}
-interface SiweAuthProviderProps extends SiweAuthConfig {
+};
+interface SiweAuthProviderProps {
     children: ReactNode;
     client: PrivanaClient;
     networkConfig: NetworkConfig;
+    autoLogin?: boolean;
 }
-declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, statement, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function SiweAuthProvider({ children, client, networkConfig, autoLogin, }: SiweAuthProviderProps): react_jsx_runtime.JSX.Element;
 declare function useSiweAuth(): SiweAuthContextValue;
 
 type TokensStatus = 'loading' | 'ready' | 'error';
@@ -649,6 +679,8 @@ interface PrivanaContextValue {
     tokensError?: Error;
     pollingInterval: number;
     serviceAddress?: Address;
+    serviceName?: string;
+    serviceIcon?: ReactNode;
     hostedAuthConfig: HostedAuthConfig | null;
     hostedAuthSession: HostedAuthSession | null;
     setHostedAuthSession: (session: HostedAuthSession | null) => void;
@@ -680,6 +712,15 @@ interface PrivanaProviderProps {
      * The service address for lock operations.
      */
     serviceAddress?: Address;
+    /**
+     * Display name of the host application/service. Shown as the title in
+     * Privana modals (e.g. the deposit modal header). Defaults to "Privana".
+     */
+    serviceName?: string;
+    /**
+     * Optional icon/logo for the host application/service.
+     */
+    serviceIcon?: ReactNode;
     /**
      * Optional hosted redirect auth configuration for cross-domain browser apps.
      */
@@ -693,7 +734,7 @@ interface PrivanaProviderProps {
      */
     siweAuth?: SiweAuthConfig;
 }
-declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
+declare function PrivanaProvider({ children, networkConfig: networkConfigOverride, tokens, chains, pollingInterval, serviceAddress, serviceName, serviceIcon, hostedAuth, siweAuth, }: PrivanaProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePrivanaContext(): PrivanaContextValue;
 declare function useSafePrivanaContext(): PrivanaContextValue | null;
 
@@ -787,6 +828,25 @@ interface UseDepositResult {
 }
 declare function useDeposit(options?: UseDepositOptions): UseDepositResult;
 
+interface UseDepositAddressOptions {
+    enabled?: boolean;
+}
+interface UseDepositAddressResult {
+    depositAddress: string | null;
+    isReady: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Fetches the user's Privana deposit address via the SIWE private-read flow
+ * (`POST /v1/accounting/deposits/address`) — the same authenticated path used
+ * by `useFiatOnRamp`. Used by the external-wallet deposit view to show a QR
+ * code / copyable address to send funds to.
+ */
+declare function useDepositAddress(options?: UseDepositAddressOptions): UseDepositAddressResult;
+
 interface VerificationContext {
     /** On-chain transfer that funded the user's Privana deposit address. */
     hash: `0x${string}`;
@@ -1096,9 +1156,77 @@ declare function PrivanaInlineModal({ className, showLockedFunds, defaultTab, on
     onDepositSuccess?: () => void;
 }): react_jsx_runtime.JSX.Element;
 
+type DepositMethodTab = 'crypto' | 'credit-card';
+type DepositSource = 'connected' | 'external' | 'credit-card';
+interface DepositMethodHandlers {
+    defaultTab?: DepositMethodTab;
+    /** Allowance (shown as a "policy") the host service requests. */
+    allowance?: Allowance;
+    onSelectConnectedWallet?: () => void;
+    onSelectExternalWallet?: () => void;
+    onSelectCreditCard?: () => void;
+    onConnectWallet?: () => void;
+    /** Called when the user confirms the amount on the deposit view. */
+    onDeposit?: (args: {
+        source: DepositSource;
+        tokenId: string;
+        amount: string;
+    }) => void;
+    onDepositSuccess?: () => void;
+}
+interface DepositModalProps extends DepositMethodHandlers {
+    open: boolean;
+    onClose: () => void;
+}
+declare function DepositModal({ open, onClose, ...handlers }: DepositModalProps): react_jsx_runtime.JSX.Element;
+interface DepositInlineModalProps extends DepositMethodHandlers {
+    className?: string;
+}
+declare function DepositInlineModal({ className, ...handlers }: DepositInlineModalProps): react_jsx_runtime.JSX.Element;
+
+interface WithdrawModalProps {
+    open: boolean;
+    onClose: () => void;
+}
+declare function WithdrawModal({ open, onClose }: WithdrawModalProps): react_jsx_runtime.JSX.Element;
+interface WithdrawInlineModalProps {
+    className?: string;
+}
+declare function WithdrawInlineModal({ className }: WithdrawInlineModalProps): react_jsx_runtime.JSX.Element;
+
+interface WalletSession {
+    /** Funds committed to the active session, in the display token's base units. */
+    inUse: string | bigint;
+    /** Unix timestamp (seconds) when the session lock expires; shows the countdown. */
+    expiry?: number;
+}
+interface WalletModalHandlers extends DepositMethodHandlers {
+    session?: WalletSession;
+    onPlay?: (args: {
+        tokenId: string;
+        amount: string;
+    }) => void;
+    onEndSession?: () => Promise<void>;
+}
+interface WalletModalProps extends WalletModalHandlers {
+    open: boolean;
+    onClose: () => void;
+}
+declare function WalletModal({ open, onClose, ...handlers }: WalletModalProps): react_jsx_runtime.JSX.Element;
+interface WalletInlineModalProps extends WalletModalHandlers {
+    className?: string;
+}
+declare function WalletInlineModal({ className, ...handlers }: WalletInlineModalProps): react_jsx_runtime.JSX.Element;
+
 declare function Skeleton({ className, ...props }: React.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 
 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, Address, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, Bytes32, type ChainConfig, CreateOnRampIntentRequest, CreateOnRampIntentResponse, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, type DepositParams, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, 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, NetworkConfig, NetworkError, PendingOnRampsResponse, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, SignOnRampUrlRequest, SignOnRampUrlResponse, 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, 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, UpdateOnRampRequest, UpdateOnRampResponse, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositOptions, type UseDepositResult, type UseDepositVerificationOptions, type UseDepositVerificationResult, 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, type VerificationContext, 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, getChainById, getChainIcon, getExplorerAddressUrl, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useDepositVerification, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };
+interface PrivanaIconProps {
+    className?: string;
+    size?: number;
+}
+declare function PrivanaIcon({ className, size }: PrivanaIconProps): react_jsx_runtime.JSX.Element;
+
+export { AccountingApiError, Address, type Allowance, type AllowanceTerm, type BalanceResponse, type BatchBalancesRequest, type BatchBalancesResponse, Button, Bytes32, type ChainConfig, CreateOnRampIntentRequest, CreateOnRampIntentResponse, type DepositAddressRequest, type DepositAddressResponse, type DepositCheckRequest, type DepositCheckResponse, DepositInlineModal, type DepositInlineModalProps, type DepositMethodHandlers, DepositModal, type DepositModalProps, type DepositParams, type DepositSource, type EIP712Domain, type ExpiredLocksResponse, HOSTED_AUTH_CLOCK_SKEW_MS, HexString, type HistoryEntry, type HistoryKind, type HistoryRequest, type HistoryResponse, type HostedAuthAuthorizeUrlRequest, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, HostedAuthResponseMode, type HostedAuthSession, HostedAuthStateMismatchError, type HostedAuthTokenExchangeRequest, type HostedAuthTokenExchangeResponse, HttpClient, type HttpClientConfig, 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, NetworkConfig, NetworkError, PendingOnRampsResponse, type PendingWithdrawalsResponse, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaClientConfig, type PrivanaContextValue, PrivanaIcon, PrivanaInlineModal, PrivanaModal, PrivanaProvider, type PrivanaProviderProps, SUPPORTED_CHAINS, type SignLockParams, type SignModifyLockParams, SignOnRampUrlRequest, SignOnRampUrlResponse, 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, 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, UpdateOnRampRequest, UpdateOnRampResponse, type UseBalanceOptions, type UseBalanceResult, type UseBatchBalancesOptions, type UseBatchBalancesResult, type UseDepositAddressOptions, type UseDepositAddressResult, type UseDepositOptions, type UseDepositResult, type UseDepositVerificationOptions, type UseDepositVerificationResult, 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, type VerificationContext, WITHDRAW_FROM_LOCK_TYPES, WITHDRAW_TYPES, WalletInlineModal, type WalletInlineModalProps, WalletModal, type WalletModalHandlers, type WalletModalProps, type WalletSession, type WithdrawFromLockMessage, type WithdrawFromLockRequest, WithdrawInlineModal, type WithdrawInlineModalProps, type WithdrawMessage, WithdrawModal, type WithdrawModalProps, type WithdrawParams, type WithdrawStep, type WithdrawalInfo, type WithdrawalInfoResponse, type WithdrawalNonceResponse, type WithdrawalRequest, applyRefreshResponse, buildHostedAuthSession, buildSiweStatement, buttonVariants, clearHostedAuthPendingTransaction, createDomain, createHostedAuthPendingStorageKey, createHostedAuthState, createHostedAuthStorageKey, createLockExpiry, createPkceChallenge, createPkceVerifier, getChainById, getChainIcon, getExplorerAddressUrl, getExplorerLabel, getTokenIcon, isHostedAuthRefreshActive, isHostedAuthSessionActive, parseHostedAuthCallback, persistHostedAuthPendingTransaction, readHostedAuthPendingTransaction, readStoredHostedAuthSession, signLockMessage, signModifyLockMessage, signTransferLockedMessage, signTransferMessage, signWithdrawFromLockMessage, signWithdrawMessage, stripHostedAuthCallbackParams, syncHostedAuthSessionToClient, useBalance, useBatchBalances, useDeposit, useDepositAddress, useDepositVerification, useExpiredLocks, useHistory, useHostedRedirectAuth, useLockFunds, useLockedFunds, useModifyLock, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };