Deploy Your Contract (Hardhat)

Deploy Your First Contract (Hardhat)

This guide deploys a simple Solidity contract to SATUCHAIN Testnet using Hardhat and a private key from MetaMask.

Requirements

• Node.js 18+ and npm

• A wallet with tSTU (faucet): https://faucet.satuchain.com/

• SATUCHAIN Testnet RPC: https://rpc-testnet.satuchain.com

• Chain ID: 17081945

• Explorer: https://testnet.satuchain.com

1) Create a Hardhat Project

Open a terminal:

mkdir satuchain-hardhat
cd satuchain-hardhat
npm init -y
npm install --save-dev hardhat
npx hardhat init

If prompted, choose a basic TypeScript or JavaScript project (either is fine).

2) Install Dependencies

npm install --save-dev @nomicfoundation/hardhat-toolbox dotenv

3) Add Your Private Key

Create a .env file:

PRIVATE_KEY=YOUR_METAMASK_PRIVATE_KEY

Notes:

• Use a testnet-only wallet.

• Never commit .env to git.

4) Add SATUCHAIN Testnet Network

Open hardhat.config.js (or hardhat.config.ts) and add the network:

hardhat.config.js

require("@nomicfoundation/hardhat-toolbox");
require("dotenv").config();

const { PRIVATE_KEY } = process.env;

module.exports = {
  solidity: "0.8.20",
  networks: {
    satuchainTestnet: {
      url: "https://rpc-testnet.satuchain.com",
      chainId: 17081945,
      accounts: PRIVATE_KEY ? [PRIVATE_KEY] : [],
    },
  },
};

5) Create the Contract

Create contracts/Storage.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Storage {
    uint256 private value;

    event ValueChanged(uint256 newValue);

    function set(uint256 newValue) external {
        value = newValue;
        emit ValueChanged(newValue);
    }

    function get() external view returns (uint256) {
        return value;
    }
}

6) Create the Deploy Script

Create scripts/deploy.js:

const hre = require("hardhat");

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

  await storage.waitForDeployment();
  const address = await storage.getAddress();

  console.log("Storage deployed to:", address);
}

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

7) Compile and Deploy

Compile:

npx hardhat compile

Deploy to SATUCHAIN Testnet:

npx hardhat run scripts/deploy.js --network satuchainTestnet

You should see the deployed contract address printed in the terminal.

8) Verify the Deployment

1. Copy the contract address from the terminal output.

2. Open the explorer: https://testnet.satuchain.com

3. Search the address to confirm:

   • Contract exists

   • Deployment transaction is successful

Troubleshooting

Insufficient funds

• Claim more tSTU from the faucet and retry.

Invalid sender / signature error

• Your PRIVATE_KEY is wrong or missing 0x prefix.

• Ensure .env is loaded and the account is configured.

RPC issues

• Confirm the RPC URL is exactly: https://rpc-testnet.satuchain.com