@privy-io/api-types 0.11.0 → 0.13.0

package/src/resources/swaps.ts

@@ -6,28 +6,55 @@ import * as WalletsAPI from './wallets/wallets';
 export class Swaps extends APIResource {}
 
 /**
- * Input for requesting a token swap quote.
+ * The output side of a swap execution request.
  */
-export interface SwapQuoteRequestBody {
+export interface SwapDestination {
   /**
-   * Amount in base units (e.g., wei for ETH).
+   * Token contract address to buy, or "native" for the chain's native token.
    */
-  amount: string;
+  asset_address: string;
 
   /**
-   * Chain identifier (e.g., "eip155:1" for Ethereum mainnet).
+   * CAIP-2 chain identifier for the destination. Must match source chain —
+   * cross-chain swaps are not yet supported. Defaults to source chain if omitted.
    */
-  caip2: string;
+  caip2?: string;
+}
 
+/**
+ * The output side of a swap quote request.
+ */
+export interface SwapQuoteDestination {
   /**
-   * Token address to sell, or "native" for the chain's native token.
+   * Token contract address to buy, or "native" for the chain's native token.
    */
-  input_token: string;
+  asset_address: string;
 
   /**
-   * Token address to buy, or "native" for the chain's native token.
+   * CAIP-2 chain identifier for the destination. Must match source chain —
+   * cross-chain swaps are not yet supported. Defaults to source chain if omitted.
    */
-  output_token: string;
+  caip2?: string;
+}
+
+/**
+ * Input for requesting a token swap quote.
+ */
+export interface SwapQuoteRequestBody {
+  /**
+   * Amount in base units (e.g., wei for ETH). Must be a non-negative integer string.
+   */
+  base_amount: string;
+
+  /**
+   * The output side of a swap quote request.
+   */
+  destination: SwapQuoteDestination;
+
+  /**
+   * The input side of a swap request, including token and chain.
+   */
+  source: SwapSource;
 
   /**
    * Whether the amount refers to the input token or output token.
@@ -86,46 +113,53 @@ export interface SwapQuoteResponse {
  */
 export interface SwapRequestBody {
   /**
-   * Amount in base units (e.g., wei for ETH).
+   * Amount in base units (e.g., wei for ETH). Must be a non-negative integer string.
    */
-  amount: string;
+  base_amount: string;
 
   /**
-   * Chain identifier (e.g., "eip155:1" for Ethereum mainnet).
+   * The output side of a swap execution request.
    */
-  caip2: string;
+  destination: SwapDestination;
 
   /**
-   * Token address to sell, or "native" for the chain's native token.
+   * The input side of a swap request, including token and chain.
    */
-  input_token: string;
+  source: SwapSource;
 
   /**
-   * Token address to buy, or "native" for the chain's native token.
+   * Whether the amount refers to the input token or output token.
    */
-  output_token: string;
+  amount_type?: WalletsAPI.AmountType;
 
   /**
-   * Whether the amount refers to the input token or output token.
+   * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
    */
-  amount_type?: WalletsAPI.AmountType;
+  slippage_bps?: number;
+}
 
+/**
+ * The input side of a swap request, including token and chain.
+ */
+export interface SwapSource {
   /**
-   * Address to receive the output tokens. Defaults to the wallet address if not
-   * specified.
+   * Token contract address to sell, or "native" for the chain's native token.
    */
-  recipient?: string;
+  asset_address: string;
 
   /**
-   * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
+   * CAIP-2 chain identifier (e.g., "eip155:1").
    */
-  slippage_bps?: number;
+  caip2: string;
 }
 
 export declare namespace Swaps {
   export {
+    type SwapDestination as SwapDestination,
+    type SwapQuoteDestination as SwapQuoteDestination,
     type SwapQuoteRequestBody as SwapQuoteRequestBody,
     type SwapQuoteResponse as SwapQuoteResponse,
     type SwapRequestBody as SwapRequestBody,
+    type SwapSource as SwapSource,
   };
 }

package/src/resources/wallet-actions.ts

@@ -507,6 +507,35 @@ export interface EthereumEarnVaultDetailsResponse {
   vault_address: string;
 }
 
+/**
+ * A wallet action step representing a cross-chain/cross-asset fill by an external
+ * provider.
+ */
+export interface ExternalTransactionWalletActionStep {
+  /**
+   * Status of an external transaction step in a wallet action.
+   */
+  status: ExternalTransactionWalletActionStepStatus;
+
+  type: 'external_transaction';
+
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason?: FailureReason;
+}
+
+/**
+ * Status of an external transaction step in a wallet action.
+ */
+export type ExternalTransactionWalletActionStepStatus =
+  | 'preparing'
+  | 'queued'
+  | 'pending'
+  | 'confirmed'
+  | 'rejected'
+  | 'failed';
+
 /**
  * A description of why a wallet action (or a step within a wallet action) failed.
  */
@@ -732,12 +761,17 @@ export type WalletActionStatus = 'pending' | 'succeeded' | 'rejected' | 'failed'
 export type WalletActionStep =
   | EvmTransactionWalletActionStep
   | EvmUserOperationWalletActionStep
-  | SvmTransactionWalletActionStep;
+  | SvmTransactionWalletActionStep
+  | ExternalTransactionWalletActionStep;
 
 /**
  * Type of a wallet action step.
  */
-export type WalletActionStepType = 'evm_transaction' | 'evm_user_operation' | 'svm_transaction';
+export type WalletActionStepType =
+  | 'evm_transaction'
+  | 'evm_user_operation'
+  | 'svm_transaction'
+  | 'external_transaction';
 
 /**
  * Type of wallet action
@@ -766,6 +800,8 @@ export declare namespace WalletActions {
     type EthereumEarnPositionResponse as EthereumEarnPositionResponse,
     type EthereumEarnProvider as EthereumEarnProvider,
     type EthereumEarnVaultDetailsResponse as EthereumEarnVaultDetailsResponse,
+    type ExternalTransactionWalletActionStep as ExternalTransactionWalletActionStep,
+    type ExternalTransactionWalletActionStepStatus as ExternalTransactionWalletActionStepStatus,
     type FailureReason as FailureReason,
     type SvmTransactionWalletActionStep as SvmTransactionWalletActionStep,
     type SvmWalletActionStepStatus as SvmWalletActionStepStatus,

package/src/resources/wallets/balance.ts

@@ -68,10 +68,15 @@ export interface BalanceGetParams {
   /**
    * The token contract address(es) to query in format "chain:address" (e.g.,
    * "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" or
-   * "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v").
+   * "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"). Cannot be used together
+   * with `asset`/`chain` or with `include_currency`.
    */
   token?: string | Array<string>;
 
+  /**
+   * Named asset(s) to query (e.g. `eth`, `usdc`). Use together with `chain` to scope
+   * the query. Cannot be used with `token`.
+   */
   asset?:
     | 'usdc'
     | 'usdc.e'
@@ -83,6 +88,10 @@ export interface BalanceGetParams {
     | 'sol'
     | Array<WalletsAPI.WalletAsset>;
 
+  /**
+   * Chain(s) to query named assets on (e.g. `base`, `ethereum`). Use together with
+   * `asset`. Cannot be used with `token`.
+   */
   chain?:
     | 'ethereum'
     | 'arbitrum'
@@ -121,6 +130,10 @@ export interface BalanceGetParams {
         | 'solana_testnet'
       >;
 
+  /**
+   * If set, balances are converted to the specified fiat currency. Not supported
+   * when `token` is provided.
+   */
   include_currency?: 'usd' | 'eur';
 }
 

package/src/resources/wallets/transactions.ts

@@ -80,11 +80,15 @@ export interface TransactionGetParams {
   chain: 'ethereum' | 'arbitrum' | 'base' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'solana' | 'sepolia';
 
   /**
-   * Token contract address (EVM: 0x-prefixed hex) or mint address (Solana: base58),
-   * used to filter wallet transactions.
+   * Exactly one of `token` or `asset` is required. Cannot be used together with
+   * `asset`.
    */
   token?: WalletsAPI.TransactionTokenAddressInput | Array<WalletsAPI.TransactionTokenAddressInput>;
 
+  /**
+   * Exactly one of `asset` or `token` is required. Cannot be used together with
+   * `token`.
+   */
   asset?:
     | 'usdc'
     | 'usdc.e'

package/src/resources/wallets/wallets.ts

@@ -522,7 +522,8 @@ export interface EthereumSecp256k1SignRpcInput {
  */
 export interface EthereumSecp256k1SignRpcInputParams {
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   hash: Hex;
 }
@@ -546,7 +547,8 @@ export interface EthereumSecp256k1SignRpcResponseData {
   encoding: 'hex';
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   signature: Hex;
 }
@@ -558,7 +560,8 @@ export interface EthereumSendCallsCall {
   to: string;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   data?: Hex;
 
@@ -591,7 +594,8 @@ export interface EthereumSendCallsRpcInput {
   chain_type?: 'ethereum';
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   experimental_data_suffix?: Hex;
 
@@ -652,7 +656,8 @@ export interface EthereumSendTransactionRpcInput {
   chain_type?: 'ethereum';
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   experimental_data_suffix?: Hex;
 
@@ -730,12 +735,14 @@ export interface EthereumSign7702Authorization {
   nonce: Quantity;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   r: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   s: Hex;
 
@@ -1191,7 +1198,8 @@ export interface HpkeImportConfig {
 }
 
 /**
- * A hex-encoded string prefixed with '0x'.
+ * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+ * bytes).
  */
 export type Hex = string;
 
@@ -1383,7 +1391,8 @@ export interface RawSignBytesParams {
  */
 export interface RawSignHashParams {
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   hash: Hex;
 }
@@ -1423,7 +1432,8 @@ export interface RawSignResponseData {
   encoding: 'hex';
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   signature: Hex;
 }
@@ -1514,6 +1524,8 @@ export interface SolanaSignAndSendTransactionRpcInput {
 
   chain_type?: 'solana';
 
+  optimistic_broadcast?: boolean;
+
   reference_id?: string;
 
   sponsor?: boolean;
@@ -1555,6 +1567,8 @@ export interface SolanaSignAndSendTransactionRpcResponseData {
 
   reference_id?: string | null;
 
+  signed_transaction?: string;
+
   transaction_id?: string;
 }
 
@@ -2298,7 +2312,8 @@ export interface TempoAaAuthorization {
   nonce: Quantity;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   signature: Hex;
 }
@@ -2310,7 +2325,8 @@ export interface TempoCall {
   to: string;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   data?: Hex;
 
@@ -2326,12 +2342,14 @@ export interface TempoCall {
  */
 export interface TempoFeePayerSignature {
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   r: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   s: Hex;
 
@@ -2549,7 +2567,8 @@ export interface UnsignedStandardEthereumTransaction {
   chain_id?: Quantity;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   data?: Hex;
 
@@ -2679,56 +2698,66 @@ export namespace UnsignedTempoTransaction {
  */
 export interface UserOperationInput {
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   call_data: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   call_gas_limit: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   max_fee_per_gas: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   max_priority_fee_per_gas: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   nonce: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   pre_verification_gas: Hex;
 
   sender: string;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   verification_gas_limit: Hex;
 
   paymaster?: string;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   paymaster_data?: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   paymaster_post_op_gas_limit?: Hex;
 
   /**
-   * A hex-encoded string prefixed with '0x'.
+   * A hex-encoded string prefixed with '0x', capped at 100002 characters (50,000
+   * bytes).
    */
   paymaster_verification_gas_limit?: Hex;
 }
@@ -3273,7 +3302,8 @@ export type WalletRpcResponse =
 export type WalletSolanaAsset = 'sol' | 'usdc' | 'eurc' | 'usdb';
 
 /**
- * Request body for updating a wallet.
+ * Request body for updating a wallet. `owner` and `owner_id` are mutually
+ * exclusive.
  */
 export interface WalletUpdateRequestBody {
   /**
@@ -3571,7 +3601,8 @@ export declare namespace WalletRpcParams {
     chain_type?: 'ethereum';
 
     /**
-     * Body param: A hex-encoded string prefixed with '0x'.
+     * Body param: A hex-encoded string prefixed with '0x', capped at 100002 characters
+     * (50,000 bytes).
      */
     experimental_data_suffix?: Hex;
 
@@ -3861,7 +3892,8 @@ export declare namespace WalletRpcParams {
     chain_type?: 'ethereum';
 
     /**
-     * Body param: A hex-encoded string prefixed with '0x'.
+     * Body param: A hex-encoded string prefixed with '0x', capped at 100002 characters
+     * (50,000 bytes).
      */
     experimental_data_suffix?: Hex;
 
@@ -3965,6 +3997,11 @@ export declare namespace WalletRpcParams {
      */
     chain_type?: 'solana';
 
+    /**
+     * Body param
+     */
+    optimistic_broadcast?: boolean;
+
     /**
      * Body param
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.13.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.13.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.13.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.11.0'; // x-release-please-version
+exports.VERSION = '0.13.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.13.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map