快速入门前置条件
本文目录1. 注册商户账号1.1 点击登录按钮1.2 拉起钱包登录1.3 点击签名2. 部署 V4 分账钱包合约2.1 在控制台中，导航至 EOA Accounts，部署一个 V4 分账钱包合约(Split Wallet)：2.2 在控制台中点击 Create Account2.3 填写分账合约的信息2.4 点击确认创建合约2.5 点击签名部署合约交易2.6 等待部署合约交易完成2.7 合约部署完成3. 下载MPC Client并激活合约3.1 下载适合你操作系统的 MPC Client3.2 激活 Split Wallet3.3 为Split Wallet批量创建地址4. 简单的测试合约4.1 回到商户系统，查看合约信息4.2 创建1个订单测试收款功能4.3 归集资金4.4 提现资金5. 创建 API Key6. 记录您的分账钱包地址

前置条件 ​

在接入 HashNut V4 之前，请完成以下准备工作。

1. 注册商户账号 ​

在 HashNut 控制台（或 测试网 用于测试）注册账号。使用您的 Web3 钱包（MetaMask,TronLink等）进行身份验证。

1.1 点击登录按钮 ​

img

1.2 拉起钱包登录 ​

img

1.3 点击签名 ​

img

2. 部署 V4 分账钱包合约 ​

2.1 在控制台中，导航至 EOA Accounts，部署一个 V4 分账钱包合约(Split Wallet)： ​

img

2.2 在控制台中点击 Create Account ​

img

2.3 填写分账合约的信息 ​

img

2.4 点击确认创建合约 ​

img

2.5 点击签名部署合约交易 ​

img

wait-transaction-confirm.png

2.6 等待部署合约交易完成 ​

img

2.7 合约部署完成 ​

img

3. 下载MPC Client并激活合约 ​

3.1 下载适合你操作系统的 MPC Client ​

  • 去下面的地址下载适合你操作系统的 MPC Client
https://github.com/nuttybounty/hashnut-mpc-client/releases
  • 下载MPC Client

img

  • 解压缩

img

!!! 注意 如果你的系统是MACOS 你可能还需要执行如下命令绕开 MacOS 的安全拦截

shell
xattr -cr mpc-gui
  • 设置你的MPC Client密码

img

!!! 注意 请妥善保管该密码，丢失后将无法找回

  • 首次运行遇到提示是正常现象，请点击确定 img

  • 选择链然后输入你部署合约的钱包私钥

img

!!! 注意 默认是evm，如果你希望使用波场，请点击下拉框选择tron

img

3.2 激活 Split Wallet ​

  • 首次运行遇到提示是正常现象，点击确认即可 img

  • 点击激活分账合约 img

  • 分账合约成功激活 img

  • 激活后可以看到日志

正在查询激活状态...
正在通过 MPC keygen 生成 Split Wallet Manager...
Manager 生成成功: 0xdd73525d9bee2731c812f2d011f777e1b17f4970
注册 manager 到服务端...
正在构造并发送 activate 交易...
activate 交易已发送: 0x981591feffd713df189e26140bb3294b636d8deeea9fd52c5efae2ad549c18db
  浏览器: https://etherscan.io/tx/0x981591feffd713df189e26140bb3294b636d8deeea9fd52c5efae2ad549c18db
激活交易已提交，服务端将在链上确认后自动完成激活
  • 可以复制交易链接去确认合约已经激活
https://etherscan.io/tx/0x981591feffd713df189e26140bb3294b636d8deeea9fd52c5efae2ad549c18db

3.3 为Split Wallet批量创建地址 ​

  • 开始批量创建 img

  • 确认gas费信息 img

  • 看到如下日志则表示地址已经添加并创建完成

text
0x57c1db183091e92c636be0118dcf66d65d6258f0b0e593fe39cef6eb70863870
  等待链上 addReceiptWallets 确认...
[4/5] 10 个地址已激活 (ACTIVE)

img

4. 简单的测试合约 ​

4.1 回到商户系统，查看合约信息 ​

img

  • 可以看到刚才创建的地址信息 img

4.2 创建1个订单测试收款功能 ​

  • 进入订单创建页面 img

  • 点击创建订单 img

  • 输入订单参数 img

  • 订单创建成功 img

  • 跳转到支付页面 img

  • 支付订单 img

  • 订单确认中 img

  • 订单成功 img

4.3 归集资金 ​

  • 查询资金归集信息 img

  • 开始归集 img

  • 确认归集手续费 img

  • 归集完成 img

4.4 提现资金 ​

  • 查询提现信息 img

  • 提现资金 img

  • 提现完成 img

  • 查看提现信息 img

5. 创建 API Key ​

  • 进入创建API Key 界面 img

  • 创建API Key img

  • 填写参数 img

  • 签名消息添加apikey img

  • 保存api key信息 img

字段说明
Bind IP服务器 IP 白名单。开发环境可使用 * 表示任意 IP
Notify URL支付通知的 Webhook 地址
Callback URL支付完成后的前端跳转地址

创建后您将获得：

  • accessKeyId — 标识您的商户账号
  • secretKey — 用于 HMAC-SHA256 请求签名

DANGER

切勿在前端代码或公开仓库中暴露您的 secretKey。

6. 记录您的分账钱包地址 ​

每个订单都需要一个 splitterAddress —— 即您在 EOA Accounts 中的 V4 分账钱包合约地址。

  • 检查清单
  • [ ] 商户账号已创建
  • [ ] V4 分账钱包已部署并激活
  • [ ] 已获取 accessKeyId 和 secretKey 的 API Key
  • [ ] Webhook 端点已就绪