Differences from Ethereum that bite
Hedera is EVM-compatible, but a few things behave differently than Ethereum, and they account for most “this should work” tickets.Decimal handling: 8 vs 18
HBAR has 8 decimals (1 ℏ = 10⁸ tinybars). The JSON-RPC relay presents values to Ethereum tooling in 18-decimal weibars (1 tinybar = 10¹⁰ weibars): thevalue you send from ethers or a wallet and the result of eth_getBalance are weibars. The network converts a transaction’s value from weibars to tinybars (dividing by 10¹⁰) before the EVM runs, so inside a contract msg.value and address.balance are in tinybars. Ethereum literals such as 1 ether are 10¹⁸ tinybars on Hedera, which is 10¹⁰ HBAR.
10**10 bug comes from mixing the two scales: multiply tinybars by 10**10 only when you hand a value back to JSON-RPC tooling, never inside Solidity. See HBAR decimal places for the full breakdown.
HBAR transfers don’t always trigger receive()
On Ethereum, sending ETH to a contract address triggers receive() or fallback(). On Hedera, a native HAPI CryptoTransfer (from an SDK or wallet operating at the Hedera level rather than the EVM level) credits the contract’s underlying Hedera account directly. No EVM frame opens, so receive() doesn’t run. EVM-native paths still behave normally: call{value: ...}, transfer, and internal CALL frames all invoke receive() / fallback() as expected. If you want contract logic to execute on the HAPI path, route the deposit through a payable call instead:
ECDSA vs ED25519 keys
Hedera supports both ECDSA (secp256k1) and ED25519. The EVM toolchain only handles ECDSA. Accounts created through MetaMask or via the JSON-RPC relay get ECDSA by default; accounts created through the native SDK can get either. ED25519 accounts can still hold HBAR and HTS tokens, but they can’t sign EVM transactions. If you plan to interact through the EVM, pick ECDSA at account creation.Gas refund behavior
Per HIP-1249 (mirror node v0.140.0 release notes), unused gas is refunded in full, and only the gas you actually consumed is charged. The per-transaction limit remains 15M (HIP-185). Hedera previously capped gas refunds at 20% of the limit, so setting a generous gas limit could quietly cost you. If you find guidance referencing the 20% cap, it’s pre-HIP-1249 and no longer applies. See Gas and Fees for the full pricing model, intrinsic gas costs, and how to estimate fees.Historical queries have a retention window
The relay supportseth_call and eth_getStorageAt at historical blocks, but only as far back as the mirror node behind it has data. Query a block older than that and the relay returns an error. For deep history, retry against a provider with longer retention (Arkhia, Validation Cloud, Hgraph, QuickNode, thirdweb).
Where to ask for help
Discord
#developer-general and #smart-contracts. Live answers from engineers and the community.GitHub Issues
JSON-RPC relay bugs and feature requests.
HashScan
Look up your transaction by hash to see the consensus-level result.