wallet.* namespace. They cover the wallet lifecycle, completed signatures, confirmed on-chain activity, and key share operations.
For the shared event envelope, endpoint setup, retries, and signature verification, see Setting up webhooks and Event delivery & best practices. The current list of event types is always available from the event types endpoint.
Lifecycle events
wallet.deleted is emitted when a wallet is deleted but is not selectable in
the event types catalog today.On-chain activity events
object
Occurs when a confirmed transaction involves a user’s wallet. Tracks all on-chain activity across EVM, SVM, and Bitcoin networks. See on-chain events for details. Is a
WalletTransaction.
object
Occurs when a wallet is newly registered for on-chain activity monitoring.
Fired once per wallet after creation when the environment has on-chain
activity tracking enabled: not on duplicates, replays, or
already-registered addresses. Contains the wallet address, wallet id, and
owning user id.
Key share and recovery events
Occurs whenever a wallet’s key shares are backed up. Is a
wallet.
Occurs whenever a user backs up their key share to an external location such as Google Drive. Is a
wallet.
Occurs whenever a wallet’s key shares are recovered. Is a
wallet.
Occurs whenever a wallet’s key shares are refreshed. Is a
wallet.
Occurs whenever a wallet’s key shares are reshared across a new set of parties. Is a
wallet.
object
Occurs whenever an offline recovery kit is created for a wallet.
Related events
- Delegated signing events (
wallet.delegation.*) are documented under Agent webhooks. - Screening and policy verdicts on wallet addresses (
wallet.sanctions.blocked,wallet.addressScreening.*) are documented under Policy and screening webhooks. - Exchange transfer events (
user.exchangeTransfer.*) are documented under Flow webhooks.