Skip to content
Closed
Changes from all commits
Commits
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
21 changes: 21 additions & 0 deletions specs/channel-sync-highlevel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Channel sync – high-level notes

This document captures a high-level view of how channel-based replication and sync are expected to behave in Malachite.

It is not a formal specification. Instead, it is a starting point for discussions and more detailed specs.

## Goals

- Keep replicas in sync with minimal latency under normal network conditions.
- Provide clear semantics for how messages are ordered and committed.
- Make it easy to reason about the behavior of applications built on top of channels.

## Questions to answer

When refining this document into a full spec, we should explicitly answer:

- How do channels behave under sustained network partitions?
- What are the guarantees about message delivery and reordering?
- How do we expose progress (e.g. "all messages up to index N are committed") to applications?

As these questions are clarified and implemented, this document can be updated with links to more detailed protocol descriptions and test plans.