@privy-io/api-types 0.15.0 → 0.16.0

package/src/resources/webhooks.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as AppsAPI from './apps';
 import * as IntentsAPI from './intents';
 import * as UsersAPI from './users';
 import * as WalletActionsAPI from './wallet-actions';
@@ -8,6 +9,21 @@ 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.
@@ -1205,6 +1199,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 +1217,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 +1233,6 @@ export interface UserTransferredAccountWebhookPayload {
   type: 'user.transferred_account';
 }
 
-export namespace UserTransferredAccountWebhookPayload {
-  export interface FromUser {
-    id: string;
-  }
-}
-
 /**
  * Payload for the user.unlinked_account webhook event.
  */
@@ -1314,6 +1312,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").
    */
@@ -1387,6 +1390,16 @@ 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.
    */
@@ -1471,6 +1484,11 @@ 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.
    */
@@ -1481,6 +1499,11 @@ export interface WalletActionEarnDepositRejectedWebhookPayload {
    */
   raw_amount: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * The status of the wallet action.
    */
@@ -1554,6 +1577,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").
    */
@@ -1632,6 +1665,11 @@ export interface WalletActionEarnIncentiveClaimCreatedWebhookPayload {
    */
   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.
    */
@@ -1672,6 +1710,16 @@ export interface WalletActionEarnIncentiveClaimFailedWebhookPayload {
    */
   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.
    */
@@ -1723,11 +1771,21 @@ export interface WalletActionEarnIncentiveClaimRejectedWebhookPayload {
    */
   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;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * Claimed reward tokens. Populated after the preparation step fetches from Merkl.
    */
@@ -1773,6 +1831,16 @@ export interface WalletActionEarnIncentiveClaimSucceededWebhookPayload {
    */
   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.
    */
@@ -1823,6 +1891,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").
    */
@@ -1896,6 +1969,16 @@ 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.
    */
@@ -1980,6 +2063,11 @@ 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.
    */
@@ -1990,6 +2078,11 @@ export interface WalletActionEarnWithdrawRejectedWebhookPayload {
    */
   raw_amount: string;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * The status of the wallet action.
    */
@@ -2063,6 +2156,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").
    */
@@ -2142,7 +2245,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;
 
@@ -2191,13 +2299,23 @@ export interface WalletActionSwapFailedWebhookPayload {
    */
   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;
 
   /**
-   * 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;
 
@@ -2252,13 +2370,18 @@ export interface WalletActionSwapRejectedWebhookPayload {
    */
   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;
 
   /**
-   * 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 +2395,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.
    */
@@ -2313,7 +2441,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 +2461,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;
@@ -2368,6 +2506,11 @@ export interface WalletActionTransferCreatedWebhookPayload {
    */
   action_type: WalletActionsAPI.WalletActionType;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Recipient address.
    */
@@ -2418,7 +2561,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;
 }
@@ -2432,11 +2575,21 @@ export interface WalletActionTransferFailedWebhookPayload {
    */
   action_type: WalletActionsAPI.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.
    */
@@ -2493,7 +2646,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;
 }
@@ -2507,6 +2660,11 @@ export interface WalletActionTransferRejectedWebhookPayload {
    */
   action_type: WalletActionsAPI.WalletActionType;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was created.
+   */
+  created_at: string;
+
   /**
    * Recipient address.
    */
@@ -2517,6 +2675,11 @@ export interface WalletActionTransferRejectedWebhookPayload {
    */
   failure_reason: WalletActionsAPI.FailureReason;
 
+  /**
+   * ISO 8601 timestamp of when the wallet action was rejected.
+   */
+  rejected_at: string;
+
   /**
    * Chain name (e.g. "base", "ethereum").
    */
@@ -2567,7 +2730,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;
 }
@@ -2581,6 +2744,16 @@ export interface WalletActionTransferSucceededWebhookPayload {
    */
   action_type: WalletActionsAPI.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.
    */
@@ -2636,11 +2809,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.
  */
@@ -2747,6 +2950,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 +2999,8 @@ export type WebhookPayload =
   | SeedPhraseExportWebhookPayload
   | WalletRecoverySetupWebhookPayload
   | WalletRecoveredWebhookPayload
+  | WalletArchivedWebhookPayload
+  | WalletRestoredWebhookPayload
   | MfaEnabledWebhookPayload
   | MfaDisabledWebhookPayload
   | YieldDepositConfirmedWebhookPayload
@@ -2809,7 +3039,7 @@ export type WebhookPayload =
 export interface YieldClaimConfirmedWebhookPayload {
   caip2: string;
 
-  rewards: Array<YieldClaimConfirmedWebhookPayload.Reward>;
+  rewards: Array<YieldClaimReward>;
 
   transaction_id: string;
 
@@ -2821,14 +3051,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 +3110,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 +3150,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,
@@ -2942,6 +3175,7 @@ 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,
@@ -2949,8 +3183,10 @@ export declare namespace Webhooks {
     type WalletFundsSplAsset as WalletFundsSplAsset,
     type WalletRecoveredWebhookPayload as WalletRecoveredWebhookPayload,
     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,
   };