Skip to content

Commit 7323965

Browse files
committed
Add changelog entry
1 parent 5d7295d commit 7323965

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

cardano-node/ChangeLog.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,30 @@
1212

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

15+
- Optionally support lightweight checkpointing.
16+
17+
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.
18+
19+
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.
20+
21+
> [!WARNING]
22+
> Specifying a checkpoints file requires great care; incorrect entries can lead the node to be stuck on adversarial chains forever!
23+
24+
Concretely, the node configuration file has two new optional entries:
25+
```yaml
26+
CheckpointsFile: "/path/to/checkpoints.json"
27+
CheckpointsFileHash: "a71c47262163947daaefb6aa1112acf34cb5ded6841d51e27dd642eb2de355a3"
28+
```
29+
30+
The `checkpoints.json` file has the following format:
31+
```json
32+
{
33+
"checkpoints": [
34+
{"blockNo": 3, "hash": "52b7912de176ab76c233d6e08ccdece53ac1863c08cc59d3c5dec8d924d9b536"}
35+
]
36+
}
37+
```
38+
1539
## 8.2.1 -- August 2023
1640

1741
- prevent SIGHUP from killing node during ledger replay

0 commit comments

Comments
 (0)