从钱包注册、子合约生成到自动归集与提取的图文操作指南

本文档用于指导无 API 接入商户，通过后台自助完成收款地址生成、预付费充值、KYT 检测、自动归集与自动提取配置，以及黑名单的归集提取。

教程目标​

本教程用于指导商户完成从钱包准备、后台注册登录、批量创建子合约、开通预付费、开启 KYT 污染阻断、配置自动归集与提取策略，黑名字资金的归集提取到实际支付测试并查看自动执行结果的完整流程。

使用前准备​

• Web3 去中心化钱包，例如 TronLink
• 3个商户管理员钱包地址
• 1个商户财务钱包地址
• 对应链网络资产，例如 TRC20 USDT
• 平台邀请码
• 管理员审核通过后方可登录后台使用

整体流程​

1. 注册或准备钱包
2. 登录商户后台
3. 批量创建子合约地址
4. 开通预付费账户并充值
5. 开启污染阻断 / KYT 检测
6. 配置自动归集与提取策略
7. 黑名单风险资金归集配置
8. 黑名单风险资金归集-提取
9. 使用子合约地址完成支付测试
10. 查看自动归集与提取结果

一、基础配置​

1. 注册或准备钱包​

商户在使用系统前，需要先准备 Web3 去中心化钱包，并通过注册页面提交机构信息。本教程以 TRC20 标准版商户为例。

商户可使用已有 Web3 钱包，也可参考官方文档创建新钱包：创建 Web3 钱包

操作说明​

在注册页面选择机构类型和区块链网络，填写机构名称、邮箱、管理员钱包地址、财务钱包地址及邀请码，勾选同意《服务协议》后，点击【注册】提交申请。

2. 登录商户后台​

商户审核通过后，可使用管理员钱包登录后台。

操作说明​

打开登录页面，选择注册时对应的区块链网络，例如 Tron(TRC20)，点击【连接 TronLink 钱包】，连接成功后点击【登录】进入后台。

3. 批量创建子合约地址​

商户无需技术对接，可直接在后台批量生成充值子合约地址，用于用户充值和资金收款。

操作说明​

进入【资金管理 → 子合约】，点击【创建】，填写创建数量，例如 10 个，子合约类型选择【充值】，然后点击【提交】。

归集方式说明​

子合约地址收到用户充值后，商户可以通过两种方式处理资金归集：

1. 自动归集：在策略平台配置自动归集规则，系统会按照设定金额自动执行归集。
2. 手动归集：商户也可以根据实际资金处理需求，在后台手动发起归集。

归集完成后，子合约资金会进入冷合约。商户后续可以通过自动提取策略，或在后台手动提取，将冷合约资金提取到商户财务钱包。

手动归集操作​

进入【资金管理 → 归集】，在【待归集】列表中查看可归集的子合约资金。

勾选需要归集的子合约后，点击【批量归集】按钮。系统会调起钱包签名确认，商户在钱包中点击【Sign】完成签名后，归集交易将提交上链执行，归集成功记录可在【归集记录】列表查询。

手动提取操作​

归集成功后，资金会进入冷合约。商户如需将冷合约资金提取到财务钱包，可以进入【资产详情】，点击【一键提取】或进入【提取记录】查看提取结果。

提取操作会将冷合约中的资金转入商户财务钱包，适用于商户需要将已归集资金转入财务钱包进行后续使用的场景。

4. 开通预付费账户并充值​

商户开通预付费账户后，才可以使用自动归集、自动提取、KYT 检测等自动化策略功能。

操作说明​

进入【系统配置 → 策略配置 → 预付费账户】，打开预付费开关，点击【充值】，选择对应充值网络，例如 Tron(TRC20)，复制充值地址或扫描二维码进行 USDT 充值。充值到账后，刷新预付费余额。

5. 开启污染阻断 / KYT 检测​

污染阻断用于检测用户充值资金是否存在风险。开启后，系统会启用 KYT 检测服务。当检测到风险资金时，对应收款子合约会被标记为黑名单，便于商户后续单独处理。

操作说明​

进入【系统配置 → 策略配置 → 策略设置 → 归集策略】，将【污染阻断开关】设置为【开启】，然后点击【保存归集策略】。

6. 配置自动归集与提取策略​

自动归集用于将子合约资金归集到冷合约。自动提取用于将冷合约资金提取到商户财务钱包。

操作说明​

进入【系统配置 → 策略配置 → 策略设置】。在【归集策略】页面设置归集触发条件，例如所有子合约累计余额达到 1000 USDT 时自动归集，或单个子合约余额大于 100 USDT 时自动归集。切换至【提取策略】页面，可设置冷合约余额触发条件，例如冷合约余额达到 100 USDT 后自动提取到商户财务钱包。设置完成后分别点击保存。

7. 黑名单风险资金归集配置​

当系统通过 KYT 检测发现某个子合约存在风险时，该子合约可能会被标记为黑名单。黑名单子合约不会进入正常归集流程，商户需要先通过多签配置紧急归集地址和紧急提取地址，用于单独处理风险资金。

操作说明​

在【修改参数提案】页面点击【修改】按钮，发起多签参数修改提案。

选择多签类型为【修改紧急提取地址】，地址选择【新增】，然后点击【提交】。系统会调起钱包签名，管理员完成签名后，提案将进入待审批状态。

多签审批说明​

提案提交后，需要切换到另一个管理员钱包进行审批。

使用另一个管理员钱包登录后台，进入：系统配置 → 多签管理 → 修改参数提案，找到待审批的提案，点击【审批】，并在钱包中完成签名确认。签名完成后，系统会继续执行上链操作，等待链上确认完成。

8. 黑名单风险资金归集-提取​

当子合约因 KYT 检测被标记为黑名单后，该子合约资金不会进入正常归集流程。商户可在后台将黑名单子合约中的风险资金单独归集到紧急归集地址，便于后续冻结、审核或退款处理。

操作说明​

进入后台：资金管理 → 归集 → 黑名单

在黑名单列表中勾选需要处理的子合约，点击【批量归集】按钮。系统会调起钱包签名确认，管理员在钱包中完成签名后，归集交易将提交上链执行。

黑名单风险资金提取​

黑名单子合约资金完成风险归集后，资金会进入商户通过多签配置的紧急归集地址。商户如需进一步处理，可将紧急归集地址中的资金提取到紧急提取地址，用于后续冻结、审核或退款。

进入后台：资产详情 → 紧急提取

在紧急提取页面中查看紧急归集地址余额，点击【一键提取】按钮。系统会调起钱包签名确认，管理员在钱包中完成签名后，提取交易将提交上链执行。

二、实际演示​

完成前面的配置后，可以通过一笔实际支付测试自动归集与提取是否正常执行。

9. 使用子合约地址完成支付测试​

商户可选择一个已创建的充值子合约地址，将该地址提供给用户付款。

操作说明​

进入【资金管理 → 子合约】，复制一个充值子合约地址。用户可使用 Web3 钱包或交易所向该地址转账 USDT。转账完成后，进入【对账中心 → 充值报表】查看对应充值订单。

10. 查看自动归集与提取结果​

用户支付成功后，如达到策略条件，系统会自动执行归集和提取。

操作说明​

查看归集结果：进入【资金管理 → 归集 → 归集记录】。查看提取结果：进入【资产详情 → 提取记录】。

三、注意事项汇总​

• 使用自动策略前，必须先开通预付费账户并充值。
• 管理员钱包必须使用 Web3 去中心化钱包。
• 充值子合约地址可直接给用户收款。
• 收单地址主要用于地址池扩容，不建议直接给用户充值。
• 开启污染阻断后，风险子合约会进入黑名单，不走正常归集流程。
• 自动归集和自动提取只有在达到触发金额后才会执行。
• 配置完成后必须点击保存。
• 链上交易需要等待区块确认，后台数据可能不会立即刷新。
• 测试支付时，金额需达到配置的触发条件。
• 自动分发和自动退款如需使用，需要联系技术团队配置。

四、完成标准​

• 商户注册并审核通过
• 管理员钱包可成功登录后台
• 已批量创建充值子合约地址
• 预付费账户已开通并充值成功
• 污染阻断 / KYT 检测已开启
• 自动归集策略已保存
• 自动提取策略已保存
• 用户向子合约地址支付成功
• 后台可查看充值订单
• 系统自动归集成功
• 系统自动提取成功

一、进入策略配置页面​

登录管理员后台后，点击顶部菜单：

系统配置 → 策略配置

进入策略配置页面后，可进行预付费账户、策略设置（归集策略、提取策略、提现（分发）策略）等配置。

二、开启预付费账户​

进入【策略配置】页面后，默认进入【预付费账户】页面。

如果页面显示为【已停用】，需要先点击右侧开关，将预付费账户切换为【已启用】状态。

开启后，页面状态显示为【已启用】，同时会出现【充值】按钮。

三、充值预付费余额​

点击【充值】按钮后，系统会弹出充值窗口。

操作步骤：

1. 选择充值网络，例如：BSC(BEP20)；
2. 系统会生成对应网络的充值地址和二维码；
3. 点击【复制】按钮复制充值地址；
4. 使用钱包或交易所向该地址充值 USDT；
5. 充值到账后，刷新页面查看余额。

四、配置归集策略​

点击【策略设置】后，选择【归集策略】。

归集策略用于配置子合约余额达到指定条件后，系统自动将资金归集。

可配置内容包括：

配置完成后，点击【保存归集策略】。

五、配置提取策略​

选择【提取策略】标签页。

提取策略用于配置冷钱包或热钱包达到指定金额条件后，系统自动触发提取操作。

可配置内容包括：

配置完成后，点击【保存提取策略】。

六、配置提现（分发）策略​

选择【提现（分发）策略】标签页。

提现/分发策略用于限制单次任务处理的钱包数量和最大金额，避免一次性处理过多钱包或金额过大。

可配置内容包括：

配置完成后，点击【保存提现（分发）策略】。

七、创建子合约地址​

进入顶部菜单：

资金管理 → 子合约

在子合约页面，可以查看已有子合约地址、子合约类型、状态、余额、更新时间等信息。

八、批量创建子合约​

点击【创建】按钮，系统会弹出创建子合约窗口。

需要填写：

选择完成后，点击【提交】。

九、子合约类型说明​

1. 充值子合约​

充值子合约地址可以直接提供给用户充值。

适用场景：

1. 给用户分配固定充值地址；
2. 用户直接向该地址转入 USDT；
3. 系统监听到账后，根据策略进行归集。

2. 订单收款子合约​

订单收款子合约主要用于订单收款池扩容，一般商户不需要手动创建。

正常情况下，商户创建订单收款链接时，系统会自动生成订单收款子合约地址。

十、完整操作流程​

1. 使用超管账号登录管理员后台；
2. 进入【系统配置 → 策略配置】；
3. 打开【预付费账户】开关；
4. 点击【充值】，选择充值网络并复制充值地址；
5. 使用对应链向充值地址充值 USDT；
6. 到账后刷新页面，确认预付费余额已增加；
7. 进入【策略设置】；
8. 配置【归集策略】；
9. 配置【提取策略】；
10. 配置【提现（分发）策略】；
11. 每个策略配置完成后，点击对应保存按钮；
12. 进入【资金管理 → 子合约】；
13. 点击【创建】；
14. 选择子合约类型并填写创建数量；
15. 点击【提交】生成子合约地址；
16. 将充值子合约地址提供给用户进行充值。

十一、注意事项​

本文介绍如何通过 TronLink / MetaMask 的子钱包功能，使用 4 组助记词（3 组多签管理员 + 1 组财务）对应 4 个主钱包，管理多个商户账号，并完成以下操作：

• 创建子钱包，分别用于各商户的多签管理员和财务地址
• 注册新商户并配置多签管理员和财务钱包
• 获取 API Key 供开发团队对接

补充说明：什么是 HD 钱包​

HD 钱包（Hierarchical Deterministic Wallet，分层确定性钱包）是一种基于助记词按固定规则分层派生地址的钱包模型。

• 一组助记词可恢复该组下的全部账户与地址。
• 同一组助记词可以持续派生并管理多个地址，不需要为每个新地址单独生成新助记词。
• 主钱包与子钱包本质上是同一组助记词下不同派生路径的账户。
• 只要派生路径一致，在不同设备中也能恢复出相同地址。

结合本文场景可这样理解：

• 你会维护 4 组助记词，对应 4 个主钱包（3 个多签管理员 + 1 个财务）。
• 每个商户都从这 4 个主钱包分别派生 1 个子钱包。
• 因为每个地址都有确定的派生来源，所以多商户管理更清晰，权限隔离也更直观。

一、适用场景​

如果你需要为多个商户重复执行注册流程，同时希望降低助记词管理复杂度，这种做法会更适合：

• 使用 4 个主钱包作为固定基础账户（3 个多签管理员主钱包 + 1 个财务主钱包）
• 每注册一个新商户，就从这 4 个主钱包下分别派生 1 个子钱包
• 其中 3 个子钱包作为该商户的多签管理员，1 个子钱包作为财务钱包

二、钱包结构与前置条件​

在注册新商户前，先确认钱包层级结构与必要参数。

钱包层级结构​

• 第一层：4 组助记词（3 组多签管理员 + 1 组财务） 说明：每组助记词独立保管，分别对应 1 个主钱包
• 第二层：3 个多签管理员主钱包 + 1 个财务主钱包 说明：由各自助记词分别派生，TRON 与 EVM 链均可使用
• 第三层：子钱包 说明：每个主钱包各派生 1 个子钱包，3 个子钱包作为多签管理员，1 个子钱包作为财务钱包

示意流程：

注册前需要准备​

• 多签管理员主钱包：3 个，分别由 3 组多签管理员助记词派生
• 财务主钱包：1 个，由财务助记词派生
• 每商户子钱包：4 个，分别来自上述 4 个主钱包
• 注册码：需联系商务获取
• 适用链：TRON 与 EVM 链流程一致

三、创建管理员与财务子钱包地址​

方式一：使用 TronLink 创建子钱包（TRON 链）​

参考文档：TronLink 钱包创建教程

操作思路如下：

1. 切换到多签管理员主钱包 1，确认当前账户为主钱包 1。

   

2. 在 TronLink 中进入添加钱包流程。

   

   

3. 选择“创建子账户”，选择 TRON 链，并填写子钱包名称，例如“商户A多签管理员1”。

   

   

   

4. 创建完成后，复制该子钱包地址备用。

   

   

5. 依次切换到多签管理员主钱包 2、3，以及财务主钱包，各自派生 1 个子钱包，分别命名为“商户A多签管理员2、3”及“商户A财务钱包”。

6. 得到 4 个子钱包地址后，用它们注册商户 A。注册步骤参考下文。

   

7. 商户注册成功后，切换到对应子账户登录后台。

   

方式二：使用 MetaMask 创建子钱包（EVM 链）​

参考文档：MetaMask 官方入门教程

操作思路如下：

1. 打开 MetaMask，切换到多签管理员主钱包 1。

   

2. 点击“添加账户”或“创建新账户”，在主钱包 1 下派生 1 个子账户。

   

   

3. 为子账户重命名，例如“商户A多签管理员1”，并复制地址备用。

   

   

   

   

   

4. 依次切换到多签管理员主钱包 2、3，以及财务主钱包，各派生 1 个子账户。

5. 最终得到 4 个子账户地址，用于注册同一个商户。

四、注册 Pay Protocol 管理员后台​

使用前面创建好的 3 个多签管理员子钱包和 1 个财务子钱包地址，前往注册入口完成商户注册。

注册入口（沙盒环境）：https://adm-sandbox.payprotocol.network/signUp

注册步骤​

1. 打开注册链接。

   

2. 机构类型选择“标准版”。

3. 区块链选择对应链，例如 TRON 或 ETH。

4. 填写注册码。需联系商务获取。

5. 填写 3 个多签管理员地址和 1 个财务钱包地址，也就是前面准备好的 4 个子钱包地址。

6. 核对信息无误后点击“提交”。

7. 等待 Pay Protocol 完成审批。

五、登录管理员后台并获取 API Key​

1. 登录链管理员后台​

使用对应链的管理员钱包登录后台。

• 如果是 TRON 链管理员账号，区块链类型请选择 Tron
• 如果是 EVM 链管理员账号，则选择对应 EVM 网络

2. 获取 API Key​

1. 登录后进入“机构信息”页面。

2. 点击“重置 API Key”。

   

3. 复制 API Key 和 API Secret。

   

4. 将 API Key / API Secret 提供给开发团队，用于后续系统对接。

六、开通其他链和币种​

商户注册成功后，可继续开通更多链和币种，参考以下文档：

• 开通新链和币种教程
• 多签提款额度配置教程

你可以按以下顺序执行：

• 冷合约替换（多签）
• 紧急归集地址设置（多签）
• 紧急提取地址设置（多签）
• 黑名单子合约资金归集与提取

一、冷合约的替换​

功能说明​

冷合约用于存储商户大额资产，为避免冷合约地址被高风险交易污染或出现安全风险，商户可通过多签机制对冷合约地址进行替换。冷合约替换需由两个管理员钱包共同完成（一个发起提案、另一个审批上链），保障资产安全。

本节以专业版后台为例，说明冷合约替换的完整操作流程。

操作步骤​

1. 使用一个管理员钱包登录后台，进入“系统配置 → 多签管理”。

   

2. 在多签管理页面，点击“修改参数提案”标签，再点击“修改”按钮，在弹窗的“类别”下拉中选择“修改冷合约地址”。

   

3. 在“地址”下拉中选择冷合约地址，分为两种情况：

   • 如果没有可替换的冷合约地址，选择“新增”，由系统生成新的冷合约地址。
   • 如果有历史地址列表，可直接选择替换为之前使用过的冷合约地址。

   

4. 确认后使用当前管理员钱包进行签名，完成提案发起。

5. 退出当前账号，切换至另一个管理员钱包登录后台，再次进入“多签管理 → 修改参数提案”，找到待审批的提案，点击“审批”。

   

6. 在审批弹窗中确认信息无误后，使用钱包进行签名，并在钱包中点击“确认”上链（需要少量 gas 费用）。

   

7. 等待约 1 分钟，提案状态变为“已通过”，冷合约地址替换完成。

   

补充说明：热合约修改​

热合约的修改流程与冷合约替换一致，均通过多签提案的方式完成。简要流程如下：

1. 使用一个管理员钱包登录，在“修改参数提案”中选择“修改热合约地址”，发起提案并完成钱包签名。

   

2. 切换至另一个管理员钱包登录，对提案进行审批，使用钱包确认上链。

   

3. 等待约 1 分钟，提案状态变为“已通过”，热合约地址修改完成。

   

二、设置紧急归集与紧急提取地址​

功能说明​

紧急归集地址与紧急提取地址用于处理被标记为高风险的子合约资金。当商户的某个收款子合约地址被标记为高风险或加入黑名单时，可将该子合约的资金通过紧急归集地址进行归集，再通过紧急提取地址将资金转移至安全的外部钱包，从而隔离风险、保护主合约资金安全。

该功能通常配合“标记黑名单”接口使用，接口文档参见：黑名单接口文档。

完整流程包含三个阶段：

1. 设置紧急归集地址（多签）
2. 设置紧急提取地址（多签）
3. 对高风险子合约执行归集并将资金提取至外部钱包

阶段一：设置紧急归集地址​

1. 使用一个管理员钱包登录后台，进入“系统配置 → 多签管理 → 修改参数提案”。

   

2. 点击“修改”按钮，在“类别”下拉中选择“修改紧急归集地址”，“地址”下拉根据情况选择：

   • 如果尚未设置过紧急归集地址，选择“新增”，由系统生成新地址。
   • 如果有历史紧急归集地址，可直接选择历史地址进行替换。

   

3. 连接钱包进行签名，完成提案发起。

   

4. 退出当前账号，切换至另一个管理员钱包登录后台，进入“多签管理 → 修改参数提案”，找到待审批的提案，点击“审批”。

   

5. 在审批弹窗中确认信息后，使用钱包签名并点击“确认”上链（需要少量 gas 费用）。

   

6. 等待约 1 分钟，提案状态变为“已通过”，紧急归集地址设置完成。

阶段二：设置紧急提取地址​

紧急提取地址的设置流程与紧急归集地址完全一致，只需在“类别”下拉中选择“修改紧急提取地址”。

1. 使用一个管理员钱包登录，在“修改参数提案”中选择“修改紧急提取地址”，“地址”选择“新增”或历史地址，点击“提交”并完成钱包签名。

   

2. 切换至另一个管理员钱包登录，对该提案进行审批。

   

3. 在钱包中确认交易上链（需要少量 gas 费用），等待提案状态变为“已通过”。

   

阶段三：归集高风险资金并提取至外部钱包​

完成紧急归集地址和紧急提取地址设置后，即可对被标记为黑名单的子合约执行归集与提取。

1. 归集高风险子合约资金​

1. 进入“资金管理 → 归集”。

   

2. 切换到“黑名单”标签，勾选需要归集的子合约，点击“批量归集”。

3. 钱包弹出交易请求，点击“Confirm”确认上链，等待归集完成。

   

2. 从紧急归集地址一键提取至紧急提取地址​

1. 进入“资产详情”，点击右上角的“紧急提取”入口。

   

2. 在紧急提取页面查看“紧急归集地址总余额”，确认资金已归集到位后，点击右上角“一键提取”。

   

3. 如果页面提示“有币种的热合约最大额度未设置”，则需要先在币种列表中确认并通过多签设置热合约最大额度。具体设置方法参见：多签教程 - 商户配置。

   

4. 完成相关配置后，再次点击“一键提取”，钱包确认交易上链，资金将从紧急归集地址转入紧急提取地址。

   

3. 紧急提取地址转账（专业版商户）​

1. 进入“资产详情 → 紧急提取 → 紧急提取地址转账”标签，点击“转账”按钮。

   

2. 在转账弹窗中选择币种（如 USDT），填写目标地址和金额，可点击“添加一行”批量转出，点击“提交”。

   

3. 使用财务钱包对该转账提案进行签名。

4. 退出当前账号，切换至另一个财务钱包登录，对该转账提案进行多签审批，钱包确认上链。

   

5. 等待交易确认，紧急提取地址的资金即可转出到指定的外部钱包。

适用场景​

• 基于 TRON（TRC20）网络的订单收款业务
• 商户需要预先准备大量收款子合约钱包，以应对高并发的收款需求
• 希望通过 TRX 支付 Gas，降低批量创建子合约的成本

整体流程​

详细操作步骤​

1. 管理后台添加 TRX 币种​

使用管理员钱包登录管理员后台，进入「系统配置 → 币种列表」，添加 TRX 币种，并通过钱包签名确认操作。

管理后台地址：https://adm.payprotocol.network/login

1.1 选择需要开通的币种​

点击「管理币种」按钮，在弹出的对话框中，从下拉列表里勾选 TRX (TRX)。

图 1：在「管理币种」对话框中，从下拉列表选择 TRX (TRX)

1.2 提交开通申请​

确认已选币种包含 Tether(TRC20) (USDT) 和 TRX (TRX) 后，点击「提交」按钮。

图 2：确认选中的币种后点击「提交」

1.3 钱包签名确认​

提交后系统会唤起钱包，弹出「触发智能合约」的签名请求，预估扣除约 2.4785 TRX 的 Gas 费用。点击「签名」按钮完成上链操作。

图 3：钱包弹窗中点击「签名」完成 TRX 币种的添加

2. 调用接口创建订单收款订单​

通过商户 API 创建订单收款订单，每个订单将对应一个独立的子合约钱包地址。

接口文档：创建订单收款订单

请求示例

POST /payment/order/create
Content-Type: application/json

{
  "chainId": 1,
  "description": "A sample order",
  "isLegalTender": 0,
  "notifyUrl": "https://www.payment.com/api/notify",
  "outTradeNo": "P2026010100000001",
  "quoteAmount": "0.01",
  "quoteCurrencySymbol": "TRX",
  "redirectionUrl": "https://www.payment.com/order/redirect",
  "tagId": 1
}

接口调用成功后，会返回订单的唯一标识 orderNo（订单号），后续步骤需要用到该字段。

3. 更新付款信息为 TRX​

订单生成后，需要调用「更新付款信息」接口，将该订单的支付币种切换为 TRX。这一步是关键：通过将 currencyId 设为 1（即 TRX），后续支付的 0.01 TRX 即可触发该子合约钱包生成，且 Gas 成本极低。

接口文档：更新付款信息

请求示例

POST /payment/payInfo/update
Content-Type: application/json

{
  "chainId": 1,
  "currencyId": 1,
  "outTradeNo": "P2026010100000001"
}

关键参数说明

4. 获取订单中生成的子合约钱包地址​

更新付款信息后，可通过「查询订单收款订单详情」或「查询订单收款页面信息」接口，获取该订单关联的子合约钱包收款地址。

5. 向子合约地址支付 0.01 TRX​

使用任意交易所或钱包（如 TronLink、Binance、OKX 等），向步骤 4 获取的订单收款子合约转账 0.01 TRX。

6. 等待子合约钱包部署完成​

链上确认后（通常在 1 分钟内），系统会监听到该笔 TRX 转入交易，并自动触发子合约的部署逻辑。部署完成后，新的子合约钱包即可作为独立的收款地址投入使用。

确认子合约部署成功的方式

• 通过 TRON 区块浏览器（如 Tronscan）查询该地址，应能看到合约创建相关的交易记录
• 通过商户回调接口（notifyUrl）接收订单状态变更通知
• 再次调用「查询订单收款订单详情」接口，确认订单状态已更新

7. 批量循环操作​

将步骤 2 ~ 步骤 6 封装为程序循环或批处理脚本，即可批量生成多个子合约钱包。

8. 完成后移除 TRX 币种​

批量创建任务完成后，建议从管理后台移除 TRX 币种，避免普通订单收款业务被误用 TRX 支付通道。

操作步骤

• 使用管理员钱包登录管理后台
• 进入「系统配置 → 币种列表」
• 点击「管理币种」按钮，在弹出的对话框中点击 TRX (TRX) 旁边的「×」将其移除
• 点击「提交」按钮
• 钱包签名确认操作（与步骤 1.3 类似）

跨链桥（Cross-chain Bridge）是一种用于在不同区块链网络之间转移资产的协议机制。由于各条公链（如 TRON、Ethereum、BSC 等）相互独立、协议不兼容，资产无法直接互转，跨链桥通过「锁定 → 铸造」或「兑换 → 释放」的方式，实现同一资产在不同链上的等值流通。

本平台跨链能力​

本管理后台已内置跨链兑换功能，无需对接外部跨链桥即可在主流公链之间完成资产转移。其使用形式类似「币币兑换」：选择卖出资产、选择买入资产所在链，填入对方链上的收款地址，确认后即可完成跨链。

二、操作步骤​

1. 登录管理后台​

使用「财务管理员」账号登录管理后台。

管理后台地址：https://adm.payprotocol.network/login

2. 确保热钱包（财务）有足够余额​

跨链兑换的资金来源是「热钱包（财务）」。如果热钱包余额不足，需先将冷合约钱包的资产提取到热钱包，或从其他外部地址转入热钱包。

方式 A：从冷合约一键提取

进入「资产详情」页，点击右上角的「一键提取」按钮，系统会将冷合约钱包的可用余额自动提取到热钱包。

图 2-1：在「资产详情」页点击「一键提取」

方式 B：从外部地址转入

如冷合约也无可用余额，可从其他自有地址（如交易所提币、外部钱包转账）直接向热钱包（财务）地址充值。热钱包地址可在「资产详情 → 热钱包」标签页中查看。

3. 进入兑换页面并填写信息​

点击顶部导航「资金管理 → 兑换」，进入跨链兑换页面。

图 3-1：导航到「资金管理 → 兑换」

在兑换页面填写以下信息：

图 3-2：兑换表单（卖出 / 买入 / 收款地址）

4. 确认并发起兑换​

信息填写完整后，页面下方会显示实时报价（例如 1 USDT ≈ 1.000000 USDT）。该报价仅供参考，最终成交以兑换执行时的报价为准。

确认无误后，点击下方「开始兑换」按钮提交。系统会扣除热钱包对应金额，并通过跨链桥将资产转入目标链的收款地址。

5. 在目标地址查看到账情况​

兑换发起后，可通过以下任一方式确认到账：

• 打开目标链的区块浏览器（如 Etherscan、BscScan），查询收款地址的最新交易记录
• 打开自己的钱包应用（如 MetaMask、TronLink），切换到目标网络后查看余额变化
• 回到管理后台，在「资产详情 → 提取记录」中查看兑换流水状态

三、注意事项​

• 跨链兑换不可逆，提交后无法撤销，操作前请反复核对地址与金额
• 不同币种之间的兑换会按市场实时汇率结算，存在一定滑点
• 大额兑换建议先用小额（如 1 USDT）测试，确认到账后再进行大额操作
• 某些链对（例如冷门小币种）可能流动性不足，到账时间较长甚至失败
• 跨链桥手续费已包含在兑换汇率中，无需额外支付
• 源链交易需要支付链上 Gas（由热钱包账户承担），请确保账户有少量原生币（如 TRX）

四、参考资料​

• Etherscan（以太坊浏览器）：https://etherscan.io
• Tronscan（波场浏览器）：https://tronscan.org
• BscScan（BSC 浏览器）：https://bscscan.com

下面是使用紧急归集功能的步骤：

1. 标记子合约为黑名单​

当商户通过 KYT（了解你的交易）检测发现某笔入账资金为黑U后，应立即调用添加用户子合约到黑名单接口，将该受污染的子合约标记为黑名单。黑名单中的子合约将不会再被订单收款使用，也不会参与正常的归集流程。

2. 添加紧急归集地址​

使用管理员钱包登录商户后台，进入多签管理页面，修改多签参数配置，选择修改紧急归集地址并填入一个安全的外部地址，多签审批通过后即可。

3. 执行紧急归集​

进入归集页面，选择黑名单选项卡，可以看到之前被标记的子合约。选择需要归集的子合约，点击批量归集按钮，系统会将子合约内的资金归集到之前设置的紧急归集地址。

标签地址（Tag Address）用于对钱包地址进行分类管理。 商户在创建支付订单时指定 tagId 后，系统会自动从对应标签的地址池中分配收款地址。

地址分配规则如下：

• 如果标签下存在可用地址，系统优先复用已有地址。
• 如果标签下地址全部被占用，系统会自动创建新的地址。
• 新地址会自动归属于该标签。

该机制可以帮助商户实现：

• 地址分类管理
• 地址复用
• 自动地址扩展

该机制适用于需要管理大量订单收款地址的商户场景。

二、整体业务流程​

整体流程如下：

三、创建标签​

文档地址：创建标签接口文档

在创建支付订单之前，商户需要先创建标签。

接口地址：

POST /api/mer/user/tag

请求示例：

{
  "tagName": "A1"
}

该示例创建标签 A1。

创建成功后，接口会在 data 中返回标签 ID（例如 1），该 ID 可用于支付订单。

四、创建支付订单​

创建订单时，请在请求参数中填写 tagId，用于指定订单使用的标签地址组。

接口地址：

POST /api/mer/payment/createPaymentOrder

请求示例：

{
  "chainId": 136,
  "description": "A sample order",
  "isLegalTender": 0,
  "notifyUrl": "https://www.payment.com/api/notify",
  "outTradeNo": "C3",
  "quoteAmount": "0.01",
  "quoteCurrencySymbol": "USDT",
  "redirectionUrl": "https://www.payment.com/result?order=202312131805041280413",
  "tagId": 1
}

参数说明​

五、地址分配规则​

订单创建成功后，系统会执行以下逻辑：

1. 获取订单中的 tagId
2. 查询该标签下的地址池
3. 判断是否存在可用地址

处理逻辑如下：

• 如果存在可用地址，优先复用已有地址。
• 如果地址全部被占用，系统自动创建新地址。

地址分配判断流程：

示例（A1 标签地址池）：

地址1
地址2
地址3
地址4
地址5

订单创建时的地址分配结果：

• 订单1 -> 地址1
• 订单2 -> 地址2
• 订单3 -> 地址3

如果所有地址均被占用，系统将自动创建新地址（例如地址6），并自动加入 A1 标签地址池。

六、修改地址标签​

文档地址：修改地址标签接口文档

如果需要调整某个地址所属的标签，可通过以下接口操作。

1. 查询地址列表​

接口地址：

GET /api/mer/user/list

返回信息中包含以下字段：

• walletId
• tagId
• address

2. 修改地址标签​

接口地址：

POST /api/mer/user/wallet/tag

请求示例：

{
  "walletId": 123456,
  "tagId": 1
}

执行成功后，该地址会归属于新的标签。

七、完整流程示例​

完整业务流程示例如下：

本文档指导 商户管理员 完成以下配置：

• 开通新的区块链网络（如 ETH、BSC）
• 在区块链上添加新的加密货币（Token）

开通新区块链网络​

前置准备​

开通新链前，需要准备 4 个管理员钱包地址。这些地址将用于：

• 新链上的资产管理
• 多签配置

创建管理员钱包（以 ETH 为例）​

使用 MetaMask 创建钱包​

1. 安装 MetaMask 浏览器插件或手机应用
2. 按提示创建新钱包，务必备份助记词
3. 钱包默认连接到 Ethereum 主网
4. 复制钱包地址（需要创建 4 个管理员地址，每个都重复此步骤）

登录系统后台​

使用 Tron 链管理员账号 连接钱包登录后台系统。

配置 ETH 链管理员​

1. 在链列表中选择 ETH 链

2. 填写管理员地址

• 使用之前创建的 4 个 ETH 钱包地址
• 仔细核对地址信息后提交

3. 提交后，系统将进行审批流程

配置 BSC 链​

添加新的加密货币（Token）​

导入钱包到 MetaMask（如需要）​

如果之前的钱包地址是使用 Trust Wallet 或其他钱包创建的，可以按以下步骤导入 MetaMask：

登录链管理后台​

使用 ETH 链管理员账号 连接钱包登录后台，并在区块链选项中选择 "ETH"。

配置币种（以 ETH 链为例）​

1. 进入后台管理菜单：系统配置 → 币种列表

2. 点击 管理币种 按钮，在列表中选择需要开通的币种

3. 确认选择后，点击 "提交" 按钮

• 此操作需要在区块链上执行交易
• 会消耗少量 Gas 费用
• 交易确认后，币种添加成功

BSC 链币种配置​

在 Pay Protocol 的区块链世界中，实现这一功能的核心理念就是 商户子合约。它不是商户唯一的收款账户，而是由商户按需批量生成、专门服务于特定场景（如一个用户或一个订单）的智能合约地址。由于其基于区块链和智能合约，生成和管理方式更加灵活、透明且安全。

1. 为什么需要子合约？为什么不直接转账到冷合约？​

直接让所有用户向商户的同一个冷合约地址转账会带来几个核心问题，而子合约正是为了优雅地解决它们：

1. 业务匹配需求：现代业务场景复杂，商户需要为海量用户或交易创建唯一的标识。子合约可以批量生成唯一收款地址，完美匹配"一用户一地址"或"一订单一地址"的业务模型，便于精准跟踪资金流向。
2. 资金安全隔离：区块链上存在风险资产（如黑U）。如果使用单一地址收款，一旦收到问题资金，可能导致商户整个主资金池被污染或冻结。子合约将风险隔离在最小单元，如果某个子合约地址收到异常资金，可以单独处理，不会影响商户的冷、热主钱包。
3. 保护冷合约安全：冷合约作为总金库，设计初衷就是减少链上交互，以最大化安全。子合约作为"前沿收银点"，承担了所有高频的收款活动，冷合约只在需要资金归集时进行安全调用，形成了清晰的安全边界。

2. 生成机制：预生成地址与按需发布​

子合约的生成基于一套安全的工厂模板模式。每个商户的子合约工厂模板在部署时即与其冷合约地址进行强绑定，这确保了所有通过该模板生成的子合约都具有相同的安全规则和资金流向。

• 对于充值业务：商户可以主动调用接口，为特定用户手动生成一个专属的子合约地址，并与之绑定，实现清晰的资金归属。
• 对于订单收款业务：支付系统会根据订单量，从一个预生成的地址池中按需分配子合约地址给不同的订单。为了提升效率，非同时段的订单可以复用同一个子合约地址。
• 关键升级节点：所有预生成的子合约地址，在初始阶段只是一个普通的EOA地址。只有当它收到资金并第一次触发归集操作时，系统才会在区块链上正式部署智能合约代码，使其"升级"为一个功能完整的子合约。

重要的是，由于工厂模板的绑定设计，所有子合约内的资金只能通过唯一的归集操作路径归集到指定的冷合约中，从根本上杜绝了资金误流向其他地址的风险。

这个过程可以类比于酒店为客人分配房卡：酒店前台拥有空白的房卡（预生成的子合约地址）。当客人入住（产生订单/用户绑定），前台将一张空白房卡授权给某个房间（分配地址）。只有当客人第一次刷卡进入房间（首次归集），这次入住关系才被正式激活并记录（发布子合约）。而客人退房后，房间被打扫干净，这张房卡可以重新授权给下一位客人（地址复用）。

3. 资金流转全流程​

结合子合约，资金流转路径清晰且安全。基于模板与冷合约的绑定关系，所有子合约的资金流向被严格限定：

1. 用户支付 → 款项进入为其订单或账户生成的专属子合约地址。
2. 子合约归集 → 商户触发操作，将该地址内资金归集到与其绑定的冷合约（总金库）；此时，该地址才正式在链上"升级"为子合约。
3. 冷合约划拨 → 根据需要，将资金从冷合约转入热合约（流动运营账户）。
4. 商户提现 → 通过热合约进行提现或对外支付。

为了更好地理解整个体系，我们可以将其比喻为一家大型连锁企业的财务管理：

• 商户像一家大型连锁企业
• 冷合约是企业的"总部中央金库"，安全但调动不频繁
• 子合约工厂模板是企业的"标准化分公司设立规范"，确保所有分公司资金最终都汇入总部
• 子合约地址是企业预先申领的一批"收款账户号"
• 子合约是某个"收款账户号"被实际使用并建立完整账套后的状态
• 热合约是企业的"日常运营现金账户"

具体流程：客户向指定的收款账户号付款（子合约地址收款）→ 定期将各个账户号的钱按照既定规则归集到总部金库，此时该账户号完成正式建账（升级为子合约并归集至冷合约）→ 总部将预算划拨到运营账户（冷合约→热合约）→ 企业进行日常开支（热合约支付）。

⚡ 总结​

• 子合约工厂模板 = 与冷合约绑定的"标准化子账户生成器"
• 子合约地址 = 预生成的"收款账户号"
• 子合约 = 已激活并正式建账的"独立收款账户"
• 冷合约 = 商户的"总部总金库"
• 热合约 = 商户的"日常运营账户"

这套机制通过模板绑定、预生成和按需激活的策略，不仅实现了资金的精细化管理和风险隔离，还确保了资金流向的绝对可控性。所有子合约的资金只能通过归集操作归集到绑定的冷合约，既满足了复杂业务的需求，又从架构上保障了资产的安全性。

听起来很理想：

• 用户操作通过 UserOperation（UserOps） 来提交，而不是普通的交易。
• Bundler 会收集用户的 UserOps，打包成一笔交易，再提交到区块链。
• 账户逻辑（签名方式、多重验证、限额、恢复机制）完全由合约控制，钱包体验更灵活。

但我们在深入研究后发现：ERC-4337 在支付业务中的现实效果，并没有理想中那么完美。

1. 成本问题：Gas 并没有更省​

• ERC-4337 的问题

  • 每一笔 UserOps 需要单独验证签名、nonce、限额逻辑。
  • 这些校验不是由区块链主协议原生执行，而是由 Bundler 在内存池里模拟完成。
  • 最终提交到链上的 calldata 会更长、更复杂，导致 交易费用往往是普通交易的 2–3 倍。
  • 这笔额外开销，本质上就是“用更高的成本换来了更复杂的钱包逻辑”。

• Pay Protocol 的方案

  • 用户不需要自己操作，商户端可以批量打包，显著降低成本。
  • 没有额外验证逻辑，链上数据更简洁，Gas 消耗比标准交易还便宜。

👉 在支付场景里，低成本远比复杂功能更重要。商户要的是“每笔更便宜”，而不是“更炫的签名方式”。

2. 兼容性问题​

• ERC-4337 的问题

  • 标准虽然统一了 UserOps 的接口，但具体实现差异很大。
  • 不同服务商（如 ZeroDev、Biconomy）提供的智能合约钱包结构并不一致。
  • 应用层如果想要支持多家，兼容成本极高。实际上，开发者往往会被迫选择其中一家，然后被锁定在它的生态里。

• Pay Protocol 的方案

  • 我们的无私钥账户基于合约工厂，遵循标准 EVM 逻辑。
  • 只要是 EVM 公链，就能开箱即用，不依赖某个特定服务商。

👉 对商户来说，开放的真正意义不是“新标准”，而是“随时换链、随时接入”。

3. 升级与维护：Proxy 的复杂性 vs 模板的简洁性​

• ERC-4337 的问题

  • 合约钱包一旦部署，逻辑就固化了。

  • 如果需要加新功能，通常要通过 Proxy 升级模式：

    1. 先写一个新的逻辑合约。
    2. 修改 Proxy 指针，指向新逻辑。
    3. 处理旧数据迁移和安全审计。

  • 这个过程不仅繁琐，还容易引入新的漏洞，审计成本也会提高。

• Pay Protocol 的方案

  • 无私钥账户是基于模板合约批量生成的。
  • 如果需要升级，只需发布一个新版模板，再批量生成新账户。
  • 不需要处理 Proxy 的复杂性，迁移路径简单直接。

👉 简洁就是安全，越复杂的合约结构，出问题的概率越高。

4. 安全风险：更强的灵活性，也带来更大的攻击面​

• ERC-4337 的问题

  • 由于账户逻辑是可编程的，理论上可以支持任何签名或权限控制方式。
  • 但灵活性越强，安全边界也越模糊。
  • 过去已经出现过案例：攻击者可以通过漏洞创建“未授权的账户”，甚至绕过验证。
  • 在支付业务里，这样的风险是不可接受的。

• Pay Protocol 的方案

  • 无私钥账户的逻辑极其简洁：就是一份工厂合约，负责生成标准账户。
  • 没有复杂的多重验证或外部依赖，也就没有额外的攻击面。

👉 对支付行业来说，安全第一。

5. 目标客户群体：toC vs toB 的根本差异​

• ERC-4337 的定位

  • 主要面向 C端个人用户，为他们提供更智能的钱包体验。
  • 重点解决个人用户的痛点：忘记私钥、复杂的签名操作、缺乏社交恢复等。
  • 用户愿意为更好的体验支付额外成本，对 Gas 费用的敏感度相对较低。
  • 追求的是钱包功能的差异化和个性化。

• Pay Protocol 的定位

  • 专注服务 B端商户与支付平台，帮助他们快速接入区块链支付。
  • 重点解决企业级需求：批量处理、成本控制、合规要求、系统集成。
  • 商户对成本极其敏感，每降低1%的手续费都能带来显著收益。
  • 追求的是稳定性、可预测性和规模化运营。

👉 不同的客户群体，有着完全不同的核心诉求。ERC-4337 解决的是"让个人钱包更好用"，Pay Protocol 解决的是"让商户支付更省钱"。

对比总结​

我们的结论​

ERC-4337 代表了钱包发展的未来方向：更灵活、更个性化、更智能。但它目前还处在早期阶段，生态并不成熟：

• Bundler 运行依赖少数几家服务商 → 现实上的中心化。
• 成本偏高 → 不适合高频支付。
• 升级与兼容性不够友好 → 增加维护成本。

对支付业务而言，省钱、省心、安全才是最核心的价值。

所以，Pay Protocol 暂时不会采用 ERC-4337，而是选择了 更直接、可控、稳定的无私钥账户方案，为商户和用户提供今天就能用、而且足够安全的支付体验。

一句话总结：ERC-4337 专注提升个人钱包体验，Pay Protocol 专注解决企业支付成本问题。

一、使用形态分类（Usage-Based Categories）​

从用户体验和密钥管理方式看，钱包可分为以下几类：

1. 按是否联网：热钱包 vs 冷钱包​

2. 按私钥托管方式：托管型 vs 非托管型​

3. 按载体形态​

• 软件钱包：手机App、桌面客户端、浏览器插件（如 MetaMask、Trust Wallet）
• 硬件钱包：Ledger、Trezor、OneKey 等离线设备
• 纸钱包：打印或手写私钥与地址
• 多签钱包：需多私钥共同签署交易（如 Gnosis Safe）

二、协议模型分类（Protocol/Account Model Categories）​

不同区块链在协议层的账户设计各有特色：

作为 Web3 支付基础设施的 Pay Protocol​

Pay Protocol 是一个非托管（Non-custodial）、智能合约驱动的去中心化支付与钱包基础设施，专为 B2C 企业（如零售商、金融科技公司）设计。它允许商家拥有完全的链上控制权，并避免传统的私钥集中管理风险。

• 协议模型定位：属于 Contract Account（CA）类型，通过纯合约逻辑实现资金与授权管理，无需服务端存储私钥。
• 技术优势：
  • 即使商家服务器被攻破，资金仍可安全恢复
  • 相较于 MPC，无需服务器运维，成本大幅降低
  • 支持灵活的多签与后台管理策略配置
• 适用场景：适用于希望集成加密支付、又想保持链上自持资产控制的商家与金融机构，可归入协议模型分类下的 CA 类型钱包，并强调其智能合约管理特色

三、安全风险与防范​

常见风险​

1. 私钥/助记词泄露 → 资产被盗
2. 钓鱼网站与假App → 误导授权或签名
3. 恶意合约授权 → 资产被合约转走
4. 硬件钱包假货 → 出厂前已被篡改
5. 设备中毒 → 热钱包被远程操控

防范建议​

• 🔒 冷热分离：热钱包存小额，冷钱包存大额
• 🛒 官方渠道购买硬件钱包
• 🔄 定期撤销多余合约授权（如 Revoke.cash）
• 🌐 不在公共网络输入助记词
• 🔑 使用多签或 MPC 提升安全性

四、常见钱包对照表​

总结​

• 使用形态分类决定了钱包的安全性与便捷性
• 协议模型分类决定了钱包能实现的功能和安全策略
• 商户或机构可选择 CA 类型钱包（如 Pay Protocol）以实现链上自持资产管理，并可利用其合约策略灵活配置多签、支付和权限管理

一、签名原理与安全设计​

什么是链上签名？

区块链中的“签名”是指使用账户的私钥对交易数据进行加密确认的过程，确保交易来自合法账户且内容未被篡改。它遵循非对称加密原理，即用私钥签名、用公钥验证，具备不可伪造和不可篡改的安全属性。

签名为什么必须保护？

传统系统常将签名过程托管在服务器中，但存在以下风险：

• 私钥泄露风险：一旦服务器被攻击，资产将面临巨大损失；
• 数据明文暴露：转账内容在公网传输过程中可能被监听或截取；
• 操作不可审计：一旦多人可访问服务器，签名行为缺乏透明性与安全边界。

安全签名设计理念

为了解决上述问题，Pay Protocol 设计了“签名本地化 + 数据最小化 + 权限分离”的安全体系：

• 签名在商户本地服务器完成，私钥永不出网；
• 平台只处理签名哈希，完全看不到明文数据；
• 签名和交易广播由不同主体完成，形成权限分离。

这种架构可极大降低单点泄露风险，提高链上资产操作的合规性与安全性。

二、安全签名流程概述（五步）​

整个签名流程分为以下五个步骤：

具体部署可参考文档安全签名机安装部署

1. 签名机安装

   商户将安全签名机以 Docker 容器方式部署在自己的内网服务器中：

   • 该服务器不暴露公网接口；
   • 只有商户自己拥有访问权限；
   • 可部署在物理机、本地 IDC 或私有云环境。

   这一环节确保了签名服务的私密性，形成物理隔离。

2. 批量转账提交

   商户准备好转账列表（例如多个地址与金额组合），通过内网接口提交给签名机。此操作过程：

   • 不经过平台或第三方；
   • 转账数据始终停留在商户网络内部；
   • 保证交易信息隐私性。

3. 生成转账签名

   签名机会使用本地热钱包私钥，对每一笔转账数据逐一签名。签名行为不依赖平台 API，仅在本地完成：

   • 私钥不会离开商户服务器；
   • 签名结果为哈希 + 数字签名。

   完成后，商户即可批量导出签名数据，准备广播。

4. 提交签名

   商户将签名后的交易哈希提交给平台，平台只接收到如下信息：

   • 签名哈希；
   • 区块链网络类型；
   • 不包含转账明文。

   平台无法还原转账内容，也无法重放交易，确保“数据不可知”。

5. 确认转账 & 回调通知

   平台将收到的签名哈希广播至区块链网络，并在链上验证签名合法性。交易成功后，平台会以回调方式通知商户：

   • 回调信息包括交易哈希、状态、区块高度；
   • 若失败，也会同步失败状态，便于追踪。

三、安全性优势分析​

四、典型应用场景​

• 批量转账：如工资发放、项目奖励、批量空投等；
• 支付聚合：多笔小额收款后的批量归集操作；
• 链下风控后链上广播：审核系统在链下确认后交由签名机完成签名。

五、总结​

Pay Protocol 的安全签名方案通过安全签名机，构建了一个**“离线签名 + 上链广播分离”**的安全模型，具备：

• 零私钥暴露风险；
• 强隐私保护能力；
• 分布式部署灵活性；

它特别适合对安全要求高、有批量操作需求的 Web3 商户或项目方，为链上资产操作提供了一个高可靠、可审计、低信任依赖的基础设施。

一、合约地址是否安全？​

合约地址是用于运行智能合约的链上账户，本平台使用的合约地址是由我们部署并审计的收款合约，具有明确用途，仅用于接收用户支付款项。该合约无权限主动发起资金转出，也无法恶意操作您的钱包资产，因此是安全的。

✅ 合约地址是链上公开、可验证的，您可在浏览器中查询其代码与交易记录，确保安全性。

二、为什么钱包会提示"合约地址风险"？​

这是钱包的默认风险提示机制，目的是提醒用户谨慎操作，避免误将资产发送到未知或恶意合约地址。

但请放心，我们使用的合约地址已通过测试与验证，并长期稳定运行。

⚠️ 钱包并不会判断合约的"好坏"，仅仅是识别出这是一个"合约"而不是普通钱包地址，因此会自动提示。

三、TP(TokenPocket)，ImToken钱包中的提示示例​

如下图所示，TP，imToken 钱包在检测到合约地址时，会提示：

"您输入的地址为合约地址，请核对后再进行转账！"

四、我们建议您这样做：​

1. 确认地址来源可靠：请确认收款地址为本平台提供，切勿自行更换。
2. 正常转账即可：即使钱包提示风险，只要确认地址无误，您依然可以放心转账。
3. 如有疑问，请联系客服：我们会第一时间为您核实合约地址并给予技术支持。

一、ITRX 账号申请与登录​

1. 将您的邮箱提交给 Pay Protocol 商务或团队成员，管理员审核后，会为您开通 ITRX 账号。

2. 使用您的邮箱和我们发送的初始密码登录 ITRX。登录后请及时修改密码。

二、API Key 创建与充值地址获取​

1. 登录 ITRX 后，打开 “用户中心-API”，创建 API 并复制 API Key 和 API Secret。

   

2. 进入充值提现页面，复制充值地址， 并使用您的钱包向该地址充值 TRX（请确保充值金额足够用于购买能量）。

   

三、配置 ITRX 自动购买能量​

1. 使用管理员账户登录 Pay Protocol 商户后台，点击“机构信息”-“编辑”。

   

2. 在自动购买能量首选平台中选择 ITRX，然后填写 ITRX 的 API Key、API Secret 和充值地址，确认无误后点击“提交”保存。

   

四、自动购买能量演示（以归集操作为例）​

1. 在 Pay Protocol 商户后台，点击"资金管理"-"归集"，勾选任意待归集的钱包进行批量归集。

   

2. 如果当前管理员钱包能量不足，系统会提示“是否购买能量”，选择 “帮我购买” 并点击 “在itrx购买”，系统将自动在所选平台完成能量购买。

   

3. 等待能量购买成功后，根据提示在钱包弹窗完成签名操作。

   

以上步骤涵盖了 ITRX 自动购买能量 的完整配置流程，帮助您简化操作并节省 Gas 费。

一、什么是安全验证机​

安全验证机（又称“安全控件”）是一种部署在后台或独立服务器上的安全服务组件，用于对来自商户系统的链上转账请求或其他关键多签操作的签名进行二次验证与权限审核。

其核心机制是：

商户系统完成初次签名后，安全验证机会根据同样的参数独立生成签名，并与原始签名进行比对，只有在内容一致、权限合法的前提下，才允许上链执行。

该机制可有效防止数据篡改、伪造签名与越权操作。

二、为什么要使用安全验证机​

在区块链系统中，签名即控制权。任何一次签名若遭篡改或滥用，都可能造成严重资产损失。引入安全验证机制可以：

• 数据一致性验证：识别中间人攻击、请求伪造。

• 权限控制机制：阻止未授权或越权签名。

• 审计与追踪能力：记录所有签名行为，便于回溯和取证。

三、商户系统与后台系统的转账操作流程​

1. 加密转账请求信息

   在商户系统向后台系统发送转账请求时，使用加密算法保护转账数据（如地址、金额、币种等），确保信息的安全。

2. 请求钱包签名

   后台系统将转账请求传递给 Web3 钱包插件，钱包插件会进行多签操作并返回签名。

3. 签名验证

   后台系统收到签名后，将其提交至安全验证机 Web 端。安全验证机通过服务端生成签名，并验证后台系统与服务端签名一致。

4. 通过钱包执行转账

   安全验证机 Web 端验证签名成功后，指示 Web3 钱包插件执行转账并上链。

5. 获取交易哈希

   Web3 钱包完成交易并返回交易哈希，安全验证机 Web 端获取哈希并保存。

6. 回调交易状态

   安全验证机 Web 端根据两种方式之一回调后台系统，更新交易哈希记录：

   • 直接通过 Web 端回调更新状态。
   • 安全验证机服务端代为回调，后台系统根据哈希状态进行更新。

7. 交易状态检查

   后台系统检查交易哈希的状态，并更新交易状态记录。

四、安全验证机签名流程​

1. 商户数据初始化

   后台系统审批商户时，记录商户信息（商户 ID、冷/热合约地址等），并提供查询和删除接口给安全验证机。

2. 安全验证机数据存储

   安全验证机请求后台的查询接口获取商户数据，存储为 JSON 文件，并向后台请求删除旧数据。

3. 定时任务同步数据

   使用 cron 定时任务定期请求安全验证机接口，自动更新商户的初始化数据。

五、全链路安全​

1. 服务器安全

   使用入侵检测系统和防火墙保护服务器，避免受到外部攻击。

2. 加密通信

   使用 HTTPS 和加密算法确保所有数据在传输过程中的安全性。

3. 防重放攻击

   利用区块链的机制，通过时间戳、nonce 或链上唯一标识符来防止重放攻击，确保每个交易请求在区块链上都是唯一且不可重复的。

4. 服务监控与预警

   定期检测系统健康状态，若出现异常及时告警并修复。

六、支付流程​

1. 加密支付链接

   商户系统生成支付链接时，使用签名加密参数，确保支付链接的合法性和安全性。

2. 支付信息验证

   在用户提交支付时，验证支付信息的签名和参数，确保请求来自合法商户。

3. 支付回调验证

   在支付完成后，商户系统再次验证回调中的支付数据，确保支付状态的准确性。

4. 支付接口控制

   设置 IP 限制和访问频率限制，防止接口被滥用。

七、Docker 部署与 Web 部署​

1. 简化 Docker 部署

   提供 Docker 镜像和配置文件，使商户能够轻松通过 Docker Compose 或 Kubernetes 部署服务。

2. Java Web 支持

   Web 端应用支持在 Tomcat 等常见 Java Web 服务器上运行，确保兼容性。

3. 服务自动扩展

   配置负载均衡和自动扩展，确保在流量高峰时服务能够扩展并保持稳定。

八、API 安全性​

1. 签名验证

   所有 API 请求需要使用签名机制，确保请求的合法性。

2. 加密数据传输

   所有 API 数据传输都使用 HTTPS 协议进行加密，确保数据不被篡改。

3. 访问控制

   限制 IP 地址访问和设置请求频率，防止恶意请求滥用接口。

4. 日志记录与审计

   对所有 API 调用进行日志记录，并定期审计，确保操作可追溯。

九、真实案例：某交易所被盗 15 亿美元​

2025 年 2 月，某国际头部交易所因签名流程缺乏隔离与校验机制，被攻击者通过“masked transaction”方式劫持签名流程，导致 15 亿美元资产被盗。

攻击者将前端展示地址与真实签名数据分离，冷钱包与多签机制未能识别伪造交易。

若部署安全验证机，可在签名前识别出参数篡改与伪装行为，从源头阻止资产外流。

总结​

安全验证机是 Web3 安全体系中的核心环节，尤其适用于具备以下需求的场景：

• 数字资产的多方管理与控制
• 需要链上转账的商户平台
• 需隔离业务系统与签名私钥的机构

通过签名比对、权限验证与审计机制，安全验证机可以有效防范伪造、越权、篡改等攻击，是构建高安全性数字资产系统的重要保障。

前置条件​

在开始修复订单前，请确保您已获取以下信息：

1. 订单号：需要修复的订单编号或者付款单号。
2. 交易 Hash：用户支付的交易哈希值（可通过区块链浏览器或支付平台查询）。

第一步：添加新员工钱包地址（可选）​

如需新员工协助修复订单，可添加其钱包地址：

1. 管理员登录后台

使用管理员账户登录后台系统。

2. 导航到机构信息

   • 点击 机构信息 > 成员。

• 在页面中选择 添加员工。

3. 填写员工信息

• 在 “添加员工” 页面输入员工钱包地址，例如：TEYrHyvsssn2Kw6McY9vA1hF2taiZaEjyQ。
• 提交后等待审批，审批通过后新员工地址将被添加至系统。

4. 完成添加

员工钱包地址成功添加后，可用于登录后台并执行订单修复操作。

第二步：登录后台并执行订单修复​

1. 登录后台系统

使用管理员地址或新增员工地址登录后台。

2. 进入对账中心-订单收款报表-订单修复页面

点击 订单收款报表 > 订单修复。

3. 查询订单

• 在订单修复页面输入用户支付的 交易 Hash 和 订单号。
• 点击 搜索。

4. 核对订单信息

系统会自动检测以下信息：

• 订单号检测：确认订单号是否匹配。
• 交易哈希检测：确认交易记录的有效性。
• 子合约检测：确认交易所属钱包是否正确。
• 币种与金额检测：确认交易金额和币种是否与订单一致。
• 交易时间检测：确认支付时间是否符合订单要求。

5. 修复订单

• 确认所有信息无误后，点击 订单修复。
• 系统将自动修复订单并发送回调通知。

全合约方案虽然具备高安全性，但其 Gas 成本优化一直是开发者面临的核心挑战之一。本文将探讨如何通过 合约工厂模版设计 和 紧打包内联汇编方案，大幅降低 Gas 成本并推动子合约在实际场景中的应用。

1. 合约工厂模版设计：动态生成与成本优化​

传统问题

传统合约部署需要为每个子合约单独部署完整代码，不仅 Gas 消耗高，还会导致链上冗余代码存储。为了解决这一问题，我们设计并采用了合约工厂模版的模式。

核心思想

合约工厂模版是一种通过预定义模版合约动态生成子合约的机制。通过将模版合约的地址映射到生成的子合约，可以实现代码的复用。这种设计有以下几个关键特点：

• 动态生成：工厂合约根据需求动态创建子合约，避免重复部署模版逻辑。
• 降低冗余：所有子合约共享同一个模版代码，显著减少链上存储成本。
• 节省 Gas：子合约生成只需传递少量参数，避免完整代码部署，降低 Gas 消耗。

实际应用场景

例如，在多签钱包的场景中，用户可根据交易需求动态生成子合约来执行任务。相比传统子合约方案，这种方式更加灵活、高效。这种机制的应用使得子合约替代传统的子合约解决方案成为可能。

2. 紧打包内联汇编：批量转账的极致优化​

转账操作是区块链中最常见且最耗 Gas 的场景之一。为进一步优化，我们采用了 紧打包内联汇编方案，通过减少交易报文体积和精简代码逻辑，有效降低 Gas 成本。

方案细节

1. 参数紧打包
   • 在链下约定使用最小字节数表示参数（如地址、金额等）。
   • 压缩参数存储大小，减少批量转账的报文体积。
2. 内联汇编优化
   • 转账逻辑中大量使用 EVM（Ethereum Virtual Machine）提供的内联汇编指令，这种低级操作直接操作 EVM 栈，避免了高级语言中的冗余开销。
3. 批量转账
   • 合并多笔转账为一次调用，减少交易次数，从而进一步降低总 Gas 消耗。

3. 实际应用效果​

Gas 成本降低

通过合约工厂模版与紧打包方案，测试结果显示：

• 合约部署与调用的 Gas 消耗相比传统方式降低约 70%-81%。

示例：子合约归集操作gas对比表

数据测试时间：2024年7月29日

提升用户体验

• 用户操作成本显著降低，Gas 费用减少。
• 高效链上逻辑使交易确认速度更快。

支持复杂场景

该优化方案特别适用于：

• 多签钱包
• 大型 DApp 批量操作
• 高频交互智能合约场景

通过合约工厂模版与紧打包内联汇编方案，我们不仅解决了 Gas 成本优化的难题，还为实际应用场景提供了更灵活高效的解决方案。未来，这一设计将在更多复杂区块链场景中发挥作用。

安全自托管是一种针对加密资产的全合约解决方案。通过该方案，商户能够完全掌控系统中的所有加密资产和权限，无需依赖任何第三方服务器或服务，同时确保多节点的安全性，避免因单点权限丢失而导致资金或数据损失。

在评估是否符合安全自托管标准时，需要重点考量以下两点：

1. 是否所有服务和节点均为商户所有，且拥有最高权限？​

传统解决方案以及基于多方计算（MPC）的方案，虽然支持源码级别的私有化部署，但仍然高度依赖常规服务器的安全性。然而，大多数商户缺乏高等级安全服务器的部署能力，自行实现 MPC 的部署可能带来额外的安全隐患。

2. 是否任何单一节点或服务器权限丢失都不会造成商户资金损失？​

在安全自托管方案中，服务模块和资产存管模块是相互独立的：

• 服务模块：依托 Web2 服务器，服务器权限丢失会造成资产损失，那么这种自托管方案不能被称为安全自托管，安全自托管的方案是服务模块和资产存管模块相互分离。
• 资产存管模块：通过全合约方案实现，与公链共享安全等级，并通过多签系统进行管理。即使所有服务器权限丢失，仍可通过高级管理员的多签权限进行恢复。

自托管方案的好处​

1. 杜绝外部攻击风险​

通过安全自托管，商户完全掌控资金和权限，不依赖外部第三方服务。即使服务器被黑客攻击，商户仍可独立运营，无需担忧因第三方漏洞或恶意行为导致的风险。

2. 杜绝内部作恶风险​

在以往加密资产托管方案中，如果遇到项目方遭到攻击或权限丢失，通常很难溯源，即分辨外部攻击与内部作恶，因为服务器运维环节，财务管理配置，高管权限设置等有诸多风险。PayProtocol 安全自托管方案将所有敏感资产操作记录链上，全面杜绝内部作恶行为。

3. 提供拓展性和定制化​

许多行业对系统功能性有集成开发要求。通过自托管，项目方可以根据具体需求定制系统，同时也能灵活满足业务发展的特殊需求。自托管方案通过去运维化设计，允许企业完全掌控系统运行状态，避免上述问题。

实现安全自托管的关键​

1. 全合约方案​

加密资产操作全部由智能合约进行管理，权限仅由项目方单方保管，确保操作安全。

2. 多签系统级配置​

采用多签系统级配置，不直接操作多签冷合约，减少频繁调用冷合约的风险与不便。

3. 严格的权限管理与隔离​

• 子合约资金只能转账到冷合约。
• 冷合约中的加密资产仅能通过超级管理员多签操作。

4. 持续监控与更新​

尽管是自托管方案，项目方仍需设计或集成自动化安全更新与监控机制。我们提供诸多检测脚本和预警模块，确保系统随时应对新出现的威胁。

这项安全的自托管方案使商户能够完全掌控其加密资产，同时确保最大的安全性和运营效率。

步骤一：计算归集操作所需能量​

示例场景：

1. 使用管理员钱包登录后台，发起归集操作。

   • 选择归集发起钱包进入签名界面。
   • 无需点击签名操作，直接查看交易所需能量总量。
   • 示例：系统显示能量总消耗为 132,233 能量。

   

步骤二：能量购买详细步骤​

添加并使用 TG 能量购买 Bot

1. 打开 Telegram 应用

   • 在搜索框输入 @nengliangvipBot，点击找到的能量购买机器人。

   

2. 点击 Bot 的 “RESTART” 按钮

   • 启动 Bot 功能，进入自助菜单页面。

   

3. 在菜单中选择 “租用能量”

   • 根据需求租用能量。

   

4. 选择交易笔数并进行换算

   • 1 笔交易 = 65,500 能量。
   • 例如：归集一笔交易需要 132,233 能量，计算为： 所需笔数= 132,233 / 65500 = 2.01
   • 大致需要购买 2 笔能量。

5. Bot 提供两种支付方式

   1. 方式一：直接转账支付

      • 根据 Bot 的价格表，选择所需笔数，获取 TRX 支付金额。
      • 示例：购买 2 笔能量需支付的总金额为 6 TRX（折合单价：49sun/笔）。

      

      • 复制 Bot 提供的支付地址（例如：TV5JYxy8GUjtjtg58aLnk7mxo8ZZZZZZZZ）。
      • 使用钱包向此地址转账，完成支付，在钱包查看能量。

      

   2. 方式二：通过选择笔数完成支付

      • 在菜单中选择交易笔数 “2 笔”。
      • 按 Bot 提示输入接收能量的钱包地址。

      

      • 使用 TRX 钱包支付，根据 Bot 生成的订单，完成支付。

      

6. 转账完成后等待到账

   • 支付完成后，等待约 6 秒。
   • 刷新钱包查看能量是否到账。

   

步骤三：使用管理员钱包完成操作​

执行后台操作

1. 使用管理员钱包登录后台。

2. 选择归集或其他需要能量支持的功能。

3. 确认能量已到账，按需完成对应操作。

   

注意事项​

1. 确保支付安全：仔细核对支付地址，避免转账错误。
2. 预留手续费：支付金额之外需留出足够 TRX 作为网络手续费。
3. 能量需求换算：根据实际交易需求合理选择笔数，避免购买不足或浪费。

通过以上步骤，您可以顺利完成能量购买并降低交易手续费！