Skip to content
Blockchain Certification

Introducing Heritage Sharding | Ripple


As rippled servers run, they regularly witness data appended onto an at any time-increasing blockchain certification. This data gets the historical past that the network agrees upon and that constitutes every thing about the XRP Ledger.

As with most blockchain certifications, it is vital that XRP Ledger historic info continue being commonly available to collaborating servers. Hence, every single rippled server shares the accountability of storing some historical past. But what if preserving the entire record of the XRP Ledger starts to exceed the storage facility of most individuals? For illustration, as of this producing, the space needed to store full heritage of the XRP Ledger is about 8 terabytes, a significant flash sum.

The record sharding characteristic, enabled in rippled version .90., addresses this issue by distributing historical past into segments known as shards. A shard has all of the info for a selection of ledgers. Employing the history sharding element, individual rippled servers can add to storing historical facts with out needing to store the whole history.

A shard store does not exchange a ledger retail store, but implements a responsible route toward dispersed ledger heritage throughout the XRP Ledger Community. The background of all ledgers is shared by servers agreeing to retain shards. This makes it achievable for servers to ensure that they have all the knowledge they agreed to retain, and develop proof trees or ledger deltas.

Simply because servers that are configured with background sharding randomly select the shards that they store, the total history of all closed ledgers is stored in a typical distribution curve, escalating the probability that the XRP Ledger Community evenly maintains the historical past.

Shard Retail store Validation

Starting with rippled edition .90., you can use the --validateShards command to examine that shard keep info is valid and regular with network background. For instance:

./rippled --validateShards

This operation verifies that all objects saved for each and every ledger saved in each and every shard are valid and dependable with the community. Run this command only when you start the server and observe that it may perhaps consider a whilst to entire.

Node Keep to Shard Retail outlet

Beginning with rippled version 1.., you can use the --nodetoshard command to import the information from an existing ledger keep into a shard keep. For illustration:

./rippled --nodetoshard

This command enables you to build shards based mostly on the heritage you already have. The command makes shards from complete ledger ranges in the ledger shop.

The command generates a copy of the data, so your server will have to have the added disk space expected by the shard maximum disk space environment (max_sizing_gb) in the rippled.cfg configuration file.

Downloadable Shard Archives

Starting with rippled model 1.1., you can use the down load_shard API process to obtain and import shard archives from an HTTPS internet server. For example:


A shard archive is a tar of a finish shard directory compressed with LZ4. Downloaded archives are checked to be legitimate and dependable with network background ahead of being imported.

For much more facts, see Background Sharding.