> ## Documentation Index
> Fetch the complete documentation index at: https://hedera-0c6e0218-mintlify-bc559771.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EVM Tutorials

> Step-by-step EVM tutorials for Hedera covering Solidity, Hardhat, Foundry, ERC-20 and ERC-721 tokens, HTS system contracts, and upgradeable patterns.

Hands-on tutorials for every stage of EVM development on Hedera, from deploying your first token to building upgradeable contracts and Hedera-native integrations.

## Beginner

<CardGroup cols={2}>
  <Card title="Connect MetaMask to Hedera" href="/evm/tutorials/beginner/connect-metamask">
    Configure Hedera Mainnet and Testnet in MetaMask using network settings or one-click configuration.
  </Card>

  <Card title="Deploy Your First ERC-20 Token" href="/evm/tutorials/beginner/your-first-token">
    Deploy and mint an ERC-20 token on Hedera Testnet using Hardhat and OpenZeppelin's audited contracts. The workflow is identical to any other EVM chain.
  </Card>
</CardGroup>

## Intermediate

<CardGroup cols={2}>
  <Card title="Send and Receive HBAR Using Solidity" href="/evm/tutorials/intermediate/send-receive-hbar">
    Write Solidity contracts that hold and transfer HBAR — the foundation for DeFi, NFT marketplaces, and DAO contracts on Hedera.
  </Card>

  <Card title="Verify a Smart Contract on HashScan" href="/evm/tutorials/intermediate/verify-hashscan">
    Verify deployed bytecode against source files using Sourcify. Once verified, HashScan displays the full source code automatically.
  </Card>

  <Card title="JSON-RPC Connections" href="/evm/tutorials/intermediate/json-rpc-connections">
    Connect Hardhat, Foundry, or ethers.js to Hedera via HashIO or Validation Cloud JSON-RPC endpoints.
  </Card>
</CardGroup>

## Advanced: ERC-721 with Hardhat

Three-part series building a production-grade NFT contract from scratch to upgradeable.

<CardGroup cols={3}>
  <Card title="Part 1 — Mint and Burn" href="/evm/tutorials/advanced/erc721-hardhat/part1-mint-burn">
    Deploy an ERC-721 contract with OpenZeppelin, mint an NFT to your account, and burn it — the complete token lifecycle.
  </Card>

  <Card title="Part 2 — Access Control" href="/evm/tutorials/advanced/erc721-hardhat/part2-access-control">
    Add role-based access control, URI storage, and Pausable functionality to your ERC-721 contract.
  </Card>

  <Card title="Part 3 — Upgradeable Contracts" href="/evm/tutorials/advanced/erc721-hardhat/part3-upgradeable">
    Upgrade an ERC-721 contract in place using the OpenZeppelin UUPS upgradeable proxy pattern.
  </Card>
</CardGroup>

## Advanced: ERC-721 with Foundry

<CardGroup cols={2}>
  <Card title="Part 1 — Mint and Burn" href="/evm/tutorials/advanced/erc721-foundry/part1-mint-burn">
    Deploy, mint, and burn an ERC-721 token on Hedera Testnet using Foundry scripts and OpenZeppelin.
  </Card>

  <Card title="Part 2 — Writing Tests in Solidity" href="/evm/tutorials/advanced/erc721-foundry/part2-testing">
    Write and run Solidity unit tests for an ERC-721 mint-and-burn contract using Foundry's test framework.
  </Card>
</CardGroup>

## HTS + EVM

Three-part series using Hedera Token Service system contracts from Solidity — native token management without custom bytecode.

<CardGroup cols={3}>
  <Card title="Part 1 — Mint NFTs" href="/evm/tutorials/hedera/hts-evm/part1-mint-nfts">
    Mint, transfer, and burn NFTs using HTS system contracts from Solidity. No separate token contract required.
  </Card>

  <Card title="Part 2 — KYC and Update" href="/evm/tutorials/hedera/hts-evm/part2-kyc-update">
    Grant and revoke KYC, update token metadata, and manage compliance permissions on native HTS tokens via a smart contract.
  </Card>

  <Card title="Part 3 — Pause, Freeze, Wipe, Delete" href="/evm/tutorials/hedera/hts-evm/part3-pause-freeze-wipe">
    Pause transfers, freeze accounts, wipe balances, and delete HTS tokens from Solidity.
  </Card>
</CardGroup>

## HSS + EVM

<CardGroup cols={2}>
  <Card title="Part 1 — Schedule Smart Contract Calls" href="/evm/tutorials/hedera/hss-evm/part1-schedule-calls">
    Schedule future smart contract calls using Hedera's native Schedule Service — no off-chain bots or keeper networks required.
  </Card>

  <Card title="Part 2 — Dynamic Rebalancing" href="/evm/tutorials/hedera/hss-evm/part2-rebalancing">
    Build a capacity-aware DeFi rebalancer that adjusts its scheduling strategy dynamically based on network conditions.
  </Card>
</CardGroup>

## Hedera Native

<CardGroup cols={2}>
  <Card title="Create and Transfer an NFT Using Solidity" href="/evm/tutorials/hedera/nft-solidity">
    Create and transfer a Hedera-native NFT through a Solidity contract using the HTS system contract interface.
  </Card>

  <Card title="Hybrid HTS + EVM Tokenization" href="/evm/tutorials/hedera/hybrid-hts-evm">
    Combine HTS native tokenization with EVM smart contracts for compliance features and Solidity composability in the same token.
  </Card>
</CardGroup>