WalletConnect 2.0 Specifications

The Notify API enables wallet users to register subscriptions for blockchain, application, or off-chain events. This allows relevant notifications to be sent directly to the user's wallet.

The Chat API enables wallet users within the WalletConnect network to engage in 1-on-1, end-to-end encrypted messaging. It uses blockchain accounts as addresses to establish peer-to-peer communication. Because the system is designed to be recoverable via a seed phrase, users can migrate between different wallet providers without losing their chat history.

The Storage API provides high-level interfaces for storing persistent data. It is designed to allow state engines to manage their internal state using a simplified key-value storage model.

The Web3Inbox SDK is a unified offering that combines the functionality of the Notify and Chat clients. It provides developers with access to the Web3Inbox inner state and user interface. The SDK is designed to wrap the 'W3I proxy' state manager, enabling the implementation of Web3Inbox experiences across web, native iOS, and native Android platforms.

Relay Webhooks allow the registration of HTTP watch webhooks that trigger when a specific relay client (the "watched client") is involved in a published message. Webhooks are observational and do not affect the delivery of the actual message. They are used to monitor message flow without requiring the client to maintain a constant WebSocket connection to the relay.

The Web3Modal SDK provides a unified interface for dapp developers to enable connections to multiple wallet types. It supports a variety of connectors including Browser, Desktop, Mobile, Cloud, and Hardware wallets.

WalletConnect emits various session-related events that Dapps and Wallets can listen to in order to perform specific actions or update their UI state.

The Pairing API is a lightweight, protocol-agnostic communication layer used to establish an encrypted channel between peers. It serves as a secure foundation for proposing protocols or sending requests, allowing multiple protocols (such as Sign, Auth, and Push) to share a single reusable communication channel. This enables users to scan a single QR code to interact with multiple protocols simultaneously.

PubSub (Publish-Subscribe) is a messaging pattern used in WalletConnect 2.0 where publishers (senders) do not send messages directly to specific receivers. Instead, messages are labeled with a topic. Subscribers receive only the messages that match the specific topics they have expressed interest in.

The Relay is the system, network, or mechanism responsible for sending and receiving messages between two clients in the WalletConnect ecosystem. By default, clients utilize a proxy server connected to the Waku network, which establishes connections to clients via WebSockets using the reference Relay API.

The Sync API allows a wallet user to synchronize private data across multiple clients. Access to this data is granted and authenticated using a single blockchain account signature. It functions similarly to the Storage API but is specifically designed for cross-client accessibility via account signatures.