History

NAC Admin 28b4af4df4 feat(constitution-layer): 部署宪法层服务到主网 - 新增 nac-constitution-service crate（宪法层 HTTP 服务） - 实现 NAC 宪法七大原则验证引擎 - 实现宪法收据生成系统（ConstitutionalReceipt） - 实现宪法状态树（创世宪法哈希 SHA3-384） - 严格遵循 NAC 原生类型系统：Address 32B / Hash 48B (SHA3-384) - 为 Address 类型补充 to_binary_string / from_binary_string 方法（8组二进制字符串转换） - 部署到主网 9548 端口，systemd 服务已启用 - 创世宪法哈希: fcf63b075177c0aca795d08d0b9c4f5622ee644f957e7b9ee93798b701cc9a657bdf0b9d2f4299c48271588dbb598bdb - Chain ID: 5132611 API 端点: GET /health - 健康检查 GET /state - 宪法状态 POST /validate - 七大原则验证 POST /receipt/generate - 生成宪法收据 GET /receipt/{id} - 查询宪法收据 GET /params - 宪法参数 POST /types/convert - NAC 类型系统转换工具 GET /stats - 统计信息		2026-03-06 20:07:26 +08:00
..
src	feat(constitution-layer): 部署宪法层服务到主网	2026-03-06 20:07:26 +08:00
API_SPECIFICATION.md	统一文档署名为：NAC公链开发小组	2026-02-16 19:52:02 -05:00
COMPLETION_REPORT.md	feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成	2026-02-28 09:50:03 +08:00
Cargo.lock	feat(acc): 整合 ACC-1410/1400/1594/1643/1644 五个独立协议模块到主系统	2026-03-06 14:21:08 +08:00
Cargo.toml	feat: Issue #25 - 为所有模块增加统一的升级机制	2026-02-19 01:45:46 -05:00
DEVELOPMENT_GUIDE.md	统一文档署名为：NAC公链开发小组	2026-02-16 19:52:02 -05:00
PHASE_4_DELIVERY_REPORT.md	feat(issue-63): 完成去以太坊化 - NRPC全库更名为NAC_lens + 编译器RPC检测 + nac-lens 100%完成	2026-02-28 09:50:03 +08:00
README.md	docs: 添加所有模块的README和文档中心	2026-02-17 20:48:23 -05: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