@oasisprotocol/privana-sdk 0.4.4 → 0.5.1

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, J as JwtRefreshResponse, H as HostedAuthTokenExchangeResponse, B as Bytes32, S as SiweLoginResponse, P as PrivanaClient, N as NetworkConfig, T as TokenConfig, a as TokenBalance, b as PostDepositLockConfig, D as DepositAddressResponse, c as DepositCheckResponse, d as TransactionSubmissionResponse, e as PostDepositLockError, L as LockInfo, f as PendingDeposit, g as PendingDepositsResponse, W as WithdrawalInfo, h as HistoryEntry, i as TokenInfoResponse } from './pending-lock-BdkuMjmY.cjs';
+export { j as BalanceResponse, k as BatchBalancesRequest, l as BatchBalancesResponse, C as CreateOnRampIntentRequest, m as CreateOnRampIntentResponse, n as CreateSignedLockRequestParams, o as DEFAULT_LOCK_DURATION_SECONDS, p as DEFAULT_ONRAMP_LOCK_BUFFER, q as DepositAddressRequest, r as DepositCheckRequest, E as ExpiredLocksResponse, s as HexString, t as HistoryKind, u as HistoryRequest, v as HistoryResponse, w as HostedAuthAuthorizeUrlRequest, x as HostedAuthResponseMode, y as HostedAuthTokenExchangeRequest, z as HttpClient, F as HttpClientConfig, I as IntegerLike, G as JwtLogoutRequest, K as JwtLogoutResponse, M as JwtRefreshRequest, O as LockFundsRequest, Q as LockNonceResponse, R as LockedFundsResponse, U as MinDepositAmounts, V as ModifyLockNonceResponse, X as ModifyLockRequest, Y as NETWORK_CONFIG, Z as Network, _ as OnRampPostDepositLockConfig, $ as OnRampRecord, a0 as OnRampStatus, a1 as PendingDepositStatus, a2 as PendingDepositsRequest, a3 as PendingOnRampsResponse, a4 as PendingWithdrawalsResponse, a5 as PostDepositLockFailureReason, a6 as PrivanaClientConfig, a7 as SignOnRampUrlRequest, a8 as SignOnRampUrlResponse, a9 as SiweDomainResponse, aa as SiweLoginRequest, ab as SiweNonceResponse, ac as SubmitPendingLockParams, ad as TokenListResponse, ae as TotalLockedBalanceResponse, af as TransferFundsRequest, ag as TransferLockedFundsRequest, ah as TransferLockedNonceResponse, ai as TransferNonceResponse, aj as UnlockAllExpiredRequest, ak as UnlockFundsRequest, al as UpdateOnRampRequest, am as UpdateOnRampResponse, an as WithdrawFromLockRequest, ao as WithdrawalInfoResponse, ap as WithdrawalNonceResponse, aq as WithdrawalRequest, ar as applyLockBuffer, as as clampLockAmount, at as clearPendingLock, au as createSignedLockRequest, av as getAccountingContract, aw as getApiUrl, ax as getChainId, ay as isSignedLockUsable, az as loadPendingLock, aA as normalizeAddress, aB as normalizeHex, aC as savePendingLock, aD as submitPendingLock } from './pending-lock-BdkuMjmY.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,33 @@ 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. The pre-signed lock amount is capped to this value.
+     */
+    value: string;
+    /**
+     * Minimum amount the delivered deposit must reach, in the token's base units.
+     * Display-only: with a pre-signed exact-amount lock, a short delivery means
+     * no lock is created at all, which is stricter than any minimum.
+     */
+    minAmount?: string;
+    /**
+     * Lock lifetime in seconds, applied from signing time (the `Lock` expiry is
+     * an absolute timestamp). Defaults to the SDK default (259200, 3 days) when omitted.
+     */
+    lockDuration?: number;
+    terms?: {
+        permissions?: AllowanceTerm[];
+        restrictions?: AllowanceTerm[];
+    };
+}
+
 interface HostedAuthConfig {
     clientId: string;
     redirectUri: string;
@@ -41,272 +68,13 @@ 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 {
-    chain_type?: string;
-    version?: number;
-}
-interface DepositCheckRequest {
-    chain_type?: string;
-    chain_id: number;
-    tx_hash: HexString;
-    amount: IntegerLike;
-    log_index?: number;
-    version?: number;
-}
-interface LockFundsRequest {
-    service_address: Address;
-    token_id: Bytes32;
-    amount: IntegerLike;
-    expiry: IntegerLike;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface ModifyLockRequest {
-    lock_id: number;
-    amount: IntegerLike;
-    new_expiry: IntegerLike;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface UnlockFundsRequest {
-    user_address: Address;
-    lock_id: number;
-}
-interface UnlockAllExpiredRequest {
-    user_address: Address;
-}
-interface TransferFundsRequest {
-    to_address: Address;
-    token_id: Bytes32;
-    amount: IntegerLike;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface TransferLockedFundsRequest {
-    user_address: Address;
-    lock_id: number;
-    to_address: Address;
-    amount: IntegerLike;
-    service_address: Address;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface WithdrawalRequest {
-    token_id: Bytes32;
-    amount: IntegerLike;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface WithdrawFromLockRequest {
-    to_address: Address;
-    lock_id: number;
-    amount: IntegerLike;
-    nonce: IntegerLike;
-    signature: HexString;
-}
-interface BatchBalancesRequest {
-    token_ids: Bytes32[];
-}
-interface HistoryRequest {
-    offset?: number;
-    limit?: number;
-}
-interface SiweLoginRequest {
-    siwe_message: string;
-    signature: HexString;
-}
-interface HostedAuthAuthorizeUrlRequest {
-    client_id: string;
-    redirect_uri: string;
-    code_challenge: string;
-    state: string;
-    chain_id: number;
-    response_mode?: HostedAuthResponseMode;
-    code_challenge_method?: 'S256';
-}
-interface HostedAuthTokenExchangeRequest {
-    grant_type?: 'authorization_code';
-    code: string;
-    code_verifier: string;
-    client_id: string;
-    redirect_uri: string;
-}
-interface JwtRefreshRequest {
-    refresh_token: string;
-}
-interface JwtLogoutRequest {
-    refresh_token?: string;
-    revoke_all?: boolean;
-}
-
-interface MinDepositAmounts {
-    native: string;
-    erc20: string;
-}
-interface DepositAddressResponse {
-    deposit_address: Address;
-    chain_type: string;
-    version: number;
-    min_deposit: Record<string, MinDepositAmounts>;
-}
-interface DepositCheckResponse {
-    status: 'credited' | 'pending' | 'error';
-    deposit_id?: string;
-    amount?: string;
-    token_address?: Address;
-    detail?: string;
-}
-interface TransactionSubmissionResponse {
-    submission_id: string;
-    status: string;
-    detail?: string;
-}
-interface BalanceResponse {
-    user_address: Address;
-    token_id: Bytes32;
-    balance: string;
-    token_symbol: string;
-    chain_id: string;
-}
-interface TokenBalance {
-    token_id: Bytes32;
-    balance: string;
-    token_symbol: string;
-    chain_id: string;
-}
-interface BatchBalancesResponse {
-    user_address: Address;
-    balances: TokenBalance[];
-}
-type HistoryKind = 'deposit' | 'withdraw' | 'createLock' | 'transferFromLockOut' | 'transferFromLockIn' | 'transferBalanceOut' | 'transferBalanceIn' | 'modifyLock' | 'unlockLock' | 'unknown';
-interface HistoryEntry {
-    kind: HistoryKind;
-    timestamp: number;
-    token_id?: Bytes32 | null;
-    amount?: string | null;
-    counterparty?: Address | null;
-    deposit_id?: Bytes32 | null;
-    chain_id?: number | null;
-}
-interface HistoryResponse {
-    history: HistoryEntry[];
-    total: number;
-}
-interface TokenInfoResponse {
-    token_id: Bytes32;
-    token_type: number;
-    token_type_name: string;
-    data: string;
-    chain_id: number;
-    chain_name: string;
-    token_address: Address;
-    symbol: string;
-    name: string;
-    decimals: number;
-}
-interface TokenListResponse {
-    tokens: TokenInfoResponse[];
-}
-interface LockInfo {
-    lock_id: number;
-    user_address: Address;
-    service_address: Address;
-    token_id: Bytes32;
-    amount: string;
-    expiry: number;
-    is_expired: boolean;
-}
-interface LockedFundsResponse {
-    user_address: Address;
-    service_address?: Address;
-    locks: LockInfo[];
-    total_locked: string;
-}
-interface ExpiredLocksResponse {
-    user_address: Address;
-    expired_locks: LockInfo[];
-}
-interface TotalLockedBalanceResponse {
-    user_address: Address;
-    token_id: Bytes32;
-    total_locked: string;
-}
-interface WithdrawalInfo {
-    index: number;
-    user_address: Address;
-    to_address: Address;
-    amount: string;
-    block_number: number;
-    token_id: Bytes32;
-    resolved: boolean;
-    tx_identifier: string;
-}
-interface PendingWithdrawalsResponse {
-    user_address: Address;
-    pending_withdrawals: WithdrawalInfo[];
-}
-type WithdrawalInfoResponse = WithdrawalInfo;
-interface TransferNonceResponse {
-    user_address: Address;
-    nonce: string;
-}
-interface WithdrawalNonceResponse {
-    user_address: Address;
-    nonce: string;
-}
-interface LockNonceResponse {
-    user_address: Address;
-    nonce: string;
-}
-interface ModifyLockNonceResponse {
-    user_address: Address;
-    nonce: string;
-}
-interface TransferLockedNonceResponse {
-    service_address: Address;
-    nonce: string;
-}
-interface SiweDomainResponse {
-    domain: string;
-}
-interface SiweNonceResponse {
-    address: Address;
-    nonce: string;
-    expires_in: number;
-}
-interface SiweLoginResponse {
-    siwe_token: HexString;
-    jwt_access_token: string;
-    jwt_refresh_token: string;
-    address: Address;
-    jwt_expires_in: number;
-    jwt_refresh_expires_in: number;
-}
-interface HostedAuthTokenExchangeResponse {
-    access_token: string;
-    id_token: string;
-    refresh_token: string;
-    token_type: string;
-    expires_in: number;
-    refresh_expires_in: number;
-    address: Address;
-}
-interface JwtRefreshResponse {
-    token: string;
-    refresh_token: string;
-    expires_in: number;
-    refresh_expires_in: number;
-}
-interface JwtLogoutResponse {
-    message: string;
-    revoked_tokens: number;
-}
-
 declare const HOSTED_AUTH_CLOCK_SKEW_MS = 30000;
 type StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
 declare function createPkceVerifier(length?: number): string;
@@ -326,74 +94,6 @@ declare function isHostedAuthRefreshActive(session: HostedAuthSession, now?: num
 
 declare function buildSiweStatement(chainId: number): string;
 
-interface HttpClientConfig {
-    baseUrl: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-declare class HttpClient {
-    private readonly baseUrl;
-    private readonly timeout;
-    private readonly headers;
-    constructor(config: HttpClientConfig);
-    get<T>(path: string): Promise<T>;
-    post<T>(path: string, body?: unknown): Promise<T>;
-    getBaseUrl(): string;
-    setHeader(name: string, value: string): void;
-    removeHeader(name: string): void;
-    getHeader(name: string): string | undefined;
-    private request;
-}
-
-type PrivanaClientConfig = HttpClientConfig;
-declare class PrivanaClient {
-    private readonly http;
-    constructor(config: PrivanaClientConfig);
-    getBaseUrl(): string;
-    getDepositAddress(request?: DepositAddressRequest): Promise<DepositAddressResponse>;
-    checkDeposit(request: DepositCheckRequest): Promise<DepositCheckResponse>;
-    getDepositStatus(depositId: string): Promise<DepositCheckResponse>;
-    getBalance(tokenId: Bytes32 | string): Promise<BalanceResponse>;
-    getBatchBalances(request: BatchBalancesRequest): Promise<BatchBalancesResponse>;
-    getHistory(request?: HistoryRequest): Promise<HistoryResponse>;
-    listTokens(): Promise<TokenListResponse>;
-    getTokenInfo(tokenId: Bytes32 | string): Promise<TokenInfoResponse>;
-    lockFunds(request: LockFundsRequest): Promise<TransactionSubmissionResponse>;
-    modifyLock(request: ModifyLockRequest): Promise<TransactionSubmissionResponse>;
-    unlockFunds(request: UnlockFundsRequest): Promise<TransactionSubmissionResponse>;
-    unlockAllExpired(request: UnlockAllExpiredRequest): Promise<TransactionSubmissionResponse>;
-    getLockedFunds(serviceAddress?: Address | string): Promise<LockedFundsResponse>;
-    getTotalLockedBalance(tokenId: Bytes32 | string): Promise<TotalLockedBalanceResponse>;
-    getExpiredLocks(): Promise<ExpiredLocksResponse>;
-    transferFunds(request: TransferFundsRequest): Promise<TransactionSubmissionResponse>;
-    getTransferNonce(userAddress: Address | string): Promise<TransferNonceResponse>;
-    getLockNonce(userAddress: Address | string): Promise<LockNonceResponse>;
-    getModifyLockNonce(userAddress: Address | string): Promise<ModifyLockNonceResponse>;
-    transferLockedFunds(request: TransferLockedFundsRequest): Promise<TransactionSubmissionResponse>;
-    withdrawFromLock(request: WithdrawFromLockRequest): Promise<TransactionSubmissionResponse>;
-    requestWithdrawal(request: WithdrawalRequest): Promise<TransactionSubmissionResponse>;
-    getWithdrawalNonce(userAddress: Address | string): Promise<WithdrawalNonceResponse>;
-    getTransferLockedNonce(serviceAddress: Address | string): Promise<TransferLockedNonceResponse>;
-    getPendingWithdrawals(userAddress: Address | string): Promise<PendingWithdrawalsResponse>;
-    getWithdrawalInfo(index: number): Promise<WithdrawalInfoResponse>;
-    getSiweDomain(): Promise<SiweDomainResponse>;
-    getSiweNonce(userAddress: Address | string): Promise<SiweNonceResponse>;
-    loginWithSiwe(request: SiweLoginRequest): Promise<SiweLoginResponse>;
-    getHostedAuthAuthorizeUrl(request: HostedAuthAuthorizeUrlRequest): string;
-    exchangeHostedAuthCode(request: HostedAuthTokenExchangeRequest): Promise<HostedAuthTokenExchangeResponse>;
-    refreshJwtSession(request: JwtRefreshRequest): Promise<JwtRefreshResponse>;
-    logoutJwtSession(request?: JwtLogoutRequest): Promise<JwtLogoutResponse>;
-    signOnRampUrl(request: SignOnRampUrlRequest): Promise<SignOnRampUrlResponse>;
-    createOnRampIntent(request: CreateOnRampIntentRequest): Promise<CreateOnRampIntentResponse>;
-    updateOnRamp(transactionId: string, request: UpdateOnRampRequest): Promise<UpdateOnRampResponse>;
-    getPendingOnRamps(): Promise<PendingOnRampsResponse>;
-    setPrivateReadToken(token: string): void;
-    getPrivateReadToken(): string | undefined;
-    clearPrivateReadToken(): void;
-    setBearerToken(token: string): void;
-    clearBearerToken(): void;
-}
-
 declare class AccountingApiError extends Error {
     readonly statusCode: number;
     readonly detail?: string | undefined;
@@ -651,6 +351,8 @@ interface PrivanaContextValue {
     tokensError?: Error;
     pollingInterval: number;
     serviceAddress?: Address;
+    serviceName?: string;
+    serviceIcon?: ReactNode;
     hostedAuthConfig: HostedAuthConfig | null;
     hostedAuthSession: HostedAuthSession | null;
     setHostedAuthSession: (session: HostedAuthSession | null) => void;
@@ -682,6 +384,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.
      */
@@ -695,7 +406,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;
 
@@ -746,7 +457,18 @@ declare function useBatchBalances(options: UseBatchBalancesOptions): UseBatchBal
 interface UseDepositOptions {
     onDepositAddressReceived?: (response: DepositAddressResponse) => void;
     onDepositSuccess?: (txHash: string) => void;
-    onCredited?: (txHash: string, response: DepositCheckResponse) => void;
+    /** `lockPending` is true when a pre-signed lock is being submitted after
+     * this credit — `onLockSubmitted` or `onLockFailed` will follow. */
+    onCredited?: (txHash: string, response: DepositCheckResponse, lockPending?: boolean) => void;
+    /** Fired when the pre-signed post-deposit lock is accepted by the API. */
+    onLockSubmitted?: (response: TransactionSubmissionResponse) => void;
+    /**
+     * Fired when the deposit credited but the pre-signed lock could not be
+     * submitted (expired, short credit, stale nonce). The funds sit in the
+     * user's available balance — re-prompt a fresh lock signature at the
+     * credited amount. Falls back to `onError` when not provided.
+     */
+    onLockFailed?: (error: PostDepositLockError) => void;
     /** Called when deposit check polling times out - deposit may still be processing */
     onCheckTimeout?: (txHash: string) => void;
     onError?: (error: Error) => void;
@@ -760,6 +482,11 @@ interface UseDepositOptions {
 interface DepositParams {
     tokenId: Bytes32;
     amount: bigint;
+    /**
+     * Pre-sign a `Lock` for the deposited amount (capped by `maxAmount`) before
+     * the transfer; the SDK submits it once the deposit credits.
+     */
+    postDepositLock?: PostDepositLockConfig;
 }
 interface UseDepositResult {
     depositAddress: DepositAddressResponse | null;
@@ -789,6 +516,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}`;
@@ -796,6 +542,8 @@ interface VerificationContext {
     chainId: number;
     /** Transferred amount in base units (matches the deposit's token decimals). */
     amount: bigint;
+    /** Log index of the exact Transfer event within the tx (default: 0). */
+    logIndex?: number;
 }
 interface UseDepositVerificationOptions {
     /** Fired when the deposit is credited inside the Privana accounting module. */
@@ -979,6 +727,30 @@ interface UseExpiredLocksResult {
 }
 declare function useExpiredLocks(options?: UseExpiredLocksOptions): UseExpiredLocksResult;
 
+interface UsePendingDepositsOptions {
+    /** Source chain to scan. Query is disabled while undefined. */
+    chainId?: number;
+    enabled?: boolean;
+    /** Auto-poll cadence in ms, or false for manual refetch only (default: 30s, the server scan-cache TTL). */
+    refetchInterval?: number | false;
+    /** Narrow the scan to one registered ERC20. */
+    tokenAddress?: Address;
+    /** Scan window in blocks (server default ≈ 1h, clamped ≈ 24h). */
+    lookbackBlocks?: number;
+}
+interface UsePendingDepositsResult {
+    pending: PendingDeposit[];
+    scannedToBlock: number | undefined;
+    isFetching: boolean;
+    isError: boolean;
+    error: Error | null;
+    isRateLimited: boolean;
+    /** Discovery is not configured for this chain server-side (503) — a deployment fault, not transient. */
+    isUnavailable: boolean;
+    refetch: () => Promise<PendingDepositsResponse | undefined>;
+}
+declare function usePendingDeposits(options?: UsePendingDepositsOptions): UsePendingDepositsResult;
+
 interface UsePendingWithdrawalsOptions {
     enabled?: boolean;
 }
@@ -1098,9 +870,80 @@ 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;
+    /** With an allowance this fires only after the pre-signed lock is accepted. */
+    onDepositSuccess?: () => void;
+    /** The deposit credited but the pre-signed lock failed — re-prompt. */
+    onLockFailed?: (error: PostDepositLockError) => 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, buildSiweStatement, 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, Button, Bytes32, type ChainConfig, DepositAddressResponse, DepositCheckResponse, DepositInlineModal, type DepositInlineModalProps, type DepositMethodHandlers, DepositModal, type DepositModalProps, type DepositParams, type DepositSource, type EIP712Domain, HOSTED_AUTH_CLOCK_SKEW_MS, HistoryEntry, type HostedAuthCallback, type HostedAuthCallbackError, type HostedAuthCallbackSuccess, type HostedAuthConfig, HostedAuthError, type HostedAuthPendingTransaction, HostedAuthRequiredError, type HostedAuthSession, HostedAuthStateMismatchError, HostedAuthTokenExchangeResponse, JwtRefreshResponse, LOCK_TYPES, type LockFundsParams, LockInfo, type LockMessage, MODIFY_LOCK_TYPES, type ModifyLockMessage, type ModifyLockParams, NetworkConfig, NetworkError, PendingDeposit, PendingDepositsResponse, PostDepositLockConfig, PostDepositLockError, PrivanaButton, type PrivanaButtonProps, PrivanaClient, type PrivanaContextValue, PrivanaIcon, 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, SiweLoginResponse, Skeleton, TRANSFER_LOCKED_TYPES, TRANSFER_TYPES, TokenBalance, TokenConfig, TokenInfoResponse, type TokensStatus, TransactionSubmissionResponse, type TransferLockedMessage, type TransferLockedParams, type TransferMessage, type TransferParams, type UnlockFundsParams, 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 UsePendingDepositsOptions, type UsePendingDepositsResult, 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, WithdrawInlineModal, type WithdrawInlineModalProps, type WithdrawMessage, WithdrawModal, type WithdrawModalProps, type WithdrawParams, type WithdrawStep, WithdrawalInfo, 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, usePendingDeposits, usePendingWithdrawals, usePrivanaClient, usePrivanaContext, useSafeAccount, useSafePrivanaContext, useSiweAuth, useTokenInfo, useTokenList, useTotalLockedBalance, useTransfer, useUnlockFunds, useWithdraw };