Skip to content

Commit 15f34f5

Browse files
docs: more changes in review process
Co-authored-by: Joseph Livesey <[email protected]>
1 parent b2f150b commit 15f34f5

File tree

3 files changed

+27
-1
lines changed

3 files changed

+27
-1
lines changed

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,21 @@ This section provides guidance for building, configuring, and running `indexer-s
2323
Pre-built Docker images are available for both `indexer-service-rs` and `indexer-tap-agent`. You can pull these images using the following commands:
2424

2525
- **Indexer Service:**
26+
2627
```bash
2728
docker pull ghcr.io/graphprotocol/indexer-service-rs:<tag>
2829
```
2930

3031
- **TAP Agent:**
32+
3133
```bash
3234
docker pull ghcr.io/graphprotocol/indexer-tap-agent:<tag>
3335
```
3436

3537
The `<tag>` corresponds to the current release version, which can be found in the [Releases Page](https://github.com/graphprotocol/indexer-rs/releases).
3638

3739
#### Tag Examples for Version X.Y.Z
40+
3841
For version `X.Y.Z`, the available tags include:
3942
- `latest`
4043
- `vX.Y.Z`
@@ -55,17 +58,22 @@ Refer to the following badges for the latest release versions:
5558
To build the services locally, ensure you have the latest version of Rust installed. No additional plugins are required.
5659

5760
#### Steps:
61+
5862
1. Clone the repository:
63+
5964
```bash
6065
git clone https://github.com/graphprotocol/indexer-rs.git && cd indexer-rs
6166
```
6267

6368
2. Build the binaries:
6469
- **Indexer Service:**
70+
6571
```
6672
cargo build --release -p indexer-service-rs
6773
```
74+
6875
- **TAP Agent:**
76+
6977
```
7078
cargo build --release -p indexer-tap-agent
7179
```
@@ -94,10 +102,13 @@ export INDEXER_SERVICE_SUBGRAPHS__NETWORK__QUERY_URL=<value>
94102

95103
3. **Start the Service:**
96104
- **Indexer Service:**
105+
97106
```bash
98107
target/release/indexer-service-rs --config config/minimal-config-example.toml
99108
```
109+
100110
- **TAP Agent:**
111+
101112
```bash
102113
target/release/indexer-tap-agent --config config/minimal-config-example.toml
103114
```
@@ -112,6 +123,7 @@ All configuration is managed through a TOML file. Below are examples of configur
112123
If you are migrating from an older stack, use the [Migration Configuration Guide](./docs/migration-config/README.md) for detailed instructions.
113124

114125
### Key Notes:
126+
115127
- Ensure your configuration is tailored to your deployment environment.
116128
- Validate the configuration file syntax before starting the service.
117129
- Use environment variables to override sensitive settings like database credentials or API tokens where applicable.

docs/Queries.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,20 +39,24 @@ curl -X POST \
3939
--data '{"query": "{_meta{block{number}}}"}' \
4040
http://localhost:7600/subgraphs/id/QmacQnSgia4iDPWHpeY6aWxesRFdb8o5DKZUx96zZqEWrB
4141
```
42+
4243
```json
4344
{
4445
"attestable": true,
4546
"graphQLResponse": "{\"data\":{\"_meta\":{\"block\":{\"number\":10666745}}}}"
4647
}
4748
```
49+
4850
## Takes hex representation for subgraphs deployment id aside from IPFS hash representation
51+
4952
```bash
5053
curl -X POST \
5154
-H 'Content-Type: application/json' \
5255
-H 'Authorization: Bearer token-for-graph-node-query-endpoint' \
5356
--data '{"query": "{_meta{block{number}}}"}' \
5457
http://localhost:7600/subgraphs/id/0xb655ca6f49e73728a102219726ff678d61d8fb792874792e9f0d9887dc616600
5558
```
59+
5660
```json
5761
{
5862
"attestable": true,
@@ -80,24 +84,30 @@ curl -X POST \
8084
```bash
8185
curl http://localhost:7600/subgraphs/health/QmVhiE4nax9i86UBnBmQCYDzvjWuwHShYh7aspGPQhU5Sj
8286
```
87+
8388
```json
8489
{
8590
"health": "healthy"
8691
}
8792
```
8893
## Unfound subgraph
94+
8995
```bash
9096
curl http://localhost:7600/subgraphs/health/QmacQnSgia4iDPWHpeY6aWxesRFdb8o5DKZUx96zZqEWrB
9197
```
98+
9299
```json
93100
{
94101
"error": "Deployment not found"
95102
}
96103
```
104+
97105
## Failed Subgraph
106+
98107
```bash
99108
curl http://localhost:7600/subgraphs/health/QmVGSJyvjEjkk5U9EdxyyB78NCXK3EAoFhrzm6LV7SxxAm
100109
```
110+
101111
```json
102112
{
103113
"fatalError": "transaction 21e77ed08fbc9df7be81101e9b03c2616494cee7cac2f6ad4f1ee387cf799e0c: error while executing at wasm backtrace:\t 0: 0x5972 - <unknown>!mappings/core/handleSwap: Mapping aborted at mappings/core.ts, line 73, column 16, with message: unexpected null in handler `handleSwap` at block #36654250 (5ab4d80c8e2cd628d5bf03abab4c302fd21d25d734e66afddff7a706b804fe13)",
@@ -148,6 +158,7 @@ curl -X POST \
148158
--data '{"query": "{indexingStatuses {subgraph health}}"}' \
149159
http://localhost:7600/status
150160
```
161+
151162
```json
152163
{
153164
"data": {
@@ -170,12 +181,14 @@ curl -X POST \
170181
```
171182

172183
## Indexing status resolver - Filter out the unsupported queries
184+
173185
```bash
174186
curl -X POST \
175187
-H 'Content-Type: application/json' \
176188
--data '{"query": "{_meta{block{number}}}"}' \
177189
http://localhost:7600/status
178190
```
191+
179192
```json
180193
{
181194
"errors": [
@@ -200,6 +213,7 @@ curl -X GET \
200213
--data '{"query": "{ costModels(deployments: [\"Qmb5Ysp5oCUXhLA8NmxmYKDAX2nCMnh7Vvb5uffb9n5vss\"]) { deployment model variables }} "}' \
201214
http://localhost:7300/cost
202215
```
216+
203217
```json
204218
{
205219
"data": {

docs/migration-config/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ INDEXER_SUBGRAPHS__ESCROW__DEPLOYMENT_ID=<escrow deployment id>
3232
```
3333

3434
Users typically have an easier time using the config over
35-
environment variables, we recomment moving your environment
35+
environment variables, we recommend moving your environment
3636
variables to plain text inside the config over time.
3737

3838
## Booleans inside config

0 commit comments

Comments
 (0)