From 1573dcc7da012364099dcf6942f14036f4b4affc Mon Sep 17 00:00:00 2001
From: Kelvin Fichter <kelvin@optimism.io>
Date: Mon, 7 Mar 2022 14:21:20 -0500
Subject: [PATCH] fix(mr): update README to reflect latest version

---
 .gitignore                            |  1 +
 packages/message-relayer/.env.example | 11 ++++
 packages/message-relayer/README.md    | 75 +++++++--------------------
 3 files changed, 31 insertions(+), 56 deletions(-)
 create mode 100644 packages/message-relayer/.env.example

diff --git a/.gitignore b/.gitignore
index 3474fdc7f92bb..4fc1beef2c23e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,4 +24,5 @@ packages/data-transport-layer/db
 
 .env
 .env*
+!.env.example
 *.log
diff --git a/packages/message-relayer/.env.example b/packages/message-relayer/.env.example
new file mode 100644
index 0000000000000..3ef8ef28e5514
--- /dev/null
+++ b/packages/message-relayer/.env.example
@@ -0,0 +1,11 @@
+# URL pointing to an L1 RPC provider
+MESSAGE_RELAYER__L1RPCPROVIDER=
+
+# URL pointing to an L2 RPC provider
+MESSAGE_RELAYER__L2RPCPROVIDER=
+
+# Private key for a wallet with ETH on L1
+MESSAGE_RELAYER__L1WALLET=
+
+# Optional, L2 block height to start relaying messages from (default is 0)
+MESSAGE_RELAYER__FROML2TRANSACTIONINDEX=
diff --git a/packages/message-relayer/README.md b/packages/message-relayer/README.md
index 9bd4f9cac67e0..7ad66b72ba952 100644
--- a/packages/message-relayer/README.md
+++ b/packages/message-relayer/README.md
@@ -1,70 +1,33 @@
-[![codecov](https://codecov.io/gh/ethereum-optimism/optimism/branch/master/graph/badge.svg?token=0VTG7PG7YR&flag=message-relayer)](https://codecov.io/gh/ethereum-optimism/optimism)
 # @eth-optimism/message-relayer
 
-This package contains:
-
-1. A service for relaying messages from L2 to L1.
-2. Utilities for finding these messages and relaying them.
+`message-relayer` is a service that automatically finalizes ("relays") messages sent from Optimism to Ethereum.
+This package is meant to be used during local development and should NOT be used on a production network.
 
 ## Installation
 
+Clone, install, and build the Optimism monorepo:
+
 ```
-yarn add @eth-optimism/message-relayer
+git clone https://github.com/ethereum-optimism/optimism.git
+yarn install
+yarn build
 ```
 
-## Relay Utilities
-
-### getMessagesAndProofsForL2Transaction
-
-Finds all L2 => L1 messages sent in a given L2 transaction and generates proof for each.
-
-#### Usage
+## Running the relayer (Docker)
 
-```typescript
-import { getMessagesAndProofsForL2Transaction } from '@eth-optimism/message-relayer'
+The `message-relayer` can be included as part of the [local Optimism development environment](https://community.optimism.io/docs/developers/build/dev-node/).
+Although the `message-relayer` is not turned on by default, it can be enabled by [changing this line in docker-compose.yml](https://github.com/ethereum-optimism/optimism/blob/51a527b8e3fe69940fb8c0f5e4aa2e0ae8ee294c/ops/docker-compose.yml#L129) to:
 
-const main = async () => {
-  const l1RpcProviderUrl = 'https://layer1.endpoint'
-  const l2RpcProviderUrl = 'https://layer2.endpoint'
-  const l1StateCommitmentChainAddress = 'address of StateCommitmentChain from deployments page'
-  const l2CrossDomainMessengerAddress = 'address of L2CrossDomainMessenger from deployments page'
-  const l2TransactionHash = 'hash of the transaction with messages to relay'
-
-  const messagePairs = await getMessagesAndProofsForL2Transaction(
-    l1RpcProviderUrl,
-    l2RpcProviderUrl,
-    l1StateCommitmentChainAddress,
-    l2CrossDomainMessengerAddress,
-    l2TransactionHash
-  )
+```
+replicas: 1
+```
 
-  console.log(messagePairs)
-  // Will log something along the lines of:
-  // [
-  //   {
-  //     message: {
-  //       target: '0x...',
-  //       sender: '0x...',
-  //       message: '0x...',
-  //       messageNonce: 1234...
-  //     },
-  //     proof: {
-  //       // complicated
-  //     }
-  //   }
-  // ]
+## Running the relayer (manual)
 
-  // You can then do something along the lines of:
-  // for (const { message, proof } of messagePairs) {
-  //   await l1CrossDomainMessenger.relayMessage(
-  //     message.target,
-  //     message.sender,
-  //     message.message,
-  //     message.messageNonce,
-  //     proof
-  //   )
-  // }
-}
+The `message-relayer` can also be run manually.
+Copy `.env.example` into a new file named `.env`, then set the environment variables listed there.
+Once your environment variables have been set, run the relayer via:
 
-main()
+```
+yarn start
 ```