{"id":34606066,"url":"https://github.com/vandung-dev/hierachain","last_synced_at":"2026-04-04T09:02:04.765Z","repository":{"id":324127386,"uuid":"1031980472","full_name":"VanDung-dev/HieraChain","owner":"VanDung-dev","description":"HieraChain - The Hierarchical Blockchain Enterprise Ledger","archived":false,"fork":false,"pushed_at":"2026-03-28T08:38:45.000Z","size":4449,"stargazers_count":26,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T13:10:59.419Z","etag":null,"topics":["blockchain","enterprise","hierarchical","ledger","python"],"latest_commit_sha":null,"homepage":"http://docs.hierachain.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VanDung-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-04T16:09:12.000Z","updated_at":"2026-03-28T08:38:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/VanDung-dev/HieraChain","commit_stats":null,"previous_names":["vandung-dev/hierarchical-blockchain","vandung-dev/hierachain"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/VanDung-dev/HieraChain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VanDung-dev%2FHieraChain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VanDung-dev%2FHieraChain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VanDung-dev%2FHieraChain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VanDung-dev%2FHieraChain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VanDung-dev","download_url":"https://codeload.github.com/VanDung-dev/HieraChain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VanDung-dev%2FHieraChain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31393782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: 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":["blockchain","enterprise","hierarchical","ledger","python"],"created_at":"2025-12-24T13:47:13.513Z","updated_at":"2026-04-04T09:02:04.758Z","avatar_url":"https://github.com/VanDung-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HieraChain - The Hierarchical Blockchain Enterprise Ledger\n\n![Python Versions](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13-blue)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE-APACHE)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE-MIT)\n[![PyPI version](https://img.shields.io/pypi/v/HieraChain.svg)](https://pypi.org/project/HieraChain/)\n\n**English** | [Tiếng Việt](README_vi.md)\n\n## Overview\n\nHieraChain is an enterprise ledger built on hierarchical blockchain technology, designed specifically for business applications without any cryptocurrency concepts. Rather than being a general-purpose blockchain platform focused on digital currencies, HieraChain provides a secure, hierarchical ledger structure for managing business operations and processes.\n\nThis ledger implements a multi-layer hierarchical architecture where Main Chains supervise Sub-Chains, enabling scalable and secure business process management. All operations within the system are referred to as \"events\" rather than \"transactions,\" emphasizing its focus on business applications.\n\n## Key Features\n\n* **Hierarchical Structure**: Multi-layer architecture with Main Chains (supervisors) and Sub-Chains (domain experts).\n* **Consensus Mechanisms**: Supports Proof of Authority (PoA), Proof of Federation (PoF), and Byzantine Fault Tolerant (BFT) consensus.\n* **High Performance**: Columnar storage with Apache Arrow, hybrid caching, and parallel event processing.\n* **Reliability \u0026 Recovery**: Durable transaction journaling, automated failure recovery, and state rollback capabilities.\n* **Comprehensive Security Architecture**: An omnipresent, enterprise-grade security philosophy extending across the entire system lifecycle (not just a single module), built on 6 core pillars:\n\n    * **Authorization** (ABAC Policy Engine \u0026 MSP)\n    * **Lockdown \u0026 Logging** (Quorum-based Voting \u0026 Tamper-evident Logs)\n    * **Fault-tolerance** (BFT \u0026 Federation)\n    * **Risk Analyzer** (Real-time Z-score activity monitoring)\n    * **Encryption** (AES-256-GCM for storage, Ed25519 for signatures)\n    * **Decentralized Zero-Knowledge Proofs** (ZK Verifier for trustless chain anchoring)\n\n## Documentation\n\nComprehensive documentation is available at our official website **[docs.hierachain.org](https://docs.hierachain.org/)**:\n\n* [Getting Started](https://docs.hierachain.org/getting-started/install/) - Installation and basic setup\n* [Architecture](https://docs.hierachain.org/architecture/overview/) - System design and hierarchical model\n* [Core Modules](https://docs.hierachain.org/modules/core/) - Detailed breakdown of system components\n* [Guides \u0026 How-To](https://docs.hierachain.org/how-to/integrate-web2/) - Step-by-step implementation guides\n* [API Reference](https://docs.hierachain.org/reference/code-map/) - REST API and configuration details\n\n## Quick Start\n\n### Installation\n\n**Via PIP (recommended)**\n\n```bash\npip install HieraChain\n```\n\n**From source (for development)**\n\n```bash\ngit clone https://github.com/VanDung-dev/HieraChain.git\ncd HieraChain\npython -m venv venv\nsource venv/bin/activate  # Linux/macOS (or venv\\Scripts\\activate on Windows)\n\n# Install dependencies and project in dev mode\npip install -r requirements.txt\npip install -e .\n```\n\n### Basic Usage\n\n```python\nfrom hierachain.hierarchical import HierarchyManager\n\nmanager = HierarchyManager()\nmanager.create_sub_chain(\"supply_chain\")\n\n# Add an event\nmanager.add_event(\"supply_chain\", {\n    \"entity_id\": \"PROD-001\",\n    \"event\": \"production_complete\",\n    \"timestamp\": 1703088000.0,\n    \"details\": {\"quantity\": 100}\n})\n\n# Submit proof to main chain\nmanager.submit_proof(\"supply_chain\")\n```\n\nAPI Server:\n\n```bash\npython -m hierachain\n```\n\nAPI available at `http://localhost:2661/docs`\n\n## Technical Specifications\n\n| Metric | Value                  |\n|--------|------------------------|\n| Test Cases | \u003e700                   |\n| Python Support | 3.10, 3.11, 3.12, 3.13 |\n| Consensus Types | PoA, PoF, BFT          |\n| Signature Algorithm | Ed25519                |\n| Encryption | AES-256-GCM            |\n\n## License\n\nThis project is dual licensed under either the [Apache-2.0 License](LICENSE-APACHE) or the [MIT License](LICENSE-MIT). You may choose either license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvandung-dev%2Fhierachain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvandung-dev%2Fhierachain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvandung-dev%2Fhierachain/lists"}