SuiClient,您应用的'邮局职员'
- 受众。 刚接触 Sui 区块链的开发者。
- 先决条件。 具备区块链概念、钱包和交易的基础知识。
- 目标。 理解
SuiClient在应用架构中的作用。
简介
您的应用无法直接连接到 Sui 区块链。Sui TypeScript SDK 提供了一个用于网络请求的客户端。
SuiClient 是 Sui TypeScript SDK 中用于此目的的主要接口。
邮局类比
Sui 架构遵循与邮局相同的请求流程:
- 您的应用 扮演客户的角色。
SuiClient扮演柜员的角色。- 远程过程调用(RPC)端点 将柜员与正确的邮局连接起来。
应用程序将请求交给柜员。柜员将请求发送至网络,并将响应返回给应用程序。
- 图片
- 代码
- ASCII
flowchart LR
A["您的应用<br/>(客户)"] -->|请求服务| B("SuiClient<br/>(柜员)")
B -->|处理请求| C["Sui网络节点<br/>(邮政系统)"]
C -->|交付结果| B
B -->|移交物品| A
┌──────────────┐ 请求服务 ┌──────────────┐ 处理请求 ┌──────────────────┐
│ 您的应用 │─────────────►│ SuiClient │─────────────►│ Sui 网络节点 │
│ (客户) │◄─────────────│ (柜员) │◄─────────────│ (邮政系统) │
└──────────────┘ 移交物品 └──────────────┘ 交付结果 └──────────────────┘
连接网络
一名柜员在一家分支机构工作。客户端通过 RPC 端点连接到一个网络。
在创建客户端时选择一个网络:
| 网络 | 描述 | 用例 |
|---|---|---|
| 主网 | 正式生产网络。资产具有货币价值。 | 生产环境应用。 |
| 测试网 | 公共测试网络。与 主网 版本同步。 | 预发布和集成测试。 |
| 开发网 | 开发人员会频繁重置的实验性网络。 | 快速原型设计和公开测试。 |
| Localnet | 在您的机器上运行的本地测试网络。 | 离线开发和测试。 |
核心功能
SuiClient 支持读取操作和写入操作。这两种操作在应用设计中各司其职。
1. 读取操作 (查询)
这是用于查询账本上现有数据的请求。
- 成本。 无需 gas 费用。
- 安全性。 无需钱包签名。
- 机制。 客户端查询节点的本地数据库并返回结果。
- 示例:
getObject():获取非同质化代币(NFT)的元数据。getBalance():查询钱包余额。
2. 写入操作(交易)
这些是用于更改账本状态的请求。
- 成本。 Gas 费用需要 Sui 代币。MIST 是 Sui 的最小单位。
- 安全性。 该操作需要用户钱包的加密签名。
- 机制。 客户端通过 RPC 全节点提交已签名的交易。全节点将交易转发给验证者进行处理和达成共识。
- 示例:
- 转账。
- 创建 NFT。
- 修改链上游戏数据。
后续步骤
现在您已经了解了该架构,下一步是执行 读取操作。下一份指南 如何获取对象数据 提供了一个脚本,用于从 Sui devnet 查询实时数据。