wevm/wagmi
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.
