跳到主要内容

SuiClient,您应用的'邮局职员'

  • 受众。 刚接触 Sui 区块链的开发者。
  • 先决条件。 具备区块链概念、钱包和交易的基础知识。
  • 目标。 理解 SuiClient 在应用架构中的作用。

简介​

您的应用无法直接连接到 Sui 区块链。Sui TypeScript SDK 提供了一个用于网络请求的客户端。

SuiClient 是 Sui TypeScript SDK 中用于此目的的主要接口。

邮局类比​

Sui 架构遵循与邮局相同的请求流程:

  • 您的应用 扮演客户的角色。
  • SuiClient 扮演柜员的角色。
  • 远程过程调用(RPC)端点 将柜员与正确的邮局连接起来。

应用程序将请求交给柜员。柜员将请求发送至网络,并将响应返回给应用程序。

SuiClient 架构截图

连接网络​

一名柜员在一家分支机构工作。客户端通过 RPC 端点连接到一个网络。

在创建客户端时选择一个网络:

网络描述用例
主网正式生产网络。资产具有货币价值。生产环境应用。
测试网公共测试网络。与 主网 版本同步。预发布和集成测试。
开发网开发人员会频繁重置的实验性网络。快速原型设计和公开测试。
Localnet在您的机器上运行的本地测试网络。离线开发和测试。

核心功能​

SuiClient 支持读取操作和写入操作。这两种操作在应用设计中各司其职。

1. 读取操作 (查询)​

这是用于查询账本上现有数据的请求。

  • 成本。 无需 gas 费用。
  • 安全性。 无需钱包签名。
  • 机制。 客户端查询节点的本地数据库并返回结果。
  • 示例:
    • getObject():获取非同质化代币(NFT)的元数据。
    • getBalance():查询钱包余额。

2. 写入操作(交易)​

这些是用于更改账本状态的请求。

  • 成本。 Gas 费用需要 Sui 代币。MIST 是 Sui 的最小单位。
  • 安全性。 该操作需要用户钱包的加密签名。
  • 机制。 客户端通过 RPC 全节点提交已签名的交易。全节点将交易转发给验证者进行处理和达成共识。
  • 示例:
    • 转账。
    • 创建 NFT。
    • 修改链上游戏数据。

后续步骤​

现在您已经了解了该架构,下一步是执行 读取操作。下一份指南 如何获取对象数据 提供了一个脚本,用于从 Sui devnet 查询实时数据。