#hardhat-vyper
Hardhat plugin to develop smart contracts with Vyper.
# What
This plugin adds support for Vyper to Hardhat. Once installed, Vyper contracts can be compiled by running the compile
task.
This plugin generates the same artifact format as the built-in Solidity compiler, so that it can be used in conjunction with all other plugins.
The Vyper compiler is run using the official binary releases.
# Installation
First, you need to install the plugin by running
npm install --save-dev @nomiclabs/hardhat-vyper
And add the following statement to your hardhat.config.js
:
require("@nomiclabs/hardhat-vyper");
Or, if you are using TypeScript, add this to your hardhat.config.ts
:
import "@nomiclabs/hardhat-vyper";
# Required plugins
No plugins dependencies.
# Tasks
This plugin creates no additional tasks.
# Environment extensions
This plugin does not extend the Hardhat Runtime Environment.
# Configuration
This plugin adds an optional vyper
entry to Hardhat's config, which lets you specify the Vyper version to use.
This is an example of how to set it:
module.exports = {
vyper: {
version: "0.3.0",
},
};
You can also configure multiple versions of the Vyper compiler, as well as the compiler settings evmVersion and optimize. See the Vyper docs for more info.
module.exports = {
vyper: {
compilers: [
{
version: "0.2.1",
},
{
version: "0.3.10",
settings: {
evmVersion: "paris",
optimize: "gas",
},
},
],
},
};
# Usage
There are no additional steps you need to take for this plugin to work.
# Test directives
Brownie allows you to use the test directive #@ if mode == "test":
to specify when a portion of code should be included only for testing purposes.
Example:
#@ if mode == "test":
@external
def _mint_for_testing(_to: address, _token_id: uint256):
self._mint(_to, _token_id)
#@ endif
We do NOT support this feature. An error will be thrown every time that, when compiling a contract, the directive #@ if mode == "test":
is found.
#Additional notes
The oldest vyper version supported by this plugin is 0.2.0. Versions older than this will not work and will throw an error.