Installation
Install Viem via your package manager, a <script> tag, or build from source.
Package Manager
Install the required packages.
pnpm add viemCDN
If you're not using a package manager, you can also use Viem via an ESM-compatible CDN such as esm.sh. Simply add a <script type="module"> tag to the bottom of your HTML file with the following content.
<script type="module">
import { createClient } from 'https://esm.sh/viem'
</script>Using Unreleased Commits
If you can't wait for a new release to test the latest features, you can either install from the canary tag (tracks the main branch).
pnpm add viem@canaryOr clone the Viem repo to your local machine, build, and link it yourself.
gh repo clone wevm/viem
cd viem
pnpm install
pnpm build
pnpm link --globalThen go to the project where you are using Viem and run pnpm link --global viem (or the package manager that you used to link Viem globally).
Security
Ethereum-related projects are often targeted in attacks to steal users' assets. Make sure you follow security best-practices for your project. Some quick things to get started.
- Pin package versions, upgrade mindfully, and inspect lockfile changes to minimize the risk of supply-chain attacks.
- Install the Socket Security GitHub App to help detect and block supply-chain attacks.
- Add a Content Security Policy to defend against external scripts running in your app.