@privy-io/api-types 0.14.0 → 0.16.0

package/src/resources/wallets/wallets.ts

@@ -92,6 +92,20 @@ export class Wallets extends APIResource {
     return this._client.getAPIList('/v1/wallets', Cursor<Wallet>, { query, ...options });
   }
 
+  /**
+   * Archives a wallet, preventing it from being used in any write or signing
+   * operations. Archived wallets are hidden from list endpoints by default. Returns
+   * 404 if the wallet does not exist or is already archived.
+   *
+   * @example
+   * ```ts
+   * const wallet = await client.wallets.archive('wallet_id');
+   * ```
+   */
+  archive(walletID: string, options?: RequestOptions): APIPromise<Wallet> {
+    return this._client.post(path`/v1/wallets/${walletID}/archive`, options);
+  }
+
   /**
    * Export a wallet's private key
    *
@@ -138,8 +152,12 @@ export class Wallets extends APIResource {
    * const wallet = await client.wallets.get('wallet_id');
    * ```
    */
-  get(walletID: string, options?: RequestOptions): APIPromise<Wallet> {
-    return this._client.get(path`/v1/wallets/${walletID}`, options);
+  get(
+    walletID: string,
+    query: WalletGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Wallet> {
+    return this._client.get(path`/v1/wallets/${walletID}`, { query, ...options });
   }
 
   /**
@@ -233,6 +251,15 @@ export class Wallets extends APIResource {
 
 export type WalletsCursor = Cursor<Wallet>;
 
+/**
+ * An entry in an EIP-2930 access list, specifying an address and its storage keys.
+ */
+export interface AccessListEntry {
+  address: string;
+
+  storage_keys: Array<Hex>;
+}
+
 /**
  * Additional signers for the wallet.
  */
@@ -258,6 +285,139 @@ export interface AdditionalSignerItemInput {
  */
 export type Address = string;
 
+/**
+ * Platform fee collected on a swap.
+ */
+export interface AdvancedSwapPlatformFee {
+  /**
+   * Token the fee was taken from (output token in v1).
+   */
+  token: string;
+
+  /**
+   * Fee amount in the smallest unit of the fee token.
+   */
+  amount: string;
+
+  /**
+   * Fee in basis points.
+   */
+  bps: number;
+}
+
+/**
+ * Request body for initiating a synchronous Solana token swap through an embedded
+ * wallet.
+ */
+export interface AdvancedSwapRequestBody {
+  /**
+   * Amount in the smallest unit of the input token (e.g. lamports for SOL).
+   */
+  amount: string;
+
+  /**
+   * Input token address (base58 mint address).
+   */
+  input_token: string;
+
+  /**
+   * Output token address (base58 mint address).
+   */
+  output_token: string;
+
+  /**
+   * CAIP-2 chain identifier. Defaults to Solana mainnet.
+   */
+  caip2?: string;
+
+  /**
+   * When true, skip transaction submission (quote + sign only). The signed
+   * transaction is still returned.
+   */
+  dry_run?: boolean;
+
+  /**
+   * Token account (base58) to receive the platform fee. Must exist on-chain for the
+   * output token.
+   */
+  fee_recipient?: string;
+
+  /**
+   * Platform fee in basis points, taken from the output token. Requires
+   * fee_recipient when > 0.
+   */
+  platform_fee_bps?: number;
+
+  /**
+   * Max slippage tolerance in basis points (0-10000), or "auto" for
+   * provider-determined. Defaults to "auto".
+   */
+  slippage_bps?: number | 'auto';
+}
+
+/**
+ * Response from the synchronous Solana swap endpoint.
+ */
+export interface AdvancedSwapResponse {
+  /**
+   * Input amount consumed (smallest unit).
+   */
+  in_amount: string;
+
+  /**
+   * Input token address (base58).
+   */
+  input_token: string;
+
+  /**
+   * Minimum output amount guaranteed by slippage tolerance (smallest unit).
+   */
+  min_out_amount: string;
+
+  /**
+   * Expected output amount before slippage (smallest unit).
+   */
+  out_amount: string;
+
+  /**
+   * Output token address (base58).
+   */
+  output_token: string;
+
+  /**
+   * Which aggregator fulfilled the swap (e.g. "dflow").
+   */
+  provider: string;
+
+  /**
+   * Fully signed transaction (base64). Callers can re-submit to any Solana RPC for
+   * redundancy.
+   */
+  signed_transaction: string;
+
+  /**
+   * Slippage applied in basis points. Reflects the resolved value if "auto" was
+   * requested.
+   */
+  slippage_bps: number;
+
+  /**
+   * "accepted" if the network has acknowledged the transaction, "rejected" if the
+   * network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
+   */
+  submission_status: SwapSubmissionStatus;
+
+  /**
+   * Solana transaction signature (base58).
+   */
+  transaction_hash: string;
+
+  /**
+   * Platform fee collected on a swap.
+   */
+  platform_fee?: AdvancedSwapPlatformFee;
+}
+
 /**
  * Whether the amount refers to the input token or output token.
  */
@@ -342,7 +502,10 @@ export interface CustodialWallet {
    */
   custody: WalletCustodian;
 
-  owner_id: string | null;
+  /**
+   * A unique identifier for a key quorum.
+   */
+  owner_id: SharedAPI.KeyQuorumID | null;
 
   /**
    * Additional signers for the wallet.
@@ -405,9 +568,10 @@ export type CustodialWalletProvider = 'bridge';
  */
 export interface CustomTokenTransferSource {
   /**
-   * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
-   * USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
-   * etc.).
+   * @deprecated Amount as a decimal string in the token's standard unit (e.g. "1.5"
+   * for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to
+   * send. Not in the smallest on-chain unit (wei, lamports, etc.). Maximum 100
+   * characters.
    */
   amount: string;
 
@@ -425,6 +589,76 @@ export interface CustomTokenTransferSource {
   chain: string;
 }
 
+/**
+ * Estimated fee paid to the developer.
+ */
+export interface DeveloperFee {
+  /**
+   * Amount in USD (in decimals).
+   */
+  amount: string;
+
+  type: 'developer';
+
+  recipient?: string;
+}
+
+/**
+ * HPKE-encrypted authorization key with encapsulated key and ciphertext.
+ */
+export interface EncryptedAuthorizationKey {
+  /**
+   * The encrypted authorization key corresponding to the user's current
+   * authentication session.
+   */
+  ciphertext: string;
+
+  /**
+   * Base64-encoded ephemeral public key used in the HPKE encryption process.
+   * Required for decryption.
+   */
+  encapsulated_key: string;
+
+  /**
+   * The encryption type used. Currently only supports HPKE.
+   */
+  encryption_type: 'HPKE';
+}
+
+/**
+ * Encrypted response from bound wallet authentication, with bindings.
+ */
+export interface EncryptedBoundAuthenticateResponse {
+  bindings: Array<UserSigningKeyBinding>;
+
+  /**
+   * HPKE-encrypted authorization key with encapsulated key and ciphertext.
+   */
+  encrypted_authorization_key: EncryptedAuthorizationKey;
+
+  expires_at: number;
+
+  wallets: Array<Wallet>;
+}
+
+/**
+ * The response from authenticating a wallet with HPKE encryption, containing an
+ * encrypted authorization key and wallet data.
+ */
+export interface EncryptedWalletAuthenticateResponse {
+  /**
+   * HPKE-encrypted authorization key with encapsulated key and ciphertext.
+   */
+  encrypted_authorization_key: EncryptedAuthorizationKey;
+
+  /**
+   * The expiration time of the authorization key in milliseconds since the epoch.
+   */
+  expires_at: number;
+
+  wallets: Array<Wallet>;
+}
+
 /**
  * Executes the EVM `personal_sign` RPC (EIP-191) to sign a message.
  */
@@ -438,8 +672,19 @@ export interface EthereumPersonalSignRpcInput {
 
   address?: string;
 
+  /**
+   * A valid CAIP-2 chain ID (e.g. 'eip155:1').
+   */
+  caip2?: AppsAPI.Caip2;
+
   chain_type?: 'ethereum';
 
+  /**
+   * Options controlling signature production for personal_sign and
+   * eth_signTypedData_v4.
+   */
+  signature_options?: SignatureOptions;
+
   wallet_id?: string;
 }
 
@@ -875,8 +1120,19 @@ export interface EthereumSignTypedDataRpcInput {
 
   address?: string;
 
+  /**
+   * A valid CAIP-2 chain ID (e.g. 'eip155:1').
+   */
+  caip2?: AppsAPI.Caip2;
+
   chain_type?: 'ethereum';
 
+  /**
+   * Options controlling signature production for personal_sign and
+   * eth_signTypedData_v4.
+   */
+  signature_options?: SignatureOptions;
+
   wallet_id?: string;
 }
 
@@ -1063,11 +1319,52 @@ export type ExtendedChainType =
   | 'starknet'
   | 'spark';
 
+/**
+ * Total fees assessed on a transfer, in BPS
+ */
+export interface FeeConfiguration {
+  /**
+   * Discriminator: total fee specified in BPS.
+   */
+  type: 'total_fee_bps';
+
+  /**
+   * Total fee in basis points (1 bps = 0.01%).
+   */
+  value: number;
+}
+
+/**
+ * An individual fee assessed on a transfer.
+ */
+export type FeeLineItem = RelayerFee | PrivyFee | DeveloperFee;
+
 /**
  * The wallet chain types that offer first class support.
  */
 export type FirstClassChainType = 'ethereum' | 'solana';
 
+/**
+ * Gas cost for a blockchain action. Includes both raw base-unit amount and a
+ * human-readable decimal string, plus the gas token symbol.
+ */
+export interface Gas {
+  /**
+   * Gas cost in the gas token as a human-readable decimal string (e.g. "0.0001").
+   */
+  amount: string;
+
+  /**
+   * Gas cost in the gas token's base units (e.g. wei).
+   */
+  base_amount: string;
+
+  /**
+   * Gas token symbol (e.g. "ETH", "USDC").
+   */
+  gas_asset: string;
+}
+
 /**
  * Request body for looking up a wallet by its blockchain address.
  */
@@ -1076,6 +1373,12 @@ export interface GetByWalletAddressRequestBody {
    * A blockchain wallet address (Ethereum or Solana).
    */
   address: Address;
+
+  /**
+   * Include archived wallets in lookup. Defaults to false (archived wallets return
+   * 404).
+   */
+  include_archived?: boolean;
 }
 
 /**
@@ -1088,8 +1391,8 @@ export interface HDInitInput {
   address: string;
 
   /**
-   * The chain type of the wallet to import. Currently supports `ethereum` and
-   * `solana`.
+   * The chain type of the wallet to import. Supports `ethereum`, `solana`,
+   * `stellar`, `tron`, `sui`, and `aptos`.
    */
   chain_type: WalletImportSupportedChains;
 
@@ -1124,8 +1427,8 @@ export interface HDSubmitInput {
   address: string;
 
   /**
-   * The chain type of the wallet to import. Currently supports `ethereum` and
-   * `solana`.
+   * The chain type of the wallet to import. Supports `ethereum`, `solana`,
+   * `stellar`, `tron`, `sui`, and `aptos`.
    */
   chain_type: WalletImportSupportedChains;
 
@@ -1203,15 +1506,25 @@ export interface HpkeImportConfig {
  */
 export type Hex = string;
 
+/**
+ * A binding that scopes a user signing key to a specific intent.
+ */
+export interface IntentBinding {
+  intentId: string;
+
+  type: 'intent';
+}
+
 /**
  * Source for a transfer identified by a named asset (e.g. "usdc", "eth"). Use this
  * variant for first-class assets maintained by Privy.
  */
 export interface NamedTokenTransferSource {
   /**
-   * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
-   * USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
-   * etc.).
+   * @deprecated Amount as a decimal string in the token's standard unit (e.g. "1.5"
+   * for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to
+   * send. Not in the smallest on-chain unit (wei, lamports, etc.). Maximum 100
+   * characters.
    */
   amount: string;
 
@@ -1296,8 +1609,8 @@ export interface PrivateKeyInitInput {
   address: string;
 
   /**
-   * The chain type of the wallet to import. Currently supports `ethereum` and
-   * `solana`.
+   * The chain type of the wallet to import. Supports `ethereum`, `solana`,
+   * `stellar`, `tron`, `sui`, and `aptos`.
    */
   chain_type: WalletImportSupportedChains;
 
@@ -1319,8 +1632,8 @@ export interface PrivateKeySubmitInput {
   address: string;
 
   /**
-   * The chain type of the wallet to import. Currently supports `ethereum` and
-   * `solana`.
+   * The chain type of the wallet to import. Supports `ethereum`, `solana`,
+   * `stellar`, `tron`, `sui`, and `aptos`.
    */
   chain_type: WalletImportSupportedChains;
 
@@ -1350,12 +1663,39 @@ export interface PrivateKeySubmitInput {
   hpke_config?: HpkeImportConfig;
 }
 
+/**
+ * Estimated fee paid to Privy.
+ */
+export interface PrivyFee {
+  /**
+   * Amount in USD (in decimals).
+   */
+  amount: string;
+
+  type: 'privy';
+
+  recipient?: string;
+}
+
 /**
  * A quantity value that can be either a hex string starting with '0x' or a
  * non-negative integer.
  */
 export type Quantity = Hex | number;
 
+/**
+ * Unencrypted response from bound wallet authentication, with bindings.
+ */
+export interface RawBoundAuthenticateResponse {
+  authorization_key: string;
+
+  bindings: Array<UserSigningKeyBinding>;
+
+  expires_at: number;
+
+  wallets: Array<Wallet>;
+}
+
 /**
  * Encoding scheme for bytes in the `raw_sign` RPC.
  */
@@ -1438,12 +1778,44 @@ export interface RawSignResponseData {
   signature: Hex;
 }
 
+/**
+ * The response from authenticating a wallet without encryption, containing a raw
+ * authorization key and wallet data.
+ */
+export interface RawWalletAuthenticateResponse {
+  /**
+   * The raw authorization key data.
+   */
+  authorization_key: string;
+
+  /**
+   * The expiration time of the authorization key in milliseconds since the epoch.
+   */
+  expires_at: number;
+
+  wallets: Array<Wallet>;
+}
+
 /**
  * The recipient public key for HPKE encryption, in PEM or DER (base64-encoded)
  * format.
  */
 export type RecipientPublicKey = string;
 
+/**
+ * Estimated fee paid to the relayer.
+ */
+export interface RelayerFee {
+  /**
+   * Amount in USD (in decimals).
+   */
+  amount: string;
+
+  type: 'relayer';
+
+  recipient?: string;
+}
+
 /**
  * Input for exporting a wallet (private key or seed phrase) with HPKE encryption.
  */
@@ -1482,6 +1854,26 @@ export interface SeedPhraseExportResponse {
   encryption_type: HpkeEncryption;
 }
 
+/**
+ * Options controlling signature production for personal_sign and
+ * eth_signTypedData_v4.
+ */
+export interface SignatureOptions {
+  /**
+   * The type of cryptographic signature to produce. Use "ecdsa" for standard ECDSA
+   * signatures, or "erc1271" for ERC-1271 compliant signatures for smart account
+   * wallets.
+   */
+  type: SignatureType;
+}
+
+/**
+ * The type of cryptographic signature to produce. Use "ecdsa" for standard ECDSA
+ * signatures, or "erc1271" for ERC-1271 compliant signatures for smart account
+ * wallets.
+ */
+export type SignatureType = 'ecdsa' | 'erc1271';
+
 /**
  * The signing algorithm used by the wallet.
  */
@@ -2293,6 +2685,12 @@ export interface SparkWalletLeaf {
  */
 export type SuiCommandName = 'TransferObjects' | 'SplitCoins' | 'MergeCoins';
 
+/**
+ * "accepted" if the network has acknowledged the transaction, "rejected" if the
+ * network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
+ */
+export type SwapSubmissionStatus = 'accepted' | 'rejected' | 'skipped';
+
 /**
  * An AA authorization for Tempo transactions with P256/WebAuthn signatures.
  */
@@ -2383,7 +2781,7 @@ export interface TokenOutput {
  */
 export interface TokenTransferDestination {
   /**
-   * Recipient address (hex for EVM, base58 for Solana)
+   * Recipient address (hex for EVM, base58 for Solana, base58check for Tron)
    */
   address: string;
 
@@ -2406,6 +2804,21 @@ export interface TokenTransferDestination {
  */
 export type TokenTransferSource = NamedTokenTransferSource | CustomTokenTransferSource;
 
+/**
+ * Total fees assessed on a transfer, in BPS
+ */
+export interface TotalFeeConfigurationBps {
+  /**
+   * Discriminator: total fee specified in BPS.
+   */
+  type: 'total_fee_bps';
+
+  /**
+   * Total fee in basis points (1 bps = 0.01%).
+   */
+  value: number;
+}
+
 /**
  * Details of a wallet transaction, varying by transaction type.
  */
@@ -2418,14 +2831,107 @@ export type TransactionDetail = TransferSentTransactionDetail | TransferReceived
 export type TransactionTokenAddressInput = string;
 
 /**
- * Details for a received transfer transaction.
+ * Request body for requesting a quote for a cross-asset or cross-chain (DADC)
+ * transfer.
  */
-export interface TransferReceivedTransactionDetail {
-  asset: 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
+export interface TransferQuoteRequestBody {
+  /**
+   * The destination address for a token transfer. Optionally specify a different
+   * asset or chain for cross-asset or cross-chain transfers.
+   */
+  destination: TokenTransferDestination;
+
+  /**
+   * The source asset, amount, and chain for a token transfer. Specify either `asset`
+   * (named) or `asset_address` (custom), not both.
+   */
+  source: TokenTransferSource;
+
+  /**
+   * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
+   * USDC). For exact_input, the amount to send. For exact_output, the exact amount
+   * to receive. Takes precedence over source.amount when both are provided.
+   */
+  amount?: string;
+
+  /**
+   * Whether the amount refers to the input token or output token.
+   */
+  amount_type?: AmountType;
+
+  /**
+   * Total fees assessed on a transfer, in BPS
+   */
+  fee_configuration?: FeeConfiguration;
+
+  /**
+   * Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
+   * cross-chain or cross-asset transfers; omit to use the provider default.
+   */
+  slippage_bps?: number;
+}
+
+/**
+ * Response containing a quote for a cross-asset or cross-chain (DADC) transfer.
+ */
+export interface TransferQuoteResponse {
+  /**
+   * The destination address for a token transfer. Optionally specify a different
+   * asset or chain for cross-asset or cross-chain transfers.
+   */
+  destination: TokenTransferDestination;
+
+  /**
+   * Estimated fees in USD for the transfer. Only present for cross-chain transfers.
+   */
+  estimated_fees: Array<FeeLineItem>;
+
+  /**
+   * Estimated input amount in decimals. For exact_input, this equals source.amount.
+   * For exact_output, this is the estimated amount the sender needs to provide.
+   */
+  estimated_input_amount: string;
+
+  /**
+   * Estimated output amount in decimals. For exact_input, this is an estimate
+   * subject to slippage. For exact_output, this is the guaranteed exact amount to be
+   * received.
+   */
+  estimated_output_amount: string;
+
+  /**
+   * Quote expiry as Unix timestamp (seconds).
+   */
+  expires_at: number;
+
+  /**
+   * The source asset, amount, and chain for a token transfer. Specify either `asset`
+   * (named) or `asset_address` (custom), not both.
+   */
+  source: TokenTransferSource;
+
+  /**
+   * Whether the amount refers to the input token or output token.
+   */
+  amount_type?: AmountType;
+
+  /**
+   * Gas cost for a blockchain action. Includes both raw base-unit amount and a
+   * human-readable decimal string, plus the gas token symbol.
+   */
+  estimated_gas?: Gas;
+}
+
+/**
+ * Details for a received transfer transaction.
+ */
+export interface TransferReceivedTransactionDetail {
+  asset: 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
 
   chain:
     | 'ethereum'
     | 'arbitrum'
+    | 'avalanche'
     | 'base'
     | 'tempo'
     | 'linea'
@@ -2435,6 +2941,7 @@ export interface TransferReceivedTransactionDetail {
     | 'zksync_era'
     | 'sepolia'
     | 'arbitrum_sepolia'
+    | 'avalanche_fuji'
     | 'base_sepolia'
     | 'linea_testnet'
     | 'optimism_sepolia'
@@ -2475,13 +2982,26 @@ export interface TransferRequestBody {
    */
   source: TokenTransferSource;
 
+  /**
+   * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
+   * USDC). For exact_input, the amount to send. For exact_output, the exact amount
+   * to receive. Takes precedence over source.amount when both are provided.
+   */
+  amount?: string;
+
   /**
    * Whether the amount refers to the input token or output token.
    */
   amount_type?: AmountType;
 
   /**
-   * Maximum allowed slippage in basis points (1 bps = 0.01%).
+   * Total fees assessed on a transfer, in BPS
+   */
+  fee_configuration?: FeeConfiguration;
+
+  /**
+   * Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
+   * cross-chain or cross-asset transfers; omit to use the provider default.
    */
   slippage_bps?: number;
 }
@@ -2490,11 +3010,12 @@ export interface TransferRequestBody {
  * Details for a sent transfer transaction.
  */
 export interface TransferSentTransactionDetail {
-  asset: 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
+  asset: 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
 
   chain:
     | 'ethereum'
     | 'arbitrum'
+    | 'avalanche'
     | 'base'
     | 'tempo'
     | 'linea'
@@ -2504,6 +3025,7 @@ export interface TransferSentTransactionDetail {
     | 'zksync_era'
     | 'sepolia'
     | 'arbitrum_sepolia'
+    | 'avalanche_fuji'
     | 'base_sepolia'
     | 'linea_testnet'
     | 'optimism_sepolia'
@@ -2528,6 +3050,214 @@ export interface TransferSentTransactionDetail {
   type: 'transfer_sent';
 }
 
+/**
+ * A Tron contract, discriminated by type. Supported types: TransferContract,
+ * TriggerSmartContract.
+ */
+export type TronContract = TronTransferContract | TronTriggerSmartContract;
+
+/**
+ * Tron raw_data for tron_sendTransaction. Block reference fields are optional;
+ * Privy fetches fresh values if omitted.
+ */
+export interface TronRawDataForSend {
+  contract: Array<TronContract>;
+
+  data?: string;
+
+  expiration?: number;
+
+  fee_limit?: number;
+
+  ref_block_bytes?: string;
+
+  ref_block_hash?: string;
+
+  timestamp?: number;
+}
+
+/**
+ * Tron raw_data for tron_signTransaction. Block reference fields are required;
+ * caller is responsible for fetching them.
+ */
+export interface TronRawDataForSign {
+  contract: Array<TronContract>;
+
+  expiration: number;
+
+  ref_block_bytes: string;
+
+  ref_block_hash: string;
+
+  data?: string;
+
+  fee_limit?: number;
+
+  timestamp?: number;
+}
+
+/**
+ * Request body for Tron wallet RPC operations, discriminated by method.
+ */
+export type TronRpcInput = TronSignTransactionRpcInput | TronSendTransactionRpcInput;
+
+/**
+ * Response body for Tron wallet RPC operations, discriminated by method.
+ */
+export type TronRpcResponse = TronSignTransactionRpcResponse | TronSendTransactionRpcResponse;
+
+/**
+ * Executes the Tron `tron_sendTransaction` RPC to sign and broadcast a
+ * transaction.
+ */
+export interface TronSendTransactionRpcInput {
+  method: 'tron_sendTransaction';
+
+  /**
+   * Parameters for the Tron `tron_sendTransaction` RPC.
+   */
+  params: TronSendTransactionRpcInputParams;
+
+  /**
+   * A valid CAIP-2 chain ID (e.g. 'eip155:1').
+   */
+  caip2?: AppsAPI.Caip2;
+}
+
+/**
+ * Parameters for the Tron `tron_sendTransaction` RPC.
+ */
+export interface TronSendTransactionRpcInputParams {
+  /**
+   * Tron raw_data for tron_sendTransaction. Block reference fields are optional;
+   * Privy fetches fresh values if omitted.
+   */
+  raw_data: TronRawDataForSend;
+
+  reference_id?: string;
+}
+
+/**
+ * Response to the Tron `tron_sendTransaction` RPC.
+ */
+export interface TronSendTransactionRpcResponse {
+  /**
+   * Data returned by the Tron `tron_sendTransaction` RPC.
+   */
+  data: TronSendTransactionRpcResponseData;
+
+  method: 'tron_sendTransaction';
+}
+
+/**
+ * Data returned by the Tron `tron_sendTransaction` RPC.
+ */
+export interface TronSendTransactionRpcResponseData {
+  /**
+   * A valid CAIP-2 chain ID (e.g. 'eip155:1').
+   */
+  caip2: AppsAPI.Caip2;
+
+  hash: string;
+
+  transaction_id: string;
+
+  reference_id?: string;
+}
+
+/**
+ * Executes the Tron `tron_signTransaction` RPC to sign a transaction. The caller
+ * is responsible for broadcasting.
+ */
+export interface TronSignTransactionRpcInput {
+  method: 'tron_signTransaction';
+
+  /**
+   * Parameters for the Tron `tron_signTransaction` RPC.
+   */
+  params: TronSignTransactionRpcInputParams;
+}
+
+/**
+ * Parameters for the Tron `tron_signTransaction` RPC.
+ */
+export interface TronSignTransactionRpcInputParams {
+  /**
+   * Tron raw_data for tron_signTransaction. Block reference fields are required;
+   * caller is responsible for fetching them.
+   */
+  raw_data: TronRawDataForSign;
+}
+
+/**
+ * Response to the Tron `tron_signTransaction` RPC.
+ */
+export interface TronSignTransactionRpcResponse {
+  /**
+   * Data returned by the Tron `tron_signTransaction` RPC.
+   */
+  data: TronSignTransactionRpcResponseData;
+
+  method: 'tron_signTransaction';
+}
+
+/**
+ * Data returned by the Tron `tron_signTransaction` RPC.
+ */
+export interface TronSignTransactionRpcResponseData {
+  encoding: 'hex';
+
+  signed_transaction: string;
+}
+
+/**
+ * Tron native TRX transfer contract.
+ */
+export interface TronTransferContract {
+  amount: number;
+
+  /**
+   * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
+   * prefix.
+   */
+  owner_address: SharedAPI.TronHexAddress;
+
+  /**
+   * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
+   * prefix.
+   */
+  to_address: SharedAPI.TronHexAddress;
+
+  type: 'TransferContract';
+}
+
+/**
+ * Tron smart contract call (TRC-20 transfers and general contract interactions).
+ */
+export interface TronTriggerSmartContract {
+  /**
+   * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
+   * prefix.
+   */
+  contract_address: SharedAPI.TronHexAddress;
+
+  /**
+   * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
+   * prefix.
+   */
+  owner_address: SharedAPI.TronHexAddress;
+
+  type: 'TriggerSmartContract';
+
+  call_token_value?: number;
+
+  call_value?: number;
+
+  data?: string;
+
+  token_id?: number;
+}
+
 /**
  * The domain parameters for EIP-712 typed data signing.
  */
@@ -2625,7 +3355,7 @@ export interface UnsignedTempoTransaction {
 
   aa_authorization_list?: Array<TempoAaAuthorization>;
 
-  access_list?: Array<UnsignedTempoTransaction.AccessList>;
+  access_list?: Array<AccessListEntry>;
 
   /**
    * A quantity value that can be either a hex string starting with '0x' or a
@@ -2685,14 +3415,6 @@ export interface UnsignedTempoTransaction {
   valid_before?: Quantity;
 }
 
-export namespace UnsignedTempoTransaction {
-  export interface AccessList {
-    address: string;
-
-    storage_keys: Array<WalletsAPI.Hex>;
-  }
-}
-
 /**
  * An ERC-4337 user operation.
  */
@@ -2762,6 +3484,15 @@ export interface UserOperationInput {
   paymaster_verification_gas_limit?: Hex;
 }
 
+/**
+ * A binding that scopes a user signing key to a specific intent.
+ */
+export interface UserSigningKeyBinding {
+  intentId: string;
+
+  type: 'intent';
+}
+
 /**
  * A wallet managed by Privy's wallet infrastructure.
  */
@@ -2814,6 +3545,12 @@ export interface Wallet {
    */
   policy_ids: Array<string>;
 
+  /**
+   * Unix timestamp of when the wallet was archived in milliseconds, or null if the
+   * wallet is active.
+   */
+  archived_at?: number | null;
+
   /**
    * The number of keys that must sign for an action to be valid.
    */
@@ -2888,7 +3625,52 @@ export interface WalletAPIRevokeAuthorizationKeyInput {
 /**
  * A named asset supported across all chains.
  */
-export type WalletAsset = 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
+export type WalletAsset = 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
+
+/**
+ * Request body for creating an encrypted, bound user signing key.
+ */
+export interface WalletAuthenticateBoundEncryptedRequestBody {
+  /**
+   * Bindings that scope the USK. The key can only authorize the bound values.
+   */
+  bindings: Array<UserSigningKeyBinding>;
+
+  encryption_type: 'HPKE';
+
+  recipient_public_key: string;
+
+  user_jwt: string;
+}
+
+/**
+ * Request body for creating a user signing key scoped to specific bindings. The
+ * returned USK can only authorize the bound values and cannot sign other RPC
+ * requests.
+ */
+export type WalletAuthenticateBoundRequestBody =
+  | WalletAuthenticateBoundEncryptedRequestBody
+  | WalletAuthenticateBoundUnencryptedRequestBody;
+
+/**
+ * Request body for creating an unencrypted, bound user signing key.
+ */
+export interface WalletAuthenticateBoundUnencryptedRequestBody {
+  /**
+   * Bindings that scope the USK. The key can only authorize the bound values.
+   */
+  bindings: Array<UserSigningKeyBinding>;
+
+  user_jwt: string;
+}
+
+/**
+ * The response from authenticating a wallet with intent bindings, containing an
+ * authorization key, wallet data, and the bindings the key is scoped to.
+ */
+export type WalletAuthenticateIntentsResponse =
+  | EncryptedBoundAuthenticateResponse
+  | RawBoundAuthenticateResponse;
 
 /**
  * Request body for wallet authentication with HPKE-encrypted response.
@@ -2917,62 +3699,8 @@ export interface WalletAuthenticateRequestBody {
  * wallet data.
  */
 export type WalletAuthenticateWithJwtResponse =
-  | WalletAuthenticateWithJwtResponse.WithEncryption
-  | WalletAuthenticateWithJwtResponse.WithoutEncryption;
-
-export namespace WalletAuthenticateWithJwtResponse {
-  export interface WithEncryption {
-    /**
-     * The encrypted authorization key data.
-     */
-    encrypted_authorization_key: WithEncryption.EncryptedAuthorizationKey;
-
-    /**
-     * The expiration time of the authorization key in milliseconds since the epoch.
-     */
-    expires_at: number;
-
-    wallets: Array<WalletsAPI.Wallet>;
-  }
-
-  export namespace WithEncryption {
-    /**
-     * The encrypted authorization key data.
-     */
-    export interface EncryptedAuthorizationKey {
-      /**
-       * The encrypted authorization key corresponding to the user's current
-       * authentication session.
-       */
-      ciphertext: string;
-
-      /**
-       * Base64-encoded ephemeral public key used in the HPKE encryption process.
-       * Required for decryption.
-       */
-      encapsulated_key: string;
-
-      /**
-       * The encryption type used. Currently only supports HPKE.
-       */
-      encryption_type: 'HPKE';
-    }
-  }
-
-  export interface WithoutEncryption {
-    /**
-     * The raw authorization key data.
-     */
-    authorization_key: string;
-
-    /**
-     * The expiration time of the authorization key in milliseconds since the epoch.
-     */
-    expires_at: number;
-
-    wallets: Array<WalletsAPI.Wallet>;
-  }
-}
+  | EncryptedWalletAuthenticateResponse
+  | RawWalletAuthenticateResponse;
 
 /**
  * Headers required to authorize wallet operations.
@@ -3168,7 +3896,7 @@ export type WalletEntropyType = 'hd' | 'private-key';
 /**
  * A named asset on Ethereum-compatible chains.
  */
-export type WalletEthereumAsset = 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb';
+export type WalletEthereumAsset = 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'usdt' | 'eurc' | 'usdb';
 
 /**
  * Request body for exporting a wallet private key.
@@ -3224,10 +3952,10 @@ export interface WalletImportInitResponse {
 }
 
 /**
- * The chain type of the wallet to import. Currently supports `ethereum` and
- * `solana`.
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
+ * `stellar`, `tron`, `sui`, and `aptos`.
  */
-export type WalletImportSupportedChains = 'ethereum' | 'solana';
+export type WalletImportSupportedChains = 'ethereum' | 'solana' | 'stellar' | 'tron' | 'sui' | 'aptos';
 
 /**
  * The entropy type of the wallet to import. Supports `private-key` for raw private
@@ -3266,6 +3994,8 @@ export type WalletRpcRequestBody =
   | SparkCreateLightningInvoiceRpcInput
   | SparkPayLightningInvoiceRpcInput
   | SparkSignMessageWithIdentityKeyRpcInput
+  | TronSignTransactionRpcInput
+  | TronSendTransactionRpcInput
   | ExportPrivateKeyRpcInput
   | ExportSeedPhraseRpcInput;
 
@@ -3293,6 +4023,8 @@ export type WalletRpcResponse =
   | SparkCreateLightningInvoiceRpcResponse
   | SparkPayLightningInvoiceRpcResponse
   | SparkSignMessageWithIdentityKeyRpcResponse
+  | TronSignTransactionRpcResponse
+  | TronSendTransactionRpcResponse
   | ExportPrivateKeyRpcResponse
   | ExportSeedPhraseRpcResponse;
 
@@ -3442,6 +4174,11 @@ export interface WalletListParams extends CursorParams {
    */
   external_id?: string;
 
+  /**
+   * Include archived wallets in lookup. Defaults to false.
+   */
+  include_archived?: boolean;
+
   /**
    * Filter wallets by user ID. Cannot be used together with authorization_key.
    */
@@ -3479,6 +4216,13 @@ export interface WalletExportParams {
   'privy-request-expiry'?: string;
 }
 
+export interface WalletGetParams {
+  /**
+   * Include archived wallets in lookup. Defaults to false.
+   */
+  include_archived?: boolean;
+}
+
 export interface WalletRawSignParams {
   /**
    * Body param: Parameters for the `raw_sign` RPC.
@@ -3525,6 +4269,8 @@ export type WalletRpcParams =
   | WalletRpcParams.SparkCreateLightningInvoiceRpcInput
   | WalletRpcParams.SparkPayLightningInvoiceRpcInput
   | WalletRpcParams.SparkSignMessageWithIdentityKeyRpcInput
+  | WalletRpcParams.TronSignTransactionRpcInput
+  | WalletRpcParams.TronSendTransactionRpcInput
   | WalletRpcParams.ExportPrivateKeyRpcInput
   | WalletRpcParams.ExportSeedPhraseRpcInput;
 
@@ -3656,11 +4402,22 @@ export declare namespace WalletRpcParams {
      */
     address?: string;
 
+    /**
+     * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
+     */
+    caip2?: AppsAPI.Caip2;
+
     /**
      * Body param
      */
     chain_type?: 'ethereum';
 
+    /**
+     * Body param: Options controlling signature production for personal_sign and
+     * eth_signTypedData_v4.
+     */
+    signature_options?: SignatureOptions;
+
     /**
      * Body param
      */
@@ -3701,11 +4458,22 @@ export declare namespace WalletRpcParams {
      */
     address?: string;
 
+    /**
+     * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
+     */
+    caip2?: AppsAPI.Caip2;
+
     /**
      * Body param
      */
     chain_type?: 'ethereum';
 
+    /**
+     * Body param: Options controlling signature production for personal_sign and
+     * eth_signTypedData_v4.
+     */
+    signature_options?: SignatureOptions;
+
     /**
      * Body param
      */
@@ -4386,6 +5154,71 @@ export declare namespace WalletRpcParams {
     'privy-request-expiry'?: string;
   }
 
+  export interface TronSignTransactionRpcInput {
+    /**
+     * Body param
+     */
+    method: 'tron_signTransaction';
+
+    /**
+     * Body param: Parameters for the Tron `tron_signTransaction` RPC.
+     */
+    params: TronSignTransactionRpcInputParams;
+
+    /**
+     * Header param: Request authorization signature. If multiple signatures are
+     * required, they should be comma separated.
+     */
+    'privy-authorization-signature'?: string;
+
+    /**
+     * Header param: Idempotency keys ensure API requests are executed only once within
+     * a 24-hour window.
+     */
+    'privy-idempotency-key'?: string;
+
+    /**
+     * Header param: Request expiry. Value is a Unix timestamp in milliseconds
+     * representing the deadline by which the request must be processed.
+     */
+    'privy-request-expiry'?: string;
+  }
+
+  export interface TronSendTransactionRpcInput {
+    /**
+     * Body param
+     */
+    method: 'tron_sendTransaction';
+
+    /**
+     * Body param: Parameters for the Tron `tron_sendTransaction` RPC.
+     */
+    params: TronSendTransactionRpcInputParams;
+
+    /**
+     * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
+     */
+    caip2?: AppsAPI.Caip2;
+
+    /**
+     * Header param: Request authorization signature. If multiple signatures are
+     * required, they should be comma separated.
+     */
+    'privy-authorization-signature'?: string;
+
+    /**
+     * Header param: Idempotency keys ensure API requests are executed only once within
+     * a 24-hour window.
+     */
+    'privy-idempotency-key'?: string;
+
+    /**
+     * Header param: Request expiry. Value is a Unix timestamp in milliseconds
+     * representing the deadline by which the request must be processed.
+     */
+    'privy-request-expiry'?: string;
+  }
+
   export interface ExportPrivateKeyRpcInput {
     /**
      * Body param
@@ -4464,9 +5297,13 @@ Wallets.Transactions = Transactions;
 
 export declare namespace Wallets {
   export {
+    type AccessListEntry as AccessListEntry,
     type AdditionalSignerInput as AdditionalSignerInput,
     type AdditionalSignerItemInput as AdditionalSignerItemInput,
     type Address as Address,
+    type AdvancedSwapPlatformFee as AdvancedSwapPlatformFee,
+    type AdvancedSwapRequestBody as AdvancedSwapRequestBody,
+    type AdvancedSwapResponse as AdvancedSwapResponse,
     type AmountType as AmountType,
     type AuthorizationKeyDashboardResponse as AuthorizationKeyDashboardResponse,
     type AuthorizationKeyResponse as AuthorizationKeyResponse,
@@ -4478,6 +5315,10 @@ export declare namespace Wallets {
     type CustodialWalletCreateInput as CustodialWalletCreateInput,
     type CustodialWalletProvider as CustodialWalletProvider,
     type CustomTokenTransferSource as CustomTokenTransferSource,
+    type DeveloperFee as DeveloperFee,
+    type EncryptedAuthorizationKey as EncryptedAuthorizationKey,
+    type EncryptedBoundAuthenticateResponse as EncryptedBoundAuthenticateResponse,
+    type EncryptedWalletAuthenticateResponse as EncryptedWalletAuthenticateResponse,
     type EthereumPersonalSignRpcInput as EthereumPersonalSignRpcInput,
     type EthereumPersonalSignRpcInputParams as EthereumPersonalSignRpcInputParams,
     type EthereumPersonalSignRpcResponse as EthereumPersonalSignRpcResponse,
@@ -4521,7 +5362,10 @@ export declare namespace Wallets {
     type ExportSeedPhraseRpcResponse as ExportSeedPhraseRpcResponse,
     type ExportType as ExportType,
     type ExtendedChainType as ExtendedChainType,
+    type FeeConfiguration as FeeConfiguration,
+    type FeeLineItem as FeeLineItem,
     type FirstClassChainType as FirstClassChainType,
+    type Gas as Gas,
     type GetByWalletAddressRequestBody as GetByWalletAddressRequestBody,
     type HDInitInput as HDInitInput,
     type HDPath as HDPath,
@@ -4530,6 +5374,7 @@ export declare namespace Wallets {
     type HpkeEncryption as HpkeEncryption,
     type HpkeImportConfig as HpkeImportConfig,
     type Hex as Hex,
+    type IntentBinding as IntentBinding,
     type NamedTokenTransferSource as NamedTokenTransferSource,
     type OutputWithPreviousTransactionData as OutputWithPreviousTransactionData,
     type PolicyInput as PolicyInput,
@@ -4537,7 +5382,9 @@ export declare namespace Wallets {
     type PrivateKeyExportResponse as PrivateKeyExportResponse,
     type PrivateKeyInitInput as PrivateKeyInitInput,
     type PrivateKeySubmitInput as PrivateKeySubmitInput,
+    type PrivyFee as PrivyFee,
     type Quantity as Quantity,
+    type RawBoundAuthenticateResponse as RawBoundAuthenticateResponse,
     type RawSignBytesEncoding as RawSignBytesEncoding,
     type RawSignBytesHashFunction as RawSignBytesHashFunction,
     type RawSignBytesParams as RawSignBytesParams,
@@ -4546,9 +5393,13 @@ export declare namespace Wallets {
     type RawSignInputParams as RawSignInputParams,
     type RawSignResponse as RawSignResponse,
     type RawSignResponseData as RawSignResponseData,
+    type RawWalletAuthenticateResponse as RawWalletAuthenticateResponse,
     type RecipientPublicKey as RecipientPublicKey,
+    type RelayerFee as RelayerFee,
     type SeedPhraseExportInput as SeedPhraseExportInput,
     type SeedPhraseExportResponse as SeedPhraseExportResponse,
+    type SignatureOptions as SignatureOptions,
+    type SignatureType as SignatureType,
     type SigningAlgorithm as SigningAlgorithm,
     type SolanaRpcInput as SolanaRpcInput,
     type SolanaRpcResponse as SolanaRpcResponse,
@@ -4610,17 +5461,36 @@ export declare namespace Wallets {
     type SparkUserTokenMetadata as SparkUserTokenMetadata,
     type SparkWalletLeaf as SparkWalletLeaf,
     type SuiCommandName as SuiCommandName,
+    type SwapSubmissionStatus as SwapSubmissionStatus,
     type TempoAaAuthorization as TempoAaAuthorization,
     type TempoCall as TempoCall,
     type TempoFeePayerSignature as TempoFeePayerSignature,
     type TokenOutput as TokenOutput,
     type TokenTransferDestination as TokenTransferDestination,
     type TokenTransferSource as TokenTransferSource,
+    type TotalFeeConfigurationBps as TotalFeeConfigurationBps,
     type TransactionDetail as TransactionDetail,
     type TransactionTokenAddressInput as TransactionTokenAddressInput,
+    type TransferQuoteRequestBody as TransferQuoteRequestBody,
+    type TransferQuoteResponse as TransferQuoteResponse,
     type TransferReceivedTransactionDetail as TransferReceivedTransactionDetail,
     type TransferRequestBody as TransferRequestBody,
     type TransferSentTransactionDetail as TransferSentTransactionDetail,
+    type TronContract as TronContract,
+    type TronRawDataForSend as TronRawDataForSend,
+    type TronRawDataForSign as TronRawDataForSign,
+    type TronRpcInput as TronRpcInput,
+    type TronRpcResponse as TronRpcResponse,
+    type TronSendTransactionRpcInput as TronSendTransactionRpcInput,
+    type TronSendTransactionRpcInputParams as TronSendTransactionRpcInputParams,
+    type TronSendTransactionRpcResponse as TronSendTransactionRpcResponse,
+    type TronSendTransactionRpcResponseData as TronSendTransactionRpcResponseData,
+    type TronSignTransactionRpcInput as TronSignTransactionRpcInput,
+    type TronSignTransactionRpcInputParams as TronSignTransactionRpcInputParams,
+    type TronSignTransactionRpcResponse as TronSignTransactionRpcResponse,
+    type TronSignTransactionRpcResponseData as TronSignTransactionRpcResponseData,
+    type TronTransferContract as TronTransferContract,
+    type TronTriggerSmartContract as TronTriggerSmartContract,
     type TypedDataDomainInputParams as TypedDataDomainInputParams,
     type TypedDataTypeFieldInput as TypedDataTypeFieldInput,
     type TypedDataTypesInputParams as TypedDataTypesInputParams,
@@ -4628,12 +5498,17 @@ export declare namespace Wallets {
     type UnsignedStandardEthereumTransaction as UnsignedStandardEthereumTransaction,
     type UnsignedTempoTransaction as UnsignedTempoTransaction,
     type UserOperationInput as UserOperationInput,
+    type UserSigningKeyBinding as UserSigningKeyBinding,
     type Wallet as Wallet,
     type WalletAdditionalSigner as WalletAdditionalSigner,
     type WalletAdditionalSignerItem as WalletAdditionalSignerItem,
     type WalletAPIRegisterAuthorizationKeyInput as WalletAPIRegisterAuthorizationKeyInput,
     type WalletAPIRevokeAuthorizationKeyInput as WalletAPIRevokeAuthorizationKeyInput,
     type WalletAsset as WalletAsset,
+    type WalletAuthenticateBoundEncryptedRequestBody as WalletAuthenticateBoundEncryptedRequestBody,
+    type WalletAuthenticateBoundRequestBody as WalletAuthenticateBoundRequestBody,
+    type WalletAuthenticateBoundUnencryptedRequestBody as WalletAuthenticateBoundUnencryptedRequestBody,
+    type WalletAuthenticateIntentsResponse as WalletAuthenticateIntentsResponse,
     type WalletAuthenticateRequestBody as WalletAuthenticateRequestBody,
     type WalletAuthenticateWithJwtResponse as WalletAuthenticateWithJwtResponse,
     type WalletAuthorizationHeaders as WalletAuthorizationHeaders,
@@ -4661,6 +5536,7 @@ export declare namespace Wallets {
     type WalletUpdateParams as WalletUpdateParams,
     type WalletListParams as WalletListParams,
     type WalletExportParams as WalletExportParams,
+    type WalletGetParams as WalletGetParams,
     type WalletRawSignParams as WalletRawSignParams,
     type WalletRpcParams as WalletRpcParams,
   };