Polygon Smart Contract Dev Environment — Complete Setup Guide

# Git Bash uses forward slashes and /c/ instead of C:\
cd "/c/Users/Admin/Documents/ai coding/salud/.claude/worktrees/romantic-morse"

# Confirm you are in the right place
ls
# You should see: hardhat.config.ts  package.json  contracts/  scripts/  test/  .env

# Copy the template
cp .env.example .env

# Verify it exists
ls -la | grep .env
# Should show: .env  and  .env.example

# Open in VS Code to fill in your keys
code .env

# Wallet (see Section 04 for formatting rules)
PRIVATE_KEY=yourprivatekeyhere64charsno0xprefix

# Polygon RPC Endpoints
POLYGON_AMOY_RPC_URL=https://rpc-amoy.polygon.technology
POLYGON_MAINNET_RPC_URL=https://polygon-rpc.com

# Block Explorer Verification (see Section 05)
POLYGONSCAN_API_KEY=yourapikeyfrometherscan

# Alchemy (optional but more reliable than public RPC)
ALCHEMY_AMOY_URL=https://polygon-amoy.g.alchemy.com/v2/yourkey
ALCHEMY_MAINNET_URL=https://polygon-mainnet.g.alchemy.com/v2/yourkey

# WRONG - has 0x prefix
PRIVATE_KEY=0xabc123yourkeyhere

# CORRECT - raw 64-char hex, no prefix
PRIVATE_KEY=abc123yourkeyhere64characterstotal

# WRONG - angle brackets are just placeholders, remove them entirely
POLYGONSCAN_API_KEY=<your_api_key_here>

# CORRECT - raw key value right after the equals sign
POLYGONSCAN_API_KEY=ABC123DEF456youractualkey

import { HardhatUserConfig } from "hardhat/config";
import "@nomicfoundation/hardhat-toolbox";
import * as dotenv from "dotenv";
dotenv.config();

// Accepts private key with or without 0x prefix
function normalizeKey(pk: string | undefined): string[] {
  if (!pk || pk.trim() === "") return [];
  const trimmed = pk.trim();
  return [trimmed.startsWith("0x") ? trimmed : `0x${trimmed}`];
}

const config: HardhatUserConfig = {
  solidity: {
    version: "0.8.28",
    settings: {
      optimizer: { enabled: true, runs: 200 },
      evmVersion: "cancun",
    },
  },
  networks: {
    hardhat: {},
    polygonAmoy: {                    // always use this exact name
      url: process.env.POLYGON_AMOY_RPC_URL || "https://rpc-amoy.polygon.technology",
      accounts: normalizeKey(process.env.PRIVATE_KEY),
      chainId: 80002,
      gasPrice: "auto",
    },
    polygon: {
      url: process.env.POLYGON_MAINNET_RPC_URL || "https://polygon-rpc.com",
      accounts: normalizeKey(process.env.PRIVATE_KEY),
      chainId: 137,
    },
  },
  etherscan: {
    apiKey: {
      polygonAmoy: process.env.POLYGONSCAN_API_KEY || "",
      polygon:     process.env.POLYGONSCAN_API_KEY || "",
    },
    customChains: [{
      network: "polygonAmoy",
      chainId: 80002,
      urls: {
        apiURL:     "https://api-amoy.polygonscan.com/api",
        browserURL: "https://amoy.polygonscan.com",
      },
    }],
  },
  sourcify: { enabled: true },
};

export default config;

# Open the Hardhat console
npx hardhat console --network polygonAmoy

# Type each line separately and press Enter after each
const [deployer] = await ethers.getSigners()
console.log(deployer.address)
# Prints: 0x742d35Cc6634C0532925a3b8D4C9C2...

# Exit the console when done
.exit

npx hardhat console --network polygonAmoy

const [deployer] = await ethers.getSigners()
const bal = await ethers.provider.getBalance(deployer.address)
console.log(ethers.formatEther(bal))
# Should print "1.0" or "0.5" -- anything above 0 and you are ready

.exit

# 1. Navigate to project root
cd "/c/Users/Admin/Documents/ai coding/salud/.claude/worktrees/romantic-morse"

# 2. Compile all contracts
npx hardhat compile

# 3. Run the full test suite -- all tests should pass before deploying
npx hardhat test

# 4. Deploy to Amoy testnet
npx hardhat run scripts/deploy.ts --network polygonAmoy

# 5. Verify contracts on Polygonscan (paste the address printed by deploy)
npx hardhat verify --network polygonAmoy 0xYourDeployedContractAddress