ledger-sync

Ledger Sync Service

The ledger sync service is a collection of three flows, designed to recover contract transactions shared with nodes in a business network. The intended use case is to validate the integrity of a node for monitoring and reporting purposes mainly. The actual recovery of transaction should be a last resort if other resiliency techniques are exhausted, particularity taking into account the fact the types of transactions that are recoverable are a subset of all possible types of transactions.

Flows can be composed in a four-step process from the perspective of a node that suspects the vault has lost integrity. The flows can be utilised in the following way:

1. Determine potential counter parties by querying the business network operator.
2. Evaluate pairwise if the ledger is consistent with regards to the transactions the counter party holds.
3. If inconsistencies are flagged, the counter party can be queried for a more detailed report based on which both the parties can take further action (such as notifying the BNO) or recover the transactions found.
4. Transaction IDs can then be used in the transaction recovery flow to recover individual transactions from counter parties.

How to add Ledger Sync Service to your project

Add the following lines to repositories and dependencies blocks of your build.gradle file:

repositories {
    maven {
      url 'https://ci-artifactory.corda.r3cev.com/artifactory/corda-solutions-releases'
    }
}

dependencies {
    cordapp "com.r3.businessnetworks:ledger-sync-service:2.0"
}