Nodes in the Chromia network

A node in the Chromia network is a computer, either a virtual or physical server, that runs the core Chromia software known as Postchain and the open-source relational database, PostgreSQL. Each node contains a unique cryptographic key pair and identifies itself on the network using its public key. In this section, we explore how Postchain powers the network by managing decentralized transaction processing and data storage.

Overview of Postchain

Postchain serves as the core software that controls blockchain operations and integrates them with the PostgreSQL relational database. It acts as the backbone of Chromia, enabling decentralized transaction processing and maintaining data consistency across multiple nodes.

Postchain handles several key tasks on Chromia's nodes, including:

• Transaction processing: It accepts and processes signed transactions submitted by users or applications.
• Consensus management: The system employs the eBFT (Enhanced Byzantine Fault Tolerance) consensus protocol to validate blocks and achieve agreement among nodes.
• Data storage: It interacts with PostgreSQL to store blockchain data, including the history of verified transactions and the states of each decentralized application (dapp) on its individual blockchain.
• Dapp code execution: It executes dapp-specific code written in the Rell programming language and translates operations into database actions that update the state of each dapp.

PostgreSQL integration and indexing

Postchain integrates with PostgreSQL to enable automatic data indexing, which allows Chromia to support complex relational queries directly on-chain. This integration significantly improves performance for both read and write operations, enhancing data accessibility and flexibility for developers. With these features, dapp developers can:

• Retrieve specific data points or datasets using advanced filters, thus avoiding the need to pull entire data arrays.
• Perform relational queries across multiple tables or entities, enabling complex on-chain data interactions without depending on off-chain processing.

These capabilities empower developers to build data-rich, complex dapps that leverage Chromia’s on-chain database integration for optimal efficiency and functionality.

Transaction lifecycle on Postchain

The transaction lifecycle on Postchain involves several interconnected tasks that ensure proper reception, processing, and storage of each transaction. These tasks include:

Receiving transactions

To execute a transaction for a dapp on the Chromia network, a user or client sends the transaction to any node running the dapp via the node's REST API. This process involves sending the transaction to any node within the cluster that hosts the dapp. Transactions follow Chromia's Generic Transaction Protocol (GTX) and consist of the following:

• The unique ID of the dapp chain on the network (known as the Blockchain RID).
• A list of operations and their corresponding arguments, which developers define in the dapp's code. This setup allows users to execute these operations through transactions and modify data, establishing the transaction's purpose.
• A list of signers along with their signatures.

Building blocks and verifying consensus

When a node receives a transaction, it quickly multicasts the transaction to all other nodes in the cluster. These nodes verify consensus using Chromia's eBFT algorithm, which is a modified version of Practical Byzantine Fault Tolerance. eBFT functions as a Proof-of-Authority (PoA) algorithm, allowing a select group of validator nodes to create new blocks. The validator nodes in the dapp's cluster work together to achieve consensus, ensuring that only valid transactions are added to the blockchain and that the network remains secure and resilient.

In the eBFT process, a node proposes a block, and the other validators accept the proposal if it receives a supermajority (more than two-thirds) of signatures. The validator nodes take turns creating the next block. This consensus process follows these steps:

1. The primary node collects all incoming transactions within a specific (configurable) time interval and adds them to the proposed block for the current round.
2. It multicasts the proposed block to all other nodes.
3. Upon receiving the proposed block, the other nodes validate it by executing the transactions (without altering the database). If the block is valid, they sign it and multicast their signatures to all other nodes, including the primary node.
4. Once the primary node receives signatures from more than two-thirds of the nodes, each node commits the block to its database.

The consensus algorithm can withstand nearly one-third of the nodes in a cluster acting maliciously, turning off, or isolating themselves from the rest of the network. After the network reaches consensus on a block of transactions, those transactions can be safely committed.

Executing dapp code

Developers write dapps on the Chromia network using Rell, a programming language specifically designed for the platform. Rell simplifies the process of working with Chromia's relational blockchain model. When transactions occur, Postchain interprets and executes the dapp code, performing the specified operations using the provided arguments in the transaction.

Updating the relational database

Each dapp on Chromia operates with its own instance of a relational database. When developers deploy a new dapp or update an existing one, Postchain interprets the dapp's code to determine the required database tables. It automatically creates the necessary tables and columns, ensuring that the dapp functions smoothly.

Postchain updates the database as transactions occur. When transactions invoke operations defined in the dapp’s Rell code, Postchain translates this code into SQL queries, updating the dapp's data and state. Rell prevents developers from executing raw SQL queries directly, providing an abstraction that limits access to their own data while offering a more convenient and expressive way to interact with the database.

Additionally, Postchain stores system-level data in the relational database, including each dapp's blockchain and the history of verified transactions. If needed, developers can combine and replay this information to restore each dapp's database state at any block height, ensuring data integrity across the network.

Responding to queries

In addition to transactions that invoke operations and modify data, Chromia enables developers to perform read-only queries within decentralized applications (dapps). Similar to transactions, you typically execute queries using one of Chromia's client libraries. However, unlike transactions, nodes running Postchain quickly respond to read-only queries without needing to verify consensus. This efficiency allows you to implement your own consensus verification strategy on the client or frontend if necessary. For example, you could randomly select a node from the cluster for a query, or in more complex scenarios, you might query multiple nodes and validate consensus on the frontend.

You define queries in Rell, making them an integral part of the deployed code for a dapp. They automatically become part of the dapp's API and you can invoke them through a client library by providing the necessary arguments.

Dapp containers

Dapps on the Chromia network each receive dedicated compute and storage resources to ensure consistent performance. Each node in the network runs several instances of the core software, Postchain. The primary instance operates directly on the node machine and spawns containers (isolated virtual machines) to host specific dapps. This setup allows the main instance to efficiently route transactions and events to the relevant container. From an external perspective, each node functions as a single entity on the Chromia network, capable of accepting transactions intended for any of the dapps it hosts.

The relational database

Each dapp container hosts its own instance of a PostgreSQL relational database to support the respective dapp. This database stores:

• Dapp data, with tables corresponding to entities defined in the dapp's Rell code.
• An individual blockchain for the dapp.
• A complete history of verified transactions related to the dapp.
• Node configuration settings, including addresses of peer nodes within the cluster.
• Replicas of the system chain.

Next up

After exploring the structure of nodes in the Chromia network, we will now examine the Chromia architecture.