From 3fce6544133b93c79abf3551322d96f176edd385 Mon Sep 17 00:00:00 2001 From: Eugene Aseev <14873170+easeev@users.noreply.github.com> Date: Mon, 18 Nov 2024 20:38:27 -0500 Subject: [PATCH 1/2] Add Chainstack to indexers --- .../launch-orbit-chain/infra-options-orbit-chains.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/arbitrum-docs/launch-orbit-chain/infra-options-orbit-chains.md b/arbitrum-docs/launch-orbit-chain/infra-options-orbit-chains.md index 0cd9d52d2..a9e1fc101 100644 --- a/arbitrum-docs/launch-orbit-chain/infra-options-orbit-chains.md +++ b/arbitrum-docs/launch-orbit-chain/infra-options-orbit-chains.md @@ -59,12 +59,13 @@ One way to reduce transaction fees for Orbit chains is to configure a Data Avail Indexers provide a convenient way to retrieve historic or application-specific data without having to interface with your chain through an RPC endpoint. The following third-party providers offer indexing services that can be used with Orbit chains: -- [QuickNode](https://www.quicknode.com/streams?utm_source=arb-docs) - [Alchemy](https://www.alchemy.com/) -- [The Graph](https://thegraph.com/) +- [Chainstack](https://chainstack.com/) - [Goldsky](https://goldsky.com/) - [Ormi](https://www.ormilabs.xyz/) +- [The Graph](https://thegraph.com/) - [Traceye](https://traceye.io/) +- [QuickNode](https://www.quicknode.com/streams?utm_source=arb-docs) ## Oracles From e3f9dfe75966334ed63a43578ead539e284c641f Mon Sep 17 00:00:00 2001 From: TucksonDev Date: Tue, 17 Dec 2024 12:10:01 +0000 Subject: [PATCH 2/2] Remove Bold API documentation --- .../more-types/02-run-validator-node.mdx | 12 ---- .../more-types/04-bold-validator-api.mdx | 71 ------------------- website/sidebars.js | 5 -- 3 files changed, 88 deletions(-) delete mode 100644 arbitrum-docs/run-arbitrum-node/more-types/04-bold-validator-api.mdx diff --git a/arbitrum-docs/run-arbitrum-node/more-types/02-run-validator-node.mdx b/arbitrum-docs/run-arbitrum-node/more-types/02-run-validator-node.mdx index c22e2b051..7baadc812 100644 --- a/arbitrum-docs/run-arbitrum-node/more-types/02-run-validator-node.mdx +++ b/arbitrum-docs/run-arbitrum-node/more-types/02-run-validator-node.mdx @@ -125,18 +125,6 @@ The wallet file will be created under the mounted directory inside the `BoLD is activated, validators have access to an optional API that Nitro provides, which provides information about the assertions being posted and the current challenges going on. - -This page describes the rationale behind providing this API and the available endpoints. - -## Why do we need an API? - -BoLD is a complex protocol that enables validators to defend claims about an Arbitrum chain on its parent chain. By default, uncontested claims are confirmed within 7 days, and contested claims can be confirmed within 14 days. Within that sliding window, there can be a significant amount of challenges and activities of validators making moves to defend their claims. Nitro is equipped to make moves on behalf of honest validators automatically and logs a lot of information about ongoing challenges. - -However, the amount of information logged between a simple Alice vs. Bob dispute is enormous. Each move made in a challenge emits a log, and there are many other things occurring in a validator node's runtime that are also logged in the process. Because BoLD challenges can be concurrent, we can quickly see an explosion of logs if many participants are involved. - -```go -t=2023-11-03T21:03:08+0000 lvl=info msg="Successfully bisected edge" service=edge-tracker name= challengeType=block_challenge_edge bisectedFrom=16 bisectedFromMerkle=0x87d91006 bisectedTo=8 bisectedToMerkle=0xb3321c66 -t=2023-11-03T21:03:08+0000 lvl=info msg="Tracking edge" service=edge-tracker id=0xc66e7e5d fromBatch=0 toBatch=1 startHeight=0 endHeight=8 endCommit=0xb3321c66 startCommit=0x0107305d validatorName= challengeType=block_challenge_edge -t=2023-11-03T21:03:08+0000 lvl=info msg="Tracking edge" service=edge-tracker startHeight=8 startCommit=0xb3321c66 endHeight=16 endCommit=0x87d91006 id=0xbb16c213 fromBatch=0 toBatch=1 validatorName= challengeType=block_challenge_edge -``` - -Aside from logs, we do not have a good way of understanding if a challenge is going in favor of the honest party. Since we cannot rely solely on logs to understand the progression of a BoLD challenge, Nitro includes an API that provides information to understand ongoing challenges and the health of the honest validators involved. - -## Enabling and configuring the API - -To enable the API, include the following parameters in the configuration of your validator: - -| Parameter | Description | -| ---------------------- | --------------------------------------- | -| `--node.bold.api` | Set to true to enable the API | -| `--node.bold.api-host` | IP to listen on (defaults to 127.0.0.1) | -| `--node.bold.api-port` | Port to listen on (defaults to 9393) | - -## Endpoints available - -The following endpoints are available at the configured host and port to query information from the API. Send a `GET` request to access them: - -### `/api/v1/assertions` - -Lists all assertions up to chain head. - -This request will return an array of objects with information about each assertion. - -### `/api/v1/assertions/` - -Returns information of a specific assertion. - -### `/api/v1/challenge//edges` - -Returns all edges for a challenged assertion. - -This request will return an array of objects with information about each edge. - -### `/api/v1/challenge//edges/history/` - -Returns information about a specific edge, given its history commitment. - -### `/api/v1/challenge//ministakes` - -Returns all the ministakes bonded under a challenged assertion. - -### `/api/v1/tracked/royal-edges` - -Returns the locally-tracked, royal edges kept in-memory by the validator. - -### `/api/v1/healthz` - -Checks if the API server is ready to serve queries. Returns a status of `200` if it is ready. Notice that this request will not return any result. diff --git a/website/sidebars.js b/website/sidebars.js index 33ab8e6f1..2b0967917 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -733,11 +733,6 @@ const sidebars = { id: 'run-arbitrum-node/more-types/run-validator-node', label: 'Run a validator', }, - { - type: 'doc', - id: 'run-arbitrum-node/more-types/bold-validator-api', - label: 'BoLD validator API', - }, { type: 'doc', id: 'run-arbitrum-node/more-types/run-classic-node',