Slightly opinionated Next.js Web3 boilerplate built on ethers, web3-react, Typechain, and SWR.
⚠️ Notice
This template is no longer under active maintenance, it's out-of-date with the state of the ethereum ecosystem. Some reccomendations for replacing this would be to use the Next.js + TypeScript + ConnectKit example from Family, using wagmi directly or web3modal.This is a default Next.js project bootstrapped with create-next-app, customized as the default boilerplate for new Web3 projects.
Features
- Separate packages from ethers.js for improved tree-shaking, often only ethers Contracts
- Hooks-first approach to fetching and caching data from Contracts and memoization for performance with SWR
- web3-react for ease of connecting to Web3 providers with a solid API
- Auto-generates types for the contract ABIs in the
/contractsfolder via TypeChain
Auto Contract Type Generation
Note: After adding in your new contract ABIs (in JSON format) to the /contracts folder, run yarn compile-contract-types to generate the types.
You can import these types when declaring a new Contract hook. The types generated show the function params and return types of your functions, among other helpful types.
import MYCONTRACTABI from "../contracts/MY_CONTRACT.json";
import type { MY_CONTRACT } from "../contracts/types";
import useContract from "./useContract";
export default function useMyContract() { return useContract<MYCONTRACT>(CONTRACTADDRESS, MYCONTRACTABI); }
Previous Art
Getting Started
First, run the development server:
npm run dev
or
yarn dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying pages/index.js. The page auto-updates as you edit the file.
Learn More
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.