@privy-io/api-types 0.14.0 → 0.16.0

package/src/resources/policies.ts

@@ -87,7 +87,17 @@ export interface AggregationCondition {
 /**
  * Operator to use for policy conditions.
  */
-export type ConditionOperator = 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'in_condition_set';
+export type ConditionOperator =
+  | 'eq'
+  | 'gt'
+  | 'gte'
+  | 'lt'
+  | 'lte'
+  | 'in'
+  | 'in_condition_set'
+  | 'contains'
+  | 'starts_with'
+  | 'ends_with';
 
 /**
  * A condition set for grouping related condition values.
@@ -112,7 +122,7 @@ export interface ConditionSet {
   /**
    * A unique identifier for a key quorum.
    */
-  owner_id: SharedAPI.KeyQuorumID;
+  owner_id: SharedAPI.KeyQuorumID | null;
 }
 
 /**
@@ -205,8 +215,8 @@ export interface ConditionSetItemsResponse {
 }
 
 /**
- * Request body for creating a condition set. Exactly one of `owner` or `owner_id`
- * is required.
+ * Request body for creating a condition set. Optionally provide `owner` or
+ * `owner_id` (but not both) to specify ownership.
  */
 export interface ConditionSetRequestBody {
   /**
@@ -342,7 +352,11 @@ export interface EthereumTypedDataMessageCondition {
    */
   operator: ConditionOperator;
 
-  typed_data: EthereumTypedDataMessageCondition.TypedData;
+  /**
+   * The typed data structure containing EIP-712 types and the primary type for typed
+   * data message policy conditions.
+   */
+  typed_data: TypedDataInput;
 
   /**
    * Value to compare against in a policy condition. Can be a single string or an
@@ -351,17 +365,34 @@ export interface EthereumTypedDataMessageCondition {
   value: ConditionValue;
 }
 
-export namespace EthereumTypedDataMessageCondition {
-  export interface TypedData {
-    primary_type: string;
+/**
+ * Condition on the message being signed (e.g. in personal_sign).
+ */
+export interface MessageSigningCondition {
+  /**
+   * Supported fields for message signing conditions.
+   */
+  field: MessageSigningField;
 
-    /**
-     * The type definitions for EIP-712 typed data signing.
-     */
-    types: WalletsAPI.TypedDataTypesInputParams;
-  }
+  field_source: 'message';
+
+  /**
+   * 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;
 }
 
+/**
+ * Supported fields for message signing conditions.
+ */
+export type MessageSigningField = 'content' | 'byte_length';
+
 /**
  * A policy for controlling wallet operations.
  */
@@ -388,9 +419,9 @@ export interface Policy {
   name: string;
 
   /**
-   * The key quorum ID of the owner of the policy.
+   * A unique identifier for a key quorum.
    */
-  owner_id: string | null;
+  owner_id: SharedAPI.KeyQuorumID | null;
 
   rules: Array<PolicyRuleResponse>;
 
@@ -436,6 +467,7 @@ export type PolicyCondition =
   | EthereumTypedDataDomainCondition
   | EthereumTypedDataMessageCondition
   | Ethereum7702AuthorizationCondition
+  | TempoTransactionCondition
   | SolanaProgramInstructionCondition
   | SolanaSystemProgramInstructionCondition
   | SolanaTokenProgramInstructionCondition
@@ -445,7 +477,8 @@ export type PolicyCondition =
   | SuiTransactionCommandCondition
   | SuiTransferObjectsCommandCondition
   | ActionRequestBodyCondition
-  | AggregationCondition;
+  | AggregationCondition
+  | MessageSigningCondition;
 
 /**
  * Method the rule applies to.
@@ -455,13 +488,16 @@ export type PolicyMethod =
   | 'eth_signTransaction'
   | 'eth_signUserOperation'
   | 'eth_signTypedData_v4'
+  | 'personal_sign'
   | 'eth_sign7702Authorization'
   | 'wallet_sendCalls'
   | 'signTransaction'
   | 'signAndSendTransaction'
+  | 'signMessage'
   | 'exportPrivateKey'
   | 'exportSeedPhrase'
   | 'signTransactionBytes'
+  | 'signRawMessageBytes'
   | 'earn_deposit'
   | 'earn_withdraw'
   | 'transfer'
@@ -689,6 +725,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.
  */
@@ -744,6 +816,19 @@ export interface TronTransactionCondition {
   value: ConditionValue;
 }
 
+/**
+ * The typed data structure containing EIP-712 types and the primary type for typed
+ * data message policy conditions.
+ */
+export interface TypedDataInput {
+  primary_type: string;
+
+  /**
+   * The type definitions for EIP-712 typed data signing.
+   */
+  types: WalletsAPI.TypedDataTypesInputParams;
+}
+
 /**
  * Request body for updating a condition set. At least one field must be provided.
  * `owner` and `owner_id` are mutually exclusive.
@@ -790,6 +875,8 @@ export declare namespace Policies {
     type EthereumTransactionCondition as EthereumTransactionCondition,
     type EthereumTypedDataDomainCondition as EthereumTypedDataDomainCondition,
     type EthereumTypedDataMessageCondition as EthereumTypedDataMessageCondition,
+    type MessageSigningCondition as MessageSigningCondition,
+    type MessageSigningField as MessageSigningField,
     type Policy as Policy,
     type PolicyAction as PolicyAction,
     type PolicyAuthorizationHeaders as PolicyAuthorizationHeaders,
@@ -807,8 +894,11 @@ 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 TypedDataInput as TypedDataInput,
     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,23 @@ 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 token identifier: 0x followed by either 32 hex characters
+ * (16-byte spot/perps token IDs) or 40 hex characters (20-byte HIP-3 DEX token
+ * IDs), normalized to lowercase.
+ */
+export type HyperliquidTokenAddress = string;
+
 /**
  * A unique identifier for a key quorum.
  */
@@ -58,6 +80,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 +92,41 @@ export interface SuccessResponse {
   success: boolean;
 }
 
+/**
+ * Token identifier string. EVM-shaped 40-hex token addresses normalize to checksum
+ * case, 16-byte Hyperliquid token IDs normalize to lowercase, and all other
+ * identifiers pass through unchanged.
+ */
+export type TokenIdentifier = string;
+
+/**
+ * Tron address: base58check-encoded, starting with T, 34 characters.
+ */
+export type TronAddress = string;
+
+/**
+ * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
+ * prefix.
+ */
+export type TronHexAddress = 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 TokenIdentifier as TokenIdentifier,
+    type TronAddress as TronAddress,
+    type TronHexAddress as TronHexAddress,
   };
 }

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,28 @@ export interface SwapQuoteResponse {
    * Token address being bought.
    */
   output_token: string;
+
+  /**
+   * Destination chain CAIP-2 identifier for cross-chain swaps. Only present 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). Only present for cross-chain quotes.
+   */
+  expires_at?: number;
 }
 
 /**
@@ -132,6 +174,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