1. Home
  2. Docs
  3. Conflux Network
  4. Run Conflux Light Node

Run Conflux Light Node

Run a Conflux Light Node


Light nodes are special nodes in the Conflux network that store block headers only, and retrieve everything else from their peers on-demand. This means that by default, light nodes do not store transactions, nor do they store the state trees. This can drastically reduce the disk and bandwidth use of light nodes compared to full and archive nodes, especially under high TPS. As a trade-off, RPC queries have a higher latency on light nodes.

Light nodes execute GHAST consensus on their local header graph, and they also verify each item retrieved on-demand using Merkle proofs and other similar mechanisms. Items retrieved on-demand include accounts, bloom filters, transactions, and transaction receipts. This means that, while light nodes need to rely on their peers to fulfill RPC queries, they do this in a trustless manner.

The current light node implementation is still considered experimental, bugs are expected to exist. If you encounter any issues, please let us know by opening an issue on the conflux-rust repository.

Running a light node
Light nodes are implemented as a part of the official conflux-rust binary and can be enabled using the --light command line flag.

Please start by downloading the latest release from the conflux-rust repository, or by building from source following this guide. Then, you can simply run the node using these commands:
> cd run > ./conflux --config tethys.toml --light 2> stderr.txt

Alternatively, if you want your node to connect to the testnet, you will need to pass testnet.toml instead. Similarly to full nodes, you will know when your node is fully synced with the network once it prints:
Catch-up mode: false

Was this article helpful to you? Yes No

How can we help?