Skip to content

Add support for multiple key-value stores. #98

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
PiotrSikora merged 4 commits into from
Aug 11, 2026
Merged

Add support for multiple key-value stores. #98

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
858d105
Add support for multiple key-value stores.
PiotrSikora Feb 12, 2026
83bd221
review: style.
PiotrSikora Aug 11, 2026
0354f58
review: add `CREATED`.
PiotrSikora Aug 11, 2026
949906f
Merge remote-tracking branch 'origin/main' into PiotrSikora/multiple_…
PiotrSikora Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions abi-versions/vNEXT/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1471,6 +1471,34 @@ gRPC status message can be retrieved using [`proxy_get_status`].

### Functions exposed by the host

#### `proxy_open_kvstore`

* params:
- `i32 (const char*) kvstore_name_data`
- `i32 (size_t) kvstore_name_size`
Comment thread
PiotrSikora marked this conversation as resolved.
- `i32 (bool) create_if_not_exist`
- `i32 (uint32_t*) return_kvstore_id`
* returns:
- `i32 (`[`proxy_status_t`]`) status`

Opens named key-value store (`kvstore_name_data`, `kvstore_name_size`).

If `create_if_not_exist` is `true` and there is no shared key-value store with
the given name, then a new store will be created.

Key's value can be set using `proxy_set_shared_data` and retrieved using
`proxy_get_shared_data` from the key-value store using returned unique key-value
store identifier (`return_kvstore_id`).

Returned `status` value is:
- `OK` on success when opening existing key-value store.
- `CREATED` on success when a key-value store with the given name was created.
- `NOT_FOUND` when `create_if_not_exist` is `false` and no shared key-value
store with the given name exists.
- `INVALID_MEMORY_ACCESS` when `kvstore_name_data`, `kvstore_name_size`
and/or `return_kvstore_id` point to invalid memory address.


#### `proxy_set_shared_data`

* params:
Expand Down Expand Up @@ -1526,6 +1554,20 @@ Returned `status` value is:
point to invalid memory address.


#### `proxy_delete_kvstore`

* params:
- `i32 (uint32_t) kvstore_id`
* returns:
- `i32 (`[`proxy_status_t`]`) status`

Deletes previously created shared key-value store (`kvstore_id`).

Returned `status` value is:
- `OK` on success.
- `UNKNOWN_RESOURCE_ID` for unknown `kvstore_id`.


## Shared Queues

> **Note**
Expand Down Expand Up @@ -2175,8 +2217,10 @@ changes to unrelated connections/requests.
[`proxy_on_grpc_receive`]: #proxy_on_grpc_receive
[`proxy_on_grpc_receive_trailing_metadata`]: #proxy_on_grpc_receive_trailing_metadata
[`proxy_on_grpc_close`]: #proxy_on_grpc_close
[`proxy_open_kvstore`]: #proxy_open_kvstore
[`proxy_set_shared_data`]: #proxy_set_shared_data
[`proxy_get_shared_data`]: #proxy_get_shared_data
[`proxy_delete_kvstore`]: #proxy_delete_kvstore
[`proxy_open_shared_queue`]: #proxy_open_shared_queue
[`proxy_enqueue_shared_queue`]: #proxy_enqueue_shared_queue
[`proxy_dequeue_shared_queue`]: #proxy_dequeue_shared_queue
Expand Down