@privy-io/api-types 0.15.0 → 0.17.0

package/src/resources/webhooks.ts

@@ -1,13 +1,29 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as AppsAPI from './apps';
 import * as IntentsAPI from './intents';
 import * as UsersAPI from './users';
-import * as WalletActionsAPI from './wallet-actions';
+import * as ActionsAPI from './wallets/actions';
 import * as WalletsAPI from './wallets/wallets';
 
 export class Webhooks extends APIResource {}
 
+/**
+ * Block metadata for a wallet transfer event.
+ */
+export interface BlockInfo {
+  /**
+   * The block number.
+   */
+  number: number;
+
+  /**
+   * The block timestamp.
+   */
+  timestamp: number;
+}
+
 /**
  * Bridge metadata for a crypto deposit via liquidation address.
  */
@@ -144,7 +160,10 @@ export interface FundsDepositedWebhookPayload {
    */
   asset: WalletFundsAsset;
 
-  block: FundsDepositedWebhookPayload.Block;
+  /**
+   * Block metadata for a wallet transfer event.
+   */
+  block: BlockInfo;
 
   /**
    * The CAIP-2 chain identifier.
@@ -192,20 +211,6 @@ export interface FundsDepositedWebhookPayload {
   transaction_fee?: string;
 }
 
-export namespace FundsDepositedWebhookPayload {
-  export interface Block {
-    /**
-     * The block number.
-     */
-    number: number;
-
-    /**
-     * The block timestamp.
-     */
-    timestamp: number;
-  }
-}
-
 /**
  * Payload for the wallet.funds_withdrawn webhook event.
  */
@@ -220,7 +225,10 @@ export interface FundsWithdrawnWebhookPayload {
    */
   asset: WalletFundsAsset;
 
-  block: FundsWithdrawnWebhookPayload.Block;
+  /**
+   * Block metadata for a wallet transfer event.
+   */
+  block: BlockInfo;
 
   /**
    * The CAIP-2 chain identifier.
@@ -263,20 +271,6 @@ export interface FundsWithdrawnWebhookPayload {
   transaction_fee?: string;
 }
 
-export namespace FundsWithdrawnWebhookPayload {
-  export interface Block {
-    /**
-     * The block number.
-     */
-    number: number;
-
-    /**
-     * The block timestamp.
-     */
-    timestamp: number;
-  }
-}
-
 /**
  * Payload for the intent.authorized webhook event.
  */
@@ -771,9 +765,9 @@ export interface KrakenEmbedUserVerifiedWebhookPayload {
  */
 export interface MfaDisabledWebhookPayload {
   /**
-   * The MFA method that was disabled.
+   * A multi-factor authentication method supported by the app.
    */
-  method: 'sms' | 'totp' | 'passkey';
+  method: AppsAPI.MfaMethod;
 
   /**
    * The type of webhook event.
@@ -791,9 +785,9 @@ export interface MfaDisabledWebhookPayload {
  */
 export interface MfaEnabledWebhookPayload {
   /**
-   * The MFA method that was enabled.
+   * A multi-factor authentication method supported by the app.
    */
-  method: 'sms' | 'totp' | 'passkey';
+  method: AppsAPI.MfaMethod;
 
   /**
    * The type of webhook event.
@@ -830,7 +824,11 @@ export interface PrivateKeyExportWebhookPayload {
    */
   wallet_id: string;
 
-  export_source?: 'display' | 'client';
+  /**
+   * The export type. 'display' is for showing the key to the user in the UI,
+   * 'client' is for exporting to the client application.
+   */
+  export_source?: WalletsAPI.ExportType;
 }
 
 /**
@@ -857,7 +855,11 @@ export interface SeedPhraseExportWebhookPayload {
    */
   wallet_id: string;
 
-  export_source?: 'display' | 'client';
+  /**
+   * The export type. 'display' is for showing the key to the user in the UI,
+   * 'client' is for exporting to the client application.
+   */
+  export_source?: WalletsAPI.ExportType;
 }
 
 /**
@@ -1205,6 +1207,13 @@ export interface UserOperationCompletedWebhookPayload {
   user_op_hash: string;
 }
 
+/**
+ * A reference to a user by their unique identifier.
+ */
+export interface UserReference {
+  id: string;
+}
+
 /**
  * Payload for the user.transferred_account webhook event.
  */
@@ -1216,7 +1225,10 @@ export interface UserTransferredAccountWebhookPayload {
 
   deletedUser: true;
 
-  fromUser: UserTransferredAccountWebhookPayload.FromUser;
+  /**
+   * A reference to a user by their unique identifier.
+   */
+  fromUser: UserReference;
 
   /**
    * A Privy user object.
@@ -1229,12 +1241,6 @@ export interface UserTransferredAccountWebhookPayload {
   type: 'user.transferred_account';
 }
 
-export namespace UserTransferredAccountWebhookPayload {
-  export interface FromUser {
-    id: string;
-  }
-}
-
 /**
  * Payload for the user.unlinked_account webhook event.
  */
@@ -1302,7 +1308,7 @@ export interface WalletActionEarnDepositCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1314,6 +1320,11 @@ export interface WalletActionEarnDepositCreatedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Base-unit amount of asset deposited (e.g. "1500000").
    */
@@ -1375,7 +1386,7 @@ export interface WalletActionEarnDepositFailedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1387,10 +1398,20 @@ export interface WalletActionEarnDepositFailedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Base-unit amount of asset deposited (e.g. "1500000").
@@ -1406,7 +1427,7 @@ export interface WalletActionEarnDepositFailedWebhookPayload {
    * The steps of the wallet action. Completed steps will have transaction hashes;
    * the failing step will have a failure_reason.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1459,7 +1480,7 @@ export interface WalletActionEarnDepositRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1471,16 +1492,26 @@ export interface WalletActionEarnDepositRejectedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Base-unit amount of asset deposited (e.g. "1500000").
    */
   raw_amount: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * The status of the wallet action.
    */
@@ -1489,7 +1520,7 @@ export interface WalletActionEarnDepositRejectedWebhookPayload {
   /**
    * The steps of the wallet action at the time of rejection.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1542,7 +1573,7 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1554,6 +1585,16 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Base-unit amount of asset deposited (e.g. "1500000").
    */
@@ -1572,7 +1613,7 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
   /**
    * The steps of the wallet action, including transaction hashes.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1618,6 +1659,359 @@ export interface WalletActionEarnDepositSucceededWebhookPayload {
   decimals?: number;
 }
 
+/**
+ * Payload for the wallet_action.earn_fee_collect.created webhook event.
+ */
+export interface WalletActionEarnFeeCollectCreatedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * Base-unit amount of fees collected (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * The status of the wallet action.
+   */
+  status: 'pending';
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_fee_collect.created';
+
+  /**
+   * ERC-4626 vault contract address.
+   */
+  vault_address: string;
+
+  /**
+   * The vault ID.
+   */
+  vault_id: string;
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+
+  /**
+   * Human-readable decimal amount of fees collected (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.earn_fee_collect.failed webhook event.
+ */
+export interface WalletActionEarnFeeCollectFailedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: ActionsAPI.FailureReason;
+
+  /**
+   * Base-unit amount of fees collected (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<ActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_fee_collect.failed';
+
+  /**
+   * ERC-4626 vault contract address.
+   */
+  vault_address: string;
+
+  /**
+   * The vault ID.
+   */
+  vault_id: string;
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+
+  /**
+   * Human-readable decimal amount of fees collected (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.earn_fee_collect.rejected webhook event.
+ */
+export interface WalletActionEarnFeeCollectRejectedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: ActionsAPI.FailureReason;
+
+  /**
+   * Base-unit amount of fees collected (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
+  /**
+   * The status of the wallet action.
+   */
+  status: 'rejected';
+
+  /**
+   * The steps of the wallet action at the time of rejection.
+   */
+  steps: Array<ActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_fee_collect.rejected';
+
+  /**
+   * ERC-4626 vault contract address.
+   */
+  vault_address: string;
+
+  /**
+   * The vault ID.
+   */
+  vault_id: string;
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+
+  /**
+   * Human-readable decimal amount of fees collected (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.earn_fee_collect.succeeded webhook event.
+ */
+export interface WalletActionEarnFeeCollectSucceededWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * Base-unit amount of fees collected (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * The status of the wallet action.
+   */
+  status: 'succeeded';
+
+  /**
+   * The steps of the wallet action, including transaction hashes.
+   */
+  steps: Array<ActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_fee_collect.succeeded';
+
+  /**
+   * ERC-4626 vault contract address.
+   */
+  vault_address: string;
+
+  /**
+   * The vault ID.
+   */
+  vault_id: string;
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+
+  /**
+   * Human-readable decimal amount of fees collected (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.earn_incentive_claim.created webhook event.
  */
@@ -1625,17 +2019,22 @@ export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * EVM chain name (e.g. "base", "ethereum").
    */
   chain: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  rewards: Array<ActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
    * The status of the wallet action.
@@ -1665,22 +2064,32 @@ export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * EVM chain name (e.g. "base", "ethereum").
    */
   chain: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  rewards: Array<ActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
    * The status of the wallet action.
@@ -1691,7 +2100,7 @@ export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
    * The steps of the wallet action. Completed steps will have transaction hashes;
    * the failing step will have a failure_reason.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1716,22 +2125,32 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * EVM chain name (e.g. "base", "ethereum").
    */
   chain: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
 
   /**
    * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  rewards: Array<ActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
    * The status of the wallet action.
@@ -1741,7 +2160,7 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
   /**
    * The steps of the wallet action at the time of rejection.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1766,17 +2185,27 @@ export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * EVM chain name (e.g. "base", "ethereum").
    */
   chain: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
-  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+  rewards: Array<ActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
    * The status of the wallet action.
@@ -1786,7 +2215,7 @@ export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
   /**
    * The steps of the wallet action, including transaction hashes.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1811,7 +2240,7 @@ export interface WalletActionEarnWithdrawCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1823,6 +2252,11 @@ export interface WalletActionEarnWithdrawCreatedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Base-unit amount of asset withdrawn (e.g. "1500000").
    */
@@ -1884,7 +2318,7 @@ export interface WalletActionEarnWithdrawFailedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1896,10 +2330,20 @@ export interface WalletActionEarnWithdrawFailedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Base-unit amount of asset withdrawn (e.g. "1500000").
@@ -1915,7 +2359,7 @@ export interface WalletActionEarnWithdrawFailedWebhookPayload {
    * The steps of the wallet action. Completed steps will have transaction hashes;
    * the failing step will have a failure_reason.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -1968,7 +2412,7 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -1980,16 +2424,26 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Base-unit amount of asset withdrawn (e.g. "1500000").
    */
   raw_amount: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * The status of the wallet action.
    */
@@ -1998,7 +2452,7 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
   /**
    * The steps of the wallet action at the time of rejection.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2051,7 +2505,7 @@ export interface WalletActionEarnWithdrawSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Underlying asset token address.
@@ -2063,6 +2517,16 @@ export interface WalletActionEarnWithdrawSucceededWebhookPayload {
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Base-unit amount of asset withdrawn (e.g. "1500000").
    */
@@ -2081,7 +2545,7 @@ export interface WalletActionEarnWithdrawSucceededWebhookPayload {
   /**
    * The steps of the wallet action, including transaction hashes.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2134,7 +2598,7 @@ export interface WalletActionSwapCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Chain identifier.
@@ -2142,7 +2606,12 @@ export interface WalletActionSwapCreatedWebhookPayload {
   caip2: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * Amount of input token in base units. Populated after onchain confirmation.
    */
   input_amount: string | null;
 
@@ -2184,20 +2653,30 @@ export interface WalletActionSwapFailedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Chain identifier.
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * Amount of input token in base units. Populated after onchain confirmation.
    */
   input_amount: string | null;
 
@@ -2220,7 +2699,7 @@ export interface WalletActionSwapFailedWebhookPayload {
    * The steps of the wallet action. Completed steps will have transaction hashes;
    * the failing step will have a failure_reason.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2245,20 +2724,25 @@ export interface WalletActionSwapRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Chain identifier.
    */
   caip2: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * Amount of input token in base units. Populated after onchain confirmation.
    */
   input_amount: string | null;
 
@@ -2272,6 +2756,11 @@ export interface WalletActionSwapRejectedWebhookPayload {
    */
   output_token: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * The status of the wallet action.
    */
@@ -2280,7 +2769,7 @@ export interface WalletActionSwapRejectedWebhookPayload {
   /**
    * The steps of the wallet action at the time of rejection.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2305,7 +2794,7 @@ export interface WalletActionSwapSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
 
   /**
    * Chain identifier.
@@ -2313,7 +2802,17 @@ export interface WalletActionSwapSucceededWebhookPayload {
   caip2: string;
 
   /**
-   * Amount of input token in base units. Populated after on-chain confirmation.
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
+  /**
+   * Amount of input token in base units. Populated after onchain confirmation.
    */
   input_amount: string | null;
 
@@ -2323,7 +2822,7 @@ export interface WalletActionSwapSucceededWebhookPayload {
   input_token: string;
 
   /**
-   * Amount of output token received, in base units. Populated after on-chain
+   * Amount of output token received, in base units. Populated after onchain
    * confirmation.
    */
   output_amount: string | null;
@@ -2341,7 +2840,7 @@ export interface WalletActionSwapSucceededWebhookPayload {
   /**
    * The steps of the wallet action, including transaction hashes.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2366,7 +2865,12 @@ export interface WalletActionTransferCreatedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
 
   /**
    * Recipient address.
@@ -2418,7 +2922,7 @@ export interface WalletActionTransferCreatedWebhookPayload {
 
   /**
    * Number of decimals for the transferred token. Present when the transfer was
-   * initiated with `asset_address` and the decimals were resolved on-chain.
+   * initiated with `asset_address` and the decimals were resolved onchain.
    */
   source_asset_decimals?: number;
 }
@@ -2430,17 +2934,27 @@ export interface WalletActionTransferFailedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
 
   /**
    * Recipient address.
    */
   destination_address: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action failed.
+   */
+  failed_at: string;
+
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
 
   /**
    * Chain name (e.g. "base", "ethereum").
@@ -2456,7 +2970,7 @@ export interface WalletActionTransferFailedWebhookPayload {
    * The steps of the wallet action. Completed steps will have transaction hashes;
    * the failing step will have a failure_reason.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2493,7 +3007,7 @@ export interface WalletActionTransferFailedWebhookPayload {
 
   /**
    * Number of decimals for the transferred token. Present when the transfer was
-   * initiated with `asset_address` and the decimals were resolved on-chain.
+   * initiated with `asset_address` and the decimals were resolved onchain.
    */
   source_asset_decimals?: number;
 }
@@ -2505,7 +3019,12 @@ export interface WalletActionTransferRejectedWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
 
   /**
    * Recipient address.
@@ -2515,7 +3034,12 @@ export interface WalletActionTransferRejectedWebhookPayload {
   /**
    * A description of why a wallet action (or a step within a wallet action) failed.
    */
-  failure_reason: WalletActionsAPI.FailureReason;
+  failure_reason: ActionsAPI.FailureReason;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
 
   /**
    * Chain name (e.g. "base", "ethereum").
@@ -2530,7 +3054,7 @@ export interface WalletActionTransferRejectedWebhookPayload {
   /**
    * The steps of the wallet action at the time of rejection.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2567,7 +3091,7 @@ export interface WalletActionTransferRejectedWebhookPayload {
 
   /**
    * Number of decimals for the transferred token. Present when the transfer was
-   * initiated with `asset_address` and the decimals were resolved on-chain.
+   * initiated with `asset_address` and the decimals were resolved onchain.
    */
   source_asset_decimals?: number;
 }
@@ -2579,7 +3103,17 @@ export interface WalletActionTransferSucceededWebhookPayload {
   /**
    * Type of wallet action
    */
-  action_type: WalletActionsAPI.WalletActionType;
+  action_type: ActionsAPI.WalletActionType;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action completed successfully.
+   */
+  completed_at: string;
+
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
 
   /**
    * Recipient address.
@@ -2599,7 +3133,7 @@ export interface WalletActionTransferSucceededWebhookPayload {
   /**
    * The steps of the wallet action, including transaction hashes.
    */
-  steps: Array<WalletActionsAPI.WalletActionStep>;
+  steps: Array<ActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
@@ -2636,11 +3170,41 @@ export interface WalletActionTransferSucceededWebhookPayload {
 
   /**
    * Number of decimals for the transferred token. Present when the transfer was
-   * initiated with `asset_address` and the decimals were resolved on-chain.
+   * initiated with `asset_address` and the decimals were resolved onchain.
    */
   source_asset_decimals?: number;
 }
 
+/**
+ * Payload for the wallet.archived webhook event.
+ */
+export interface WalletArchivedWebhookPayload {
+  /**
+   * Unix timestamp of when the wallet was archived.
+   */
+  archived_at: number;
+
+  /**
+   * The chain type of the archived wallet.
+   */
+  chain_type: string;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet.archived';
+
+  /**
+   * The address of the archived wallet.
+   */
+  wallet_address: string;
+
+  /**
+   * The ID of the archived wallet.
+   */
+  wallet_id: string;
+}
+
 /**
  * An asset involved in a wallet transfer.
  */
@@ -2711,20 +3275,25 @@ export interface WalletRecoveredWebhookPayload {
   wallet_id: string;
 }
 
+/**
+ * Recovery method types for embedded wallet recovery setup webhooks.
+ */
+export type WalletRecoverySetupMethod =
+  | 'user_passcode_derived_recovery_key'
+  | 'privy_passcode_derived_recovery_key'
+  | 'privy_generated_recovery_key'
+  | 'google_drive_recovery_secret'
+  | 'icloud_recovery_secret'
+  | 'recovery_encryption_key';
+
 /**
  * Payload for the wallet.recovery_setup webhook event.
  */
 export interface WalletRecoverySetupWebhookPayload {
   /**
-   * The recovery method that was set up.
+   * Recovery method types for embedded wallet recovery setup webhooks.
    */
-  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';
+  method: WalletRecoverySetupMethod;
 
   /**
    * The type of webhook event.
@@ -2747,6 +3316,31 @@ export interface WalletRecoverySetupWebhookPayload {
   wallet_id: string;
 }
 
+/**
+ * Payload for the wallet.restored webhook event.
+ */
+export interface WalletRestoredWebhookPayload {
+  /**
+   * The chain type of the restored wallet.
+   */
+  chain_type: string;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet.restored';
+
+  /**
+   * The address of the restored wallet.
+   */
+  wallet_address: string;
+
+  /**
+   * The ID of the restored wallet.
+   */
+  wallet_id: string;
+}
+
 /**
  * Union of all webhook payload schemas.
  */
@@ -2771,6 +3365,8 @@ export type WebhookPayload =
   | SeedPhraseExportWebhookPayload
   | WalletRecoverySetupWebhookPayload
   | WalletRecoveredWebhookPayload
+  | WalletArchivedWebhookPayload
+  | WalletRestoredWebhookPayload
   | MfaEnabledWebhookPayload
   | MfaDisabledWebhookPayload
   | YieldDepositConfirmedWebhookPayload
@@ -2801,7 +3397,11 @@ export type WebhookPayload =
   | WalletActionEarnIncentiveClaimCreatedWebhookPayload
   | WalletActionEarnIncentiveClaimSucceededWebhookPayload
   | WalletActionEarnIncentiveClaimRejectedWebhookPayload
-  | WalletActionEarnIncentiveClaimFailedWebhookPayload;
+  | WalletActionEarnIncentiveClaimFailedWebhookPayload
+  | WalletActionEarnFeeCollectCreatedWebhookPayload
+  | WalletActionEarnFeeCollectSucceededWebhookPayload
+  | WalletActionEarnFeeCollectRejectedWebhookPayload
+  | WalletActionEarnFeeCollectFailedWebhookPayload;
 
 /**
  * Payload for the yield.claim.confirmed webhook event.
@@ -2809,7 +3409,7 @@ export type WebhookPayload =
 export interface YieldClaimConfirmedWebhookPayload {
   caip2: string;
 
-  rewards: Array<YieldClaimConfirmedWebhookPayload.Reward>;
+  rewards: Array<YieldClaimReward>;
 
   transaction_id: string;
 
@@ -2821,14 +3421,15 @@ export interface YieldClaimConfirmedWebhookPayload {
   wallet_id: string;
 }
 
-export namespace YieldClaimConfirmedWebhookPayload {
-  export interface Reward {
-    amount: string;
+/**
+ * A single reward token claimed from a yield vault.
+ */
+export interface YieldClaimReward {
+  amount: string;
 
-    token_address: string;
+  token_address: string;
 
-    token_symbol: string;
-  }
+  token_symbol: string;
 }
 
 /**
@@ -2879,6 +3480,7 @@ export interface YieldWithdrawConfirmedWebhookPayload {
 
 export declare namespace Webhooks {
   export {
+    type BlockInfo as BlockInfo,
     type BridgeCryptoDepositMetadata as BridgeCryptoDepositMetadata,
     type BridgeCryptoTransferMetadata as BridgeCryptoTransferMetadata,
     type BridgeFiatDepositMetadata as BridgeFiatDepositMetadata,
@@ -2918,6 +3520,7 @@ export declare namespace Webhooks {
     type UserCreatedWebhookPayload as UserCreatedWebhookPayload,
     type UserLinkedAccountWebhookPayload as UserLinkedAccountWebhookPayload,
     type UserOperationCompletedWebhookPayload as UserOperationCompletedWebhookPayload,
+    type UserReference as UserReference,
     type UserTransferredAccountWebhookPayload as UserTransferredAccountWebhookPayload,
     type UserUnlinkedAccountWebhookPayload as UserUnlinkedAccountWebhookPayload,
     type UserUpdatedAccountWebhookPayload as UserUpdatedAccountWebhookPayload,
@@ -2926,6 +3529,10 @@ export declare namespace Webhooks {
     type WalletActionEarnDepositFailedWebhookPayload as WalletActionEarnDepositFailedWebhookPayload,
     type WalletActionEarnDepositRejectedWebhookPayload as WalletActionEarnDepositRejectedWebhookPayload,
     type WalletActionEarnDepositSucceededWebhookPayload as WalletActionEarnDepositSucceededWebhookPayload,
+    type WalletActionEarnFeeCollectCreatedWebhookPayload as WalletActionEarnFeeCollectCreatedWebhookPayload,
+    type WalletActionEarnFeeCollectFailedWebhookPayload as WalletActionEarnFeeCollectFailedWebhookPayload,
+    type WalletActionEarnFeeCollectRejectedWebhookPayload as WalletActionEarnFeeCollectRejectedWebhookPayload,
+    type WalletActionEarnFeeCollectSucceededWebhookPayload as WalletActionEarnFeeCollectSucceededWebhookPayload,
     type WalletActionEarnIncentiveClaimCreatedWebhookPayload as WalletActionEarnIncentiveClaimCreatedWebhookPayload,
     type WalletActionEarnIncentiveClaimFailedWebhookPayload as WalletActionEarnIncentiveClaimFailedWebhookPayload,
     type WalletActionEarnIncentiveClaimRejectedWebhookPayload as WalletActionEarnIncentiveClaimRejectedWebhookPayload,
@@ -2942,15 +3549,19 @@ export declare namespace Webhooks {
     type WalletActionTransferFailedWebhookPayload as WalletActionTransferFailedWebhookPayload,
     type WalletActionTransferRejectedWebhookPayload as WalletActionTransferRejectedWebhookPayload,
     type WalletActionTransferSucceededWebhookPayload as WalletActionTransferSucceededWebhookPayload,
+    type WalletArchivedWebhookPayload as WalletArchivedWebhookPayload,
     type WalletFundsAsset as WalletFundsAsset,
     type WalletFundsErc20Asset as WalletFundsErc20Asset,
     type WalletFundsNativeTokenAsset as WalletFundsNativeTokenAsset,
     type WalletFundsSacAsset as WalletFundsSacAsset,
     type WalletFundsSplAsset as WalletFundsSplAsset,
     type WalletRecoveredWebhookPayload as WalletRecoveredWebhookPayload,
+    type WalletRecoverySetupMethod as WalletRecoverySetupMethod,
     type WalletRecoverySetupWebhookPayload as WalletRecoverySetupWebhookPayload,
+    type WalletRestoredWebhookPayload as WalletRestoredWebhookPayload,
     type WebhookPayload as WebhookPayload,
     type YieldClaimConfirmedWebhookPayload as YieldClaimConfirmedWebhookPayload,
+    type YieldClaimReward as YieldClaimReward,
     type YieldDepositConfirmedWebhookPayload as YieldDepositConfirmedWebhookPayload,
     type YieldWithdrawConfirmedWebhookPayload as YieldWithdrawConfirmedWebhookPayload,
   };