summaryrefslogtreecommitdiffstats
path: root/docs/rfc.txt
diff options
context:
space:
mode:
authorbt <bt@rctt.net>2026-05-16 18:34:07 +0200
committerbt <bt@rctt.net>2026-05-16 22:46:48 +0200
commitc04c73a4df223c8c2b2b42ed482fc0181948e6ea (patch)
tree5f42522ddfb880a677b92a4492c42fdb786e23b2 /docs/rfc.txt
parentb5d08e7908efaa2d9eae9a3d52249bbb51be0761 (diff)
downloadsolec-c04c73a4df223c8c2b2b42ed482fc0181948e6ea.tar.gz
solec-c04c73a4df223c8c2b2b42ed482fc0181948e6ea.zip
Update docs
Diffstat (limited to 'docs/rfc.txt')
-rw-r--r--docs/rfc.txt38
1 files changed, 33 insertions, 5 deletions
diff --git a/docs/rfc.txt b/docs/rfc.txt
index a9a4e0c..4805ab7 100644
--- a/docs/rfc.txt
+++ b/docs/rfc.txt
@@ -1,7 +1,7 @@
SOLEC Working Group bt, Ed.
Internet-Draft RCTT.net
-Intended status: Experimental 3 May 2026
-Expires: 4 November 2026
+Intended status: Experimental 16 May 2026
+Expires: 17 November 2026
System of Lightweight Electronic Communication
@@ -33,7 +33,8 @@ Table of Contents
2.4.5. ServerAuth
2.4.6. Message
2.4.7. Usermode
- 2.4.8. Test
+ 2.4.8. GetHistory
+ 2.4.9. Test
2.5. Sequential operations
2.6. Client-Server connection initialisation
2.7. Exchanging messages between servers
@@ -310,7 +311,34 @@ Table of Contents
Table 10
-2.4.8. Test
+2.4.8. GetHistory
+
+ Read messages previously send to a specific channel. User has to
+ member of the channel to perform this action. _since_ field specifies
+ start of time range for which history should be retrieved. _count_
+ specifes how many messages should be returned in a single response.
+ _GetHistory_ is a locking sequence and it cannot be cancelled while
+ in progress so _count_ should be set relatively low. To get more
+ messages use multiple requests with incremented _offset_.
+
+ Response is just a sequence of _Message_. Client should use
+ _Timestamp_ field of a _Message_ to show them in corrent order.
+
+ +===========+==============+
+ | Type | Name |
+ +===========+==============+
+ | string | channel_name |
+ +-----------+--------------+
+ | timestamp | since |
+ +-----------+--------------+
+ | int64 | count |
+ +-----------+--------------+
+ | int64 | offset |
+ +-----------+--------------+
+
+ Table 11
+
+2.4.9. Test
Test payload is used for encoder and decoders testing. Clients and
servers should ignore this kind of payload.
@@ -335,7 +363,7 @@ Table of Contents
| uint64 | num4 |
+-----------+-------+
- Table 11
+ Table 12
2.5. Sequential operations