hashgraph · mintlify · Jun 10, 2026
@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Addresses"
+description: "Compare smart contract EVM addresses and Hedera contract IDs, how they map via HIP-729, and when to use each format with HashScan and MetaMask."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "EVM Archive Node Queries"
+description: "Use the Hedera mirror node /contracts/call endpoint to run gas-free smart contract queries, estimate gas, and simulate EVM transactions without state changes."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Compiling Smart Contracts"
+description: "Learn how Solidity is compiled to EVM bytecode and ABI on Hedera using solc, Remix, Hardhat, and Truffle before deploying your smart contract."
 ---
 
 Compiling a smart contract involves using the contract's source code to generate its [**bytecode**](/support/glossary#bytecode) and the contract [**Application** **Binary Interface (ABI)**](/support/glossary#application-binary-interface-abi). The Ethereum Virtual Machine (EVM) executes the bytecode to understand and execute the smart contract. Meanwhile, other smart contracts use the ABI to understand how to interact with the deployed contracts on the Hedera network.

@@ -1,5 +1,6 @@
 ---
 title: "Creating Smart Contracts"
+description: "Write smart contracts for the Hedera EVM in Solidity or Vyper, compile to bytecode, and target the Ethereum Virtual Machine with familiar tools."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Deploying Smart Contracts"
+description: "Deploy Solidity smart contracts to the Hedera Besu EVM using ContractCreate, EthereumTransaction, or eth_sendRawTransaction with the Cancun hard fork."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Forking Hedera Network for Local Testing"
+description: "Fork Hedera mainnet or testnet locally with the hedera-forking library to test Solidity contracts and system contracts in Foundry or Hardhat."
 ---
 
 This guide explains how fork testing works on Hedera, how it differs from traditional EVM chains, and how the [hedera-forking](https://github.com/hashgraph/hedera-forking) library enables local development with Hedera System Contracts.

@@ -1,6 +1,6 @@
 ---
 title: "Gas and Fees"
-description: "Understanding gas costs, throttling, and fee calculation for Hiero Contracts"
+description: "Understand gas, weibar, intrinsic costs, throttling, and fee calculation on the Hedera EVM after HIP-1249 eliminated minimum gas charges for contracts."
 mode: "wide"
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: "JSON-RPC Relay"
+description: "Use the Hiero JSON-RPC Relay to interact with Hedera nodes through standard EVM methods like eth_call, eth_sendRawTransaction, and eth_getLogs."
 ---
 
 The [Hiero JSON-RPC Relay](https://github.com/hiero-ledger/hiero-json-rpc-relay) is an open-source project implementing the EVM JSON-RPC standard. It allows developers to interact with Hedera nodes using familiar EVM tools, allowing developers and users to deploy, query, and execute contracts as they usually would. Check out the interactive[ OpenRPC Specification](https://playground.open-rpc.org/?schemaUrl=https://raw.githubusercontent.com/hashgraph/hedera-json-rpc-relay/main/docs/openrpc.json&uiSchema%5BappBar%5D%5Bui:splitView%5D=false&uiSchema%5BappBar%5D%5Bui:input%5D=false&uiSchema%5BappBar%5D%5Bui:examplesDropdown%5D=false) and a simple [list of endpoints](https://github.com/hiero-ledger/hiero-json-rpc-relay/blob/main/docs/rpc-api.md).

@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Rent"
+description: "Learn how smart contract auto-renewal and storage rent will work on Hedera, including the planned $0.02 per key-value pair annual storage fee."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Security"
+description: "Review the Hedera Smart Contract Service security model, EVM equivalence on Besu, authorization rules, and how state changes are scoped on contracts."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Traceability"
+description: "Inspect Hedera smart contract execution using call traces and state traces to debug, audit, and analyze nested function calls and gas consumption."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: "Troubleshooting"
-description: "Diagnose and fix common issues when developing EVM smart contracts on Hedera."
+description: "Diagnose common Hedera EVM contract errors including gas failures, decoded reverts, HBAR transfer issues, 8 vs 18 decimal bugs, and JSON-RPC quirks."
 ---
 
 Most failures on Hedera fall into one of a few buckets: gas problems, reverts you can't decode, HBAR transfers that don't trigger your contract, decimal mismatches between SDK and EVM, or RPC issues that look like contract bugs but aren't. The sections below cover the patterns that account for most of them.

@@ -1,5 +1,6 @@
 ---
 title: "Verifying Smart Contracts"
+description: "Verify Hedera smart contracts on Sourcify so HashScan and other mirror node explorers can display matched source code, ABI, and metadata for users."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Accounts, Signature Verification & Keys (ECDSA vs. ED25519)"
+description: "Compare Hedera account models, ECDSA and ED25519 key handling, aliases, and signature verification with isAuthorized versus Ethereum's ECRECOVER flow."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: "Migration Checklist"
-description: "A step-by-step checklist for migrating your dApp from Ethereum to Hedera."
+description: "Follow a step-by-step checklist for migrating an Ethereum dApp to Hedera, covering accounts, decimals, tokens, JSON-RPC, and contract deployment changes."
 hidden: true
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: "Decimal Handling (8 vs. 18 Decimals)"
+description: "Understand 8 vs 18 decimal handling for HBAR, HTS tokens, and ERC-20 tokens across HAPI, the Smart Contract Service, and the JSON-RPC relay on Hedera."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: Understanding Hedera's EVM Differences and Compatibility
+description: "Compare Hedera and Ethereum on consensus, fees, tokens, key management, and JSON-RPC behavior to migrate Solidity smart contracts and EVM dApps."
 sidebarTitle: Hedera vs. Ethereum
 ---
 

@@ -1,6 +1,6 @@
 ---
 title: "JSON-RPC Relay and EVM Tooling"
-description: "Learn how to use the JSON-RPC relay and familiar EVM tools to interact with the Hedera network."
+description: "See how the Hiero JSON-RPC relay supports EVM tooling like Hardhat, Foundry, and MetaMask, plus differences in state queries, logs, and historical data."
 mode: "wide"
 ---
 

@@ -1,6 +1,6 @@
 ---
-title: "Integrating
-      ED25519 Accounts and Advanced Features Into Smart Contracts"
+title: "Integrate ED25519 accounts and HIP-632 in smart contracts"
+description: "Use HIP-632 system contract functions isAuthorized and isAuthorizedRaw to verify ED25519 and ECDSA signatures from Solidity smart contracts on Hedera."
 ---
 ## Overview
 

@@ -1,5 +1,6 @@
 ---
 title: "Extending Token Management with Smart Contracts"
+description: "Extend HTS token management with Solidity by combining mintToken, burnToken, supply keys, and access control patterns inside Hedera smart contracts."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: For Hedera-Native Developers Adding Smart Contract Functionality
+title: "Add smart contracts to Hedera-native applications"
+description: "Add EVM smart contract logic to Hedera-native apps using HTS, HCS, mirror nodes, and ECDSA or ED25519 key management without losing native performance."
 sidebarTitle: For Native Devs
 ---
 ## **Introduction**

@@ -1,5 +1,6 @@
 ---
 title: "JSON-RPC Relay and State Queries"
+description: "Query Hedera state from EVM tooling using the JSON-RPC relay and mirror nodes, and learn how the lack of a Merkle Patricia Trie affects historical data."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Handling HBAR Transfers in Contracts"
+description: "Handle HBAR transfers in Solidity on Hedera, including when receive() and fallback() fire and how transfer(), send(), and call() differ from Ethereum."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Token Management with Hedera Token Service"
+description: "Manage token supply on Hedera using the HTS system contract at 0x167, supply keys, and access control patterns since native HBAR cannot be burned."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: "Create Tokens"
-description: "Create fungible and non-fungible HTS tokens directly from Solidity via the 0x167 system contract."
+description: "Create fungible and non-fungible HTS tokens from Solidity using the 0x167 system contract, with optional custom fees, royalties, and ERC-20 or ERC-721 access."
 ---
 
 The HTS system contract at `0x167` lets a Solidity contract create native HTS tokens. The resulting token is a real HTS token: same association rules, same mirror node REST responses, same HashScan view as an SDK-created one. You can operate on it through the HTS interface or through ERC-20 / ERC-721 redirects.

@@ -1,5 +1,6 @@
 ---
 title: "ERC/EVM-Compatible Tokenization"
+description: "Deploy ERC-20 and ERC-721 smart contracts on Hedera using Hardhat, ethers.js, web3.js, and Remix while keeping standard EVM workflows and low fees."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Hybrid (HTS + EVM ) Tokenization"
+description: "Combine Hedera Token Service tokens with EVM smart contracts to manage HTS tokens like ERC-20 or ERC-721 and add programmable logic via system contracts."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Hedera Account Service"
+description: "Use the Hedera Account Service system contract at 0x16a to verify signatures, call ECRECOVER on ECDSA aliases, and authorize ED25519 keys via HIP-632."
 sidebarTitle: "Account Service"
 ---
 

@@ -1,7 +1,7 @@
 ---
 title: "Exchange Rate System Contract"
 sidebarTitle: "Exchange Rate"
-description: "Query HBAR/USD exchange rates directly from your smart contracts via the 0x168 system contract."
+description: "Query the live HBAR to USD exchange rate from Solidity using the 0x168 system contract to convert tinycents and tinybars deterministically on-chain."
 ---
 
 The exchange rate system contract exposes the network's active HBAR/USD rate to your EVM contracts. If you want to price something in USD but settle in HBAR, this is what you call.

@@ -1,5 +1,6 @@
 ---
 title: "Hedera Token Service System Contract"
+description: "Call the Hedera Token Service system contract at 0x167 from Solidity to create, mint, burn, associate, freeze, KYC, and transfer fungible and NFT tokens."
 sidebarTitle: "Token Service"
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: System Smart Contracts
+description: "Browse Hedera's system smart contracts for token service, exchange rate, account service, and scheduling, with reserved EVM addresses and Solidity interfaces."
 sidebarTitle: System Contracts
 ---
 System smart contracts are Hedera API functionality logic presented at reserved address locations on the EVM network. These addresses contain reserved function selectors. When a deployed contract calls these selectors, they execute as though a corresponding system contract exists on the network. Both system and user-deployed contracts live at the same address. If a contract is redeployed, it gets a new address while the original address retains the old bytecode.

@@ -1,5 +1,6 @@
 ---
 title: "Hedera Schedule Service"
+description: "Schedule future smart contract calls on Hedera using the HSS system contract and HIP-755 and HIP-1215 for on-chain automation and multi-sig workflows."
 sidebarTitle: "Schedule Service"
 mode: "wide"
 ---

@@ -1,6 +1,6 @@
 ---
 title: "EVM Developers"
-description: "Deploy Solidity smart contracts on Hedera using MetaMask, Hardhat, Foundry, and the JSON-RPC relay, your existing EVM workflow."
+description: "Build and deploy Solidity smart contracts on Hedera using MetaMask, Hardhat, Foundry, Remix, and the JSON-RPC relay with your familiar EVM workflow."
 mode: wide
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: Interoperability and Bridging
+description: "Move assets and messages between Hedera and other chains using LayerZero, Chainlink CCIP, Hashport, and other cross-chain interoperability protocols."
 ---
 
 Interoperability and bridging on Hedera enable seamless communication and asset transfers between Hedera and other blockchain networks. This will allow developers to create dApps across multiple blockchain platforms, furthering the functionality and versatility of applications. Projects like **LayerZero**, **Chainlink**, and **Hashport** are among the leading providers of these integrations. Learn more about these integrations below.

@@ -1,5 +1,6 @@
 ---
 title: "LayerZero"
+description: "Send omnichain messages and bridge HTS or ERC-20 tokens between Hedera and other EVM chains using the LayerZero protocol and OApp contract templates."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Chainlink Oracles"
+description: "Connect Hedera smart contracts to real-world data with Chainlink Price Feeds, VRF, and oracles, including a working price feed demo repository on Hedera."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: Oracle Networks
-description: Oracle networks integrated with the Hedera network.
+description: "Compare oracle networks available on Hedera, including Pyth, Chainlink, and Supra, to feed real-world price and event data into your smart contracts."
 ---
 Oracle networks integrated with Hedera provide secure, reliable, and decentralized off-chain data feeds for applications and smart contracts. They bridge the gap between blockchain-based systems and external data, enabling smart contracts to access real-world information like market prices, weather forecasts, and more to execute automated actions, such as payments or trading decisions.
 

@@ -1,5 +1,6 @@
 ---
 title: "Pyth Oracles"
+description: "Integrate the Pyth Network on Hedera to pull low-latency price feeds for crypto, equities, FX, and commodities into your Solidity smart contracts."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Supra Oracles"
+description: "Pull Supra Oracles price feeds into Hedera smart contracts for real-time crypto and asset data, with payload sizing and mirror node call considerations."
 ---
 
 

@@ -1,7 +1,7 @@
 ---
 title: "Tutorial: MetaMask Snaps – What Are They and How to Use Them"
 sidebarTitle: "MetaMask Snap Tutorial"
-description: "A step-by-step tutorial on how to integrate the Hedera Wallet Snap by MetaMask into a dApp."
+description: "Step-by-step tutorial to integrate the Hedera Wallet Snap by MetaMask into a dApp so users can send HBAR and query Hedera account info without a relay."
 ---
 
 ## Introduction

@@ -1,7 +1,8 @@
----
-title: Hedera Wallet Snap By MetaMask
+---
+title: Hedera Wallet Snap By MetaMask
+description: "Install the Hedera Wallet Snap by MetaMask to send HBAR, query account info, and interact with Hedera natively from the MetaMask browser extension."
 sidebarTitle: MetaMask Snap
----
+---
 ## Overview
 
 MetaMask is a popular Ethereum wallet and browser extension that developers can integrate into a variety of third-party applications. MetaMask Snaps is an open-source solution to enhance MetaMask's functionalities beyond its native capabilities. The [Hedera Wallet Snap](https://snaps.metamask.io/snap/npm/hashgraph/hedera-wallet-snap/), developed by [Tuum Tech](https://www.tuum.tech/) and managed by [Hashgraph](https://www.hashgraph.com/), enables users to interact directly with the Hedera network without relying on [Hedera JSON-RPC Relay](https://github.com/hashgraph/hedera-json-rpc-relay), offering Hedera native functionalities like sending HBAR to different accounts and retrieving account information.

@@ -1,4 +1,5 @@
 ---
 title: "Hedera WalletConnect"
+description: "Connect Hedera dApps to mobile and desktop wallets using the Hedera WalletConnect library for HAPI transactions, signing, and account management."
 url: "https://github.com/hashgraph/hedera-wallet-connect?tab=readme-ov-file#overview"
----
+---
@@ -1,5 +1,6 @@
 ---
 title: "Deploy your First Contract with Hedera Contract Builder"
+description: "Deploy your first Hedera smart contract from the browser with the Hedera Contract Builder in the developer portal, no local setup or toolchain required."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Deploy and Verify a Smart Contract with Foundry"
+description: "Compile, deploy, and verify a Solidity ERC-20 smart contract on Hedera testnet using Foundry, forge, and cast through the Hedera JSON-RPC relay."
 ---
 
 ## Deploying a Contract Using Foundry

@@ -1,5 +1,6 @@
 ---
 title: "Deploy and Verify a Smart Contract with Hardhat"
+description: "Compile, deploy, and interact with an ERC-721 Solidity smart contract on Hedera testnet using Hardhat, ethers.js, and the Hedera JSON-RPC relay."
 ---
 
 ## Deploying a Contract Using Hardhat Scripts

@@ -1,6 +1,6 @@
 ---
 title: "Deploy a Smart Contract with Remix"
-description: "A step-by-step tutorial on how to create and deploy a smart contract on the Hedera network using Remix IDE."
+description: "Step-by-step guide to writing, compiling, and deploying a Solidity smart contract to Hedera testnet from the browser using Remix IDE and MetaMask."
 ---
 
 ## Introduction to Remix IDE

@@ -1,4 +1,5 @@
 ---
 title: "Hedera vs. Ethereum"
+description: "Quick redirect to the Hedera vs. Ethereum comparison covering EVM compatibility, account models, tokens, fees, and key differences for Solidity developers."
 url: "/evm/differences/index"
 ---
@@ -1,5 +1,6 @@
 ---
 title: "Hedera Testnet Faucet"
+description: "Use the Hedera testnet faucet to create a new account from your EVM wallet address and receive free testnet HBAR for smart contract development."
 ---
 
 The Hedera faucet allows you to quickly create and fund a testnet account without creating a developer portal account. The faucet flow auto-creates an account when you enter an EVM wallet address to receive testnet HBAR.

@@ -1,4 +1,5 @@
 ---
 title: "Hedera Contract Builder"
+description: "Quick link to the Hedera Contract Builder, a browser-based IDE for scaffolding, compiling, deploying, and verifying smart contracts on Hedera testnet."
 url: "/evm/tools/contract-builder"
 ---
@@ -1,5 +1,6 @@
 ---
 title: "Add Hedera to MetaMask"
+description: "Add Hedera Mainnet or Testnet to MetaMask using ChainList or manual JSON-RPC settings so you can send HBAR and interact with Hedera smart contracts."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "ERC-1363 (Payable Tokens)"
+description: "Deploy ERC-1363 payable tokens on Hedera so smart contracts react instantly to transfers and approvals, useful for subscriptions and on-chain payments."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "ERC-20 (Fungible Tokens)"
+description: "Use the ERC-20 standard with Hedera Token Service tokens through IERC20 interfaces and system contract functions for fungible token management in Solidity."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "ERC-3643 (Real World Assets)"
+description: "Issue permissioned ERC-3643 real-world asset tokens on Hedera with ONCHAINID identity, KYC and AML compliance, and ERC-20 interoperability for regulated assets."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "ERC-721 (Non-Fungible Tokens)"
+description: "Manage non-fungible HTS tokens on Hedera through the ERC-721 interface using IERC721 functions and system contract calls from Solidity smart contracts."
 ---