Skip to content

Commit 040cb70

Browse files
committed
Add changelog entry
1 parent 0f72ee8 commit 040cb70

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

cardano-node/ChangeLog.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,29 @@
1717

1818
- Use metric names of old-tracing in new-tracing as well, and fix some metrics in new tracing.
1919

20+
- Optionally support lightweight checkpointing.
21+
22+
This PR adds optional support for *lightweight checkpointing*. Concretely, a file can contain a list of checkpoints (each consisting of a block number and a corresponding block hash). When validating a header/block with a block number with a corresponding checkpoint, we consider the header/block to be invalid if their actual hash does not coincide with the hash from the checkpoint.
23+
24+
This is only expected to be used in certain disaster recovery scenarios, so ideally never. See [CIP-0135](https://github.com/cardano-foundation/CIPs/blob/master/CIP-0135/README.md) for more details.
25+
26+
> ⚠️ Specifying a checkpoints file requires great care; incorrect entries can lead the node to be stuck on adversarial chains forever!
27+
28+
Concretely, the node configuration file has two new optional entries:
29+
```yaml
30+
CheckpointsFile: "/path/to/checkpoints.json"
31+
CheckpointsFileHash: "a71c47262163947daaefb6aa1112acf34cb5ded6841d51e27dd642eb2de355a3"
32+
```
33+
34+
The `checkpoints.json` file has the following format:
35+
```json
36+
{
37+
"checkpoints": [
38+
{"blockNo": 3, "hash": "52b7912de176ab76c233d6e08ccdece53ac1863c08cc59d3c5dec8d924d9b536"}
39+
]
40+
}
41+
```
42+
2043
## 8.2.1 -- August 2023
2144

2245
- prevent SIGHUP from killing node during ledger replay

0 commit comments

Comments
 (0)