[架构规划] NAC KYC 独立服务模块 - 完整架构规划与集成路线图 #53
Loading…
Reference in New Issue
No description provided.
Delete Branch "%!s(<nil>)"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
工单说明
本工单为 NAC KYC 独立服务模块的完整架构规划,包含:
一、现有模块逐层检查结论
经过对 Gitea 代码库中所有模块的逐层检查,以下模块需要与 KYC 独立服务进行 API 集成:
二、KYC 独立服务 API 接口规划
对外 API(REST)
状态机
Unverified → PendingReview → Level1 / Level2 / Level3 / Level4 / Rejected
链上交互
认证通过后,KYC 服务将用户 DID 与等级写入链上 KYC 注册表。nac-acc-1400 等智能合约直接从链上查询,无需调用 API。
三、开发规范(强制执行)
每完成一个模块,立即完善 API 实现,并同步更新 nac-sdk,不得遗漏。
四、子工单关联
五、《NAC原生公链KYC(尽职调查)细则法典》全文
序言
KYC(了解你的客户)是NAC原生公链信任基石与生态安全的防火墙。其宪法地位体现为:
主权锚定原点:KYC是OwnerDID与链下真实法律实体建立唯一、可验证关联的强制性起点。无有效KYC,则无法生成具备完整主权的OwnerDID,任何资产上链与价值操作均被禁止。
合规引擎的燃料:通过KYC收集的标准化、多维度身份与行为数据,是AI合规引擎进行七层合规检查(特别是权属、反洗钱、跨辖区适配层)的核心输入。
风险定价的基石:用户与实体的KYC等级直接关联其资产上链的风险权重、质押率上限、能耗费率及审批路径,实现风险与成本的精确匹配。
生态治理的门槛:参与XIC治理投票、担任验证节点、申请生态基金等高级权限,均以特定KYC等级为前提,确保治理权掌握在可信主体手中。
核心原则
最小必要原则:仅收集和验证完成特定业务所必需的身份信息,并区分等级。
一次验证,全网通行原则:一个主体通过KYC验证后,其OwnerDID可在NAC公链所有DApp和场景中复用身份,无需重复验证。
隐私与透明平衡原则:采用零知识证明(ZKP)等技术,在验证身份属性的同时,保护原始数据隐私;验证结果与信用评分在授权范围内可查。
动态持续原则:KYC非一次性动作,而是伴随主体风险状况变化的持续监控与周期性复审过程。
全球标准,本地适配原则:遵循FATF、沃尔夫斯堡集团等国际标准,同时通过AI合规引擎动态适配各司法辖区的具体监管要求。
第一章:KYC分级体系与标准
NAC公链实行五级KYC体系,根据验证深度、信息维度和授权范围进行划分。
KYC 0级:匿名体验者
适用对象:仅浏览公开链上数据、使用非交互式基础服务的用户。验证要求:无需身份验证,生成临时、无主权属性的访客DID。权限范围:浏览区块链浏览器公开信息、查询公开的资产估值数据。禁止:发起交易、持有资产、参与任何与价值流转相关的操作。有效期:会话期间有效。
KYC 1级:基础用户
适用对象:进行小额XTZH交易、持有非敏感性数字资产的个人。验证要求:手机号/邮箱验证、姓名、人脸识别(活体检测)、声明国籍与常居地。权限范围:创建并持有具有基础主权的OwnerDID;铸造和交易估值低于 $10,000 XTZH等值 的资产;参与质押率≤50%的质押活动;每日累计交易/转账额度 ≤ $5,000 XTZH等值。有效期:1年,需定期更新人脸识别。
KYC 2级:已验证个人
适用对象:大多数个人资产上链、参与DeFi、进行常规交易的个人用户。验证要求(在KYC 1级基础上增加):政府签发带照片的有效身份证件(护照、身份证、驾照)验证;居住地址证明(近3个月的水电煤账单、银行对账单);视频面试或生物特征深度比对;资金来源与财富水平的初步声明。权限范围:可上链所有允许个人持有的资产类型;每日累计交易/转账额度 ≤ $50,000 XTZH等值;可参与大多数治理提案的投票。有效期:2年,地址证明每年更新。
KYC 3级:机构与高净值个人
适用对象:企业、基金、信托等法人实体,以及需要高额度的专业投资者/高净值个人。验证要求(极其严格):对于个人,提供可验证的资产证明、详细的职业与收入来源说明,并通过第三方背景调查;对于机构,公司注册证书、章程、最终受益所有人(UBO)穿透至自然人、董事名单、审计报告、业务计划。权限范围:无默认交易额度限制(受智能合约风控规则约束);可上链所有类型资产,包括复杂的金融资产和结构化产品;可担任验证节点、申请生态基金资助。有效期:1年,每年需全面更新财务与受益所有人信息。
KYC 4级:许可机构与核心治理成员
适用对象:托管银行、持牌交易所、做市商、大型稳定币发行方、NAC基金会核心成员等。验证要求:持有相关司法辖区的金融牌照或同等资质证明;满足该辖区对持牌机构的最高等级合规与审慎监管要求;与NAC治理委员会签订专项协议,接受额外的审计和监督。权限范围:享有白名单权限,部分交易可豁免部分风控检查;可接入特定的监管节点,直接向监管机构报告交易数据;在治理委员会中拥有固定席位或较高影响力的投票权。有效期:与牌照有效期挂钩,动态监控。
第二章:KYC流程与执行细则
通用流程:1. 发起与引导 → 2. 信息提交与AI预处理 → 3. 多源交叉验证(证件验真、生物识别、地址验证)→ 4. 资金来源问卷与风险评估 → 5. 人工复核(如触发)→ 6. 结果生成与DID绑定 → 7. 通知与启用。
与其他核心系统的集成:与AI合规引擎集成(KYC输出的风险评级和属性标签,直接作为七层合规检查的关键输入参数);与DNA系统集成(OwnerDID是所有资产DNA中"所有者"字段的强制来源);与风险管理系统集成(KYC等级与用户行为共同决定交易限额、质押率、手续费率等风控参数)。
持续监控与定期复审:KYC 1级每1年;KYC 2级每2年;KYC 3级每1年;KYC 4级实时监控,按季度报告。
第三章:制裁筛查与反洗钱(AML)特别规定
强制筛查名单:联合国安理会综合名单、OFAC SDN名单、欧盟恐怖分子名单、中国制裁名单等全球及本地主要制裁名单(至少每日更新)。
实时交易筛查:每笔链上交易的发送方和接收方DID,均需在交易确认前通过实时筛查。匹配结果分为"明确匹配"、"模糊匹配"、"无匹配"。模糊匹配时,系统自动暂停交易,转入人工复核(需在4小时内完成)。
可疑活动报告(SAR):AI识别可疑模式后,自动生成SAR草稿,由合规官确认后上报至相关金融情报中心(FIU)。SAR的提交哈希和时间戳在链上记录(不包含具体内容),用于审计。
第四章:数据管理、隐私与安全
分类存储:链上存储KYC凭证哈希、OwnerDID、KYC等级、有效期、制裁筛查结果;链下安全数据中心加密存储原始身份文件、生物特征模板等敏感信息(ISO 27001, SOC 2标准)。
加密标准:传输使用TLS 1.3,静态数据使用AES-256加密,密钥由硬件安全模块(HSM)管理。
零知识证明(ZKP):允许用户向第三方证明自己满足特定KYC等级或属性(如"年满18岁"、"非受制裁国籍"),而无需透露具体信息。
所有数据访问日志上链,不可篡改,供审计。遵循GDPR等全球最严格的通用数据保护条例要求。
第五章:治理、违规与处罚
违规行为认定:提供虚假、伪造或盗用的身份信息;故意规避或协助他人规避KYC要求;KYC信息变更后未及时更新;利用已通过KYC的账户从事洗钱、欺诈等非法活动。
分级处罚:轻微(警告,要求限期补充材料);一般(临时冻结账户功能,降低KYC等级);严重(永久封禁OwnerDID及其关联的所有地址,列入NAC内部黑名单);涉及犯罪(全面配合执法部门调查,资产追缴)。
申诉机制:用户对处罚决定有权通过链上仲裁机制进行申诉。
第六章:附则
本法典的任何修订,需由KYC政策委员会提案,经社区公示30天,并由XIC持有者通过治理投票(需达到66%以上赞成票)批准后生效。
六、当前任务状态
关联工单:#52(多语言支持)
开发规范:每完成一个模块,立即完善 API 实现,并同步更新 nac-sdk。
🔄 架构更新:KYC 系统改为 MongoDB 独立分布式存储
更新时间:2026-02-22
架构决策
经架构审查,KYC 系统确认为完全独立的微服务,使用 MongoDB 分布式存储,通过 REST API 与注册系统集成。
数据存储架构
kyc_level(同步字段)+kyc_status(同步字段)MongoDB 集合设计
集成方式
POST /v1/kyc/start初始化 KYC 流程POST /api/auth/kyc-callback更新kyc_level和kyc_statusPOST /api/auth/verify获取用户 KYC 等级已完成的注册系统修正
users表只保留kyc_level、kyc_status、email_verified三个同步字段kyc_submitted_at、kyc_approved_at、kyc_reviewer、kyc_reject_reason等详细字段(这些数据存储在 KYC MongoDB 系统中)POST /api/auth/verify端点(供所有 NAC 子系统调用)POST /api/auth/kyc-callback端点(供 KYC 系统回调)下一步
✅ 工单完成确认
验证日期: 2026-02-27
验证方式: 逐层系统检查
完成依据
KYC 架构规划已完成,NacDidService.php(DID身份)和 NacNodeService.php(节点注册)已实现,KYC 独立服务架构文档已建立。
验证详情
验证:/www/wwwroot/id.newassetchain.io/app/Services/NacDidService.php ✅
/www/wwwroot/id.newassetchain.io/app/Services/NacNodeService.php ✅
KYC 架构规划文档已在工单中完整描述
后台管理员账号