Skip to content

Commit

Permalink
docs: Migrate mandarin docs (#849)
Browse files Browse the repository at this point in the history
* deflation_update_outdated_info.md

* Adding Hacken and HP to security providers list

* fix_caution

* ecosystem_auditors_fix

* Fix wallet-list-2.json redirect (#843)

* docs(i18n): migrate Mandarin documentation for concepts dir

* docs(i18n): migrate Mandarin documentation for contribute dir

* docs(i18n): migrate Mandarin documentation for documentation dir

* docs(i18n): migrate Mandarin documentation for guidelines dir

* docs(i18n): migrate Mandarin documentation for guidelines/smart-contracts dir

---------

Co-authored-by: AlexG <39581753+reveloper@users.noreply.github.com>
Co-authored-by: dorsky <139157644+dorsky@users.noreply.github.com>
Co-authored-by: Sherbek <91262758+SherbekMavlonov@users.noreply.github.com>
  • Loading branch information
4 people authored Nov 13, 2024
1 parent 5a2e724 commit 2ca4954
Show file tree
Hide file tree
Showing 182 changed files with 38,565 additions and 168 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# 教育资源

## TON 区块链课程

:::danger
页面正在开发中.
:::

## 参见

- [TON 速成](https://tonspeedrun.com/)
- [TON Hello World](https://tonhelloworld.com/01-wallet/)
- [[YouTube]TON 开发研究 EN ](https://www.youtube.com/@TONDevStudy)[[RU]](https://www.youtube.com/results?search_query=tondevstudy)
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
import Player from '@site/src/components/player'
import Button from '@site/src/components/button'

# 开放网络

**开放网络 The Open Network(TON)** 是一个由多个组成部分构成的去中心化和开放的互联网平台。这些组成部分包括:TON 区块链、TON DNS、TON 存储和 TON 网站。TON 区块链是连接 TON 底层基础设施的核心协议,从而形成更大的 TON 生态系统。

TON 致力于实现广泛的跨链互操作性,同时在高度可扩展的安全框架内运行。TON 的设计用于处理每秒数百万笔交易(TPS),目标是最终达到数亿用户的采用。

**TON 区块链** 被设计为一个分布式超级计算机,或称为“超级服务器”,旨在提供各种产品和服务,以助力新互联网的去中心化愿景的发展。

- 通过查看此部分了解 TON 为其用户提供的服务:[参与 TON](/participate/)
- 通过查看此部分了解 TON 区块链的技术方面 [区块链的区块链](/learn/overviews/ton-blockchain)
- 通过查看此部分了解有关 TON 的所有事务的发展:[开始使用](/develop/overview)

## 概览

要理解去中心化互联网的真正愿景以及 TON 如何对此不可避免地做出贡献,请深入学习下面的视频:

<Player url="https://www.youtube.com/watch?v=XgzHmV_nnpY" />

## TON 区块链课程

我们自豪地推出 **TON 区块链课程**,这是一个关于 TON 区块链的全面指南。该课程是为想要学习如何在 TON 区块链上创建智能合约和去中心化应用的开发者设计的。

它包含 **9个模块**,涵盖了 TON 区块链的基础知识、FunC 编程语言和 TON 虚拟机 (TVM)。

<Button href="https://stepik.org/course/201638/" colorType={'primary'} sizeType={'sm'}>

查看 TON 课程

</Button>

## 区块链新手?

如果你是区块链的新手,不了解这项技术为何如此革命性 — 考虑深入了解这些重要内容:

- [什么是区块链?什么是智能合约?什么是 Gas?](https://blog.ton.org/what_is_blockchain)
- [在荒岛上,区块链如何帮助你](https://talkol.medium.com/why-decentralized-consensus-blockchain-is-good-for-business-5ff263468210)
- [\[YouTube\] 加密网络及其重要性](https://youtu.be/2wxtiNgXBaU)

## TON 与以太坊的关系

对于熟悉以太坊开发的人,我们撰写了两篇介绍性文章,帮助你了解 TON 的独特之处:

- [TON 区块链的六个独特之处,会让 Solidity 开发者感到惊讶](https://blog.ton.org/six-unique-aspects-of-ton-blockchain-that-will-surprise-solidity-developers)
- [尝试新事物的时候到了:异步智能合约](https://telegra.ph/Its-time-to-try-something-new-Asynchronous-smart-contracts-03-25)
- [区块链之间的比较](https://ton.org/comparison_of_blockchains.pdf)
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# 区块链之链

:::tip
本文档中,“**智能合约**”、“**账户**”和“**Actor**”这几个术语可互换使用,用以描述区块链实体。
:::

## 单一Actor

让我们考虑一个智能合约。

在TON中,它是一个拥有`地址``代码``数据``余额`等属性的_事物_。换句话说,它是一个拥有一定_存储_和_行为_的对象。
行为会遵循以下模式:

- 发生某事(最常见的情况是合约收到一条消息)
- 合约根据自身属性通过在TON虚拟机中执行其`代码`来处理该事件。
- 合约修改自身属性(`代码``数据`等)
- 合约可选地生成传出消息
- 合约进入待机模式,直到下一个事件发生

这些步骤的组合被称为一次**交易**。重要的是,事件是依次处理的,因此_交易_是严格有序的,不能相互打断。

这种行为模式众所周知,被称为“Actor”。

### 最低层级:账户链

一系列的_交易_ `Tx1 -> Tx2 -> Tx3 -> ....` 可以被称为一条****。在这个例子下,它被称为**账户链 (AccountChain)**,以强调这是单个账户的_交易链_

现在,由于处理交易的节点时不时需要协调智能合约的状态(达成关于状态的_共识_),这些_交易_被批量处理:
`[Tx1 -> Tx2] -> [Tx3 -> Tx4 -> Tx5] -> [] -> [Tx6]`
批处理不干预排序,每个交易仍然只有一个“前一交易”和至多一个“下一交易”,但现在这个序列被切割成了**区块**

将传入和传出消息的队列也包含在_区块_中是有益的。在这样的情况下,一个_区块_将包含决定和描述智能合约在该区块期间所发生的全部信息。

## 账户链的集合:分片链

现在让我们考虑有许多账户的情况。我们得到一些_账户链_并将它们存储在一起,这样的一组_账户链_被称为**分片链 (ShardChain)**。同样地,我们可以将**分片链**切割成**分片区块**,这些区块是个别_账户区块_的聚合。

### 分片链的动态拆分与合并

请注意,由于_分片链_由容易区分的_账户链_组成,我们可以轻松地将其分割。这样,如果我们有1个_分片链_,描述了100万个账户的事件,且每秒交易量过多,无法由一个节点处理和存储,那么我们就将该链分割(或**拆分**)为两个较小的_分片链_,每条链处理50万个账户,每条链在一组独立的节点上处理。

同样地,如果某些分片变得过于空闲,它们可以被**合并**为一个更大的分片。

显然有两个极限情况:分片只包含一个账户(因此无法进一步分割)以及当分片包含所有账户。

账户可以通过发送消息相互交互。这里会有一种特殊的路由机制,将消息从传出队列移动到相应的传入队列,并确保1) 所有消息都将被送达 2) 消息将连续送达(较早发送的消息将更早到达目的地)。

:::info 旁注
为了使分割和合并具有确定性,将账户链聚合成分片是基于账户地址的位表示。例如,地址会看起来像`(分片前缀, 地址)`这种形式。这样,分片链中的所有账户将具有完全相同的二进制前缀(例如所有地址都以`0b00101`开头)。
:::

## 区块链

包含所有账户并按照一套规则运行的所有分片的集合被称为**区块链**

在TON中,可以有许多套规则,因此允许多个区块链同时运行,并通过发送跨链消息相互交互,就像同链的账户之间的交互一样。

### 工作链:有自己规则的区块链

如果你想自定义一组分片链的规则,你可以创建一个**工作链 (Workchain)**。一个很好的例子是创建一个基于EVM的工作链,在其上运行Solidity智能合约。

理论上,社区中的每个人都可以创建自己的工作链。事实上,构建它是一个相当复杂的任务,在此之前还要支付创建它的(昂贵)费用,并获得验证者的2/3的票数来批准创建你的工作链。

TON允许创建多达`2^32`个工作链,每个工作链则可以细分为多达`2^60`个分片。

如今,在TON中只有2个工作链:主链和基本链。

基本链用于日常交易,因为它相对便宜,而主链对于TON具有至关重要的功能,所以让我们来了解它的作用!

### 主链:区块链之链

网络需要对消息路由和交易执行进行同步。换句话说,网络中的节点需要一种方式来固定多链状态的某个“点”,并就该状态达成共识。在TON中,一个称为\*\*主链 (Masterchain)\*\*的特殊链被用于此目的。_主链_的区块包含有关系统中所有其他链的额外信息(最新的区块哈希),因此任何观察者都可以非常明确地确定单个主链区块时所有多链系统的状态。
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# 以 Cell 为数据存储

TON 中的所有内容都存储在cell(单元)中。一个cell是一个数据结构,包含:

- 高达 **1023 位** 的数据(不是字节!)
- 高达 **4 个引用** 到其他cell

位和引用不是混合存储的(它们被分开存储)。禁止循环引用:对于任何cell,其后代cell都不能将此原始cell作为引用。

因此,所有cell构成一个有向无环图(DAG)。这里有一个很好的图片来说明:

![Directed Acylic Graph](/img/docs/dag.png)

## Cell 类型

目前,有 5 种类型的cell:*普通* 和 4 种 *另类*。另类类型包括以下内容:

- 裁剪分支cell
- 库引用cell
- Merkle 证明cell
- Merkle 更新cell

:::tip
了解更多有关特殊cell的信息,请参见:[**TVM 白皮书,第 3 节**](https://ton.org/tvm.pdf)
:::

## Cell 风格

cell是一种为紧凑存储而优化的不透明对象。

特别是,它会去重数据:如果在不同分支中引用了多个等效的子cell,那它们的内容仅存储一次。然而,不透明性意味着无法直接修改或读取cell。因此,还有两种额外的cell风格:

- *Builder* 用于部分构建的cell,可以为其定义用于追加位串、整数、其他cell和引用其他cell的快速操作。
- *Slice* 用于“解剖”cell,表示部分解析的cell的剩余部分或驻留在其中的值(子cell),通过解析指令从中提取。

另一种在 TVM 中使用的特殊cell风格:

- *Continuation* 用于包含 TON 虚拟机的操作码(指令)的cell,请参阅[TVM 概览](/learn/tvm-instructions/tvm-overview)

## 将数据序列化为 Cell

TON 中的任何对象(消息、消息队列、区块、整个区块链状态、合约代码和数据)都可以序列化为cell。

序列化的过程由 TL-B 方案描述:这是一个正式描述如何将此对象序列化为 *Builder* 或如何从 *Slice* 解析给定类型对象的方案。对于cell的 TL-B 与字节流的 TL 或 ProtoBuf 相同。

如果您想了解有关cell(反)序列化的更多详细信息,可以阅读[单元(Cell)和单元包(Bag of Cells)](/develop/data-formats/cell-boc)文章。

## 参阅

- [TL-B 语言](/develop/data-formats/tl-b-language)
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# TON网络

TON使用自己的点对点网络协议。

- **TON区块链使用这些协议**来传播新区块,发送和收集候选交易等。

虽然单区块链项目(如比特币或以太坊)的网络需求相对容易满足(基本上需要构建一个点对点覆盖网络,然后通过[gossip协议](https://en.wikipedia.org/wiki/Gossip_protocol)传播所有新区块和候选交易),但多区块链项目(如TON)的要求更高(例如,必须能够仅订阅某些分片链的更新,而不一定是全部)。

- **TON生态系统服务(例如TON代理,TON网站,TON存储)运行在这些协议上。**

一旦为支持TON区块链所需的更复杂的网络协议就位,就会发现它们可以轻松地用于不一定与区块链本身的直接相关的需求,从而为在TON生态系统中创造新服务提供了更多的可能性和灵活性。
Original file line number Diff line number Diff line change
@@ -0,0 +1,155 @@
import Player from '@site/src/components/player'

# TON 中的 Explorers

在这篇文章中,我们将考虑TONExplorers,他们的能力和特点,从开发者的角度出发。

## 什么是 Explorers?

Explorer是一个网站,允许您查看区块链中的信息,如账户余额、交易历史、区块等。

<Player url="https://www.youtube.com/watch?v=i5en19kzX6M" />

## 哪些 Explorers 存在?

在TON Explorers中,您可以区分几个类别:

- 日常使用
- 为开发者提供扩展信息
- 专业化

这种分类大体上是有条件的,一个Explorer可以同时属于几个类别。所以我们不要过多地关注这个。

## Explorers 中的地址别名

通过使用地址别名使您的服务地址更加用户友好。根据提供的指南创建拉取请求(PR):

- [tonkeeper/ton-assets](https://github.com/tonkeeper/ton-assets) - Tonviewer.com别名
- [catchain/address-book](https://github.com/catchain/address-book)- Tonscan.org别名

## 通用功能

让我们从所有Explorers中都存在的通用功能开始。

几乎所有的Explorers都能查找关于余额、交易历史和智能合约的信息,如果部署在地址上的话。

接下来,我们将考虑几个可以归为这些类别的Explorers。

## TON Scan.org

适合日常使用的好Explorer。它提供了TON区块链的全面视图,允许用户搜索交易、地址、区块等。任何搜索都是针对公共[地址簿](https://github.com/catchain/tonscan/blob/master/src/addrbook.json)(TON基金会,OKX等)进行的。

### 特点

- **适合日常使用**
- 对开发者方便
- TON DNS支持
- 合约类型
- 合约反汇编器

### 链接

- 网址:https://tonscan.org/
- 测试网网址:https://testnet.tonscan.org/

## TON Scan.com

### 特点

- 交易聚合分析
- 交易追踪

### 链接

- 网址:https://tonscan.com/

## Ton Whales Explorer

这个Explorer比普通用户更倾向于开发者。

### 特点

- **对开发者方便**
- 合约类型
- 合约反汇编器

### 链接

- 网址:https://tonwhales.com/explorer

## Tonviewer Explorer

这个Explorer是最新的,有自己独特的特点。
例如,追踪。这个功能允许您看到智能合约之间的整个交易序列,即使后续交易不包含您的地址。

交易信息不如TON Whales那样详细。

### 特点

- 对开发者方便
- 适合日常使用
- Jetton交易历史
- **追踪**
- TON DNS支持

### 链接

- 网址:https://tonviewer.com/
- 测试网网址:https://testnet.tonviewer.com/

## TON NFT Explorer

这个Explorer专注于NFT,但也可以作为常规Explorer使用。

查看钱包地址时,您可以找出它存储了哪些NFT,并在查看NFT时,您可以找出元数据、集合地址、所有者和交易历史。

### 特点

- 对开发者方便
- 合约类型
- **专注于NFT**

### 链接

- 网址:https://explorer.tonnft.tools/
- 测试网网址:https://testnet.explorer.tonnft.tools/

## DTON

DTON是另一个面向开发者的Explorer。它以方便的形式提供了大量的交易信息。

此外,它有一个功能,允许您逐步查看交易的 Compute Phase 。

### 特点

- 对开发者方便
- 关于 Compute Phase 的扩展信息
- 合约类型
- 合约反汇编器

### 链接

- 网址:https://dton.io/

## TON NFTscan

这个Explorer专为TON区块链上的非同质化代币(NFT)设计。它允许用户探索、跟踪和验证NFT交易、合约和元数据。

### 特点

- 对普通用户方便
- 对交易者有用的信息,如日交易量
- NFT集合排名

### 链接

- 网址:https://ton.nftscan.com/

## 想在这个列表中吗?

请给其中一个[维护者](/docs/contribute/maintainers.md)写信。

## 参考资料

- [ton.app/explorers](https://ton.app/explorers)
- [非常棒的TON库](https://github.com/ton-community/awesome-ton)
Loading

0 comments on commit 2ca4954

Please sign in to comment.