Hello and welcome to the course! I'm excited to guide you on your journey from a theoretical understanding of blockchain to becoming a hands-on developer, focusing on your goal of building applications for tokenized money.
This first lesson is all about laying the groundwork. To build, test, and deploy smart contracts, we need a solid development environment. Today, we will install the three essential tools that form the foundation of our workflow:
- Node.js: A JavaScript runtime that will power our development framework and scripts.
- Visual Studio Code (VS Code): A versatile code editor where we'll write our smart contracts.
- MetaMask: A browser wallet that will act as our gateway to the Ethereum blockchain.
By the end of this 60-minute lesson, you'll have a complete local setup, ready to start building in the next lesson. Let's begin.
1. The Engine: Installing Node.js
First, we need to install Node.js. While you might know JavaScript from its role in web browsers, Node.js allows us to run it directly on our machines. This is crucial for Ethereum development because our primary tool, Hardhat, is built on Node.js. We'll use it to compile contracts, run tests, and execute deployment scripts.
Node.js also comes with npm (Node Package Manager), which we'll use to manage project dependencies, similar to how pip is used in Python environments.
For installation, we'll refer to the official Hardhat documentation, as it provides the most direct and reliable instructions for setting up an environment compatible with Hardhat.
This guide from the official Hardhat documentation provides clear, OS-specific instructions for installing Node.js. It's the recommended starting point for any Hardhat developer.
Please read the section 'Installing Node.js'. Follow the command-line instructions that match your operating system (Ubuntu, MacOS, or Windows). The guide strongly recommends using WSL 2 on Windows, which is a best practice for blockchain development. If you already have Node.js, ensure your version is 18.0 or higher.
After following the instructions, verify your installation by opening a new terminal and running:
node -v
npm -v
You should see the version numbers for Node.js and npm printed, confirming that they are installed and accessible from your system's path.
2. The Workbench: Installing Visual Studio Code
Next, you need a code editor. While you can use any editor, Visual Studio Code (VS Code) has become the de-facto standard for smart contract development due to its excellent extension ecosystem. These extensions provide syntax highlighting, code completion, and error checking for Solidity, which will significantly speed up your workflow.
First, download and install VS Code from the official website.
Once installed, we'll add a few essential extensions specifically for Solidity development. The following reading explains what to install and why.
This article by Michael Pichura provides a concise guide to setting up VS Code for Solidity, including a list of recommended extensions that will enhance your development experience.
Read section '2. Installing Visual Studio Code'. You have already installed VS Code itself. Now, focus on the subsection '3. Install recommended extensions'. You can either install them from the VS Code marketplace (the 'Extensions' tab on the left sidebar) or run the provided commands in your terminal.
Installing these extensions will make writing Solidity feel much more like a modern development experience, which will be invaluable as we start writing our first contracts.
3. The Gateway: Installing MetaMask
The final piece of our setup is MetaMask. MetaMask is a crypto wallet that runs as a browser extension. It allows us to manage Ethereum accounts and interact with decentralized applications (dApps) and smart contracts directly from our browser.
For our purposes, we will use it to:
- Hold test Ether (a valueless version of ETH) on various test networks.
- Pay for the "gas" fees required to deploy and test our contracts.
- Act as a user account to interact with our token contracts.
The following video from CoinGecko provides an excellent introduction and setup guide. Pay very close attention to the section on the Secret Recovery Phrase (or seed phrase). This is the single most critical piece of information for securing a wallet.
What Is MetaMask? | Beginner's MetaMask Tutorial In 2025!
This video provides a clear, step-by-step tutorial for installing and setting up a new MetaMask wallet. It places strong and necessary emphasis on security practices.
Watch the video from the beginning of the installation process (02:19) through the account creation and security explanation (05:02). Follow along to install the extension and create your first wallet. Crucially, when you are given your 12-word seed phrase, write it down on a piece of paper and store it somewhere safe and private. Never store it digitally.
A few key security takeaways that cannot be overstated:
- Your Secret Recovery Phrase is your master key. Anyone who has it can access your funds. The MetaMask team will never ask you for it.
- Store it offline. Do not save it in a text file, email, or cloud drive. Physical copies are best.
- Beware of phishing. Only download MetaMask from the official website (
metamask.io) and be suspicious of any website or person asking for your private key or seed phrase.
Once MetaMask is installed and you have secured your recovery phrase, you are all set.
Conclusion
Congratulations on completing the first lesson! You have now installed the three pillars of your Ethereum development environment:
- Node.js: The runtime for our development tools.
- VS Code: Our editor for writing and managing code.
- MetaMask: Our wallet for interacting with the blockchain.
With this foundation in place, you are ready to move from setup to actual development. In the next lesson, we will use these tools to create your first Hardhat project, which will serve as the professional framework for compiling, testing, and deploying all the smart contracts we build in this course.