New to EVM development
Migrating from Ethereum
Hedera-native developer
New to EVM development
You are new to Solidity and smart contracts, or new to web3 entirely. Start with the tooling and deploy a working contract before going deeper.1
Set up a wallet and testnet account
Add Hedera Testnet to MetaMask and fund an account from the faucet.
Set Up MetaMask and Get Test HBAR.
2
Deploy your first contract
Deploy a Solidity contract with Hardhat and the JSON-RPC relay.
Deploy with Hardhat.
3
Understand what makes Hedera different
Read how execution, finality, and the account model work.
EVM on Hedera Explained.
Migrating from Ethereum or another EVM chain
You know Solidity, Hardhat, Foundry, or Remix and want to bring existing contracts to Hedera. Your bytecode and tooling carry over. Focus on the handful of behaviors that differ.1
Review the differences
Start with the differences catalogue, then the two that trip people up most: HBAR decimal precision and the account and key model.
EVM Differences, HBAR Decimals, and Accounts and Keys.
2
Point your tools at Hedera
Configure Hardhat or Foundry against the JSON-RPC relay.
JSON-RPC Relay and Tools.
Hedera-native developer adding the EVM
You already build with the Hiero SDKs and Hedera services, and you want to add Solidity contracts or call your existing HTS tokens from contract code.1
See how native services map into the EVM
Learn how to reach HTS, HCS, and other services from Solidity through system contracts.
System Contracts and HTS from Solidity.
2
Learn the EVM account model
See how Hedera accounts map to EVM addresses.
EVM on Hedera Explained and Accounts.
3
Combine ERC and HTS
Use hybrid tokenization to keep ERC compatibility with native controls.
Hybrid Tokenization.