Crates.io | hashseq |
lib.rs | hashseq |
version | 0.1.0 |
source | src |
created_at | 2022-03-09 19:27:59.68084 |
updated_at | 2022-03-09 19:27:59.68084 |
description | A BFT Sequence CRDT suitable for unpermissioned networks with unbounded number of collaborators. |
homepage | https://github.com/davidrusu/hashseq |
repository | https://github.com/davidrusu/hashseq |
max_upload_size | |
id | 547133 |
size | 25,671 |
A Byzantine-Fault-Tolerant (BFT) Sequence CRDT suitable for unpermissioned networks with unbounded number of collaborators.
op | time | space |
---|---|---|
insert | O(n) | O(n) |
remove | O(n) | O(1) |
This is still a WIP, I think we can improve these substantially with some clever indexing strategies
Each insert produces a Node holding a value, the hashes of the immediate nodes to the left, and the immediate nodes to the right:
struct Node<V> {
value: V,
lefts: Set<Hash>,
rights: Set<Hash>,
}
E.g.
Inserting 'a', 'b', 'c' in sequential order produces the graph:
a <- b <- c
Inserting 'd' between 'a' and 'b'
a <- d -> b <- c
\_____/
We linearize these Hash Graphs by performing a biased topological sort.
The bias is used to decide a canonical ordering in cases where multiple linearizations satisfy the left/right constraints.
E.g.
s - a - m
/ \
h - i - ' ' ! - !
\ /
d - a - n
The above hash-graph can serialize to hi samdan!!
or hi dansam
or even any interleaving of sam/dan: hi sdaamn
, hi sdanam
, ... . We need a canonical ordering that preserves some semantic information, (i.e. no interleaving of concurrent runs)
The choice we make is: in a fork, we choose the branch whose starting element has the smaller hash, then to avoid interleaving of concurrent runs, our topological sort runs depth first rather than the traditional breadth first.
So in the above example, assuming hash(s)
< hash(d)
, we'd get is: hi samdan!!
.
If we detect hash-chains, we can collabse them to just the first left hashes and the right hashes:
struct Run<T> {
run: Vec<T>
lefts: Set<Hash>
rights: Set<Hash>
}
i.e. in the first example, a,b,c are sequential, they all have a common right hand (empty set), and their left hand is the previous element in the sequence.
So we could represent this as:
// a <- b <- c == RUN("abc")
Run {
run: "abc",
lefts: {},
rights: {}
}
Inserting 'd' splits the run:
a <- d -> RUN("bc")
\_____/
And the fork example:
RUN("sam")
/ \
RUN("hi ") RUN("!!")
\ /
RUN("dan")
This way we only store hashes at forks, the rest can be recomputed when necessary.