Introduction
I created a Japanese tutorial for ethers.js, a JavaScript library for Ethereum.
https://github.com/nakamura196/ethers-ja-tutorial
It is also published as a static site using VitePress.
https://nakamura196.github.io/ethers-ja-tutorial/
Background
ethers.js is one of the most widely used libraries in Ethereum development. Japanese articles about v6 were mostly focused on migration guides from v5, and there was no systematic tutorial for beginners to learn from scratch. Since the official documentation is only available in English, I created a tutorial that allows learners to study the basics step by step in Japanese.
Tutorial Contents
It consists of 8 chapters, covering topics from basics to practical content.
| Chapter | Theme | Content |
|---|---|---|
| 1 | Environment Setup | Installing Node.js and ethers.js |
| 2 | Providers | Connecting to the Ethereum network |
| 3 | Wallets | Creating and managing wallets |
| 4 | Reading the Blockchain | Checking balances and retrieving block information |
| 5 | Sending Transactions | Sending ETH |
| 6 | Smart Contracts | Interacting with contracts |
| 7 | Events | Listening to events |
| 8 | Utilities | Useful features like unit conversion and hashing |
Features
Includes Runnable Sample Code
Executable sample code is provided in the examples/ directory.
For example, running 01-connect.mjs retrieves the latest block number and gas price from the Ethereum mainnet.
Documentation Site with VitePress
The tutorial is built as a static site with VitePress and hosted on GitHub Pages. Each chapter is accessible from the sidebar, and a table of contents is automatically generated.
It is configured to auto-deploy via GitHub Actions on push to the main branch.
Differences from ethers.js v5
This tutorial targets v6. Major changes from v5 include the following:
ethers.providers.JsonRpcProvider->ethers.JsonRpcProvider(flat namespace)ethers.utils.formatEther()->ethers.formatEther()- BigNumber -> native
BigInt - Changes to the
Contractevent listening API
Since v5 code often doesn’t work as-is, I prepared a tutorial specifically for v6.
Tech Stack
- ethers.js v6 – Ethereum library
- VitePress – Static site generator
- GitHub Actions – CI/CD (auto-deploy)
- GitHub Pages – Hosting
Conclusion
I hope this is helpful for those who are interested in Ethereum development but find English documentation intimidating, or for those who want to systematically learn how to use ethers.js v6.
Feedback via Issues and PRs is welcome.