cyotee/voltaire-effect-overview

Voltaire-Effect Overview

Effect.ts integration for Ethereum with typed errors and composable operations.

Install

pnpm add voltaire-effect @tevm/voltaire effect

Quick Start

import { Effect, Layer } from 'effect'
import { getBlockNumber, Provider, HttpTransport } from 'voltaire-effect'

const ProviderLayer = Provider.pipe(
  Layer.provide(HttpTransport('https://eth.llamarpc.com'))
)

const program = Effect.gen(function* () {
  return yield* getBlockNumber()
})

const blockNumber = await Effect.runPromise(program.pipe(Effect.provide(ProviderLayer)))

Core Concepts

• Schema - Validation with typed errors
• Effect - Composable async operations
• Services - Stateful resources (Provider, Signer)

Skills

• Provider: voltaire-effect-provider - JSON-RPC operations
• Contracts: voltaire-effect-contracts - Type-safe contract interaction
• Signer: voltaire-effect-signer - Transaction signing
• Layers: voltaire-effect-layers - Dependency composition
• Errors: voltaire-effect-error-handling - Typed error handling

Key Features

• Branded types - Zero-cost type safety
• Typed errors - No more untyped exceptions
• Retry/timeout - Built-in Effect patterns
• Multicall - Batch reads efficiently