The ethernaut-cli is basically an ai agent that is given access to web3 actions through hardhat tasks. It is a cli meant to be installed globally, and used like:
ethernaut what is the total supply of USDC
or
ethernaut complete level 2 of the ethernaut challenges
It can also be used as a regular cli:
ethernaut util unit 5 --from ether --to wei
And also features an interactive mode that allows easy navigation of tasks and collection of task arguments.
npm i -g ethernaut-cli
Warning!!! This software is in beta, and very experimental atm.
| Title | Description | Coverage |
|---|---|---|
| ethernaut-ai | AI assistant that interprets user input and executes hardhat tasks |  |
| ethernaut-ai-ui | Ui extensions for the ethernaut-ai package |  |
| ethernaut-cli | Main hardhat project |  |
| ethernaut-challenges | Tasks for playing the Open Zeppelin Ethernaut challenges from the CLI |  |
| ethernaut-common | Common utils used by several ethernaut-cli plugins |  |
| ethernaut-interact | Tasks for sending transactions and interacting with contracts |  |
| ethernaut-interact-ui | Ui extensions for the ethernaut-interact package |  |
| ethernaut-network | Tasks for interacting with different networks |  |
| ethernaut-network-ui | Ui extensions for the ethernaut-network package |  |
| ethernaut-ui | Intuitive navigation and interactive param collection for hardhat tasks |  |
| ethernaut-util | Simple, everyday utilities for Ethereum devs |  |
| ethernaut-util-ui | Ui extensions for the ethernaut-util package |  |
| ethernaut-wallet | Tasks for interacting from different Ethereum accounts |  |
| ethernaut-wallet-ui | Ui extensions for the ethernaut-wallet package |  |
No more man pages. No more --help.
Just type ethernaut and jump straight into an enquirer based navigation mode. Select a scope, select a task, and boom.
Once in a task, interactive mode kicks in, and parameters are collected through enquirer prompts.
This is still a regular CLI app, so commands can be called without all the fancy ui or ai stuff:
Plugins of plugins? Why not.
Plugins that enhance parameter collection prompts in other plugins with even cooler prompts, smart suggestions, etc.
For example, the ui extension of the interact plugin can fetch the abi from Etherscan if you didn't provide an abi:
But after you've interacted with the contract, it already has the abi, so the abi is instead suggested:
Another example is the extension for the model param in ethernaut ai config --model, which queries the openai API and presents a list of available models.
If that wasn't easy enough, just type whatever you want and AI will kick in to try to make sense of what you typed, and the right command or sequence of commands will be executed.
You want the AI to also teach you how the commands work? Sure.
You want the AI to also teach you about Ethereum. Also sure.
Interesting toy ain't it?
You don't have to use this entire plethora of features tho. You can use a single feature in your regular hardhat project with exactly what you need. This is because the ethernaut-cli is completely built with hardhat plugins.
You just want task navigation and interactive mode in your project: use the ethernaut-ui plugin.
Or the ai stuff: use ethernaut-ai plugin.
All the plugins combined conform the ethernaut-cli.