Getting Started ​

Overview ​

viem is a TypeScript interface for Ethereum that provides low-level stateless primitives for interacting with Ethereum. viem is focused on developer experience, stability, bundle size, and performance:

• Developer experience Automatic type safety and inference, comprehensive documentation, composable APIs.
• Stability Test suite runs against forked Ethereum networks, complete test coverage.
• Bundle size Modular, tree-shakable, 35kB bundle.
• Performance Optimized encoding/parsing, async tasks only when necessary, consistently #1 in benchmarks.

You can learn more about the rationale behind the project in the Why viem section.

Installation ​

npm i viem

pnpm i viem

yarn add viem

Quick Start ​

1. Set up your Client & Transport ​

Firstly, set up your Client with a desired Transport & Chain.

import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

const client = createPublicClient({
  chain: mainnet,
  transport: http(),
})

2. Consume Actions! ​

Now that you have a Client set up, you can now interact with Ethereum and consume Actions!

import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

const client = createPublicClient({
  chain: mainnet,
  transport: http(),
})

const blockNumber = await client.getBlockNumber()

Live example ​