@privy-io/api-types 0.9.0 → 0.11.0

package/src/resources/webhooks.ts

@@ -9,168 +9,282 @@ import * as WalletsAPI from './wallets/wallets';
 export class Webhooks extends APIResource {}
 
 /**
- * Payload for the intent.created webhook event.
+ * Bridge metadata for a crypto deposit via liquidation address.
  */
-export interface IntentCreatedWebhookPayload {
-  /**
-   * Unix timestamp when the intent was created.
-   */
-  created_at: number;
+export interface BridgeCryptoDepositMetadata {
+  drain_id: string;
 
   /**
-   * Unix timestamp when the intent expires.
+   * The crypto address of the liquidation address that received the deposit.
    */
-  expires_at: number;
+  liquidation_address: string;
 
-  /**
-   * The unique ID of the intent.
-   */
-  intent_id: string;
+  liquidation_address_id: string;
 
-  /**
-   * Type of intent.
-   */
-  intent_type: IntentsAPI.IntentType;
+  method: 'liquidation_address';
 
   /**
-   * The current status of the intent.
+   * The address that sent the deposit.
    */
-  status: string;
+  source_wallet_address: string;
 
-  /**
-   * The type of webhook event.
-   */
-  type: 'intent.created';
+  type: 'crypto_deposit';
+}
+
+/**
+ * Bridge metadata for a crypto deposit via transfer.
+ */
+export interface BridgeCryptoTransferMetadata {
+  method: 'transfer';
 
   /**
-   * Key quorums that can authorize this intent.
+   * The wallet address that sent the transfer.
    */
-  authorization_details?: Array<IntentsAPI.IntentAuthorization>;
+  source_wallet_address: string;
+
+  transfer_id: string;
+
+  type: 'crypto_deposit';
+}
+
+/**
+ * Bridge metadata for a fiat deposit via virtual account.
+ */
+export interface BridgeFiatDepositMetadata {
+  activity_id: string;
+
+  method: 'virtual_account';
+
+  type: 'fiat_deposit';
+
+  virtual_account_id: string;
+}
+
+/**
+ * Bridge metadata for a fiat deposit via transfer.
+ */
+export interface BridgeFiatTransferMetadata {
+  method: 'transfer';
+
+  transfer_id: string;
+
+  type: 'fiat_deposit';
+}
+
+/**
+ * Metadata about a Bridge transaction associated with a wallet event.
+ */
+export type BridgeMetadata =
+  | BridgeCryptoDepositMetadata
+  | BridgeRefundMetadata
+  | BridgeFiatDepositMetadata
+  | BridgeCryptoTransferMetadata
+  | BridgeFiatTransferMetadata
+  | BridgeTransferRefundMetadata
+  | BridgeStaticMemoDepositMetadata;
+
+/**
+ * Bridge metadata for a refund via liquidation address.
+ */
+export interface BridgeRefundMetadata {
+  drain_id: string;
+
+  liquidation_address_id: string;
+
+  method: 'liquidation_address';
 
   /**
-   * Display name of the user who created the intent.
+   * The original deposit transaction hash that triggered the failed drain.
    */
-  created_by_display_name?: string;
+  original_transaction_hash: string;
+
+  type: 'refund';
+}
+
+/**
+ * Bridge metadata for a fiat deposit via static memo.
+ */
+export interface BridgeStaticMemoDepositMetadata {
+  method: 'static_memo';
+
+  static_memo_event_id: string;
+
+  static_memo_id: string;
+
+  type: 'fiat_deposit';
+}
+
+/**
+ * Bridge metadata for a transfer refund.
+ */
+export interface BridgeTransferRefundMetadata {
+  method: 'transfer';
+
+  transfer_id: string;
+
+  type: 'refund';
 
   /**
-   * The ID of the user who created the intent.
+   * The original transfer transaction hash (if available).
    */
-  created_by_id?: string;
+  original_transaction_hash?: string;
 }
 
 /**
- * Payload for the intent.authorized webhook event.
+ * Payload for the wallet.funds_deposited webhook event.
  */
-export interface IntentAuthorizedWebhookPayload {
+export interface FundsDepositedWebhookPayload {
   /**
-   * Unix timestamp when the authorization was recorded.
+   * The amount transferred, as a stringified bigint.
    */
-  authorized_at: number;
+  amount: string;
 
   /**
-   * Unix timestamp when the intent was created.
+   * An asset involved in a wallet transfer.
    */
-  created_at: number;
+  asset: WalletFundsAsset;
+
+  block: FundsDepositedWebhookPayload.Block;
 
   /**
-   * Unix timestamp when the intent expires.
+   * The CAIP-2 chain identifier.
    */
-  expires_at: number;
+  caip2: string;
 
   /**
-   * The unique ID of the intent.
+   * A unique key for this event.
    */
-  intent_id: string;
+  idempotency_key: string;
 
   /**
-   * Type of intent.
+   * The recipient address.
    */
-  intent_type: IntentsAPI.IntentType;
+  recipient: string;
 
   /**
-   * A leaf member (user or key) of a nested key quorum in an intent authorization.
+   * The sender address.
    */
-  member: IntentsAPI.IntentAuthorizationKeyQuorumMember;
+  sender: string;
 
   /**
-   * The current status of the intent.
+   * The blockchain transaction hash.
    */
-  status: string;
+  transaction_hash: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'intent.authorized';
+  type: 'wallet.funds_deposited';
 
   /**
-   * Display name of the user who created the intent.
+   * The ID of the wallet.
    */
-  created_by_display_name?: string;
+  wallet_id: string;
 
   /**
-   * The ID of the user who created the intent.
+   * Metadata about a Bridge transaction associated with a wallet event.
    */
-  created_by_id?: string;
+  bridge_metadata?: BridgeMetadata;
+
+  /**
+   * The transaction fee paid, as a stringified bigint in the chain's native token.
+   */
+  transaction_fee?: string;
+}
+
+export namespace FundsDepositedWebhookPayload {
+  export interface Block {
+    /**
+     * The block number.
+     */
+    number: number;
+
+    /**
+     * The block timestamp.
+     */
+    timestamp: number;
+  }
 }
 
 /**
- * Payload for the intent.executed webhook event.
+ * Payload for the wallet.funds_withdrawn webhook event.
  */
-export interface IntentExecutedWebhookPayload {
+export interface FundsWithdrawnWebhookPayload {
   /**
-   * Result of the successful intent execution.
+   * The amount transferred, as a stringified bigint.
    */
-  action_result: IntentsAPI.BaseActionResult;
+  amount: string;
 
   /**
-   * Unix timestamp when the intent was created.
+   * An asset involved in a wallet transfer.
    */
-  created_at: number;
+  asset: WalletFundsAsset;
+
+  block: FundsWithdrawnWebhookPayload.Block;
 
   /**
-   * Unix timestamp when the intent expires.
+   * The CAIP-2 chain identifier.
    */
-  expires_at: number;
+  caip2: string;
 
   /**
-   * The unique ID of the intent.
+   * A unique key for this event.
    */
-  intent_id: string;
+  idempotency_key: string;
 
   /**
-   * Type of intent.
+   * The recipient address.
    */
-  intent_type: IntentsAPI.IntentType;
+  recipient: string;
 
   /**
-   * The current status of the intent.
+   * The sender address.
    */
-  status: string;
+  sender: string;
+
+  /**
+   * The blockchain transaction hash.
+   */
+  transaction_hash: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'intent.executed';
+  type: 'wallet.funds_withdrawn';
 
   /**
-   * Display name of the user who created the intent.
+   * The ID of the wallet.
    */
-  created_by_display_name?: string;
+  wallet_id: string;
 
   /**
-   * The ID of the user who created the intent.
+   * The transaction fee paid, as a stringified bigint in the chain's native token.
    */
-  created_by_id?: string;
+  transaction_fee?: string;
+}
+
+export namespace FundsWithdrawnWebhookPayload {
+  export interface Block {
+    /**
+     * The block number.
+     */
+    number: number;
+
+    /**
+     * The block timestamp.
+     */
+    timestamp: number;
+  }
 }
 
 /**
- * Payload for the intent.failed webhook event.
+ * Payload for the intent.authorized webhook event.
  */
-export interface IntentFailedWebhookPayload {
+export interface IntentAuthorizedWebhookPayload {
   /**
-   * Result of the failed intent execution.
+   * Unix timestamp when the authorization was recorded.
    */
-  action_result: IntentsAPI.BaseActionResult;
+  authorized_at: number;
 
   /**
    * Unix timestamp when the intent was created.
@@ -192,6 +306,11 @@ export interface IntentFailedWebhookPayload {
    */
   intent_type: IntentsAPI.IntentType;
 
+  /**
+   * A leaf member (user or key) of a nested key quorum in an intent authorization.
+   */
+  member: IntentsAPI.IntentAuthorizationKeyQuorumMember;
+
   /**
    * The current status of the intent.
    */
@@ -200,7 +319,7 @@ export interface IntentFailedWebhookPayload {
   /**
    * The type of webhook event.
    */
-  type: 'intent.failed';
+  type: 'intent.authorized';
 
   /**
    * Display name of the user who created the intent.
@@ -214,864 +333,874 @@ export interface IntentFailedWebhookPayload {
 }
 
 /**
- * Payload for the mfa.enabled webhook event.
- */
-export interface MfaEnabledWebhookPayload {
-  /**
-   * The MFA method that was enabled.
-   */
-  method: 'sms' | 'totp' | 'passkey';
-
-  /**
-   * The type of webhook event.
-   */
-  type: 'mfa.enabled';
-
-  /**
-   * The ID of the user who enabled MFA.
-   */
-  user_id: string;
-}
-
-/**
- * Payload for the mfa.disabled webhook event.
- */
-export interface MfaDisabledWebhookPayload {
-  /**
-   * The MFA method that was disabled.
-   */
-  method: 'sms' | 'totp' | 'passkey';
-
-  /**
-   * The type of webhook event.
-   */
-  type: 'mfa.disabled';
-
-  /**
-   * The ID of the user who disabled MFA.
-   */
-  user_id: string;
-}
-
-/**
- * Payload for the transaction.broadcasted webhook event.
+ * Payload for the intent.created webhook event.
  */
-export interface TransactionBroadcastedWebhookPayload {
+export interface IntentCreatedWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * Unix timestamp when the intent was created.
    */
-  caip2: string;
+  created_at: number;
 
   /**
-   * The blockchain transaction hash.
+   * Unix timestamp when the intent expires.
    */
-  transaction_hash: string;
+  expires_at: number;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * The unique ID of the intent.
    */
-  transaction_id: string;
+  intent_id: string;
 
   /**
-   * The type of webhook event.
+   * Type of intent.
    */
-  type: 'transaction.broadcasted';
+  intent_type: IntentsAPI.IntentType;
 
   /**
-   * The ID of the wallet that initiated the transaction.
+   * The current status of the intent.
    */
-  wallet_id: string;
+  status: string;
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The type of webhook event.
    */
-  reference_id?: string | null;
-}
+  type: 'intent.created';
 
-/**
- * Payload for the transaction.confirmed webhook event.
- */
-export interface TransactionConfirmedWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * Key quorums that can authorize this intent.
    */
-  caip2: string;
+  authorization_details?: Array<IntentsAPI.IntentAuthorization>;
 
   /**
-   * The blockchain transaction hash.
+   * Display name of the user who created the intent.
    */
-  transaction_hash: string;
+  created_by_display_name?: string;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * The ID of the user who created the intent.
    */
-  transaction_id: string;
+  created_by_id?: string;
+}
 
+/**
+ * Payload for the intent.executed webhook event.
+ */
+export interface IntentExecutedWebhookPayload {
   /**
-   * The type of webhook event.
+   * Result of the successful intent execution.
    */
-  type: 'transaction.confirmed';
+  action_result: IntentsAPI.BaseActionResult;
 
   /**
-   * The ID of the wallet that initiated the transaction.
+   * Unix timestamp when the intent was created.
    */
-  wallet_id: string;
+  created_at: number;
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * Unix timestamp when the intent expires.
    */
-  reference_id?: string | null;
-}
+  expires_at: number;
 
-/**
- * Payload for the transaction.execution_reverted webhook event.
- */
-export interface TransactionExecutionRevertedWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * The unique ID of the intent.
    */
-  caip2: string;
+  intent_id: string;
 
   /**
-   * The blockchain transaction hash.
+   * Type of intent.
    */
-  transaction_hash: string;
+  intent_type: IntentsAPI.IntentType;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * The current status of the intent.
    */
-  transaction_id: string;
+  status: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'transaction.execution_reverted';
+  type: 'intent.executed';
 
   /**
-   * The ID of the wallet that initiated the transaction.
+   * Display name of the user who created the intent.
    */
-  wallet_id: string;
+  created_by_display_name?: string;
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The ID of the user who created the intent.
    */
-  reference_id?: string | null;
+  created_by_id?: string;
 }
 
 /**
- * Payload for the transaction.still_pending webhook event.
+ * Payload for the intent.failed webhook event.
  */
-export interface TransactionStillPendingWebhookPayload {
+export interface IntentFailedWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * Result of the failed intent execution.
    */
-  caip2: string;
+  action_result: IntentsAPI.BaseActionResult;
 
   /**
-   * The blockchain transaction hash.
+   * Unix timestamp when the intent was created.
    */
-  transaction_hash: string;
+  created_at: number;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * Unix timestamp when the intent expires.
    */
-  transaction_id: string;
+  expires_at: number;
+
+  /**
+   * The unique ID of the intent.
+   */
+  intent_id: string;
+
+  /**
+   * Type of intent.
+   */
+  intent_type: IntentsAPI.IntentType;
 
   /**
-   * An unsigned Ethereum transaction object.
+   * The current status of the intent.
    */
-  transaction_request: WalletsAPI.UnsignedEthereumTransaction;
+  status: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'transaction.still_pending';
+  type: 'intent.failed';
 
   /**
-   * The ID of the wallet that initiated the transaction.
+   * Display name of the user who created the intent.
    */
-  wallet_id: string;
+  created_by_display_name?: string;
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The ID of the user who created the intent.
    */
-  reference_id?: string | null;
+  created_by_id?: string;
 }
 
 /**
- * Payload for the transaction.failed webhook event.
+ * Payload for the kraken_embed.quote.cancelled webhook event.
  */
-export interface TransactionFailedWebhookPayload {
+export interface KrakenEmbedQuoteCancelledWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * ISO 8601 timestamp of when the quote was cancelled.
    */
-  caip2: string;
+  cancelled_at: string;
 
   /**
-   * The blockchain transaction hash.
+   * The ID of the cancelled quote.
    */
-  transaction_hash: string;
+  quote_id: string;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * A human-readable description of why the quote was cancelled. Intended for
+   * display and logging purposes only.
    */
-  transaction_id: string;
+  reason: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'transaction.failed';
-
-  /**
-   * The ID of the wallet that initiated the transaction.
-   */
-  wallet_id: string;
+  type: 'kraken_embed.quote.cancelled';
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The ID of the user.
    */
-  reference_id?: string | null;
+  user_id: string;
 }
 
 /**
- * Payload for the transaction.replaced webhook event.
+ * Payload for the kraken_embed.quote_executed webhook event.
  */
-export interface TransactionReplacedWebhookPayload {
-  /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
-   */
-  caip2: string;
-
+export interface KrakenEmbedQuoteExecutedWebhookPayload {
   /**
-   * The blockchain transaction hash.
+   * ISO 8601 timestamp of when the quote was executed.
    */
-  transaction_hash: string;
+  executed_at: string;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * The ID of the executed quote.
    */
-  transaction_id: string;
+  quote_id: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'transaction.replaced';
-
-  /**
-   * The ID of the wallet that initiated the transaction.
-   */
-  wallet_id: string;
+  type: 'kraken_embed.quote.executed';
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The ID of the user.
    */
-  reference_id?: string | null;
+  user_id: string;
 }
 
 /**
- * Payload for the transaction.provider_error webhook event.
+ * Payload for the kraken_embed.quote.execution_failed webhook event.
  */
-export interface TransactionProviderErrorWebhookPayload {
+export interface KrakenEmbedQuoteExecutionFailedWebhookPayload {
   /**
-   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
+   * ISO 8601 timestamp of when the quote execution failed.
    */
-  caip2: string;
+  failed_at: string;
 
   /**
-   * The blockchain transaction hash.
+   * The ID of the quote that failed to execute.
    */
-  transaction_hash: string;
+  quote_id: string;
 
   /**
-   * The Privy-assigned ID for this transaction.
+   * A human-readable description of why the quote execution failed. Intended for
+   * display and logging purposes only.
    */
-  transaction_id: string;
+  reason: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'transaction.provider_error';
-
-  /**
-   * The ID of the wallet that initiated the transaction.
-   */
-  wallet_id: string;
+  type: 'kraken_embed.quote.execution_failed';
 
   /**
-   * Developer-provided reference ID for transaction reconciliation, if one was
-   * provided.
+   * The ID of the user.
    */
-  reference_id?: string | null;
+  user_id: string;
 }
 
 /**
- * Payload for the user_operation.completed webhook event.
+ * Payload for the kraken_embed.user.closed webhook event.
  */
-export interface UserOperationCompletedWebhookPayload {
-  actual_gas_cost: string;
-
-  actual_gas_used: string;
-
-  block_number: number;
-
-  caip2: string;
-
-  log_index: number;
-
-  nonce: string;
-
-  paymaster: string | null;
-
-  sender: string;
-
-  success: boolean;
-
-  transaction_hash: string;
+export interface KrakenEmbedUserClosedWebhookPayload {
+  /**
+   * ISO 8601 timestamp of when the user was closed.
+   */
+  closed_at: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'user_operation.completed';
+  type: 'kraken_embed.user.closed';
 
-  user_op_hash: string;
+  /**
+   * The ID of the user.
+   */
+  user_id: string;
 }
 
 /**
- * Payload for the user.created webhook event.
+ * Payload for the kraken_embed.user.disabled webhook event.
  */
-export interface UserCreatedWebhookPayload {
+export interface KrakenEmbedUserDisabledWebhookPayload {
+  /**
+   * ISO 8601 timestamp of when the user was disabled.
+   */
+  disabled_at: string;
+
   /**
    * The type of webhook event.
    */
-  type: 'user.created';
+  type: 'kraken_embed.user.disabled';
 
   /**
-   * A Privy user object.
+   * The ID of the user.
    */
-  user: UsersAPI.User;
+  user_id: string;
 }
 
 /**
- * Payload for the user.authenticated webhook event.
+ * Payload for the kraken_embed.user.verified webhook event.
  */
-export interface UserAuthenticatedWebhookPayload {
+export interface KrakenEmbedUserVerifiedWebhookPayload {
   /**
-   * A linked account for the user.
+   * The type of webhook event.
    */
-  account: UsersAPI.LinkedAccount;
+  type: 'kraken_embed.user.verified';
 
   /**
-   * The type of webhook event.
+   * The ID of the user.
    */
-  type: 'user.authenticated';
+  user_id: string;
 
   /**
-   * A Privy user object.
+   * ISO 8601 timestamp of when the user was verified.
    */
-  user: UsersAPI.User;
+  verified_at: string;
 }
 
 /**
- * Payload for the user.linked_account webhook event.
+ * Payload for the mfa.disabled webhook event.
  */
-export interface UserLinkedAccountWebhookPayload {
+export interface MfaDisabledWebhookPayload {
   /**
-   * A linked account for the user.
+   * The MFA method that was disabled.
    */
-  account: UsersAPI.LinkedAccount;
+  method: 'sms' | 'totp' | 'passkey';
 
   /**
    * The type of webhook event.
    */
-  type: 'user.linked_account';
+  type: 'mfa.disabled';
 
   /**
-   * A Privy user object.
+   * The ID of the user who disabled MFA.
    */
-  user: UsersAPI.User;
+  user_id: string;
 }
 
 /**
- * Payload for the user.unlinked_account webhook event.
+ * Payload for the mfa.enabled webhook event.
  */
-export interface UserUnlinkedAccountWebhookPayload {
+export interface MfaEnabledWebhookPayload {
   /**
-   * A linked account for the user.
+   * The MFA method that was enabled.
    */
-  account: UsersAPI.LinkedAccount;
+  method: 'sms' | 'totp' | 'passkey';
 
   /**
    * The type of webhook event.
    */
-  type: 'user.unlinked_account';
+  type: 'mfa.enabled';
 
   /**
-   * A Privy user object.
+   * The ID of the user who enabled MFA.
    */
-  user: UsersAPI.User;
+  user_id: string;
 }
 
 /**
- * Payload for the user.updated_account webhook event.
+ * Payload for the wallet.private_key_export webhook event.
  */
-export interface UserUpdatedAccountWebhookPayload {
+export interface PrivateKeyExportWebhookPayload {
   /**
-   * A linked account for the user.
+   * The type of webhook event.
    */
-  account: UsersAPI.LinkedAccount;
+  type: 'wallet.private_key_export';
 
   /**
-   * The type of webhook event.
+   * The ID of the user who exported the key.
    */
-  type: 'user.updated_account';
+  user_id: string;
 
   /**
-   * A Privy user object.
+   * The address of the wallet.
    */
-  user: UsersAPI.User;
+  wallet_address: string;
+
+  /**
+   * The ID of the wallet.
+   */
+  wallet_id: string;
+
+  export_source?: 'display' | 'client';
 }
 
 /**
- * Payload for the user.transferred_account webhook event.
+ * Payload for the wallet.seed_phrase_export webhook event.
  */
-export interface UserTransferredAccountWebhookPayload {
+export interface SeedPhraseExportWebhookPayload {
   /**
-   * A linked account for the user.
+   * The type of webhook event.
    */
-  account: UsersAPI.LinkedAccount;
-
-  deletedUser: true;
+  type: 'wallet.seed_phrase_export';
 
-  fromUser: UserTransferredAccountWebhookPayload.FromUser;
+  /**
+   * The ID of the user who exported the seed phrase.
+   */
+  user_id: string;
 
   /**
-   * A Privy user object.
+   * The address of the wallet.
    */
-  toUser: UsersAPI.User;
+  wallet_address: string;
 
   /**
-   * The type of webhook event.
+   * The ID of the wallet.
    */
-  type: 'user.transferred_account';
-}
+  wallet_id: string;
 
-export namespace UserTransferredAccountWebhookPayload {
-  export interface FromUser {
-    id: string;
-  }
+  export_source?: 'display' | 'client';
 }
 
 /**
- * Payload for the user.wallet_created webhook event.
+ * Payload for the transaction.broadcasted webhook event.
  */
-export interface UserWalletCreatedWebhookPayload {
+export interface TransactionBroadcastedWebhookPayload {
   /**
-   * The type of webhook event.
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  type: 'user.wallet_created';
+  caip2: string;
 
   /**
-   * A Privy user object.
+   * The blockchain transaction hash.
    */
-  user: UsersAPI.User;
+  transaction_hash: string;
 
   /**
-   * Base schema for wallet accounts linked to the user.
+   * The Privy-assigned ID for this transaction.
    */
-  wallet: UsersAPI.LinkedAccountBaseWallet;
-}
+  transaction_id: string;
 
-/**
- * Payload for the wallet_action.swap.created webhook event.
- */
-export interface WalletActionSwapCreatedWebhookPayload {
   /**
-   * Type of wallet action
+   * The type of webhook event.
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  type: 'transaction.broadcasted';
 
   /**
-   * Chain identifier.
+   * The ID of the wallet that initiated the transaction.
    */
-  caip2: string;
+  wallet_id: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
    */
-  input_amount: string | null;
+  reference_id?: string | null;
+}
 
+/**
+ * Payload for the transaction.confirmed webhook event.
+ */
+export interface TransactionConfirmedWebhookPayload {
   /**
-   * Token address being sold.
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  input_token: string;
+  caip2: string;
 
   /**
-   * Token address being bought.
+   * The blockchain transaction hash.
    */
-  output_token: string;
+  transaction_hash: string;
 
   /**
-   * Status of a wallet action.
+   * The Privy-assigned ID for this transaction.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  transaction_id: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.swap.created';
+  type: 'transaction.confirmed';
 
   /**
-   * The ID of the wallet action.
+   * The ID of the wallet that initiated the transaction.
    */
-  wallet_action_id: string;
+  wallet_id: string;
 
   /**
-   * The ID of the wallet involved in the action.
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
    */
-  wallet_id: string;
+  reference_id?: string | null;
 }
 
 /**
- * Payload for the wallet_action.swap.succeeded webhook event.
+ * Payload for the transaction.execution_reverted webhook event.
  */
-export interface WalletActionSwapSucceededWebhookPayload {
+export interface TransactionExecutionRevertedWebhookPayload {
   /**
-   * Type of wallet action
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  caip2: string;
 
   /**
-   * Chain identifier.
+   * The blockchain transaction hash.
    */
-  caip2: string;
+  transaction_hash: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * The Privy-assigned ID for this transaction.
    */
-  input_amount: string | null;
+  transaction_id: string;
 
   /**
-   * Token address being sold.
+   * The type of webhook event.
    */
-  input_token: string;
+  type: 'transaction.execution_reverted';
 
   /**
-   * Amount of output token received, in base units. Populated after on-chain
-   * confirmation.
+   * The ID of the wallet that initiated the transaction.
    */
-  output_amount: string | null;
+  wallet_id: string;
 
   /**
-   * Token address being bought.
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
    */
-  output_token: string;
+  reference_id?: string | null;
+}
 
+/**
+ * Payload for the transaction.failed webhook event.
+ */
+export interface TransactionFailedWebhookPayload {
   /**
-   * Status of a wallet action.
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  caip2: string;
 
   /**
-   * The steps of the wallet action, including transaction hashes.
+   * The blockchain transaction hash.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  transaction_hash: string;
 
   /**
-   * The type of webhook event.
+   * The Privy-assigned ID for this transaction.
    */
-  type: 'wallet_action.swap.succeeded';
+  transaction_id: string;
 
   /**
-   * The ID of the wallet action.
+   * The type of webhook event.
    */
-  wallet_action_id: string;
+  type: 'transaction.failed';
 
   /**
-   * The ID of the wallet involved in the action.
+   * The ID of the wallet that initiated the transaction.
    */
   wallet_id: string;
+
+  /**
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
+   */
+  reference_id?: string | null;
 }
 
 /**
- * Payload for the wallet_action.swap.rejected webhook event.
+ * Payload for the transaction.provider_error webhook event.
  */
-export interface WalletActionSwapRejectedWebhookPayload {
+export interface TransactionProviderErrorWebhookPayload {
   /**
-   * Type of wallet action
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  caip2: string;
 
   /**
-   * Chain identifier.
+   * The blockchain transaction hash.
    */
-  caip2: string;
+  transaction_hash: string;
 
   /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * The Privy-assigned ID for this transaction.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  transaction_id: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * The type of webhook event.
    */
-  input_amount: string | null;
+  type: 'transaction.provider_error';
 
   /**
-   * Token address being sold.
+   * The ID of the wallet that initiated the transaction.
    */
-  input_token: string;
+  wallet_id: string;
 
   /**
-   * Token address being bought.
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
    */
-  output_token: string;
+  reference_id?: string | null;
+}
 
+/**
+ * Payload for the transaction.replaced webhook event.
+ */
+export interface TransactionReplacedWebhookPayload {
   /**
-   * Status of a wallet action.
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  caip2: string;
 
   /**
-   * The steps of the wallet action at the time of rejection.
+   * The blockchain transaction hash.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  transaction_hash: string;
 
   /**
-   * The type of webhook event.
+   * The Privy-assigned ID for this transaction.
    */
-  type: 'wallet_action.swap.rejected';
+  transaction_id: string;
 
   /**
-   * The ID of the wallet action.
+   * The type of webhook event.
    */
-  wallet_action_id: string;
+  type: 'transaction.replaced';
 
   /**
-   * The ID of the wallet involved in the action.
+   * The ID of the wallet that initiated the transaction.
    */
   wallet_id: string;
+
+  /**
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
+   */
+  reference_id?: string | null;
 }
 
 /**
- * Payload for the wallet_action.swap.failed webhook event.
+ * Payload for the transaction.still_pending webhook event.
  */
-export interface WalletActionSwapFailedWebhookPayload {
-  /**
-   * Type of wallet action
-   */
-  action_type: WalletActionsAPI.WalletActionType;
-
+export interface TransactionStillPendingWebhookPayload {
   /**
-   * Chain identifier.
+   * The CAIP-2 chain identifier (e.g., eip155:1 for Ethereum mainnet).
    */
   caip2: string;
 
   /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * The blockchain transaction hash.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  transaction_hash: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * The Privy-assigned ID for this transaction.
    */
-  input_amount: string | null;
+  transaction_id: string;
 
   /**
-   * Token address being sold.
+   * An unsigned standard Ethereum transaction object. Supports EVM transaction types
+   * 0, 1, 2, and 4.
    */
-  input_token: string;
+  transaction_request: WalletsAPI.UnsignedStandardEthereumTransaction;
 
   /**
-   * Token address being bought.
+   * The type of webhook event.
    */
-  output_token: string;
+  type: 'transaction.still_pending';
 
   /**
-   * Status of a wallet action.
+   * The ID of the wallet that initiated the transaction.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  wallet_id: string;
 
   /**
-   * The steps of the wallet action. Completed steps will have transaction hashes;
-   * the failing step will have a failure_reason.
+   * Developer-provided reference ID for transaction reconciliation, if one was
+   * provided.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  reference_id?: string | null;
+}
 
+/**
+ * Payload for the user.authenticated webhook event.
+ */
+export interface UserAuthenticatedWebhookPayload {
   /**
-   * The type of webhook event.
+   * A linked account for the user.
    */
-  type: 'wallet_action.swap.failed';
+  account: UsersAPI.LinkedAccount;
 
   /**
-   * The ID of the wallet action.
+   * The type of webhook event.
    */
-  wallet_action_id: string;
+  type: 'user.authenticated';
 
   /**
-   * The ID of the wallet involved in the action.
+   * A Privy user object.
    */
-  wallet_id: string;
+  user: UsersAPI.User;
 }
 
 /**
- * Payload for the wallet_action.transfer.created webhook event.
+ * Payload for the user.created webhook event.
  */
-export interface WalletActionTransferCreatedWebhookPayload {
+export interface UserCreatedWebhookPayload {
   /**
-   * Type of wallet action
+   * The type of webhook event.
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  type: 'user.created';
 
   /**
-   * Recipient address.
+   * A Privy user object.
    */
-  destination_address: string;
+  user: UsersAPI.User;
+}
 
+/**
+ * Payload for the user.linked_account webhook event.
+ */
+export interface UserLinkedAccountWebhookPayload {
   /**
-   * Decimal amount as provided by the user (e.g. "1.5").
+   * A linked account for the user.
    */
-  source_amount: string;
+  account: UsersAPI.LinkedAccount;
 
   /**
-   * Asset identifier (e.g. "usdc", "eth").
+   * The type of webhook event.
    */
-  source_asset: string;
+  type: 'user.linked_account';
 
   /**
-   * Chain name (e.g. "base", "ethereum").
+   * A Privy user object.
    */
-  source_chain: string;
+  user: UsersAPI.User;
+}
+
+/**
+ * Payload for the user_operation.completed webhook event.
+ */
+export interface UserOperationCompletedWebhookPayload {
+  actual_gas_cost: string;
+
+  actual_gas_used: string;
+
+  block_number: number;
+
+  caip2: string;
+
+  log_index: number;
+
+  nonce: string;
+
+  paymaster: string | null;
+
+  sender: string;
+
+  success: boolean;
+
+  transaction_hash: string;
 
   /**
-   * Status of a wallet action.
+   * The type of webhook event.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  type: 'user_operation.completed';
+
+  user_op_hash: string;
+}
 
+/**
+ * Payload for the user.transferred_account webhook event.
+ */
+export interface UserTransferredAccountWebhookPayload {
   /**
-   * The type of webhook event.
+   * A linked account for the user.
    */
-  type: 'wallet_action.transfer.created';
+  account: UsersAPI.LinkedAccount;
+
+  deletedUser: true;
+
+  fromUser: UserTransferredAccountWebhookPayload.FromUser;
 
   /**
-   * The ID of the wallet action.
+   * A Privy user object.
    */
-  wallet_action_id: string;
+  toUser: UsersAPI.User;
 
   /**
-   * The ID of the wallet involved in the action.
+   * The type of webhook event.
    */
-  wallet_id: string;
+  type: 'user.transferred_account';
+}
+
+export namespace UserTransferredAccountWebhookPayload {
+  export interface FromUser {
+    id: string;
+  }
 }
 
 /**
- * Payload for the wallet_action.transfer.succeeded webhook event.
+ * Payload for the user.unlinked_account webhook event.
  */
-export interface WalletActionTransferSucceededWebhookPayload {
-  /**
-   * Type of wallet action
-   */
-  action_type: WalletActionsAPI.WalletActionType;
-
+export interface UserUnlinkedAccountWebhookPayload {
   /**
-   * Recipient address.
+   * A linked account for the user.
    */
-  destination_address: string;
+  account: UsersAPI.LinkedAccount;
 
   /**
-   * Decimal amount as provided by the user (e.g. "1.5").
+   * The type of webhook event.
    */
-  source_amount: string;
+  type: 'user.unlinked_account';
 
   /**
-   * Asset identifier (e.g. "usdc", "eth").
+   * A Privy user object.
    */
-  source_asset: string;
+  user: UsersAPI.User;
+}
 
+/**
+ * Payload for the user.updated_account webhook event.
+ */
+export interface UserUpdatedAccountWebhookPayload {
   /**
-   * Chain name (e.g. "base", "ethereum").
+   * A linked account for the user.
    */
-  source_chain: string;
+  account: UsersAPI.LinkedAccount;
 
   /**
-   * Status of a wallet action.
+   * The type of webhook event.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  type: 'user.updated_account';
 
   /**
-   * The steps of the wallet action, including transaction hashes.
+   * A Privy user object.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  user: UsersAPI.User;
+}
 
+/**
+ * Payload for the user.wallet_created webhook event.
+ */
+export interface UserWalletCreatedWebhookPayload {
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.transfer.succeeded';
+  type: 'user.wallet_created';
 
   /**
-   * The ID of the wallet action.
+   * A Privy user object.
    */
-  wallet_action_id: string;
+  user: UsersAPI.User;
 
   /**
-   * The ID of the wallet involved in the action.
+   * Base schema for wallet accounts linked to the user.
    */
-  wallet_id: string;
+  wallet: UsersAPI.LinkedAccountBaseWallet;
 }
 
 /**
- * Payload for the wallet_action.transfer.rejected webhook event.
+ * Payload for the wallet_action.earn_deposit.created webhook event.
  */
-export interface WalletActionTransferRejectedWebhookPayload {
+export interface WalletActionEarnDepositCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * Recipient address.
-   */
-  destination_address: string;
-
-  /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * Underlying asset token address.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  asset_address: string;
 
   /**
-   * Decimal amount as provided by the user (e.g. "1.5").
+   * CAIP-2 chain identifier.
    */
-  source_amount: string;
+  caip2: string;
 
   /**
-   * Asset identifier (e.g. "usdc", "eth").
+   * Base-unit amount of asset deposited (e.g. "1500000").
    */
-  source_asset: string;
+  raw_amount: string;
 
   /**
-   * Chain name (e.g. "base", "ethereum").
+   * The status of the wallet action.
    */
-  source_chain: string;
+  status: 'pending';
 
   /**
-   * Status of a wallet action.
+   * The type of webhook event.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  type: 'wallet_action.earn_deposit.created';
 
   /**
-   * The steps of the wallet action at the time of rejection.
+   * ERC-4626 vault contract address.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  vault_address: string;
 
   /**
-   * The type of webhook event.
+   * The vault ID.
    */
-  type: 'wallet_action.transfer.rejected';
+  vault_id: string;
 
   /**
    * The ID of the wallet action.
@@ -1082,21 +1211,44 @@ export interface WalletActionTransferRejectedWebhookPayload {
    * The ID of the wallet involved in the action.
    */
   wallet_id: string;
+
+  /**
+   * Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
+   * the token is known in the asset registry.
+   */
+  amount?: string;
+
+  /**
+   * Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
+   * the asset registry.
+   */
+  asset?: string;
+
+  /**
+   * Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
+   * present when the token is known in the asset registry.
+   */
+  decimals?: number;
 }
 
 /**
- * Payload for the wallet_action.transfer.failed webhook event.
+ * Payload for the wallet_action.earn_deposit.failed webhook event.
  */
-export interface WalletActionTransferFailedWebhookPayload {
+export interface WalletActionEarnDepositFailedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * Recipient address.
+   * Underlying asset token address.
    */
-  destination_address: string;
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
 
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
@@ -1104,51 +1256,69 @@ export interface WalletActionTransferFailedWebhookPayload {
   failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * Decimal amount as provided by the user (e.g. "1.5").
+   * Base-unit amount of asset deposited (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * The status of the wallet action.
+   */
+  status: 'failed';
+
+  /**
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
    */
-  source_amount: string;
+  type: 'wallet_action.earn_deposit.failed';
 
   /**
-   * Asset identifier (e.g. "usdc", "eth").
+   * ERC-4626 vault contract address.
    */
-  source_asset: string;
+  vault_address: string;
 
   /**
-   * Chain name (e.g. "base", "ethereum").
+   * The vault ID.
    */
-  source_chain: string;
+  vault_id: string;
 
   /**
-   * Status of a wallet action.
+   * The ID of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  wallet_action_id: string;
 
   /**
-   * The steps of the wallet action. Completed steps will have transaction hashes;
-   * the failing step will have a failure_reason.
+   * The ID of the wallet involved in the action.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  wallet_id: string;
 
   /**
-   * The type of webhook event.
+   * Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
+   * the token is known in the asset registry.
    */
-  type: 'wallet_action.transfer.failed';
+  amount?: string;
 
   /**
-   * The ID of the wallet action.
+   * Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
+   * the asset registry.
    */
-  wallet_action_id: string;
+  asset?: string;
 
   /**
-   * The ID of the wallet involved in the action.
+   * Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
+   * present when the token is known in the asset registry.
    */
-  wallet_id: string;
+  decimals?: number;
 }
 
 /**
- * Payload for the wallet_action.earn_deposit.created webhook event.
+ * Payload for the wallet_action.earn_deposit.rejected webhook event.
  */
-export interface WalletActionEarnDepositCreatedWebhookPayload {
+export interface WalletActionEarnDepositRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
@@ -1164,20 +1334,30 @@ export interface WalletActionEarnDepositCreatedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: WalletActionsAPI.FailureReason;
+
   /**
    * Base-unit amount of asset deposited (e.g. "1500000").
    */
   raw_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
+   */
+  status: 'rejected';
+
+  /**
+   * The steps of the wallet action at the time of rejection.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_deposit.created';
+  type: 'wallet_action.earn_deposit.rejected';
 
   /**
    * ERC-4626 vault contract address.
@@ -1248,9 +1428,9 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
   share_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'succeeded';
 
   /**
    * The steps of the wallet action, including transaction hashes.
@@ -1302,106 +1482,109 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_deposit.rejected webhook event.
+ * Payload for the wallet_action.earn_incentive_claim.created webhook event.
  */
-export interface WalletActionEarnDepositRejectedWebhookPayload {
+export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * Underlying asset token address.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  asset_address: string;
+  chain: string;
 
   /**
-   * CAIP-2 chain identifier.
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  caip2: string;
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * The status of the wallet action.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  status: 'pending';
 
   /**
-   * Base-unit amount of asset deposited (e.g. "1500000").
+   * The type of webhook event.
    */
-  raw_amount: string;
+  type: 'wallet_action.earn_incentive_claim.created';
 
   /**
-   * Status of a wallet action.
+   * The ID of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  wallet_action_id: string;
 
   /**
-   * The steps of the wallet action at the time of rejection.
+   * The ID of the wallet involved in the action.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  wallet_id: string;
+}
 
+/**
+ * Payload for the wallet_action.earn_incentive_claim.failed webhook event.
+ */
+export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
   /**
-   * The type of webhook event.
+   * Type of wallet action
    */
-  type: 'wallet_action.earn_deposit.rejected';
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * ERC-4626 vault contract address.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  vault_address: string;
+  chain: string;
 
   /**
-   * The vault ID.
+   * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  vault_id: string;
+  failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * The ID of the wallet action.
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  wallet_action_id: string;
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
-   * The ID of the wallet involved in the action.
+   * The status of the wallet action.
    */
-  wallet_id: string;
+  status: 'failed';
 
   /**
-   * Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
-   * the token is known in the asset registry.
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
    */
-  amount?: string;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
-   * Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
-   * the asset registry.
+   * The type of webhook event.
    */
-  asset?: string;
+  type: 'wallet_action.earn_incentive_claim.failed';
 
   /**
-   * Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
-   * present when the token is known in the asset registry.
+   * The ID of the wallet action.
    */
-  decimals?: number;
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
 }
 
 /**
- * Payload for the wallet_action.earn_deposit.failed webhook event.
+ * Payload for the wallet_action.earn_incentive_claim.rejected webhook event.
  */
-export interface WalletActionEarnDepositFailedWebhookPayload {
+export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * Underlying asset token address.
-   */
-  asset_address: string;
-
-  /**
-   * CAIP-2 chain identifier.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  caip2: string;
+  chain: string;
 
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
@@ -1409,63 +1592,79 @@ export interface WalletActionEarnDepositFailedWebhookPayload {
   failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * Base-unit amount of asset deposited (e.g. "1500000").
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  raw_amount: string;
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'rejected';
 
   /**
-   * The steps of the wallet action. Completed steps will have transaction hashes;
-   * the failing step will have a failure_reason.
+   * The steps of the wallet action at the time of rejection.
    */
   steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_deposit.failed';
+  type: 'wallet_action.earn_incentive_claim.rejected';
 
   /**
-   * ERC-4626 vault contract address.
+   * The ID of the wallet action.
    */
-  vault_address: string;
+  wallet_action_id: string;
 
   /**
-   * The vault ID.
+   * The ID of the wallet involved in the action.
    */
-  vault_id: string;
+  wallet_id: string;
+}
 
+/**
+ * Payload for the wallet_action.earn_incentive_claim.succeeded webhook event.
+ */
+export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
   /**
-   * The ID of the wallet action.
+   * Type of wallet action
    */
-  wallet_action_id: string;
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * The ID of the wallet involved in the action.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  wallet_id: string;
+  chain: string;
 
   /**
-   * Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when
-   * the token is known in the asset registry.
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  amount?: string;
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
-   * Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in
-   * the asset registry.
+   * The status of the wallet action.
    */
-  asset?: string;
+  status: 'succeeded';
 
   /**
-   * Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only
-   * present when the token is known in the asset registry.
+   * The steps of the wallet action, including transaction hashes.
    */
-  decimals?: number;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_incentive_claim.succeeded';
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
 }
 
 /**
@@ -1493,9 +1692,9 @@ export interface WalletActionEarnWithdrawCreatedWebhookPayload {
   raw_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'pending';
 
   /**
    * The type of webhook event.
@@ -1542,9 +1741,9 @@ export interface WalletActionEarnWithdrawCreatedWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_withdraw.succeeded webhook event.
+ * Payload for the wallet_action.earn_withdraw.failed webhook event.
  */
-export interface WalletActionEarnWithdrawSucceededWebhookPayload {
+export interface WalletActionEarnWithdrawFailedWebhookPayload {
   /**
    * Type of wallet action
    */
@@ -1561,29 +1760,30 @@ export interface WalletActionEarnWithdrawSucceededWebhookPayload {
   caip2: string;
 
   /**
-   * Base-unit amount of asset withdrawn (e.g. "1500000").
+   * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  raw_amount: string;
+  failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * Vault shares burned in base units.
+   * Base-unit amount of asset withdrawn (e.g. "1500000").
    */
-  share_amount: string;
+  raw_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'failed';
 
   /**
-   * The steps of the wallet action, including transaction hashes.
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
    */
   steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_withdraw.succeeded';
+  type: 'wallet_action.earn_withdraw.failed';
 
   /**
    * ERC-4626 vault contract address.
@@ -1654,9 +1854,9 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
   raw_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'rejected';
 
   /**
    * The steps of the wallet action at the time of rejection.
@@ -1708,9 +1908,9 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_withdraw.failed webhook event.
+ * Payload for the wallet_action.earn_withdraw.succeeded webhook event.
  */
-export interface WalletActionEarnWithdrawFailedWebhookPayload {
+export interface WalletActionEarnWithdrawSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
@@ -1727,30 +1927,29 @@ export interface WalletActionEarnWithdrawFailedWebhookPayload {
   caip2: string;
 
   /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * Base-unit amount of asset withdrawn (e.g. "1500000").
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  raw_amount: string;
 
   /**
-   * Base-unit amount of asset withdrawn (e.g. "1500000").
+   * Vault shares burned in base units.
    */
-  raw_amount: string;
+  share_amount: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'succeeded';
 
   /**
-   * The steps of the wallet action. Completed steps will have transaction hashes;
-   * the failing step will have a failure_reason.
+   * The steps of the wallet action, including transaction hashes.
    */
   steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_withdraw.failed';
+  type: 'wallet_action.earn_withdraw.succeeded';
 
   /**
    * ERC-4626 vault contract address.
@@ -1792,33 +1991,43 @@ export interface WalletActionEarnWithdrawFailedWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_incentive_claim.created webhook event.
+ * Payload for the wallet_action.swap.created webhook event.
  */
-export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
+export interface WalletActionSwapCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * EVM chain name (e.g. "base", "ethereum").
+   * Chain identifier.
    */
-  chain: string;
+  caip2: string;
 
   /**
-   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   * Amount of input token in base units. Populated after on-chain confirmation.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  input_amount: string | null;
+
+  /**
+   * Token address being sold.
+   */
+  input_token: string;
 
   /**
-   * Status of a wallet action.
+   * Token address being bought.
+   */
+  output_token: string;
+
+  /**
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'pending';
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_incentive_claim.created';
+  type: 'wallet_action.swap.created';
 
   /**
    * The ID of the wallet action.
@@ -1832,38 +2041,54 @@ export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_incentive_claim.succeeded webhook event.
+ * Payload for the wallet_action.swap.failed webhook event.
  */
-export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
+export interface WalletActionSwapFailedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: WalletActionsAPI.FailureReason;
+
   /**
-   * Type of wallet action
+   * Amount of input token in base units. Populated after on-chain confirmation.
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  input_amount: string | null;
 
   /**
-   * EVM chain name (e.g. "base", "ethereum").
+   * Token address being sold.
    */
-  chain: string;
+  input_token: string;
 
   /**
-   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   * Token address being bought.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  output_token: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'failed';
 
   /**
-   * The steps of the wallet action, including transaction hashes.
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
    */
   steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_incentive_claim.succeeded';
+  type: 'wallet_action.swap.failed';
 
   /**
    * The ID of the wallet action.
@@ -1877,18 +2102,18 @@ export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_incentive_claim.rejected webhook event.
+ * Payload for the wallet_action.swap.rejected webhook event.
  */
-export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
+export interface WalletActionSwapRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * EVM chain name (e.g. "base", "ethereum").
+   * Chain identifier.
    */
-  chain: string;
+  caip2: string;
 
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
@@ -1896,14 +2121,24 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
   failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   * Amount of input token in base units. Populated after on-chain confirmation.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  input_amount: string | null;
+
+  /**
+   * Token address being sold.
+   */
+  input_token: string;
+
+  /**
+   * Token address being bought.
+   */
+  output_token: string;
 
   /**
-   * Status of a wallet action.
+   * The status of the wallet action.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  status: 'rejected';
 
   /**
    * The steps of the wallet action at the time of rejection.
@@ -1913,7 +2148,7 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_incentive_claim.rejected';
+  type: 'wallet_action.swap.rejected';
 
   /**
    * The ID of the wallet action.
@@ -1927,44 +2162,54 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
 }
 
 /**
- * Payload for the wallet_action.earn_incentive_claim.failed webhook event.
+ * Payload for the wallet_action.swap.succeeded webhook event.
  */
-export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
+export interface WalletActionSwapSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
   action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * EVM chain name (e.g. "base", "ethereum").
+   * Chain identifier.
    */
-  chain: string;
+  caip2: string;
 
   /**
-   * A description of why a wallet action (or a step within a wallet action) failed.
+   * Amount of input token in base units. Populated after on-chain confirmation.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  input_amount: string | null;
 
   /**
-   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   * Token address being sold.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  input_token: string;
 
   /**
-   * Status of a wallet action.
+   * Amount of output token received, in base units. Populated after on-chain
+   * confirmation.
    */
-  status: WalletActionsAPI.WalletActionStatus;
+  output_amount: string | null;
 
   /**
-   * The steps of the wallet action. Completed steps will have transaction hashes;
-   * the failing step will have a failure_reason.
+   * Token address being bought.
+   */
+  output_token: string;
+
+  /**
+   * The status of the wallet action.
+   */
+  status: 'succeeded';
+
+  /**
+   * The steps of the wallet action, including transaction hashes.
    */
   steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet_action.earn_incentive_claim.failed';
+  type: 'wallet_action.swap.succeeded';
 
   /**
    * The ID of the wallet action.
@@ -1978,393 +2223,330 @@ export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
 }
 
 /**
- * A native token asset (e.g. ETH, SOL).
- */
-export interface WalletFundsNativeTokenAsset {
-  address: null;
-
-  type: 'native-token';
-}
-
-/**
- * An ERC-20 token asset.
- */
-export interface WalletFundsErc20Asset {
-  address: string;
-
-  type: 'erc20';
-}
-
-/**
- * A Solana SPL token asset.
- */
-export interface WalletFundsSplAsset {
-  mint: string;
-
-  type: 'spl';
-}
-
-/**
- * A Stellar Asset Contract (SAC) asset.
- */
-export interface WalletFundsSacAsset {
-  address: string;
-
-  type: 'sac';
-}
-
-/**
- * An asset involved in a wallet transfer.
- */
-export type WalletFundsAsset =
-  | WalletFundsNativeTokenAsset
-  | WalletFundsErc20Asset
-  | WalletFundsSplAsset
-  | WalletFundsSacAsset;
-
-/**
- * Bridge metadata for a crypto deposit via liquidation address.
+ * Payload for the wallet_action.transfer.created webhook event.
  */
-export interface BridgeCryptoDepositMetadata {
-  drain_id: string;
-
+export interface WalletActionTransferCreatedWebhookPayload {
   /**
-   * The crypto address of the liquidation address that received the deposit.
+   * Type of wallet action
    */
-  liquidation_address: string;
-
-  liquidation_address_id: string;
-
-  method: 'liquidation_address';
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * The address that sent the deposit.
+   * Recipient address.
    */
-  source_wallet_address: string;
-
-  type: 'crypto_deposit';
-}
-
-/**
- * Bridge metadata for a refund via liquidation address.
- */
-export interface BridgeRefundMetadata {
-  drain_id: string;
-
-  liquidation_address_id: string;
-
-  method: 'liquidation_address';
+  destination_address: string;
 
   /**
-   * The original deposit transaction hash that triggered the failed drain.
+   * Chain name (e.g. "base", "ethereum").
    */
-  original_transaction_hash: string;
-
-  type: 'refund';
-}
-
-/**
- * Bridge metadata for a fiat deposit via virtual account.
- */
-export interface BridgeFiatDepositMetadata {
-  activity_id: string;
-
-  method: 'virtual_account';
-
-  type: 'fiat_deposit';
-
-  virtual_account_id: string;
-}
-
-/**
- * Bridge metadata for a crypto deposit via transfer.
- */
-export interface BridgeCryptoTransferMetadata {
-  method: 'transfer';
+  source_chain: string;
 
   /**
-   * The wallet address that sent the transfer.
+   * The status of the wallet action.
    */
-  source_wallet_address: string;
-
-  transfer_id: string;
-
-  type: 'crypto_deposit';
-}
+  status: 'pending';
 
-/**
- * Bridge metadata for a fiat deposit via transfer.
- */
-export interface BridgeFiatTransferMetadata {
-  method: 'transfer';
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.transfer.created';
 
-  transfer_id: string;
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
 
-  type: 'fiat_deposit';
-}
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
 
-/**
- * Bridge metadata for a transfer refund.
- */
-export interface BridgeTransferRefundMetadata {
-  method: 'transfer';
+  /**
+   * Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
+   * cross-chain transfers until the source amount is determined.
+   */
+  source_amount?: string;
 
-  transfer_id: string;
+  /**
+   * Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated
+   * with a named asset; omitted for custom-token transfers.
+   */
+  source_asset?: string;
 
-  type: 'refund';
+  /**
+   * Token contract address (EVM) or mint address (Solana). Present when the transfer
+   * was initiated with `asset_address`.
+   */
+  source_asset_address?: string;
 
   /**
-   * The original transfer transaction hash (if available).
+   * Number of decimals for the transferred token. Present when the transfer was
+   * initiated with `asset_address` and the decimals were resolved on-chain.
    */
-  original_transaction_hash?: string;
+  source_asset_decimals?: number;
 }
 
 /**
- * Metadata about a Bridge transaction associated with a wallet event.
- */
-export type BridgeMetadata =
-  | BridgeCryptoDepositMetadata
-  | BridgeRefundMetadata
-  | BridgeFiatDepositMetadata
-  | BridgeCryptoTransferMetadata
-  | BridgeFiatTransferMetadata
-  | BridgeTransferRefundMetadata;
-
-/**
- * Payload for the wallet.funds_deposited webhook event.
+ * Payload for the wallet_action.transfer.failed webhook event.
  */
-export interface FundsDepositedWebhookPayload {
+export interface WalletActionTransferFailedWebhookPayload {
   /**
-   * The amount transferred, as a stringified bigint.
+   * Type of wallet action
    */
-  amount: string;
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * An asset involved in a wallet transfer.
+   * Recipient address.
    */
-  asset: WalletFundsAsset;
-
-  block: FundsDepositedWebhookPayload.Block;
+  destination_address: string;
 
   /**
-   * The CAIP-2 chain identifier.
+   * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  caip2: string;
+  failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * A unique key for this event.
+   * Chain name (e.g. "base", "ethereum").
    */
-  idempotency_key: string;
+  source_chain: string;
 
   /**
-   * The recipient address.
+   * The status of the wallet action.
    */
-  recipient: string;
+  status: 'failed';
 
   /**
-   * The sender address.
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
    */
-  sender: string;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
-   * The blockchain transaction hash.
+   * The type of webhook event.
    */
-  transaction_hash: string;
+  type: 'wallet_action.transfer.failed';
 
   /**
-   * The type of webhook event.
+   * The ID of the wallet action.
    */
-  type: 'wallet.funds_deposited';
+  wallet_action_id: string;
 
   /**
-   * The ID of the wallet.
+   * The ID of the wallet involved in the action.
    */
   wallet_id: string;
 
   /**
-   * Metadata about a Bridge transaction associated with a wallet event.
+   * Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
+   * cross-chain transfers until the source amount is determined.
    */
-  bridge_metadata?: BridgeMetadata;
+  source_amount?: string;
 
   /**
-   * The transaction fee paid, as a stringified bigint in the chain's native token.
+   * Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated
+   * with a named asset; omitted for custom-token transfers.
    */
-  transaction_fee?: string;
-}
+  source_asset?: string;
 
-export namespace FundsDepositedWebhookPayload {
-  export interface Block {
-    /**
-     * The block number.
-     */
-    number: number;
+  /**
+   * Token contract address (EVM) or mint address (Solana). Present when the transfer
+   * was initiated with `asset_address`.
+   */
+  source_asset_address?: string;
 
-    /**
-     * The block timestamp.
-     */
-    timestamp: number;
-  }
+  /**
+   * Number of decimals for the transferred token. Present when the transfer was
+   * initiated with `asset_address` and the decimals were resolved on-chain.
+   */
+  source_asset_decimals?: number;
 }
 
 /**
- * Payload for the wallet.funds_withdrawn webhook event.
+ * Payload for the wallet_action.transfer.rejected webhook event.
  */
-export interface FundsWithdrawnWebhookPayload {
+export interface WalletActionTransferRejectedWebhookPayload {
   /**
-   * The amount transferred, as a stringified bigint.
+   * Type of wallet action
    */
-  amount: string;
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * An asset involved in a wallet transfer.
+   * Recipient address.
    */
-  asset: WalletFundsAsset;
-
-  block: FundsWithdrawnWebhookPayload.Block;
+  destination_address: string;
 
   /**
-   * The CAIP-2 chain identifier.
+   * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  caip2: string;
+  failure_reason: WalletActionsAPI.FailureReason;
 
   /**
-   * A unique key for this event.
+   * Chain name (e.g. "base", "ethereum").
    */
-  idempotency_key: string;
+  source_chain: string;
 
   /**
-   * The recipient address.
+   * The status of the wallet action.
    */
-  recipient: string;
+  status: 'rejected';
 
   /**
-   * The sender address.
+   * The steps of the wallet action at the time of rejection.
    */
-  sender: string;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
-   * The blockchain transaction hash.
+   * The type of webhook event.
    */
-  transaction_hash: string;
+  type: 'wallet_action.transfer.rejected';
 
   /**
-   * The type of webhook event.
+   * The ID of the wallet action.
    */
-  type: 'wallet.funds_withdrawn';
+  wallet_action_id: string;
 
   /**
-   * The ID of the wallet.
+   * The ID of the wallet involved in the action.
    */
   wallet_id: string;
 
   /**
-   * The transaction fee paid, as a stringified bigint in the chain's native token.
+   * Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
+   * cross-chain transfers until the source amount is determined.
    */
-  transaction_fee?: string;
-}
+  source_amount?: string;
 
-export namespace FundsWithdrawnWebhookPayload {
-  export interface Block {
-    /**
-     * The block number.
-     */
-    number: number;
+  /**
+   * Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated
+   * with a named asset; omitted for custom-token transfers.
+   */
+  source_asset?: string;
 
-    /**
-     * The block timestamp.
-     */
-    timestamp: number;
-  }
+  /**
+   * Token contract address (EVM) or mint address (Solana). Present when the transfer
+   * was initiated with `asset_address`.
+   */
+  source_asset_address?: string;
+
+  /**
+   * Number of decimals for the transferred token. Present when the transfer was
+   * initiated with `asset_address` and the decimals were resolved on-chain.
+   */
+  source_asset_decimals?: number;
 }
 
 /**
- * Payload for the wallet.private_key_export webhook event.
+ * Payload for the wallet_action.transfer.succeeded webhook event.
  */
-export interface PrivateKeyExportWebhookPayload {
+export interface WalletActionTransferSucceededWebhookPayload {
   /**
-   * The type of webhook event.
+   * Type of wallet action
    */
-  type: 'wallet.private_key_export';
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * The ID of the user who exported the key.
+   * Recipient address.
    */
-  user_id: string;
+  destination_address: string;
 
   /**
-   * The address of the wallet.
+   * Chain name (e.g. "base", "ethereum").
    */
-  wallet_address: string;
+  source_chain: string;
 
   /**
-   * The ID of the wallet.
+   * The status of the wallet action.
    */
-  wallet_id: string;
-
-  export_source?: 'display' | 'client';
-}
+  status: 'succeeded';
 
-/**
- * Payload for the wallet.seed_phrase_export webhook event.
- */
-export interface SeedPhraseExportWebhookPayload {
   /**
-   * The type of webhook event.
+   * The steps of the wallet action, including transaction hashes.
    */
-  type: 'wallet.seed_phrase_export';
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
-   * The ID of the user who exported the seed phrase.
+   * The type of webhook event.
    */
-  user_id: string;
+  type: 'wallet_action.transfer.succeeded';
 
   /**
-   * The address of the wallet.
+   * The ID of the wallet action.
    */
-  wallet_address: string;
+  wallet_action_id: string;
 
   /**
-   * The ID of the wallet.
+   * The ID of the wallet involved in the action.
    */
   wallet_id: string;
 
-  export_source?: 'display' | 'client';
-}
-
-/**
- * Payload for the wallet.recovery_setup webhook event.
- */
-export interface WalletRecoverySetupWebhookPayload {
   /**
-   * The recovery method that was set up.
+   * Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output
+   * cross-chain transfers until the source amount is determined.
    */
-  method:
-    | 'user_passcode_derived_recovery_key'
-    | 'privy_passcode_derived_recovery_key'
-    | 'privy_generated_recovery_key'
-    | 'google_drive_recovery_secret'
-    | 'icloud_recovery_secret'
-    | 'recovery_encryption_key';
+  source_amount?: string;
 
   /**
-   * The type of webhook event.
+   * Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated
+   * with a named asset; omitted for custom-token transfers.
    */
-  type: 'wallet.recovery_setup';
+  source_asset?: string;
 
   /**
-   * The ID of the user.
+   * Token contract address (EVM) or mint address (Solana). Present when the transfer
+   * was initiated with `asset_address`.
    */
-  user_id: string;
+  source_asset_address?: string;
 
   /**
-   * The address of the wallet.
+   * Number of decimals for the transferred token. Present when the transfer was
+   * initiated with `asset_address` and the decimals were resolved on-chain.
    */
-  wallet_address: string;
+  source_asset_decimals?: number;
+}
 
-  /**
-   * The ID of the wallet.
-   */
-  wallet_id: string;
+/**
+ * An asset involved in a wallet transfer.
+ */
+export type WalletFundsAsset =
+  | WalletFundsNativeTokenAsset
+  | WalletFundsErc20Asset
+  | WalletFundsSplAsset
+  | WalletFundsSacAsset;
+
+/**
+ * An ERC-20 token asset.
+ */
+export interface WalletFundsErc20Asset {
+  address: string;
+
+  type: 'erc20';
+}
+
+/**
+ * A native token asset (e.g. ETH, SOL).
+ */
+export interface WalletFundsNativeTokenAsset {
+  address: null;
+
+  type: 'native-token';
+}
+
+/**
+ * A Stellar Asset Contract (SAC) asset.
+ */
+export interface WalletFundsSacAsset {
+  address: string;
+
+  type: 'sac';
+}
+
+/**
+ * A Solana SPL token asset.
+ */
+export interface WalletFundsSplAsset {
+  mint: string;
+
+  type: 'spl';
 }
 
 /**
@@ -2393,79 +2575,41 @@ export interface WalletRecoveredWebhookPayload {
 }
 
 /**
- * Payload for the yield.deposit.confirmed webhook event.
+ * Payload for the wallet.recovery_setup webhook event.
  */
-export interface YieldDepositConfirmedWebhookPayload {
-  assets: string;
-
-  caip2: string;
-
-  owner: string;
-
-  sender: string;
-
-  shares: string;
-
+export interface WalletRecoverySetupWebhookPayload {
   /**
-   * The type of webhook event.
+   * The recovery method that was set up.
    */
-  type: 'yield.deposit.confirmed';
-
-  vault_address: string;
-}
-
-/**
- * Payload for the yield.withdraw.confirmed webhook event.
- */
-export interface YieldWithdrawConfirmedWebhookPayload {
-  assets: string;
-
-  caip2: string;
-
-  owner: string;
-
-  receiver: string;
-
-  sender: string;
-
-  shares: string;
+  method:
+    | 'user_passcode_derived_recovery_key'
+    | 'privy_passcode_derived_recovery_key'
+    | 'privy_generated_recovery_key'
+    | 'google_drive_recovery_secret'
+    | 'icloud_recovery_secret'
+    | 'recovery_encryption_key';
 
   /**
    * The type of webhook event.
    */
-  type: 'yield.withdraw.confirmed';
-
-  vault_address: string;
-}
-
-/**
- * Payload for the yield.claim.confirmed webhook event.
- */
-export interface YieldClaimConfirmedWebhookPayload {
-  caip2: string;
-
-  rewards: Array<YieldClaimConfirmedWebhookPayload.Reward>;
+  type: 'wallet.recovery_setup';
 
-  transaction_id: string;
+  /**
+   * The ID of the user.
+   */
+  user_id: string;
 
   /**
-   * The type of webhook event.
+   * The address of the wallet.
    */
-  type: 'yield.claim.confirmed';
+  wallet_address: string;
 
+  /**
+   * The ID of the wallet.
+   */
   wallet_id: string;
 }
 
-export namespace YieldClaimConfirmedWebhookPayload {
-  export interface Reward {
-    amount: string;
-
-    token_address: string;
-
-    token_symbol: string;
-  }
-}
-
 /**
  * Union of all webhook payload schemas.
  */
@@ -2522,222 +2666,150 @@ export type WebhookPayload =
   | WalletActionEarnIncentiveClaimFailedWebhookPayload;
 
 /**
- * Payload for the kraken_embed.quote_executed webhook event.
+ * Payload for the yield.claim.confirmed webhook event.
  */
-export interface KrakenEmbedQuoteExecutedWebhookPayload {
-  /**
-   * ISO 8601 timestamp of when the quote was executed.
-   */
-  executed_at: string;
+export interface YieldClaimConfirmedWebhookPayload {
+  caip2: string;
 
-  /**
-   * The ID of the executed quote.
-   */
-  quote_id: string;
+  rewards: Array<YieldClaimConfirmedWebhookPayload.Reward>;
+
+  transaction_id: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'kraken_embed.quote.executed';
+  type: 'yield.claim.confirmed';
 
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
+  wallet_id: string;
 }
 
-/**
- * Payload for the kraken_embed.quote.execution_failed webhook event.
- */
-export interface KrakenEmbedQuoteExecutionFailedWebhookPayload {
-  /**
-   * ISO 8601 timestamp of when the quote execution failed.
-   */
-  failed_at: string;
-
-  /**
-   * The ID of the quote that failed to execute.
-   */
-  quote_id: string;
-
-  /**
-   * A human-readable description of why the quote execution failed. Intended for
-   * display and logging purposes only.
-   */
-  reason: string;
+export namespace YieldClaimConfirmedWebhookPayload {
+  export interface Reward {
+    amount: string;
 
-  /**
-   * The type of webhook event.
-   */
-  type: 'kraken_embed.quote.execution_failed';
+    token_address: string;
 
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
+    token_symbol: string;
+  }
 }
 
 /**
- * Payload for the kraken_embed.quote.cancelled webhook event.
+ * Payload for the yield.deposit.confirmed webhook event.
  */
-export interface KrakenEmbedQuoteCancelledWebhookPayload {
-  /**
-   * ISO 8601 timestamp of when the quote was cancelled.
-   */
-  cancelled_at: string;
+export interface YieldDepositConfirmedWebhookPayload {
+  assets: string;
 
-  /**
-   * The ID of the cancelled quote.
-   */
-  quote_id: string;
+  caip2: string;
 
-  /**
-   * A human-readable description of why the quote was cancelled. Intended for
-   * display and logging purposes only.
-   */
-  reason: string;
+  owner: string;
 
-  /**
-   * The type of webhook event.
-   */
-  type: 'kraken_embed.quote.cancelled';
+  sender: string;
 
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
-}
+  shares: string;
 
-/**
- * Payload for the kraken_embed.user.verified webhook event.
- */
-export interface KrakenEmbedUserVerifiedWebhookPayload {
   /**
    * The type of webhook event.
    */
-  type: 'kraken_embed.user.verified';
-
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
+  type: 'yield.deposit.confirmed';
 
-  /**
-   * ISO 8601 timestamp of when the user was verified.
-   */
-  verified_at: string;
+  vault_address: string;
 }
 
 /**
- * Payload for the kraken_embed.user.disabled webhook event.
+ * Payload for the yield.withdraw.confirmed webhook event.
  */
-export interface KrakenEmbedUserDisabledWebhookPayload {
-  /**
-   * ISO 8601 timestamp of when the user was disabled.
-   */
-  disabled_at: string;
+export interface YieldWithdrawConfirmedWebhookPayload {
+  assets: string;
 
-  /**
-   * The type of webhook event.
-   */
-  type: 'kraken_embed.user.disabled';
+  caip2: string;
 
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
-}
+  owner: string;
 
-/**
- * Payload for the kraken_embed.user.closed webhook event.
- */
-export interface KrakenEmbedUserClosedWebhookPayload {
-  /**
-   * ISO 8601 timestamp of when the user was closed.
-   */
-  closed_at: string;
+  receiver: string;
+
+  sender: string;
+
+  shares: string;
 
   /**
    * The type of webhook event.
    */
-  type: 'kraken_embed.user.closed';
+  type: 'yield.withdraw.confirmed';
 
-  /**
-   * The ID of the user.
-   */
-  user_id: string;
+  vault_address: string;
 }
 
 export declare namespace Webhooks {
   export {
-    type IntentCreatedWebhookPayload as IntentCreatedWebhookPayload,
+    type BridgeCryptoDepositMetadata as BridgeCryptoDepositMetadata,
+    type BridgeCryptoTransferMetadata as BridgeCryptoTransferMetadata,
+    type BridgeFiatDepositMetadata as BridgeFiatDepositMetadata,
+    type BridgeFiatTransferMetadata as BridgeFiatTransferMetadata,
+    type BridgeMetadata as BridgeMetadata,
+    type BridgeRefundMetadata as BridgeRefundMetadata,
+    type BridgeStaticMemoDepositMetadata as BridgeStaticMemoDepositMetadata,
+    type BridgeTransferRefundMetadata as BridgeTransferRefundMetadata,
+    type FundsDepositedWebhookPayload as FundsDepositedWebhookPayload,
+    type FundsWithdrawnWebhookPayload as FundsWithdrawnWebhookPayload,
     type IntentAuthorizedWebhookPayload as IntentAuthorizedWebhookPayload,
+    type IntentCreatedWebhookPayload as IntentCreatedWebhookPayload,
     type IntentExecutedWebhookPayload as IntentExecutedWebhookPayload,
     type IntentFailedWebhookPayload as IntentFailedWebhookPayload,
-    type MfaEnabledWebhookPayload as MfaEnabledWebhookPayload,
+    type KrakenEmbedQuoteCancelledWebhookPayload as KrakenEmbedQuoteCancelledWebhookPayload,
+    type KrakenEmbedQuoteExecutedWebhookPayload as KrakenEmbedQuoteExecutedWebhookPayload,
+    type KrakenEmbedQuoteExecutionFailedWebhookPayload as KrakenEmbedQuoteExecutionFailedWebhookPayload,
+    type KrakenEmbedUserClosedWebhookPayload as KrakenEmbedUserClosedWebhookPayload,
+    type KrakenEmbedUserDisabledWebhookPayload as KrakenEmbedUserDisabledWebhookPayload,
+    type KrakenEmbedUserVerifiedWebhookPayload as KrakenEmbedUserVerifiedWebhookPayload,
     type MfaDisabledWebhookPayload as MfaDisabledWebhookPayload,
+    type MfaEnabledWebhookPayload as MfaEnabledWebhookPayload,
+    type PrivateKeyExportWebhookPayload as PrivateKeyExportWebhookPayload,
+    type SeedPhraseExportWebhookPayload as SeedPhraseExportWebhookPayload,
     type TransactionBroadcastedWebhookPayload as TransactionBroadcastedWebhookPayload,
     type TransactionConfirmedWebhookPayload as TransactionConfirmedWebhookPayload,
     type TransactionExecutionRevertedWebhookPayload as TransactionExecutionRevertedWebhookPayload,
-    type TransactionStillPendingWebhookPayload as TransactionStillPendingWebhookPayload,
     type TransactionFailedWebhookPayload as TransactionFailedWebhookPayload,
-    type TransactionReplacedWebhookPayload as TransactionReplacedWebhookPayload,
     type TransactionProviderErrorWebhookPayload as TransactionProviderErrorWebhookPayload,
-    type UserOperationCompletedWebhookPayload as UserOperationCompletedWebhookPayload,
-    type UserCreatedWebhookPayload as UserCreatedWebhookPayload,
+    type TransactionReplacedWebhookPayload as TransactionReplacedWebhookPayload,
+    type TransactionStillPendingWebhookPayload as TransactionStillPendingWebhookPayload,
     type UserAuthenticatedWebhookPayload as UserAuthenticatedWebhookPayload,
+    type UserCreatedWebhookPayload as UserCreatedWebhookPayload,
     type UserLinkedAccountWebhookPayload as UserLinkedAccountWebhookPayload,
+    type UserOperationCompletedWebhookPayload as UserOperationCompletedWebhookPayload,
+    type UserTransferredAccountWebhookPayload as UserTransferredAccountWebhookPayload,
     type UserUnlinkedAccountWebhookPayload as UserUnlinkedAccountWebhookPayload,
     type UserUpdatedAccountWebhookPayload as UserUpdatedAccountWebhookPayload,
-    type UserTransferredAccountWebhookPayload as UserTransferredAccountWebhookPayload,
     type UserWalletCreatedWebhookPayload as UserWalletCreatedWebhookPayload,
-    type WalletActionSwapCreatedWebhookPayload as WalletActionSwapCreatedWebhookPayload,
-    type WalletActionSwapSucceededWebhookPayload as WalletActionSwapSucceededWebhookPayload,
-    type WalletActionSwapRejectedWebhookPayload as WalletActionSwapRejectedWebhookPayload,
-    type WalletActionSwapFailedWebhookPayload as WalletActionSwapFailedWebhookPayload,
-    type WalletActionTransferCreatedWebhookPayload as WalletActionTransferCreatedWebhookPayload,
-    type WalletActionTransferSucceededWebhookPayload as WalletActionTransferSucceededWebhookPayload,
-    type WalletActionTransferRejectedWebhookPayload as WalletActionTransferRejectedWebhookPayload,
-    type WalletActionTransferFailedWebhookPayload as WalletActionTransferFailedWebhookPayload,
     type WalletActionEarnDepositCreatedWebhookPayload as WalletActionEarnDepositCreatedWebhookPayload,
-    type WalletActionEarnDepositSucceededWebhookPayload as WalletActionEarnDepositSucceededWebhookPayload,
-    type WalletActionEarnDepositRejectedWebhookPayload as WalletActionEarnDepositRejectedWebhookPayload,
     type WalletActionEarnDepositFailedWebhookPayload as WalletActionEarnDepositFailedWebhookPayload,
-    type WalletActionEarnWithdrawCreatedWebhookPayload as WalletActionEarnWithdrawCreatedWebhookPayload,
-    type WalletActionEarnWithdrawSucceededWebhookPayload as WalletActionEarnWithdrawSucceededWebhookPayload,
-    type WalletActionEarnWithdrawRejectedWebhookPayload as WalletActionEarnWithdrawRejectedWebhookPayload,
-    type WalletActionEarnWithdrawFailedWebhookPayload as WalletActionEarnWithdrawFailedWebhookPayload,
+    type WalletActionEarnDepositRejectedWebhookPayload as WalletActionEarnDepositRejectedWebhookPayload,
+    type WalletActionEarnDepositSucceededWebhookPayload as WalletActionEarnDepositSucceededWebhookPayload,
     type WalletActionEarnIncentiveClaimCreatedWebhookPayload as WalletActionEarnIncentiveClaimCreatedWebhookPayload,
-    type WalletActionEarnIncentiveClaimSucceededWebhookPayload as WalletActionEarnIncentiveClaimSucceededWebhookPayload,
-    type WalletActionEarnIncentiveClaimRejectedWebhookPayload as WalletActionEarnIncentiveClaimRejectedWebhookPayload,
     type WalletActionEarnIncentiveClaimFailedWebhookPayload as WalletActionEarnIncentiveClaimFailedWebhookPayload,
-    type WalletFundsNativeTokenAsset as WalletFundsNativeTokenAsset,
+    type WalletActionEarnIncentiveClaimRejectedWebhookPayload as WalletActionEarnIncentiveClaimRejectedWebhookPayload,
+    type WalletActionEarnIncentiveClaimSucceededWebhookPayload as WalletActionEarnIncentiveClaimSucceededWebhookPayload,
+    type WalletActionEarnWithdrawCreatedWebhookPayload as WalletActionEarnWithdrawCreatedWebhookPayload,
+    type WalletActionEarnWithdrawFailedWebhookPayload as WalletActionEarnWithdrawFailedWebhookPayload,
+    type WalletActionEarnWithdrawRejectedWebhookPayload as WalletActionEarnWithdrawRejectedWebhookPayload,
+    type WalletActionEarnWithdrawSucceededWebhookPayload as WalletActionEarnWithdrawSucceededWebhookPayload,
+    type WalletActionSwapCreatedWebhookPayload as WalletActionSwapCreatedWebhookPayload,
+    type WalletActionSwapFailedWebhookPayload as WalletActionSwapFailedWebhookPayload,
+    type WalletActionSwapRejectedWebhookPayload as WalletActionSwapRejectedWebhookPayload,
+    type WalletActionSwapSucceededWebhookPayload as WalletActionSwapSucceededWebhookPayload,
+    type WalletActionTransferCreatedWebhookPayload as WalletActionTransferCreatedWebhookPayload,
+    type WalletActionTransferFailedWebhookPayload as WalletActionTransferFailedWebhookPayload,
+    type WalletActionTransferRejectedWebhookPayload as WalletActionTransferRejectedWebhookPayload,
+    type WalletActionTransferSucceededWebhookPayload as WalletActionTransferSucceededWebhookPayload,
+    type WalletFundsAsset as WalletFundsAsset,
     type WalletFundsErc20Asset as WalletFundsErc20Asset,
-    type WalletFundsSplAsset as WalletFundsSplAsset,
+    type WalletFundsNativeTokenAsset as WalletFundsNativeTokenAsset,
     type WalletFundsSacAsset as WalletFundsSacAsset,
-    type WalletFundsAsset as WalletFundsAsset,
-    type BridgeCryptoDepositMetadata as BridgeCryptoDepositMetadata,
-    type BridgeRefundMetadata as BridgeRefundMetadata,
-    type BridgeFiatDepositMetadata as BridgeFiatDepositMetadata,
-    type BridgeCryptoTransferMetadata as BridgeCryptoTransferMetadata,
-    type BridgeFiatTransferMetadata as BridgeFiatTransferMetadata,
-    type BridgeTransferRefundMetadata as BridgeTransferRefundMetadata,
-    type BridgeMetadata as BridgeMetadata,
-    type FundsDepositedWebhookPayload as FundsDepositedWebhookPayload,
-    type FundsWithdrawnWebhookPayload as FundsWithdrawnWebhookPayload,
-    type PrivateKeyExportWebhookPayload as PrivateKeyExportWebhookPayload,
-    type SeedPhraseExportWebhookPayload as SeedPhraseExportWebhookPayload,
-    type WalletRecoverySetupWebhookPayload as WalletRecoverySetupWebhookPayload,
+    type WalletFundsSplAsset as WalletFundsSplAsset,
     type WalletRecoveredWebhookPayload as WalletRecoveredWebhookPayload,
+    type WalletRecoverySetupWebhookPayload as WalletRecoverySetupWebhookPayload,
+    type WebhookPayload as WebhookPayload,
+    type YieldClaimConfirmedWebhookPayload as YieldClaimConfirmedWebhookPayload,
     type YieldDepositConfirmedWebhookPayload as YieldDepositConfirmedWebhookPayload,
     type YieldWithdrawConfirmedWebhookPayload as YieldWithdrawConfirmedWebhookPayload,
-    type YieldClaimConfirmedWebhookPayload as YieldClaimConfirmedWebhookPayload,
-    type WebhookPayload as WebhookPayload,
-    type KrakenEmbedQuoteExecutedWebhookPayload as KrakenEmbedQuoteExecutedWebhookPayload,
-    type KrakenEmbedQuoteExecutionFailedWebhookPayload as KrakenEmbedQuoteExecutionFailedWebhookPayload,
-    type KrakenEmbedQuoteCancelledWebhookPayload as KrakenEmbedQuoteCancelledWebhookPayload,
-    type KrakenEmbedUserVerifiedWebhookPayload as KrakenEmbedUserVerifiedWebhookPayload,
-    type KrakenEmbedUserDisabledWebhookPayload as KrakenEmbedUserDisabledWebhookPayload,
-    type KrakenEmbedUserClosedWebhookPayload as KrakenEmbedUserClosedWebhookPayload,
   };
 }