# Deploy a simple contract

In this first tutorial, you'll write and deploy a basic Ethereum-compatible smart contract to the IoTeX testnet using **Solidity**, **Hardhat**, and **MetaMask**. The contract includes a simple function that accepts a string and emits an event with that string — allowing anyone to write a permanent message on the IoTeX blockchain.

## **Prerequisites**

* Node.js and npm installed — [instructions](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
* MetaMask wallet — [install](https://metamask.io/download)

<a href="https://developers.iotex.io/metamask" class="button secondary">Add IoTeX Testnet to Metamask</a>   <a href="https://developers.iotex.io/faucet" class="button primary">Claim some Testnet IOTX</a>

## **Step 1: Set Up Your Project**

```bash
mkdir iotex-contract-tutorial
cd iotex-contract-tutorial
npm init -y
npm install --save-dev hardhat
npx hardhat
```

When prompted, select `Create a JavaScript project` from the menu, follow the prompts and accept the defaults.

## **Step 2: Write the Contract**

Replace the contents of `contracts/Lock.sol` with the following:

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract MessageBoard {
    event MessagePosted(address sender, string message);

    function postMessage(string calldata message) external {
        emit MessagePosted(msg.sender, message);
    }
}
```

## **Step 3: Configure for IoTeX**

Ensure dependencies are installed:

```bash
npm install @nomicfoundation/hardhat-toolbox
```

Update `hardhat.config.js`:

```javascript
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: "0.8.21",
  networks: {
    iotex_testnet: {
      url: "https://babel-api.testnet.iotex.io",
      accounts: ["<YOUR_PRIVATE_KEY>"]
    }
  }
};
```

{% hint style="danger" %}
Replace `<YOUR_PRIVATE_KEY>` with your MetaMask private key (testnet only!). Never share or commit this key to public code repositories.
{% endhint %}

## **Step 4: Deploy the Contract**

Create a new file `scripts/deploy.js`:

```javascript
const hre = require("hardhat");

async function main() {
  const MessageBoard = await hre.ethers.getContractFactory("MessageBoard");
  const contract = await MessageBoard.deploy();

  await contract.waitForDeployment();
  console.log("Contract deployed to:", await contract.getAddress());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

```

Then deploy:

```bash
npx hardhat run scripts/deploy.js --network iotex_testnet
```

You should see your contract address printed in the terminal. You’ve now deployed your first contract to the IoTeX Blockchain!

***

## Part 2: Interact with Your Contract Using JavaScript

In the second tutorial, you'll build a Node.js application to interact with the deployed contract using Web3.js. Instead of sending IOTX tokens, your application will call the contract's function to send messages and view events logged on-chain.

These tutorials use JavaScript (Node.js), Solidity, MetaMask, and Web3.js — all common tools for Ethereum developers — to provide a smooth onboarding experience for building on IoTeX Layer 1.

***

{% hint style="info" %}
**Continue to** [Build a client for your contract](/blockchain/quick-start/build-a-client-for-your-contract.md)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iotex.io/blockchain/quick-start/deploy-a-simple-contract.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.