wagmi-swift

Native Swift port of wagmi for iOS and macOS. Built on viem-swift.

Ported to Swift by Backseats

Documentation: backseats.com/wagmi-swift

Requirements

• iOS 17+ / macOS 14+
• Swift 6.1+

Installation

Add to your Package.swift:

dependencies: [
    .package(url: "https://github.com/backseats/wagmi-swift.git", from: "0.1.0"),
]

Then add Wagmi to your target:

.target(name: "MyApp", dependencies: [
    .product(name: "Wagmi", package: "wagmi-swift"),
]),

Quick Start

Set Up WagmiConfig

import SwiftUI
import Wagmi

@main
struct MyApp: App {
    let config = WagmiConfig(chains: [.mainnet, .base, .arbitrum])

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(config)
        }
    }
}

Use in a View

struct ContentView: View {
    @Environment(WagmiConfig.self) var config

    var body: some View {
        if config.isConnected {
            Text("Connected: \(config.currentAddress?.checksummed ?? "")")
            Text("Chain: \(config.currentChain?.name ?? "Unknown")")
        } else {
            Button("Connect") {
                Task { try await config.connect() }
            }
        }
    }
}

Use Hooks

struct BalanceView: View {
    @Environment(WagmiConfig.self) var config
    @State private var balance = UseBalance()

    var body: some View {
        VStack {
            if balance.isLoading {
                ProgressView()
            } else if let data = balance.data {
                Text("\(data) wei")
            }
        }
        .task {
            await balance.fetch(config: config, address: config.currentAddress!)
        }
    }
}

Use viem-swift Directly

Since Wagmi re-exports ViemSwift, you get full access to low-level Ethereum primitives:

import Wagmi // also gives you ViemSwift types

// ABI encoding
let calldata = try ABIEncoder.encodeFunctionData(
    signature: "transfer(address,uint256)",
    values: [.address(recipient), .uint(amount)]
)

// Keccak-256 hashing
let hash = Keccak256.hash(data: someData)

// Public client for read-only RPC calls
let client = try PublicClient(chain: .mainnet)
let blockNumber = try await client.getBlockNumber()

Architecture

wagmi-swift depends on viem-swift, mirroring the TypeScript ecosystem:

• viem-swift — Low-level Ethereum client (ABI, RLP, keccak, signing, JSON-RPC, chains)
• wagmi-swift — High-level config, wallet connectors, SwiftUI hooks

API Index

Every item below links to the source definition in this repo.

Config and connection hooks

• WagmiConfig — connect, disconnect, switchChain, reconnect, publicClient
• UseConfig
• UseChainId
• UseChains
• UseConnectors
• UseConnect — connect, reset
• UseReconnect — reconnect, reset
• UseDisconnect — disconnect, reset
• UseAccount
• UseConnection
• UseConnections
• UseSwitchAccount — switchAccount, reset
• UseSwitchConnection — switchConnection, reset
• UseSwitchChain — switchChain, reset
• UsePublicClient
• UseClient
• UseConnectorClient
• UseWalletClient

Read hooks

• UseBalance — fetch, reset
• UseBlock — fetch, reset
• UseBlockNumber — fetch, reset
• UseBlockTransactionCount — fetch, reset
• UseBytecode — fetch, reset
• UseCall — fetch, reset
• UseContractEvents — fetch, reset
• UseEnsName — fetch, reset
• UseEnsAddress — fetch, reset
• UseEnsAvatar — fetch, reset
• UseEnsResolver — fetch, reset
• UseEnsText — fetch, reset
• UseEstimateFeesPerGas — fetch, reset
• UseEstimateGas — fetch, reset
• UseEstimateMaxPriorityFeePerGas — fetch, reset
• UseFeeHistory — fetch, reset
• UseGasPrice — fetch, reset
• UseProof — fetch, reset
• UsePrepareTransactionRequest — fetch, reset
• UseReadContract — fetch, reset
• UseReadContracts — fetch, reset
• UseStorageAt — fetch, reset
• UseToken — fetch, reset
• UseTokenBalance — fetch, reset
• UseTransaction — fetch, reset
• UseTransactionConfirmations — fetch, reset
• UseTransactionCount — fetch, reset
• UseTransactionReceipt — fetch, reset
• UseWaitForTransactionReceipt — wait, reset

Write, signing, and verification hooks

• UseDeployContract — deploy, reset
• UseSendTransaction — sendTransaction, reset
• UseSignMessage — signMessage, reset
• UseSignTransaction — signTransaction, reset
• UseSignTypedData — signTypedData, reset
• UseSimulateContract — fetch, reset
• UseWriteContract — writeContract, reset
• UseVerifyMessage — verify, reset
• UseVerifyTypedData — verify, reset

Watch hooks

• UseWatchAsset — watchAsset, reset
• UseWatchBlockNumber — watch, stop
• UseWatchBlocks — watch, stop
• UseWatchContractEvent — watch, stop
• UseWatchPendingTransactions — watch, stop

Batch call hooks (EIP-5792)

• UseSendCalls — sendCalls, reset
• UseCallsStatus — fetch, reset
• UseWaitForCallsStatus — wait, reset
• UseShowCallsStatus — showCallsStatus, reset

Connectors

• Connector
• MockConnector — connect, disconnect, switchChain, plus simulation helpers for tests
• WalletConnectConnector — connect, disconnect, switchChain, personalSign, sendTransaction
• CoinbaseWalletConnector — connect, disconnect, switchChain

Supporting types and storage

• BalanceResult
• TokenMetadata
• ContractReadCall
• Connection
• WatchAssetParams
• BatchCall
• BatchCallResult
• InsecureStorage
• SecureStorage
• UserDefaultsStorage
• KeychainStorage