Domains Module (hierachain/domains/*)

Overview

The Domains module is a critical intermediary layer connecting the core Blockchain infrastructure with real-world enterprise business processes. It provides standardized templates for building business chains (Sub-Chains), managing entity lifecycles, and ensuring data consistency across the entire HieraChain system.

Core Components

Domain Management

Entity Lifecycle

Every DomainChain supports automatic entity state management through default Event Handlers:

1. Registration: Register a new entity in the business chain.
2. Status Tracking: Track current status (e.g., In Production, Quality Passed, Shipped).
3. Resource Allocation: Attach resources (personnel, machinery, materials) to an entity.
4. Compliance Monitoring: Record regulatory compliance check results.

Operation Metrics

The system automatically tracks key KPIs through OperationMetricsTracker: * Success Rate: Rate of successful task completion. * Quality Pass Rate: Rate of passing quality inspections. * Approval Rate: Rate of management approvals. * Compliance Violations: Number of detected process violations.

Two-Phase Commit (2PC) Mechanism

To ensure consistency when performing operations affecting multiple chains, DomainChain integrates the 2PC protocol:

sequenceDiagram
    participant Source as Source Chain
    participant Target as Target Chain

    Note over Source, Target: Phase 1: Prepare
    Source->>Target: Prepare Transaction (ID, Payload)
    Target-->>Source: Prepared OK / Reject

    Note over Source, Target: Phase 2: Commit/Rollback
    alt All chains prepared
        Source->>Target: Commit Transaction
        Target->>Target: Execute & Finalize Block
    else Failure detected
        Source->>Target: Rollback Transaction
        Target->>Target: Discard Pending Data
    end

Compliance and Security Control

Cryptocurrency Terminology Prevention

According to HieraChain's philosophy, CrossChainValidator performs strict scanning and flags violations if cryptocurrency-related terms are detected in event data: * Banned list: transaction, mining, coin, token, wallet, address, amount, fee, etc. * Action: Records violations in the system compliance report (Ledger_compliance).

Cross-Chain Tracing

EntityTracer allows administrators to reconstruct the complete "journey" of an entity across multiple departments or chains:

from hierachain.domains.generic.utils.entity_tracer import EntityTracer

tracer = EntityTracer(hierarchy_manager)
# Get the history of entity "ORDER-789" across the entire system
trace_results = tracer.trace_entity_across_chains("ORDER-789")

for chain_name, events in trace_results.items():
    print(f"Activity at {chain_name}: {len(events)} events.")

Standardized Event Types

Related

• Hierarchical System
• Core Blockchain Structure
• ERP Integration Guide