hashgraph · mintlify · Jun 11, 2026
@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Addresses"
+description: "Learn the two address formats for Hedera smart contracts: the EVM hex address and the native Hedera contract ID, and when to use each in your tools."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "EVM Archive Node Queries"
+description: "Run gas-free smart contract calls, estimate gas, and simulate EVM transactions against Hedera mirror nodes using HIP-584 archive queries."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Compiling Smart Contracts"
+description: "Compile Solidity or Vyper source into EVM bytecode and an ABI for Hedera smart contracts using solc, Remix IDE, Hardhat, or Foundry tooling."
 ---
 
 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 Hedera in Solidity or Vyper that compile to EVM bytecode and run on the Hedera Smart Contract Service via the Besu EVM."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Deploying Smart Contracts"
+description: "Deploy smart contract bytecode to Hedera via ContractCreate, EthereumTransaction, or eth_sendRawTransaction on the Hyperledger Besu EVM."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Forking Hedera Network for Local Testing"
+description: "Use the hedera-forking library with Foundry or Hardhat to fork Hedera mainnet or testnet locally and test against HTS system contracts."
 ---
 
 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 EVM gas costs, weibar units, operational throttling, and fee calculation for smart contract transactions on Hedera under HIP-1249."
 mode: "wide"
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: "JSON-RPC Relay"
+description: "Connect EVM tools like MetaMask, Hardhat, and ethers.js to Hedera through the Hiero JSON-RPC Relay using Hashio, self-hosted, or third-party endpoints."
 ---
 
 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"
+title: "Smart Contract Rent"
+description: "How Hedera's planned smart contract rent system works, including auto-renewal periods and storage payments to keep contracts active on the network."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Security"
+description: "Hedera's smart contract security model: EVM equivalence on Besu, deterministic finality, and protections against reentrancy and replay attacks."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Smart Contract Traceability"
+description: "Debug and audit smart contract calls on Hedera using call traces and state traces to capture inputs, outputs, gas usage, and EVM state changes."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: "Troubleshooting"
-description: "Diagnose and fix common issues when developing EVM smart contracts on Hedera."
+description: "Diagnose common Hedera EVM issues, from gas reverts and decimal mismatches to HBAR transfer quirks and JSON-RPC errors that mimic contract bugs."
 ---
 
 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 deployed Hedera smart contracts with Sourcify so HashScan and mirror node explorers display matched source code and metadata."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Accounts, Signature Verification & Keys (ECDSA vs. ED25519)"
+title: "Accounts, Signature Verification & Keys (ECDSA vs. ED25519)"
+description: "How Hedera handles ECDSA and ED25519 keys, account aliases, and signature verification with isAuthorized compared to Ethereum's ECRECOVER model."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: "Migration Checklist"
-description: "A step-by-step checklist for migrating your dApp from Ethereum to Hedera."
+description: "A step-by-step migration checklist for moving Ethereum dApps to Hedera, covering accounts, keys, JSON-RPC differences, token handling, and tooling."
 hidden: true
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: "Decimal Handling (8 vs. 18 Decimals)"
+description: "Understand how HBAR, HTS, and ERC tokens use 8 or 18 decimals across HAPI, the JSON-RPC relay, and smart contracts to avoid precision bugs."
 ---
 
 

@@ -1,6 +1,7 @@
 ---
 title: Understanding Hedera's EVM Differences and Compatibility
 sidebarTitle: Hedera vs. Ethereum
+description: "Compare Hedera and Ethereum across consensus, fees, accounts, keys, JSON-RPC, and tokens to plan a smooth EVM migration to Hedera."
 ---
 
 Hedera's EVM-compatible environment lets you deploy Solidity smart contracts using Hardhat, Foundry, or Remix and connect with standard Ethereum tooling. Hedera's architecture introduces differences in account models, key management, token handling, and JSON-RPC behavior that affect how you build and migrate from 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: "How Hedera's JSON-RPC relay differs from Ethereum for historical state, event filters, and tooling like Hardhat, Foundry, MetaMask, and ethers.js."
 mode: "wide"
 ---
 

@@ -1,6 +1,6 @@
 ---
-title: "Integrating
-      ED25519 Accounts and Advanced Features Into Smart Contracts"
+title: "Integrate ED25519 Accounts in Smart Contracts"
+description: "Bridge ED25519 and ECDSA accounts in Solidity using HIP-632's isAuthorized and isAuthorizedRaw functions for on-chain signature verification."
 ---
 ## Overview
 

@@ -1,5 +1,6 @@
 ---
-title: "Extending Token Management with Smart Contracts"
+title: "Extending Token Management with Smart Contracts"
+description: "Combine Hedera Token Service with Solidity for conditional minting, burning, and transfers, plus secure supply key handling and access control patterns."
 ---
 
 

@@ -1,6 +1,7 @@
 ---
-title: For Hedera-Native Developers Adding Smart Contract Functionality
+title: Adding EVM Smart Contracts to Hedera-Native Apps
 sidebarTitle: For Native Devs
+description: "How Hedera-native developers can extend SDK-based apps with EVM smart contracts while keeping HTS, HCS, and ED25519 workflows intact."
 ---
 ## **Introduction**
 

@@ -1,5 +1,6 @@
 ---
 title: "JSON-RPC Relay and State Queries"
+description: "How Hedera's JSON-RPC relay handles state queries differently from Ethereum and how to use mirror nodes for historical data and event logs."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Handling HBAR Transfers in Contracts"
+title: "Handling HBAR Transfers in Contracts"
+description: "Use Solidity transfer, send, and call patterns to move HBAR to and from Hedera smart contracts, and trigger receive and fallback functions correctly."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Token Management with Hedera Token Service"
+title: "Token Management with Hedera Token Service"
+description: "Why HBAR cannot be burned and how to use the HTS system contract at 0x167 with supply keys and access control to mint and burn custom tokens."
 ---
 
 

@@ -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 directly from Solidity using the 0x167 system contract, including custom fees and royalty schedules."
 ---
 
 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, ERC-721, and other EVM token contracts on Hedera using familiar tools like Hardhat, Foundry, ethers.js, web3.js, and Remix IDE."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Hybrid (HTS + EVM ) Tokenization"
+title: "Hybrid (HTS + EVM) Tokenization"
+description: "Combine native HTS tokens with EVM smart contracts on Hedera to manage HBAR allowances, ERC interfaces, and programmable token logic in one stack."
 ---
 
 

@@ -1,6 +1,7 @@
 ---
 title: "Hedera Account Service"
 sidebarTitle: "Account Service"
+description: "Use the Hedera Account Service system contract from HIP-632 to verify ECDSA and ED25519 signatures and authorize accounts inside Solidity contracts."
 ---
 
 

@@ -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 Hedera's active HBAR/USD exchange rate from Solidity using the 0x168 system contract to convert tinybars to tinycents for USD-priced fees."
 ---
 
 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,6 +1,7 @@
 ---
 title: "Hedera Token Service System Contract"
 sidebarTitle: "Token Service"
+description: "Reference for HTS system contract functions like createFungibleToken, mintToken, associate, and transferToken callable from Solidity smart contracts."
 ---
 
 

@@ -1,6 +1,7 @@
 ---
 title: System Smart Contracts
 sidebarTitle: System Contracts
+description: "Overview of Hedera system smart contracts at reserved EVM addresses that expose HTS, account, schedule, and exchange rate functions to Solidity."
 ---
 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.
 

@@ -2,6 +2,7 @@
 title: "Hedera Schedule Service"
 sidebarTitle: "Schedule Service"
 mode: "wide"
+description: "Use the HSS system contract from HIP-755 and HIP-1215 to schedule future contract calls, automate multi-sig flows, and build on-chain cron jobs."
 ---
 
 

@@ -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: "Deploy Solidity smart contracts on Hedera using MetaMask, Hardhat, Foundry, Remix, and the JSON-RPC relay with your existing EVM developer workflow."
 mode: wide
 ---
 

@@ -1,5 +1,6 @@
 ---
 title: Interoperability and Bridging
+description: "Bridge assets and messages between Hedera and other chains using LayerZero, Chainlink CCIP, Hashport, and other cross-chain interoperability providers."
 ---
 
 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"
+title: "LayerZero"
+description: "Bridge HTS and ERC-20 or ERC-721 tokens across chains using LayerZero's omnichain messaging protocol to deploy OApps on Hedera and EVM networks."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Chainlink Oracles"
+title: "Chainlink Oracles"
+description: "Use Chainlink price feeds and decentralized oracles on Hedera to bring real-world data into your Solidity smart contracts and dApps."
 ---
 
 

@@ -1,6 +1,6 @@
 ---
 title: Oracle Networks
-description: Oracle networks integrated with the Hedera network.
+description: "Compare oracle networks integrated with Hedera, including Pyth, Supra, and Chainlink, for price feeds and real-world data inside 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"
+title: "Pyth Oracles"
+description: "Integrate Pyth Network price feeds on Hedera using the pull oracle model to access low-latency crypto, equity, FX, and commodity market data."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "Supra Oracles"
+title: "Supra Oracles"
+description: "Use Supra's decentralized oracle price feeds on Hedera for real-time crypto and asset data in smart contracts via the mirror node API."
 ---
 
 

@@ -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 in a dApp, pair with MetaMask, fetch the EVM address, and send HBAR from the snap account."
 ---
 
 ## Introduction

@@ -1,6 +1,7 @@
 ---
 title: Hedera Wallet Snap By MetaMask
-sidebarTitle: MetaMask Snap
+sidebarTitle: MetaMask Snap
+description: "Extend MetaMask with the Hedera Wallet Snap to interact with native Hedera accounts, send HBAR, and query balances without the JSON-RPC relay."
 ---
 ## Overview
 

@@ -1,4 +1,5 @@
 ---
 title: "Hedera WalletConnect"
+description: "Connect dApps to Hedera-compatible wallets using the Hedera WalletConnect library, the standard WalletConnect protocol adapter for Hedera networks."
 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"
+title: "Deploy your First Contract with Hedera Contract Builder"
+description: "Compile and deploy an ERC-20 smart contract to Hedera testnet from your browser using the Hedera Contract Builder, no CLI or local setup required."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
 title: "Deploy and Verify a Smart Contract with Foundry"
+description: "Compile, deploy, interact with, and verify an ERC-20 smart contract on Hedera testnet using Foundry's forge and cast via the 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 smart contract on Hedera testnet using Hardhat scripts, Ethers.js, and the 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 tutorial to write, compile, and deploy a Solidity smart contract to Hedera testnet from the browser using Remix IDE and MetaMask."
 ---
 
 ## Introduction to Remix IDE

@@ -1,5 +1,6 @@
 ---
-title: "Hedera Testnet Faucet"
+title: "Hedera Testnet Faucet"
+description: "Use the Hedera testnet faucet to auto-create a funded developer account from your EVM wallet address and receive free testnet HBAR for testing."
 ---
 
 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: "Quickstart link to the Hedera Contract Builder, a browser-based playground to scaffold, compile, deploy, and verify Solidity contracts on Hedera testnet."
 url: "/evm/tools/contract-builder"
 ---
@@ -1,5 +1,6 @@
 ---
 title: "Add Hedera to MetaMask"
+description: "Configure MetaMask to connect to Hedera mainnet and testnet with chain IDs 295 and 296 using the Hashio JSON-RPC endpoints or Chainlist one-click setup."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "ERC-1363 (Payable Tokens)"
+title: "ERC-1363 (Payable Tokens)"
+description: "Use the ERC-1363 payable token standard on Hedera to trigger smart contract logic from a single token transfer or approval call for payments and subs."
 ---
 
 

@@ -1,5 +1,6 @@
 ---
-title: "ERC-20 (Fungible Tokens)"
+title: "ERC-20 (Fungible Tokens)"
+description: "Deploy ERC-20 fungible tokens on Hedera and interact with HTS fungible tokens through the IERC20 interface and supported smart contract functions."
 ---