Submit Your Smart Contract To Etherscan

Generate an API Key on your Etherscan account

An Etherscan API Key is a crucial prerequisite for verifying smart contracts on the Etherscan blockchain explorer. This unique identifier serves as proof of ownership, allowing you to authenticate that you are the legitimate owner of the smart contract you intend to publish. The API key acts as a security credential that ensures only authorized individuals can submit and verify contracts associated with their accounts.

To obtain your Etherscan API Key, you must first create an account on Etherscan if you do not already have one. Once your account is established and you are logged in, navigate to your user profile by clicking your username located in the top right corner of the interface. From the dropdown menu, select the "My profile" option. Within your profile settings, you will find your newly generated API key. It is essential to copy this key to your clipboard, as you will need it for subsequent verification steps on Etherscan and Goerli test network interactions.

Install the hardhat-etherscan plugin

Hardhat is a popular development environment for Ethereum smart contracts, and to facilitate the verification process on Etherscan, you must install the hardhat-etherscan plugin. This plugin streamlines the interaction between your local development environment and Etherscan's verification service, making it easier to work with Goerli and other test networks.

Begin by navigating to your project directory (such as hello-world) and execute the installation command in your terminal. Run npm install --save-dev @nomiclabs/hardhat-etherscan to install the required plugin. This command will download and integrate the hardhat-etherscan package into your project dependencies.

Following the installation, you must modify your hardhat.config.js file to include the hardhat-etherscan configuration. Within this configuration file, add the etherscan object containing your API key. The configuration should include your Solidity version, the default network setting, network-specific parameters such as the Goerli test network URL and private key, and critically, your etherscan apiKey field. Ensure that you replace "YOUR_ETHERSCAN_API_KEY" with the actual API key you obtained from your Etherscan account.

Verify your smart contract on Etherscan

With the plugin installed and properly configured, you are now ready to verify your smart contract on Etherscan. This verification process makes your smart contract's source code publicly visible and allows anyone to interact with it directly through the Etherscan interface. Verification on Goerli and other networks follows the same methodical approach.

In your project directory, execute the verification command in your terminal: npx hardhat verify --network goerli DEPLOYED_CONTRACT_ADDRESS "Hello World!". It is critical to replace DEPLOYED_CONTRACT_ADDRESS with the actual address of your deployed smart contract on the Goerli test network. Additionally, the final argument—in this example 'Hello World!'—must exactly match the string value you used during the deployment step in your initial setup. This matching is essential for the verification to succeed on Etherscan.

If the verification process completes successfully, your terminal will display a confirmation message indicating that your smart contract code has been successfully published to Etherscan. This marks a significant milestone in your smart contract development journey.

Check out your smart contract on Etherscan

Once verification is complete, you can view your published smart contract by navigating to the link provided in your terminal output. On this Etherscan page, you will be able to see your complete smart contract source code and its Application Binary Interface (ABI). These publicly available resources enable the broader blockchain community to audit your code, understand its functionality, and interact with your contract's functions across various networks including Goerli.

The publication of your smart contract on Etherscan represents the culmination of your development work. Your contract is now part of the transparent, verifiable blockchain ecosystem, and anyone with the contract address can view, call, or write to your smart contract depending on its implemented functions and permissions.

Conclusion

Publishing your smart contract to Etherscan is a straightforward yet crucial step in the smart contract deployment lifecycle. By following these systematic steps—obtaining an Etherscan API Key, installing the necessary hardhat-etherscan plugin, configuring your hardhat environment for networks like Goerli, and executing the verification command—you can successfully make your smart contract publicly verifiable and accessible. This process enhances the credibility and transparency of your smart contract on Etherscan, allowing the community to verify your code and interact with your deployed contract. With your smart contract now published on Etherscan, you have successfully completed the journey from development to public deployment.

FAQ

What's the difference between Ethereum and Etherscan?

Ethereum is a blockchain platform for decentralized applications, while Etherscan is a block explorer that lets you view transactions, smart contracts, and account data on the Ethereum network.

What is goerli testnet?

Goerli is a stable Ethereum testnet for developers to test smart contracts and dapps without using real funds. It uses Proof-of-Authority consensus and is maintained by the Ethereum community for safe experimentation.

What are the main differences between Goerli and Mainnet on Etherscan?

Goerli is Ethereum's testnet for development and testing with free ETH, while Mainnet is the live production network with real value and actual transaction fees. Goerli data doesn't affect mainnet operations.