Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add trusted hash doc resolve #1460 #1651

Merged
merged 3 commits into from
Jul 31, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .vitepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -448,6 +448,10 @@ function sidebarHome() {
text: "Custom networks and values",
link: "/nodes/celestia-node-custom-networks",
},
{
text: "Syncing a light node from a trusted hash",
link: "/nodes/celestia-node-trusted-hash",
},
{
text: "Troubleshooting",
link: "/nodes/celestia-node-troubleshooting",
Expand Down
38 changes: 38 additions & 0 deletions nodes/celestia-node-trusted-hash.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
description: How to sync a light node from a trusted hash.
---

# Syncing a light node from a trusted hash

This guide goes over how to sync a DA light node from a trusted hash.
The example is with Mainnet Beta. You will need to adjust the commands
accordingly for Mocha, Arabica, or a custom network.

::: warning
Syncing to a trusted hash means that you will not sample the entire chain. This adds a trust
assumption that you trust the history of the chain up to that point and that you trust the entity
where you get the hash from. In this example, the trusted entity is a consensus endpoint or
Celenium
:::

1. Get trusted height & hash from a consensus endpoint or [Celenium](https://celenium.io).
1. Initialize the node store

```sh
celestia light init
```

1. Set the trusted height & hash
1. Open your config.toml at `.celestia-light/config.toml` (or `.celestia-light-<other-network>/config.toml`)
1. Set `DASer.SampleFrom` to the trusted height (e.g. `SampleFrom = 123456`)
1. Run the node with the hash and flag:

```sh
celestia light start --headers.trusted-hash <hash_of_block_n>
```

## For service operators

If you're using multiple light nodes for similar services like tracking the same rollup,
it is recommended to use the same hash and height for them all services using
the same starting height.
Loading