From 80797b08629f34978ddf2f3a6f145f850e8b0580 Mon Sep 17 00:00:00 2001
From: Ivan Reshetnikov <keenn2007@gmail.com>
Date: Wed, 10 Apr 2024 14:38:58 +0200
Subject: [PATCH] feat(relay): `irn_batchRequest` method

---
 docs/specs/servers/relay/relay-server-rpc.md | 26 ++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/docs/specs/servers/relay/relay-server-rpc.md b/docs/specs/servers/relay/relay-server-rpc.md
index cd1dfd75..e220c209 100644
--- a/docs/specs/servers/relay/relay-server-rpc.md
+++ b/docs/specs/servers/relay/relay-server-rpc.md
@@ -424,6 +424,32 @@ Used to unregister an active watch webhook corresponding to a webhookId.
 }
 ```
 
+### Batch Request
+
+Allows combining multiple requests into a single one. Used to save on round-trip latency.
+
+```jsonc
+// Request (client->server)
+{
+  "id" : "1",
+  "jsonrpc": "2.0",
+  "method": "irn_batchRequest",
+  "params" : {
+    "batch": Request[],
+    "mode": "sequence" | "concurrent"
+  }
+}
+
+// Response (server->client)
+{
+  "id" : "1",
+  "jsonrpc": "2.0",
+  "result": true
+}
+```
+
+Requests in the batch are executed either concurrently or in sequence, as specified in the `mode` parameter. Responses to each request in the batch are sent back separately and immediately after the request has been processed. Once all of the requests have been processed, the batch response is sent to the client.
+
 ## FAQ
 
 - What is a client? - Any SDK instance (Sign, Chat, Auth, Push)