# hiero-ledger/hiero-sdk-java — health index 95/100 (Exceptional)

> Inspection of the public repository hiero-ledger/hiero-sdk-java by inspect.software. It holds a health index of 95 out of 100, placing it in the Exceptional band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/hiero-ledger/hiero-sdk-java
- Report page: https://inspect.software/software/hiero-ledger/hiero-sdk-java
- Full JSON report: https://inspect.software/api/repositories/hiero-ledger/hiero-sdk-java/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/h/hiero-ledger/hiero-sdk-java.svg
- Inspected: 2026-09-21
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 94/100 | Exceptional |
| Community & Adoption | 17% | 79/100 | Good |
| Sustainability & Governance | 23% | 75/100 | Good |
| Engineering Quality | 19% | 80/100 | Excellent |
| Security | 16% | 85/100 | Excellent |
| AI Readiness | 4% | 72/100 | Good |

The weighted overall 82 is calibrated to 95 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | Java SDK for Hiero |
| Classification | mobile, library |
| Homepage | https://docs.hedera.com/guides/docs/sdks |
| Primary language | Java |
| License | Apache-2.0 |
| Stars | 264 |
| Forks | 193 |
| Created | 2018-10-10 |
| Last push | 2026-09-21 |
| Latest release | v2.78.0-beta.1 |
| Commits (last year) | 266 |
| Bus factor | 3 |
| Topics | hashgraph, distributed-ledger-technology, hedera, sdk, java, sdk-java, hacktoberfest |

## Vitality — 94/100 (Exceptional)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 0 days ago |
| Commit cadence | partial | 25.6 / 36 | 37/52 weeks with commits |
| Commit volume | met | 18 / 18 | 266 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | met | 36 / 36 | latest release 28 days ago |
| Release cadence | met | 27 / 27 | a release every ~16.2 days |
| OpenSSF Scorecard: Signed-Releases | excluded | 0 / 10 | no releases found |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 0 days ago |

## Community & Adoption — 79/100 (Good)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 67/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | partial | 39.3 / 60 | 264 stars |
| Forks | partial | 19 / 25 | 193 forks |
| Watchers | partial | 8.6 / 15 | 36 watchers |

### Community health — 92/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (Apache-2.0) |
| CONTRIBUTING guide | met | 18 / 18 | — |
| Code of conduct | met | 13.5 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | met | 6.3 / 6.3 | — |

## Sustainability & Governance — 75/100 (Good)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 75/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 36 / 54 | 3 contributor(s) cover half of all commits |
| Commit distribution | partial | 15.8 / 22.5 | top contributor authored 30% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 72 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 14 contributing companies or organizations |

### Issue & PR responsiveness — 87/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 40.2 / 42 | 96% of issues closed |
| PR acceptance | partial | 23 / 30 | 1545/2011 decided PRs merged |
| Newcomer PR acceptance | partial | 9 / 13 | 9/13 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | met | 15 / 15 | all changesets reviewed |

### Ownership & stewardship — 64/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 17.4 / 25 | 258 followers of hiero-ledger |
| Track record | partial | 16.1 / 25 | 42 public repos, account ~2 yr old |

## Engineering Quality — 80/100 (Excellent)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 74/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 9 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | not met | 0 / 16 | — |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | met | 6.4 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | met | 20 / 20 | 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |

### Documentation — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://docs.hedera.com/guides/docs/sdks |
| Repository description | met | 10 / 10 | — |
| Topics | met | 10 / 10 | 7 topics |
| Wiki | not met | 0 / 10 | — |

## Security — 85/100 (Excellent)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 85/100 (Excellent)

Excluded from scoring (no data or not applicable): Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 3 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | met | 2.5 / 2.5 | 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
| CII-Best-Practices | partial | 0.5 / 2.5 | badge detected: InProgress |
| Code-Review | met | 7.5 / 7.5 | all changesets reviewed |
| Contributors | met | 2.5 / 2.5 | project has 14 contributing companies or organizations |
| Dangerous-Workflow | met | 10 / 10 | no dangerous workflow patterns detected |
| Dependency-Update-Tool | met | 7.5 / 7.5 | update tool detected |
| Fuzzing | not met | 0 / 5 | project is not fuzzed |
| License | met | 2.5 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | met | 5 / 5 | packaging workflow detected |
| Pinned-Dependencies | partial | 4.5 / 5 | dependency not pinned by hash detected -- score normalized to 9 |
| SAST | partial | 2 / 5 | SAST tool is not run on all commits -- score normalized to 4 |
| Security-Policy | met | 5 / 5 | security policy file detected |
| Signed-Releases | excluded | 0 / 7.5 | no releases found |
| Token-Permissions | met | 7.5 / 7.5 | GitHub workflow tokens follow principle of least privilege |
| Vulnerabilities | met | 7.5 / 7.5 | 0 existing vulnerabilities detected |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 72/100 (Good)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 55/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | not met | 0 / 45 | no CLAUDE.md / AGENTS.md / editor rules |
| Machine-readable docs (llms.txt) | met | 15 / 15 | llms.txt served by the project website (https://docs.hedera.com/llms.txt) |
| Legible commit history | met | 40 / 40 | 48 of 48 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 65/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | partial | 12.6 / 18 | example-android/app/build.gradle.kts, example-android/build.gradle.kts, examples/build.gradle.kts (toolchain convention, no task runner) |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | not met | 0 / 11 | — |
| Static type checking | met | 11 / 11 | Java (statically typed) |
| Reproducible environment | not met | 0 / 10 | — |
| Demonstrated agent practice | partial | 2 / 10 | 1 of the last 100 commits agent-authored or agent-credited |
| Automated maintenance | met | 8 / 8 | 52 of the last 100 commits are automated dependency updates |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 9 / 10 | dependency not pinned by hash detected -- score normalized to 9 |

### Code legibility for models — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | Java (statically typed) |
| Manageable file sizes | partial | 54.5 / 55 | 7/777 source files over 60KB |

### Machine-readable interfaces — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): MCP server. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | met | 40 / 40 | sdk/src/main/proto/account.proto, sdk/src/main/proto/account_pending_airdrop.proto, sdk/src/main/proto/address_book_service.proto, sdk/src/main/proto/basic_types.proto, sdk/src/main/proto/block_info.proto, sdk/src/main/proto/block_stream_info.proto, sdk/src/main/proto/bytecode.proto, sdk/src/main/proto/common.proto, sdk/src/main/proto/congestion_level_starts.proto, sdk/src/main/proto/consensus_create_topic.proto, sdk/src/main/proto/consensus_delete_topic.proto, sdk/src/main/proto/consensus_get_topic_info.proto, sdk/src/main/proto/consensus_service.proto, sdk/src/main/proto/consensus_submit_message.proto, sdk/src/main/proto/consensus_topic_info.proto, sdk/src/main/proto/consensus_update_topic.proto, sdk/src/main/proto/contract_call.proto, sdk/src/main/proto/contract_call_local.proto, sdk/src/main/proto/contract_create.proto, sdk/src/main/proto/contract_delete.proto, sdk/src/main/proto/contract_get_bytecode.proto, sdk/src/main/proto/contract_get_info.proto, sdk/src/main/proto/contract_get_records.proto, sdk/src/main/proto/contract_types.proto, sdk/src/main/proto/contract_update.proto, sdk/src/main/proto/crs_publication.proto, sdk/src/main/proto/crypto_add_live_hash.proto, sdk/src/main/proto/crypto_approve_allowance.proto, sdk/src/main/proto/crypto_create.proto, sdk/src/main/proto/crypto_delete.proto, sdk/src/main/proto/crypto_delete_allowance.proto, sdk/src/main/proto/crypto_delete_live_hash.proto, sdk/src/main/proto/crypto_get_account_balance.proto, sdk/src/main/proto/crypto_get_account_records.proto, sdk/src/main/proto/crypto_get_info.proto, sdk/src/main/proto/crypto_get_live_hash.proto, sdk/src/main/proto/crypto_get_stakers.proto, sdk/src/main/proto/crypto_service.proto, sdk/src/main/proto/crypto_transfer.proto, sdk/src/main/proto/crypto_update.proto, sdk/src/main/proto/custom_fees.proto, sdk/src/main/proto/duration.proto, sdk/src/main/proto/entity_counts.proto, sdk/src/main/proto/ethereum_transaction.proto, sdk/src/main/proto/event_consensus_data.proto, sdk/src/main/proto/event_core.proto, sdk/src/main/proto/event_descriptor.proto, sdk/src/main/proto/event_transaction.proto, sdk/src/main/proto/evm_hook_state.proto, sdk/src/main/proto/exchange_rate.proto, sdk/src/main/proto/file.proto, sdk/src/main/proto/file_append.proto, sdk/src/main/proto/file_create.proto, sdk/src/main/proto/file_delete.proto, sdk/src/main/proto/file_get_contents.proto, sdk/src/main/proto/file_get_info.proto, sdk/src/main/proto/file_service.proto, sdk/src/main/proto/file_update.proto, sdk/src/main/proto/freeze.proto, sdk/src/main/proto/freeze_service.proto, sdk/src/main/proto/freeze_type.proto, sdk/src/main/proto/get_account_details.proto, sdk/src/main/proto/get_by_key.proto, sdk/src/main/proto/get_by_solidity_id.proto, sdk/src/main/proto/gossip_event.proto, sdk/src/main/proto/hints_key_publication.proto, sdk/src/main/proto/hints_partial_signature.proto, sdk/src/main/proto/hints_preprocessing_vote.proto, sdk/src/main/proto/hints_types.proto, sdk/src/main/proto/history_proof_key_publication.proto, sdk/src/main/proto/history_proof_signature.proto, sdk/src/main/proto/history_proof_vote.proto, sdk/src/main/proto/history_types.proto, sdk/src/main/proto/hook_dispatch.proto, sdk/src/main/proto/hook_store.proto, sdk/src/main/proto/hook_types.proto, sdk/src/main/proto/ledger_id.proto, sdk/src/main/proto/ledger_id_publication.proto, sdk/src/main/proto/migration_root_hash_vote.proto, sdk/src/main/proto/migration_wrapped_hashes.proto, sdk/src/main/proto/mirror/consensus_service.proto, sdk/src/main/proto/mirror/mirror_network_service.proto, sdk/src/main/proto/network_get_execution_time.proto, sdk/src/main/proto/network_get_version_info.proto, sdk/src/main/proto/network_service.proto, sdk/src/main/proto/network_staking_rewards.proto, sdk/src/main/proto/nft.proto, sdk/src/main/proto/node.proto, sdk/src/main/proto/node_create.proto, sdk/src/main/proto/node_delete.proto, sdk/src/main/proto/node_payments.proto, sdk/src/main/proto/node_rewards.proto, sdk/src/main/proto/node_stake_update.proto, sdk/src/main/proto/node_update.proto, sdk/src/main/proto/primitives.proto, sdk/src/main/proto/query.proto, sdk/src/main/proto/query_header.proto, sdk/src/main/proto/recordcache.proto, sdk/src/main/proto/registered_node.proto, sdk/src/main/proto/registered_node_create.proto, sdk/src/main/proto/registered_node_delete.proto, sdk/src/main/proto/registered_node_update.proto, sdk/src/main/proto/registered_service_endpoint.proto, sdk/src/main/proto/response.proto, sdk/src/main/proto/response_code.proto, sdk/src/main/proto/response_header.proto, sdk/src/main/proto/roster.proto, sdk/src/main/proto/roster_state.proto, sdk/src/main/proto/running_hashes.proto, sdk/src/main/proto/schedulable_transaction_body.proto, sdk/src/main/proto/schedule.proto, sdk/src/main/proto/schedule_create.proto, sdk/src/main/proto/schedule_delete.proto, sdk/src/main/proto/schedule_get_info.proto, sdk/src/main/proto/schedule_service.proto, sdk/src/main/proto/schedule_sign.proto, sdk/src/main/proto/smart_contract_service.proto, sdk/src/main/proto/staking_node_info.proto, sdk/src/main/proto/state_signature_transaction.proto, sdk/src/main/proto/storage_slot.proto, sdk/src/main/proto/system_delete.proto, sdk/src/main/proto/system_undelete.proto, sdk/src/main/proto/throttle_definitions.proto, sdk/src/main/proto/throttle_usage_snapshots.proto, sdk/src/main/proto/timestamp.proto, sdk/src/main/proto/token.proto, sdk/src/main/proto/token_airdrop.proto, sdk/src/main/proto/token_associate.proto, sdk/src/main/proto/token_burn.proto, sdk/src/main/proto/token_cancel_airdrop.proto, sdk/src/main/proto/token_claim_airdrop.proto, sdk/src/main/proto/token_create.proto, sdk/src/main/proto/token_delete.proto, sdk/src/main/proto/token_dissociate.proto, sdk/src/main/proto/token_fee_schedule_update.proto, sdk/src/main/proto/token_freeze_account.proto, sdk/src/main/proto/token_get_account_nft_infos.proto, sdk/src/main/proto/token_get_info.proto, sdk/src/main/proto/token_get_nft_info.proto, sdk/src/main/proto/token_get_nft_infos.proto, sdk/src/main/proto/token_grant_kyc.proto, sdk/src/main/proto/token_mint.proto, sdk/src/main/proto/token_pause.proto, sdk/src/main/proto/token_reject.proto, sdk/src/main/proto/token_relation.proto, sdk/src/main/proto/token_revoke_kyc.proto, sdk/src/main/proto/token_service.proto, sdk/src/main/proto/token_unfreeze_account.proto, sdk/src/main/proto/token_unpause.proto, sdk/src/main/proto/token_update.proto, sdk/src/main/proto/token_update_nfts.proto, sdk/src/main/proto/token_wipe_account.proto, sdk/src/main/proto/topic.proto, sdk/src/main/proto/transaction.proto, sdk/src/main/proto/transaction_contents.proto, sdk/src/main/proto/transaction_get_fast_record.proto, sdk/src/main/proto/transaction_get_receipt.proto, sdk/src/main/proto/transaction_get_record.proto, sdk/src/main/proto/transaction_list.proto, sdk/src/main/proto/transaction_receipt.proto, sdk/src/main/proto/transaction_record.proto, sdk/src/main/proto/transaction_response.proto, sdk/src/main/proto/tss_encryption_key.proto, sdk/src/main/proto/tss_encryption_keys.proto, sdk/src/main/proto/tss_message.proto, sdk/src/main/proto/tss_message_map_key.proto, sdk/src/main/proto/tss_vote.proto, sdk/src/main/proto/tss_vote_map_key.proto, sdk/src/main/proto/unchecked_submit.proto, sdk/src/main/proto/util_prng.proto, sdk/src/main/proto/util_service.proto |
| MCP server | excluded | 0 / 20 | not applicable to this kind of software |
| Runnable examples | met | 40 / 40 | examples |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- First-time contributor figures cover 12 of 19 authors (cap 12)

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt