Skip to content

Current Architecture

Sathishkumar edited this page Aug 14, 2026 · 1 revision

Current Architecture

Overview

The current Firebolt native client exposes synchronous APIs while internally utilizing an asynchronous JSON-RPC transport.

High-Level Architecture

+-------------+
| Application |
+-------------+
        |
        v
+-------------------+
| Firebolt Client   |
+-------------------+
        |
        v
+--------------------+
| Firebolt Transport |
+--------------------+
        |
        v
+------------------+
| Firebolt Server  |
+------------------+


## Request Lifecycle
* Application invokes API.
* Gateway creates Promise.
* Promise stored using JSON-RPC request ID.
* Request sent to Firebolt Server.
* Response received.
* Promise resolved.
* Result returned to caller.

## Gateway Responsibilities
* JSON-RPC request generation
* Response correlation
* Promise lifecycle management
* Timeout management
* Watchdog processing

Clone this wiki locally