fix: protocol units structuring.

Author: l-monninger

protocol-units/README.md

@@ -2,4 +2,4 @@
 `protocol-units` are used to collect runnable and composable units for interacting with the `ffs` protocol. We store contracts within protocol units, for example. 
 
 ## Contents
-- **[`contracts`](./contracts/)**: contract-based implementations of the `ffs` protocol.
+- **[`mcr`](./mcr/)**: the `MCR` implementation of `ffs` provided prior to the specification of the `fast-confirmations` and `post-confirmations` protocols. 

protocol-units/contracts/eth/lib/openzeppelin-foundry-upgrades/test-profiles/openzeppelin-contracts-v4-with-v5-proxies/src/.gitkeep renamed to protocol-units/fast-confirmations/README.md

@@ -0,0 +1,15 @@
+# MCR - Multi-Commit Rollup
+
+**MCR** implements a staking-based settlement where validators commit L2-blocks on Layer 1 (L1). 
+
+Validators stake tokens to participate in block validation. They commit to L2-blocks on L1, and the contract on L1 tracks block commitments, epochs, and stake. The contracts also manage validators and custodian staking and unstaking. The contract validates if commitments have reached two-thirds supermajority stake, and rewards or slashes validators based on their actions.
+
+For further details see the [RFC for MCR](https://github.com/movementlabsxyz/rfcs/pull/29) and the [MIP-34](https://github.com/movementlabsxyz/MIP/blob/main/MIP/mip-34).
+
+## Architecture
+
+- [Contracts](./contracts/README.md): Includes settlement contracts for block commitments, staking contracts for validator management, token contracts for custody.
+- **Manager**: Manages block commitments by batching and submitting them, interacts with clients, and processes commitment events (acceptance or rejection) for the settlement system.
+- **Setup**: Prepares local environments or deploys contracts, manages configuration for local and deployment setups, and ensures contract deployment when needed.
+- **Runner**: Orchestrates the setup and execution of configuration tasks, applies setup steps, and logs processes for debugging.
+- **Client**: Handles interaction with the MCR system by posting block commitments, streaming commitment data, and managing Ethereum blockchain interactions.

protocol-units/contracts/eth/lib/openzeppelin-foundry-upgrades/test-profiles/openzeppelin-contracts-v4/src/.gitkeep renamed to protocol-units/ffs/README.md

@@ -0,0 +1,67 @@
+[package]
+name = "mcr-settlement-client"
+version = { workspace = true }
+edition = { workspace = true }
+license = { workspace = true }
+authors = { workspace = true }
+homepage = { workspace = true }
+publish = { workspace = true }
+rust-version = { workspace = true }
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+# [[bin]]
+# name = "test-mcr-settlement-client"
+# path = "src/bin/e2e/test_client_settlement.rs"
+
+
+[dependencies]
+mcr-settlement-config = { workspace = true }
+movement-signer-loader = { workspace = true }
+movement-signer = { workspace = true }
+movement-signing-eth = { workspace = true }
+
+alloy = { workspace = true, features = [
+    "node-bindings",
+    "rpc-types-trace",
+    "json-rpc",
+    "rpc-client",
+    "signers",
+    "signer-yubihsm",
+    "pubsub",
+    "providers",
+] }
+alloy-contract = { workspace = true }
+alloy-network = { workspace = true }
+alloy-primitives = { workspace = true }
+alloy-provider = { workspace = true, features = [] }
+alloy-signer = { workspace = true }
+alloy-sol-types = { workspace = true }
+alloy-transport = { workspace = true }
+alloy-transport-ws = { workspace = true }
+
+anyhow = { workspace = true }
+async-stream = { workspace = true }
+async-trait = { workspace = true }
+serde_json = { workspace = true }
+movement-types = { workspace = true }
+thiserror = { workspace = true }
+tokio = { workspace = true }
+tokio-stream = { workspace = true }
+tracing = { workspace = true }
+serde = { workspace = true }
+
+godfig = { workspace = true }
+
+dot-movement = { workspace = true }
+alloy-rpc-types = { workspace = true }
+futures = { workspace = true }
+tracing-subscriber = { workspace = true }
+
+[features]
+default = ["eth"]
+e2e = ["eth"]
+eth = []
+mock = []
+
+[lints]
+workspace = true