Wagmi

Wagmi is a collection of reactive hooks and a toolkit for interacting with Ethereum blockchains. It provides a comprehensive suite of primitives for managing wallet connections, reading smart contract data, and orchestrating on-chain transactions.

The project distinguishes itself through a smart contract interface toolkit that retrieves binary interfaces to generate type-safe hooks and function wrappers. This ensures that blockchain inputs and outputs are validated at compile-time. It also features a specialized utility for translating Ethereum Name Service domains into wallet addresses and profile metadata.

The library covers a broad range of blockchain capabilities, including transaction management for batching calls and sponsoring gas fees, as well as state management for caching on-chain data. It handles identity via cryptographic message signing and wallet provider integration, and supports multi-chain synchronization to maintain the correct network context.

The project includes a command-line tool for organizing and retrieving contract binary interfaces.

Features

Wallet Integrations - Provides the primary integration layer for connecting web applications to external Ethereum wallet providers for authentication and signing.

Blockchain State Querying - Retrieves real-time blockchain state, including account balances, block headers, and transaction receipts.

Blockchain Transaction Orchestration - Implements tools for estimating gas fees, batching multiple calls, and tracking the lifecycle of Ethereum transactions.

Blockchain Data Synchronization - Synchronizes on-chain data with a local state management layer to maintain a reactive user interface.

Digital Message Signing - Enables requesting cryptographic signatures from wallets to verify user identity and authorize on-chain actions.

Wallet Provider Connectors - Implements interfaces for initializing connections to injected browser-based Ethereum wallets for user authentication.

Connection Management - Manages the active session lifecycle between the application and connected browser-based wallets.

Contract Type Generators - Generates TypeScript type definitions from smart contract ABIs to ensure compile-time safety for blockchain calls.

Ethereum Client Libraries - A comprehensive collection of reactive React hooks for interacting with Ethereum blockchains and managing wallet connections.

Smart Contract Callers - Provides interfaces for reading state and executing functions on smart contracts via the network.

ABI Mappings - Provides mappings that translate smart contract ABIs into executable JavaScript functions for interaction.

Contract Interface Toolkits - Provides a toolkit for fetching ABIs and generating type-safe hooks and function wrappers for smart contract interaction.

Data Caching - Implements a state management layer that caches on-chain data in memory to reduce redundant network requests.

Cross-Request Data Caches - Caches fetched blockchain data across requests to avoid redundant network calls and improve performance.

Transaction Management - Provides tools for estimating gas, simulating calls, and monitoring transactions until network confirmation.

Blockchain Network Connections - Defines the necessary providers and network parameters to connect applications to various Ethereum-compatible chains.

Cross-Chain State Synchronization - Automatically manages the transition between different blockchain network configurations to maintain the correct application context.

Network Context Synchronization - Tracks and updates the current network state to ensure requests are routed to the correct blockchain endpoint.

ENS Domain Resolutions - Translates human-readable Ethereum Name Service domains into wallet addresses and profile metadata.

ENS Resolution Utilities - Provides specialized utilities for translating human-readable Ethereum Name Service domains into wallet addresses and profile metadata.

Transaction Sequence Coordination - Tracks the sequence of multiple outgoing transactions to prevent collisions and ensure correct execution order.

Transaction Batching - Groups multiple smart contract calls into a single execution to reduce user interactions and lower gas costs.

Account Linking - Links browser extensions and mobile wallets to manage user identities and authorize on-chain transactions.

Transaction Fee Sponsorships - Enables delegating transaction gas costs to a third-party payer or paymaster contract.

State Management Providers - Distributes blockchain network and wallet connection states throughout the component tree using centralized context providers.

TanStack Query SSR Integrations - Integrates TanStack Query for managed blockchain data fetching, caching, and server-state synchronization.

wevmwagmi

Features

Star history