Skip to content

Commit

Permalink
feat: add some ref
Browse files Browse the repository at this point in the history
  • Loading branch information
phenix3443 committed Sep 20, 2023
1 parent 0a76c51 commit b54a011
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 7 deletions.
2 changes: 1 addition & 1 deletion content/posts/geth-code/ch60-02-blockchain/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ trie 节点的这种“引用计数”式的设计应该是很好理解的,[

在以太坊中,区块可能会组织成下面这个样子:

![blockchain](blockchain.webp)
![blockchain](images/blockchain.webp)

这个图体现了以太坊区块链的大多数特性。大多数区块组成了一个链条,每个区块指向了自己的父多块,直到`创世区块(Genesis)`。但也很容易注意到,这个链条从头到尾并不是只有一条,而是有不少“毛刺”似的或长或短的分支链。这些分支链条被称为`侧链 (sidechain)`,而主要的那个链条则是`主链(也称为规范链:canonical chain)`,而这种出现分支链的情况就叫做`分叉 (fork)`

Expand Down
18 changes: 12 additions & 6 deletions content/posts/geth-code/ch60-03-geth-node/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,25 +28,31 @@ Geth 中的命令行程序基于 [urfave/cli]({{< ref "../../golang-cmd-tools#ur

([Node](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L44)) 是以太坊节点的实现,它支持多种协议,是一组服务(services)的集合,这些服务使用共享资源来提供 RPC API。这些服务还可以提供 devp2p 协议,当启动节点实例时,它们将连接到 devp2p 网络上。

在创建 geth 节点的时候,定义的是变量名是 [stack](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/cmd/geth/config.go#L150),有协议栈的含义
在创建 geth 节点的时候,定义的是变量名 [stack](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/cmd/geth/config.go#L150) 就有协议栈的含义

## 生命周期

Node 对象具有 [三种基本状态](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L71-L73): INITIALIZING(初始化)、RUNNING(运行)和 CLOSED(关闭)。

![geth-node-lifecycle](images/geth-node.drawio.svg)

创建一个节点会分配基本资源,如数据目录,并返回处于初始化状态的节点。在此状态下,可以 [注册实现 Lifecycle 接口的对象](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L559)[RPC API](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L104-L117)[p2p 网络协议](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L133-L140)。在初始化期间,允许执行基本操作,如打开键值数据库。
创建一个节点会分配基本资源,如数据目录,并返回处于初始化状态的节点。在此状态下,可以

一旦所有内容都注册完成,可以启动节点,将其状态转换为运行状态。启动节点会 [启动所有已注册的 Lifecycle 对象](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L189),并 [启用 RPC 和 p2p 网络](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L177)。请注意,在节点运行时不能注册额外的 Lifecycle、API 或 p2p 协议(这是通过 Node.lock 实现的)。
- [注册实现 service](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L559),service 是实现 Lifecycle 接口的对象
- [注册 RPC API](https://github.com/phenix3443/go-ethereum/blob/f52d18e6a1e5d7cdd9daa00e6432637559246ae0/node/node.go#L584)
- [注册 p2p 网络协议](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L133-L140)

关闭节点会释放所有占用的资源。Close 方法执行的操作取决于节点的状态。当关闭处于初始化状态的节点时,会释放与数据目录相关的资源。如果节点在运行状态下关闭,它还会 [停止所有实现 Lifecycle 接口的对象并关闭 RPC 和 p2p 网络](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L293)
在初始化期间,允许执行基本操作,如打开键值数据库。

一旦所有内容 [都注册完成](https://github.com/phenix3443/go-ethereum/blob/f52d18e6a1e5d7cdd9daa00e6432637559246ae0/cmd/geth/config.go#L169),可以 [启动节点](https://github.com/phenix3443/go-ethereum/blob/f52d18e6a1e5d7cdd9daa00e6432637559246ae0/cmd/geth/main.go#L352),将其状态转换为运行状态。启动节点会 [启动所有已注册的 Lifecycle 对象](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L189),并 [启用 RPC 和 p2p 网络](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L177)。请注意,在节点运行时不能注册额外的 Lifecycle、API 或 p2p 协议(这是通过 [Node.lock](https://github.com/phenix3443/go-ethereum/blob/f52d18e6a1e5d7cdd9daa00e6432637559246ae0/node/node.go#L560-L561) 实现的)。

关闭节点会释放所有占用的资源。Close 方法执行的操作取决于节点的状态。当关闭处于初始化状态的节点时,会释放与数据目录相关的资源。如果节点在运行状态下关闭,它还会 [停止 service 并关闭 RPC 和 p2p 网络](https://github.com/phenix3443/go-ethereum/blob/b5f3e54a8b2b9950095d78c8ccde4f8c806dc384/node/node.go#L293)

无论节点是否已启动,都必须始终调用 Node 的 Close 方法。

## 节点管理的资源

节点实例使用的所有文件系统资源都位于名为 "数据目录" 的目录中。每个资源的位置可以通过额外的节点配置进行覆盖。数据目录是可选的。如果未设置数据目录,并且资源的位置未明确指定,包 "node" 将在内存中创建该资源。
节点实例使用的所有文件系统资源都位于名为 "data" 的目录中。每个资源的位置可以通过额外的节点配置进行覆盖。数据目录是可选的。如果未设置数据目录,并且资源的位置未明确指定,包 "node" 将在内存中创建该资源。

为了访问 devp2p 网络,Node 配置并启动 p2p.Server。devp2p 网络上的每个主机都具有唯一的标识符,即节点密钥。Node 实例会跨重启保留此密钥。Node 还加载静态和可信的节点列表,并确保保存了关于其他主机的信息。

Expand All @@ -58,7 +64,7 @@ Node 还创建了加密的 [以太坊账户密钥的共享存储](https://github

## 在实例之间共享数据目录

如果多个节点实例具有不同的实例名称(通过 Name 配置选项设置),它们可以共享单个数据目录。共享行为取决于资源的类型。
如果多个节点实例具有不同的实例名称(通过 Name 配置选项设置),它们可以共享单个 data 目录。共享行为取决于资源的类型。

与 devp2p 相关的资源(节点密钥、静态/可信节点列表、已知主机数据库)存储在与实例名称相同的目录中。因此,使用相同数据目录的多个节点实例将把这些信息存储在数据目录的不同子目录中。

Expand Down

0 comments on commit b54a011

Please sign in to comment.