EVMts Next Wagmi Boilerplate
Visit Docs for docs, guides, API and more! 📄
To use this plugin with Visual Studio Code, you should set your workspace's version of TypeScript, which will load plugins from your tsconfig.json file.
For instructions, see: Using the workspace version of TypeScript.
This is a EVMts + wagmi + RainbowKit + Next.js boilerplate to get started using EVMts quickly
EVMts allows you to import Solidity directly into your NEXT.js typescript files with great editor support and minimal boilerplate. Features include
- Etherscan links on hover
- Human readable ABIs
- Seemless integration with wagmi for reads, writes, and events
- No ABIs referenced again just import the contract directly
- No Addresses needed to be copy pasted just configure them in the tsconfig
- Direct contract imports with etherscan links on hover
EVMts docs exist at evmts.dev. As EVMts is currently still in Alpha and following documentation driven development much of the documented behavior may not be implemented yet.
Run npm run dev in your terminal, and then open localhost:3000 in your browser.
Once the webpage has loaded, changes made to files inside the src/ directory (e.g. src/pages/index.tsx) will automatically update the webpage.
This boilerplate comes preconfigured but we will document what needed to be configured in case you are following along to add to your own NEXT.js app
EVMts requires two pieces of configuration to get started.
- TypeScript configuration
@evmts/ts-plugin is configured in the tsconfig.json. EVMts uses this configuration to configure the addresses, solc version etc. The TypeScript plugin provides TypeScript editor support for your Solidity imports.
- Bundler configuration
The bundler is how the files are processed at runtime. Next.js uses webpack. Simple webpack configuration is done in the next.config.js. The plugin here will read the configuration in the tsconfig.json
Usage examples with wagmi are in src/wagmi/ folder
- Recommended usage
To use this plugin with Visual Studio Code, you should set your workspace's version of TypeScript, which will load plugins from your tsconfig.json file.
For instructions, see: Using the workspace version of TypeScript.
- Alternative usage You can simple add this plugin to "typescript.tsserver.pluginPaths" in settings. You cannot provide plugin options such as contract addresseswith this approach.
{ "typescript.tsserver.pluginPaths": ["@evmts/ts-plugin"] }
- Other editors
Other editors are not tested/documented yet. I personally use neovim successfully and it should work in most editors. They all work via the ts-plugin settings similar to vscode.
Typechecking is disabled in the next.config.ts. Your editor will typecheck and provide diagnostics correctly but the NEXT.js build is not configured yet.
Full TypeChecking will be available soon in one of the next few releases of EVMts alpha
As a workaround .ts files can be generated to enable typechecking with tsc. To run the code gen tool run evmts-gen cli tool Codegen is undocumented and may lose support on future versions of EVMts so it is recomended to wait for the official typechecking tool
If you like EVMts give it a ⭐ at the EVMts monorepo
Check out Vite example for an example of EVMts wagmi anv Vite