Changelog

2026-10-18

• API (Phản hồi Secure Event Ở trạng thái Queued): add_secure_event (hierachain/api/admin/endpoints.py) đóng dấu event/timestamp, giữ nguyên nội dung đã ký trong event_data["signature_content"] trước khi ghi journal, trả SecureEventResponse(status="queued") với ID event từ ordering trong event_hash và thời gian phản hồi trong timestamp, đồng thời chuyển OrderingBackpressureError thành HTTP 503 ({message, event_id, journaled}) và ValueError thành 422; SecureEventResponse (hierachain/api/admin/schemas.py) nay mô tả status là queued với cam kết block bất đồng bộ — response không còn báo "committed", nên client đang chờ trạng thái committed phải coi phản hồi là queued và chờ block commit.

2026-10-15

• Packaging (Ngừng Hỗ Trợ Python 3.10): requires-python trong pyproject.toml tăng từ >=3.10 lên >=3.11 và bỏ classifier 3.10; Ruff target-version chuyển sang py311, Black bỏ py310, Mypy python_version chuyển sang 3.11, ma trận tương thích CI trong .github/workflows/test.yml chỉ còn 3.11–3.14, và uv.lock được tạo lại — môi trường còn ở Python 3.10 phải nâng cấp lên 3.11+ trước khi cài checkout này.

2026-10-06

• Config & Core (Bỏ Metadata Cache Không dùng): Bỏ Settings.ADVANCED_CACHING_ENABLED, BLOCK_CACHE_SIZE, EVENT_CACHE_SIZE, ENTITY_CACHE_SIZE, BLOCK_CACHE_POLICY, EVENT_CACHE_POLICY, ENTITY_CACHE_POLICY, ENTITY_TTL và hierachain.core.cache.DEFAULT_CACHE_CONFIG. Import/truy cập trực tiếp cần chuyển sang cấu hình instance cache hoặc service thực tế; các tên này không có nơi đọc trong runtime. AdvancedCache, cache của KeyManager và block_cache_size của Ordering giữ nguyên hành vi. Kiểm tra số node BFT nay nhận trực tiếp ID node, không tạo lớp bọc; kiểm tra quorum không đổi.
• Giảm thiểu Lỗi (Log Khuyến nghị): Sự kiện log tài nguyên đổi thành consensus_capacity_recommendation (cả payload và wrapper) và resource_capacity_recommendation; cần cập nhật bộ lọc cho auto_scaling_triggered, consensus_scaling và resource_scaling_triggered. Bỏ sự kiện giả key_rotation_scheduled và deadline next_rotation. Phương thức public, cấu hình legacy, đường dẫn Parquet, kiểm tra quorum BFT và hành vi AES-256-GCM dùng khóa lưu giữ giữ nguyên; cấp phát và xoay khóa thuộc ứng dụng host.
• Đồng thuận (Hợp nhất Ordering Processor): Bỏ OrderingExecutor (hierachain/consensus/ordering/processor.py) và gộp process_batch()/process_single_event() vào OrderingProcessor; __init__ nhận OrderingService có kiểu và đọc event_pool/pending_events/metrics/certifier/block_builder/storage_handler/should_stop/config trực tiếp từ service thay vì cache bản sao thuộc tính, kèm annotation -> None cho các phương thức vòng đời. Import trực tiếp OrderingExecutor và truy cập processor.event_pool/processor.should_stop/processor.executor (cùng các thuộc tính cache tương tự) cần chuyển sang processor.service.* hoặc process_batch/process_single_event trên processor; luồng certification/batch/replay (process_replayed_event() với allow_stale_timestamp) giữ nguyên.

2026-10-05

• Đồng thuận & Config (PoA Interval Opt-in, Bỏ Delay Ngầm): ProofOfAuthority.__init__ (hierachain/consensus/proof_of_authority.py) đổi mặc định block_interval từ 10.0 sang 0.0 (None = 0.0), từ chối giá trị không hữu hạn/âm bằng ValueError, và _check_block_timing() chỉ ép spacing đã cấu hình tường minh nhưng vẫn chặn timestamp giảm dần; Settings.BLOCK_INTERVAL (hierachain/config/settings.py) đổi mặc định HRC_BLOCK_INTERVAL từ "10.0" sang "0.0" — trước đây ép delay spacing 10s nếu không override.
• Channel (Ledger Stream Append-only Bền): ChannelLedger (hierachain/hierarchical/channel/ledger.py) thay callback _persist bằng bind_storage() bắt buộc append_channel_record/load_channel_records, append bản ghi event/block có kiểu kèm chặn expected_sequence và revision registry, thêm refresh()/_replay_record() với validate block theo trusted-key chỉ rollback các bản ghi mới áp dụng, và dùng chung _validate_block()/_validate_pending_event() giữa restore() và replay; Channel (hierachain/hierarchical/channel/channel.py) refresh ledger trong _registry_operation, ghi stat qua _record_event_statistics() bỏ qua event thiếu submitter_org, và bỏ rollback thủ công trong add_event()/finalize_block() — trước đây persist qua callback mờ với rollback toàn trạng thái.
• Hierarchy (Tách Recovery/Registry & Seed Ledger Có Version): HierarchyManager (hierachain/hierarchical/hierarchy_manager/base.py) ủy quyền replay main-chain/khôi phục sub-chain cho hierarchy_manager/recovery.py mới và persist/restore/apply snapshot cho hierarchy_manager/registry.py mới, ngừng nhúng snapshot channel-ledger trong state registry, persist ledger channel nguyên tử cùng revision registry qua seed _channel_ledger_version ghi bằng append_channel_record/load_channel_records (ledger đã bind khởi động lại từ sequence 1), validate toàn bộ snapshot trước khi mutate object coordinator, và migrate snapshot legacy tại chỗ với retry 3 lần — trước đây lưu snapshot nguyên khối kèm dữ liệu ledger nhúng.
• Database (Bảng Ledger Channel & Ghi Registry+Ledger Nguyên tử): thêm mixin ChannelLedgerSQLStorage cùng create_channel_ledger_tables() (hierachain/adapters/database/channel_ledger_sql.py) giúp SQLBase (SQLite/PostgreSQL) có append_channel_record/load_channel_records với chặn revision registry và sequence ledger (bảng channel_ledger_heads/channel_ledger_records tạo trong postgres_schema.py/sqlite_schema.py); save_hierarchy_registry() nhận thêm channel_ledgers và commit registry kèm seed ledger trong một transaction (chuyển commit ra khỏi _execute_save_hierarchy_registry, override placeholder/lock/BEGIN IMMEDIATE cho Postgres); RedisStorageAdapter (hierachain/adapters/database/redis_adapter.py) thêm seed/append có điều kiện/đọc suffix ledger qua WATCH/MULTI và sửa xử lý key trong load_hierarchy_registry — trước đây chưa có lưu trữ ledger channel và commit registry đơn lẻ.

2026-10-04

• Serialization (JSON Chuẩn stdlib, Bỏ orjson): thêm hierachain/serialization.py (dumps_json/loads_json/dumps_canonical_json) thay orjson trên ~40 module (hierachain/adapters/database/base/sql_adapter.py, hierachain/adapters/database/postgres_adapter.py, hierachain/adapters/database/redis_adapter.py, hierachain/core/block.py, hierachain/core/blockchain.py, hierachain/core/merkle_tree.py, hierachain/network/zmq_transport.py, hierachain/network/message_cryptographic.py, hierachain/security/*, hierachain/api/**/*, hierachain/sdk/client.py, hierachain/sdk/async_client.py, hierachain/consensus/ordering/utils.py, hierachain/error_mitigation/*, hierachain/monitoring/*, hierachain/risk_management/types.py, hierachain/config/*, hierachain/cli/key.py) với encoding compact (",", ":"), allow_nan=False, giữ nguyên integer và từ chối NaN/Infinity; RedisEventManager nay raise RedisStorageError khi bản ghi event sai/thiếu thay vì trả [], và _execute_delete_chain của SQLite nay xóa cả dòng proofs kèm events/blocks/chains — trước đây serialize qua orjson, cho qua float không hữu hạn, bỏ qua lặng lẽ bản ghi Redis hỏng và để sót proofs.
• Core (Cache MutableMapping & Ép Kiểu Key): AdvancedCache (hierachain/core/cache.py) nay implement collections.abc.MutableMapping[str, Any] thay vì kế thừa dict, bỏ keys() -> list[str] để dùng __iter__, ép mọi key qua str(key) trong get/set/delete/contains/__getitem__, phân biệt giá trị None đã lưu với miss bằng sentinel trong __getitem__, và chỉ loại bỏ khi evict_key is not None — trước đây hành xử như dict không ép key, nhầm lẫn giá trị None với miss và bỏ qua key loại bỏ falsy.
• Hierarchy (Ledger Channel Bền & Rebuild Registration Có Ký): Channel.__init__ (hierachain/hierarchical/channel/channel.py) nhận thêm node_identity/trusted_public_keys và dựng ChannelLedger(node_identity, trusted_public_keys, channel_id) có ký; ChannelLedger (hierachain/hierarchical/channel/ledger.py) thêm snapshot()/restore() kèm validate đầy đủ chữ ký/thứ tự/channel_id, threading.RLock, persist fail-closed _save() với rollback khi add_event/finalize_block, cô lập deepcopy kèm đóng dấu channel_id/timestamp, cùng Channel.restore_statistics(); HierarchyManager (hierachain/hierarchical/hierarchy_manager/base.py) lấy transaction_manager lười (raise RuntimeError khi đã đóng), thêm close(), và rebuild registered_sub_chains/sub_chain_metadata/authorities từ event sub_chain_registration MainChain đã ký với kiểm tra timestamp hữu hạn, shape metadata và xung đột domain — trước đây chấp nhận ledger không ký/không kiểm tra và append trùng registration mỗi lần restart.
• Đồng thuận (Digest Chuẩn & Pipeline Quorum Chặt): hash_request (hierachain/consensus/bft/types.py, hierachain/consensus/bft/helpers.py) dùng dumps_canonical_json với _request_digest_is_valid() mới; BFTConsensus/BFTConsensusEngine (hierachain/consensus/bft/consensus.py, hierachain/consensus/bft/engine.py) deepcopy operation/message, chặn đề xuất mới khi pending_apply_events còn tồn đọng, từ chối trùng sequence PRE_PREPARE, ghi vote PREPARE cục bộ trước khi broadcast qua record_local_prepare_vote(), ép commit đúng thứ tự (seq == committed_sequence + 1, đệm future, drain sau phục hồi), và persist/apply qua _build_consensus_event kèm retry; OrderingService (hierachain/consensus/ordering/service.py) thêm sinh ID ổn định cho kiểm tra cross-tier — trước đây băm str(operation), cho phép đề xuất chồng lấn/commit lệch thứ tự và mutate message dùng chung.
• Domain & Sync (Projection Giao dịch & Chữ ký Lockdown Chuẩn): BaseChain (hierachain/domains/chains/base_chain.py) tuần tự hóa register_entity/handler operation dưới lock, chặn khi _domain_projection_healthy sai, persist initial_data_json (bytes chuẩn) cho rebuild_domain_state() khi restart với dedup theo event_id rồi nội dung và domain_projection_errors, phân biệt handler mặc định vs custom, cô lập payload qua deepcopy/snapshot cloning trong CrossChainValidator (hierachain/domains/utils/cross_chain_validator.py); DomainChain/TxManager (hierachain/domains/chains/domain_chain.py, hierachain/domains/chains/tx_manager.py) replay projection từ log đã chấp nhận; CrossLevelSyncManager (hierachain/cluster/cross_level_sync.py) thêm RLock kèm context batch _operation với theo dõi operation đang chạy, còn LockdownMessageGuard/lockdown_types.py giới hạn admission với replay tracking khi chữ ký chuyển sang helper JSON chặt — trước đây mutate state dùng chung không lock, mất dữ liệu khởi tạo khi rebuild và ký qua orjson nên chữ ký cũ không còn hợp lệ.
• API (Siết Auth, Phân quyền & Stub 501): helper JSON chặt thay orjson trong hierachain/api/* (hierachain/api/ledger/blocks.py, hierachain/api/ledger/chains.py, hierachain/api/ledger/events.py, hierachain/api/ledger/schemas.py, hierachain/api/graphql/resolvers.py, hierachain/api/graphql/types.py, hierachain/api/storage/*, hierachain/api/websocket/*); graphql_handler.py thêm thực thi async kèm kiểm tra quyền và auth theo context, websocket/endpoints.py ép auth subscription, business/contracts.py/business/private_data.py trả HTTP 501 cho contract/private-data chưa triển khai, endpoint ledger validate tham số query chặt hơn, và depds.py/server.py thêm helper đóng/vòng đời hierarchy-manager — trước đây cho phép GraphQL/WS không auth, stub lặng lẽ endpoint chưa xong và chấp nhận query param lỏng lẻo.
• CLI & Config (Config Node Thống nhất & Bỏ Master-Key): load_chains_from_file được thay bằng load_node_config(ctx, config) (hierachain/cli/store.py, hierachain/cli/__init__.py) hỗ trợ YAML/JSON, mặc định settings.CLI_CONFIG_FILE đổi từ chains.json sang data/config.yaml, và create/list_chains/add_event/show_events/init_node (hierachain/cli/chain.py, hierachain/cli/event.py, hierachain/cli/node.py) validate chặt hơn kèm get_hierarchy_manager() bền; Settings (hierachain/config/settings.py) xóa MASTER_KEY_SOURCE/MASTER_KEY_FILE (HRC_MASTER_KEY_SOURCE/HRC_MASTER_KEY_FILE nay raise ValueError), nạp dotenv qua HRC_ENV_FILE ngay khi import, tập trung parse trong _first_nonblank_environment_value()/_environment_csv() (HRC_NODE_ID/NODE_ID, HRC_P2P_PORT/NODE_PORT, HRC_PEERS/PEERS, HRC_REDIS_HOST/REDIS_HOST, HRC_REDIS_PORT/REDIS_PORT), và bỏ master_key khỏi diagnostics — trước đây nhận file chain legacy, mặc định chains.json và lặng lẽ bỏ qua nguồn key không hỗ trợ.
• Journal, Network, Audit & ERP (Fail-closed Chặt): TransactionJournal (hierachain/error_mitigation/journal.py) duyệt thư mục qua descriptor ghim từ chối symlink (O_NOFOLLOW, 0600/0700), giữ độc quyền ghi bằng lock fcntl POSIX, serialize qua helper chặt, mở rộng envelope journal với fields/details và rollback khi ghi lỗi; DataValidator (hierachain/error_mitigation/data_validator.py) siết tương thích schema; SecureConnectionManager (hierachain/network/secure_connection.py) thêm chống replay timestamp/nonce với kiểm tra certificate/org/signing-key chặt và từ chối handshake ack cũ/không mời; ArrowAuditStorage (hierachain/risk_management/audit_logger.py, hierachain/risk_management/__init__.py) thêm AuditReadResult/AuditIntegrityStatus, chuẩn hóa event lưu trữ và raise thay vì fail lặng với hỗ trợ legacy tốt hơn; ERP (hierachain/integration/enterprise.py, hierachain/integration/erp/base.py, hierachain/integration/erp/change_detector.py, hierachain/integration/erp/mapping.py) cô lập profile/metadata bằng deepcopy, validate config/key_fields/detect_changes và ép simulation mode cho fixture tổng hợp — trước đây cho phép path symlink, writer đồng thời, handshake cũ, drop audit lặng lẽ và mutate profile ERP dùng chung.

2026-10-03

• Database (Chặn Ghi Registry Theo Revision): SQLBase.save_hierarchy_registry() / RedisStorageAdapter.save_hierarchy_registry() (hierachain/adapters/database/base/sql_adapter.py, hierachain/adapters/database/postgres_adapter.py, hierachain/adapters/database/redis_adapter.py) nay bắt buộc state["_revision"] là str mới khác expected_revision (SQL INSERT/UPDATE có điều kiện theo _revision đã lưu, Redis so sánh qua WATCH/MULTI, Postgres dùng placeholder %s) và từ chối revision thiếu/không đổi — trước đây chấp nhận mọi snapshot và ghi đè vô điều kiện.
• Hierarchy (Đồng thời Lạc quan & Siết Quyền Admin): _persist_hierarchy_registry() (hierachain/hierarchical/hierarchy_manager/base.py) đóng dấu uuid4 _revision và từ chối bản ghi cũ qua expected_revision, get_organization()/get_channel()/_restore_hierarchy_registry() refresh từ state đã persist (raise khi snapshot thiếu/không hợp lệ), cùng _apply_hierarchy_registry()/_mutate_registry() retry kèm rollback; _build_channel_orgs() (hierachain/hierarchical/hierarchy_manager/organization.py) nay nhận registered dict thay vì manager, và register_organization_member(..., actor_user_id) raise PermissionError qua _is_organization_admin() dùng chung khi không phải admin — trước đây ghi đè state mới hơn và cho phép mọi caller.
• Channel (Refresh Trực tiếp & Cổng ACTIVE): Channel (hierachain/hierarchical/channel/channel.py) tuần tự hóa thao tác registry qua RLock _registry_operation kèm _refresh_registry() trực tiếp trước mỗi lệnh gọi (thêm/xóa org, tạo private-collection, truy vấn/thông tin event, cập nhật policy, suspend/resume), và submit_event() trả False khi status != ACTIVE trước khi phân giải vai trò — trước đây phục vụ membership cũ và nhận event trên channel không active.
• Ordering (Backpressure, Validate Timeout & Phát hiện Gap): OrderingService (hierachain/consensus/ordering/service.py) validate enqueue_timeout (0 < timeout <= 60, mặc định 1.0) và raise ValueError nếu ngoài biên, giữ chỗ hàng đợi trước khi ghi journal qua _enqueue_event() với OrderingBackpressureError(event_id, journaled) (hierachain/consensus/ordering/types.py) khi đầy/không active, còn OrderingStorageHandler._load_from_db() (hierachain/consensus/ordering/storage.py) tải qua get_blocks_from_index() và raise ValueError khi gap index — trước đây queue vô điều kiện và dừng lặng lẽ ở block thiếu đầu tiên.
• API (Backpressure 503 & Admin 403): add_event (hierachain/api/ledger/events.py) chuyển OrderingBackpressureError thành HTTP 503 kèm {message, event_id, journaled} để client retry; register_organization_member (hierachain/api/business/organizations.py) dùng chung _is_organization_admin() và chuyển PermissionError của manager thành 403 đồng thời chuyển tiếp actor_user_id — trước đây event nghẽn hiện lỗi chung và kiểm tra admin viết inline trùng lặp.
• Core (Snapshot Event Block Độc lập): Block.to_event_list() (hierachain/core/block.py) chuyển đổi bảng Arrow đã verify ở mỗi lần gọi để trả snapshot độc lập, loại bỏ memoization _cached_events và entry __slots__ (kèm dọn _block_from_dict trong hierachain/consensus/ordering/storage.py) — trước đây trả về list cache dùng chung có thể lệch với events gốc.

2026-10-01

• Giảm thiểu Lỗi (Khóa Lưu giữ & Validator Chặt): EncryptionValidator (hierachain/error_mitigation/encryption_validator.py) nay resolve khóa 32-byte do caller quản lý theo key_id qua key_resolver (không còn fallback os.urandom tạm thời) với AES-256-GCM gắn AAD (algorithm/key_id/timestamp), bổ sung decrypt_data() kèm kiểm tra bytes/độ dài tag-IV/thuật toán/timestamp hữu hạn, và che lỗi nội bộ sau SecurityError chung; _run_single_custom_validator (hierachain/error_mitigation/data_validator.py) ép kiểu trả về (bool, str) và chuyển lỗi/ngoại lệ của validator từ warning sang add_error kèm tên field — các validation trước đây cho qua nay sẽ fail.
• ERP (Transformer Fail-closed): EventTranslator (hierachain/integration/erp/mapping.py) dùng chung MappingEngine của caller (hierachain/integration/erp/base.py) để áp transformer đã đăng ký nhất quán, và tên transformer không tồn tại nay raise MappingError thay vì lặng lẽ trả về giá trị gốc.
• Cluster (Payload Chữ ký Quarantine): QuarantineReport.compute_signature (hierachain/cluster/lockdown_types.py) ký toàn bộ payload orjson sort-key thay vì node_id:timestamp:last_block_index, from_dict() kiểm tra msg_type/lockdown_type và từ chối timestamp không hữu hạn trước khi ký, còn verify_signature() trả False khi thiếu/chữ ký sai thay vì raise — các chữ ký đã phát hành trước đây không còn verify được.
• Config (Field Secret JSON AWS): _get_from_aws/SecretManager._get_aws (hierachain/config/secret_manager.py) parse SecretString thành object JSON qua orjson và trả về field chuỗi tên theo key, bắt buộc HRC_AWS_SECRET_NAME làm SecretId thay vì fallback sang key — secret không phải JSON, field không phải chuỗi và thiếu tên secret nay đều trả None.

2026-09-30

• Domain (Validate Phân bổ Tài nguyên Chặt): BaseChain.add_domain_event (hierachain/domains/chains/base_chain.py) nay từ chối event của entity chưa đăng ký và chuyển đổi tài nguyên không hợp lệ qua _can_apply_resource_allocation() (kiểu event phải bằng resource_{allocation_type}, kiểm tra thành viên cho assigned/reserved/released/transferred kèm kiểm tra tồn tại target_entity_id); ResourceAllocationEvent.is_valid (hierachain/domains/events/custom_events.py) bắt buộc target_entity_id khác rỗng và khác entity_id với kiểu transferred — các event trước đây được chấp nhận nay trả False.
• Validator (Validate Field Proof Chặt): ProofValidator._validate_single_proof (hierachain/domains/utils/cross_chain_validator.py) bắt buộc sub_chain_name/proof_hash là str khác rỗng và timestamp là int/float dương (không phải bool), ghi nhận missing_proof_fields kèm tăng inconsistent_proofs thay vì lặng lẽ bỏ qua proof thiếu field.

2026-09-29

• Core & Hierarchical (Validate Event Nghiêm ngặt): Blockchain.add_event (hierachain/core/blockchain.py) và SubChain.add_event (hierachain/hierarchical/sub_chain/base.py) nay ép validate_event_structure() (kèm kiểm tra kiểu dict trong SubChain) và raise ValueError khi cấu trúc không hợp lệ; add_event của ledger (hierachain/api/ledger/events.py) chuyển thành HTTP 422 thay vì chấp nhận event sai định dạng.
• API (Rate Limiting Redis Fail-closed): RedisRateLimiter chuyển sang (hierachain/adapters/database/redis_rate_limiter.py) với check()/RateLimiterBackendError; add_rate_limit (hierachain/api/middleware.py) chạy kiểm tra Redis qua asyncio.to_thread và trả 503 khi backend không khả dụng thay vì fail-open cho qua như trước, đồng thời tái dùng quota remaining đã kiểm tra cho header.
• API (GraphQL Giới hạn Kết quả): resolver (hierachain/api/graphql/resolvers.py) chặn kết quả qua _bounded_limit()/MAX_QUERY_RESULTS=100 với limit=None nghĩa là 100, cắt lát from_index/to_index/start+limit có kẹp biên, và thoát sớm khi limit=0 — limit yêu cầu lớn hơn nay chỉ trả tối đa 100 bản ghi.
• Network (Kiểm tra Replay & Nonce Chặt): _is_valid_replay (hierachain/network/zmq_transport.py) bắt buộc nonce là str dài 1..128 ký tự, timestamp số hữu hạn trong replay_tolerance, và từ chối khi replay buffer 1000 entry vẫn đầy sau khi tỉa hết hạn thay vì âm thầm loại bỏ.

2026-09-28

• Core & Bảo mật (Chữ ký Block Tin cậy Bắt buộc): Blockchain.__init__/add_block/is_valid_new_block/is_chain_valid (hierachain/core/blockchain.py) nay resolve signer qua require_block_identity() và xác minh theo trusted_public_keys với _sign_block()/sign_block(); BlockVerifier (hierachain/security/verify/block_verifier.py) bắt buộc strict_mode=True, từ chối tuyệt đối block thiếu/chữ ký sai định dạng và chỉ xác minh với trusted key do caller cung cấp; load_trusted_block_keys()/require_block_identity() (hierachain/security/identity_loader.py) bắt buộc HRC_BLOCK_TRUSTED_KEYS_FILE (mới Settings.BLOCK_TRUSTED_KEYS_FILE) dạng map Ed25519 hex kèm kiểm tra khớp key của node; initialize_default_keys() (hierachain/security/key_manager.py) chặn tạo key mặc định khi Settings().env == "production".
• Đồng thuận & Ordering (Block Ký, Quorum & ZK): bổ sung creator_id khi dựng block với kiểm tra vị trí finalization trong verify_quorum_signatures (hierachain/consensus/base_consensus.py, hierachain/consensus/proof_of_federation.py); xác minh ZK proof trong quá trình verify, từ chối proof thiếu/không hợp lệ khi bắt buộc và kiểm tra cấu trúc/thứ tự/hash consensus_finalization; BlockManager ký khi tạo block, storage từ chối block thiếu/thiếu tin cậy với reconcile_journal_event() chống trùng khi replay (hierachain/consensus/ordering/block_manager.py, hierachain/consensus/ordering/service.py, hierachain/consensus/ordering/storage.py).
• Hierarchical Main/Sub-Chain (Proof Bền & Ký Tin cậy): thay đếm proof in-memory bằng lưu trữ bền với _refresh_durable_proofs()/proof_sequence/_durable_block_events (hierachain/hierarchical/main_chain/base.py, hierachain/hierarchical/main_chain/proofs.py, hierachain/hierarchical/main_chain/registry.py); SubChain bắt buộc persist proof bền, chặn nộp trùng, validate metadata ZK-proof chặt hơn và ký finalization bằng trusted key theo consensus type (hierachain/hierarchical/sub_chain/base.py, hierachain/hierarchical/sub_chain/block.py, hierachain/hierarchical/sub_chain/proof.py).
• Hierarchical Registry (Hierarchy Bền & Validate Chặt): _persist_hierarchy_registry()/_restore_hierarchy_registry() kèm locking (hierachain/hierarchical/hierarchy_manager/base.py); khôi phục hỗ trợ sub-chain placeholder với thay thế động; registry organization/channel siết kiểm tra member (hierachain/hierarchical/hierarchy_manager/organization.py, hierachain/hierarchical/hierarchy_manager/validation.py).
• Channel (Chữ ký, Endorsement & Vai trò): finalization block xác minh chữ ký theo trusted key, đánh giá endorsement hỗ trợ tập org đủ điều kiện cấu hình được, cập nhật policy/org/status có rollback, và submit_event/persist registry bắt buộc validate vai trò member (hierachain/hierarchical/channel/channel.py, hierachain/hierarchical/channel/ledger.py, hierachain/hierarchical/channel/policy.py, hierachain/hierarchical/channel/types.py).
• Cluster (Đồng bộ Cross-level Không Copy): nộp proof không còn merge history hay copy block cross-chain (hierachain/cluster/cross_level_sync.py); anchor persist qua _persist_proof_anchor() với xác minh bền dưới storage lock.
• Audit (Schema & Đổi Hash): AuditEvent thêm affected_entities kèm migration SQLite, xử lý JSON cho field tùy chọn, và calculate_hash() trên toàn bộ dict sort-key (hierachain/risk_management/types.py, hierachain/risk_management/audit_logger.py) — digest đã lưu thay đổi; thêm PostgresAuditManifest (hierachain/adapters/database/audit_manifest.py) với verify_integrity() và validate persist chặt hơn.
• Config (Env & Backend Nghiêm): Settings.env (hierachain/config/settings.py) raise ValueError với HRC_ENV/ENV không hỗ trợ (chỉ alias production/prod/product, dev, test), STORAGE_BACKEND allowlist memory/redis/sqlite/postgres/postgresql qua _configured_database_url() (DATABASE_URL/HRC_DATABASE_URL), thêm BLOCK_TRUSTED_KEYS_FILE, và ProductionSettings.AUTH_ENABLED luôn True kèm bắt buộc HRC_AUTH_ENABLED=true; get_settings() chỉ route theo production/test đã chuẩn hóa.
• API/CLI/Business (Auth Prod & HierarchyManager): lifespan server bắt buộc require_block_identity() kèm DATABASE_URL/HRC_DATABASE_URL tường minh cho Postgres production, bắt buộc HRC_API_KEYS_FILE qua _load_production_key_manager() (key ≥32 ký tự, có permissions, còn hiệu lực), thay ENV bằng env, siết CORS/logging theo production (hierachain/api/server.py, hierachain/api/graphql_handler.py); business channels/organizations chuyển khỏi _channels/_organizations in-memory sang HierarchyManager với validate chặt và schema vai trò member (hierachain/api/business/channels.py, hierachain/api/business/organizations.py, hierachain/api/business/schemas.py, hierachain/api/business/state.py); nộp proof ledger ủy quyền cho HierarchyManager (hierachain/api/ledger/proofs.py); CLI submit_proof từ chối nộp qua registry (bắt buộc API xác thực bền) và verify ép validate chain theo trusted key (hierachain/cli/chain.py, hierachain/cli/verify.py).

2026-09-27

• Lưu trữ (Khóa mã hóa IPFS): create_ipfs_client_from_env() (hierachain/api/storage/ipfs_client.py) nay bắt buộc HRC_IPFS_ENCRYPTION_KEY phải đúng 64 ký tự hex (32 byte) và raise IPFSError nếu thiếu/không hợp lệ — không còn tự sinh key tạm kèm warning, nên deployment thiếu key ổn định sẽ fail-fast ngay khi khởi động thay vì tạo payload không thể giải mã.

2026-09-26

• Config (Journal Sync): Loại bỏ Settings.JOURNAL_FSYNC / HRC_JOURNAL_FSYNC (hierachain/config/settings.py); TransactionJournal (hierachain/error_mitigation/journal.py) bỏ hàng đợi/luồng ghi nền và luôn ghi đồng bộ kèm os.fsync.
• Core (Merkle Payload): Hợp nhất serialize payload event thành serialize_event_payload() (hierachain/core/merkle_tree.py) dùng chung cho hierachain/core/block.py; Merkle leaves nay bao gồm trường data (trước đây bị loại), nên leaves/roots/hashes thay đổi với cùng event.
• Database (Fail-hard Reads & Event Envelope): SQLBase.get_block_by_index/get_latest_block/get_event_by_id (hierachain/adapters/database/base/sql_adapter.py) nay lan truyền lỗi database thay vì trả None; PostgresAdapter._execute_save_block (hierachain/adapters/database/postgres_adapter.py) persist toàn bộ event envelope (orjson.dumps(event)) với fallback submitted_by/sender_id, các hàm fetch giải mã qua _create_event_from_row/_decode_jsonb dùng chung.
• Hierarchical (Storage Fail-fast): HierarchyManager._create_storage() (hierachain/hierarchical/hierarchy_manager/base.py) không còn fallback về SQLite khi PostgreSQL đã cấu hình nhưng không khả dụng — nay raise RuntimeError; __init__/add_sub_chain persist metadata và khôi phục qua list_chains(), raise khi thất bại.

2026-09-24

• Core (Parquet Logs): write_parquet_log() hiện ghi các segment bất biến tối đa 1.024 bản ghi trong <path>.segments; read_parquet_log() đọc các segment và cả log một tệp legacy. Bên dùng đang đọc trực tiếp <path> cần chuyển sang helper này.

2026-09-22

• Giảm thiểu Lỗi (Validators): Loại bỏ APIValidator (kèm entry "api" trong factory create_validator và logic kiểm tra thuật ngữ cấm trên Arrow/legacy) khỏi hierachain/error_mitigation/validator.py và các export của package (hierachain/error_mitigation/__init__.py); đồng thời chỉnh đường dẫn import ConsensusValidator sang hierachain/error_mitigation/consensus_validator.py trong hierachain/consensus/bft/helpers.py.
• Giám sát (Monitoring): Loại bỏ singleton toàn cục alert_manager và export khỏi hierachain/monitoring/__init__.py (các lớp AlertManager/PerformanceMonitor vẫn khả dụng).
• Config (Storage Backend): Đổi backend lưu trữ mặc định từ sqlite sang postgres trong hierachain/config/settings.py (DEFAULT_STORAGE_BACKEND, DATABASE_URL mặc định nay là postgresql://hiera:hiera@localhost:5432/hierachain, hỗ trợ HRC_DATABASE_URL với xử lý tường minh sqlite://) và hierachain/config/product_config_template.py (HRC_STORAGE_BACKEND=postgres kèm DATABASE_URL/HRC_DATABASE_URL theo từng node); ProductionSettings.DEFAULT_STORAGE_BACKEND chuyển từ redis sang postgres.

2026-09-21

• Giám sát (Monitoring): Loại bỏ PrometheusMetrics và singleton metrics khỏi hierachain/monitoring/metrics.py (xóa file), loại bỏ các tiện ích thu thập số liệu Prometheus.
• Quản trị Rủi ro (Risk Management): Loại bỏ RotatingAuditStorage khỏi hierachain/risk_management/audit_logger.py và các export của package (hierachain/risk_management/__init__.py).

2026-09-20

• Core (Cache): Loại bỏ BlockchainCacheManager, CacheInvalidator, EntityEventFetcher và CachePerformanceTracker khỏi hierachain/core/cache_manager.py (xóa file).
• Giảm thiểu Rủi ro (Recovery & Rollback): Loại bỏ RollbackManager và các kiểu dữ liệu liên quan (RollbackType, RollbackStatus, StateSnapshot, RollbackOperation), các engine phục hồi (NetworkRecoveryEngine, ConsensusRecoveryEngine, BackupRecoveryEngine, AutoScaler), cùng RecoveryError khỏi hierachain/error_mitigation/.
• Quản trị Rủi ro (Risk Management): Loại bỏ RiskAnalyzer, MitigationManager, MitigationStrategies và các kiểu dữ liệu liên quan (RiskAssessment, RiskSeverity, RiskCategory, MitigationAction, MitigationResult, MitigationStatus) khỏi hierachain/risk_management/, chỉ giữ lại các nguyên thủy ghi log kiểm toán.
• Giám sát (Monitoring): Loại bỏ PerformanceMetrics, MetricType và PerformanceSnapshot khỏi hierachain/monitoring/performance_metrics.py (xóa file).
• Cluster: Loại bỏ ClusterManager, ClusterLockdownManager, ClusterState và cơ chế điều phối lockdown theo quorum khỏi hierachain/cluster/ (xóa cluster_manager.py và lockdown_protocol.py).

2026-09-19

• Hierarchical & Config: Loại bỏ các gói deprecated k8s_namespace_manager, proof_aggregation và rebalancer khỏi hierachain/hierarchical/ (K8sNamespaceManager, ProofAggregator, SubChainRebalancer) cùng các cấu hình liên quan (K8S_*, PROOF_*, REBALANCE_*) trong hierachain/config/settings.py.

2026-09-18

• Cluster: Loại bỏ StateSyncManager (hierachain/cluster/state_sync_manager.py) và các export liên quan khỏi hierachain/cluster/__init__.py.

2026-10-22

• Mạng (Giải phóng Transport & Kiểm tra MSP Tường minh): ZmqNode.start() (hierachain/network/zmq_transport.py) nay gọi stop() và nối lỗi gốc bằng raise ... from e khi thiết lập socket thất bại, NetworkClient.start() (hierachain/network/network_client.py) gọi stop() khi lỗi, và stop() không còn thoát sớm khi _is_running là false — lần khởi động lỗi có thể thử lại mà không rò rỉ socket. validate_msp_from_message() (hierachain/network/secure_connection.py) thay generator all(...) bằng kiểm tra str/khác rỗng tường minh cho từng trường handshake để mỗi trường thiếu có lý do từ chối riêng.
• Adapter (Biên Runtime): PostgresAuditManifest.__init__ (hierachain/adapters/database/audit_manifest.py) chấp nhận fetchone() trả None; PostgresAdapter (hierachain/adapters/database/postgres_adapter.py) nạp fallback psycopg2 qua import_module, chuyển _execute_store_proof() thành static với submitted_at/created_at mặc định time.time(), và kiểu trả về của _execute_update_state() (SQLite) nới thành bool | None (hierachain/adapters/database/base/sql_adapter.py); ChannelLedgerSQLStorage (hierachain/adapters/database/channel_ledger_sql.py) khai báo _get_connection() dưới TYPE_CHECKING, còn RedisLedgerAdapter.get_latest_block() (hierachain/adapters/database/redis_ledger.py) lọc tip rỗng trước max() và trả None khi không chain nào có block.
• API (Lọc GraphQL & Siết Kiểu): resolve_events (hierachain/api/graphql/resolvers.py) truyền tường minh entity_id/event_type/from_timestamp/to_timestamp/limit/after cho select_event_page() với chain ngoài Blockchain, _to_event_type() gán từng field của EventType sau khi khởi tạo nên details_metadata không còn rơi vào keyword không hợp lệ, và _required_graphql_permissions() (hierachain/api/graphql_handler.py) nhận diện fragment qua isinstance(..., FragmentDefinitionNode) thay vì so chuỗi definition.kind; các field GraphQL trong hierachain/api/graphql/types.py được annotate bằng cast() (và EventType.resolve_events() được phép trả None), còn tham số chain_name của WebSocket (hierachain/api/websocket/endpoints.py) đổi sang kiểu str với mặc định "all" giữ nguyên.
• Đồng thuận (Requeue Journal & Tên Rule): OrderingService.receive_event() (hierachain/consensus/ordering/service.py) raise ValueError khi hit journal không có bản ghi trước khi requeue, và _find_stable_event() từ chối payload lưu không phải dict bằng cùng ValueError thay vì AttributeError; _run_custom_rules() (hierachain/consensus/ordering/certifier.py) lấy tên rule thiếu __name__ qua type(rule).__name__ nên callable object không còn làm hỏng certification, và BFTConsensus (hierachain/consensus/bft/consensus.py) băm trực tiếp self.current_request.
• Hierarchical & Cluster (Guard Phục hồi Bền): _restore_main_chain() (hierachain/hierarchical/hierarchy_manager/recovery.py) raise RuntimeError khi storage bền không khả dụng và cast timestamp đăng ký trước float(); ChannelLedger._replay_record() (hierachain/hierarchical/channel/ledger.py) từ chối payload snapshot/event/block không phải dict qua đúng đường validate và RuntimeError sẵn có; _durable_block_events() (hierachain/hierarchical/main_chain/proofs.py) và _verify_anchor_exists() (hierachain/cluster/cross_level_sync.py) xem proof_storage thiếu là không khả dụng một cách tường minh để nhánh strict và non-strict trả kết quả đúng tài liệu thay vì dựa vào getattr(None, ...).
• Core & Giảm thiểu Lỗi (API Compute PyArrow 25): _iter_block_rows() (hierachain/core/event_query.py) dựng mask entity/timestamp bằng pc.call_function("and"/"equal"/"greater_equal"/"less_equal"/"indices_nonzero"), và _check_forbidden_terms_in_array() (hierachain/error_mitigation/validator_helpers.py) hạ chữ thường và so khớp qua pc.call_function với pc.MatchSubstringOptions(term); _open_safe_file() (hierachain/error_mitigation/journal.py) thu hẹp mode về Literal["rb", "ab", "wb", "r+b"], còn AdvancedCache.get() (hierachain/core/cache.py) nhận mọi key object trước khi ép str().
• Domains (Marker Event & Thu hẹp Validator): _rebuild_domain_state() (hierachain/domains/chains/base_chain.py) bỏ qua event replay có kiểu event không phải str trước khi dispatch, recover_committed_transaction()/commit_transaction() (hierachain/domains/chains/domain_chain.py) trả False khi _transaction_event_markers là None thay vì index vào đó, và ProofValidator._validate_single_proof() (hierachain/domains/utils/cross_chain_validator.py) cast sub_chain_name/proof_hash đã validate trước khi tra cứu.
• SDK & Bảo mật (Timeout & Nguồn API Key): HieraChainAsyncClient (hierachain/sdk/async_client.py) bọc config.timeout trong aiohttp.ClientTimeout(total=...), và HieraChainClient (hierachain/sdk/client.py) raise HieraChainAPIError khi response không có HTTP status code; APIKeyVerifier._extract_api_key() (hierachain/security/verify/api_key_verifier.py) chọn nguồn tường minh — query_params cho APIKeyQuery, còn lại là header — và gọi check_api_key() trên mapping đó thay vì gọi dependency FastAPI với connection, trong khi KeyManager.storage (hierachain/security/key_manager.py) được annotate Any.
• Giám sát & CLI (Kiểu Thống kê Alert & Đăng ký Lệnh): AlertManager.stats (hierachain/monitoring/alert_system.py) được định kiểu bằng TypedDict _AlertStatistics nên các lần tăng counter bỏ được cast() lặp lại, và hierachain/cli/__init__.py đăng ký lệnh không còn bọc cast(Command, ...) dư thừa.

2026-10-18

• API (Danh tính Sender Ledger & Validate Nonce Mặc định): _build_event_data (hierachain/api/ledger/events.py) nay ghi thêm sender bên cạnh submitted_by để ordering đọc được danh tính ký ở cả hai trường, và EventRequest.details_nonce (hierachain/api/ledger/schemas.py) bật validate_default=True để giá trị mặc định None cũng được validate — trước đây nonce mặc định bỏ qua validate hex/độ dài và event lưu thiếu sender.
• Đồng thuận (Kiểm tra lại Chữ ký Canonical & Drain khi Shutdown): _extract_verification_items (hierachain/consensus/ordering/processor.py) bỏ qua event có signature_content (đã được certifier xác minh khi xử lý trực tiếp và replay), xác minh chữ ký kiểu cũ với sender/signature hex đã bỏ tiền tố 0x, và poll event_pool tối đa mỗi 0.1s mà vẫn giữ batch_timeout; _verify_canonical_event() mới (hierachain/consensus/ordering/utils.py) ràng buộc lại các trường nghiệp vụ được đưa vào block (entity_id, event_type, event, timestamp) với signature_content gốc đã ký, từ chối trường bị sửa hoặc thêm ngoài danh sách qua SignatureVerifier().verify_event_signature(), còn verify_event_signature() chạy nhánh canonical cho các envelope này thay vì đường payload kiểu cũ; OrderingService.stop() (hierachain/consensus/ordering/service.py) join processing thread không còn timeout 5 giây để thao tác đang chạy hoàn tất trước khi đóng storage và journal — trước đây event secure canonical chỉ được xác minh lại như payload kiểu cũ, trường bị sửa/thêm lọt qua kiểm tra ràng buộc, và shutdown có thể đóng storage khi batch còn đang chạy.

2026-10-07

• Ordering (Tính Latency Theo Event Đã Commit): OrderingStorageHandler.save_block() (hierachain/consensus/ordering/storage.py) chỉ tiêu thụ các entry timing trong processed_events cho những event_id thuộc block đã persist, giữ lại timing của event còn chờ ở batch khác, và định kiểu trusted_public_keys là dict[str, bytes] giữ nguyên fallback cấu hình/file — trước đây xóa toàn bộ timing map ở mỗi lần commit.
• Lưu trữ (Kiểm tra Khả dụng IPFS): IPFSClient.is_available() (hierachain/api/storage/ipfs_client.py) gọi /api/v0/files/stat với arg=/ipfs/<cid> thay cho /api/v0/object/stat?arg=<cid> đã bị loại bỏ, trả False khi phản hồi thất bại hoặc lỗi kết nối — trước đây gọi endpoint không còn hỗ trợ.

2026-10-04

• Parquet (Niêm phong Khi Lỗi & Không Ghi đè Lặng): write_parquet_log() (hierachain/core/parquet_log.py) niêm phong segment active khi fsync file/thư mục hoặc publish thất bại và xóa file tạm, nên lần append lỗi không bao giờ bị ghi đè lặng lẽ bởi lần sau.
• Journal & Monitoring (Rollback & Kiểu Chặt): ghi journal lỗi được rollback để giữ toàn vẹn envelope (hierachain/error_mitigation/journal.py); ErrorClassifier (hierachain/error_mitigation/error_classifier.py) và kiểu monitoring (hierachain/monitoring/alert_system.py, hierachain/monitoring/performance_monitor.py, hierachain/monitoring/types.py) chuyển sang helper JSON chặt với kiểu payload alert đã sửa thay vì ép kiểu orjson hao hụt.

2026-10-03

• Ordering (Tuần tự hóa Commit & Lockdown): dùng chung một RLock service._commit_lock cho OrderingBlockManager/OrderingMaintenance/OrderingProcessor (hierachain/consensus/ordering/block_manager.py, hierachain/consensus/ordering/maintenance.py, hierachain/consensus/ordering/processor.py, hierachain/consensus/ordering/service.py); commit đang bay retry qua OrderingPausedError giữ nguyên batch đã cắt, LOCKDOWN/SHUTDOWN/ERROR không còn bị MAINTENANCE ghi đè, tạm dừng thu thập khi LOCKDOWN, shutdown đánh thức producer đang nghẽn, và event bị từ chối được xóa khỏi pending map.
• Hierarchy (Refresh Registry Tại chỗ): _apply_hierarchy_registry() refresh orgs/channels tại chỗ giữ nguyên tham chiếu object Channel và đếm events_by_org đồng thời đóng các channel đã xóa, còn _mutate_registry() retry thay đổi registry 3 lần kèm rollback (hierachain/hierarchical/hierarchy_manager/base.py).
• Channel (Tuần tự hóa Truy cập Registry): decorator _registry_operation (hierachain/hierarchical/channel/channel.py) tuần tự hóa thêm/xóa org, tạo private-collection, truy vấn event, thông tin channel/org, cập nhật policy và suspend/resume dưới RLock registry dùng chung kèm refresh trực tiếp.
• API (Tập trung Kiểm tra Admin Org): register_organization_member (hierachain/api/business/organizations.py) dùng chung _is_organization_admin() (hierachain/hierarchical/hierarchy_manager/organization.py) thay cho các kiểm tra role/identity viết inline trùng lặp.

2026-10-02

• Hierarchical (Dọn dẹp Journal khi Load lỗi): CrossChainTransactionManager.__init__ (hierachain/hierarchical/transaction_manager.py) đóng journal tự tạo khi _load_journal() raise (journal do caller truyền vào để caller tự quản) thay vì rò rỉ handle.
• Core (Validate Sender): validate_event_structure() (hierachain/core/utils.py) loại trường khóa công khai sender của envelope đã ký khỏi quét thuật ngữ tiền mã hóa của nội dung nghiệp vụ và validate riêng sender, giữ key envelope ngoài kiểm tra nội dung.
• API (Đồng thời khi Recovery Hierarchy): get_hierarchy_manager() (hierachain/api/ledger/depds.py) dùng lock non-blocking (trả 503 "in progress" khi luồng khác đang recovery) với backoff retry monotonic 5 giây giới hạn số lần thử trong bão request thay vì block các request đồng thời.

2026-10-01

• ERP (Deadlock Scheduler): SyncScheduler.get_all_tasks (hierachain/integration/erp/scheduler.py) dựng trạng thái qua snapshot tách rời _task_status() dưới một lock duy nhất thay vì gọi get_status() cho từng task, khắc phục deadlock lock lồng nhau khi liệt kê tasks.

2026-09-28

• Mạng (Kiểm tra Env Production): SecureConnectionManager (hierachain/network/secure_connection.py) kiểm tra settings.env == "production" thay vì "product" cũ, khôi phục cảnh báo P2P kém an toàn.

2026-09-27

• Lưu trữ (Phân giải CID): resolve_cid_field() (hierachain/api/storage/endpoint_helpers.py) nay re-raise lỗi khi phân giải CID thất bại thay vì lặng lẽ trả về dữ liệu gốc chưa phân giải, ngăn consumer xử lý nhầm payload chưa resolve.

2026-09-26

• Journal (Framing & Replay): Bổ sung envelope _JOURNAL_MAX_FRAME_SIZE/_JOURNAL_DATA_MARKER tách data và extra fields, vòng lặp ghi từng phần, tự sửa đuôi file rách khi mở, nhận diện PAR1 bằng magic đầu file, và replay fail-hard raise ValueError khi gặp frame hỏng/cụt thay vì bỏ qua (hierachain/error_mitigation/journal.py).
• Đồng thuận (Ordering Fail-closed): OrderingBlockManager.commit_block/vòng lặp processor/executor (hierachain/consensus/ordering/block_manager.py, hierachain/consensus/ordering/processor.py) chuyển MAINTENANCE và re-raise; recovery ép tạo block (force=True) và raise RuntimeError khi gặp entry null/hỏng; _block_from_dict (hierachain/consensus/ordering/storage.py) kiểm tra Merkle root trước hash với điều kiện dừng chặt data is None.
• Hierarchical (Recovery Validation): Khởi tạo SubChain (hierachain/hierarchical/sub_chain/base.py) fail-fast khi wait_for_active() timeout kèm shutdown ordering và giao persist genesis cho OrderingService; _process_and_finalize_single_block (hierachain/hierarchical/sub_chain/block.py) kiểm tra qua is_valid_new_block; rehydration (hierachain/hierarchical/sub_chain/ordering.py) raise ValueError khi xung đột toàn vẹn/hàng đợi và loại bỏ block đã rehydrate khỏi queue.

2026-09-25

• Journal (Giảm thiểu Lỗi): Chuyển TransactionJournal.log_event() (hierachain/error_mitigation/journal.py) sang fail-closed cho ghi async bằng cách chờ Future theo từng event do background writer hoàn tất thay vì ack ngay khi enqueue; nhánh queue đầy vẫn fallback sang ghi đồng bộ.
• Đồng thuận (Phục hồi Ordering): Đặt OrderingStatus.MAINTENANCE ngay đầu _initialize_service (hierachain/consensus/ordering/processor.py) để service không bao giờ ở trạng thái ACTIVE trong lúc replay, và buộc OrderingRecovery (hierachain/consensus/ordering/recovery.py) raise RuntimeError khi gặp entry journal error thay vì âm thầm bỏ qua.

2026-09-24

• Database (PostgreSQL Adapter): Củng cố _execute_save_block (hierachain/adapters/database/postgres_adapter.py) xóa các dòng events cũ của (chain_name, index) trước khi insert, và upsert block bằng ON CONFLICT (chain_name, "index") DO UPDATE thay vì ON CONFLICT (hash) DO NOTHING, giữ ghi đè block nhất quán với events của nó.
• Đồng thuận (Ordering Service & Storage): submit_event (hierachain/consensus/ordering/service.py) nay raise RuntimeError khi journal.log_event() thất bại thay vì âm thầm queue event chưa persist, và OrderingStorageHandler.save_block (hierachain/consensus/ordering/storage.py) raise khi storage adapter từ chối kèm cập nhật block_history/last_block idempotent (thay thế khi trùng index, chỉ append khi tiến lên).

2026-09-23

• API (Admin Secure Event): Sửa add_secure_event (hierachain/api/admin/endpoints.py) để gọi request.model_dump(exclude_unset=True), tránh chuyển các trường tùy chọn chưa thiết lập (nonce/timestamp/chain_id) thành None khi thêm event vào chain.

2026-08-31

• Bảo mật (Secret Manager): Chuẩn hóa lại các template log thông báo lỗi trong _get_from_aws (hierachain/config/secret_manager.py) nhằm loại bỏ cảnh báo nhận diện nhầm rò rỉ credential khi quét bảo mật tĩnh.

2026-08-29

• Bảo mật (Sanitization): Sửa _sanitize_html_context (hierachain/security/sanitization.py) vô hiệu hóa SSTI bằng [TEMPLATE_BLOCKED] thay vì html.escape no-op, và làm chặt _sanitize_filename_context bằng allowlist ^[a-zA-Z0-9_\-~.]+$ và lọc ../. để ngăn path traversal.

2026-08-27

• Bảo mật (Key Manager): Bổ sung guard PYTEST_CURRENT_TEST/pytest trong initialize_default_keys (hierachain/security/key_manager.py) để ngăn tạo API key mặc định trong môi trường kiểm thử khi HRC_ENV=product và cho phép khởi tạo an toàn dưới pytest.
• Hierarchical (Rebalancer): Xử lý cả pending events dạng callable và non-callable trong _get_pending_events (hierachain/hierarchical/rebalancer/split_ops.py) bằng cách kiểm tra callable() và fallback pending_events list.
• Đồng thuận (BFT): Nới lỏng ngưỡng drift timestamp từ 30s lên 120s trong verify_message_signature (hierachain/consensus/bft/helpers.py) để tránh lỗi drift khi suite chạy lâu với message tĩnh tạo lúc import.
• Config (Env Manager): Bổ sung kiểm tra HRC_ENV=test/PYTEST_CURRENT_TEST trong init_env_config (hierachain/config/env_manager.py) để ngăn tạo .env.HRC.example và load .env product trong khi chạy pytest.
• Cluster (Lockdown): Chuẩn hóa verify_signature trong hierachain/cluster/lockdown_types.py với kiểm tra kiểu str rỗng và try/except quanh hmac.compare_digest để xử lý signature không hợp lệ an toàn, duy trì tương thích với chữ ký 32 ký tự cũ.

2026-08-24

• Đồng thuận (Ordering): Bổ sung kiểm tra batch rỗng (if not self.current_batch: return False) cho hàm is_batch_ready trong BlockBuilder (hierachain/consensus/ordering/block_builder.py) nhằm ngăn chặn việc kích hoạt kiểm tra sẵn sàng sai lệch và gọi tạo block rỗng khi hệ thống ở trạng thái nhàn rỗi.
• Core (Merkle Tree): Bổ sung tiền tố phân tách miền (0x01) cho các phép băm node trung gian trong MerkleTree._build_tree (hierachain/core/merkle_tree.py) để ngăn ngừa rủi ro va chạm nhánh và trùng lặp băm.
• API (Payload Limit): Bổ sung kiểm tra kích thước stream body trực tiếp trong add_payload_limit (hierachain/api/middleware.py) nhằm kiểm soát giới hạn tải lên tối đa (1MB) cho các request dạng chunked transfer không có Content-Length.

2026-08-23

• Đồng thuận (BFT): Áp dụng xác thực chữ ký nghiêm ngặt trong _validate_consensus_message (hierachain/consensus/bft/helpers.py), đảm bảo các thông điệp đồng thuận BFT (PRE-PREPARE, PREPARE, COMMIT) có chữ ký không hợp lệ luôn bị từ chối (return False) trên mọi chế độ strictness.
• Hierarchical (Proof Verification): Bổ sung cơ chế quét chuỗi dự phòng (fallback chain scan) trong _verify_proof_in_main_chain (hierachain/hierarchical/main_chain/proofs.py) để tìm kiếm proof trên các block đã commit khi chỉ mục proof_index chưa kịp đồng bộ.
• Cluster (Lockdown Protocol): Chuẩn hóa chữ ký HMAC-SHA256 của LockdownMessage trong hierachain/cluster/lockdown_types.py sang định dạng 64 ký tự hex đầy đủ (256-bit), đồng thời duy trì khả năng tương thích ngược với chữ ký cắt ngắn 32 ký tự cũ trong verify_signature.

2026-08-14

• Bảo mật (ZK Mock Proof): _generate_mock_proof trong hierachain/security/zk_prover.py nhận thêm tham số sub_chain_name và đưa vào public_inputs, khắc phục tình trạng commitment SHA-256 được tính với sub_chain_name="" trong khi verifier hash với tên sub-chain thật (làm mọi proof bị reject khi ENABLE_ZK_PROOFS=true). _verify_mock_proof thay thế kiểm tra prefix mock_proof thiếu chặt chẽ bằng logic _verify_mock chuẩn từ zk_verifier (so hash commitment với public_inputs), từ chối fake proof.
• Hierarchical: Chuyển guard chain chỉ có genesis block lên trước get_latest_block() trong _submit_proof_for_sub_chain (hierachain/hierarchical/sub_chain/proof.py), tránh IndexError khi SubChain rỗng thay vì trả False đúng quy ước.

Ổn định Consensus & Ordering:

• Giải quyết race condition quan trọng trong commit khối và xử lý sự kiện chờ trong OrderingService.
• Đảm bảo các hoạt động lockdown và resume là atomic để ngăn chặn trạng thái không nhất quán trong quá trình bảo trì.
• Ngăn chặn mất dữ liệu im lặng trong quá trình phục hồi transaction journal với xác thực đúng đắn.
• Cải thiện logic phục hồi state với xác thực config và modularized recovery từ transaction journal.

Core & Hierarchical Chain:

• Sửa race condition trong quản lý hierarchical chain và thêm thủ tục shutdown graceful.

Ổn định & QA:

• Sửa lỗi Chain Rehydration giúp khôi phục trạng thái chính xác sau khi restart.