Skip to content

Commit f1674f2

Browse files
committed
docs: replace hosted service endpoints with decentralized network requiring api-key from users
1 parent 683e608 commit f1674f2

File tree

6 files changed

+32
-31
lines changed

6 files changed

+32
-31
lines changed

docs/graphcast/radios/graphcast-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ The Graphcast CLI is configured using config variables. You will need to prepare
1717
| `PRIVATE_KEY` | Private key to the Graphcast ID wallet (precendence over mnemonics).<br/>Example: `PRIVATE_KEY=YOUR_PRIVATE_KEY` |
1818
| `MNEMONIC` | Mnemonic to the Graphcast ID wallet (first address of the wallet is used; Only one of private key or mnemonic is needed).<br/>Example: `MNEMONIC=YOUR_MNEMONIC` |
1919
| `GRAPH_ACCOUNT` | Graph account corresponding to Graphcast operator.<br/>Example: `GRAPH_ACCOUNT=YOUR_GRAPH_ACCOUNT` |
20-
| `REGISTRY_SUBGRAPH` | Subgraph endpoint to the Graphcast Registry.<br/>Default: `https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-goerli` |
21-
| `NETWORK_SUBGRAPH` | Subgraph endpoint to The Graph network subgraph.<br/>Default: `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-goerli` |
20+
| `REGISTRY_SUBGRAPH` | Subgraph endpoint to the Graphcast Registry.<br/>Default: `https://gateway-arbitrum.network.thegraph.com/api/{api-key}/subgraphs/id/9bnkkKmSqX3FpoxnBVNFcQfmdSJt2Zc8PrsY1ek64jPr` |
21+
| `NETWORK_SUBGRAPH` | Subgraph endpoint to The Graph network subgraph.<br/>Default: `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/3xQHhMudr1oh69ut36G2mbzpYmYxwqCeU6wwqyCDCnqV` |
2222
| `GRAPHCAST_NETWORK` | Supported Graphcast networks: mainnet, testnet.<br/>Default: `testnet` |
2323
| `LOG_LEVEL` | Logging configuration to set as RUST_LOG.<br/>Default: `info` |
2424
| `LOG_FORMAT` | Support logging formats: pretty, json, full, compact.<br/>Default: `pretty` |

docs/graphcast/radios/subgraph-radio/advanced-configuration.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,8 @@ Example .env file:
113113
```bash
114114
PRIVATE_KEY="a2b3c1d4e5f6890e7f6g5h4i3j2k1l0m"
115115
GRAPH_NODE_STATUS_ENDPOINT="http://127.0.0.42:8030/graphql"
116-
REGISTRY_SUBGRAPH="https://api.thegraph.com/subgraphs/name/randomuser/graphcast-registry-mainnet"
117-
NETWORK_SUBGRAPH="https://api.thegraph.com/subgraphs/name/graphprotocol/graph-mainnet"
116+
REGISTRY_SUBGRAPH="https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6"
117+
NETWORK_SUBGRAPH="https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp"
118118
GRAPHCAST_NETWORK=mainnet
119119
INDEXER_ADDRESS="0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
120120
```
@@ -127,8 +127,8 @@ Pass the configuration options directly as command-line arguments.
127127
docker run ghcr.io/graphops/subgraph-radio \
128128
--private-key "a2b3c1d4e5f6890e7f6g5h4i3j2k1l0m" \
129129
--graph-node-status-endpoint "http://127.0.0.42:8030/graphql" \
130-
--registry-subgraph "https://api.thegraph.com/subgraphs/name/randomuser/graphcast-registry-mainnet" \
131-
--network-subgraph "https://api.thegraph.com/subgraphs/name/graphprotocol/graph-mainnet" \
130+
--registry-subgraph "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6" \
131+
--network-subgraph "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp" \
132132
--graphcast-network mainnet \
133133
--indexer-address "0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
134134
```
@@ -141,8 +141,8 @@ Example TOML configuration file (`config.toml`):
141141
[graph_stack]
142142
graph_node_status_endpoint = 'http://127.0.0.42:8030/graphql'
143143
indexer_address = '0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6'
144-
registry_subgraph = 'https://api.thegraph.com/subgraphs/name/randomuser/graphcast-registry-mainnet'
145-
network_subgraph = 'https://api.thegraph.com/subgraphs/name/graphprotocol/graph-mainnet'
144+
registry_subgraph = 'https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6'
145+
network_subgraph = 'https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp'
146146
private_key = 'a2b3c1d4e5f6890e7f6g5h4i3j2k1l0m'
147147
```
148148

@@ -154,8 +154,8 @@ Example YAML configuration file (`config.yaml`):
154154
graph_stack:
155155
graph_node_status_endpoint: "http://127.0.0.42:8030/graphql"
156156
indexer_address: "0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
157-
registry_subgraph: "https://api.thegraph.com/subgraphs/name/randomuser/graphcast-registry-mainnet"
158-
network_subgraph: "https://api.thegraph.com/subgraphs/name/graphprotocol/graph-mainnet"
157+
registry_subgraph: "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6"
158+
network_subgraph: "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp"
159159
private_key: "a2b3c1d4e5f6890e7f6g5h4i3j2k1l0m"
160160
```
161161

docs/graphcast/radios/subgraph-radio/intro.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ docker pull ghcr.io/graphops/subgraph-radio:latest
3737
```bash
3838
docker run \
3939
-e GRAPHCAST_NETWORK="mainnet" \
40-
-e REGISTRY_SUBGRAPH="https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-mainnet" \
41-
-e NETWORK_SUBGRAPH="https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-mainnet" \
40+
-e REGISTRY_SUBGRAPH="https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6" \
41+
-e NETWORK_SUBGRAPH="https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp" \
4242
-e PRIVATE_KEY="PRIVATE_KEY" \
4343
-e GRAPH_NODE_STATUS_ENDPOINT="http://graph-node:8030/graphql" \
4444
-e RUST_LOG="warn,hyper=warn,graphcast_sdk=info,subgraph_radio=info" \
@@ -59,8 +59,8 @@ services:
5959
restart: unless-stopped
6060
environment:
6161
GRAPHCAST_NETWORK: "mainnet"
62-
REGISTRY_SUBGRAPH: "https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-mainnet"
63-
NETWORK_SUBGRAPH: "https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-mainnet"
62+
REGISTRY_SUBGRAPH: "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6"
63+
NETWORK_SUBGRAPH: "https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp"
6464
PRIVATE_KEY: "PRIVATE_KEY"
6565
GRAPH_NODE_STATUS_ENDPOINT: "http://graph-node:8030/graphql"
6666
RUST_LOG: "warn,hyper=warn,graphcast_sdk=info,subgraph_radio=info"

docs/graphcast/sdk/radio-dev.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -227,7 +227,6 @@ pub struct Config {
227227
value_name = "SUBGRAPH",
228228
env = "REGISTRY_SUBGRAPH",
229229
help = "Subgraph endpoint to the Graphcast Registry",
230-
default_value = "https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-goerli"
231230
)]
232231
pub registry_subgraph: String,
233232
#[clap(
@@ -242,7 +241,6 @@ pub struct Config {
242241
value_name = "SUBGRAPH",
243242
env = "NETWORK_SUBGRAPH",
244243
help = "Subgraph endpoint to The Graph network subgraph",
245-
default_value = "https://gateway.testnet.thegraph.com/network"
246244
)]
247245
pub network_subgraph: String,
248246
#[clap(

docs/graphcast/sdk/registry.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,11 @@ You can register multiple Operators for your Indexer in parallel. If you would p
4242

4343
#### Registry endpoints
4444

45-
| Network | Registry Contract | Subgraph API |
46-
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
47-
| Ethereum-mainnet | [0x89f97698d6006f25570cd2e31737d3d22aedcbcf](https://etherscan.io/address/0x89f97698d6006f25570cd2e31737d3d22aedcbcf#writeProxyContract) | [https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-mainnet](https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-mainnet) |
48-
| Ethereum-goerli | [0x26ebbA649FAa7b56FDB8DE9Ea17aF3504B76BFA0](https://goerli.etherscan.io/address/0x26ebbA649FAa7b56FDB8DE9Ea17aF3504B76BFA0#writeProxyContract) | [https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-goerli](https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-goerli) |
49-
| Arbitrum-one | [0xfae79e8cb8fbac2408e5baf89262bd92b6ca464a](https://arbiscan.io/address/0xfae79e8cb8fbac2408e5baf89262bd92b6ca464a#writeProxyContract) | [https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arb-one](https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arb-one) |
50-
| Arbitrum-goerli | [0x50c2d70a41ecefe4cc54a331457ea204ecf97292](https://goerli.arbiscan.io/address/0x50c2d70a41ecefe4cc54a331457ea204ecf97292#writeProxyContract) | [https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arbitrum-go](https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arbitrum-go) |
45+
| Network | Registry Contract |
46+
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
47+
| Arbitrum-one | [0xfae79e8cb8fbac2408e5baf89262bd92b6ca464a](https://arbiscan.io/address/0xfae79e8cb8fbac2408e5baf89262bd92b6ca464a#writeProxyContract) |
48+
| Arbitrum-sepolia | [0x17c3a072E5b1B2c260C29D289ee2E7372b8f7C69](https://sepolia.arbiscan.io/address/0x17c3a072E5b1B2c260C29D289ee2E7372b8f7C69#writeProxyContract) |
49+
| Ethereum-mainnet | [0x89f97698d6006f25570cd2e31737d3d22aedcbcf](https://etherscan.io/address/0x89f97698d6006f25570cd2e31737d3d22aedcbcf#writeProxyContract) |
5150

5251
:::info
5352
Each Graphcast ID can be associated with a single Indexer. To revoke a Graphcast ID for your Indexer, call `setGraphcastIDFor(indexer_address, graphcast_id)` with a Graphcast ID of `0x0` using a registered Indexer Operator Account.
@@ -57,11 +56,10 @@ Each Graphcast ID can be associated with a single Indexer. To revoke a Graphcast
5756

5857
Here we list out the APIs the team supports actively. For network subgraph endpoint, We recommend you to expose your indexer-service's endpoint at `/network` queries with authentication. You can also index and serve registry subgraph but they are not currently deployed on the decentralized network.
5958

60-
Here are the endpoints available on the hosted service.
59+
Here are the endpoints available on the decentralized network, please replace `[api-key]` with a valid api key for service.
6160

6261
| Protocol Network | Graphcast Network | Registry Subgraph Endpoint | Network Subgraph Endpoint |
6362
| ---------------- | ----------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
64-
| Ethereum Mainnet | `mainnet` | `https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-mainnet` | `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-mainnet` |
65-
| Goerli | `testnet` | `https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-goerli` | `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-goerli` |
66-
| Arbitrum-One | `mainnet` | `https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arb-one` | `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-arbitrum` |
67-
| Arbitrum-Goerli | `testnet` | `https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arbitrum-go` | `https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-arbitrum-goerli` |
63+
| Arbitrum-One | `mainnet` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/DZz4kDTdmzWLWsV373w2bSmoar3umKKH9y82SUKr5qmp` |
64+
| Arbitrum-Sepolia | `testnet` | `https://gateway-arbitrum.network.thegraph.com/api/{api-key}/subgraphs/id/9bnkkKmSqX3FpoxnBVNFcQfmdSJt2Zc8PrsY1ek64jPr` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/3xQHhMudr1oh69ut36G2mbzpYmYxwqCeU6wwqyCDCnqV` |
65+
| Ethereum Mainnet | `mainnet` | `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/rcKzonu5NGbKcxCDZoQWmcckRKJw8rnmMNJDV8UeDzJ` | `https://gateway-arbitrum.network.thegraph.com/api/{api-key}/subgraphs/id/GgwLf9BTFBJi6Z5iYHssMAGEE4w5dR3Jox2dMLrBxnCT` |

docs/launchpad/quick-start.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -537,17 +537,20 @@ releases:
537537
config:
538538
ethereum: "http://proxyd-proxyd.arbitrum-sepolia:8545"
539539
ethereum-network: "arbitrum-sepolia"
540-
network-subgraph-endpoint: "https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-arbitrum-sepolia"
540+
network-subgraph-endpoint: "https://gateway-arbitrum.network.thegraph.com/api/{{ .Values.secretEnv.api_key }}/subgraphs/id/3xQHhMudr1oh69ut36G2mbzpYmYxwqCeU6wwqyCDCnqV"
541541
graph-node-query-endpoint: "http://graph-node-query:8000"
542542
graph-node-status-endpoint: "http://graph-node-block-ingestor:8030/graphql"
543543
postgres-host: "<your-indexer-metadata-postgresql-host>" ## change me
544544
postgres-database: "<your-indexer-metadata-postgresql-db>" ## change me
545545
546+
secretEnv:
547+
api_key: <your-secret-graph-network-api-key>
548+
546549
indexerAgent:
547550
config:
548551
collect-receipts-endpoint: "https://gateway-testnet-arbitrum.network.thegraph.com/collect-receipts"
549552
network-subgraph-deployment: "QmT8UDGK7zKd2u2NQZwhLYHdA4KM55QsivkE3ouCuX6fEj" # find at https://github.com/graphprotocol/indexer/blob/main/docs/networks.md
550-
epoch-subgraph-endpoint: "https://api.thegraph.com/subgraphs/name/graphprotocol/arbitrum-sepolia-ebo" # find at https://github.com/graphprotocol/indexer/blob/main/docs/networks.md
553+
epoch-subgraph-endpoint: "https://gateway-arbitrum.network.thegraph.com/api/{{ .Values.secretEnv.api_key }}/subgraphs/id/BhnsdeZihU4SuokxZMLF4FQBVJ3jgtZf6v51gHvz3bSS" # find at https://github.com/graphprotocol/indexer/blob/main/docs/networks.md
551554
epoch-subgraph-deployment: "QmTpu2mVquoMpr4SWSM77nGkU3tcUS1Bhk1sVHpjDrAUAx"
552555
graph-node-admin-endpoint: "http://graph-node-block-ingestor:8020"
553556
public-indexer-url: "<your-public-indexer-url>" ## change me
@@ -563,6 +566,7 @@ releases:
563566
INDEXER_AGENT_POSTGRES_PASSWORD:
564567
secretName: <your-secret-containing-indexer-metadata-postgresql-password>
565568
key: password
569+
api_key: <your-secret-graph-network-api-key>
566570
567571
568572
indexerService:
@@ -599,12 +603,13 @@ releases:
599603
GRAPH_NODE_STATUS_ENDPOINT: http://graph-node-block-ingestor:8030/graphql
600604
INDEXER_MANAGEMENT_SERVER_ENDPOINT: http://graph-network-indexer-agent:8000
601605
GRAPHCAST_NETWORK: "testnet"
602-
REGISTRY_SUBGRAPH: https://api.thegraph.com/subgraphs/name/hopeyen/graphcast-registry-arb-se
603-
NETWORK_SUBGRAPH: https://api.thegraph.com/subgraphs/name/graphprotocol/graph-network-arbitrum-sepolia
606+
REGISTRY_SUBGRAPH: "https://gateway-arbitrum.network.thegraph.com/api/{{ .Values.secretEnv.api_key }}/subgraphs/id/5tHgjCNF4XxAzp9ja8dU3j9JrqU7zctXj6DnxWpwAzc6"
607+
NETWORK_SUBGRAPH: "https://gateway-arbitrum.network.thegraph.com/api/{{ .Values.secretEnv.api_key }}/subgraphs/id/3xQHhMudr1oh69ut36G2mbzpYmYxwqCeU6wwqyCDCnqV"
604608
secretEnv:
605609
MNEMONIC:
606610
secretName: <your-secret-containing-your-graph-operator-mnemonic>
607611
key: mnemonic
612+
api_key: <your-secret-graph-network-api-key>
608613
609614
- name: graph-toolbox
610615
namespace: arbitrum-sepolia

0 commit comments

Comments
 (0)