Skip to content

docs: add EVM account model page (hollow and long-zero accounts)#678

Open
theekrystallee wants to merge 1 commit into
mainfrom
docs/evm-account-model
Open

docs: add EVM account model page (hollow and long-zero accounts)#678
theekrystallee wants to merge 1 commit into
mainfrom
docs/evm-account-model

Conversation

@theekrystallee

Copy link
Copy Markdown
Member

summary

  • creates evm/development/accounts.mdx, a dedicated page explaining the Hedera account model for EVM developers covering hollow accounts (auto-created with no signing key) and long-zero accounts (existing Hedera accounts without an ECDSA key, represented as zero-padded EVM addresses)
  • adds the page to the development group in docs.json navigation
  • updates evm/quickstart/get-test-hbar.mdx: tightens the hollow account warning with precise terminology, adds the portal account path as an alternative to the faucet, and cross-links to the new page
  • adds cross-links from evm/differences/accounts-and-keys.mdx and learn/core-concepts/accounts/auto-account-creation.mdx
  • adds a hollow account entry to support/glossary.mdx

what the new page covers

resolves #655

all content fact-checked against HIP-32, HIP-542, HIP-583, and HIP-904.

hollow accounts:

  • how auto account creation works and when it triggers (HBAR or tokens sent to a new EVM address)
  • what hollow accounts can do (full EVM/JSON-RPC compatibility - Hardhat, Foundry, contract calls, ERC-20/ERC-721) and cannot do (no native Hedera transactions until completed)
  • how completion works - automatically on first outbound EVM wallet transaction (EthereumTransaction), or explicitly via SDK
  • token association behavior: ERC-20/ERC-721 require no association; HTS tokens auto-associate (maxAutoAssociations = -1 set at creation per HIP-904)
  • how to look up an account ID from an EVM address (mirror node REST API + HashScan)

long-zero accounts:

  • what they are and how the EVM address from account ID is derived
  • why they cannot connect EVM wallets, sign EthereumTransactions, interact with smart contracts via EVM tooling, or pass ECRECOVER-based checks
  • common dApp failure modes and how to detect long-zero addresses programmatically

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
@theekrystallee theekrystallee requested a review from Reccetech June 29, 2026 23:24
@theekrystallee theekrystallee self-assigned this Jun 29, 2026
@theekrystallee theekrystallee requested review from a team as code owners June 29, 2026 23:24
@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
hedera-docs 🟢 Ready View Preview Jun 29, 2026, 11:27 PM

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.

[QA] EVM Developers: missing account model content (hollow accounts, long-zero accounts)

1 participant