ppaarell/blockchain-royalty-settlement

# 可复现版税结算引擎 一个用于治理版税结算的最小化权利感知区块链原型。 ## 概述 本仓库包含一个基于区块链的版税结算工作流的概念验证实现。该系统旨在通过链上记录使核心结算步骤更加可见且可复现，同时保持操作流程简洁且可测试。 此版本有意限定为一个**最小化治理版税结算原型**。其重点关注： - 资产注册 - 许可条款提案与验证者批准 - 版税资金与支付执行 - 审计包锚定 - 争议与合规记录 它**尚未**实现多接收者版税拆分、批量接收者分配或高级隐私证明。 ## 当前系统范围 当前实现支持单接收者支付流程： 1. 创建者注册创意资产。 2. 创建者提出版税条款。 3. 验证者批准条款。 4. 管理员发布已批准条款。 5. DSP 或报告者为版税引擎注资。 6. DSP 提交使用记录。 7. 引擎计算版税并向当前资产所有者支付。 8. 可记录审计包。 9. 可标记合规状态并开启或解决争议。 ## 合约 ### AssetRegistry.sol 创意资产的 ERC-721 注册表。 主要职责： - 铸造资产 NFT - 存储不可变的内容哈希关联 - 维护资产所有权 - 向下游版税支付暴露 `ownerOf()` 关键函数： - `mintAsset` - `ownerOf` - `grantRole` ### LicenseTerms.sol 治理版税条款生命周期。 主要职责： - 允许代币所有者提出条款 - 在激活前需要验证者批准 - 跟踪条款版本 - 正确重置新版本条款的批准状态 关键函数： - `proposeTerms` - `approveTerms` - `publishTerms` - `rateOf` - `isActive` - `getTerms` ### RoyaltyEngine.sol 单接收者版税执行引擎。 主要职责： - 接收报告者注资 - 接受使用提交 - 按 `units × rate` 计算版税 - 向当前资产所有者转账 ERC-20 支付 - 使用使用记录键拒绝重复提交 关键函数： - `fund` - `submitUsage` - `quoteRoyalty` ### AuditCompliance.sol 审计与争议记录层。 主要职责： - 锚定审计包 - 标记合规 - 开启争议 - 解决争议 - 获取包信息 关键函数： - `recordAuditBundle` - `markCompliant` - `openDispute` - `resolveDispute` - `getBundle` ### MintUSD.sol 用于模拟版税支付的测试 ERC-20 代币。 部署合约名称： - `TestUSD` ## 本版本修复了哪些问题 本版本在保留原始流程的同时进行了有针对性的修复： - 修复验证者批准状态，使新版本条款可被干净批准 - 在 `RoyaltyEngine` 中添加重复使用记录拒绝 - 保持整体结算流程不变 - 保留简单的单接收者支付设计 ## 本原型可以诚实地声称支持 该实现可以支持以下主张： - 治理版税结算流程 - 批准门控条款激活 - 单接收者版税支付 - 基于链上事件的追溯性 - 重复使用记录拒绝 - 审计包锚定 - 争议与合规工作流 ## 本原型尚未声称支持 本实现**不应**被描述为支持： - 多接收者支付拆分 - 大规模扇出分配向量 - 向数百或数千接收者批量支付 - 零知识隐私证明 - 代码层级的完整 DDEX 或 ISRC 集成 - 从结算事件自动生成完整审计 ## 仓库结构 ``` contracts/ AssetRegistry.sol LicenseTerms.sol RoyaltyEngine.sol AuditCompliance.sol MintUSD.sol scripts/ simulate.js validate_fixed.js README.md ``` ## 快速验证逻辑 验证脚本检查最小端到端流程： - 部署合约 - 分配角色 - 铸造资产 - 提出并批准条款 - 发布条款 - 为版税引擎注资 - 提交使用记录 - 确认创建者支付 - 拒绝重复使用 - 记录审计包 - 标记合规 - 开启并解决争议 ## 示例最小流程 1. 管理员部署合约。 2. 管理员授予创建者、验证者和报告者角色。 3. 创建者铸造资产。 4. 创建者提出条款。 5. 验证者批准。 6. 管理员发布条款。 7. 报告者为引擎注资。 8. 报告者提交使用记录。 9. 版税支付给当前所有者。 10. 报告者记录审计包。 11. 监管者标记合规。 12. 如有需要，创建者或报告者开启争议。 13. 仲裁者解决争议。 ## GitHub 建议定位描述 一个安全的仓库描述为： 该描述比关于大规模多方版税重建的更广泛主张更贴近当前代码。 ## 限制 本原型有意保持最小化。 当前限制： - 支付仅流向当前单一所有者 - 无原生拆分接收者分配 - 审计记录为手动，而非由支付自动触发 - 尚未有隐私保护证明层 - 未经生产环境审计 ## 后续扩展 可能的下一阶段： - 多接收者版税拆分 - 批量支付执行 - 更好的权利元数据集成 - 自动化的结算到审计链路 - 公共测试网部署脚本 - 面向创建者的前端仪表板以提升可见性 ## 研究用途 本仓库适用于： - 原型演示 - 受控测试场景 - 研究与教育用途 - 作为最小化创建者面向治理构件的证据 不应将其视为生产就绪的版税基础设施。 ## 许可证 仓库许可证：**MIT** 我出于多个原因使用此许可证： - Solidity 文件已使用 `SPDX-License-Identifier: MIT` - MIT 简单且与研究原型一致 - 它使任何查看公共仓库的人都能清楚复用条款

标签：DSP, ERC-721, NFT, on-chain, reproducible, SEC, SOX, 争议解决, 区块链, 去中心化, 可追溯性, 可验证性, 合规记录, 审计追踪, 数据可视化, 智能合约, 最小原型, 治理流程, 版权管理, 版权结算, 版税引擎, 版税支付, 版税结算, 许可条款治理, 资产登记, 链上记录