Nâng cấp & Nâng cấp căn bản
Klaytn và ServiceChain của nền tảng đã liên tục phát hành các phiên bản mới để phát triển các tính năng mới và sửa lỗi. Trang này là hướng dẫn nâng cấp nhị phân ServiceChain và đặt số khối hard fork cho ServiceChain của bạn.
Nâng cấp
Phần này cho biết cách nâng cấp nhị phân ServiceChain.
LƯU Ý Việc nâng cấp nhị phân ServiceChain có thể không thể đảo ngược và không tương thích ngược, nghĩa là bạn không thể hạ về phiên bản cũ hơn. Tham khảo lưu ý cho bản phát hành để biết thêm chi tiết. Ví dụ: lưu ý cho bản phát hành Klaytn v1.9.0 cho biết:
LƯU Ý: Phiên bản này cập nhật phiên bản cơ sở dữ liệu để hỗ trợ việc đồng bộ thu thập dữ liệu. Bạn không thể quay lại các phiên bản cũ hơn với dữ liệu hiện có sau khi cập nhật lên v1.9.0.
Bạn có thể tải phiên bản mới nhất của nhị phân Klaytn và ServiceChain bằng một trong các liên kết bên dưới:
Để nâng cấp nhị phân ServiceChain, hãy dừng nút ServiceChain và thay thế nhị phân. Ví dụ: bạn có thể sử dụng các lệnh bên dưới để dừng nút SCN và thay thế bằng nhị phân mới hơn.
$ kscnd stopShutting down kscnd: OK$ cp /path/to/new/kscn /path/to/original/kscn
Bạn có thể khởi động lại nút ServiceChain sau khi nâng cấp. Tuy nhiên, nếu bạn dự định kích hoạt hard fork trong ServiceChain, bạn phải giữ các nút ServiceChain ở trạng thái ngừng hoạt động. Tham khảo Hard Fork để tìm hiểu hướng dẫn về Hard Fork ServiceChain.
$ kscnd start
Hard Fork
Phần này mô tả các bước áp dụng hard fork Klaytn cho ServiceChain.
Để áp dụng Hard Fork cho ServiceChain, bạn cần:
- Chọn một số khối thích hợp cho hard fork
- Nâng cấp nhị phân ServiceChain lên phiên bản hỗ trợ hard fork
- Đặt số khối Hard Fork trong ServiceChain
1) Chọn một số khối thích hợp cho hard fork
Trong bảng điều khiển Javascript của ServiceChain, bạn có thể kiểm tra số khối hiện tại như ở bên dưới.
$ kscn attach ~/kscnd_home/klay.ipcWelcome to the Klaytn JavaScript console!instance: Klaytn/vX.X.X/XXXX-XXXX/goX.X.X datadir: ~/kscnd_home modules: admin:1.0 debug:1.0 eth:1.0 governance:1.0 istanbul:1.0 klay:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0> klay.blockNumber1234
Bây giờ, bạn phải chọn một số khối thích hợp đ ể kích hoạt hard fork. Đảm bảo có đủ số khối (được tạo ra mỗi giây) giữa khối hiện tại và khối hard fork.
2. Nâng cấp nhị phân ServiceChain
Tham khảo phần Nâng cấp trong trang này để xem hướng dẫn nâng cấp nhị phân ServiceChain. Đảm bảo giữ cho các nút ServiceChain tạm ngừng hoạt động (hoặc tắt) vào thời điểm này. Bạn sẽ khởi động lại chúng sau khi đã đặt số khối hard fork.
3. Đặt số khối hard fork
Nếu bạn đã nâng cấp nhị phân ServiceChain với phiên bản hỗ trợ hard fork mà bạn muốn, bạn có thể đặt số khối hard fork trong ServiceChain bằng cách khởi tạo lại cấu hình chuỗi với khởi nguyên được cập nhật.
Cập nhật khởi nguyên và khởi tạo lại cấu h ình chuỗi cho tất cả các nút ServiceChain
Đầu tiên, chỉ định số hard fork trong trường config của genesis.json. Ví dụ: nếu bạn đang cố gắng kích hoạt hard fork Magma trong ServiceChain của mình, bạn nên chỉ định trường magmaCompatibleBlock trong config của khởi nguyên, như bên dưới.
{ "config": { "chainId": 1000, "istanbulCompatibleBlock": 0, ... "magmaCompatibleBlock": 1500, ... }, ...}
Để kích hoạt hard fork trong cấu hình chuỗi, các hard fork trước đó phải được kích hoạt. Nghĩa là, để kích hoạt hard fork Magma, bạn phải kích hoạt hard fork EthTxType từ trước đó. Nếu các trường cho số khối tương thích của các hard fork trước đó trong cấu hình chuỗi bị thiếu, bạn cũng phải thêm vào.
Ví dụ: nếu bạn muốn đặt số khối hard fork Magma và nếu genesis.json của bạn không có ethTxTypeCompatibleBlock trong trường config như bên dưới:
{ "config": { "chainId": 1000, "istanbulCompatibleBlock": 0, "londonCompatibleBlock": 0, "istanbul": { "epoch": 3600, "policy":0, "sub":21 }, ... }}
Bạn cũng phải thêm cả ethTxTypeCompatibleBlock khi thêm magmaCompatibleBlock vào trường config, như bên dưới.
{ "config": { "chainId": 1000, "istanbulCompatibleBlock": 0, "londonCompatibleBlock": 0, "ethTxTypeCompatibleBlock": 1500, "magmaCompatibleBlock": 1500, "istanbul": { "epoch": 3600, "policy":0, "sub":21 }, ... }}
Bạn có thể tìm thấy lịch sử hard fork của Klaytn trong Tài liệu Klaytn.
Nếu bạn đã cập nhật genesis.json với các hard fork mà bạn muốn, hãy khởi tạo lại cấu hình chuỗi và áp dụng thay đổi.
$ kscn --datadir /path/to/data/directory init /path/to/genesis.json
LƯU Ý Nhật ký lỗi sau được in khi bạn khởi tạo lại cấu hình chuỗi là điều bình thường.
ERROR[08/02,09:12:39 Z] [48] The same or more recent governance index exist. Skip writing governance index newIdx=0 govIdxes=[0]
Xác nhận cấu hình chuỗi đã cập nhật
Bây giờ, hãy khởi động lại nút ServiceChain. Ví dụ: bạn có thể khởi động lại nút SCN bằng lệnh sau.
$ kscnd start
Sau đó, trong bảng điều khiển Javascript của SCN, bạn có thể kiểm tra cấu hình chuỗi đã cập nhật.
$ kscn attach ~/kscnd_home/klay.ipcWelcome to the Klaytn JavaScript console!instance: Klaytn/vX.X.X/XXXX-XXXX/goX.X.X datadir: ~/kscnd_home modules: admin:1.0 debug:1.0 eth:1.0 governance:1.0 istanbul:1.0 klay:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0> governance.chainConfig.magmaCompatibleBlock1500
Một số thông số về hard fork
Phần này mô tả một số thông số cho một hard fork cụ thể.
Magma
Hard fork Magma giới thiệu KIP-71, phí gas linh động. Bao gồm giới hạn trên và dưới của giá gas.
Theo mặc định, giới hạn trên được đặt là 750000000000 và giới hạn dưới là 25000000000. You can change those bounds in the Javascript console of SCN nodes using the governance APIs. Hiển nhiên, giới hạn dưới không thể vượt quá giới hạn trên.
Để đặt giá gas thành một giá trị tĩnh, bạn phải đặt giới hạn trên và dưới của giá gas thành cùng một giá trị. Ví dụ: bạn có thể đặt giá gas thành 0 bằng cách sử dụng API governance.vote trong bảng điều khiển Javascript của các nút SCN.
$ kscn attach ~/kscnd_home/klay.ipcWelcome to the Klaytn JavaScript console!instance: Klaytn/vX.X.X/XXXX-XXXX/goX.X.X datadir: ~/kscnd_home modules: admin:1.0 debug:1.0 eth:1.0 governance:1.0 istanbul:1.0 klay:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0> governance.vote("kip71.lowerboundbasefee", 0)"Your vote is prepared. It will be put into the block header or applied when your node generates a block as a proposer. Note that your vote may be duplicate."> governance.vote("kip71.upperboundbasefee", 0)"Your vote is prepared. It will be put into the block header or applied when your node generates a block as a proposer. Note that your vote may be duplicate."
LƯU Ý Biểu quyết quản trị và bản cập nhật của nó sẽ có sẵn bất kể có kích hoạt hard fork Magma hay không. Nghĩa là việc biểu quyết quản trị cũng có thể được thực hiện trước khi kích hoạt hard fork Magma.
Nếu các phiếu bầu để cập nhật giới hạn trên và dưới của giá gas thành công, những thay đổi đó sẽ có hiệu lực sau 2 epoch istanbul (Một epoch có giá trị bằng số khối).
Ví dụ: nếu epoch là 3600 và các phiếu bầu để cập nhật giới hạn trên và dưới của giá gas đã được đặt trong khối #4000, những thay đổi đó sẽ có hiệu lực bắt đầu từ khối #10800. Cụ thể, các phiếu bầu sẽ được hoàn tất khi epoch đầu tiên đạt đến khối #7200 và các thay đổi được áp dụng ở epoch thứ hai (khối #10800).
Để kiểm tra epoch, bạn có thể sử dụng API governanace.itemsAt như bên dưới.
> governance.itemsAt(klay.blockNumber){ governance.governancemode: "none", governance.governingnode: "0x05ad406f31e22b74f18c9ed65ed1ccd349bbbee0", governance.unitprice: 0, istanbul.committeesize: 21, istanbul.epoch: 3600, istanbul.policy: 0, kip71.basefeedenominator: 20, kip71.gastarget: 30000000, kip71.lowerboundbasefee: 25000000000, kip71.maxblockgasusedforbasefee: 60000000, kip71.upperboundbasefee: 750000000000, reward.deferredtxfee: false, reward.minimumstake: "2000000", reward.mintingamount: "9600000000000000000", reward.proposerupdateinterval: 3600, reward.useginicoeff: false}
Bạn có thể thấy rằng istanbul.epoch có giá trị là 3600 khối, thường mất một giờ để vượt qua.
Bạn cũng có thể thay đổi giai đoạn bằng cách sử dụng API governance.vote.
> governance.vote("istanbul.epoch", 60)"Your vote is prepared. It will be put into the block header or applied when your node generates a block as a proposer. Note that your vote may be duplicate."