OnFinality
新用户订阅 RPC,首月享 6.5 折优惠查看优惠
RPC Assistant

Sui Docs:在哪里查找 SDK、Move、RPC 和节点参考资料

摘要

# Sui Docs:在哪里查找 SDK、Move、RPC 和节点参考资料

官方 Sui 文档位于 docs.sui.io,是构建 Sui 应用的最佳起点。文档围绕入门、Move 开发、链上应用、Sui 技术栈、API 和 SDK 参考、节点运行以及数据管理组织内容。具体路径取决于你是在学习对象模型、部署 package、查询数据,还是运行基础设施。

对于应用开发,建议先阅读官方 Sui TypeScript SDK 文档和 Move 资源,然后选择用于网络访问的 RPC API。Sui 当前的工具链和 API 接口可能会发生变化,因此应将旧版 JSON-RPC 示例视为具有版本依赖,并在当前 SDK 和服务提供商文档中确认受支持的方法。当项目需要托管访问或对节点环境拥有更多控制权时,OnFinality 可以提供 RPC API 或专用节点基础设施选项。

本页面将 Sui 的主要文档路径映射到实际开发决策中,同时说明如何验证端点,而不假设通用的 Ethereum JSON-RPC 工作流同样适用于 Sui。

关键要点

  • 将 docs.sui.io 作为当前 Sui 开发、API 和节点运行文档的主要来源。
  • 在设计交易和 package 工作流之前,先学习 Move 和对象模型相关内容。
  • 使用 Sui TypeScript SDK 进行客户端查询、交易构建、签名及相关操作。
  • 将较旧的 JSON-RPC 示例视为具有版本依赖,并在实现前验证当前 API 是否支持。
  • 应用访问可选择托管 RPC API;如果需要运维控制和隔离,则应评估专用节点。
  • 在投入生产前,分别测试读取、交易提交、错误处理和网络身份。

从与任务匹配的文档路径开始

Sui 文档内容广泛,如果只搜索一个孤立的 RPC 示例,可能会从错误的起点开始。先使用下方的任务映射,再进入相关参考资料。对于协议行为、CLI 命令、Move framework 细节和当前 SDK 指引,官方文档是权威来源。

Sui TypeScript SDK 文档对应用开发者尤其有用,其中涵盖安装、模块化 package、网络位置、客户端、密钥对、交易以及 faucet 相关工具。SDK 不能替代对 Sui 对象模型的理解:交易设计、所有权、共享对象和可编程交易仍然需要通过概念性文档学习。

对于基础设施团队,节点运营和数据管理部分比应用教程更相关。这些内容介绍运行 Sui 全节点所涉及的职责和组件,而 RPC 提供商可以为应用团队减少部分运维工作。

  • 学习 Sui 或 Move:从 Getting Started、Move 和对象模型相关内容开始。
  • 构建 TypeScript 应用:使用当前的 Sui TypeScript SDK 及其客户端参考。
  • 部署 package:结合 package、环境、gas、发布和升级文档进行操作。
  • 查询或索引数据:先阅读 API 参考,然后评估普通 RPC 读取是否足以满足所需的历史数据和数据量。
  • 运行基础设施:使用全节点、验证者和数据管理文档,而不是只参考应用示例。
标准检查内容为什么重要
主要任务从这里开始避免混淆应用、协议和节点运行说明
Move package 开发Move 语言、package、对象和交易文档Sui 以对象为中心的执行模型会影响 package 和交易设计
客户端集成当前 TypeScript SDK 客户端和交易参考SDK 抽象了请求构建,并提供 Sui 专用工具
RPC 或节点访问当前 API 参考以及提供商或全节点文档端点可用性和方法支持可能因 API 版本和提供商而异

决策指南:托管 RPC、专用节点,还是自行运行节点?

当当前需求是应用连接——读取对象、检查交易、提交已签名交易,或在不承担节点部署和维护工作的情况下支持服务——请选择托管 RPC API。在实现前,确认方法、数据保留、身份验证模式、请求策略、受支持的传输协议。

专用节点与单纯提高请求额度是不同的选择。当工作负载需要单独管理的环境、对配置拥有可预测的所有权、与无关租户隔离,或需要发展专用数据服务时,专用节点可能更合适。应明确记录这些要求,并与基础设施提供商进行验证。

当协议参与、本地数据控制、自定义集成或运营独立性足以证明存储、升级、监控、同步和事故响应成本合理时,可以运行自己的全节点。资源和版本要求应以官方 Sui 节点文档为准,不要从其他链的节点架构推断。

  • 使用 RPC API,获得应用访问 Sui 网络数据的最短路径。
  • 当工作负载隔离或基础设施所有权比最简单的配置更重要时,评估专用节点。
  • 只有在考虑同步、存储、升级、安全和 on-call 职责后,才选择自行运行的基础设施。
  • 在应用中保留提供商抽象层,使端点变更无需重写交易逻辑。
标准检查内容为什么重要
托管 RPC API受支持的方法、身份验证、请求策略、数据范围和传输协议适合需要网络访问但不想运行节点的团队
专用节点基础设施隔离、配置所有权、支持边界和数据要求当共享服务不符合工作负载的运维约束时很有用
自行运行的全节点硬件、存储、升级、监控、备份和事故处理流程提供更多控制权,但会将持续的运维责任转移给你的团队

开发者应区分的 Sui SDK 和 RPC 概念

Sui TypeScript SDK 是客户端库,而不是网络本身。它帮助应用构建请求、处理 Sui 数据类型、构建交易,并与配置好的网络位置交互。客户端背后的 RPC 服务仍然决定可用的 API 方法、限制、历史数据和提交行为。

未经模型和 API 检查,不应直接照搬 Ethereum 教程中的 Sui 示例。Sui 使用 Move 和面向对象的资产模型,其交易工作流包含对象输入、gas 对象、可编程交易块和 package 发布等 Sui 专用概念。在其他生态中语法有效的请求,对于 Sui 可能在概念上是错误的。

当前 SDK 文档列出了网络位置和客户端设置示例。在生产环境中,应将开发配置替换为所选 RPC 提供商提供的端点和凭据,并将密钥置于源代码管理之外。

  • 固定兼容的 SDK 版本,并在升级前查看发行说明。
  • 在配置中明确选择网络,而不是将其硬编码到业务逻辑中。
  • 尽可能将读取客户端与交易签名代码分离。
  • 将私钥、API token 和签名材料视为具有不同访问控制的独立机密。
标准检查内容为什么重要
SDK 职责客户端构建、序列化、交易构建和签名辅助工具这些是由库实现的应用层职责
RPC 职责请求处理、方法支持、访问控制和数据可用性端点是应用必须监控的外部依赖
应用职责重试、幂等性、错误分类、密钥安全和可观测性提供商访问并不会消除安全应用行为的必要性

配置端点时不要假设存在公共 URL

OnFinality 的 Sui repository 配置没有提供 chainInfo.rpcUrls 值。因此,本文不会发布猜测的公共端点。请使用当前的 Sui 网络页面或 OnFinality 账户获取适用的 RPC URL 和凭据,然后通过环境变量注入。

即使不使用具体占位符,配置模式仍应清楚体现必要的边界。端点应属于部署配置,而 SDK 客户端负责 Sui 专用请求。具体客户端构造函数和受支持的方法应遵循当前官方 SDK 文档的版本。

  • 将 RPC URL 存储在机密或部署环境变量中,而不是提交到 repository。
  • 部署生产流量时,确认端点指向 Sui Mainnet;不要复用 testnet 配置。
  • 将 SDK 版本、提供商端点和网络环境一起记录,以实现可复现发布。
  • 添加启动检查,在接受应用流量前验证网络身份。
标准检查内容为什么重要
端点来源当前 OnFinality Sui 服务配置或账户控制面板避免依赖过时或非官方 URL
环境选择Mainnet、testnet、本地网络或其他明确受支持的环境不同环境中的地址和数据不可互换
凭据身份验证格式和机密存储策略错误的请求头或暴露的 token 可能阻止请求或造成安全风险

可复现的 Sui RPC 验证工作流

在调试应用逻辑前先验证连接。首先执行提供商支持的低成本读取,确认响应格式,然后测试具有代表性的对象或交易查询。不要将成功的 HTTP 响应视为所有 Sui 方法或历史查询都可用的证明。

对于交易工作流,在受支持的情况下,将模拟或检查、签名、提交以及后续状态获取作为独立步骤进行测试。记录请求 ID,并按身份验证、传输、方法支持、输入验证、速率策略或网络状态对失败进行分类。这样更容易诊断提供商变更和 SDK 升级问题。

实用的监控探针应使用已知安全的读取,并同时针对传输失败和异常响应结构发出告警。不要使用 faucet 请求、package 发布或交易提交作为健康检查。

  • 从应用使用的同一区域或运行时检查 DNS 和 TLS 连接。
  • 将身份验证与 payload 验证分开确认。
  • 确认返回的网络身份并检查响应 schema。
  • 按方法测量错误率和响应时间,而不是使用一个聚合数值。
  • 使用带退避的有界重试,不要盲目重试非幂等提交。
  • 只有在应用能够安全处理方法支持和数据新鲜度差异时,才配置第二个端点。
标准检查内容为什么重要
失败症状401、403 或与身份验证相关的响应请求可能尚未到达方法验证阶段
失败症状方法未找到或旧版 API 错误示例可能针对旧版 Sui API,或提供商不支持该方法
失败症状无效对象、交易或参数错误端点可能正常工作,但 Sui 专用 payload 不正确
失败症状超时、网关错误或间歇性传输失败应分别调查网络路径、请求大小、重试行为和提供商状态

文档维护和生产交接

Sui 文档具有版本依赖。每次发布前,检查官方文档、SDK package 文档、repository 发行说明以及所选提供商的方法参考。特别关注 API 弃用、交易格式、package 升级和节点配置相关的变更。

维护一份内部运行手册,其中包含网络名称、端点来源、SDK 版本、受支持的方法、重试策略、升级路径和回滚流程。在评估商业化或多网络扩展时,链接到规范的 OnFinality RPC pricing 和 supported RPC networks 页面。

如果应用从简单读取扩展到索引、分析或高吞吐交易工作流,应重新评估架构,而不是假设普通 RPC 连接就是完整的数据管道。托管 RPC API、专用节点基础设施和专用索引层解决的是不同问题。

  • SDK 或协议升级后,重新验证端点和方法假设。
  • 记录工作负载是否需要当前状态、历史数据、订阅、trace 或索引。
  • 为提供商配置指定负责人,并为签名安全指定独立负责人。
  • 在增加更多端点或专用基础设施前,审查成本和运维权衡。
  • 协议事实使用官方 Sui 文档,服务特定行为使用提供商文档。
标准检查内容为什么重要
当前状态应用RPC 读取、交易提交和基本可观测性托管 API 可能足以覆盖初始集成
数据密集型应用历史数据、分页、索引和保留要求仅 RPC 访问可能无法提供所需的查询模型
基础设施采购方隔离、支持边界、故障转移设计和总运维工作量价格最低的端点不一定是运维最简单的选择

常见问题

官方 Sui 文档在哪里?

主要文档位于 docs.sui.io,其中包括入门资料、Move 和应用开发、SDK 与 API 参考、Sui Stack 组件、全节点运行以及数据管理指南。

作为 TypeScript 开发者,我应该先阅读哪些 Sui 文档?

从官方 Sui TypeScript SDK 文档及其安装、客户端、网络位置、交易和密钥对部分开始。同时阅读 Sui 对象模型和交易概念,确保代码符合 Sui 的执行模型。

Sui 是否使用与 Ethereum 相同的 JSON-RPC 工作流?

不使用。Sui 拥有自己的数据模型、基于 Move 的编程环境、交易结构和 API 约定。旧版 JSON-RPC 示例也可能具有版本依赖,因此应在官方 SDK 和提供商文档中验证当前方法支持情况。

我应该运行 Sui 全节点,还是使用 RPC 提供商?

如果主要需求是应用访问,且不希望运行节点基础设施,请使用托管 RPC API。当隔离、配置控制、本地数据或运营独立性足以证明额外责任合理时,可考虑专用节点或自行运行的全节点。

如何从 OnFinality 获取 Sui RPC 端点?

从 OnFinality Sui 网络页面或账户配置开始,获取当前端点和身份验证详情。端点应通过部署配置注入,而不是从未经验证的公共示例中复制。

RPC 知识库

相关 RPC 内容

RPC 提供商选择Ethereum

如何评估用于性能监控的以太坊 RPC 服务

选择用于性能监控的以太坊 RPC 服务,需要超越单纯的吞吐量。你需要一致的延迟、可靠的 WebSocket 连接,以及访问 debug 或 trace 方法以诊断问题。本文概述了需要跟踪的关键指标、重要的方法,以及如何构建一个能在用户发现问题之前捕获问题的监控设置。...

网络 RPCTON

关于TON RPC端点,我需要了解什么?

# 关于TON RPC端点,我需要了解什么? TON RPC端点之所以重要,是因为Web3应用依赖于稳定的端点访问来进行读取、交易、仪表盘和后端工作流。正确的设置应匹配你的工作负载,支持你所需的网络和测试网,使限制可见,并在共享RPC不再足够时提供扩展路径。 对于TON构建者、基础设施负责人、DeF...

网络 RPCArbitrum

Arbitrum 公共 RPC:端点、链设置和提供商选择

Arbitrum One 和 Arbitrum Sepolia 的公共 RPC 端点让开发者无需运行节点即可连接钱包和 dApp。本文涵盖官方端点、链设置,以及如何评估公共与托管 RPC 提供商以用于生产工作负载。...

RPC 提供商选择Solana

如何为NFT数据API选择Solana RPC提供商

为NFT数据API选择合适的Solana RPC提供商,意味着要在读取密集型工作负载、WebSocket订阅以及可靠的getAsset和getAssets响应之间取得平衡。本指南介绍了需要评估的要素——从速率限制、归档数据到专用节点——以便您将基础设施与您的市场、钱包或分析用例相匹配。...

网络 RPCAcala

什么是Acala Network,如何连接?

Acala Network是基于Polkadot构建的去中心化金融(DeFi)中心,提供跨链流动性、流动性质押和EVM兼容的智能合约平台。本指南涵盖Acala的架构、如何通过RPC端点连接,以及开发者在Acala上构建时的关键考量。...

RPC 提供商选择Solana

有哪些可靠的服务提供用于Solana质押的API访问?

可靠的Solana质押API服务提供编程访问,用于在Solana网络上进行质押、解除质押和管理奖励。顶级选项包括Blockdaemon Staking API、Helius Staking API和Figment Staking API。选择提供商时,评估正常运行时间保证、支持的操作、用于实时更新的...

永远不用担心基础设施

OnFinality 消除了 DevOps 的繁重工作,让您能够更聪明、更快地构建。

开始