remove duplicate spy content and reformat (#39)

* remove duplicate spy content and reformat

* grammar

* reorder sections

Author: eshaben

.pages

@@ -2,6 +2,5 @@ nav:
  - index.md
  - build
  - infrastructure
- - learn
- - infrastructure
  - tutorials
+ - learn

infrastructure/spy/run-spy.md

@@ -7,15 +7,15 @@ description: Learn how to run a Spy locally to listen for and forward messages (
 
 ## Introduction
 
-The `Spy` is a lightweight component in the Wormhole infrastructure designed to listen for and forward messages (Verifiable Action Approvals, or VAAs) published on the Wormhole network. Running a Spy locally allows developers to subscribe to a filtered stream of these messages, facilitating the development of custom relayers or other integrations with Wormhole.
+The Spy is a lightweight component in the Wormhole infrastructure designed to listen for and forward messages (Verifiable Action Approvals (VAAs)) published on the Wormhole network. Running a Spy locally allows developers to subscribe to a filtered stream of these messages, facilitating the development of custom relayers or other integrations with Wormhole.
 
 For a more comprehensive understanding of the Spy and its role within the Wormhole ecosystem, refer to the [Spy Documentation](/learn/infrastructure/spy/){target=\_blank}.
 
 ## How to Start a Spy
 
 To start a Spy locally, run the following Docker command:
 
-=== "TestNet"
+=== "MainNet"
 
     ```sh
     docker run --platform=linux/amd64 \
@@ -24,16 +24,10 @@ To start a Spy locally, run the following Docker command:
         spy \
         --nodeKey /node.key \
         --spyRPC "[::]:7073" \
-        --env testnet
-    ```
-        Optionally, add the following flags to skip any VAAs with invalid signatures:
-    ```sh
-    --ethRPC https://sepolia.drpc.org/
-    --ethContract 0x4a8bc80Ed5a4067f1CCf107057b8270E0cC11A78    
+        --env mainnet
     ```
 
-
-=== "MainNet"
+=== "TestNet"
 
     ```sh
     docker run --platform=linux/amd64 \
@@ -42,23 +36,42 @@ To start a Spy locally, run the following Docker command:
         spy \
         --nodeKey /node.key \
         --spyRPC "[::]:7073" \
-        --env mainnet
+        --env testnet
     ```
-    Optionally, add the following flags to skip any VAAs with invalid signatures:
+
+Optionally, add the following flags to skip any VAAs with invalid signatures:
+
+=== "MainNet"
+
     ```sh
     --ethRPC https://eth.drpc.org
     --ethContract 0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B
     ```
 
-Once running, a [gRPC](https://grpc.io/){target=\_blank} client (i.e., your program) can subscribe to a filtered stream of messages.
+=== "TestNet"
+
+    ```sh
+    --ethRPC https://sepolia.drpc.org/
+    --ethContract 0x4a8bc80Ed5a4067f1CCf107057b8270E0cC11A78    
+    ```
+
+## Subscribe to Filtered VAAs
+
+Once running, a [gRPC](https://grpc.io/){target=\_blank} client (i.e., your program) can subscribe to a filtered stream of messages (VAAs).
 
 Use this [proto-spec file](https://github.com/wormhole-foundation/wormhole/blob/main/proto/spy/v1/spy.proto){target=\_blank} to generate a client for the gRPC service.
 
 !!! note
     If using JavaScript/TypeScript, the [Spydk](https://www.npmjs.com/package/@certusone/wormhole-spydk){target=\_blank} makes setting up a client easier.
 
+## Data Persistence
+
+The Spy does not have a built-in persistence layer, so it is typically paired with something like Redis or an SQL database to record relevant messages.
+
+The persistence layer needs to implement the appropriate interface. For example, you can check out the [Redis interface](https://github.com/wormhole-foundation/relayer-engine/blob/main/relayer/storage/redis-storage.ts){target=\_blank} used by the Relayer Engine, a package that serves as a starting point for a custom relaying service.
+
 ## See Also
 
 The [Pyth Beacon](https://github.com/pyth-network/beacon){target=\_blank} provides an alternate Spy implementation that is highly available for improved performance and reliability.
 
-The [relayer engine](https://github.com/wormhole-foundation/relayer-engine){target=\_blank} implements a client and persistence layer for messages received from a Spy subscription.
+The [Relayer Engine](https://github.com/wormhole-foundation/relayer-engine){target=\_blank} implements a client and persistence layer for messages received from a Spy subscription.

learn/infrastructure/spy.md

@@ -5,66 +5,20 @@ description: Discover Wormhole's Spy daemon, which subscribes to gossiped messag
 
 # Spy
 
-In the Wormhole context, a _Spy_ is a daemon that subscribes to the gossiped messages in the Guardian Network.
-
-The messages available over gossip are things like:
-
-- [VAAs](/learn/infrastructure/vaas/){target=\_blank}
-- [Observations](/learn/glossary/#observation){target=\_blank}
-- [Guardian heartbeats](/learn/glossary/#heartbeat){target=\_blank}
-
-The source code for the Spy is available on [GitHub](https://github.com/wormhole-foundation/wormhole/blob/main/node/cmd/spy/spy.go){target=\_blank}.
-
-!!! note
-    The Spy has no persistence layer built in, so typically, it is paired with something like Redis or an SQL database to record relevant messages.
-
-## How to Start a Spy
+## Introduction
 
-To start a Spy locally, run the following Docker command:
-
-=== "TestNet"
-
-    ```sh
-    docker run --platform=linux/amd64 \
-        -p 7073:7073 \
-        --entrypoint /guardiand ghcr.io/wormhole-foundation/guardiand:latest \
-        spy \
-        --nodeKey /node.key \
-        --spyRPC "[::]:7073" \
-        --env testnet
-    ```
-        Optionally, add the following flags to skip any VAAs with invalid signatures:
-    ```sh
-    --ethRPC https://sepolia.drpc.org/
-    --ethContract 0x4a8bc80Ed5a4067f1CCf107057b8270E0cC11A78    
-    ```
-
-=== "MainNet"
-
-    ```sh
-    docker run --platform=linux/amd64 \
-        -p 7073:7073 \
-        --entrypoint /guardiand ghcr.io/wormhole-foundation/guardiand:latest \
-        spy \
-        --nodeKey /node.key \
-        --spyRPC "[::]:7073" \
-        --env mainnet
-    ```
-    Optionally, add the following flags to skip any VAAs with invalid signatures:
-    ```sh
-    --ethRPC https://eth.drpc.org
-    --ethContract 0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B
-    ```
+In the Wormhole context, a _Spy_ is a daemon that subscribes to the gossiped messages in the Guardian Network.
 
-Once running, a [gRPC](https://grpc.io/){target=\_blank} client (i.e., your program) can subscribe to a filtered stream of messages.
+They don’t do any validation work. Instead, they watch the Guardian Network and act as an interface to allow users and applications to check on the Spy-accessible messages.
 
-To generate a client for the gRPC service use [this proto spec file](https://github.com/wormhole-foundation/wormhole/blob/main/proto/spy/v1/spy.proto){target=\_blank}.
+## Spy-Accessible Messages
 
-!!! note
-    If using JavaScript/TypeScript, the [Spydk](https://www.npmjs.com/package/@certusone/wormhole-spydk){target=\_blank} makes setting up a client easier.
+The messages available over gossip are things like:
 
-## See Also
+- [Verifiable Action Approvals (VAAs)](/learn/infrastructure/vaas/){target=\_blank} - packets of cross-chain data. A Spy can see whether a VAA has been approved by the Guardian Network
+- [Observations](/learn/glossary/#observation){target=\_blank} - messages emitted by Core Contracts that the Guardians have picked up
+- [Guardian heartbeats](/learn/glossary/#heartbeat){target=\_blank} - the liveness of a Guardian
 
-The [Pyth Beacon](https://github.com/pyth-network/beacon){target=\_blank} provides an alternate Spy implementation that is highly available for improved performance and reliability.
+## Source Code
 
-The [relayer engine](https://github.com/wormhole-foundation/relayer-engine){target=\_blank} implements a client and persistence layer for messages received from a Spy subscription.
+The source code for the Spy is available on [GitHub](https://github.com/wormhole-foundation/wormhole/blob/main/node/cmd/spy/spy.go){target=\_blank}.