Skip to content

evmts/bun-starterkit

Repository files navigation

wagmi logo

Evmts bun example

✨ EVMts bun starterkit

Starter project of using Bun with EVMts. EVMts is an LSP and bundler used to import solidity contracts directly into your TypeScript code.

Untitled_ Sep 9, 2023 9_27 AM (1)

🤝 Getting Started

  1. Install Node Modules
bun install
  1. Run tests
bun test
  1. Run bun script in watch mode
bun dev

EVMts bundler configuration

EVMts works via a bun plugin. This includes:

  1. EVMts configuration which is in the tsconfig.json. Note in future EVMts will be configurable via a evmts.config.ts file.

The minimal configuration simply needs to specify typescript uses the @evmts/ts-plugin but it also has other configuration options. This template globally configured the contract addresses for ExampleContract.sol

  1. Bun plugin configuration in the plugins.ts file along with loading the plugin file in bunfig.toml

This enables bun to import solidity files

EVMts LSP

EVMts LSP gives you language server functionality in your editor. In EVMts this includes many nice features

  • Natspec comments on hover
  • go-to-definition takes you directly to the solidity code that defined the contract method or event
  • Etherscan links to your contracts on hover

Below is an example of go-to-definition support

Untitled_ Sep 3, 2023 6_52 AM

Ethers.js

An ethers.js version of this template is available on the ethers branch

image

VSCode instructions

Special steps are needed to get the LSP features working in VSCode. Most editors should work out the box but please open an issue if you run into trouble.

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.

  1. Open a typescript file in your project in vscode
  2. Open command pallet +p or +p
  3. Select >Typescript: Select TypeScript Version in command pallet
  4. Select Use workspace version

image image

You now should get all the EVMts LSP features such as natspec comments on hover and go-to-solidity-definition support

For more details see: Using the workspace version of TypeScript.

⭐ Github

If you like Evmts give it a ⭐ at the Evmts monorepo

🔗 See also

About

A minimal EVMts+Viem+Bun starterkit

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published