@privy-io/api-types 0.13.0 → 0.15.0

package/src/resources/policies.ts

@@ -436,6 +436,7 @@ export type PolicyCondition =
   | EthereumTypedDataDomainCondition
   | EthereumTypedDataMessageCondition
   | Ethereum7702AuthorizationCondition
+  | TempoTransactionCondition
   | SolanaProgramInstructionCondition
   | SolanaSystemProgramInstructionCondition
   | SolanaTokenProgramInstructionCondition
@@ -455,6 +456,7 @@ export type PolicyMethod =
   | 'eth_signTransaction'
   | 'eth_signUserOperation'
   | 'eth_signTypedData_v4'
+  | 'personal_sign'
   | 'eth_sign7702Authorization'
   | 'wallet_sendCalls'
   | 'signTransaction'
@@ -689,6 +691,42 @@ export interface SystemCondition {
   value: ConditionValue;
 }
 
+/**
+ * A Tempo (type 118) transaction-level field. Evaluated once per transaction (not
+ * per call).
+ */
+export interface TempoTransactionCondition {
+  /**
+   * Tempo (type 118) transaction-level fields that can be referenced in a policy
+   * condition.
+   */
+  field: TempoTransactionConditionField;
+
+  field_source: 'tempo_transaction';
+
+  /**
+   * Operator to use for policy conditions.
+   */
+  operator: ConditionOperator;
+
+  /**
+   * Value to compare against in a policy condition. Can be a single string or an
+   * array of strings.
+   */
+  value: ConditionValue;
+}
+
+/**
+ * Tempo (type 118) transaction-level fields that can be referenced in a policy
+ * condition.
+ */
+export type TempoTransactionConditionField =
+  | 'fee_token'
+  | 'fee_payer_signature'
+  | 'nonce_key'
+  | 'valid_before'
+  | 'valid_after';
+
 /**
  * Decoded calldata from a TRON TriggerSmartContract interaction.
  */
@@ -807,6 +845,8 @@ export declare namespace Policies {
     type SuiTransferObjectsCommandCondition as SuiTransferObjectsCommandCondition,
     type SuiTransferObjectsCommandField as SuiTransferObjectsCommandField,
     type SystemCondition as SystemCondition,
+    type TempoTransactionCondition as TempoTransactionCondition,
+    type TempoTransactionConditionField as TempoTransactionConditionField,
     type TronCalldataCondition as TronCalldataCondition,
     type TronTransactionCondition as TronTransactionCondition,
     type UpdateConditionSetRequestBody as UpdateConditionSetRequestBody,

package/src/resources/shared.ts

@@ -4,6 +4,11 @@ import { APIResource } from '../core/resource';
 
 export class Shared extends APIResource {}
 
+/**
+ * Bitcoin address: bech32 (bc1), P2SH (3), or P2PKH (1).
+ */
+export type BitcoinAddress = string;
+
 /**
  * A monetary value with its currency denomination.
  */
@@ -19,6 +24,22 @@ export interface CurrencyAmount {
   value: string;
 }
 
+/**
+ * EVM address: 0x followed by 40 hex characters. Preserves input case.
+ */
+export type EvmAddress = string;
+
+/**
+ * EVM address normalized to EIP-55 checksum case.
+ */
+export type EvmChecksumAddress = string;
+
+/**
+ * Hyperliquid L1 spot token identifier: 0x followed by 32–40 hex characters,
+ * normalized to lowercase.
+ */
+export type HyperliquidTokenAddress = string;
+
 /**
  * A unique identifier for a key quorum.
  */
@@ -58,6 +79,11 @@ export interface OwnerInputUser {
  */
 export type P256PublicKey = string;
 
+/**
+ * Solana address: base58-encoded public key (32 bytes).
+ */
+export type SolanaAddress = string;
+
 /**
  * A simple success response.
  */
@@ -65,15 +91,26 @@ export interface SuccessResponse {
   success: boolean;
 }
 
+/**
+ * Tron address: base58check-encoded, starting with T, 34 characters.
+ */
+export type TronAddress = string;
+
 export declare namespace Shared {
   export {
+    type BitcoinAddress as BitcoinAddress,
     type CurrencyAmount as CurrencyAmount,
+    type EvmAddress as EvmAddress,
+    type EvmChecksumAddress as EvmChecksumAddress,
+    type HyperliquidTokenAddress as HyperliquidTokenAddress,
     type KeyQuorumID as KeyQuorumID,
     type OwnerIDInput as OwnerIDInput,
     type OwnerInput as OwnerInput,
     type OwnerInputPublicKey as OwnerInputPublicKey,
     type OwnerInputUser as OwnerInputUser,
     type P256PublicKey as P256PublicKey,
+    type SolanaAddress as SolanaAddress,
     type SuccessResponse as SuccessResponse,
+    type TronAddress as TronAddress,
   };
 }

package/src/resources/swaps.ts

@@ -15,10 +15,16 @@ export interface SwapDestination {
   asset_address: string;
 
   /**
-   * CAIP-2 chain identifier for the destination. Must match source chain —
-   * cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+   * CAIP-2 chain identifier for the destination. Defaults to source chain if
+   * omitted. Specify a different chain for cross-chain swaps.
    */
   caip2?: string;
+
+  /**
+   * Address to receive the output tokens. Defaults to the swapping wallet address.
+   * Required when swapping between different chain types (e.g. EVM to Solana).
+   */
+  destination_address?: string;
 }
 
 /**
@@ -31,10 +37,18 @@ export interface SwapQuoteDestination {
   asset_address: string;
 
   /**
-   * CAIP-2 chain identifier for the destination. Must match source chain —
-   * cross-chain swaps are not yet supported. Defaults to source chain if omitted.
+   * CAIP-2 chain identifier for the destination. Defaults to source chain if
+   * omitted. Will result in a cross-chain swap if source and destination chains
+   * differ.
    */
   caip2?: string;
+
+  /**
+   * Address to receive the output tokens. Defaults to the swapping wallet address.
+   * Required when swapping between chains with different address types (e.g. EVM to
+   * Solana).
+   */
+  destination_address?: string;
 }
 
 /**
@@ -61,6 +75,11 @@ export interface SwapQuoteRequestBody {
    */
   amount_type?: WalletsAPI.AmountType;
 
+  /**
+   * Total fees assessed on a transfer, in BPS
+   */
+  fee_configuration?: WalletsAPI.FeeConfiguration;
+
   /**
    * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
    * auto-slippage is used.
@@ -83,7 +102,8 @@ export interface SwapQuoteResponse {
   est_output_amount: string;
 
   /**
-   * Estimated gas cost in base units of the native token.
+   * Estimated gas cost in base units of the native token. @deprecated For
+   * cross-chain swaps, use estimated_gas instead.
    */
   gas_estimate: string;
 
@@ -106,6 +126,27 @@ export interface SwapQuoteResponse {
    * Token address being bought.
    */
   output_token: string;
+
+  /**
+   * Destination chain CAIP-2 identifier for cross-chain swaps.
+   */
+  destination_caip2?: string;
+
+  /**
+   * Estimated fees for the swap. Only present for cross-chain swaps.
+   */
+  estimated_fees?: Array<WalletsAPI.FeeLineItem>;
+
+  /**
+   * 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?: WalletsAPI.Gas;
+
+  /**
+   * Quote expiry as Unix timestamp (seconds). Present for cross-chain quotes.
+   */
+  expires_at?: number;
 }
 
 /**
@@ -132,6 +173,11 @@ export interface SwapRequestBody {
    */
   amount_type?: WalletsAPI.AmountType;
 
+  /**
+   * Total fees assessed on a transfer, in BPS
+   */
+  fee_configuration?: WalletsAPI.FeeConfiguration;
+
   /**
    * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
    */

package/src/resources/users.ts

@@ -406,6 +406,9 @@ export interface LinkedAccountEmailInput {
   type: 'email';
 }
 
+/**
+ * A linked embedded wallet account across all supported chain types.
+ */
 export type LinkedAccountEmbeddedWallet =
   | LinkedAccountEthereumEmbeddedWallet
   | LinkedAccountSolanaEmbeddedWallet

package/src/resources/wallet-actions.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as WalletsAPI from './wallets/wallets';
 
 export class WalletActions extends APIResource {}
 
@@ -272,6 +273,57 @@ export interface EarnIncentiveClaimRequestBody {
   chain: string;
 }
 
+/**
+ * A reward token with claimed and unclaimed amounts.
+ */
+export interface EarnIncentiveRewardEntry {
+  /**
+   * Total amount already claimed, in smallest unit.
+   */
+  amount_claimed: string;
+
+  /**
+   * Amount available to claim on-chain but not yet claimed, in smallest unit.
+   */
+  amount_unclaimed: string;
+
+  /**
+   * Address of the reward token.
+   */
+  token_address: string;
+
+  /**
+   * Symbol of the reward token (e.g. "MORPHO").
+   */
+  token_symbol: string;
+
+  /**
+   * Number of decimals for the reward token.
+   */
+  token_decimals?: number;
+}
+
+/**
+ * Query parameters for fetching incentive rewards.
+ */
+export interface EarnIncentiveRewardsQuery {
+  /**
+   * Chain name to fetch rewards for (e.g. "base", "ethereum").
+   */
+  chain: string;
+}
+
+/**
+ * All incentive rewards for a wallet, with claimed and unclaimed amounts per
+ * token.
+ */
+export interface EarnIncentiveRewardsResponse {
+  /**
+   * Reward tokens with their claimed and unclaimed amounts.
+   */
+  rewards: Array<EarnIncentiveRewardEntry>;
+}
+
 /**
  * A specific reward token and amount associated with an earn incentive claim.
  */
@@ -642,11 +694,38 @@ export interface SwapActionResponse {
    */
   wallet_id: string;
 
+  /**
+   * Destination chain CAIP-2 identifier. Present for cross-chain swaps.
+   */
+  destination_caip2?: string;
+
+  /**
+   * Estimated fee breakdown from the provider quote.
+   */
+  estimated_fees?: Array<WalletsAPI.FeeLineItem>;
+
+  /**
+   * 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?: WalletsAPI.Gas;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
   failure_reason?: FailureReason;
 
+  /**
+   * Actual fees paid for the swap. Populated after on-chain confirmation.
+   */
+  fees?: Array<WalletsAPI.FeeLineItem>;
+
+  /**
+   * Gas cost for a blockchain action. Includes both raw base-unit amount and a
+   * human-readable decimal string, plus the gas token symbol.
+   */
+  gas?: WalletsAPI.Gas;
+
   /**
    * The steps of the wallet action. Only returned if `?include=steps` is provided.
    */
@@ -705,11 +784,33 @@ export interface TransferActionResponse {
    */
   destination_chain?: string;
 
+  /**
+   * Estimated fee breakdown from the provider quote.
+   */
+  estimated_fees?: Array<WalletsAPI.FeeLineItem>;
+
+  /**
+   * 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?: WalletsAPI.Gas;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
   failure_reason?: FailureReason;
 
+  /**
+   * Actual fees paid for the transfer. Populated after on-chain confirmation.
+   */
+  fees?: Array<WalletsAPI.FeeLineItem>;
+
+  /**
+   * Gas cost for a blockchain action. Includes both raw base-unit amount and a
+   * human-readable decimal string, plus the gas token symbol.
+   */
+  gas?: WalletsAPI.Gas;
+
   /**
    * Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
    * cross-chain transfers until the source amount is determined.
@@ -793,6 +894,9 @@ export declare namespace WalletActions {
     type EarnDepositRequestBody as EarnDepositRequestBody,
     type EarnIncentiveClaimActionResponse as EarnIncentiveClaimActionResponse,
     type EarnIncentiveClaimRequestBody as EarnIncentiveClaimRequestBody,
+    type EarnIncentiveRewardEntry as EarnIncentiveRewardEntry,
+    type EarnIncentiveRewardsQuery as EarnIncentiveRewardsQuery,
+    type EarnIncentiveRewardsResponse as EarnIncentiveRewardsResponse,
     type EarnIncetiveClaimRewardEntry as EarnIncetiveClaimRewardEntry,
     type EarnWithdrawActionResponse as EarnWithdrawActionResponse,
     type EarnWithdrawRequestBody as EarnWithdrawRequestBody,

package/src/resources/wallets/index.ts

@@ -18,6 +18,7 @@ export {
   type CustodialWalletCreateInput,
   type CustodialWalletProvider,
   type CustomTokenTransferSource,
+  type DeveloperFee,
   type EthereumPersonalSignRpcInput,
   type EthereumPersonalSignRpcInputParams,
   type EthereumPersonalSignRpcResponse,
@@ -61,7 +62,10 @@ export {
   type ExportSeedPhraseRpcResponse,
   type ExportType,
   type ExtendedChainType,
+  type FeeConfiguration,
+  type FeeLineItem,
   type FirstClassChainType,
+  type Gas,
   type GetByWalletAddressRequestBody,
   type HDInitInput,
   type HDPath,
@@ -77,6 +81,7 @@ export {
   type PrivateKeyExportResponse,
   type PrivateKeyInitInput,
   type PrivateKeySubmitInput,
+  type PrivyFee,
   type Quantity,
   type RawSignBytesEncoding,
   type RawSignBytesHashFunction,
@@ -87,6 +92,7 @@ export {
   type RawSignResponse,
   type RawSignResponseData,
   type RecipientPublicKey,
+  type RelayerFee,
   type SeedPhraseExportInput,
   type SeedPhraseExportResponse,
   type SigningAlgorithm,
@@ -156,8 +162,11 @@ export {
   type TokenOutput,
   type TokenTransferDestination,
   type TokenTransferSource,
+  type TotalFeeConfigurationBps,
   type TransactionDetail,
   type TransactionTokenAddressInput,
+  type TransferQuoteRequestBody,
+  type TransferQuoteResponse,
   type TransferReceivedTransactionDetail,
   type TransferRequestBody,
   type TransferSentTransactionDetail,