Skip to content
Blockchain Certification

Introducing History Sharding | Ripple


As rippled servers work, they frequently witness information appended onto an at any time-rising blockchain certification. This information gets the background that the community agrees upon and that constitutes all the things about the XRP Ledger.

As with most blockchain certifications, it is imperative that XRP Ledger historic facts remain readily available to collaborating servers. Hence, each rippled server shares the duty of storing some history. But what if maintaining the whole background of the XRP Ledger starts off to exceed the storage facility of most members? For case in point, as of this producing, the place expected to retail outlet comprehensive heritage of the XRP Ledger is in excess of 8 terabytes, a significant flash sum.

The record sharding feature, enabled in rippled variation .90., addresses this situation by distributing heritage into segments identified as shards. A shard has all of the knowledge for a selection of ledgers. Working with the heritage sharding element, person rippled servers can lead to storing historic knowledge devoid of needing to store the complete history.

A shard store does not replace a ledger store, but implements a trusted route towards distributed ledger record throughout the XRP Ledger Network. The historical past of all ledgers is shared by servers agreeing to preserve shards. This tends to make it achievable for servers to confirm that they have all the facts they agreed to maintain, and deliver proof trees or ledger deltas.

Mainly because servers that are configured with heritage sharding randomly select the shards that they retailer, the comprehensive heritage of all closed ledgers is stored in a standard distribution curve, escalating the chance that the XRP Ledger Community evenly maintains the historical past.

Shard Store Validation

Commencing with rippled edition .90., you can use the --validateShards command to look at that shard retailer facts is legitimate and consistent with community background. For instance:

./rippled --validateShards

This procedure verifies that all objects saved for every single ledger saved in each individual shard are valid and consistent with the community. Run this command only when you begin the server and note that it may choose a although to full.

Node Retailer to Shard Retail store

Starting with rippled version 1.., you can use the --nodetoshard command to import the information from an current ledger retail outlet into a shard keep. For instance:

./rippled --nodetoshard

This command enables you to produce shards primarily based on the background you already have. The command results in shards from finish ledger ranges in the ledger retail store.

The command produces a copy of the facts, so your server must have the supplemental disk house expected by the shard maximum disk space location (max_size_gb) in the rippled.cfg configuration file.

Downloadable Shard Archives

Commencing with rippled version 1.1., you can use the obtain_shard API technique to download and import shard archives from an HTTPS website server. For instance:


A shard archive is a tar of a total shard listing compressed with LZ4. Downloaded archives are checked to be legitimate and regular with network background in advance of becoming imported.

For extra data, see Background Sharding.