[actors] Introduce Mailbox (#3739)

Author: patrick-ogrady

.github/workflows/publish.yml

@@ -60,6 +60,11 @@ jobs:
       continue-on-error: true
       env:
         CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+    - name: Publish actor
+      run: cargo publish --manifest-path actor/Cargo.toml
+      continue-on-error: true
+      env:
+        CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
     - name: Publish math
       run: cargo publish --manifest-path math/Cargo.toml
       continue-on-error: true

Cargo.lock

@@ -1,5 +1,6 @@
 [workspace]
 members = [
+    "actor",
     "broadcast",
     "codec",
     "coding",
@@ -96,6 +97,7 @@ chacha20poly1305 = { version = "0.10.1", default-features = false }
 chrono = "0.4.39"
 clap = "4.5.18"
 colored = "3.0.0"
+commonware-actor = { version = "2026.4.0", path = "actor" }
 commonware-broadcast = { version = "2026.4.0", path = "broadcast" }
 commonware-codec = { version = "2026.4.0", path = "codec", default-features = false }
 commonware-coding = { version = "2026.4.0", path = "coding" }
@@ -134,7 +136,7 @@ ed25519-zebra = "4.1.0"
 either = "1.13.0"
 futures = "0.3.31"
 futures-timer = "3.0.3"
-futures-util = "0.3.31"
+futures-util = { version = "0.3.31", default-features = false, features = ["std"] }
 governor = "0.10.2"
 hashbrown = { version = "0.16.1", default-features = false, features = ["default-hasher"] }
 io-uring = "0.7.4"

Cargo.toml

@@ -12,6 +12,7 @@
 
 _Primitives are designed for deployment in adversarial environments. If you find an exploit, please refer to our [security policy](./SECURITY.md) before disclosing it publicly (an exploit may equip a malicious party to attack users of a primitive)._
 
+* [actor](./actor/README.md): Safely coordinate concurrent components.
 * [broadcast](./broadcast/README.md): Disseminate data over a wide-area network.
 * [codec](./codec/README.md): Serialize structured data.
 * [coding](./coding/README.md): Encode data to enable recovery from a subset of fragments.

README.md

@@ -0,0 +1,38 @@
+[package]
+name = "commonware-actor"
+edition.workspace = true
+publish = true
+version.workspace = true
+license.workspace = true
+description = "Safely coordinate concurrent components."
+readme = "README.md"
+homepage.workspace = true
+repository = "https://github.com/commonwarexyz/monorepo/tree/main/actor"
+documentation = "https://docs.rs/commonware-actor"
+
+[lints]
+workspace = true
+
+[dependencies]
+cfg-if.workspace = true
+commonware-macros.workspace = true
+crossbeam-queue.workspace = true
+futures-util.workspace = true
+loom = { workspace = true, features = ["futures"], optional = true }
+parking_lot.workspace = true
+
+[dev-dependencies]
+commonware-utils.workspace = true
+criterion.workspace = true
+futures.workspace = true
+
+[features]
+loom = [ "dep:loom" ]
+
+[lib]
+bench = false
+
+[[bench]]
+name = "mailbox"
+harness = false
+path = "src/benches/bench.rs"

actor/Cargo.toml

@@ -0,0 +1,10 @@
+# commonware-actor
+
+[![Crates.io](https://img.shields.io/crates/v/commonware-actor.svg)](https://crates.io/crates/commonware-actor)
+[![Docs.rs](https://docs.rs/commonware-actor/badge.svg)](https://docs.rs/commonware-actor)
+
+Safely coordinate concurrent components.
+
+## Status
+
+Stability varies by primitive. See [README](https://github.com/commonwarexyz/monorepo#stability) for details.

actor/README.md

@@ -0,0 +1,5 @@
+use criterion::criterion_main;
+
+mod mailbox;
+
+criterion_main!(mailbox::benches);