@privy-io/api-types 0.8.0 → 0.9.0

package/src/resources/webhooks.ts

@@ -1146,213 +1146,1005 @@ export interface WalletActionTransferFailedWebhookPayload {
 }
 
 /**
- * Payload for the wallet.funds_deposited webhook event.
+ * Payload for the wallet_action.earn_deposit.created webhook event.
+ */
+export interface WalletActionEarnDepositCreatedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * Base-unit amount of asset deposited (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_deposit.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 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.earn_deposit.succeeded webhook event.
+ */
+export interface WalletActionEarnDepositSucceededWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * Base-unit amount of asset deposited (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Vault shares received in base units.
+   */
+  share_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The steps of the wallet action, including transaction hashes.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_deposit.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 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.earn_deposit.rejected webhook event.
+ */
+export interface WalletActionEarnDepositRejectedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  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.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * 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.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 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.earn_deposit.failed webhook event.
+ */
+export interface WalletActionEarnDepositFailedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  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.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * 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_deposit.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 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.earn_withdraw.created webhook event.
+ */
+export interface WalletActionEarnWithdrawCreatedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * Base-unit amount of asset withdrawn (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_withdraw.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 asset withdrawn (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_withdraw.succeeded webhook event.
+ */
+export interface WalletActionEarnWithdrawSucceededWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * Base-unit amount of asset withdrawn (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Vault shares burned in base units.
+   */
+  share_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The steps of the wallet action, including transaction hashes.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_withdraw.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 asset withdrawn (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_withdraw.rejected webhook event.
+ */
+export interface WalletActionEarnWithdrawRejectedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  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 withdrawn (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The steps of the wallet action at the time of rejection.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_withdraw.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 asset withdrawn (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_withdraw.failed webhook event.
+ */
+export interface WalletActionEarnWithdrawFailedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * Underlying asset token address.
+   */
+  asset_address: string;
+
+  /**
+   * CAIP-2 chain identifier.
+   */
+  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 withdrawn (e.g. "1500000").
+   */
+  raw_amount: string;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * 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.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 asset withdrawn (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.
+ */
+export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * EVM chain name (e.g. "base", "ethereum").
+   */
+  chain: string;
+
+  /**
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   */
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_incentive_claim.created';
+
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+}
+
+/**
+ * Payload for the wallet_action.earn_incentive_claim.succeeded webhook event.
  */
-export interface FundsDepositedWebhookPayload {
+export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
   /**
-   * The amount transferred, as a stringified bigint.
+   * Type of wallet action
    */
-  amount: string;
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * The asset type being transferred.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  asset:
-    | FundsDepositedWebhookPayload.UnionMember0
-    | FundsDepositedWebhookPayload.UnionMember1
-    | FundsDepositedWebhookPayload.UnionMember2
-    | FundsDepositedWebhookPayload.UnionMember3;
+  chain: string;
 
-  block: FundsDepositedWebhookPayload.Block;
+  /**
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   */
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
   /**
-   * The CAIP-2 chain identifier.
+   * Status of a wallet action.
    */
-  caip2: string;
+  status: WalletActionsAPI.WalletActionStatus;
 
   /**
-   * A unique key for this event.
+   * The steps of the wallet action, including transaction hashes.
    */
-  idempotency_key: string;
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
-   * The recipient address.
+   * The type of webhook event.
    */
-  recipient: string;
+  type: 'wallet_action.earn_incentive_claim.succeeded';
 
   /**
-   * The sender address.
+   * The ID of the wallet action.
    */
-  sender: string;
+  wallet_action_id: string;
 
   /**
-   * The blockchain transaction hash.
+   * The ID of the wallet involved in the action.
    */
-  transaction_hash: string;
+  wallet_id: string;
+}
+
+/**
+ * Payload for the wallet_action.earn_incentive_claim.rejected webhook event.
+ */
+export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
+  /**
+   * Type of wallet action
+   */
+  action_type: WalletActionsAPI.WalletActionType;
+
+  /**
+   * EVM chain name (e.g. "base", "ethereum").
+   */
+  chain: string;
+
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: WalletActionsAPI.FailureReason;
+
+  /**
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   */
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
+
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
+
+  /**
+   * The steps of the wallet action at the time of rejection.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
   /**
    * The type of webhook event.
    */
-  type: 'wallet.funds_deposited';
+  type: 'wallet_action.earn_incentive_claim.rejected';
 
   /**
-   * The ID of the wallet.
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
+
+  /**
+   * The ID of the wallet involved in the action.
    */
   wallet_id: string;
+}
 
+/**
+ * Payload for the wallet_action.earn_incentive_claim.failed webhook event.
+ */
+export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
   /**
-   * Optional Bridge metadata for custodial wallet deposits.
+   * Type of wallet action
    */
-  bridge_metadata?:
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember0
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember1
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember2
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember3
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember4
-    | FundsDepositedWebhookPayload.BridgeMetadataUnionMember5;
+  action_type: WalletActionsAPI.WalletActionType;
 
   /**
-   * The transaction fee paid, as a stringified bigint in the chain's native token.
+   * EVM chain name (e.g. "base", "ethereum").
    */
-  transaction_fee?: string;
-}
+  chain: string;
 
-export namespace FundsDepositedWebhookPayload {
-  export interface UnionMember0 {
-    address: null;
+  /**
+   * A description of why a wallet action (or a step within a wallet action) failed.
+   */
+  failure_reason: WalletActionsAPI.FailureReason;
 
-    type: 'native-token';
-  }
+  /**
+   * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
+   */
+  rewards: Array<WalletActionsAPI.EarnIncetiveClaimRewardEntry> | null;
 
-  export interface UnionMember1 {
-    address: string;
+  /**
+   * Status of a wallet action.
+   */
+  status: WalletActionsAPI.WalletActionStatus;
 
-    type: 'erc20';
-  }
+  /**
+   * The steps of the wallet action. Completed steps will have transaction hashes;
+   * the failing step will have a failure_reason.
+   */
+  steps: Array<WalletActionsAPI.WalletActionStep>;
 
-  export interface UnionMember2 {
-    mint: string;
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet_action.earn_incentive_claim.failed';
 
-    type: 'spl';
-  }
+  /**
+   * The ID of the wallet action.
+   */
+  wallet_action_id: string;
 
-  export interface UnionMember3 {
-    address: string;
+  /**
+   * The ID of the wallet involved in the action.
+   */
+  wallet_id: string;
+}
 
-    type: 'sac';
-  }
+/**
+ * A native token asset (e.g. ETH, SOL).
+ */
+export interface WalletFundsNativeTokenAsset {
+  address: null;
 
-  export interface Block {
-    /**
-     * The block number.
-     */
-    number: number;
+  type: 'native-token';
+}
 
-    /**
-     * The block timestamp.
-     */
-    timestamp: number;
-  }
+/**
+ * An ERC-20 token asset.
+ */
+export interface WalletFundsErc20Asset {
+  address: string;
 
-  export interface BridgeMetadataUnionMember0 {
-    drain_id: string;
+  type: 'erc20';
+}
 
-    /**
-     * The crypto address of the liquidation address that received the deposit.
-     */
-    liquidation_address: string;
+/**
+ * A Solana SPL token asset.
+ */
+export interface WalletFundsSplAsset {
+  mint: string;
 
-    liquidation_address_id: string;
+  type: 'spl';
+}
 
-    method: 'liquidation_address';
+/**
+ * A Stellar Asset Contract (SAC) asset.
+ */
+export interface WalletFundsSacAsset {
+  address: string;
 
-    /**
-     * The address that sent the deposit.
-     */
-    source_wallet_address: string;
+  type: 'sac';
+}
 
-    type: 'crypto_deposit';
-  }
+/**
+ * An asset involved in a wallet transfer.
+ */
+export type WalletFundsAsset =
+  | WalletFundsNativeTokenAsset
+  | WalletFundsErc20Asset
+  | WalletFundsSplAsset
+  | WalletFundsSacAsset;
+
+/**
+ * Bridge metadata for a crypto deposit via liquidation address.
+ */
+export interface BridgeCryptoDepositMetadata {
+  drain_id: string;
 
-  export interface BridgeMetadataUnionMember1 {
-    drain_id: string;
+  /**
+   * The crypto address of the liquidation address that received the deposit.
+   */
+  liquidation_address: string;
 
-    liquidation_address_id: string;
+  liquidation_address_id: string;
 
-    method: 'liquidation_address';
+  method: 'liquidation_address';
 
-    /**
-     * The original deposit transaction hash that triggered the failed drain.
-     */
-    original_transaction_hash: string;
+  /**
+   * The address that sent the deposit.
+   */
+  source_wallet_address: string;
 
-    type: 'refund';
-  }
+  type: 'crypto_deposit';
+}
 
-  export interface BridgeMetadataUnionMember2 {
-    activity_id: string;
+/**
+ * Bridge metadata for a refund via liquidation address.
+ */
+export interface BridgeRefundMetadata {
+  drain_id: string;
 
-    method: 'virtual_account';
+  liquidation_address_id: string;
 
-    type: 'fiat_deposit';
+  method: 'liquidation_address';
 
-    virtual_account_id: string;
-  }
+  /**
+   * The original deposit transaction hash that triggered the failed drain.
+   */
+  original_transaction_hash: string;
 
-  export interface BridgeMetadataUnionMember3 {
-    method: 'transfer';
+  type: 'refund';
+}
 
-    /**
-     * The wallet address that sent the transfer.
-     */
-    source_wallet_address: string;
+/**
+ * Bridge metadata for a fiat deposit via virtual account.
+ */
+export interface BridgeFiatDepositMetadata {
+  activity_id: string;
 
-    transfer_id: string;
+  method: 'virtual_account';
 
-    type: 'crypto_deposit';
-  }
+  type: 'fiat_deposit';
 
-  export interface BridgeMetadataUnionMember4 {
-    method: 'transfer';
+  virtual_account_id: string;
+}
 
-    transfer_id: string;
+/**
+ * Bridge metadata for a crypto deposit via transfer.
+ */
+export interface BridgeCryptoTransferMetadata {
+  method: 'transfer';
 
-    type: 'fiat_deposit';
-  }
+  /**
+   * The wallet address that sent the transfer.
+   */
+  source_wallet_address: string;
+
+  transfer_id: string;
 
-  export interface BridgeMetadataUnionMember5 {
-    method: 'transfer';
+  type: 'crypto_deposit';
+}
 
-    transfer_id: string;
+/**
+ * Bridge metadata for a fiat deposit via transfer.
+ */
+export interface BridgeFiatTransferMetadata {
+  method: 'transfer';
 
-    type: 'refund';
+  transfer_id: string;
 
-    /**
-     * The original transfer transaction hash (if available).
-     */
-    original_transaction_hash?: string;
-  }
+  type: 'fiat_deposit';
 }
 
 /**
- * Payload for the wallet.funds_withdrawn webhook event.
+ * Bridge metadata for a transfer refund.
  */
-export interface FundsWithdrawnWebhookPayload {
+export interface BridgeTransferRefundMetadata {
+  method: 'transfer';
+
+  transfer_id: string;
+
+  type: 'refund';
+
+  /**
+   * The original transfer transaction hash (if available).
+   */
+  original_transaction_hash?: string;
+}
+
+/**
+ * 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.
+ */
+export interface FundsDepositedWebhookPayload {
   /**
    * The amount transferred, as a stringified bigint.
    */
   amount: string;
 
   /**
-   * The asset type being transferred.
+   * An asset involved in a wallet transfer.
    */
-  asset:
-    | FundsWithdrawnWebhookPayload.UnionMember0
-    | FundsWithdrawnWebhookPayload.UnionMember1
-    | FundsWithdrawnWebhookPayload.UnionMember2
-    | FundsWithdrawnWebhookPayload.UnionMember3;
+  asset: WalletFundsAsset;
 
-  block: FundsWithdrawnWebhookPayload.Block;
+  block: FundsDepositedWebhookPayload.Block;
 
   /**
    * The CAIP-2 chain identifier.
@@ -1382,44 +2174,96 @@ export interface FundsWithdrawnWebhookPayload {
   /**
    * The type of webhook event.
    */
-  type: 'wallet.funds_withdrawn';
+  type: 'wallet.funds_deposited';
 
   /**
    * The ID of the wallet.
    */
   wallet_id: string;
 
+  /**
+   * Metadata about a Bridge transaction associated with a wallet event.
+   */
+  bridge_metadata?: BridgeMetadata;
+
   /**
    * The transaction fee paid, as a stringified bigint in the chain's native token.
    */
   transaction_fee?: string;
 }
 
-export namespace FundsWithdrawnWebhookPayload {
-  export interface UnionMember0 {
-    address: null;
+export namespace FundsDepositedWebhookPayload {
+  export interface Block {
+    /**
+     * The block number.
+     */
+    number: number;
 
-    type: 'native-token';
+    /**
+     * The block timestamp.
+     */
+    timestamp: number;
   }
+}
+
+/**
+ * Payload for the wallet.funds_withdrawn webhook event.
+ */
+export interface FundsWithdrawnWebhookPayload {
+  /**
+   * The amount transferred, as a stringified bigint.
+   */
+  amount: string;
 
-  export interface UnionMember1 {
-    address: string;
+  /**
+   * An asset involved in a wallet transfer.
+   */
+  asset: WalletFundsAsset;
 
-    type: 'erc20';
-  }
+  block: FundsWithdrawnWebhookPayload.Block;
 
-  export interface UnionMember2 {
-    mint: string;
+  /**
+   * The CAIP-2 chain identifier.
+   */
+  caip2: string;
 
-    type: 'spl';
-  }
+  /**
+   * A unique key for this event.
+   */
+  idempotency_key: string;
 
-  export interface UnionMember3 {
-    address: string;
+  /**
+   * The recipient address.
+   */
+  recipient: string;
 
-    type: 'sac';
-  }
+  /**
+   * The sender address.
+   */
+  sender: string;
+
+  /**
+   * The blockchain transaction hash.
+   */
+  transaction_hash: string;
+
+  /**
+   * The type of webhook event.
+   */
+  type: 'wallet.funds_withdrawn';
+
+  /**
+   * The ID of the wallet.
+   */
+  wallet_id: string;
+
+  /**
+   * The transaction fee paid, as a stringified bigint in the chain's native token.
+   */
+  transaction_fee?: string;
+}
 
+export namespace FundsWithdrawnWebhookPayload {
   export interface Block {
     /**
      * The block number.
@@ -1663,7 +2507,19 @@ export type WebhookPayload =
   | WalletActionTransferCreatedWebhookPayload
   | WalletActionTransferSucceededWebhookPayload
   | WalletActionTransferRejectedWebhookPayload
-  | WalletActionTransferFailedWebhookPayload;
+  | WalletActionTransferFailedWebhookPayload
+  | WalletActionEarnDepositCreatedWebhookPayload
+  | WalletActionEarnDepositSucceededWebhookPayload
+  | WalletActionEarnDepositRejectedWebhookPayload
+  | WalletActionEarnDepositFailedWebhookPayload
+  | WalletActionEarnWithdrawCreatedWebhookPayload
+  | WalletActionEarnWithdrawSucceededWebhookPayload
+  | WalletActionEarnWithdrawRejectedWebhookPayload
+  | WalletActionEarnWithdrawFailedWebhookPayload
+  | WalletActionEarnIncentiveClaimCreatedWebhookPayload
+  | WalletActionEarnIncentiveClaimSucceededWebhookPayload
+  | WalletActionEarnIncentiveClaimRejectedWebhookPayload
+  | WalletActionEarnIncentiveClaimFailedWebhookPayload;
 
 /**
  * Payload for the kraken_embed.quote_executed webhook event.
@@ -1843,6 +2699,30 @@ export declare namespace Webhooks {
     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 WalletActionEarnIncentiveClaimCreatedWebhookPayload as WalletActionEarnIncentiveClaimCreatedWebhookPayload,
+    type WalletActionEarnIncentiveClaimSucceededWebhookPayload as WalletActionEarnIncentiveClaimSucceededWebhookPayload,
+    type WalletActionEarnIncentiveClaimRejectedWebhookPayload as WalletActionEarnIncentiveClaimRejectedWebhookPayload,
+    type WalletActionEarnIncentiveClaimFailedWebhookPayload as WalletActionEarnIncentiveClaimFailedWebhookPayload,
+    type WalletFundsNativeTokenAsset as WalletFundsNativeTokenAsset,
+    type WalletFundsErc20Asset as WalletFundsErc20Asset,
+    type WalletFundsSplAsset as WalletFundsSplAsset,
+    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,