SplitXCH 版税分拆构建器

根据自然语言描述，生成复杂的 XCH 版税分配地址。

工作原理

SplitXCH 创建特殊的 Chia 区块链地址，该地址可自动将收到的付款按预设比例分发给多个收款方。API 会计算出一个 puzzle 地址；任何发送至该地址的 XCH 都将在链上自动完成分发。

工作流程

1. 将用户提供的纯文本分拆描述解析为带百分比的收款方列表
2. 将百分比转换为基点（basis points）：总和缩放为 9850（API 额外收取 150 bps / 1.5% 手续费）
3. 对于嵌套分拆（即“分拆中的分拆”），采用自底向上方式构建：先创建叶子级分拆，再将其生成的地址作为收款方用于上级分拆
4. 通过 scripts/splitxch.sh 脚本或直接使用 curl 调用 SplitXCH API
5. 返回生成的分拆地址及摘要信息

基点（Basis Points）换算规则

• 10,000 bps = 100%；API 手续费 = 150 bps（即 1.5%）；收款方可获得总计 9,850 bps
• 换算公式：points = round(percentage / 100 * 9850)
• 调整最后一个收款方的基点值，使所有基点之和恰好等于 9850

示例：“在 Alice 和 Bob 之间按 60/40 比例分拆”

• Alice：round(0.60 * 9850) = 5910
• Bob：9850 - 5910 = 3940

构建 API 请求载荷（Payload）

{
  "recipients": [
    {"name": "Alice", "address": "xch1...", "points": 5910, "id": 1},
    {"name": "Bob", "address": "xch1...", "points": 3940, "id": 2}
  ]
}

保存至临时文件后执行：

bash /scripts/splitxch.sh /tmp/split-payload.json

嵌套分拆（超过 128 个收款方或存在层级结构）

当用户描述“组内含组”的结构时：

1. 首先通过 API 分别创建每个叶子级分拆
2. 将返回的 address 作为收款方填入其父级分拆中
3. 每一级分拆均单独收取 150 bps 的手续费

示例：“Team A（Alice 占 50%，Bob 占 50%）获得 70%，Charlie 获得 30%”

1. 创建 Team A 分拆：Alice 4925 + Bob 4925 = 9850 → 返回地址 xch1teamA...
2. 创建父级分拆：TeamA 地址占 6895 + Charlie 占 2955 = 9850

校验规则

• 所有地址必须以 xch1 开头，且为合法的 bech32m 编码格式
• 单次分拆最多支持 128 个收款方
• 同一分拆内所有地址必须唯一
• 每个收款方的基点值必须大于 0
• 所有基点之和必须严格等于 9850

输出格式

创建分拆后，需呈现以下内容：

1. 分拆地址：生成的 xch1... 地址
2. 摘要表格：列出每位收款方的姓名、地址（截断显示）及其对应百分比
3. 手续费说明：“SplitXCH 对每一级分拆收取 1.5% 平台手续费”
4. 使用说明：“向该地址发送 XCH，系统将自动分发至全部收款方”

若为嵌套结构，还需展示完整的树状层级结构。

API 参考文档

如需查看详细的 API 文档、校验规则及错误处理说明，请参阅 references/api.md。

重要注意事项

• 用户必须为所有收款方提供有效的 XCH 钱包地址。若地址缺失，应在调用 API 前主动向用户索取。
• 若用户仅提供了姓名与百分比而未提供地址，应明确列出所需信息并请求补充。
• 对于试运行（dry run）或预览场景，仅展示计算所得的基点值，不实际调用 API。