WalletPair
DocsPlayground GitHub
OverviewInstall ExtensionGetting StartedCore ConceptsdApp IntegrationWallet IntegrationSelf-Hosting RelaySecurity
Protocol Specifications
Protocol MapEthereum ProtocolEIP-1193 and wagmi

Documentation

WalletPair is a minimal, self-sovereign protocol for connecting dApps with blockchain wallets. The core protocol is network-agnostic — it handles pairing, encryption, and transport. The current application protocol defines EIP-1193 behavior for EVM chains.

Core Protocol

Getting Started

Implement the three wire specifications and run your first pairing.

Core Concepts

Pairing URI validation, directional keys, MessagePack, frames, and counters.

dApp Integration

Full guide to integrating WalletPair into your dApp.

Wallet Integration

Handle pairing requests and sign transactions in your wallet.

Self-Hosting Relay

Deploy your own relay server with a single Rust binary.

Security

Cryptography, formal verification, and threat model.

Protocol Map

WalletPair currently has three normative specifications: encryption, relay, and Ethereum. The Ethereum specification defines the EIP-1193 envelope carried by encrypted frames.

Protocol Map

How the encryption, relay, and EVM specifications fit together.

Ethereum Protocol

EIP-1193 methods, events, envelope shapes, and error codes.

EIP-1193 and wagmi

Compatibility guidance for adapting your own EIP-1193 provider.

WalletPair Protocol
GitHub · Docs · MIT License