@privy-io/js-sdk-core 0.79.1 → 0.79.3

package/dist/cjs/tempoChains-C7o70PSk.js

@@ -0,0 +1 @@
+let e=require("viem/chains");Object.defineProperty(exports,"tempo",{enumerable:!0,get:function(){return e.tempo}}),Object.defineProperty(exports,"tempoModerato",{enumerable:!0,get:function(){return e.tempoModerato}});

package/dist/dts/index.d.mts

@@ -304,20 +304,21 @@ type OnNeedsRecovery = (input: {
   recoveryMethod: EmbeddedWalletRecoveryOptions;
   onRecovered: () => void;
 }) => Promise<void> | void;
-declare class EmbeddedWalletProvider extends EventEmitter implements EIP1193Provider {
+declare abstract class EmbeddedWalletProvider extends EventEmitter implements EIP1193Provider {
   request(request: RequestArguments): Promise<any>;
   private applyDataSuffix;
-  /**
-   * Backfills a transaction that may not specify a `chainId` with the provider's `this._chainId`
-   * and switches the provider to that chain. Works for both standard EVM and
-   * Tempo (type 118) requests.
-   */
   private ensureChainId;
+  private awaitClientReady;
   /**
    * If a chainId is provided that differs from the current `this._chainId`,
    * the new chain and StaticJsonRpcProvider will be set
    */
   private internalSwitchEthereumChain;
+  /**
+   * Rebuild `_client` for the current chain. Tempo chains need their definitions loaded first, so
+   * the client is built asynchronously and `_clientReady` is set until then.
+   */
+  private updateClient;
   private handlePopulateTransaction;
   private handleSignTransaction;
   private handleSendTransaction;
@@ -841,7 +842,7 @@ type SignTransactionRequestArguments<T extends SolanaTransactionInput = Transact
  *
  * Currently only supports signing messages.
  */
-declare class EmbeddedSolanaWalletProvider {
+declare abstract class EmbeddedSolanaWalletProvider {
   request(request: SignMessageRequestArguments): Promise<{
     signature: string;
   }>;
@@ -864,10 +865,6 @@ declare class EmbeddedSolanaWalletProvider {
    * @deprecated
    */
   get _publicKey(): string;
-  private connectAndRecover;
-  private walletRpcContext;
-  private signMessageRpc;
-  private signSerializedTransaction;
   private signTransactionObject;
   private handleIFrameRpc;
   private handleSignAndSendTransaction;
@@ -1152,6 +1149,9 @@ declare class EmbeddedWalletApi {
    * Retrieve this user's embedded wallet.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @param password Recovery password for the embedded wallet
    * @returns EmbeddedWalletProvider implementing EIP1193Provider
    */
@@ -1160,6 +1160,9 @@ declare class EmbeddedWalletApi {
    * Load this user's embedded ethereum wallet through the given entropy.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @returns EmbeddedWalletProvider implementing EIP1193Provider
    */
   getEthereumProvider({ wallet, entropyId, entropyIdVerifier, recoveryPassword, recoveryAccessToken, recoverySecretOverride, recoveryKey, onNeedsRecovery }: {
@@ -1188,6 +1191,9 @@ declare class EmbeddedWalletApi {
    * Retrieve this users embedded Solana wallet.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @returns EmbeddedSolanaWalletProvider
    */
   getSolanaProvider(account: LinkedAccountSolanaEmbeddedWallet, entropyId: string, entropyIdVerifier: EntropyIdVerifier, recoveryPassword?: string, recoveryAccessToken?: string, recoverySecretOverride?: string,
@@ -1470,6 +1476,7 @@ declare class OAuthApi {
   linkWithCode(authorizationCode: string, returnedStateCode: string, provider?: OAuthProviderID$1, codeType?: 'raw'): Promise<{
     user: import("@privy-io/api-types").User;
     identity_token: string | undefined;
+    oauth_tokens: import("@privy-io/api-types").OAuthTokens | undefined;
   }>;
   /**
    * Un-links an OAuth account from an existing user
@@ -2476,7 +2483,7 @@ type UnsignedEthereumTransactionType = UnsignedEthereumTransaction;
  * Converts an unsigned transaction request to the format expected by the Wallet API.
  *
  * Routes Tempo (type 118 / 0x76) requests through the Tempo serializer and falls
- * through to the standard EVM serializer for legacy/EIP-2930/EIP-1559 inputs.
+ * through to the standard EVM serializer for legacy/EIP-1559/EIP-7702 inputs.
  */
 declare function toWalletApiUnsignedEthTransaction(transaction: StrictUnsignedTransactionRequest | StrictUnsignedTempoTransactionRequest): UnsignedEthereumTransactionType;
 //#endregion
@@ -3232,13 +3239,17 @@ declare function filterDepositConfig(config: CryptoDepositAccountConfig, source:
 /**
  * Picks the deposit address that should be shown for a selected source chain.
  *
- * Create returns one address per source chain family. Prefer an account whose
- * source filter mentions that chain, then fall back to address format vs VM.
+ * Create returns one address per source chain family, so the address in the
+ * selected chain's format is the one to show. Which assets and chains a user
+ * can pick is decided by the request's source filter (see
+ * `filterDepositConfig`), not here.
+ * Returns undefined rather than an address in the wrong format.
  */
 declare function pickDepositAddressForChain({ accounts, selectedChain }: {
   accounts: CryptoDepositAddressRoute[];
+  /** Only `vmType` is read; `caip2` is accepted for compatibility. */
   selectedChain: {
-    caip2: string;
+    caip2?: string;
     vmType: string;
   };
 }): string | undefined;
@@ -3604,6 +3615,42 @@ declare const approveSpend: ({ sendTransaction, evmChainId, stablecoinAddress, s
   hash: string;
 }>;
 //#endregion
+//#region src/cards/statement-periods.d.ts
+type StatementMonth = {
+  /** `YYYY-MM`, the value the statement endpoint takes as its whole period. */
+  value: string;
+  /** Localized "August 2026", the value the user picks by. */
+  label: string;
+};
+/**
+ * The months this card can have a statement for, newest first. Empty when it can have none yet.
+ *
+ * Bounded at both ends, because a period the provider has no statement for is an error rather than
+ * an empty PDF:
+ *
+ * - **Newest.** Production only generates statements for complete months, so it starts at last
+ *   month; sandbox generates the current month so integrations can test without waiting for one to
+ *   close, so it starts there. Confirmed by Elvin, 2026-08-28.
+ * - **Oldest.** Stops at the month the card was issued — a period before the card existed has no
+ *   statement. The issue month itself is offered: a card issued mid-month has a statement for that
+ *   month once it closes.
+ *
+ * Every month is read in UTC, the frame `created_at` is already in, and each period is anchored on
+ * its 1st. Local months would make the bound depend on the viewer's offset: a card issued
+ * `2026-08-01T00:30Z` reads as July from UTC-5, which would offer a period from before the card
+ * existed — the failure this function exists to prevent. The 1st keeps subtracting a month from
+ * rolling over a shorter one (e.g. the 31st minus a month).
+ *
+ * @param cardCreatedAt When the card was issued.
+ * @param environment Which environment the card belongs to, which sets the newest month offered.
+ * @param now Override for the current date. Present so callers can test period boundaries.
+ */
+declare const buildRecentMonths: ({ cardCreatedAt, environment, now }: {
+  cardCreatedAt: Date;
+  environment: IntegrationEnvironment;
+  now?: Date;
+}) => StatementMonth[];
+//#endregion
 //#region src/cards/card-funding-source.d.ts
 /**
  * Funds a card can spend: its wallet's stablecoin, or its shares in an Earn vault. `selected` marks
@@ -4251,4 +4298,4 @@ declare const THIRDWEB: "thirdweb";
 /** @deprecated {@link SmartWalletType} is a well-typed union, use the `'nexus'` literal instead */
 declare const NEXUS: "nexus";
 //#endregion
-export { ALL_WALLET_CLIENT_TYPES, BICONOMY, COINBASE_SMART_WALLET, type CardFundingSource, type CardResponse, type CardSignUp, type CardSignUpEvmWallet, type CardSignUpHostedPage, type CardSignUpPlatform, type CardSignUpSpendApproval, type CardSignUpStep, type CardTransactionBadge, type CardTransactionRow, type CardsConfig, Cluster, type CoinbaseAssetId, CoinbaseWalletClientType, type CompletedDepositAddressOrder, ConnectedStandardSolanaWallet, ConnectorType, CookieWriteBehavior, type CountryCallingCode, type CountryCode, type CreateCryptoDepositAccountInput, type CreateCryptoDepositAccountResponse, type CreateSiwsMessageOpts, type CryptoDepositAccountConfig, type CryptoDepositAccountQuote, type CryptoDepositAccountQuoteInput, type CryptoDepositAccountSearchResult, type CryptoDepositAddressRoute, type CryptoDepositAddressStrategy, type CryptoDepositAsset, type CryptoDepositAssetFilter, DATA_SUFFIX_PLUGIN_ID, type DataSuffixPlugin, type DepositAddressOrder, type DepositAddressPollingResult, type DepositAddressQuote, type DepositConfig, type DevSpendApprovalTarget, type EIP1193Provider, type EmbeddedBitcoinWalletProvider, EmbeddedProviderError, EmbeddedWalletClientType, type EmbeddedWalletConfig, type EmbeddedWalletRecoveryOptions, type EntropyIdVerifier, type ErrorMessageMap, type EvmDevSpendApprovalTarget, ExternalWallet, ExternalWalletMetadata, FundingMethod, FundingProvider, type GenerateAuthorizationSignatureInput, type GenerateAuthorizationSignatureOutput, type GenerateDepositAddressInput, type GetCryptoDepositAccountNextOrderInput, type GetCryptoDepositAccountNextOrderResponse, type GetCryptoDepositAccountOrderInput, type GetCryptoDepositAccountOrderResponse, type GetDepositInput, IdentifierString, InMemoryCache, type IncompleteDepositAddressOrder, InjectedWalletClientType, KERNEL, LIGHT_ACCOUNT, LIST_CARDS_MAX_LIMIT, LocalStorage, type LogLevel, type Logger, type MfaMethod, type MfaPromise, type MfaSubmitArgs, type MfaSubmitPromise, MoonpayApiError, type MoonpayTransactionStatus, type MoonpayTransactionStatusResponse, NEXUS, type OAuthProviderID, OAuthProviderType, type OnNeedsRecovery, type ParsedSolanaOffchainMessage, PaymentOption, type PollOptions, type PollResult, type PreparedTransactionRequest, PrivyApiError, PrivyClientError, PrivyConnectorError, PrivyEmbeddedSolanaWalletProvider, PrivyEmbeddedWalletErrorCode, PrivyEmbeddedWalletProvider, type PrivyPlugin, PrivyProviderRpcError, ProviderErrors, type Quantity, type ResolveRefundAddressError, type ResolveRefundAddressResult, SAFE, SUPPORTED_CONNECTOR_TYPES, type SendSpendApproval, type SessionSignerInput, type SetRecoveryInput, SmartWalletType, SolanaClient, SolanaCluster, SolanaSignAndSendTransactionInput, SolanaSignAndSendTransactionMode, SolanaSignAndSendTransactionOptions, SolanaSignAndSendTransactionOutput, SolanaSignMessageInput, SolanaSignMessageOutput, SolanaSignTransactionInput, SolanaSignTransactionOptions, SolanaSignTransactionOutput, type SolanaSpendApprovalChain, SolanaStandardWallet, SolanaTransactionCommitment, SolanaUsdcAddressMap, type SpendApprovalConfig, type SpendApprovalProvider, type Storage, type SvmDevSpendApprovalTarget, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, type UpdateWalletInput, UsdcAddressMap, type WaitForCompletionInput, type WaitForDepositInput, WalletBranding, WalletClientType, WalletConnectWalletClientType, acceptCardConsents, addSessionSigners, approveSpend, buildSolanaOffchainMessage, chainToMoonpayCurrency, chooseTempoEarnVault, cookies, countryCodesAndNumbers, create, createCard, createCardSignUp, createDataSuffixPlugin, createErrorFormatter, createSiwsMessage, index_d_exports as crossApp, index_d_exports$1 as cryptoDepositAccount, Privy as default, index_d_exports$2 as delegatedActions, index_d_exports$3 as depositAddress, deriveSolanaApplicationDomain, downloadCardStatement, errorIndicatesMaxMfaRetries, errorIndicatesMfaCanceled, errorIndicatesMfaRateLimit, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, errorIndicatesRecoveryIsNeeded, formatLamportsAmount, formatPhoneNumber, formatSignedTransactionAmount, formatTokenAmount, formatTransactionDate, formatUsdAmount, formatWalletAddress, formatWeiAmount, fundingMethodToMoonpayPaymentMethod, generateAuthorizationSignature, generateWalletIdempotencyKey, getAllUserEmbeddedBitcoinWallets, getAllUserEmbeddedEthereumWallets, getAllUserEmbeddedSolanaWallets, getCardAssetDisplayName, getCardById, getCardCustomer, getCardDisclosure, getCardEphemeralKey, getCardsConfig, getCoinbaseOnRampUrl, getCountryCallingCode, getDataSuffixPlugin, getEntropyDetailsFromAccount, getEntropyDetailsFromUser, getFiatOnrampProviderBrand, getFiatOnrampProviderId, getIsTokenUsdc, getJsonRpcEndpointFromChain, getOrCreateCardCustomer, getPhoneCountryCodeAndNumber, getPlaceholderPhoneNumber, getSolanaClusterDisplayName, getSolanaRpcEndpointForCluster, getSolanaUsdcMintAddressForCluster, getSpendApproval, getTransactionBadge, getUserEmbeddedEthereumWallet, getUserEmbeddedSolanaWallet, getUserEmbeddedWallet, getUserSmartWallet, getWallet, getWalletAction, handleSignUpClose, isCardExpired, isEmbeddedWalletAccount, isExtensionContext, isSupportedChainIdForCoinbaseOnramp, isSupportedChainIdForMoonpay, isUnifiedWallet, lastFourDigits, listCardTransactions, listCards, listWalletActions, parseSolanaOffchainMessage, phoneNumberTypingFormatter, poll, rawSign, readSpendAllowance, readTempoEarnVault, removeSessionSigners, replaceCard, rpc, shouldWriteSessionCookies, throwIfInvalidRecoveryUpgradePath, toCoinbaseAssetId, toCoinbaseBlockchainFromChainId, toE164, toObjectKeys, toTransactionRow, toWalletApiUnsignedEthTransaction, transfer, updateCardPin, updateCardStatus, updateWallet, validatePhoneNumber };
+export { ALL_WALLET_CLIENT_TYPES, BICONOMY, COINBASE_SMART_WALLET, type CardFundingSource, type CardResponse, type CardSignUp, type CardSignUpEvmWallet, type CardSignUpHostedPage, type CardSignUpPlatform, type CardSignUpSpendApproval, type CardSignUpStep, type CardTransactionBadge, type CardTransactionRow, type CardsConfig, Cluster, type CoinbaseAssetId, CoinbaseWalletClientType, type CompletedDepositAddressOrder, ConnectedStandardSolanaWallet, ConnectorType, CookieWriteBehavior, type CountryCallingCode, type CountryCode, type CreateCryptoDepositAccountInput, type CreateCryptoDepositAccountResponse, type CreateSiwsMessageOpts, type CryptoDepositAccountConfig, type CryptoDepositAccountQuote, type CryptoDepositAccountQuoteInput, type CryptoDepositAccountSearchResult, type CryptoDepositAddressRoute, type CryptoDepositAddressStrategy, type CryptoDepositAsset, type CryptoDepositAssetFilter, DATA_SUFFIX_PLUGIN_ID, type DataSuffixPlugin, type DepositAddressOrder, type DepositAddressPollingResult, type DepositAddressQuote, type DepositConfig, type DevSpendApprovalTarget, type EIP1193Provider, type EmbeddedBitcoinWalletProvider, EmbeddedProviderError, EmbeddedWalletClientType, type EmbeddedWalletConfig, type EmbeddedWalletRecoveryOptions, type EntropyIdVerifier, type ErrorMessageMap, type EvmDevSpendApprovalTarget, ExternalWallet, ExternalWalletMetadata, FundingMethod, FundingProvider, type GenerateAuthorizationSignatureInput, type GenerateAuthorizationSignatureOutput, type GenerateDepositAddressInput, type GetCryptoDepositAccountNextOrderInput, type GetCryptoDepositAccountNextOrderResponse, type GetCryptoDepositAccountOrderInput, type GetCryptoDepositAccountOrderResponse, type GetDepositInput, IdentifierString, InMemoryCache, type IncompleteDepositAddressOrder, InjectedWalletClientType, KERNEL, LIGHT_ACCOUNT, LIST_CARDS_MAX_LIMIT, LocalStorage, type LogLevel, type Logger, type MfaMethod, type MfaPromise, type MfaSubmitArgs, type MfaSubmitPromise, MoonpayApiError, type MoonpayTransactionStatus, type MoonpayTransactionStatusResponse, NEXUS, type OAuthProviderID, OAuthProviderType, type OnNeedsRecovery, type ParsedSolanaOffchainMessage, PaymentOption, type PollOptions, type PollResult, type PreparedTransactionRequest, PrivyApiError, PrivyClientError, PrivyConnectorError, PrivyEmbeddedSolanaWalletProvider, PrivyEmbeddedWalletErrorCode, PrivyEmbeddedWalletProvider, type PrivyPlugin, PrivyProviderRpcError, ProviderErrors, type Quantity, type ResolveRefundAddressError, type ResolveRefundAddressResult, SAFE, SUPPORTED_CONNECTOR_TYPES, type SendSpendApproval, type SessionSignerInput, type SetRecoveryInput, SmartWalletType, SolanaClient, SolanaCluster, SolanaSignAndSendTransactionInput, SolanaSignAndSendTransactionMode, SolanaSignAndSendTransactionOptions, SolanaSignAndSendTransactionOutput, SolanaSignMessageInput, SolanaSignMessageOutput, SolanaSignTransactionInput, SolanaSignTransactionOptions, SolanaSignTransactionOutput, type SolanaSpendApprovalChain, SolanaStandardWallet, SolanaTransactionCommitment, SolanaUsdcAddressMap, type SpendApprovalConfig, type SpendApprovalProvider, type StatementMonth, type Storage, type SvmDevSpendApprovalTarget, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, type UpdateWalletInput, UsdcAddressMap, type WaitForCompletionInput, type WaitForDepositInput, WalletBranding, WalletClientType, WalletConnectWalletClientType, acceptCardConsents, addSessionSigners, approveSpend, buildRecentMonths, buildSolanaOffchainMessage, chainToMoonpayCurrency, chooseTempoEarnVault, cookies, countryCodesAndNumbers, create, createCard, createCardSignUp, createDataSuffixPlugin, createErrorFormatter, createSiwsMessage, index_d_exports as crossApp, index_d_exports$1 as cryptoDepositAccount, Privy as default, index_d_exports$2 as delegatedActions, index_d_exports$3 as depositAddress, deriveSolanaApplicationDomain, downloadCardStatement, errorIndicatesMaxMfaRetries, errorIndicatesMfaCanceled, errorIndicatesMfaRateLimit, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, errorIndicatesRecoveryIsNeeded, formatLamportsAmount, formatPhoneNumber, formatSignedTransactionAmount, formatTokenAmount, formatTransactionDate, formatUsdAmount, formatWalletAddress, formatWeiAmount, fundingMethodToMoonpayPaymentMethod, generateAuthorizationSignature, generateWalletIdempotencyKey, getAllUserEmbeddedBitcoinWallets, getAllUserEmbeddedEthereumWallets, getAllUserEmbeddedSolanaWallets, getCardAssetDisplayName, getCardById, getCardCustomer, getCardDisclosure, getCardEphemeralKey, getCardsConfig, getCoinbaseOnRampUrl, getCountryCallingCode, getDataSuffixPlugin, getEntropyDetailsFromAccount, getEntropyDetailsFromUser, getFiatOnrampProviderBrand, getFiatOnrampProviderId, getIsTokenUsdc, getJsonRpcEndpointFromChain, getOrCreateCardCustomer, getPhoneCountryCodeAndNumber, getPlaceholderPhoneNumber, getSolanaClusterDisplayName, getSolanaRpcEndpointForCluster, getSolanaUsdcMintAddressForCluster, getSpendApproval, getTransactionBadge, getUserEmbeddedEthereumWallet, getUserEmbeddedSolanaWallet, getUserEmbeddedWallet, getUserSmartWallet, getWallet, getWalletAction, handleSignUpClose, isCardExpired, isEmbeddedWalletAccount, isExtensionContext, isSupportedChainIdForCoinbaseOnramp, isSupportedChainIdForMoonpay, isUnifiedWallet, lastFourDigits, listCardTransactions, listCards, listWalletActions, parseSolanaOffchainMessage, phoneNumberTypingFormatter, poll, rawSign, readSpendAllowance, readTempoEarnVault, removeSessionSigners, replaceCard, rpc, shouldWriteSessionCookies, throwIfInvalidRecoveryUpgradePath, toCoinbaseAssetId, toCoinbaseBlockchainFromChainId, toE164, toObjectKeys, toTransactionRow, toWalletApiUnsignedEthTransaction, transfer, updateCardPin, updateCardStatus, updateWallet, validatePhoneNumber };

package/dist/dts/index.d.ts

@@ -304,20 +304,21 @@ type OnNeedsRecovery = (input: {
   recoveryMethod: EmbeddedWalletRecoveryOptions;
   onRecovered: () => void;
 }) => Promise<void> | void;
-declare class EmbeddedWalletProvider extends EventEmitter implements EIP1193Provider {
+declare abstract class EmbeddedWalletProvider extends EventEmitter implements EIP1193Provider {
   request(request: RequestArguments): Promise<any>;
   private applyDataSuffix;
-  /**
-   * Backfills a transaction that may not specify a `chainId` with the provider's `this._chainId`
-   * and switches the provider to that chain. Works for both standard EVM and
-   * Tempo (type 118) requests.
-   */
   private ensureChainId;
+  private awaitClientReady;
   /**
    * If a chainId is provided that differs from the current `this._chainId`,
    * the new chain and StaticJsonRpcProvider will be set
    */
   private internalSwitchEthereumChain;
+  /**
+   * Rebuild `_client` for the current chain. Tempo chains need their definitions loaded first, so
+   * the client is built asynchronously and `_clientReady` is set until then.
+   */
+  private updateClient;
   private handlePopulateTransaction;
   private handleSignTransaction;
   private handleSendTransaction;
@@ -841,7 +842,7 @@ type SignTransactionRequestArguments<T extends SolanaTransactionInput = Transact
  *
  * Currently only supports signing messages.
  */
-declare class EmbeddedSolanaWalletProvider {
+declare abstract class EmbeddedSolanaWalletProvider {
   request(request: SignMessageRequestArguments): Promise<{
     signature: string;
   }>;
@@ -864,10 +865,6 @@ declare class EmbeddedSolanaWalletProvider {
    * @deprecated
    */
   get _publicKey(): string;
-  private connectAndRecover;
-  private walletRpcContext;
-  private signMessageRpc;
-  private signSerializedTransaction;
   private signTransactionObject;
   private handleIFrameRpc;
   private handleSignAndSendTransaction;
@@ -1152,6 +1149,9 @@ declare class EmbeddedWalletApi {
    * Retrieve this user's embedded wallet.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @param password Recovery password for the embedded wallet
    * @returns EmbeddedWalletProvider implementing EIP1193Provider
    */
@@ -1160,6 +1160,9 @@ declare class EmbeddedWalletApi {
    * Load this user's embedded ethereum wallet through the given entropy.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @returns EmbeddedWalletProvider implementing EIP1193Provider
    */
   getEthereumProvider({ wallet, entropyId, entropyIdVerifier, recoveryPassword, recoveryAccessToken, recoverySecretOverride, recoveryKey, onNeedsRecovery }: {
@@ -1188,6 +1191,9 @@ declare class EmbeddedWalletApi {
    * Retrieve this users embedded Solana wallet.
    * If the wallet has never been used on this device recover.
    *
+   * TEE wallet providers do not use the embedded wallet proxy, but their requests fail until
+   * `signWithUserSigner` can sign.
+   *
    * @returns EmbeddedSolanaWalletProvider
    */
   getSolanaProvider(account: LinkedAccountSolanaEmbeddedWallet, entropyId: string, entropyIdVerifier: EntropyIdVerifier, recoveryPassword?: string, recoveryAccessToken?: string, recoverySecretOverride?: string,
@@ -1470,6 +1476,7 @@ declare class OAuthApi {
   linkWithCode(authorizationCode: string, returnedStateCode: string, provider?: OAuthProviderID$1, codeType?: 'raw'): Promise<{
     user: import("@privy-io/api-types").User;
     identity_token: string | undefined;
+    oauth_tokens: import("@privy-io/api-types").OAuthTokens | undefined;
   }>;
   /**
    * Un-links an OAuth account from an existing user
@@ -2476,7 +2483,7 @@ type UnsignedEthereumTransactionType = UnsignedEthereumTransaction;
  * Converts an unsigned transaction request to the format expected by the Wallet API.
  *
  * Routes Tempo (type 118 / 0x76) requests through the Tempo serializer and falls
- * through to the standard EVM serializer for legacy/EIP-2930/EIP-1559 inputs.
+ * through to the standard EVM serializer for legacy/EIP-1559/EIP-7702 inputs.
  */
 declare function toWalletApiUnsignedEthTransaction(transaction: StrictUnsignedTransactionRequest | StrictUnsignedTempoTransactionRequest): UnsignedEthereumTransactionType;
 //#endregion
@@ -3232,13 +3239,17 @@ declare function filterDepositConfig(config: CryptoDepositAccountConfig, source:
 /**
  * Picks the deposit address that should be shown for a selected source chain.
  *
- * Create returns one address per source chain family. Prefer an account whose
- * source filter mentions that chain, then fall back to address format vs VM.
+ * Create returns one address per source chain family, so the address in the
+ * selected chain's format is the one to show. Which assets and chains a user
+ * can pick is decided by the request's source filter (see
+ * `filterDepositConfig`), not here.
+ * Returns undefined rather than an address in the wrong format.
  */
 declare function pickDepositAddressForChain({ accounts, selectedChain }: {
   accounts: CryptoDepositAddressRoute[];
+  /** Only `vmType` is read; `caip2` is accepted for compatibility. */
   selectedChain: {
-    caip2: string;
+    caip2?: string;
     vmType: string;
   };
 }): string | undefined;
@@ -3604,6 +3615,42 @@ declare const approveSpend: ({ sendTransaction, evmChainId, stablecoinAddress, s
   hash: string;
 }>;
 //#endregion
+//#region src/cards/statement-periods.d.ts
+type StatementMonth = {
+  /** `YYYY-MM`, the value the statement endpoint takes as its whole period. */
+  value: string;
+  /** Localized "August 2026", the value the user picks by. */
+  label: string;
+};
+/**
+ * The months this card can have a statement for, newest first. Empty when it can have none yet.
+ *
+ * Bounded at both ends, because a period the provider has no statement for is an error rather than
+ * an empty PDF:
+ *
+ * - **Newest.** Production only generates statements for complete months, so it starts at last
+ *   month; sandbox generates the current month so integrations can test without waiting for one to
+ *   close, so it starts there. Confirmed by Elvin, 2026-08-28.
+ * - **Oldest.** Stops at the month the card was issued — a period before the card existed has no
+ *   statement. The issue month itself is offered: a card issued mid-month has a statement for that
+ *   month once it closes.
+ *
+ * Every month is read in UTC, the frame `created_at` is already in, and each period is anchored on
+ * its 1st. Local months would make the bound depend on the viewer's offset: a card issued
+ * `2026-08-01T00:30Z` reads as July from UTC-5, which would offer a period from before the card
+ * existed — the failure this function exists to prevent. The 1st keeps subtracting a month from
+ * rolling over a shorter one (e.g. the 31st minus a month).
+ *
+ * @param cardCreatedAt When the card was issued.
+ * @param environment Which environment the card belongs to, which sets the newest month offered.
+ * @param now Override for the current date. Present so callers can test period boundaries.
+ */
+declare const buildRecentMonths: ({ cardCreatedAt, environment, now }: {
+  cardCreatedAt: Date;
+  environment: IntegrationEnvironment;
+  now?: Date;
+}) => StatementMonth[];
+//#endregion
 //#region src/cards/card-funding-source.d.ts
 /**
  * Funds a card can spend: its wallet's stablecoin, or its shares in an Earn vault. `selected` marks
@@ -4251,4 +4298,4 @@ declare const THIRDWEB: "thirdweb";
 /** @deprecated {@link SmartWalletType} is a well-typed union, use the `'nexus'` literal instead */
 declare const NEXUS: "nexus";
 //#endregion
-export { ALL_WALLET_CLIENT_TYPES, BICONOMY, COINBASE_SMART_WALLET, type CardFundingSource, type CardResponse, type CardSignUp, type CardSignUpEvmWallet, type CardSignUpHostedPage, type CardSignUpPlatform, type CardSignUpSpendApproval, type CardSignUpStep, type CardTransactionBadge, type CardTransactionRow, type CardsConfig, Cluster, type CoinbaseAssetId, CoinbaseWalletClientType, type CompletedDepositAddressOrder, ConnectedStandardSolanaWallet, ConnectorType, CookieWriteBehavior, type CountryCallingCode, type CountryCode, type CreateCryptoDepositAccountInput, type CreateCryptoDepositAccountResponse, type CreateSiwsMessageOpts, type CryptoDepositAccountConfig, type CryptoDepositAccountQuote, type CryptoDepositAccountQuoteInput, type CryptoDepositAccountSearchResult, type CryptoDepositAddressRoute, type CryptoDepositAddressStrategy, type CryptoDepositAsset, type CryptoDepositAssetFilter, DATA_SUFFIX_PLUGIN_ID, type DataSuffixPlugin, type DepositAddressOrder, type DepositAddressPollingResult, type DepositAddressQuote, type DepositConfig, type DevSpendApprovalTarget, type EIP1193Provider, type EmbeddedBitcoinWalletProvider, EmbeddedProviderError, EmbeddedWalletClientType, type EmbeddedWalletConfig, type EmbeddedWalletRecoveryOptions, type EntropyIdVerifier, type ErrorMessageMap, type EvmDevSpendApprovalTarget, ExternalWallet, ExternalWalletMetadata, FundingMethod, FundingProvider, type GenerateAuthorizationSignatureInput, type GenerateAuthorizationSignatureOutput, type GenerateDepositAddressInput, type GetCryptoDepositAccountNextOrderInput, type GetCryptoDepositAccountNextOrderResponse, type GetCryptoDepositAccountOrderInput, type GetCryptoDepositAccountOrderResponse, type GetDepositInput, IdentifierString, InMemoryCache, type IncompleteDepositAddressOrder, InjectedWalletClientType, KERNEL, LIGHT_ACCOUNT, LIST_CARDS_MAX_LIMIT, LocalStorage, type LogLevel, type Logger, type MfaMethod, type MfaPromise, type MfaSubmitArgs, type MfaSubmitPromise, MoonpayApiError, type MoonpayTransactionStatus, type MoonpayTransactionStatusResponse, NEXUS, type OAuthProviderID, OAuthProviderType, type OnNeedsRecovery, type ParsedSolanaOffchainMessage, PaymentOption, type PollOptions, type PollResult, type PreparedTransactionRequest, PrivyApiError, PrivyClientError, PrivyConnectorError, PrivyEmbeddedSolanaWalletProvider, PrivyEmbeddedWalletErrorCode, PrivyEmbeddedWalletProvider, type PrivyPlugin, PrivyProviderRpcError, ProviderErrors, type Quantity, type ResolveRefundAddressError, type ResolveRefundAddressResult, SAFE, SUPPORTED_CONNECTOR_TYPES, type SendSpendApproval, type SessionSignerInput, type SetRecoveryInput, SmartWalletType, SolanaClient, SolanaCluster, SolanaSignAndSendTransactionInput, SolanaSignAndSendTransactionMode, SolanaSignAndSendTransactionOptions, SolanaSignAndSendTransactionOutput, SolanaSignMessageInput, SolanaSignMessageOutput, SolanaSignTransactionInput, SolanaSignTransactionOptions, SolanaSignTransactionOutput, type SolanaSpendApprovalChain, SolanaStandardWallet, SolanaTransactionCommitment, SolanaUsdcAddressMap, type SpendApprovalConfig, type SpendApprovalProvider, type Storage, type SvmDevSpendApprovalTarget, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, type UpdateWalletInput, UsdcAddressMap, type WaitForCompletionInput, type WaitForDepositInput, WalletBranding, WalletClientType, WalletConnectWalletClientType, acceptCardConsents, addSessionSigners, approveSpend, buildSolanaOffchainMessage, chainToMoonpayCurrency, chooseTempoEarnVault, cookies, countryCodesAndNumbers, create, createCard, createCardSignUp, createDataSuffixPlugin, createErrorFormatter, createSiwsMessage, index_d_exports as crossApp, index_d_exports$1 as cryptoDepositAccount, Privy as default, index_d_exports$2 as delegatedActions, index_d_exports$3 as depositAddress, deriveSolanaApplicationDomain, downloadCardStatement, errorIndicatesMaxMfaRetries, errorIndicatesMfaCanceled, errorIndicatesMfaRateLimit, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, errorIndicatesRecoveryIsNeeded, formatLamportsAmount, formatPhoneNumber, formatSignedTransactionAmount, formatTokenAmount, formatTransactionDate, formatUsdAmount, formatWalletAddress, formatWeiAmount, fundingMethodToMoonpayPaymentMethod, generateAuthorizationSignature, generateWalletIdempotencyKey, getAllUserEmbeddedBitcoinWallets, getAllUserEmbeddedEthereumWallets, getAllUserEmbeddedSolanaWallets, getCardAssetDisplayName, getCardById, getCardCustomer, getCardDisclosure, getCardEphemeralKey, getCardsConfig, getCoinbaseOnRampUrl, getCountryCallingCode, getDataSuffixPlugin, getEntropyDetailsFromAccount, getEntropyDetailsFromUser, getFiatOnrampProviderBrand, getFiatOnrampProviderId, getIsTokenUsdc, getJsonRpcEndpointFromChain, getOrCreateCardCustomer, getPhoneCountryCodeAndNumber, getPlaceholderPhoneNumber, getSolanaClusterDisplayName, getSolanaRpcEndpointForCluster, getSolanaUsdcMintAddressForCluster, getSpendApproval, getTransactionBadge, getUserEmbeddedEthereumWallet, getUserEmbeddedSolanaWallet, getUserEmbeddedWallet, getUserSmartWallet, getWallet, getWalletAction, handleSignUpClose, isCardExpired, isEmbeddedWalletAccount, isExtensionContext, isSupportedChainIdForCoinbaseOnramp, isSupportedChainIdForMoonpay, isUnifiedWallet, lastFourDigits, listCardTransactions, listCards, listWalletActions, parseSolanaOffchainMessage, phoneNumberTypingFormatter, poll, rawSign, readSpendAllowance, readTempoEarnVault, removeSessionSigners, replaceCard, rpc, shouldWriteSessionCookies, throwIfInvalidRecoveryUpgradePath, toCoinbaseAssetId, toCoinbaseBlockchainFromChainId, toE164, toObjectKeys, toTransactionRow, toWalletApiUnsignedEthTransaction, transfer, updateCardPin, updateCardStatus, updateWallet, validatePhoneNumber };
+export { ALL_WALLET_CLIENT_TYPES, BICONOMY, COINBASE_SMART_WALLET, type CardFundingSource, type CardResponse, type CardSignUp, type CardSignUpEvmWallet, type CardSignUpHostedPage, type CardSignUpPlatform, type CardSignUpSpendApproval, type CardSignUpStep, type CardTransactionBadge, type CardTransactionRow, type CardsConfig, Cluster, type CoinbaseAssetId, CoinbaseWalletClientType, type CompletedDepositAddressOrder, ConnectedStandardSolanaWallet, ConnectorType, CookieWriteBehavior, type CountryCallingCode, type CountryCode, type CreateCryptoDepositAccountInput, type CreateCryptoDepositAccountResponse, type CreateSiwsMessageOpts, type CryptoDepositAccountConfig, type CryptoDepositAccountQuote, type CryptoDepositAccountQuoteInput, type CryptoDepositAccountSearchResult, type CryptoDepositAddressRoute, type CryptoDepositAddressStrategy, type CryptoDepositAsset, type CryptoDepositAssetFilter, DATA_SUFFIX_PLUGIN_ID, type DataSuffixPlugin, type DepositAddressOrder, type DepositAddressPollingResult, type DepositAddressQuote, type DepositConfig, type DevSpendApprovalTarget, type EIP1193Provider, type EmbeddedBitcoinWalletProvider, EmbeddedProviderError, EmbeddedWalletClientType, type EmbeddedWalletConfig, type EmbeddedWalletRecoveryOptions, type EntropyIdVerifier, type ErrorMessageMap, type EvmDevSpendApprovalTarget, ExternalWallet, ExternalWalletMetadata, FundingMethod, FundingProvider, type GenerateAuthorizationSignatureInput, type GenerateAuthorizationSignatureOutput, type GenerateDepositAddressInput, type GetCryptoDepositAccountNextOrderInput, type GetCryptoDepositAccountNextOrderResponse, type GetCryptoDepositAccountOrderInput, type GetCryptoDepositAccountOrderResponse, type GetDepositInput, IdentifierString, InMemoryCache, type IncompleteDepositAddressOrder, InjectedWalletClientType, KERNEL, LIGHT_ACCOUNT, LIST_CARDS_MAX_LIMIT, LocalStorage, type LogLevel, type Logger, type MfaMethod, type MfaPromise, type MfaSubmitArgs, type MfaSubmitPromise, MoonpayApiError, type MoonpayTransactionStatus, type MoonpayTransactionStatusResponse, NEXUS, type OAuthProviderID, OAuthProviderType, type OnNeedsRecovery, type ParsedSolanaOffchainMessage, PaymentOption, type PollOptions, type PollResult, type PreparedTransactionRequest, PrivyApiError, PrivyClientError, PrivyConnectorError, PrivyEmbeddedSolanaWalletProvider, PrivyEmbeddedWalletErrorCode, PrivyEmbeddedWalletProvider, type PrivyPlugin, PrivyProviderRpcError, ProviderErrors, type Quantity, type ResolveRefundAddressError, type ResolveRefundAddressResult, SAFE, SUPPORTED_CONNECTOR_TYPES, type SendSpendApproval, type SessionSignerInput, type SetRecoveryInput, SmartWalletType, SolanaClient, SolanaCluster, SolanaSignAndSendTransactionInput, SolanaSignAndSendTransactionMode, SolanaSignAndSendTransactionOptions, SolanaSignAndSendTransactionOutput, SolanaSignMessageInput, SolanaSignMessageOutput, SolanaSignTransactionInput, SolanaSignTransactionOptions, SolanaSignTransactionOutput, type SolanaSpendApprovalChain, SolanaStandardWallet, SolanaTransactionCommitment, SolanaUsdcAddressMap, type SpendApprovalConfig, type SpendApprovalProvider, type StatementMonth, type Storage, type SvmDevSpendApprovalTarget, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, type UpdateWalletInput, UsdcAddressMap, type WaitForCompletionInput, type WaitForDepositInput, WalletBranding, WalletClientType, WalletConnectWalletClientType, acceptCardConsents, addSessionSigners, approveSpend, buildRecentMonths, buildSolanaOffchainMessage, chainToMoonpayCurrency, chooseTempoEarnVault, cookies, countryCodesAndNumbers, create, createCard, createCardSignUp, createDataSuffixPlugin, createErrorFormatter, createSiwsMessage, index_d_exports as crossApp, index_d_exports$1 as cryptoDepositAccount, Privy as default, index_d_exports$2 as delegatedActions, index_d_exports$3 as depositAddress, deriveSolanaApplicationDomain, downloadCardStatement, errorIndicatesMaxMfaRetries, errorIndicatesMfaCanceled, errorIndicatesMfaRateLimit, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, errorIndicatesRecoveryIsNeeded, formatLamportsAmount, formatPhoneNumber, formatSignedTransactionAmount, formatTokenAmount, formatTransactionDate, formatUsdAmount, formatWalletAddress, formatWeiAmount, fundingMethodToMoonpayPaymentMethod, generateAuthorizationSignature, generateWalletIdempotencyKey, getAllUserEmbeddedBitcoinWallets, getAllUserEmbeddedEthereumWallets, getAllUserEmbeddedSolanaWallets, getCardAssetDisplayName, getCardById, getCardCustomer, getCardDisclosure, getCardEphemeralKey, getCardsConfig, getCoinbaseOnRampUrl, getCountryCallingCode, getDataSuffixPlugin, getEntropyDetailsFromAccount, getEntropyDetailsFromUser, getFiatOnrampProviderBrand, getFiatOnrampProviderId, getIsTokenUsdc, getJsonRpcEndpointFromChain, getOrCreateCardCustomer, getPhoneCountryCodeAndNumber, getPlaceholderPhoneNumber, getSolanaClusterDisplayName, getSolanaRpcEndpointForCluster, getSolanaUsdcMintAddressForCluster, getSpendApproval, getTransactionBadge, getUserEmbeddedEthereumWallet, getUserEmbeddedSolanaWallet, getUserEmbeddedWallet, getUserSmartWallet, getWallet, getWalletAction, handleSignUpClose, isCardExpired, isEmbeddedWalletAccount, isExtensionContext, isSupportedChainIdForCoinbaseOnramp, isSupportedChainIdForMoonpay, isUnifiedWallet, lastFourDigits, listCardTransactions, listCards, listWalletActions, parseSolanaOffchainMessage, phoneNumberTypingFormatter, poll, rawSign, readSpendAllowance, readTempoEarnVault, removeSessionSigners, replaceCard, rpc, shouldWriteSessionCookies, throwIfInvalidRecoveryUpgradePath, toCoinbaseAssetId, toCoinbaseBlockchainFromChainId, toE164, toObjectKeys, toTransactionRow, toWalletApiUnsignedEthTransaction, transfer, updateCardPin, updateCardStatus, updateWallet, validatePhoneNumber };