hyperledger / hyperledger/fabric-x-evm

Design HA Database Architecture

Open
#64 0 comments 0 reactions 0 assignees View on GitHub
task
Dominant language
Go
Stars
12
Forks
18
Avg merge
4d 18h
Merged PRs (30d)
23

Description

Analyze and document the architectural tradeoffs between using a replicated database shared by multiple Gateway replicas versus having each replica maintain its own local database with a single writer feeding data. A shared PostgreSQL database enables multiple Gateway replicas to serve queries from the same data source, providing high availability and load balancing for read queries. However, it introduces complexity around concurrent writes, requires database replication and failover mechanisms, and creates a potential single point of failure. Alternatively, each Gateway replica could maintain its own local SQLite database with only one replica actively synchronizing blocks, providing simpler architecture but requiring client-side load balancing and handling of stale reads. Document the pros and cons of each approach, recommend a solution based on production requirements, and design the implementation accordingly.

---

**Quarter:** Q3

Contributor guide

No contributing guide indexed for this repository

Research direction

The issue names no files, tests, or entry points. Start by mapping the Gateway replicas, block synchronization, and database interactions, then compare shared PostgreSQL with per-replica SQLite against production requirements; done means a documented tradeoff analysis, recommendation, and implementation design.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, postgresql, sqlite
Domain
backend, databases, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.