@privy-io/js-sdk-core 0.78.1 → 0.78.3

package/dist/dts/index.d.mts

@@ -1,6 +1,6 @@
-import { AuthenticatedUser, CardIssuingCardResponse, CardIssuingCardStatus, CardIssuingCardsResponse, CardIssuingCustomerResponse, CardIssuingReplacementReason, CardIssuingTransactionsResponse, CoinbaseOnRampInitInput, CoinbaseOnRampInitResponse, CreateCryptoDepositAccountResponse, CryptoDepositAccountConfigResponse, CryptoDepositAddressRoute, CryptoDepositAddressStrategy, CryptoDepositAsset, CryptoDepositAssetFilter, DepositAccountCryptoQuoteResponse, GetCryptoDepositAccountNextOrderResponse, GetCryptoDepositAccountOrderResponse, IntegrationEnvironment, LinkedAccount, LinkedAccountBitcoinSegwitEmbeddedWallet, LinkedAccountBitcoinTaprootEmbeddedWallet, LinkedAccountEmbeddedWallet, LinkedAccountEmbeddedWalletWithID, LinkedAccountEthereumEmbeddedWallet, LinkedAccountSmartWallet, LinkedAccountSolanaEmbeddedWallet, MfaPasskeyInitRequestBody, MfaSMSInitRequestBody, MoonpayOnRampSignInput, OAuthProviderID, OAuthProviderID as OAuthProviderID$1, OAuthTokens, PasskeyAuthenticatorVerifyResponse, RawSignResponse, SmartWalletConfiguration, SmartWalletType as SmartWalletType$1, TransferRequestBody, UnsignedEthereumTransaction, User, Wallet, WalletCreateParams, WalletRawSignParams, WalletRpcParams, WalletRpcResponse, WalletUpdateParams, Wallets } from "@privy-io/api-types";
+import { AuthenticatedUser, CardIssuingBankInfo, CardIssuingCardResponse, CardIssuingCardStatus, CardIssuingCardsResponse, CardIssuingCustomerResponse, CardIssuingReplacementReason, CardIssuingTransactionResponse, CardIssuingTransactionStatus, CardIssuingTransactionsResponse, CoinbaseOnRampInitInput, CoinbaseOnRampInitResponse, CreateCryptoDepositAccountResponse, CryptoDepositAccountConfigResponse, CryptoDepositAddressRoute, CryptoDepositAddressStrategy, CryptoDepositAsset, CryptoDepositAssetFilter, DepositAccountCryptoQuoteResponse, GetCryptoDepositAccountNextOrderResponse, GetCryptoDepositAccountOrderResponse, IntegrationEnvironment, LinkedAccount, LinkedAccountBitcoinSegwitEmbeddedWallet, LinkedAccountBitcoinTaprootEmbeddedWallet, LinkedAccountEmbeddedWallet, LinkedAccountEmbeddedWalletWithID, LinkedAccountEthereumEmbeddedWallet, LinkedAccountSmartWallet, LinkedAccountSolanaEmbeddedWallet, MfaPasskeyInitRequestBody, MfaSMSInitRequestBody, MoonpayOnRampSignInput, OAuthProviderID, OAuthProviderID as OAuthProviderID$1, OAuthTokens, PasskeyAuthenticatorVerifyResponse, RawSignResponse, SmartWalletConfiguration, SmartWalletType as SmartWalletType$1, TransferRequestBody, UnsignedEthereumTransaction, User, Wallet, WalletCreateParams, WalletRawSignParams, WalletRpcParams, WalletRpcResponse, WalletUpdateParams, Wallets } from "@privy-io/api-types";
 import { Chain, RpcConfig } from "@privy-io/chains";
-import { Route } from "@privy-io/routes";
+import { CryptoDepositAccountConfigSearchResponse, Route } from "@privy-io/routes";
 import "@metamask/eth-sig-util";
 import "viem/account-abstraction";
 import { StrictUnsignedTempoTransactionRequest, StrictUnsignedTransactionRequest } from "@privy-io/ethereum";
@@ -2983,9 +2983,9 @@ interface SendTransactionOutput {
 /**
  * Requests a cross-app wallet to send a transaction, returning the resulting transaction hash.
  */
-declare const sendTransaction: ({ client, openAuthSession }: SendTransactionDependencies) => ({ user, transaction, address, redirectUrl }: SendTransactionInput) => Promise<SendTransactionOutput>;
+declare const sendTransaction$1: ({ client, openAuthSession }: SendTransactionDependencies) => ({ user, transaction, address, redirectUrl }: SendTransactionInput) => Promise<SendTransactionOutput>;
 declare namespace index_d_exports$4 {
-  export { SendTransactionDependencies, SendTransactionInput, SendTransactionOutput, SignMessageDependencies, SignMessageInput, SignMessageOutput, SignTypedDataDependencies, SignTypedDataInput, SignTypedDataOutput, sendTransaction, signMessage, signTypedData };
+  export { SendTransactionDependencies, SendTransactionInput, SendTransactionOutput, SignMessageDependencies, SignMessageInput, SignMessageOutput, SignTypedDataDependencies, SignTypedDataInput, SignTypedDataOutput, sendTransaction$1 as sendTransaction, signMessage, signTypedData };
 }
 declare namespace index_d_exports {
   export { LinkWithCrossAppAuthDependencies, LinkWithCrossAppAuthInput, LinkWithCrossAppAuthOutput, LoginWithCrossAppAuthDependencies, LoginWithCrossAppAuthInput, LoginWithCrossAppAuthOutput, linkWithCrossAppAuth, loginWithCrossAppAuth, index_d_exports$4 as wallet };
@@ -3123,6 +3123,7 @@ declare function getConfig(privy: Privy): Promise<DepositConfig>;
 //#endregion
 //#region src/action/cryptoDepositAccount/types.d.ts
 type CryptoDepositAccountConfig = CryptoDepositAccountConfigResponse;
+type CryptoDepositAccountSearchResult = CryptoDepositAccountConfigSearchResponse;
 type CryptoDepositAccountQuote = DepositAccountCryptoQuoteResponse;
 type CreateCryptoDepositAccountWithConfigInput = {
   walletId: string;
@@ -3209,6 +3210,10 @@ declare function getCryptoDepositAccountQuote(privy: Pick<Privy, 'fetchPrivyRout
 /** Conversion rate as dest-per-source, or undefined when the quote amounts are not usable. */
 declare function indicativeRateFromQuote(quote: CryptoDepositAccountQuote): string | undefined;
 //#endregion
+//#region src/action/cryptoDepositAccount/search.d.ts
+/** Search deposit-account source tokens by symbol, name, or contract address. */
+declare function searchCryptoDepositAccountConfig(privy: Pick<Privy, 'fetchPrivyRoute'>, query: string): Promise<CryptoDepositAccountSearchResult>;
+//#endregion
 //#region src/action/cryptoDepositAccount/orders.d.ts
 /** Fetches a crypto deposit-account sweep by wallet action ID. */
 declare function getCryptoDepositAccountOrder(privy: Pick<Privy, 'fetchPrivyRoute'>, input: GetCryptoDepositAccountOrderInput): Promise<GetCryptoDepositAccountOrderResponse>;
@@ -3260,7 +3265,7 @@ declare function findCatalogSymbol({ config, chain, asset }: {
   asset: string;
 }): string;
 declare namespace index_d_exports$1 {
-  export { CreateCryptoDepositAccountInput, CreateCryptoDepositAccountResponse, CreateCryptoDepositAccountWithConfigInput, CreateCryptoDepositAccountWithRouteInput, CryptoDepositAccountConfig, CryptoDepositAccountQuote, CryptoDepositAccountQuoteInput, CryptoDepositAddressRoute, CryptoDepositAddressStrategy, CryptoDepositAsset, CryptoDepositAssetFilter, GetCryptoDepositAccountNextOrderInput, GetCryptoDepositAccountNextOrderResponse, GetCryptoDepositAccountOrderInput, GetCryptoDepositAccountOrderResponse, createCryptoDepositAccount, filterDepositConfig, findCatalogSymbol, getCryptoDepositAccountNextOrder, getCryptoDepositAccountOrder, getCryptoDepositAccountQuote, indicativeRateFromQuote, isNativeAssetAlias, pickDepositAddressForChain, quoteSourceAsset, resolveChainAlias };
+  export { CreateCryptoDepositAccountInput, CreateCryptoDepositAccountResponse, CreateCryptoDepositAccountWithConfigInput, CreateCryptoDepositAccountWithRouteInput, CryptoDepositAccountConfig, CryptoDepositAccountQuote, CryptoDepositAccountQuoteInput, CryptoDepositAccountSearchResult, CryptoDepositAddressRoute, CryptoDepositAddressStrategy, CryptoDepositAsset, CryptoDepositAssetFilter, GetCryptoDepositAccountNextOrderInput, GetCryptoDepositAccountNextOrderResponse, GetCryptoDepositAccountOrderInput, GetCryptoDepositAccountOrderResponse, createCryptoDepositAccount, filterDepositConfig, findCatalogSymbol, getCryptoDepositAccountNextOrder, getCryptoDepositAccountOrder, getCryptoDepositAccountQuote, indicativeRateFromQuote, isNativeAssetAlias, pickDepositAddressForChain, quoteSourceAsset, resolveChainAlias, searchCryptoDepositAccountConfig };
 }
 //#endregion
 //#region src/wallet-api/generate-authorization-signature.d.ts
@@ -3553,6 +3558,294 @@ declare const acceptCardConsents: (client: Privy, { environment, acceptElectroni
   acceptBankTerms?: boolean;
 }) => Promise<CardIssuingCustomerResponse['data']>;
 //#endregion
+//#region src/cards/send-spend-approval.d.ts
+/**
+ * Sends the approval from the funding wallet, through the gas sponsorship policy when `sponsor` is
+ * set and paid by the wallet otherwise.
+ */
+type SendSpendApproval = (transaction: {
+  to: string;
+  chainId: number;
+  data: `0x${string}`;
+}, options: {
+  sponsor: boolean;
+}) => Promise<{
+  hash: string;
+}>;
+//#endregion
+//#region src/cards/approve-spend.d.ts
+/**
+ * Grants the spender an unlimited (`maxUint256`) allowance from the funding wallet, letting the card
+ * spend the wallet's balance. Resolves with the approval transaction hash. `sendTransaction` is
+ * called before anything is awaited, so a send from a user's tap stays inside that gesture.
+ *
+ * ##CardApprovalNeedsGas: the approval is the funding wallet's first transaction, so it typically
+ * holds no native gas token — only the stablecoin the card spends. The send is therefore attempted
+ * sponsored first, so the app's gas sponsorship policy covers the fee, and falls back to a pre-funded
+ * send (where the wallet pays) on any sponsored failure.
+ *
+ * The fallback keeps the approval working for an app that has not configured gas sponsorship for the
+ * card's chain — the backend rejects a sponsored send outright in that case (`Gas sponsorship is not
+ * enabled.` / `... not configured for chain <caip2>`, and `App secret is required ...` when the app's
+ * sponsorship config sets `requireAppSecret`, which a client-side call cannot satisfy) rather than
+ * degrading to an unsponsored send. It also leaves the pre-funded path testable against a wallet that
+ * does hold gas. Only if both attempts fail does this reject; a gasless wallet then fails with
+ * `insufficient funds for gas * price + value`, which the onboarding flow surfaces as the generic
+ * approve-error step.
+ */
+declare const approveSpend: ({ sendTransaction, evmChainId, stablecoinAddress, spenderAddress }: {
+  sendTransaction: SendSpendApproval;
+  evmChainId: number;
+  stablecoinAddress: string;
+  spenderAddress: string;
+}) => Promise<{
+  hash: string;
+}>;
+//#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
+ * what the card spends now.
+ */
+type CardFundingSource = {
+  type: 'wallet';
+  selected: boolean;
+} | {
+  type: 'erc4626_vault';
+  selected: boolean;
+  provider: 'morpho' | 'aave';
+  spender_address: string;
+  /** An ERC-4626 vault, which is its own share token. */
+  share_token_address: string;
+} | {
+  type: 'tempo_earn_vault';
+  selected: boolean;
+  spender_address: string;
+  share_token_address: string;
+  vault_address: string;
+  /** The vault's underlying token, which is the card's stablecoin. */
+  asset_address: string;
+};
+//#endregion
+//#region src/cards/card-response.d.ts
+/** A card, with what it can spend from. */
+type CardResponse = CardIssuingCardResponse & {
+  /**
+   * What the card can spend from. At most one entry is `selected`, and none only when a Tempo Earn
+   * wallet picked a vault outside the app's Earn vaults. Absent from backends that don't list them.
+   */
+  funding_sources?: CardFundingSource[];
+};
+//#endregion
+//#region src/cards/card-sign-up.d.ts
+/**
+ * The actions each sign-up screen triggers. Every action takes the open flow's signal: closing the
+ * flow aborts it so in-flight polls and advances stop. Requests can't be cancelled mid-flight, so the
+ * signal only marks a late response unwanted so it never overwrites current state.
+ */
+type CardSignUp = {
+  /**
+   * Initial read. Every non-terminal status shows the get-started checklist -- onboarding only
+   * advances once the user starts it, so a returning, already-`ready` user still sees get-started
+   * first rather than jumping into the approval. Only `under_review`, `rejected`, and `error` are
+   * shown directly, and a failed read surfaces the error screen.
+   */
+  load(signal: AbortSignal): Promise<void>;
+  /** Begins onboarding: get-or-create the customer, then show the first required prompt. */
+  start(signal: AbortSignal): void;
+  /** Records the electronic disclosure acceptance from the `disclosure-prompt` step. */
+  acceptDisclosure(signal: AbortSignal): void;
+  /**
+   * Records the bank agreements acceptance from the `bank-terms-prompt` step, then opens the
+   * provider terms. Must be called from the user's tap so a browser does not block the page.
+   */
+  acceptBankTerms(signal: AbortSignal): void;
+  /**
+   * Opens the hosted page for the current `*-prompt` step (KYC, or the provider-terms fallback) and
+   * polls until it completes. Must be called from the user's tap.
+   */
+  proceed(signal: AbortSignal): void;
+  /**
+   * Sends the spend approval from the `approve-prompt` step, and retries it from `approve-error`,
+   * where it first checks whether the earlier send landed. Must be called from the user's tap so a
+   * wallet confirmation is not blocked. A Tempo Earn card opting into Earn then waits for the
+   * approval to land and picks the vault on the spender.
+   */
+  approve(signal: AbortSignal): void;
+  /** Re-reads customer state, used to recover from a terminal `error`. */
+  retry(signal: AbortSignal): void;
+};
+//#endregion
+//#region src/cards/spend-approval-provider.d.ts
+/** The EIP-1193 surface the allowance read uses, so any wallet's provider can be passed as is. */
+type SpendApprovalProvider = {
+  request(args: {
+    method: string;
+    params?: unknown[];
+  }): Promise<unknown>;
+};
+//#endregion
+//#region src/cards/card-sign-up-evm-wallet.d.ts
+/**
+ * The card's funding wallet on an EVM chain, for the approvals card sign-up sends itself.
+ */
+type CardSignUpEvmWallet = {
+  address: `0x${string}`;
+  /** The wallet's provider, which reads go through. */
+  getProvider(): Promise<SpendApprovalProvider>;
+  /**
+   * Sends from the wallet without a confirmation screen, since sign-up's own button gates it. That
+   * also lets a Tempo Earn vault pick go out after the tap's gesture has passed.
+   */
+  sendTransaction: SendSpendApproval;
+};
+//#endregion
+//#region src/cards/card-sign-up-hosted-page.d.ts
+/**
+ * A provider-hosted page (Bridge terms or KYC) open for the current step. Bridge and Persona refuse
+ * to be framed, so each platform opens these in its own browser surface.
+ */
+type CardSignUpHostedPage = {
+  /** Points the page at `url`, for a page opened before its URL was known. */
+  navigate(url: string): void;
+  /** Whether the user has left the page. */
+  isClosed(): boolean;
+  /** Closes the page where the platform allows it. */
+  dismiss(): void;
+};
+//#endregion
+//#region src/cards/card-sign-up-spend-approval.d.ts
+/**
+ * The spend approval for the card's chain, or why there is none.
+ */
+type CardSignUpSpendApproval = {
+  kind: 'unsupported';
+  /** Shown on the error screen. With none, the screen shows its generic error. */
+  reason?: string;
+} | {
+  kind: 'supported';
+  /** Whether the funding wallet has already approved spending. */
+  isApproved(): Promise<boolean>;
+  /**
+   * Sends the approval. A first attempt calls it with nothing awaited first, so it runs inside
+   * the user's tap.
+   */
+  approve(): Promise<void>;
+};
+//#endregion
+//#region src/cards/card-sign-up-step.d.ts
+/**
+ * The screen card sign-up renders. Derived from the cards customer `status` plus, once `ready`,
+ * whether a card already exists and whether the funding wallet has approved spending. The `*-prompt`
+ * steps ask the user to act (accept a Privy agreement, open a provider page, sign an approval); the
+ * matching in-progress step is set once that action is underway. The disclosure and bank-terms
+ * prompts carry the copy the backend serves for them. `ready` is the final success step. It,
+ * `approve-error`, and an `error` reached once the card exists carry the card's id, so closing still
+ * hands the card back.
+ */
+type CardSignUpStep = {
+  status: 'loading';
+} | {
+  status: 'get-started';
+  pending?: boolean;
+} | {
+  status: 'disclosure-prompt';
+  disclosureUrl: string;
+} | {
+  status: 'accepting-disclosure';
+} | {
+  status: 'bank-terms-prompt';
+  bankInfo: CardIssuingBankInfo;
+} | {
+  status: 'accepting-bank-terms';
+} | {
+  status: 'provider-terms-prompt';
+  pending?: boolean;
+} | {
+  status: 'accepting-provider-terms';
+} | {
+  status: 'kyc-prompt';
+  pending?: boolean;
+} | {
+  status: 'verifying-identity';
+} | {
+  status: 'pending';
+} | {
+  status: 'under-review';
+} | {
+  status: 'creating-card';
+} | {
+  status: 'approve-prompt';
+  pending?: boolean;
+  /** The Earn provider's name when the card spends a vault's shares, or null for the stablecoin. */
+  vaultProvider: string | null;
+} | {
+  status: 'approve-error';
+  cardId: string;
+} | {
+  status: 'ready';
+  cardId: string;
+} | {
+  status: 'rejected';
+  reason?: string;
+} | {
+  status: 'error';
+  message?: string;
+  cardId?: string;
+};
+//#endregion
+//#region src/cards/card-sign-up-platform.d.ts
+/**
+ * What card sign-up needs from the platform it runs on.
+ */
+type CardSignUpPlatform = {
+  /**
+   * Opens a hosted page, at `url` when it is known. Called from the user's tap with nothing awaited
+   * first, so a browser can open its popup inside the gesture. Returns `null` when it could not
+   * open one.
+   */
+  openHostedPage(url?: string): CardSignUpHostedPage | null;
+  /**
+   * The spend approval for the card's chain. Synchronous so the approval send starts inside the
+   * user's tap. Throws when the funding wallet can't be resolved.
+   */
+  resolveSpendApproval(): CardSignUpSpendApproval;
+  /**
+   * The funding wallet on the card's EVM chain, which approves a vault card's share token instead of
+   * the chain's stablecoin, and picks a Tempo Earn vault for a wallet opting into Earn. Synchronous
+   * like `resolveSpendApproval`, and throws the same way.
+   */
+  resolveEvmWallet(): CardSignUpEvmWallet;
+  /** Shows a step. */
+  setStep(step: CardSignUpStep): void;
+};
+//#endregion
+//#region src/cards/card-transaction-badge.d.ts
+/** Which badge a transaction row carries. Each UI names and colors it. */
+type CardTransactionBadge = 'credit' | 'pending' | 'declined' | 'expired' | 'reversed';
+//#endregion
+//#region src/cards/card-transaction-row.d.ts
+/**
+ * One card activity row: the fields a row renders, with the merchant name resolved, plus the ones a
+ * row's details screen reads.
+ */
+type CardTransactionRow = {
+  id: string;
+  /** USD cents (#CardAmountUsdCents). Sign carries direction on `posted` rows only. */
+  amount: number;
+  merchant: {
+    name: string;
+  };
+  status: CardIssuingTransactionStatus;
+  created: number;
+  /**
+   * Carried through, but not what the amount is rendered as: rows read every amount as USD cents
+   * (#CardAmountUsdCents). Card activity is USD-only today, so the two cannot disagree yet.
+   */
+  currency: string;
+  dispute: CardIssuingTransactionResponse['dispute'];
+};
+//#endregion
 //#region src/cards/cards-config.d.ts
 /** Browser-safe card-issuing configuration. */
 type CardsConfig = {
@@ -3563,6 +3856,22 @@ type CardsConfig = {
   stripeAccount?: string;
 };
 //#endregion
+//#region src/cards/choose-tempo-earn-vault.d.ts
+/**
+ * Has the funding wallet choose `vaultAddress` on a Tempo Earn spender, so the card spends the
+ * vault's shares instead of the stablecoin, or the zero address to spend the stablecoin again. The
+ * spender reverts unless Bridge has allowlisted the vault. Sent like `approveSpend`: sponsored
+ * first since the wallet may hold no gas, then paid by the wallet if that fails.
+ */
+declare const chooseTempoEarnVault: ({ sendTransaction, evmChainId, spenderAddress, vaultAddress }: {
+  sendTransaction: SendSpendApproval;
+  evmChainId: number;
+  spenderAddress: string;
+  vaultAddress: string;
+}) => Promise<{
+  hash: string;
+}>;
+//#endregion
 //#region src/cards/create-card.d.ts
 /**
  * Creates the virtual card for a wallet, returning the new card. Only valid once the cards
@@ -3577,6 +3886,73 @@ declare const createCard: (client: Privy, { environment, walletId, chainId, asse
   asset: string;
 }) => Promise<CardIssuingCardResponse>;
 //#endregion
+//#region src/cards/create-card-sign-up.d.ts
+/**
+ * Card sign-up: drives the pre-card journey (accept terms -> KYC -> create card -> approve spending)
+ * off the cards customer status, ending in a `ready` step that carries the created card's id. The
+ * React and React Native SDKs run the same flow and supply the platform pieces.
+ */
+declare const createCardSignUp: ({ client, environment, walletId, chainId, asset, platform }: {
+  client: Privy;
+  environment: IntegrationEnvironment;
+  /** Wallet the card is created for. */
+  walletId: string;
+  /** CAIP-2 chain the card funds from. */
+  chainId: string;
+  /** Asset forwarded to card creation, e.g. `'usdc'`, `'pathusd'`, or `'ousd'`. */
+  asset: string;
+  platform: CardSignUpPlatform;
+}) => CardSignUp;
+//#endregion
+//#region src/cards/evm-dev-spend-approval-target.d.ts
+/**
+ * EVM card approval target: the stablecoin ERC-20 contract and the Bridge spender the funding wallet
+ * grants an allowance to. Supplied as the `spendApproval` option when the card's `chainId` is `eip155:*`.
+ *
+ * @experimental This interface may change in a minor version.
+ */
+type EvmDevSpendApprovalTarget = {
+  /** ERC-20 stablecoin contract (USDC on the built-in testnets) the allowance is set on. */
+  stablecoinAddress: string;
+  /** Bridge spender contract the allowance is granted to. */
+  spenderAddress: string;
+};
+//#endregion
+//#region src/cards/svm-dev-spend-approval-target.d.ts
+/**
+ * SVM card approval target: the stablecoin mint and the Bridge card program (with its merchant id)
+ * that owns the per-user delegate PDA. Supplied as the `spendApproval` option when the card's `chainId`
+ * is `solana:*`.
+ *
+ * @experimental This interface may change in a minor version.
+ */
+type SvmDevSpendApprovalTarget = {
+  /**
+   * SPL stablecoin mint (USDC on the built-in devnet) the delegation source ATA holds. The Solana
+   * OUSD mint uses Token-2022. Other mints use the classic SPL Token program.
+   */
+  stablecoinAddress: string;
+  /** Bridge card program that owns the delegate PDA. */
+  programId: string;
+  /**
+   * Bridge merchant id, an LE u64 seed of the delegate PDA. Accepts a `number`, decimal `string`, or
+   * `bigint` so it can be supplied from JSON/env config (a `bigint` literal is not JSON-serializable);
+   * {@link getSpendApproval} normalizes it to a `bigint` before use.
+   */
+  merchantId: number | string | bigint;
+};
+//#endregion
+//#region src/cards/dev-spend-approval-target.d.ts
+/**
+ * The card spend-approval target for the chain a card is onboarded on — an {@link
+ * EvmDevSpendApprovalTarget} for an `eip155:*` chain or an {@link SvmDevSpendApprovalTarget} for a
+ * `solana:*` chain. {@link getSpendApproval} resolves its shape against the card's `chainId`.
+ * Production environments require this target because Bridge does not publish the mainnet targets.
+ *
+ * @experimental This interface may change in a minor version.
+ */
+type DevSpendApprovalTarget = EvmDevSpendApprovalTarget | SvmDevSpendApprovalTarget;
+//#endregion
 //#region src/cards/download-card-statement.d.ts
 /**
  * Fetches one month's card statement as a PDF blob.
@@ -3590,6 +3966,37 @@ declare const downloadCardStatement: (client: Privy, { cardId, environment, stat
   statementPeriod: string;
 }) => Promise<Blob>;
 //#endregion
+//#region src/cards/format-signed-transaction-amount.d.ts
+/**
+ * Signed amount plus whether it reads as a credit (which colors it). Direction follows
+ * #CardAmountSignByStatus; magnitude is {@link formatUsdAmount}, so `- -$1` never happens. Takes a
+ * bare `{amount, status}` so a list row and a detail view share one signer off different shapes.
+ */
+declare const formatSignedTransactionAmount: ({ amount, status }: {
+  amount: number;
+  status: CardIssuingTransactionStatus;
+}) => {
+  text: string;
+  isCredit: boolean;
+};
+//#endregion
+//#region src/cards/format-transaction-date.d.ts
+/** Timestamp in the runtime's locale and time zone. Year shown only outside the current one. */
+declare const formatTransactionDate: ({ unixSeconds }: {
+  unixSeconds: number;
+}) => string;
+//#endregion
+//#region src/cards/format-usd-amount.d.ts
+/**
+ * Unsigned USD magnitude of a cent amount: `-4703` and `4703` both format `$47.03`. Non-finite
+ * input -> `''`, like the amount cell.
+ */
+declare const formatUsdAmount: (cents: number) => string;
+//#endregion
+//#region src/cards/get-card-asset-display-name.d.ts
+/** Display name for a card asset id (`usdc` → `USDC`, `pathusd` → `PathUSD`, `ousd` → `OUSD`). */
+declare const getCardAssetDisplayName: (asset: string | null | undefined) => string;
+//#endregion
 //#region src/cards/get-card-by-id.d.ts
 /**
  * One card by id, or null when it is not among the user's first {@link LIST_CARDS_MAX_LIMIT}.
@@ -3604,7 +4011,7 @@ declare const downloadCardStatement: (client: Privy, { cardId, environment, stat
 declare const getCardById: (client: Privy, { cardId, environment }: {
   cardId: string;
   environment: IntegrationEnvironment;
-}) => Promise<CardIssuingCardResponse | null>;
+}) => Promise<CardResponse | null>;
 //#endregion
 //#region src/cards/get-card-customer.d.ts
 /**
@@ -3616,6 +4023,14 @@ declare const getCardCustomer: (client: Privy, { environment }: {
   environment: IntegrationEnvironment;
 }) => Promise<CardIssuingCustomerResponse['data']>;
 //#endregion
+//#region src/cards/get-card-disclosure.d.ts
+/**
+ * The card program's regulatory disclosure, shown below a card's activity. The copy is fixed
+ * regulatory text; the Platform Provider it names is the app, which should pass its legal entity
+ * name when it has one.
+ */
+declare const getCardDisclosure: (platformProviderName: string) => string;
+//#endregion
 //#region src/cards/get-card-ephemeral-key.d.ts
 /**
  * Mints a single-use Stripe ephemeral key for revealing one card's sensitive fields.
@@ -3650,6 +4065,79 @@ declare const getOrCreateCardCustomer: (client: Privy, { environment }: {
   environment: IntegrationEnvironment;
 }) => Promise<CardIssuingCustomerResponse['data']>;
 //#endregion
+//#region src/cards/solana-spend-approval-chain.d.ts
+/** Solana chains with card spend-approval support. */
+type SolanaSpendApprovalChain = 'solana:mainnet' | 'solana:devnet';
+//#endregion
+//#region src/cards/spend-approval-config.d.ts
+type EvmSpendApprovalConfig = {
+  kind: 'evm';
+} & EvmDevSpendApprovalTarget;
+type ResolvedSvmSpendApprovalTarget = Omit<SvmDevSpendApprovalTarget, 'merchantId'> & {
+  /** Normalized from the target's `number | string | bigint` by {@link getSpendApproval}. */
+  merchantId: bigint;
+};
+type SvmSpendApprovalConfig = ResolvedSvmSpendApprovalTarget & {
+  kind: 'svm';
+  chain: SolanaSpendApprovalChain;
+};
+/**
+ * A {@link DevSpendApprovalTarget} resolved for a specific chain — the target's own fields plus the
+ * `kind` discriminant (inferred from the CAIP-2 key) and, for SVM, the resolved Solana `chain` alias.
+ * {@link getSpendApproval} returns this (or `null` when no target is configured, which the onboarding
+ * flow treats as unsupported rather than approvable); the approve/read helpers consume its fields.
+ */
+type SpendApprovalConfig = EvmSpendApprovalConfig | SvmSpendApprovalConfig;
+//#endregion
+//#region src/cards/get-spend-approval.d.ts
+/**
+ * Resolves the spend-approval config for a CAIP-2 chain, or `null` when there is nothing to approve.
+ * Uses the developer-supplied `spendApproval` target (required for production) when given, otherwise
+ * the built-in sandbox target for a testnet/devnet chain. That built-in target follows `asset` on
+ * Tempo Moderato, where `ousd` approves OUSD instead of PathUSD. A chain with neither — and a
+ * supplied target whose shape doesn't match the chain — resolves to `null`, which the
+ * onboarding flow surfaces as an unsupported-network error rather than reporting a card that can never
+ * spend.
+ *
+ * EVM vs SVM is inferred from the `chainId` namespace, not a field on the target: a `solana:*` chain
+ * with a recognized cluster resolves to SVM (adding the resolved `chain` alias), an `eip155:*` chain
+ * to EVM. A target whose shape doesn't match the chain's namespace is treated as unsupported.
+ */
+declare const getSpendApproval: (chainId: string, spendApproval?: DevSpendApprovalTarget, asset?: string) => SpendApprovalConfig | null;
+//#endregion
+//#region src/cards/get-transaction-badge.d.ts
+/**
+ * The badge for a transaction, or `null` for a posted debit, which has nothing worth badging.
+ * Status outranks amount: an authorization's positive amount is a charge, not a credit
+ * (#CardAmountSignByStatus), so only a posted credit badges as one.
+ */
+declare const getTransactionBadge: (transaction: {
+  amount: number;
+  status: CardIssuingTransactionStatus;
+}) => CardTransactionBadge | null;
+//#endregion
+//#region src/cards/handle-sign-up-close.d.ts
+/**
+ * Completes card sign-up from the current step: success when a card already exists, otherwise a
+ * step-specific failure. Closing mid-flow is a user cancel.
+ */
+declare const handleSignUpClose: ({ step, onSuccess, onFailure }: {
+  step: CardSignUpStep;
+  onSuccess: (result: {
+    id: string;
+  }) => void;
+  onFailure: (error: Error) => void;
+}) => void;
+//#endregion
+//#region src/cards/is-card-expired.d.ts
+/**
+ * Whether a card's printed expiration has passed. A card is valid through the last day of its
+ * expiration month, so it only counts as expired once the current month is strictly past
+ * `exp_month`/`exp_year`. Returns `false` when either field is unknown, since expiry can't be
+ * judged.
+ */
+declare const isCardExpired: ({ exp_month, exp_year }: Pick<CardIssuingCardResponse, 'exp_month' | 'exp_year'>) => boolean;
+//#endregion
 //#region src/cards/list-card-transactions.d.ts
 /**
  * A page of activity for one card, newest first.
@@ -3674,7 +4162,35 @@ declare const listCards: (client: Privy, { environment, limit, cursor }: {
   environment: IntegrationEnvironment;
   limit?: number;
   cursor?: string;
-}) => Promise<CardIssuingCardsResponse>;
+}) => Promise<Omit<CardIssuingCardsResponse, 'data'> & {
+  data: CardResponse[];
+}>;
+//#endregion
+//#region src/cards/read-spend-allowance.d.ts
+/**
+ * Reads the current allowance the owner has granted the spender, over an `eth_call` from the
+ * wallet's own provider. Switches the wallet to the target chain first so the read hits the right
+ * network.
+ */
+declare const readSpendAllowance: ({ provider, evmChainId, owner, stablecoinAddress, spenderAddress }: {
+  provider: SpendApprovalProvider;
+  evmChainId: number;
+  owner: `0x${string}`;
+  stablecoinAddress: string;
+  spenderAddress: string;
+}) => Promise<bigint>;
+//#endregion
+//#region src/cards/read-tempo-earn-vault.d.ts
+/**
+ * Reads the vault the owner has chosen on a Tempo Earn spender, or the zero address when it hasn't
+ * chosen one, over an `eth_call` from the wallet's own provider like `readSpendAllowance`.
+ */
+declare const readTempoEarnVault: ({ provider, evmChainId, owner, spenderAddress }: {
+  provider: SpendApprovalProvider;
+  evmChainId: number;
+  owner: `0x${string}`;
+  spenderAddress: string;
+}) => Promise<`0x${string}`>;
 //#endregion
 //#region src/cards/replace-card.d.ts
 /**
@@ -3687,6 +4203,14 @@ declare const replaceCard: (client: Privy, { cardId, environment, reason }: {
   reason: CardIssuingReplacementReason;
 }) => Promise<CardIssuingCardResponse>;
 //#endregion
+//#region src/cards/to-transaction-row.d.ts
+/** Maps one API item onto the narrower shape a row renders. */
+declare const toTransactionRow: ({ transaction, unknownMerchantName }: {
+  transaction: CardIssuingTransactionResponse;
+  /** The API allows a null merchant name; a row's type does not. */
+  unknownMerchantName: string;
+}) => CardTransactionRow;
+//#endregion
 //#region src/cards/update-card-pin.d.ts
 /** Sets one card's PIN from a Stripe-encrypted JWE. The plaintext PIN never enters this request. */
 declare const updateCardPin: (client: Privy, { cardId, environment, encryptedNumber }: {
@@ -3725,4 +4249,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 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 CryptoDepositAddressRoute, type CryptoDepositAddressStrategy, type CryptoDepositAsset, type CryptoDepositAssetFilter, DATA_SUFFIX_PLUGIN_ID, type DataSuffixPlugin, type DepositAddressOrder, type DepositAddressPollingResult, type DepositAddressQuote, type DepositConfig, type EIP1193Provider, type EmbeddedBitcoinWalletProvider, EmbeddedProviderError, EmbeddedWalletClientType, type EmbeddedWalletConfig, type EmbeddedWalletRecoveryOptions, type EntropyIdVerifier, type ErrorMessageMap, 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 SessionSignerInput, type SetRecoveryInput, SmartWalletType, SolanaClient, SolanaCluster, SolanaSignAndSendTransactionInput, SolanaSignAndSendTransactionMode, SolanaSignAndSendTransactionOptions, SolanaSignAndSendTransactionOutput, SolanaSignMessageInput, SolanaSignMessageOutput, SolanaSignTransactionInput, SolanaSignTransactionOptions, SolanaSignTransactionOutput, SolanaStandardWallet, SolanaTransactionCommitment, SolanaUsdcAddressMap, type Storage, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, UsdcAddressMap, type WaitForCompletionInput, type WaitForDepositInput, WalletBranding, WalletClientType, WalletConnectWalletClientType, acceptCardConsents, addSessionSigners, buildSolanaOffchainMessage, chainToMoonpayCurrency, cookies, countryCodesAndNumbers, create, createCard, 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, formatTokenAmount, formatWalletAddress, formatWeiAmount, fundingMethodToMoonpayPaymentMethod, generateAuthorizationSignature, generateWalletIdempotencyKey, getAllUserEmbeddedBitcoinWallets, getAllUserEmbeddedEthereumWallets, getAllUserEmbeddedSolanaWallets, getCardById, getCardCustomer, getCardEphemeralKey, getCardsConfig, getCoinbaseOnRampUrl, getCountryCallingCode, getDataSuffixPlugin, getEntropyDetailsFromAccount, getEntropyDetailsFromUser, getFiatOnrampProviderBrand, getFiatOnrampProviderId, getIsTokenUsdc, getJsonRpcEndpointFromChain, getOrCreateCardCustomer, getPhoneCountryCodeAndNumber, getPlaceholderPhoneNumber, getSolanaClusterDisplayName, getSolanaRpcEndpointForCluster, getSolanaUsdcMintAddressForCluster, getUserEmbeddedEthereumWallet, getUserEmbeddedSolanaWallet, getUserEmbeddedWallet, getUserSmartWallet, getWallet, getWalletAction, isEmbeddedWalletAccount, isExtensionContext, isSupportedChainIdForCoinbaseOnramp, isSupportedChainIdForMoonpay, isUnifiedWallet, lastFourDigits, listCardTransactions, listCards, listWalletActions, parseSolanaOffchainMessage, phoneNumberTypingFormatter, poll, rawSign, removeSessionSigners, replaceCard, rpc, shouldWriteSessionCookies, throwIfInvalidRecoveryUpgradePath, toCoinbaseAssetId, toCoinbaseBlockchainFromChainId, toE164, toObjectKeys, 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 Storage, type SvmDevSpendApprovalTarget, THIRDWEB, type TelegramAuthInput, type TelegramAuthResult, type TelegramWebAppData, UnknownWalletClientType, type UnsignedTransactionRequest, type UnsignedTransactionRequestWithChainId, 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 };