Skip to content

Commit b411c6c

Browse files
CoderZhiCoderZhi
authored
Merge pull request #310 from iotexproject/r233
v2.3.3 release
2 parents 3010f67 + 6fb56c1 commit b411c6c

7 files changed

Lines changed: 129 additions & 168 deletions

File tree

‎README.md‎

Lines changed: 16 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919

2020
Here are the software versions we use:
2121

22-
- MainNet: v2.3.2
22+
- MainNet: v2.3.3
2323

2424
## <a name="testnet"/>Join TestNet
2525
To start and run a testnet node, please click [**Join Testnet**](https://github.com/iotexproject/iotex-bootstrap/blob/master/README_testnet.md)
@@ -32,7 +32,7 @@ This is the recommended way to start an IoTeX node
3232
1. Pull the docker image:
3333

3434
```
35-
docker pull iotex/iotex-core:v2.3.2
35+
docker pull iotex/iotex-core:v2.3.3
3636
```
3737

3838
2. Set the environment with the following commands:
@@ -47,62 +47,34 @@ mkdir -p $IOTEX_HOME/data
4747
mkdir -p $IOTEX_HOME/log
4848
mkdir -p $IOTEX_HOME/etc
4949
50-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/config_mainnet.yaml > $IOTEX_HOME/etc/config.yaml
51-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/genesis_mainnet.yaml > $IOTEX_HOME/etc/genesis.yaml
52-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/trie.db.patch > $IOTEX_HOME/data/trie.db.patch
50+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/config_mainnet.yaml > $IOTEX_HOME/etc/config.yaml
51+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/genesis_mainnet.yaml > $IOTEX_HOME/etc/genesis.yaml
52+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/trie.db.patch > $IOTEX_HOME/data/trie.db.patch
5353
```
5454

5555
3. Edit `$IOTEX_HOME/etc/config.yaml`, look for `externalHost` and `producerPrivKey`, uncomment the lines and fill in your external IP and private key. If you leave `producerPrivKey` empty, your node will be assgined with a random key.
5656

5757
4. Start from a **baseline snapshot** (rather than sync from the genesis block), run the following commands:
5858

5959
```
60-
curl -L https://t.iotex.me/mainnet-data-snapshot-latest > $IOTEX_HOME/data.tar.gz
60+
curl -L https://storage.iotex.io/mainnet-data-e-20251228-042459-core.tar.gz > $IOTEX_HOME/data.tar.gz
6161
```
6262

63-
or download from another website:
63+
5. Extract the data package:
6464

6565
```
66-
curl -L https://storage.iotex.io/mainnet-data-snapshot-latest.tar.gz > $IOTEX_HOME/data.tar.gz
67-
```
68-
69-
**We will update the baseline snapshot on the 1st of every month**.
70-
71-
5. Download the latest **incremental data** (Optional):
72-
73-
```
74-
curl -L https://storage.iotex.io/mainnet-data-incr-latest.tar.gz > $IOTEX_HOME/incr.tar.gz
75-
```
76-
77-
**We will update the incremental snapshot everyday**.
78-
79-
We also provide incremental packages from the **past 7 days**.
80-
You can choose any day within this period.
81-
For example, if you want to use the data from April 27, 2025, the incremental package file name will be `mainnet-data-incr-2025-04-27.tar.gz`.
82-
83-
The file named **latest** corresponds to today’s data.
84-
85-
To restore, you only need the full baseline package of the same month and the incremental package of the selected date.
86-
87-
6. Extract the data packages in the correct order.
88-
It is essential to extract the baseline package first, followed by the incremental package.
89-
90-
```
91-
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/ && tar -xzf $IOTEX_HOME/incr.tar.gz -C $IOTEX_HOME/data/
66+
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/
9267
```
9368

9469
For advanced users, there are three options to consider:
9570

9671
- Option 1: If you plan to run your node as a [gateway](#gateway), please use the snapshot with index data:
97-
https://t.iotex.me/mainnet-data-with-idx-latest.
98-
99-
or download from another website:
10072
```
101-
curl -L https://storage.iotex.io/mainnet-data-with-idx-latest.tar.gz > $IOTEX_HOME/data.tar.gz
102-
tar -xzf data.tar.gz
73+
curl -L https://storage.iotex.io/mainnet-data-e-20251228-042459-gateway.tar.gz > $IOTEX_HOME/data_index.tar.gz
74+
tar -xzf data_index.tar.gz
10375
```
10476

105-
> mainnet-data-with-idx-latest.tar.gz will be update on Monday every week
77+
If you need to run your node in archive mode to provide full historical data, please go to [Archive Node](./archive-node.md).
10678

10779
- Optional 2: If you only want to sync chain data from 0 height without relaying on legacy delegate election data from Ethereum, you can setup legacy delegate election data with following command:
10880
```bash
@@ -111,7 +83,7 @@ curl -L https://storage.iotex.io/poll.mainnet.tar.gz > $IOTEX_HOME/poll.tar.gz;
11183

11284
- Optional 3: If you want to sync the chain from 0 height and also fetching legacy delegate election data from Ethereum, please change the `gravityChainAPIs` in config.yaml to use your infura key with Ethereum archive mode supported or change the API endpoint to an Ethereum archive node which you can access.
11385

114-
5. Run the following command to start a node:
86+
6. Run the following command to start a node:
11587

11688
```
11789
docker run -d --restart on-failure --name iotex \
@@ -121,7 +93,7 @@ docker run -d --restart on-failure --name iotex \
12193
-v=$IOTEX_HOME/log:/var/log:rw \
12294
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
12395
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
124-
iotex/iotex-core:v2.3.2 \
96+
iotex/iotex-core:v2.3.3 \
12597
iotex-server \
12698
-config-path=/etc/iotex/config_override.yaml \
12799
-genesis-path=/etc/iotex/genesis.yaml
@@ -142,14 +114,14 @@ docker run -d --restart on-failure --name iotex \
142114
-v=$IOTEX_HOME/log:/var/log:rw \
143115
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
144116
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
145-
iotex/iotex-core:v2.3.2 \
117+
iotex/iotex-core:v2.3.3 \
146118
iotex-server \
147119
-config-path=/etc/iotex/config_override.yaml \
148120
-genesis-path=/etc/iotex/genesis.yaml \
149121
-plugin=gateway
150122
```
151123

152-
6. Ensure that TCP ports `4689` and `8080` are open on your firewall and load balancer (if applicable). Additionally, if you intend to use the node as a gateway, make sure the following ports are open:
124+
7. Ensure that TCP ports `4689` and `8080` are open on your firewall and load balancer (if applicable). Additionally, if you intend to use the node as a gateway, make sure the following ports are open:
153125
- `14014` for the IoTeX native gRPC API
154126
- `15014` for the Ethereum JSON API
155127
- `16014` for the Ethereum WebSocket
@@ -166,7 +138,7 @@ Same as [Join MainNet](#mainnet) step 2
166138
```
167139
git clone https://github.com/iotexproject/iotex-core.git
168140
cd iotex-core
169-
git checkout v2.3.2
141+
git checkout v2.3.3
170142
171143
// optional
172144
export GOPROXY=https://goproxy.io

‎README_CN.md‎

Lines changed: 16 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818

1919
以下是当前我们使用的软件版本：
2020

21-
- 主网：v2.3.2
21+
- 主网：v2.3.3
2222

2323
## <a name="testnet"/>加入测试网
2424
如果你要启动节点加入测试网，请点击[**加入测试网**](https://github.com/iotexproject/iotex-bootstrap/blob/master/README_CN_testnet.md)
@@ -32,7 +32,7 @@
3232
1. 提取(pull) docker镜像
3333

3434
```
35-
docker pull iotex/iotex-core:v2.3.2
35+
docker pull iotex/iotex-core:v2.3.3
3636
```
3737

3838
2. 使用以下命令设置运行环境
@@ -47,51 +47,33 @@ mkdir -p $IOTEX_HOME/data
4747
mkdir -p $IOTEX_HOME/log
4848
mkdir -p $IOTEX_HOME/etc
4949
50-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/config_mainnet.yaml > $IOTEX_HOME/etc/config.yaml
51-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/genesis_mainnet.yaml > $IOTEX_HOME/etc/genesis.yaml
52-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/trie.db.patch > $IOTEX_HOME/data/trie.db.patch
50+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/config_mainnet.yaml > $IOTEX_HOME/etc/config.yaml
51+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/genesis_mainnet.yaml > $IOTEX_HOME/etc/genesis.yaml
52+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/trie.db.patch > $IOTEX_HOME/data/trie.db.patch
5353
```
5454

5555
3. 编辑 `$IOTEX_HOME/etc/config.yaml`, 查找 `externalHost` 和 `producerPrivKey`, 取消注释行并填写您的外部 IP 和私钥。如果`producerPrivKey`放空，你的节点将被分配一个随机密钥。
5656

5757
4. 下载全量数据快照, 请运行以下命令:
5858
```
59-
curl -L https://t.iotex.me/mainnet-data-snapshot-latest > $IOTEX_HOME/data.tar.gz
59+
curl -L https://storage.iotex.io/mainnet-data-e-20251228-042459-core.tar.gz > $IOTEX_HOME/data.tar.gz
6060
```
61-
或者 请运行以下命令
62-
```
63-
curl -L https://storage.iotex.io/mainnet-data-snapshot-latest.tar.gz > $IOTEX_HOME/data.tar.gz
64-
```
65-
66-
**我们将会在每月一日更新全量数据快照**。
67-
68-
5. 下载最新增量数据, 请运行以下命令(可选):
69-
70-
```
71-
curl -L https://storage.iotex.io/mainnet-data-incr-latest.tar.gz > $IOTEX_HOME/incr.tar.gz
72-
```
73-
74-
**我们将会每天更新一次增量数据快照**。
7561

76-
同时我们提供7日内的增量包下载，你可以选择这期间中任意一天。比如你想使用2025.4.27日的数据， 那么增量包的文件名称为`mainnet-data-incr-2025-04-27.tar.gz`， latest为今日的数据。 还原的时候只需当月的全量包 + 当日的增量包即可。
77-
78-
6. 解压数据包, 请注意解压顺序, 必须先解压全量包, 再解压增量包
62+
5. 解压数据包
7963

8064
```
81-
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/ && tar -xzf $IOTEX_HOME/incr.tar.gz -C $IOTEX_HOME/data/
65+
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/
8266
```
8367

8468
对于高级用户，可以考虑以下三个选项：
8569

86-
- 选项1：如果计划将节点作为[网关](#gateway)运行，请使用带有索引数据的快照：https://t.iotex.me/mainnet-data-with-idx-latest.
87-
88-
或从另一个站点下载:
70+
- 选项1：如果计划将节点作为[网关](#gateway)运行，还需要额外下载带有索引数据的快照
8971
```
90-
curl -L https://storage.iotex.io/mainnet-data-with-idx-latest.tar.gz > $IOTEX_HOME/data.tar.gz
91-
tar -xzf data.tar.gz
72+
curl -L https://storage.iotex.io/mainnet-data-e-20251228-042459-gateway.tar.gz > $IOTEX_HOME/data_index.tar.gz
73+
tar -xzf data_index.tar.gz
9274
```
9375

94-
> mainnet-data-with-idx-latest.tar.gz 在每周一会打新的压缩包
76+
如果需要以 archive 模式运行提供全量历史数据，请转到 [Archive Node](./archive-node.md)
9577

9678
- 选择2：如果计划从 0 区块高度开始同步链上数据而不使用来自以太坊旧的节点代表数据，执行以下命令设置旧的节点代表数据：
9779
```
@@ -100,7 +82,7 @@ curl -L https://storage.iotex.io/poll.mainnet.tar.gz > $IOTEX_HOME/poll.tar.gz;
10082

10183
- 选择3：如果计划从 0 区块高度开始同步链并从以太坊获取旧的节点代表数据，请更改 config.yaml 中的 `gravityChainAPIs`并在支持以太坊存档模式的情况下使用您的 infura 密钥，或将 API 端点更改为您有权限访问的以太坊存档节点。
10284

103-
7. 运行以下命令以启动节点:
85+
6. 运行以下命令以启动节点:
10486

10587
```
10688
docker run -d --restart on-failure --name iotex \
@@ -110,7 +92,7 @@ docker run -d --restart on-failure --name iotex \
11092
-v=$IOTEX_HOME/log:/var/log:rw \
11193
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
11294
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
113-
iotex/iotex-core:v2.3.2 \
95+
iotex/iotex-core:v2.3.3 \
11496
iotex-server \
11597
-config-path=/etc/iotex/config_override.yaml \
11698
-genesis-path=/etc/iotex/genesis.yaml
@@ -128,7 +110,7 @@ docker run -d --restart on-failure --name iotex \
128110
-v=$IOTEX_HOME/log:/var/log:rw \
129111
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
130112
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
131-
iotex/iotex-core:v2.3.2 \
113+
iotex/iotex-core:v2.3.3 \
132114
iotex-server \
133115
-config-path=/etc/iotex/config_override.yaml \
134116
-genesis-path=/etc/iotex/genesis.yaml \
@@ -148,7 +130,7 @@ docker run -d --restart on-failure --name iotex \
148130
```
149131
git clone https://github.com/iotexproject/iotex-core.git
150132
cd iotex-core
151-
git checkout v2.3.2
133+
git checkout v2.3.3
152134
153135
// optional
154136
export GOPROXY=https://goproxy.io

‎README_CN_testnet.md‎

Lines changed: 15 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717

1818
以下是当前我们使用的软件版本：
1919

20-
- 测试网：v2.3.2
20+
- 测试网：v2.3.3
2121

2222
**Note**
2323
如果你要启动节点加入主网，请点击[**加入主网**](https://github.com/iotexproject/iotex-bootstrap/blob/master/README_CN.md)
@@ -31,7 +31,7 @@
3131
1. 提取(pull) docker镜像
3232

3333
```
34-
docker pull iotex/iotex-core:v2.3.2
34+
docker pull iotex/iotex-core:v2.3.3
3535
```
3636

3737
2. 使用以下命令设置运行环境
@@ -46,61 +46,40 @@ mkdir -p $IOTEX_HOME/data
4646
mkdir -p $IOTEX_HOME/log
4747
mkdir -p $IOTEX_HOME/etc
4848
49-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/config_testnet.yaml > $IOTEX_HOME/etc/config.yaml
50-
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.2/genesis_testnet.yaml > $IOTEX_HOME/etc/genesis.yaml
49+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/config_testnet.yaml > $IOTEX_HOME/etc/config.yaml
50+
curl https://raw.githubusercontent.com/iotexproject/iotex-bootstrap/v2.3.3/genesis_testnet.yaml > $IOTEX_HOME/etc/genesis.yaml
5151
```
5252

5353
3. 编辑 `$IOTEX_HOME/etc/config.yaml`, 查找 `externalHost` 和 `producerPrivKey`, 取消注释行并填写您的外部 IP 和私钥。如果`producerPrivKey`放空，你的节点将被分配一个随机密钥。
5454

5555
4. 下载全量数据快照, 请运行以下命令:
56-
```
57-
curl -L https://t.iotex.me/testnet-data-snapshot-latest > $IOTEX_HOME/data.tar.gz
58-
tar -xzf data.tar.gz
59-
```
60-
或者 请运行以下命令
61-
```
62-
curl -L https://storage.iotex.io/testnet-data-snapshot-latest.tar.gz > $IOTEX_HOME/data.tar.gz
63-
tar -xzf data.tar.gz
64-
```
65-
66-
**我们将会在每月一日更新全量数据快照**。
67-
68-
5. 下载最新增量数据, 请运行以下命令(可选):
6956

7057
```
71-
curl -L https://storage.iotex.io/testnet-data-incr-latest.tar.gz > $IOTEX_HOME/incr.tar.gz
58+
curl -L https://storage.iotex.io/testnet-data-e-20260105-042459-core.tar.gz > $IOTEX_HOME/data.tar.gz
7259
```
7360

74-
**我们将会每天更新一次增量数据快照**。
75-
76-
同时我们提供7日内的增量包下载，你可以选择这期间中任意一天。比如你想使用2025.4.27日的数据， 那么增量包的文件名称为`testnet-data-incr-2025-04-27.tar.gz`， latest为今日的数据。 还原的时候只需当月的全量包 + 当日的增量包即可。
77-
78-
6. 解压数据包, 请注意解压顺序, 必须先解压全量包, 再解压增量包
61+
5. 解压数据包
7962

8063
```
81-
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/ && tar -xzf $IOTEX_HOME/incr.tar.gz -C $IOTEX_HOME/data/
64+
tar -xzf $IOTEX_HOME/data.tar.gz -C $IOTEX_HOME/data/
8265
```
8366

8467
对于高级用户，可以考虑以下三个选项：
8568

86-
- 选项1：如果计划将节点作为[网关](#gateway)运行，请使用带有索引数据的快照：https://t.iotex.me/testnet-data-with-idx-latest.
87-
88-
或从另一个站点下载:
69+
- 选项1：如果计划将节点作为[网关](#gateway)运行，请额外下载带有索引数据的快照
8970
```
90-
curl -L https://storage.iotex.io/testnet-data-with-idx-latest.tar.gz > $IOTEX_HOME/data.tar.gz
91-
tar -xzf data.tar.gz
71+
curl -L https://storage.iotex.io/testnet-data-e-20260105-042459-gateway.tar.gz > $IOTEX_HOME/data_index.tar.gz
72+
tar -xzf data_index.tar.gz
9273
```
9374

94-
> testnet-data-with-idx-latest.tar.gz 在每周一会打新的压缩包
95-
9675
- 选择2：如果计划从 0 区块高度开始同步链上数据而不使用来自以太坊旧的节点代表数据，执行以下命令设置旧的节点代表数据：
9776
```
9877
curl -L https://storage.iotex.io/poll.testnet.tar.gz > $IOTEX_HOME/poll.tar.gz; tar -xzf $IOTEX_HOME/poll.tar.gz --directory $IOTEX_HOME/data
9978
```
10079

10180
- 选择3：如果计划从 0 区块高度开始同步链并从以太坊获取旧的节点代表数据，请更改 config.yaml 中的 `gravityChainAPIs`并在支持以太坊存档模式的情况下使用您的 infura 密钥，或将 API 端点更改为您有权限访问的以太坊存档节点。
10281

103-
5. 运行以下命令以启动节点:
82+
6. 运行以下命令以启动节点:
10483

10584
```
10685
docker run -d --restart on-failure --name iotex \
@@ -110,7 +89,7 @@ docker run -d --restart on-failure --name iotex \
11089
-v=$IOTEX_HOME/log:/var/log:rw \
11190
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
11291
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
113-
iotex/iotex-core:v2.3.2 \
92+
iotex/iotex-core:v2.3.3 \
11493
iotex-server \
11594
-config-path=/etc/iotex/config_override.yaml \
11695
-genesis-path=/etc/iotex/genesis.yaml
@@ -128,14 +107,14 @@ docker run -d --restart on-failure --name iotex \
128107
-v=$IOTEX_HOME/log:/var/log:rw \
129108
-v=$IOTEX_HOME/etc/config.yaml:/etc/iotex/config_override.yaml:ro \
130109
-v=$IOTEX_HOME/etc/genesis.yaml:/etc/iotex/genesis.yaml:ro \
131-
iotex/iotex-core:v2.3.2 \
110+
iotex/iotex-core:v2.3.3 \
132111
iotex-server \
133112
-config-path=/etc/iotex/config_override.yaml \
134113
-genesis-path=/etc/iotex/genesis.yaml \
135114
-plugin=gateway
136115
```
137116

138-
6. 确保您的防火墙和负载均衡器（如果有）上的TCP端口4689, 8080（14014如果节点启用了网关）已打开。
117+
7. 确保您的防火墙和负载均衡器（如果有）上的TCP端口4689, 8080（14014如果节点启用了网关）已打开。
139118

140119
## <a name="testnet_native"/>不使用Docker加入测试网
141120

@@ -148,7 +127,7 @@ docker run -d --restart on-failure --name iotex \
148127
```
149128
git clone https://github.com/iotexproject/iotex-core.git
150129
cd iotex-core
151-
git checkout v2.3.2
130+
git checkout v2.3.3
152131
153132
// optional
154133
export GOPROXY=https://goproxy.io

0 commit comments

Comments
 (0)