Key components of WalletsNet

December 18, 2021

WalletsNet 由四个关键的组件组成，分别是：

• Participant Account，即网络的参与者账号，账号里面有一个非常重要的参数 —— Participant ID，一个由11位字母组成的ID，这是参与者在网络内的唯一标识，它的结构和 SWIFT Code类似，PID 是交易的重要参数。
• Settlement Account，即参与者的结算账户，该账户开设在与 WalletsNet 合作的结算行中，所有权归参与者所有，结算账户暂时无法在线设立，需要联系 WalletsClub 线下开设。结算账户设立后才可发起交易，否则交易会被拒绝。
• Connection，即交易对手方之间的互联互通关系，只有建立连接，交易报文才会被 WalletsNet 路由和转发，否则交易会被拒绝。
• Transceiver，即收发器，是一个运行在参与者服务器端的http服务，用于和 WalletsNet 的通讯。

了解了这四个组件，开发者就可以轻易的在 WalletsNet 上运行交易了，我们接下来分别详细介绍一下这四个组件。

1. Participant Account

注册成为 WalletsNet 的会员即可获得一个参与者账号，参与者账号分为三种类型：

• Direct Participant，即正式的直接参与者
• Indirect Participant，即正式的间接参与者
• Trial Participant，即试用参与者

新注册进来的账户的类型为「Trial Participant」，Trial Participant 可以：

• 在网络内设立一个 Sandbox 结算账户
• 和网络内的 Sandbox 对手方建立连接
• 和网络内的 Sandbox 对手方发生交易（收款或者付款）

Trial Participant 主要是用来体验、集成 WalletsNet 的各种流程，所有的交易都是在 sandbox 环境中完成，无法与其他参与者连接或者交易。

当 Trial Participant 已经完成了集成开发，并通过 WalletsNet 的验收后，则自动升级为 Direct Participant，此时就进入了生产环境，就可以和其他的直接参与者进行正常的连接和交易往来了。

快来注册体验一下吧：https://portal.walletsclub.com/portal-users/register

2. Settlement Account

结算账户是参与者开设在与 WalletsNet 合作的结算行中的账户，用来存放参与者的资金，该账户归参与者所有，由结算行为参与者提供资金托管的各项服务。

参与者可以：

• 向结算账户中充值，确保网络内的交易能够顺利的进行
• 从结算中户中提现
• 向结算行申请变更、注销结算账户等

WalletsNet 可以：

• 向结算行发送结算指令，在参与者的结算账户之间划转资金
• 向结算行发送查询指令，查询参与者结算账户的余额、状态等信息

为了方便参与者的集成和调试，WalletsNet 为参与者提供了一个模拟的结算行 —— ABank，所有参与者都可以在 WalletsNet 的 Dashboard 上自助开通一个模拟结算行的结算账户，获得模拟结算账户后，参与者可以任意的进行充值、提现等操作，也可以看到由 WalletsNet 触发的结算指令导致的余额变化。

3. Connection

WalletsNet 网络内的参与者之间并不是天然就可以互相通讯的，参与者A要想和参与者B进行交易，必须先建立 Connection，只有双方达成了互联互通的意愿，WalletsNet 才会在双边进行各种消息的转发。

建立连接的过程非常简单：

• 参与者A在 WalletsNet 的 dashboard 上查看可连接的所有参与者
• 参与者A通过点击「Connect」按钮向参与者B发送连接请求
• 参与者B收到连接请求的邮件推送后，即可开始和参与者A进行商务合作的谈判
• 达成合作意向后，参与者B在 WalletsNet 的 dashboard 上点击「Approve」即与参与者A建立了 Connection
• 参与者A或者参与者B在任何时刻都可以单方面取消 Connection，一旦Connection被取消，双方之间的所有通讯将被不会被转发，包括退款请求

为了方便开发者的集成和调试，我们为开发者提供了一个模拟参与者，在 Dashboard 上，你可以立刻与模拟参与者建立连接而无需任何额外流程，和模拟参与者的Connection建立后，就可以向它付款、收款啦！

4. Transceiver

收发器是一个运行在参与者服务器端的http服务，用于和 WalletsNet 的通讯，也是参与者的开发者最需要关注的，收发器有2个关键组成部分：

• 数据加解密，根据开发文档进行报文的加密和解密
• 异步处理报文，即收取来自 WalletsNet 的报文 -> 处理报文 -> 向 WalletsNet 发送反馈报文（如需）

在集成之前，开发者需要在 WalletsNet 的 Dashboard 上完成对收发器的设置：

• 根据 Dashboard 上的指引，生成公钥并上传
• 配置收发器的 webhook 地址，WalletsNet 会将报文转发至该地址

完成设置之后，开发者就可以根据 WalletsNet 的接入文档进行开发了，为了方便开发者在本地集成调试，我们为开发者提供了一个 CLI 工具，借助 CLI 工具进行本地的集成和开发，真的非常简单。关于 CLI 工具，我们专门有一篇Blog介绍 —— 《Introducing the WalletsNet CLI》

结束

太好了，到这里为止，相信你已经了解了：

• 如何获取一个 WalletsNet 的 Participant Account
• 如何开设一个用于体验和调试的 Settlement Account
• 如何和模拟参与者建立 Connection
• 什么是 Transceiver 以及如何配置

接下来，让我们开始通过 WalletsNet 完成我们的第一笔交易吧 —— Get start your first transaction!

没有账号？没关系，点击这里注册：https://portal.walletsclub.com/portal-users/register