effect-evm


> [!WARNING]
>
> This is experimental, beta software. It is provided "as is" without warranty of any kind, express or implied.

Type-safe, composable EVM abstractions for Effect, built on viem.

!Banner

📦 Installation

``bash
bun add @prb/effect-evm
`

Peer dependencies

- effect@^3.19.11
- @effect/platform@^0.93.7
- viem@^2.0.0
- Optional: @wagmi/core@^2.0.0 (for effect-evm/wagmi)
- Optional: react@>=18.2.0, react-dom@>=18.2.0 (for effect-evm/react-hooks)

🚀 Usage

`typescript
import { Effect } from "effect";
import { mainnet } from "viem/chains";
import { ContractReader, erc20Abi, makeEffectEvmLayer, type ChainConfig } from "effect-evm";

// 1. Configure chains
const configs: ChainConfig[] = [{ chainId: 1, chain: mainnet, rpcUrls: ["https://rpc.example"] }];

// 2. Create the layer
const EvmLayer = makeEffectEvmLayer(configs, window.ethereum);

// 3. Use services
const program = Effect.gen(function* () {
const reader = yield* ContractReader;
return yield* reader.read({
chainId: 1,
address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
abi: erc20Abi,
functionName: "balanceOf",
args: ["0x..."],
});
});

// 4. Run
Effect.runPromise(program.pipe(Effect.provide(EvmLayer)));
`

✨ Features

- Contracts — ContractReader (multicall), ContractWriter, ContractPipeline, typedContract
- Transactions — TxManager with reactive state tracking
- Events — EventStream, ReliableEventStream (confirmations + reorg filtering)
- Chain utilities — BalanceService, BlockService, GasService, NonceService
- Deploy + NFTs — DeployService, Erc721Service
- Signatures + simulation — SignatureService, SimulationService (Tenderly)
- Subscriptions — SubscriptionService (blocks/logs/pending tx)
- EIP-7702 — Delegation and atomic batching for EOAs
- React hooks — effect-evm/react-hooks (primitives + convenience hooks)
- Safe App + Safe multisig — useIsSafeAppContext, useIsHostSafeApp, useIsSafeMultisigWallet
- Wagmi integration — effect-evm/wagmi (build layers from wagmi config)
- Browser persistence — browser namespace (localStorage-backed stores)
- Testing — effect-evm/testing-kit (mocks + makeEffectEvmTestLayer`)

📖 Documentation

- Usage and examples: DOCS.md
- Contributing: CONTRIBUTING.md

📄 License

MIT