diff --git a/PLUGINS.md b/PLUGINS.md
index c62f1f79f7..398100e047 100644
--- a/PLUGINS.md
+++ b/PLUGINS.md
@@ -36,8 +36,8 @@ It is applied, with different configuration to:
 ## Sequencer
 ### Transaction Selection - LineaTransactionSelectorPlugin
 
-This plugin extends the standard transaction selection protocols employed by Besu for block creation. 
-It leverages the TransactionSelectionService to manage and customize the process of transaction selection. 
+This plugin extends the standard transaction selection protocols employed by Besu for block creation.
+It leverages the TransactionSelectionService to manage and customize the process of transaction selection.
 This includes setting limits such as `TraceLineLimit`, `maxBlockGas`, and `maxCallData`, and check the profitability
 of a transaction.
 
@@ -72,28 +72,28 @@ that are not allowed to add transactions to the pool.
 ### Linea Estimate Gas
 #### `linea_estimateGas`
 
-This endpoint simulates a transaction and returns the estimated gas used ( as the standard `eth_estimateGas`) plus the estimated gas price to be used when submitting the tx. 
+This endpoint simulates a transaction and returns the estimated gas used ( as the standard `eth_estimateGas`) plus the estimated gas price to be used when submitting the tx.
 
 #### Parameters
 
 same as `eth_estimateGas`
 
 ### Counters - CountersEndpointServicePlugin
-#### `rollup_getTracesCountersByBlockNumberV0` 
+#### `rollup_getTracesCountersByBlockNumberV0`
 
-The CountersEndpointServicePlugin registers an RPC endpoint named `getTracesCountersByBlockNumberV0` 
+The CountersEndpointServicePlugin registers an RPC endpoint named `getTracesCountersByBlockNumberV0`
 under the `rollup` namespace. When this endpoint is called, returns trace counters based on the provided request parameters.
 
 #### Parameters
 
   - `blockNumber`: _string_ - The block number
 
-  - `tracerVersion`: _string_ - The tracer version. It will return an error if the 
-requested version is different from the tracer runtime 
+  - `tracerVersion`: _string_ - The tracer version. It will return an error if the
+requested version is different from the tracer runtime
 
 ### Trace generation - TracesEndpointServicePlugin
 
-This plugin registers an RPC endpoint named `generateConflatedTracesToFileV0` under the `rollup` namespace. 
+This plugin registers an RPC endpoint named `generateConflatedTracesToFileV0` under the `rollup` namespace.
 The endpoint generates conflated file traces.
 
 #### Parameters
@@ -132,3 +132,20 @@ In the success case the trace file will simply be deleted.
 In case of an error the trace file will be renamed to `trace_$BLOCK_NUMBER_$BLOCK_HASH.lt` and moved
 to `$BESU_USER_HOME/invalid-traces`. The output of Corset will be saved in the same directory in a file
 named `corset_output_$BLOCK_NUMBER_$BLOCK_HASH.txt`. After that an error message will be sent to Slack.
+
+## Tracer Readiness
+
+Tracer Readiness is a plugin that enables the existence of the `/tracer-readiness` REST endpoint that
+ensures that the given node is able to accept new requests. Under the hood it performs request limiting via an
+option configuring the number of allowed concurrent requests. Additionally in ensures that the your state is in sync.
+
+The plugin supports the following options in the TOML configuration:
+
+```toml
+# Configures the number of allowed concurrent requests that the node can process.
+plugin-linea-rpc-concurrent-requests-limit=1
+# Configures the host of the Tracer Readiness plugin.
+plugin-linea-tracer-readiness-server-host="0.0.0.0"
+# Configures the port of the Tracer Readiness plugin.
+plugin-linea-tracer-readiness-server-port=8548
+```
diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 0000000000..7311ddcfdd
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,169 @@
+# Linea Arithmetization (zkEVM)
+
+A Linea tracing implementation for [Hyperledger Besu](https://github.com/hyperledger/besu) based on
+an [existing implementation in Go](https://github.com/Consensys/zk-evm/).
+
+## Development Setup
+
+### Install Java 17
+
+```
+brew install openjdk@17
+```
+
+### Install the Go toolchain
+
+### Install Rust
+
+```
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+
+# Use local git executable to fetch from repos (needed for private repos)
+echo "net.git-fetch-with-cli=true" >> .cargo/config.toml
+```
+
+### Install Corset
+
+```shell
+cargo install --git ssh://git@github.com/ConsenSys/corset --locked --force
+```
+
+### Update Constraints [Submodule](https://github.com/Consensys/zkevm-constraints/)
+
+```shell
+git submodule update --init --recursive
+```
+
+### Install [pre-commit](https://pre-commit.com/)
+
+```shell
+pip install --user pre-commit
+
+# For macOS users.
+brew install pre-commit
+```
+
+Then run `pre-commit install` to set up git hook scripts.
+Used hooks can be found [here](.pre-commit-config.yaml).
+
+______________________________________________________________________
+
+NOTE
+
+> `pre-commit` aids in running checks (end of file fixing,
+> markdown linting, linting, runs tests, json validation, etc.)
+> before you perform your git commits.
+
+______________________________________________________________________
+
+### Run tests
+
+```shell
+# Run all tests
+./gradlew clean test
+
+# Run only unit tests
+./gradlew clean unitTests
+
+# Run only acceptance tests
+./gradlew clean acceptanceTests
+
+# Run EVM test suite BlockchainTests
+./gradlew clean referenceBlockchainTests
+
+# Run EVM test suite GeneralStateTests
+./gradlew clean referenceGeneralStateTests
+
+# Run all EVM test suite reference tests
+./gradlew clean referenceTests
+
+# Run single reference test via gradle, e.g for net.consensys.linea.generated.blockchain.BlockchainReferenceTest_583
+./gradlew :reference-tests:referenceTests --tests "net.consensys.linea.generated.blockchain.BlockchainReferenceTest_583"
+```
+
+______________________________________________________________________
+
+NOTE
+
+> Please be aware if the reference test code generation tasks `blockchainReferenceTests` and
+> `generalStateReferenceTests` do not generate any java code, than probably you are missing the Ethereum tests
+> submodule which you can clone via `git submodule update --init --recursive`.
+
+______________________________________________________________________
+
+### Capturing a replay
+
+For debugging and inspection purposes, it is possible to capture a _replay_, _i.e._ all the minimal information required to replay a series of blocks as they played on the blockchain, which is done with `scripts/capture.pl`.
+
+A typical invocation would be:
+
+```
+scripts/capture.pl --start 1300923
+```
+
+which would capture a replay of block #1300923 and store it in `arithmetization/src/test/resources/replays`. More options are available, refer to `scripts/capture.pl -h`.
+
+## IntelliJ IDEA Setup
+
+### Enable Annotation Processing
+
+- Go to `Settings | Build, Execution, Deployment | Compiler | Annotation Processors` and tick the following
+  checkbox:
+
+  ![idea_enable_annotation_processing_setting.png](images/idea_enable_annotation_processing_setting.png)
+
+______________________________________________________________________
+
+NOTE
+
+> This setting is required to avoid IDE compilation errors because of the [Lombok](https://projectlombok.org/features/)
+> library used for code generation of boilerplate Java code such as:
+>
+> - Getters/Setters (via [`@Getter/@Setter`](https://projectlombok.org/features/GetterSetter))
+> - Class log instances (via [`@Slf4j`](https://projectlombok.org/features/log))
+> - Builder classes (via [`@Builder`](https://projectlombok.org/features/Builder))
+> - Constructors (
+>   via [`@NoArgsConstructor/@RequiredArgsConstructor/@AllArgsConstructor`](https://projectlombok.org/features/constructor))
+> - etc.
+>
+> Learn more about how Java annotation processing
+> works [here](https://www.baeldung.com/java-annotation-processing-builder).
+
+______________________________________________________________________
+
+### Set Up IDE Code Re-formatting
+
+- Install [Checkstyle](https://plugins.jetbrains.com/plugin/1065-checkstyle-idea) plugin and set IDE code
+  reformatting to comply with the project's Checkstyle configuration:
+
+  - Go to `Settings | Editor | Code Style | Java | <hamburger menu> | Import Scheme | Checkstyle configuration`:
+
+    ![idea_checkstyle_reformat.png](images/idea_checkstyle_reformat.png)
+
+    and select `<project_root>/config/checkstyle.xml`.
+
+### Install Optional Plugins
+
+- Install [Spotless Gradle](https://plugins.jetbrains.com/plugin/18321-spotless-gradle) plugin to re-format through
+  the IDE according to spotless configuration.
+
+## Debugging Traces
+
+- JSON files can be debugged with the following command:
+
+```shell
+corset check -T <JSON_FILE> -v zkevm-constraints/zkevm.bin
+```
+
+## Plugins
+
+Plugins are documented [here](PLUGINS.md).
+
+## Release Process
+Here are the steps for releasing a new version of the plugins:
+  1. Create a tag with the release version number in the format vX.Y.Z (e.g., v0.2.0 creates a release version 0.2.0).
+  2. Push the tag to the repository.
+  3. GitHub Actions will automatically create a draft release for the release tag.
+  4. Once the release workflow completes, update the release notes, uncheck "Draft", and publish the release.
+
+Note: Release tags (of the form v*) are protected and can only be pushed by organization and/or repository owners.