Skip to content

docs: fix EVM account model content for hollow and long-zero accounts#657

Open
ayesigaisaac wants to merge 1 commit into
hashgraph:mainfrom
ayesigaisaac:docs/fix-evm-account-model
Open

docs: fix EVM account model content for hollow and long-zero accounts#657
ayesigaisaac wants to merge 1 commit into
hashgraph:mainfrom
ayesigaisaac:docs/fix-evm-account-model

Conversation

@ayesigaisaac

Copy link
Copy Markdown

PR title

docs: fix EVM account model content for hollow and long-zero accounts

Description

Summary

This PR updates EVM documentation to clarify Hedera account model behavior for hollow accounts and long-zero addresses.

What changed

  • Updated evm/differences/accounts-and-keys.mdx

    • Added an explicit explanation of hollow accounts
    • Described how hollow accounts are completed
    • Clarified fallback to EVM Address from Account ID / long-zero form
    • Explained why long-zero addresses are not compatible with ECRECOVER like alias-based EVM addresses
    • Added a link to the faucet flow example
  • Updated evm/quickstart/get-test-hbar.mdx

    • Expanded the faucet warning to mention hollow account limitations
    • Added completion guidance for hollow accounts
    • Clarified long-zero fallback behavior
    • Added a link to the EVM account model guide

Why

These docs were missing important account-model details that are critical for EVM developers:

  • Understanding the difference between alias-based EVM addresses and long-zero fallback addresses
  • Knowing how hollow accounts behave and how to complete them
  • Avoiding confusion when ECRECOVER fails due to a long-zero address fallback

Testing

@ayesigaisaac ayesigaisaac requested review from a team as code owners June 17, 2026 06:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant