Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# build spec

open-spec

# Dependencies
/node_modules

# Production
/build

# Generated files
.docusaurus
.cache-loader

# Misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local

npm-debug.log*
yarn-debug.log*
yarn-error.log*
package-lock.json
.vercel
.env*.local
1 change: 1 addition & 0 deletions .husky/pre-commit
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
lint-staged
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ pnpm install
pnpm build
```

这在首次克隆仓库时是必需的,因为它将[下载OpenRPC规范]((/docs/site/src/utils/getopenrpcspecs.js)),这是部署站点所必需的。
这在首次克隆仓库时是必需的,因为它将[下载 OpenRPC 规范]((/docs/site/src/utils/getopenrpcspecs.js)),这是部署站点所必需的。

接下来,使用以下命令将站点的开发预览部署到 `localhost:3000`:

Expand All @@ -28,17 +28,17 @@ pnpm start

完成更改后,再次运行 `pnpm build`,这将构建静态站点并将文件放置在 `site\build` 中。在提交更改进行审查之前运行此命令很重要,因为构建将在诸如坏的内部链接之类的错误上失败,并将错误原因显示到控制台。开发预览会忽略此类错误,以提供更灵活的环境。

Sui Foundation 无法提供本地构建文档站点的支持。如果遇到问题,请查阅 [Docusaurus文档](https://docusaurus.io/)。
Sui Foundation 无法提供本地构建文档站点的支持。如果遇到问题,请查阅 [Docusaurus 文档](https://docusaurus.io/)。

## 拉取请求

Sui使用Vercel来托管其文档站点。Vercel为每个提交到Sui仓库的拉取请求构建文档的预览。你可以在 Vercel 机器人的 PR 注释部分找到指向此预览的链接。点击 **Visit Preview** 链接以验证你的更改是否按你的期望进行。
Sui 使用 Vercel 来托管其文档站点。Vercel 为每个提交到 Sui 仓库的拉取请求构建文档的预览。你可以在 Vercel 机器人的 PR 注释部分找到指向此预览的链接。点击 **Visit Preview** 链接以验证你的更改是否按你的期望进行。

如果你想在准备好进行审查之前查看Vercel预览,那么[请将你的 PR 标记为草稿](https://github.blog/2019-02-14-introducing-draft-pull-requests/)。
如果你想在准备好进行审查之前查看 Vercel 预览,那么[请将你的 PR 标记为草稿](https://github.blog/2019-02-14-introducing-draft-pull-requests/)。

## 贡献

Sui是为社区而设。为了所有人的利益做出贡献。
Sui 是为社区而设。为了所有人的利益做出贡献。

- [文档贡献指南](https://docs.sui.io/references/contribute/contribution-process)
- [仓库贡献指南](https://docs.sui.io/contribute-to-sui-repos)
Expand All @@ -48,4 +48,4 @@ Sui是为社区而设。为了所有人的利益做出贡献。

## License

Sui文档在 [LICENSE](CC BY 4.0 license) 下分发。
Sui 文档在 [LICENSE](CC BY 4.0 license) 下分发。
2 changes: 1 addition & 1 deletion content/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar_label: 概览

import { Card, Cards } from '../site/src/components/Cards';

在Sui区块链上,标准是你可以扩展或自定义的功能、框架或应用程序。
在 Sui 区块链上,标准是你可以扩展或自定义的功能、框架或应用程序。

<Cards>
<Card title="Deepbook" href="standards/deepbook" />
Expand Down
38 changes: 19 additions & 19 deletions content/concepts/components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,23 @@
title: Sui 的组成部分
---

Sui 这个名称在英语中发音为 `swē`,源自日语中表示水元素的一个词汇。你可以在区块链的名称、其本地代币元素 (SUI和MIST) ,以及其品牌形象中看到这种影响。
Sui 这个名称在英语中发音为 `swē`,源自日语中表示水元素的一个词汇。你可以在区块链的名称、其本地代币元素 (SUI 和 MIST) ,以及其品牌形象中看到这种影响。

在本文档中,当提到Sui时,指的是构成该区块链系统的所有部分。这包括区块链本身、其各种网络(例如Mainnet)、区块链上的活动(交易块)、验证此活动的分布式实体(验证器)以及执行交易块的全节点。文档将所有这些元素的整体称为Sui平台,或简称Sui
在本文档中,当提到 Sui 时,指的是构成该区块链系统的所有部分。这包括区块链本身、其各种网络(例如 Mainnet)、区块链上的活动(交易块)、验证此活动的分布式实体(验证器)以及执行交易块的全节点。文档将所有这些元素的整体称为 Sui 平台,或简称 Sui

## Sui 区块链

Sui被定义为Layer 1协议的区块链。简而言之,这意味着Sui在其网络上使用自己的本地代币(在这种情况下是SUI)执行交易块(活动)的一致性和验证。以太坊(ETH)和比特币(BTC)是Layer 1区块链的其他示例
Sui 被定义为 Layer 1 协议的区块链。简而言之,这意味着 Sui 在其网络上使用自己的本地代币(在这种情况下是 SUI)执行交易块(活动)的一致性和验证。以太坊(ETH)和比特币(BTC)是 Layer 1 区块链的其他示例

相比之下,Layer 2区块链利用Layer 1网络的基础设施,依赖于Layer 1区块链来完成交易块。Polygon (MATIC) 是扩展以太坊的Layer 2区块链的一个示例
相比之下,Layer 2 区块链利用 Layer 1 网络的基础设施,依赖于 Layer 1 区块链来完成交易块。Polygon (MATIC) 是扩展以太坊的 Layer 2 区块链的一个示例

## SUI 代币

Sui的本地代币是SUI。每当文档提到SUI(全大写字母),都指的是这个代币。Sui上的交易块通常涉及到一个SUI值的小部分。为了更方便地处理这些交易块,Sui提供了MIST。一亿MIST等于一个SUI
Sui 的本地代币是 SUI。每当文档提到 SUI(全大写字母),都指的是这个代币。Sui 上的交易块通常涉及到一个 SUI 值的小部分。为了更方便地处理这些交易块,Sui 提供了 MIST。一亿 MIST 等于一个 SUI

一切都有成本,区块链交易也不例外。提供计算能力来处理交易块并存储其结果是需要花费的。处理交易块的成本术语是“gas”。你使用区块链的本地代币,这种情况下是SUI(或MIST),支付gas和存储数据的成本
一切都有成本,区块链交易也不例外。提供计算能力来处理交易块并存储其结果是需要花费的。处理交易块的成本术语是“gas”。你使用区块链的本地代币,这种情况下是 SUI(或 MIST),支付 gas 和存储数据的成本

要了解有关Sui代币经济学的更多信息,请参阅以下主题:
要了解有关 Sui 代币经济学的更多信息,请参阅以下主题:

- [Sui 代币经济学](./tokenomics.mdx)
- [Sui 代币](./tokenomics/sui-token.mdx)
Expand All @@ -27,29 +27,29 @@ Sui的本地代币是SUI。每当文档提到SUI(全大写字母),都指

## 委托权益证明共识

Sui使用委托权益证明(DPoS)共识机制来验证链上的交易块。这意味着Sui网络上的验证器必须在Sui Mainnet上拥有一定数量的SUI,可以是他们自己的资金,也可以是与Sui基金会合作,以证明他们对区块链安全性的兴趣。这种方法使所有验证器的兴趣与Sui用户的兴趣(高效、安全的区块链)保持一致,而无需像早期区块链那样对能源资源的高需求。
Sui 使用委托权益证明(DPoS)共识机制来验证链上的交易块。这意味着 Sui 网络上的验证器必须在 Sui Mainnet 上拥有一定数量的 SUI,可以是他们自己的资金,也可以是与 Sui 基金会合作,以证明他们对区块链安全性的兴趣。这种方法使所有验证器的兴趣与 Sui 用户的兴趣(高效、安全的区块链)保持一致,而无需像早期区块链那样对能源资源的高需求。

要了解有关Sui共识的更多信息,请参阅以下指南和主题:
要了解有关 Sui 共识的更多信息,请参阅以下指南和主题:

- [验证器委员会](guides/operator/validator-committee.mdx)
- [Sui全节点数据管理](guides/operator/data-management.mdx)
- [Sui 全节点数据管理](guides/operator/data-management.mdx)

## Sui 网络

Sui有几个网络可用,每个网络都具有不同的用途。
Sui 有几个网络可用,每个网络都具有不同的用途。

- **Mainnet:** 处理生产交易块的网络。当你交易SUI或最终基于法定货币的NFT时,你是在Sui的Mainnet网络上进行的
- **Testnet:** 作为一个分阶段网络,提供质量保证,确保对Sui的任何计划更改不会对性能产生不利影响。开发人员可以使用此网络在将其代码投入生产之前测试其代码。
- **Devnet:** 一个更不稳定的网络,用于开发新功能。开发人员可以利用此网络编写针对Sui最新计划功能的代码
- **Localnet:** 你可以在本地计算机上运行Sui网络。在受控制的环境中,使用本地网络进行开发提供了一种优化的工作流程。
- **Mainnet:** 处理生产交易块的网络。当你交易 SUI 或最终基于法定货币的 NFT 时,你是在 Sui 的 Mainnet 网络上进行的
- **Testnet:** 作为一个分阶段网络,提供质量保证,确保对 Sui 的任何计划更改不会对性能产生不利影响。开发人员可以使用此网络在将其代码投入生产之前测试其代码。
- **Devnet:** 一个更不稳定的网络,用于开发新功能。开发人员可以利用此网络编写针对 Sui 最新计划功能的代码
- **Localnet:** 你可以在本地计算机上运行 Sui 网络。在受控制的环境中,使用本地网络进行开发提供了一种优化的工作流程。

要了解有关这些网络以及如何与它们交互的更多信息,请参阅以下指南:

- [创建本地Sui网络](guides/developer/getting-started/local-network.mdx)
- [连接到Sui](guides/developer/getting-started/connect.mdx)
- [创建本地 Sui 网络](guides/developer/getting-started/local-network.mdx)
- [连接到 Sui](guides/developer/getting-started/connect.mdx)

## Move

Move语言为Sui上的所有活动提供逻辑,如交易NFT、玩Sui集成的游戏(dApps)以及所有其他基于交易的事件。Sui平台采用了早期区块链不同的概念,其中链上的块实际上是定义资产的对象,而不是定义地址的简单键值存储。对象固有的增强可编程性要求更强大的逻辑引擎,以最大程度地发挥这种区块链技术的新方法的好处。
Move 语言为 Sui 上的所有活动提供逻辑,如交易 NFT、玩 Sui 集成的游戏(dApps)以及所有其他基于交易的事件。Sui 平台采用了早期区块链不同的概念,其中链上的块实际上是定义资产的对象,而不是定义地址的简单键值存储。对象固有的增强可编程性要求更强大的逻辑引擎,以最大程度地发挥这种区块链技术的新方法的好处。

要了解有关Move的更多信息,请参阅 [Move概念](./sui-move-concepts.mdx)。
要了解有关 Move 的更多信息,请参阅 [Move 概念](./sui-move-concepts.mdx)。
8 changes: 4 additions & 4 deletions content/concepts/cryptography.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
title: 加密学
---

密码学的灵活性是Sui的核心。该系统支持多种密码算法和原语,并能够快速切换其中。使用Sui,你可以为你的系统选择合适的密码解决方案,并在最新算法推出时实施它们。
密码学的灵活性是 Sui 的核心。该系统支持多种密码算法和原语,并能够快速切换其中。使用 Sui,你可以为你的系统选择合适的密码解决方案,并在最新算法推出时实施它们。

Sui定义了其密码原语,如公钥、签名、聚合签名和哈希函数,都在一个统一的类型别名或枚举包装器下,这在整个存储库中是共享的。对这些原语进行更改会影响应用程序的所有组件。你可以快速更新应用程序的密码学,并确保统一的安全性。
Sui 定义了其密码原语,如公钥、签名、聚合签名和哈希函数,都在一个统一的类型别名或枚举包装器下,这在整个存储库中是共享的。对这些原语进行更改会影响应用程序的所有组件。你可以快速更新应用程序的密码学,并确保统一的安全性。

## 交易身份验证

Sui上的交易身份验证功能提供了对链上数据的未经授权访问的安全性。请参阅 [交易身份验证](./cryptography/transaction-auth.mdx) 以获取相关主题的概述。
Sui 上的交易身份验证功能提供了对链上数据的未经授权访问的安全性。请参阅 [交易身份验证](./cryptography/transaction-auth.mdx) 以获取相关主题的概述。

## zkLogin

zkLogin是Sui的一个原语,使你能够使用OAuth凭据从Sui地址发送交易,而不会公开地将两者关联。请参阅 [zkLogin](./cryptography/zklogin.mdx) 以了解有关该原语以及如何实施它的描述。
zkLogin 是 Sui 的一个原语,使你能够使用 OAuth 凭据从 Sui 地址发送交易,而不会公开地将两者关联。请参阅 [zkLogin](./cryptography/zklogin.mdx) 以了解有关该原语以及如何实施它的描述。
14 changes: 7 additions & 7 deletions content/concepts/cryptography/transaction-auth.mdx
Original file line number Diff line number Diff line change
@@ -1,26 +1,26 @@
---
title: 交易身份验证
description: 交易安全性可以说是区块链最重要的特性之一。Sui提供多种功能来保护你的交易,无论是在链上还是离线。
description: 交易安全性可以说是区块链最重要的特性之一。Sui 提供多种功能来保护你的交易,无论是在链上还是离线。
---

Sui上的交易身份验证功能提供了对链上数据的未经授权访问的安全性
Sui 上的交易身份验证功能提供了对链上数据的未经授权访问的安全性

## 密钥和地址

Sui遵循加密货币行业中广泛接受的钱包规范,包括BIP-32(及其变体SLIP-0010)、BIP-44和BIP-39,以便为用户提供密钥管理。目前,Sui支持纯Ed25519、ECDSA Secp256k1、ECDSA Secp256r1和多重签名用于签名的交易。查看 [密钥和地址](./transaction-auth/keys-addresses.mdx) 以了解更多信息。
Sui 遵循加密货币行业中广泛接受的钱包规范,包括 BIP-32(及其变体 SLIP-0010)、BIP-44 和 BIP-39,以便为用户提供密钥管理。目前,Sui 支持纯 Ed25519、ECDSA Secp256k1、ECDSA Secp256r1 和多重签名用于签名的交易。查看 [密钥和地址](./transaction-auth/keys-addresses.mdx) 以了解更多信息。

## 签名

密码学的灵活性是Sui的核心。该系统支持多种密码算法和原语,并能够在它们之间快速切换。使用Sui,你可以为你的系统选择合适的密码学解决方案,并在最新算法可用时实施它们。查看 [签名](./transaction-auth/signatures.mdx) 以了解更多信息。
密码学的灵活性是 Sui 的核心。该系统支持多种密码算法和原语,并能够在它们之间快速切换。使用 Sui,你可以为你的系统选择合适的密码学解决方案,并在最新算法可用时实施它们。查看 [签名](./transaction-auth/signatures.mdx) 以了解更多信息。

## 多重签名

Sui支持多重签名(multisig)交易,这需要多个密钥进行授权,而不是单一的单键签名。查看 [多重签名](./transaction-auth/multisig.mdx) 以了解更多信息。
Sui 支持多重签名(multisig)交易,这需要多个密钥进行授权,而不是单一的单键签名。查看 [多重签名](./transaction-auth/multisig.mdx) 以了解更多信息。

## 离线签名

Sui支持离线签名,即使用未连接到Sui网络的设备签署交易,或者在使用不依赖于Sui密钥存储的不同编程语言实现的钱包中签署交易。查看 [离线签名](./transaction-auth/offline-signing.mdx) 以了解更多信息。
Sui 支持离线签名,即使用未连接到 Sui 网络的设备签署交易,或者在使用不依赖于 Sui 密钥存储的不同编程语言实现的钱包中签署交易。查看 [离线签名](./transaction-auth/offline-signing.mdx) 以了解更多信息。

## 意图签名

在Sui中,意图是一个紧凑的结构,充当签名承诺的消息的域分隔器。签名承诺的数据是一个意图消息。Sui中的所有签名都必须承诺一个意图消息,而不是消息本身。查看 [意图签名](./transaction-auth/intent-signing.mdx) 以了解更多信息。
在 Sui 中,意图是一个紧凑的结构,充当签名承诺的消息的域分隔器。签名承诺的数据是一个意图消息。Sui 中的所有签名都必须承诺一个意图消息,而不是消息本身。查看 [意图签名](./transaction-auth/intent-signing.mdx) 以了解更多信息。
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ const signature = await this.signData(intentMessage);
在底层,Rust 中的 `new_secure` 方法和 TypeScript 中的 `signData` 方法执行以下操作:
1. 将意图消息序列化为包含 3 字节意图和交易数据的 BCS 序列化字节的连接。
1. 应用 Blake2b 哈希以获取 32 字节摘要。
1. 将摘要传递给签名 API,对应于签名者的每个支持的方案。支持的签名方案有纯 Ed25519、ECDSA Secp256k1 和 ECDSA Secp256r1。请查看[Sui签名](./signatures.mdx#signature-requirements)以获取每种方案的要求。
1. 将摘要传递给签名 API,对应于签名者的每个支持的方案。支持的签名方案有纯 Ed25519、ECDSA Secp256k1 和 ECDSA Secp256r1。请查看[Sui 签名](./signatures.mdx#signature-requirements)以获取每种方案的要求。

## 权威签名

Expand Down
Loading