Rust implementation of Dataspaces, Syndicate, and a high-speed networked dataspace broker.
Go to file
Tony Garnock-Jones 2384b29754 (cargo-release) version 0.3.0-alpha.0 2021-08-13 12:51:18 -04:00
dev-scripts dev-scripts 2021-08-13 12:41:48 -04:00
syndicate (cargo-release) version 0.8.0-alpha.0 2021-08-13 12:50:40 -04:00
syndicate-macros (cargo-release) version 0.3.0-alpha.0 2021-08-13 12:51:18 -04:00
syndicate-server (cargo-release) version 0.3.0-alpha.0 2021-08-13 12:51:18 -04:00
.gitignore Use OUT_DIR 2021-08-10 22:07:48 -04:00
Cargo.lock (cargo-release) version 0.3.0-alpha.0 2021-08-13 12:51:18 -04:00
Cargo.toml Initial commit of syndicate-macros crate, still incomplete 2021-08-12 23:58:23 -04:00
Makefile Copy Makefile from preserves 2021-08-13 12:40:31 -04:00
README.md Split out syndicate-server crate 2021-08-12 21:42:14 -04:00
rust-toolchain Split out syndicate-server crate 2021-08-12 21:42:14 -04:00
syndicate-rs-server.png README.md 2021-05-12 15:36:27 +02:00

README.md

Syndicate/rs

A Rust implementation of:

  • the Syndicated Actor model (partial; includes assertion-based communication, failure-handling, capability-style security, and dataspace entities, but not (yet) facets as a structuring principle);

  • the Syndicate network protocol, including

    • a high-speed Dataspace indexing structure (skeleton.rs; see also HOWITWORKS.md from syndicate-rkt) and

    • a standalone Syndicate protocol "broker" service (roughly comparable in scope and intent to D-Bus); and

  • a handful of example programs.

The Syndicate/rs server running.
The Syndicate/rs server running.

Quickstart

git clone https://git.syndicate-lang.org/syndicate-lang/syndicate-rs
cd syndicate-rs
cargo build --release
./target/release/syndicate-server

Running the examples

In one window, start the server:

./target/release/syndicate-server

Then, choose one of the examples below.

Producer/Consumer (sending messages)

In a second window, run a "consumer" process:

./target/release/examples/consumer

Finally, in a third window, run a "producer" process:

./target/release/examples/producer

State producer/consumer (state replication)

Replace producer with state-producer and consumer with state-consumer, respectively, in the instructions of the previous subsection to demonstrate Syndicate state replication.

Pingpong example (latency)

In a second window, run

./target/release/examples/pingpong pong

and in a third window, run

./target/release/examples/pingpong ping

The order is important - the difference between ping and pong is about who kicks off the pingpong session.

Performance note

You may find better performance by restricting the server to fewer cores than you have available. For example, for me, running

taskset -c 0,1 ./target/release/syndicate-server

roughly quadruples throughput for a single producer/consumer pair, on my 48-core AMD CPU.