{"id":41725262,"url":"https://github.com/bsv-blockchain/go-chaintracks","last_synced_at":"2026-04-02T19:19:05.049Z","repository":{"id":327113535,"uuid":"1100895608","full_name":"bsv-blockchain/go-chaintracks","owner":"bsv-blockchain","description":"Real-time Bitcoin SV header orchestration in Go","archived":false,"fork":false,"pushed_at":"2026-03-23T14:22:05.000Z","size":63950,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-24T11:23:49.437Z","etag":null,"topics":["bitcoin","bitcoinsv","block-header","blockchain","bsv","go","headers"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bsv-blockchain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":".github/AGENTS.md","dco":null,"cla":null},"funding":{"github":"bsv-blockchain"}},"created_at":"2025-11-20T22:55:28.000Z","updated_at":"2026-03-23T14:21:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bsv-blockchain/go-chaintracks","commit_stats":null,"previous_names":["bsv-blockchain/go-chaintracks"],"tags_count":11,"template":false,"template_full_name":"bsv-blockchain/go-template","purl":"pkg:github/bsv-blockchain/go-chaintracks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsv-blockchain%2Fgo-chaintracks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsv-blockchain%2Fgo-chaintracks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsv-blockchain%2Fgo-chaintracks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsv-blockchain%2Fgo-chaintracks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bsv-blockchain","download_url":"https://codeload.github.com/bsv-blockchain/go-chaintracks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsv-blockchain%2Fgo-chaintracks/sbom","scorecard":{"id":1240289,"data":{"date":"2025-12-08T08:06:59Z","repo":{"name":"github.com/bsv-blockchain/go-chaintracks","commit":"2cf0e3b9f13ac9e28a2773b6ce868e2a40978f35"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":7.3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 1/19 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: .github/SECURITY.md:1","Info: Found linked content: .github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/SECURITY.md:1","Info: Found text in security policy: .github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:32","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:31","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/dependabot-auto-merge.yml:87","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress-coverage.yml:116","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:117","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-coverage.yml:112","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-coverage.yml:2344","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:2345","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-release.yml:59","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-fuzz.yml:61","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-matrix.yml:109","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-test-suite.yml:187","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-test-suite.yml:182","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress-test-suite.yml:186","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-validation.yml:49","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-test-validation.yml:50","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:81","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:148","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:173","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress.yml:251","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress.yml:252","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress.yml:247","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:290","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:318","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress.yml:436","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:116","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:135","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:200","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:225","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress.yml:450","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:449","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management-fork.yml:225","Warn: jobLevel 'actions' permission set to 'write': .github/workflows/pull-request-management-fork.yml:380","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management-fork.yml:381","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management-fork.yml:123","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management-fork.yml:181","Warn: jobLevel 'actions' permission set to 'write': .github/workflows/pull-request-management.yml:587","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:588","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/pull-request-management.yml:690","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:92","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:302","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:131","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:388","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:481","Info: jobLevel 'contents' permission set to 'read': .github/workflows/sync-labels.yml:111","Info: topLevel 'contents' permission set to 'read': .github/workflows/auto-merge-on-approval.yml:39","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/auto-merge-on-approval.yml:40","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:23","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependabot-auto-merge.yml:35","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-benchmarks.yml:92","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-code-quality.yml:58","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-finalize.yml:45","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-finalize.yml:46","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-report.yml:101","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-report.yml:102","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-statistics.yml:46","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-statistics.yml:47","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-tests.yml:43","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-tests.yml:44","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-coverage.yml:57","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:58","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-pre-commit.yml:46","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-release.yml:49","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-security-scans.yml:63","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-setup-config.yml:184","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-fuzz.yml:50","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-magex.yml:27","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-matrix.yml:99","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-suite.yml:117","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-test-suite.yml:118","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-validation.yml:38","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-test-validation.yml:39","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-warm-cache.yml:54","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:64","Info: topLevel 'contents' permission set to 'read': .github/workflows/pull-request-management-fork.yml:100","Info: topLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:43","Info: topLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:23","Info: topLevel 'contents' permission set to 'read': .github/workflows/stale-check.yml:32","Info: topLevel 'contents' permission set to 'read': .github/workflows/sync-labels.yml:44"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:118","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:182","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:190","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:276","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:173","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:183","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:251","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:401","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:444","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:474","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:618","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:683","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:750","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-warm-cache.yml:70","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-warm-cache.yml:82","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-warm-cache.yml:96","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-warm-cache.yml:133","Info:  75 out of  75 GitHub-owned GitHubAction dependencies pinned","Info:   5 out of   5 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2024-3218"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":10,"reason":"project is fuzzed","details":["Info: GoBuiltInFuzzer integration found: pkg/chaintracks/chainwork_fuzz_test.go:9","Info: GoBuiltInFuzzer integration found: pkg/chaintracks/chainwork_fuzz_test.go:51","Info: GoBuiltInFuzzer integration found: pkg/chaintracks/loader_fuzz_test.go:13"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: all commits (11) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Branch-Protection","score":4,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'master'","Info: 'force pushes' disabled on branch 'master'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'master'","Warn: 'stale review dismissal' is disabled on branch 'master'","Warn: required approving review count is 1 on branch 'master'","Warn: codeowners review is not required on branch 'master'","Warn: 'last push approval' is disabled on branch 'master'","Warn: 'up-to-date branches' is disabled on branch 'master'","Info: status check found to merge onto on branch 'master'","Info: PRs are required in order to make changes on branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Contributors","score":3,"reason":"project has 1 contributing companies or organizations -- score normalized to 3","details":["Info: found contributions from: skyetel @bsv-blockchain @buxorg @bitcoinschema @tonicpow @bitcoin-sv"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"11 out of 11 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2025-12-08T13:30:25.807Z","repository_id":327113535,"created_at":"2025-12-08T13:30:25.807Z","updated_at":"2025-12-08T13:30:25.807Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","bitcoinsv","block-header","blockchain","bsv","go","headers"],"created_at":"2026-01-24T23:02:39.955Z","updated_at":"2026-04-02T19:19:05.041Z","avatar_url":"https://github.com/bsv-blockchain.png","language":"Go","funding_links":["https://github.com/sponsors/bsv-blockchain"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ⛓️\u0026nbsp;\u0026nbsp;go-chaintracks\n\n**Real-time Bitcoin SV header orchestration in Go**\n\n\u003cbr/\u003e\n\n\u003ca href=\"https://github.com/bsv-blockchain/go-chaintracks/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release-pre/bsv-blockchain/go-chaintracks?include_prereleases\u0026style=flat-square\u0026logo=github\u0026color=black\" alt=\"Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://golang.org/\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/bsv-blockchain/go-chaintracks?style=flat-square\u0026logo=go\u0026color=00ADD8\" alt=\"Go Version\"\u003e\u003c/a\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-OpenBSV-blue?style=flat-square\u0026logo=springsecurity\u0026logoColor=white\" alt=\"License\"\u003e\u003c/a\u003e\n\n\u003cbr/\u003e\n\n\u003ctable align=\"center\" border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"right\"\u003e\n       \u003ccode\u003eCI / CD\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n    \u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\n       \u003ca href=\"https://github.com/bsv-blockchain/go-chaintracks/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/bsv-blockchain/go-chaintracks/fortress.yml?branch=master\u0026label=build\u0026logo=github\u0026style=flat-square\" alt=\"Build\"\u003e\u003c/a\u003e\n       \u003ca href=\"https://github.com/bsv-blockchain/go-chaintracks/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/bsv-blockchain/go-chaintracks?style=flat-square\u0026logo=git\u0026logoColor=white\u0026label=last%20update\" alt=\"Last Commit\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"right\"\u003e\n       \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; \u003ccode\u003eQuality\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n    \u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\n       \u003ca href=\"https://goreportcard.com/report/github.com/bsv-blockchain/go-chaintracks\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/bsv-blockchain/go-chaintracks?style=flat-square\" alt=\"Go Report\"\u003e\u003c/a\u003e\n       \u003ca href=\"https://codecov.io/gh/bsv-blockchain/go-chaintracks\"\u003e\u003cimg src=\"https://codecov.io/gh/bsv-blockchain/go-chaintracks/branch/master/graph/badge.svg?style=flat-square\" alt=\"Coverage\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd align=\"right\"\u003e\n       \u003ccode\u003eSecurity\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n    \u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\n       \u003ca href=\"https://scorecard.dev/viewer/?uri=github.com/bsv-blockchain/go-chaintracks\"\u003e\u003cimg src=\"https://api.scorecard.dev/projects/github.com/bsv-blockchain/go-chaintracks/badge?style=flat-square\" alt=\"Scorecard\"\u003e\u003c/a\u003e\n       \u003ca href=\".github/SECURITY.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/policy-active-success?style=flat-square\u0026logo=security\u0026logoColor=white\" alt=\"Security\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"right\"\u003e\n       \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; \u003ccode\u003eCommunity\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n    \u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\n       \u003ca href=\"https://github.com/bsv-blockchain/go-chaintracks/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/bsv-blockchain/go-chaintracks?style=flat-square\u0026color=orange\" alt=\"Contributors\"\u003e\u003c/a\u003e\n       \u003ca href=\"https://github.com/sponsors/bsv-blockchain\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-BSV-181717.svg?logo=github\u0026style=flat-square\" alt=\"Sponsor\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n### \u003ccode\u003eProject Navigation\u003c/code\u003e\n\n\u003c/div\u003e\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n       📦\u0026nbsp;\u003ca href=\"#-installation\"\u003e\u003ccode\u003eInstallation\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n       📚\u0026nbsp;\u003ca href=\"#-documentation\"\u003e\u003ccode\u003eDocumentation\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n       🧪\u0026nbsp;\u003ca href=\"#-examples--tests\"\u003e\u003ccode\u003eExamples\u0026nbsp;\u0026\u0026nbsp;Tests\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n       🤝\u0026nbsp;\u003ca href=\"#-contributing\"\u003e\u003ccode\u003eContributing\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      🛠️\u0026nbsp;\u003ca href=\"#-code-standards\"\u003e\u003ccode\u003eCode\u0026nbsp;Standards\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      ⚡\u0026nbsp;\u003ca href=\"#-benchmarks\"\u003e\u003ccode\u003eBenchmarks\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      🤖\u0026nbsp;\u003ca href=\"#-ai-usage--assistant-guidelines\"\u003e\u003ccode\u003eAI\u0026nbsp;Usage\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n       📝\u0026nbsp;\u003ca href=\"#-license\"\u003e\u003ccode\u003eLicense\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n       👥\u0026nbsp;\u003ca href=\"#-maintainers\"\u003e\u003ccode\u003eMaintainers\u003c/code\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\u003cbr/\u003e\n\n## 📦 Installation\n\n**go-chaintracks** requires a [supported release of Go](https://golang.org/doc/devel/release.html#policy).\n```shell script\ngo get -u github.com/bsv-blockchain/go-chaintracks\n```\n\n\u003cbr/\u003e\n\n## 📚 Documentation\n- **API Reference** – Dive into the godocs at [pkg.go.dev/github.com/bsv-blockchain/go-chaintracks](https://pkg.go.dev/github.com/bsv-blockchain/go-chaintracks)\n\n### Features\n\n- In-memory chain tracking with height and hash indexes\n- Chainwork calculation and comparison\n- Automatic orphan pruning (keeps last 100 blocks)\n- P2P live sync with automatic updates\n- Bootstrap sync from CDN or API sources\n- REST API with v2 endpoints\n- CDN server for hosting header files\n- File-based persistence with metadata\n- Docker support with docker-compose\n\n### Architecture\n- **ChainManager** - Main orchestrator for chain operations\n- **BlockHeader** - Extends SDK header with height and chainwork\n- **File I/O** - Local storage with seek-based updates\n- **P2P Sync** - Live header updates via message bus\n- **ChainTracker** - Implements go-sdk interface\n\n\u003cbr/\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eUsage as a Library\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n```go\nimport \"github.com/bsv-blockchain/go-chaintracks/chaintracks\"\n\n// Create chain manager with local storage\n// Network options: \"main\", \"test\", \"teratest\"\n// Optional bootstrap URL for initial sync\ncm, err := chaintracks.NewChainManager(\"main\", \"~/.chaintracks\", \"https://node.example.com\")\nif err != nil {\n    log.Fatal(err)\n}\n\n// Start P2P sync for automatic updates\nctx := context.Background()\ntipChanges, err := cm.Start(ctx)\nif err != nil {\n    log.Fatal(err)\n}\n\n// Listen for tip changes (optional)\ngo func() {\n    for tip := range tipChanges {\n        log.Printf(\"New tip: height=%d hash=%s\", tip.Height, tip.Hash())\n    }\n}()\n\n// Query methods\ntip := cm.GetTip()\nheight := cm.GetHeight()\nheader, err := cm.GetHeaderByHeight(123456)\nheader, err := cm.GetHeaderByHash(\u0026hash)\n\n// Cleanup\ndefer cm.Stop()\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eUsage as a Client\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n```go\nimport \"github.com/bsv-blockchain/go-chaintracks/pkg/chaintracks\"\n\n// Connect to remote chaintracks server\nclient := chaintracks.NewChainClient(\"http://localhost:3011\")\n\n// Start SSE connection for automatic updates\nctx := context.Background()\ntipChanges, err := client.Start(ctx)\nif err != nil {\n    log.Fatal(err)\n}\n\n// Listen for tip changes (optional)\ngo func() {\n    for tip := range tipChanges {\n        log.Printf(\"New tip: height=%d hash=%s\", tip.Height, tip.Hash)\n    }\n}()\n\n// Query methods (same interface as ChainManager)\ntip := client.GetTip()\nheight := client.GetHeight()\nheader, err := client.GetHeaderByHeight(123456)\nheader, err := client.GetHeaderByHash(\u0026hash)\n\n// Cleanup\ndefer client.Stop()\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eUsage as a Server\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Build and run\ngo build -o server ./cmd/server\n./server\n\n# Configure via .env file\ncp env.docker .env\n# Edit .env with your settings\n\n# Or configure via environment variables\nCHAINTRACKS_PORT=3011 CHAINTRACKS_CHAINTRACKS_P2P_NETWORK=main ./server\n```\n\nServer starts on port 3011 with Swagger UI at `/docs`.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eDocker Deployment\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\nThe easiest way to run go-chaintracks is with Docker:\n\n```bash\n# Quick start with default settings\ndocker compose up -d\n\n# View logs\ndocker compose logs -f\n```\n\nThis starts:\n- **API Server** on port 3011 - REST API for header queries\n- **CDN Server** on port 3012 - Static header files for bootstrap (optional)\n\nConfigure via environment variables in `.env`:\n\n```bash\n# Copy the example config\ncp env.docker .env\n\n# Key settings:\nCHAIN=main                                          # Network: main or test\nCHAINTRACKS_MODE=embedded                           # Mode: embedded or remote\nCDN_ENABLED=true                                    # Enable CDN server on port 3012\nBOOTSTRAP_URL=https://chaintracks-cdn-us-1.bsvb.tech  # Bootstrap source\nBOOTSTRAP_MODE=cdn                                  # Bootstrap mode: cdn or api\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eAPI Endpoints\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n**API Server (port 3011):**\n- `GET /v2/network` - Network name (main or test)\n- `GET /v2/tip` - Chain tip header (JSON)\n- `GET /v2/tip.bin` - Chain tip header (binary)\n- `GET /v2/tip/stream` - SSE stream for real-time tip updates\n- `GET /v2/header/height/:height` - Header by height (JSON)\n- `GET /v2/header/height/:height.bin` - Header by height (binary)\n- `GET /v2/header/hash/:hash` - Header by hash (JSON)\n- `GET /v2/header/hash/:hash.bin` - Header by hash (binary)\n- `GET /v2/headers?height=N\u0026count=C` - Multiple headers (binary)\n\n**CDN Server (port 3012, when enabled):**\n- `GET /{network}NetBlockHeaders.json` - Metadata with file list\n- `GET /{network}Net_{index}.headers` - Binary header files (100k headers each)\n- `GET /health` - CDN health check\n\nFull API documentation available at `/docs` when running.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eData Storage\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\nHeaders are stored in 100k-block files:\n```text\n~/.chaintracks/\n├── mainNetBlockHeaders.json    # Metadata\n├── mainNet_0.headers           # Blocks 0-99999\n├── mainNet_1.headers           # Blocks 100000-199999\n└── ...\n```\n\nEach header is 80 bytes. Files use seek-based updates for efficient writes.\n\nThis format is compatible with the TypeScript chaintracks-server CDN format, allowing:\n- Bootstrap from any CDN hosting these files\n- Self-hosting your own CDN for other nodes to bootstrap from\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eBootstrap Options\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\nTwo bootstrap modes are supported:\n\n**CDN Mode (recommended):**\n```bash\nBOOTSTRAP_URL=https://chaintracks-cdn-us-1.bsvb.tech\nBOOTSTRAP_MODE=cdn\n```\nDownloads headers from TypeScript CDN format files. Fast and efficient for initial sync.\n\n**API Mode:**\n```bash\nBOOTSTRAP_URL=https://mainnet.gorillanode.io/api/v1\nBOOTSTRAP_MODE=api\n```\nFetches headers via REST API calls. Compatible with gorillanode-style endpoints.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eDevelopment Build Commands\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nGet the [MAGE-X](https://github.com/mrz1836/mage-x) build tool for development:\n```shell script\ngo install github.com/mrz1836/mage-x/cmd/magex@latest\n```\n\nView all build commands\n\n```bash script\nmagex help\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eRepository Features\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nThis repository includes 25+ built-in features covering CI/CD, security, code quality, developer experience, and community tooling.\n\n**[View the full Repository Features list →](.github/docs/repository-features.md)**\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eLibrary Deployment\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nThis project uses [goreleaser](https://github.com/goreleaser/goreleaser) for streamlined binary and library deployment to GitHub. To get started, install it via:\n\n```bash\nbrew install goreleaser\n```\n\nThe release process is defined in the [.goreleaser.yml](.goreleaser.yml) configuration file.\n\n\nThen create and push a new Git tag using:\n\n```bash\nmagex version:bump push=true bump=patch branch=master\n```\n\nThis process ensures consistent, repeatable releases with properly versioned artifacts and citation metadata.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003ePre-commit Hooks\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nSet up the Go-Pre-commit System to run the same formatting, linting, and tests defined in [AGENTS.md](.github/AGENTS.md) before every commit:\n\n```bash\ngo install github.com/mrz1836/go-pre-commit/cmd/go-pre-commit@latest\ngo-pre-commit install\n```\n\nThe system is configured via modular env files in [`.github/env/`](.github/env/README.md) and provides 17x faster execution than traditional Python-based pre-commit hooks. See the [complete documentation](http://github.com/mrz1836/go-pre-commit) for details.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eGitHub Workflows\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nAll workflows are driven by modular configuration in [`.github/env/`](.github/env/README.md) — no YAML editing required.\n\n**[View all workflows and the control center →](.github/docs/workflows.md)**\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eUpdating Dependencies\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nTo update all dependencies (Go modules, linters, and related tools), run:\n\n```bash\nmagex deps:update\n```\n\nThis command ensures all dependencies are brought up to date in a single step, including Go modules and any tools managed by [MAGE-X](https://github.com/mrz1836/mage-x). It is the recommended way to keep your development environment and CI in sync with the latest versions.\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## 🧪 Examples \u0026 Tests\n\nAll unit tests run via [GitHub Actions](https://github.com/bsv-blockchain/go-chaintracks/actions) and use [Go version 1.26.x](https://go.dev/doc/go1.26). View the [configuration file](.github/workflows/fortress.yml).\n\nRun all tests (fast):\n\n```bash script\nmagex test\n```\n\nRun all tests with race detector (slower):\n```bash script\nmagex test:race\n```\n\n\u003cbr/\u003e\n\n## ⚡ Benchmarks\n\nRun the Go benchmarks:\n\n```bash script\nmagex bench\n```\n\n\u003cbr/\u003e\n\n## 🛠️ Code Standards\nRead more about this Go project's [code standards](.github/CODE_STANDARDS.md).\n\n\u003cbr/\u003e\n\n## 🤖 AI Usage \u0026 Assistant Guidelines\nRead the [AI Usage \u0026 Assistant Guidelines](.github/tech-conventions/ai-compliance.md) for details on how AI is used in this project and how to interact with AI assistants.\n\n\u003cbr/\u003e\n\n## 👥 Maintainers\n| [\u003cimg src=\"https://github.com/icellan.png\" height=\"50\" alt=\"Siggi\" /\u003e](https://github.com/icellan) | [\u003cimg src=\"https://github.com/galt-tr.png\" height=\"50\" alt=\"Galt\" /\u003e](https://github.com/galt-tr) | [\u003cimg src=\"https://github.com/mrz1836.png\" height=\"50\" alt=\"MrZ\" /\u003e](https://github.com/mrz1836) |\n|:--------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------:|\n|                                [Siggi](https://github.com/icellan)                                 |                                [Dylan](https://github.com/galt-tr)                                 |                                [MrZ](https://github.com/mrz1836)                                 |\n\n\u003cbr/\u003e\n\n## 🤝 Contributing\nView the [contributing guidelines](.github/CONTRIBUTING.md) and please follow the [code of conduct](.github/CODE_OF_CONDUCT.md).\n\n### How can I help?\nAll kinds of contributions are welcome :raised_hands:!\nThe most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:.\n\n[![Stars](https://img.shields.io/github/stars/bsv-blockchain/go-chaintracks?label=Please%20like%20us\u0026style=social\u0026v=1)](https://github.com/bsv-blockchain/go-chaintracks/stargazers)\n\n\u003cbr/\u003e\n\n## 📝 License\n\n[![License](https://img.shields.io/badge/license-OpenBSV-blue?style=flat\u0026logo=springsecurity\u0026logoColor=white)](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsv-blockchain%2Fgo-chaintracks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsv-blockchain%2Fgo-chaintracks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsv-blockchain%2Fgo-chaintracks/lists"}