Verify & Publish Contract ( Hardhat )

This guide explains how to verify and publish a deployed contract on SATUCHAIN Testnet Explorer using Hardhat. Explorer API: https://testnet.satuchain.com/api

---

Prerequisites

You need:

• Contract deployed on SATUCHAIN Testnet

• Contract address

• Matching compiler settings (solc version, optimizer, runs, viaIR, evmVersion)

• Node.js project with Hardhat

SATUCHAIN Testnet:

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

• Chain ID: 17081945

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

---

1) Install Hardhat Verify Plugin

If you use @nomicfoundation/hardhat-toolbox, you already have the verify task. Otherwise install:

npm i -D @nomicfoundation/hardhat-verify dotenv

---

2) Configure Hardhat Network

In hardhat.config.js:

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

const { PRIVATE_KEY } = process.env;

module.exports = {
  solidity: {
    version: "0.8.20",
    settings: {
      optimizer: { enabled: true, runs: 200 },
      // evmVersion: "paris",   // set only if you used it in compilation
      // viaIR: false,          // set only if you used it in compilation
    },
  },
  networks: {
    satuchainTestnet: {
      url: "https://rpc-testnet.satuchain.com",
      chainId: 17081945,
      accounts: PRIVATE_KEY ? [PRIVATE_KEY] : [],
    },
  },
  etherscan: {
    // IMPORTANT: Some explorers require an API key field even if unused.
    // Use any placeholder unless SATUCHAIN enforces a real key.
    apiKey: {
      satuchainTestnet: process.env.SATU_EXPLORER_API_KEY || "satuchain",
    },
    customChains: [
      {
        network: "satuchainTestnet",
        chainId: 17081945,
        urls: {
          apiURL: "https://testnet.satuchain.com/api",
          browserURL: "https://testnet.satuchain.com",
        },
      },
    ],
  },
};

Create .env:

PRIVATE_KEY=YOUR_TESTNET_PRIVATE_KEY
SATU_EXPLORER_API_KEY=satuchain

If SATUCHAIN later requires a real key, replace the placeholder value.

---

3) Deploy (Example)

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

Copy the deployed contract address from the output.

---

4) Verify (No Constructor Args)

npx hardhat verify --network satuchainTestnet <CONTRACT_ADDRESS>

Example:

npx hardhat verify --network satuchainTestnet 0xYourContractAddress

---

5) Verify (With Constructor Args)

If your contract constructor has parameters:

npx hardhat verify --network satuchainTestnet <CONTRACT_ADDRESS> "arg1" "arg2"

Example:

npx hardhat verify --network satuchainTestnet 0xYourContractAddress "MyToken" "MTK"

If you pass an address:

npx hardhat verify --network satuchainTestnet 0xYourContractAddress 0xRecipientAddress

---

6) Confirm on Explorer

Open: https://testnet.satuchain.com/address/<CONTRACT_ADDRESS>

You should see the contract marked as Verified with:

• Source code

• ABI

• Read/Write tabs

---

Troubleshooting

“Contract source code already verified”

The contract is already verified; nothing else needed.

“Bytecode does not match”

Most common causes:

• Wrong Solidity version

• Optimizer settings mismatch (enabled/runs)

• viaIR mismatch

• evmVersion mismatch (e.g. paris)

• You deployed a different build artifact than the one you are verifying

“Missing API Key” / “Invalid API Key”

If SATUCHAIN requires a real key, set SATU_EXPLORER_API_KEY to the correct value. If it does not, keep a placeholder as shown.

---