From 48280518f05073274cdf77c43390188577b558c8 Mon Sep 17 00:00:00 2001 From: Cody Littley Date: Tue, 16 Jul 2024 10:05:52 -0500 Subject: [PATCH 1/4] Added missing steps for inabox tutorial. Signed-off-by: Cody Littley --- inabox/README.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/inabox/README.md b/inabox/README.md index 746a11c45c..98e1355673 100644 --- a/inabox/README.md +++ b/inabox/README.md @@ -3,24 +3,35 @@ Notice: The scripts for setting up a local geth chain are currently broken. The instructions below use anvil instead ## First time setup -- Go path is in system path +- Go path is in system path. [Instructions for installing go](https://go.dev/doc/install). - Ensure all submodules are initialized and checked out ``` git submodule update --init --recursive ``` +- Docker is installed. [Instructions for installing docker](https://www.docker.com/products/docker-desktop/). - Ensure foundry is installed (comes with `anvil` which we use as a test chain and `forge` which we use for deployment scripting): ``` $ curl -L https://foundry.paradigm.xyz | bash $ foundryup ``` +- `brew` is installed, see instructions [here](https://brew.sh/). - Localstack CLI is installed (simulates AWS stack on local machine; we also provide instructions for running localstack from docker without the CLI): ``` $ brew install localstack/tap/localstack-cli ``` -- grpcurl is installed: +- `grpcurl` is installed: ``` go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest ``` +- `aws` is installed, follow instructions [here](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). +- `npm` is installed + ``` + brew install node + ``` +- `yarn` is installed + ``` + npm install --global yarn + ``` ## Run a complete end-to-end test From cadb0fff884acc85b35275aa3f8b41e91e077ac4 Mon Sep 17 00:00:00 2001 From: Cody Littley Date: Tue, 16 Jul 2024 13:42:49 -0500 Subject: [PATCH 2/4] Cleanup. Signed-off-by: Cody Littley --- inabox/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/inabox/README.md b/inabox/README.md index 98e1355673..db482d37e2 100644 --- a/inabox/README.md +++ b/inabox/README.md @@ -6,7 +6,7 @@ Notice: The scripts for setting up a local geth chain are currently broken. The - Go path is in system path. [Instructions for installing go](https://go.dev/doc/install). - Ensure all submodules are initialized and checked out ``` - git submodule update --init --recursive + $ git submodule update --init --recursive ``` - Docker is installed. [Instructions for installing docker](https://www.docker.com/products/docker-desktop/). - Ensure foundry is installed (comes with `anvil` which we use as a test chain and `forge` which we use for deployment scripting): @@ -21,16 +21,16 @@ Notice: The scripts for setting up a local geth chain are currently broken. The ``` - `grpcurl` is installed: ``` - go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest + $ brew install grpcurl ``` - `aws` is installed, follow instructions [here](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). - `npm` is installed ``` - brew install node + $ brew install node ``` - `yarn` is installed ``` - npm install --global yarn + $ npm install --global yarn ``` ## Run a complete end-to-end test From 11020b1e196c0c82ce1c77a6d88cf8b41fed1bf5 Mon Sep 17 00:00:00 2001 From: Cody Littley Date: Wed, 17 Jul 2024 07:48:21 -0500 Subject: [PATCH 3/4] Additional improvements. Signed-off-by: Cody Littley --- inabox/README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/inabox/README.md b/inabox/README.md index db482d37e2..c0811e36ee 100644 --- a/inabox/README.md +++ b/inabox/README.md @@ -155,6 +155,15 @@ $ grpcurl -plaintext -d '{"data": "'$(tools/kzgpad/bin/kzgpad -e hello)'"}' \ localhost:32003 disperser.Disperser/DisperseBlob ``` +This will return a message in the following form: + +``` +{ + "result": "PROCESSING", + "requestId": "$REQUEST_ID" +} +``` + Look for logs such as the following to indicate that the disperser has successfully confirmed the batch: ``` TRACE[10-12|22:02:13.365] [batcher] Aggregating signatures... caller=batcher.go:178 @@ -166,6 +175,13 @@ TRACE[10-12|22:02:13.376] [batcher] AggregateSignatures took duration=10.6 TRACE[10-12|22:02:13.376] [batcher] Confirming batch... caller=batcher.go:198 ``` +To dispense that same blob (replace `$REQUEST_ID` with the request ID from the prior step): + +``` +grpcurl -plaintext -d '{"request_id": "$REQUEST_ID"}' \ + localhost:32003 disperser.Disperser/GetBlobStatus +``` + ### Cleanup If you followed [Option 1](#option-1-simplest) above, you can run the following command in order to clean up the test infra: @@ -175,3 +191,5 @@ make stop-infra ``` If you followed [Option 2](#option-2), you can stop the infra services by `Ctrl-C`'ing in each terminal. For the graph, it's also important to run `docker compose down -v` from within the `inabox/thegraph` directory to make sure that the containers are fully removed. + + From 790d181c39249e8f5a34ea8835e62c625df833ea Mon Sep 17 00:00:00 2001 From: Cody Littley Date: Thu, 18 Jul 2024 07:52:24 -0500 Subject: [PATCH 4/4] Made suggested change, added missing step. Signed-off-by: Cody Littley --- inabox/README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/inabox/README.md b/inabox/README.md index c0811e36ee..aa65a50168 100644 --- a/inabox/README.md +++ b/inabox/README.md @@ -32,6 +32,10 @@ Notice: The scripts for setting up a local geth chain are currently broken. The ``` $ npm install --global yarn ``` +- The Graph is installed + ``` + $ npm install -g @graphprotocol/graph-cli@latest + ``` ## Run a complete end-to-end test @@ -175,7 +179,7 @@ TRACE[10-12|22:02:13.376] [batcher] AggregateSignatures took duration=10.6 TRACE[10-12|22:02:13.376] [batcher] Confirming batch... caller=batcher.go:198 ``` -To dispense that same blob (replace `$REQUEST_ID` with the request ID from the prior step): +To check the status of that same blob (replace `$REQUEST_ID` with the request ID from the prior step): ``` grpcurl -plaintext -d '{"request_id": "$REQUEST_ID"}' \