Label: Blockchain

Pages about how the XRP Ledger functions as a blockchain.

Concepts

Introduction Introduction to Consensus
Develop a basic understanding of the XRP Ledger's consensus mechanism.
Payment System Basics Ledgers
The XRP Ledger is composed of a series of individual ledgers, or ledger versions, which rippled keeps in its internal database. Learn about the structure and contents of these ledgers.
Transaction Basics Finality of Results
Learn when the outcome of a transaction is final and immutable.
Consensus Network Consensus
Understand the role of consensus in the XRP Ledger.
Consensus Network Consensus Principles and Rules
The rules and principles of the consensus algorithm that allow users to transfer funds (including fiat currencies, digital currencies and other forms of value) across national boundaries as seamlessly as sending an email.
Consensus Network Consensus Protections Against Attacks and Failure Modes
Learn how the XRP Ledger Consensus Protocol is protected against various problems and attacks that may occur in a decentralized financial system.
Consensus Network Invariant Checking
Understand what Invariant Checking is, why it exists, how it works, and what invariant checks are active.
Consensus Network Negative UNL
Understand how Negative UNL improves the ledger's resilience during partial outages.
Consensus Network Amendments
Amendments represent new features or other changes to transaction processing. Validators coordinate through consensus to apply these upgrades to the XRP Ledger in an orderly fashion.
Amendments Known Amendments
List of all known amendments to the XRP Ledger protocol and their status.
Consensus Network Consensus Research
Scholarly articles on consensus algorithms and related research.
Consensus Network Parallel Networks
Understand how test networks and alternate ledger chains relate to the production XRP Ledger.
Consensus Network Federated Sidechains
Learn about federated sidechains, which enable value in the form of XRP and other tokens (IOUs) to move efficiently between a sidechain and the XRP Ledger.
XRP Ledger Servers Ledger History
rippled servers store a variable amount of transaction and state history locally.
XRP Ledger Servers Peer Protocol
The peer protocol specifies the language rippled servers speak to each other.
XRP Ledger Servers Transaction Censorship Detection
XRP Ledger provides an automated transaction censorship detector that is available on all rippled servers.

Tutorials

Install rippled Build and Run rippled in Reporting Mode
Build and run a special operating mode of rippled that handles remote procedure calls (RPC) for validated data.
Configure rippled Run rippled as a Validator
Have your server vote on the consensus ledger.
Configure rippled Configure Amendment Voting
Set your server's votes on protocol amendments.
Configure rippled Test Amendments
You can test proposed amendments before they're enabled on the network.
Configure rippled Connect Your rippled to a Parallel Network
Connect your rippled server to the test net to try out new features or test functionality with fake money.

References

Ledger Data Formats Ledger Header
A unique header that describes the contents of a ledger version.
Ledger Object Types Amendments
Singleton object with status of enabled and pending amendments.
Ledger Object Types LedgerHashes
Lists of prior ledger versions' hashes for history lookup.
Ledger Object Types NegativeUNL
List of validators currently believed to be offline.
Transaction Reference Transaction Types
All the different types of transactions that the XRP Ledger can process.
Transaction Reference Pseudo-Transactions
Formats of pseudo-transactions that validators sometimes apply to the XRP Ledger.
Pseudo-Transactions EnableAmendment
Enable a change in transaction processing.
Pseudo-Transactions UNLModify
Change the list of trusted validators currently considered offline.
Transaction Reference Transaction Metadata
Transaction metadata describes the outcome of the transaction in detail, regardless of whether the transaction is successful.
XRP Ledger Protocol Reference Serialization Format
Conversion between JSON and canonical binary format for XRP Ledger transactions and other objects.
Ledger Methods ledger
Get info about a ledger version.
Ledger Methods ledger_closed
Get the latest closed ledger version.
Ledger Methods ledger_current
Get the current working ledger version.
Ledger Methods ledger_data
Get the raw contents of a ledger version.
Ledger Methods ledger_entry
Get one element from a ledger version.
Subscription Methods subscribe
Listen for updates about a particular subject.
Subscription Methods unsubscribe
Stop listening for updates about a particular subject.
Server Info Methods manifest
Look up the public information about a known validator.
Clio Server Methods ledger
Get info about a ledger version.
Status and Debugging Methods consensus_info
Get information about the state of consensus as it happens.
Status and Debugging Methods feature
Get information about protocol amendments.
Status and Debugging Methods validator_list_sites
Get information about sites that publish validator lists.
Status and Debugging Methods validators
Get information about the current validators.
Peer Port Methods Peer Crawler
Special API method for sharing network topology and status metrics.
Peer Port Methods Validator List Method
Special API method for sharing recommended validator lists.