Releases: near/nearcore
1.36.5
Notice
This release of nearcore is a security release (CODE_RED_MAINNET
). It fixes a bug around shard management that, if exploited, can lead to a node crash.
Apart from the bugfix mentioned above, the release also includes a few other minor functional fixes.
All node operators must upgrade to 1.36.5 immediately.
CODE_COLOR: CODE_RED_MAINNET
RELEASE_VERSION: 1.36.5
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: TRUE
1.37.0-rc.2
CODE_COLOR: CODE_GREEN_TESTNET
RELEASE_VERSION: 1.37.0-rc.2
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: FALSE
Note (Upgraded Protocol Upgrade Voting Date)
Testnet is still running protocol version 63. Voting for upgrading to protocol version 64 will now start on Monday 2024-02-05 15:00:00 UTC (one week later than in 1.37.0-rc.1).
Pagoda will update their testnet validators ASAP. As they hold more than 20% of the stake, this is enough to postpone the voting.
If you run your own testnet validator, you are not required to update. The voting will be finished later either way.
Non-protocol Changes
- Split storage optimisation (#10437)
1.37.0-rc.1
CODE_COLOR: CODE_YELLOW_TESTNET
RELEASE_VERSION: 1.37.0-rc.1
PROTOCOL_UPGRADE: TRUE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: FALSE
Protocol Upgrade Voting
This release contains a protocol upgrade. Voting for upgrading to protocol version 64 will start on Monday 2024-01-29 15:00:00 UTC.
Managing Resharding
This protocol upgrade includes resharding of shard 3. Which means that after protocol upgrade we will have 5 shards. New shard split is defined by these border accounts vec!["aurora", "aurora-0", "kkuuue2akv_1630967379.near", "tge-lockup.sweat"]
Important points:
- Resharding will happen in the epoch RIGHT AFTER protocol voting epoch (and RIGHT BEFORE actual protocol upgrade).
- If your node fails to reshard before protocol upgrade, it will not be able to continue being a part of the chain. If that happens, you should restart from a Pagoda provided backup.
- Resharding creates a database snapshot that is deleted right after resharding is finished.During resharding, though, you may notice progressive increase of
data
folder size (around 150GB). - To monitor resharding you can use metrics
near_resharding_status
,near_resharding_batch_size
, andnear_resharding_batch_prepare_time_bucket
. You can read more herehttps://github.com/near/nearcore/blob/master/docs/architecture/how/resharding.md#monitoring
. - If you observe problems with block production or resharding performance, you can adjust resharding throttling configuration. Read more here https://github.com/near/nearcore/blob/master/docs/architecture/how/resharding.md#monitoring.
- RAM usage during resharding is around 8-10GB.
Full resharding doc can be found here https://github.com/near/nearcore/blob/master/docs/architecture/how/resharding.md.
Protocol Changes
- Resharding v2 - new implementation for resharding and a new shard layout for production networks. #10303, NEP-0508
- Restrict the creation of non-implicit top-level accounts that are longer than 32 bytes. Only the registrar account can create them. #9589
- Adjust the number of block producers and chunk producers on testnet to facilitate testing of chunk-only producers #9563
Non-protocol Changes
1.36.4
Notice
This release of nearcore is a security release (CODE_RED_MAINNET
). It fixes a handshake parsing vulnerability that, if exploited, can lead to a node crash.
All node operators must upgrade to 1.36.4 immediately.
This release contains no additional code or behavior changes beyond the fix that addresses the security vulnerability, which is related only to a feature that isn't used in production today.
Fixes
- Fix an issue related to handshake parsing
CODE_COLOR: CODE_RED_MAINNET
RELEASE_VERSION: 1.36.4
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: TRUE
1.36.3
Notice
This release of nearcore is a security release (CODE_RED_MAINNET
). It fixes a handshake parsing vulnerability that, if exploited, can lead to a node crash.
All node operators must upgrade to 1.36.3 immediately.
This release contains no additional code or behavior changes beyond the fix that addresses the security vulnerability, which is related only to a feature that isn't used in production today.
Fixes
- Fix an issue related to handshake parsing
CODE_COLOR: CODE_RED_MAINNET
RELEASE_VERSION: 1.36.3
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: TRUE
1.36.2
Notice
This release of nearcore is a security release (CODE_RED_MAINNET
). It fixes a protobuf vulnerability that, if exploited, can lead to a node crash.
All node operators must upgrade to 1.36.2 immediately.
This release contains no additional code or code changes beyond the fix that addresses the security vulnerability.
Fixes
- Fix an issue related to parsing of protobuf messages
CODE_COLOR: CODE_RED_MAINNET
RELEASE_VERSION: 1.36.2
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: TRUE
1.36.1
Minor CODE_GREEN
release, feel free to skip upgrading your nodes.
Adds 2 configuration options and contains no other fixes or improvements.
Fixes
- Add config option
tx_routing_height_horizon
to configure how many chunk producers are notified about the tx. #10251 - Add config options
state_sync.dump.credentials_file
to configure pro-active state part production for State Sync. #9487
Crates
Crates corresponding to this nearcore version were published with version 0.18.0
CODE_COLOR: CODE_GREEN_MAINNET
RELEASE_VERSION: 1.36.1
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: FALSE
1.36.0
CODE_COLOR: CODE_YELLOW_MAINNET
RELEASE_VERSION: 1.36.0
PROTOCOL_UPGRADE: TRUE
DATABASE_UPGRADE: TRUE
SECURITY_UPGRADE: TRUE
Protocol Changes
- The support for fixed shards in shard layout was removed. #9219
Protocol Upgrade Voting
This release contains a protocol upgrade. Voting for upgrading to protocol version 63 will start on 2023-11-13 15:00:00 UTC.
Database Upgrade
This release contains a database upgrade. STATE_SYNC_DUMP_KEY and STATE_SNAPSHOT_KEY was added to the BlockMisc column for support of state sync.
Non-protocol Changes
- New option
transaction_pool_size_limit
inconfig.json
allows to limit the size of the node's transaction pool.
By default the limit is set to 100 MB. #3284 - Database snapshots at the end of an epoch. This lets a node obtain state parts using flat storage. #9090
- Number of transactions included in a chunk will be lowered if there is a congestion of more than 20000 delayed receipts in a shard. #9222
- Our more efficient and scalable V2 routing protocol is implemented. It shadows the V1 protocol for now while we verify its performance. #9187
- The default config now enables TIER1 outbound connections by default. #9349
- State Sync from GCS is available for experimental use. #9398
Note around node performance
During internal testing of 1.36 we noticed nodes were impacted by a performance degradation manifesting as slowness in producing blocks. This impact was statistical, and the investigation we performed did not reveal any clear indicator of the root cause of this degradation.
In order to better assess this issue, we decided to test the release on testnet. The testnet release so far did not reveal any performance degradation, so we are releasing to mainnet.
After upgrading on mainnet to 1.36, if you get kicked out or notice any performance issue, please reach out to us on the NEAR Validators Telegram channel with data regarding node configuration and performance.
1.36.0-rc.2
CODE_COLOR: CODE_GREEN_TESTNET
RELEASE_VERSION: 1.36.0-rc.2
PROTOCOL_UPGRADE: FALSE
DATABASE_UPGRADE: FALSE
SECURITY_UPGRADE: FALSE
Protocol Changes
Non-protocol Changes
1.36.0-rc.1
CODE_COLOR: CODE_YELLOW_TESTNET
RELEASE_VERSION: 1.36.0-rc.1
PROTOCOL_UPGRADE: TRUE
DATABASE_UPGRADE: TRUE
SECURITY_UPGRADE: FALSE
Protocol Changes
- The support for fixed shards in shard layout was removed. #9219
Protocol Upgrade Voting
This release contains a protocol upgrade. Voting for upgrading to protocol version 63 will start on 2023-09-26 15:00:00 UTC.
Database Upgrade
This release contains a database upgrade. STATE_SYNC_DUMP_KEY and STATE_SNAPSHOT_KEY was added to the BlockMisc column for support of state sync.
Non-protocol Changes
- New option
transaction_pool_size_limit
inconfig.json
allows to limit the size of the node's transaction pool.
By default the limit is set to 100 MB. #3284 - Database snapshots at the end of an epoch. This lets a node obtain state parts using flat storage. #9090
- Number of transactions included in a chunk will be lowered if there is a congestion of more than 20000 delayed receipts in a shard. #9222
- Our more efficient and scalable V2 routing protocol is implemented. It shadows the V1 protocol for now while we verify its performance. #9187
- The default config now enables TIER1 outbound connections by default. #9349
- State Sync from GCS is available for experimental use. #9398
Note around node performance
During internal testing of 1.36 we noticed nodes were impacted by a performance degradation manifesting as slowness in producing blocks. This impact was statistical, and the investigation we performed did not reveal any clear indicator of the rootcause of this degradation. In order to better assess this issue, we need to determine the behaviour of the 1.36 nodes in a real-life environment, such as testnet. After upgrading on testnet to 1.36, if you get kicked out or notice any performance issue, please reach out to us on the NEAR Validators Telegram channel with data regarding node configuration and performance.