NAC_Blockchain/protocol/nac-udm
NAC Admin a754adcee8 feat: 宪法层四项完善 - 条款拆分/SHA3-384哈希/L3对接/nac_lens协议
1. 条款文件拆分:amendments.cnnl -> 6个独立章节文件
   - infrastructure.cnnl (A04-A08)
   - asset_compliance.cnnl (A09-A16)
   - governance.cnnl (A17-A24)
   - xtzh_currency.cnnl (A25-A32)
   - jurisdiction.cnnl (A33-A38)
   - ai_compliance.cnnl (A39-A43)

2. constitution_hash 升级:新增 calculate_constitution_merkle_root()
   使用 SHA3-384 计算所有激活条款的 Merkle 根(48字节/96位十六进制)

3. L3 存储层对接:state_database_ext.rs v2
   - 新增 ConstitutionClauseId 枚举(A01-A56 完整56条)
   - constitution_ref 字段类型安全验证
   - ConstitutionRefValidator 验证器

4. nac_lens 协议对接:constitution-service main.rs v2
   - 8个 nac_lens 方法(verify_clause/get_hash/issue_cr等)
   - TCP 监听 22050 端口
   - 完整请求/响应结构体

Issue: #CONSTITUTION-LAYER-002
Closes: 条款拆分/哈希升级/L3对接/nac_lens对接
2026-03-18 23:30:50 +08:00
..
src feat: 宪法层四项完善 - 条款拆分/SHA3-384哈希/L3对接/nac_lens协议 2026-03-18 23:30:50 +08:00
API_SPECIFICATION.md Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
COMPLETION_REPORT.md Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
Cargo.lock Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
Cargo.toml Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
DEVELOPMENT_GUIDE.md Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
PHASE_4_DELIVERY_REPORT.md Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00
README.md Issue #78 #79: protocol/ 和 rwa/ 目录分组重组 2026-03-07 18:12:43 +08:00

README.md

nac_udm

模块名称: nac_udm
描述: NAC Unified Definition Module - Single Source of Truth for NAC Blockchain
最后更新: 2026-02-18


目录结构

nac-udm/
├── Cargo.toml
├── README.md (本文件)
└── src/
├── lib.rs
    ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
    ├── contract.rs
    ├── cross_shard_transaction.rs
    ├── layer_router.rs
    ├── mod.rs
    ├── parallel_chain_manager.rs
    ├── shard_governance.rs
    ├── shard_load_balancer.rs
    ├── state.rs
    ├── state_shard_optimization.rs
    ├── upgrade.rs
        ├── acc1155.rs
        ├── acc20.rs
        ├── acc20_enhanced.rs
        ├── acc721.rs
        ├── acc_collateral.rs
        ├── acc_compliance.rs
        ├── acc_custody.rs
        ├── acc_governance.rs
        ├── acc_insurance.rs
        ├── acc_performance.rs
        ├── acc_redemption.rs
        ├── acc_reserve.rs
        ├── acc_rwa.rs
        ├── acc_valuation.rs
        ├── acc_xtzh.rs
        ├── mod.rs
        ├── xtzh_ai_engine.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
        ├── metadata_generator.rs
        ├── mod.rs
        ├── permission_proxy.rs
        ├── sync_engine.rs
        ├── wrapper.rs
        ├── constitutional_receipt.rs
        ├── execution_engine.rs
        ├── fluid_block.rs
        ├── gossip_protocol.rs
        ├── mod.rs
        ├── nrpc.rs
        ├── open_production_network.rs
        ├── amm.rs
        ├── cross_chain.rs
        ├── factory.rs
        ├── fork.rs
        ├── layered.rs
        ├── mod.rs
        ├── category.rs
        ├── code.rs
        ├── compliance.rs
        ├── jurisdiction.rs
        ├── mod.rs
        ├── risk.rs
        ├── executor.rs
        ├── gas.rs
        ├── gas_meter.rs
        ├── instruction.rs
        ├── mod.rs
        ├── opcode.rs
    ├── mod.rs
    ├── sovereignty.rs
    ├── sovereignty_history.rs
    ├── sovereignty_rules.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
        ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
            ├── mod.rs
    ├── mod.rs
        ├── cross_chain_sync.rs
        ├── mod.rs
    ├── address.rs
    ├── hash.rs
    ├── mod.rs
    ├── signature.rs
    ├── sovereignty.rs
    ├── timestamp.rs
    ├── auto_register.rs
    ├── definition.rs
    ├── language.rs
    ├── mod.rs
    ├── registry.rs
    ├── uid.rs
    ├── version.rs
    ├── mod.rs
    ├── archive_storage.rs
    ├── evidence_storage.rs
    ├── merkle_tree.rs
    ├── mod.rs
    ├── state_database.rs
    ├── cee.rs
    ├── compliance.rs
    ├── governance.rs
    ├── mod.rs
    ├── oracle.rs
    ├── unified_interface.rs
    ├── valuation.rs
    ├── xtzh_ai.rs
    ├── charter.rs
    ├── dapps.rs
    ├── explorer.rs
    ├── mod.rs
    ├── wallet.rs
    ├── amendments.rs
        ├── ai_governance.rs
        ├── ccrn.rs
        ├── clauses.rs
        ├── constitution.rs
        ├── mod.rs
        ├── rwa.rs
        ├── sovereignty.rs
        ├── xtzh.rs
    ├── asset_instance_id.rs
    ├── dna_generator.rs
    ├── feature_fingerprint.rs
    ├── mapping_table.rs
    ├── mod.rs
    ├── version_chain.rs
    ├── ai_engine.rs
    ├── constitutional_validation.rs
    ├── distribution.rs
    ├── gnacs_extension.rs
    ├── mod.rs
    ├── oracle.rs

源文件说明

lib.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/aa_pe/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/ftan/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/gids/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/ma_rcm/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l0_native/uca/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/contract.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cross_shard_transaction.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/layer_router.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/parallel_chain_manager.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/shard_governance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/shard_load_balancer.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/state.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/state_shard_optimization.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/upgrade.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1155.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc20.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc20_enhanced.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc721.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_collateral.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_compliance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_custody.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_governance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_insurance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_performance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_redemption.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_reserve.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_rwa.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_valuation.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc_xtzh.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/xtzh_ai_engine.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1594/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1643/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1644/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1400/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc/acc1410/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc20c/metadata_generator.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc20c/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc20c/permission_proxy.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc20c/sync_engine.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/acc20c/wrapper.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/constitutional_receipt.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/execution_engine.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/fluid_block.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/gossip_protocol.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/nrpc.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/cbpp/open_production_network.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/amm.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/cross_chain.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/factory.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/fork.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/layered.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/fragmentation/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/category.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/code.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/compliance.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/jurisdiction.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/gnacs/risk.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/executor.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/gas.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/gas_meter.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/instruction.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l1_protocol/nvm/opcode.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/sovereignty.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/sovereignty_history.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/sovereignty_rules.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/ccrn/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/clauses/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/constitutional/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/penalties/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/rules/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/constitution/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/clauses/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/sovereignty/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/ai_governance/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/rwa/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/ccrn/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/xtzh/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_governance/codex/amendments/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_network/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_network/csnp/cross_chain_sync.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_network/csnp/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/address.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/hash.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/signature.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/sovereignty.rs

  • 功能: 待补充
  • 依赖: 待补充

primitives/timestamp.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/auto_register.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/definition.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/language.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/registry.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/uid.rs

  • 功能: 待补充
  • 依赖: 待补充

registry/version.rs

  • 功能: 待补充
  • 依赖: 待补充

utils/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l3_storage/archive_storage.rs

  • 功能: 待补充
  • 依赖: 待补充

l3_storage/evidence_storage.rs

  • 功能: 待补充
  • 依赖: 待补充

l3_storage/merkle_tree.rs

  • 功能: 待补充
  • 依赖: 待补充

l3_storage/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l3_storage/state_database.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/cee.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/compliance.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/governance.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/oracle.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/unified_interface.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/valuation.rs

  • 功能: 待补充
  • 依赖: 待补充

l4_ai/xtzh_ai.rs

  • 功能: 待补充
  • 依赖: 待补充

l5_application/charter.rs

  • 功能: 待补充
  • 依赖: 待补充

l5_application/dapps.rs

  • 功能: 待补充
  • 依赖: 待补充

l5_application/explorer.rs

  • 功能: 待补充
  • 依赖: 待补充

l5_application/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l5_application/wallet.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/amendments.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/ai_governance.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/ccrn.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/clauses.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/constitution.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/rwa.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/sovereignty.rs

  • 功能: 待补充
  • 依赖: 待补充

l2_constitutional/codex/xtzh.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/asset_instance_id.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/dna_generator.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/feature_fingerprint.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/mapping_table.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

asset_dna/version_chain.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/ai_engine.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/constitutional_validation.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/distribution.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/gnacs_extension.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/mod.rs

  • 功能: 待补充
  • 依赖: 待补充

dividend_ai/oracle.rs

  • 功能: 待补充
  • 依赖: 待补充

编译和测试

# 编译
cargo build

# 测试
cargo test

# 运行
cargo run

维护: NAC开发团队
创建日期: 2026-02-18