Skip to content

Comments

docs(hedera-stats): Add documentation for NFT ranking and ERC-1155 adoption metrics#124

Open
omar-hgraph wants to merge 3 commits intomainfrom
eng-435/update-stats-functionality
Open

docs(hedera-stats): Add documentation for NFT ranking and ERC-1155 adoption metrics#124
omar-hgraph wants to merge 3 commits intomainfrom
eng-435/update-stats-functionality

Conversation

@omar-hgraph
Copy link

Overview

This PR adds comprehensive documentation for three new Hedera Stats metrics from merged PRs #69, #70, and #71. These metrics provide enhanced visibility into NFT ecosystem activity and smart contract adoption on Hedera.

Changes

1. NFT Collection Ranking Metrics (PRs #69 & #70)

  • ERC-721 Smart Contract Rankings (top_non_fungible_tokens_erc)

    • Ranks ERC-721 NFT collections using composite scoring (60% volume + 40% transactions)
    • Min-max normalization for fair cross-collection comparison
    • Optional concentration filter to identify organic vs whale-dominated communities
    • Configurable time windows (24h, 72h, 168h, 720h)
  • HTS Native NFT Rankings (top_non_fungible_tokens_hts)

    • Ranks native Hedera Token Service (NON_FUNGIBLE_UNIQUE) NFT collections
    • Same scoring methodology as ERC-721 with HTS-specific data handling
    • Multi-NFT transaction HBAR amount splitting
    • Treasury account exclusion for accurate volume tracking

2. ERC-1155 Multi-Token Adoption (PR #71)

  • Total ERC-1155 Accounts (total_erc1155_accounts)
    • Tracks cumulative unique accounts holding ERC-1155 tokens
    • Monitors TransferSingle and TransferBatch contract events
    • Provides rolling totals across multiple granularities (hour, day, week, month, quarter, year)
    • Demonstrates adoption of the multi-token standard

3. Navigation & Discoverability

  • Updated Hedera Stats introduction page with new metric links
  • Organized metrics by category (Network Performance, EVM, NFTs)

Files Added

  • docs/hedera-stats/non-fungible-tokens/top-erc-nfts.md
  • docs/hedera-stats/non-fungible-tokens/top-hts-nfts.md
  • docs/hedera-stats/evm/total-erc1155-accounts.md

Files Modified

  • docs/hedera-stats/introduction.md

Verification

  • All documentation builds without errors (npm run build)
  • No broken internal links
  • Content verified against actual SQL implementations in hedera-stats repository

Related Issues & PRs

Testing Instructions

  1. Pull the branch: git checkout eng-435/update-stats-functionality
  2. Install dependencies: npm install
  3. Build documentation: npm run build
  4. Serve locally: npm run serve
  5. Verify all new pages render correctly under /hedera-stats/non-fungible-tokens/ and /hedera-stats/evm/

- Add ERC-721 smart contract NFT ranking documentation (PR #69)
- Add HTS native NFT collection ranking documentation (PR #70)
- Add Total ERC-1155 Accounts metric documentation (PR #71)
Add links to newly documented Hedera Stats metrics in introduction.md:
EVM:
- Total ERC-1155 Accounts (multi-token standard adoption)

NFTs:
- Top ERC-721 Smart Contract Collections (PR #69)
- Top HTS Native NFT Collections (PR #70)
@linear
Copy link

linear bot commented Feb 21, 2026

ENG-435

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