Skip to content

Commit cd97032

Browse files
committed
Add getNodeVersionV2 endpoint
1 parent 339eea9 commit cd97032

File tree

4 files changed

+76
-0
lines changed

4 files changed

+76
-0
lines changed

apis/node/version.v2.yaml

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
get:
2+
operationId: "getNodeVersionV2"
3+
tags:
4+
- Node
5+
summary: "Get version information for the beacon node and execution payload validator."
6+
description: "Retrieves structured information about the version of the beacon node and its attached execution payload validator."
7+
responses:
8+
"200":
9+
description: Request successful
10+
content:
11+
application/json:
12+
schema:
13+
title: GetVersionV2Response
14+
type: object
15+
required: [data]
16+
properties:
17+
data:
18+
type: object
19+
required: [beacon_node, execution_payload_validator]
20+
properties:
21+
beacon_node:
22+
$ref: '../../beacon-node-oapi.yaml#/components/schemas/ClientVersionV1'
23+
execution_payload_validator:
24+
$ref: '../../beacon-node-oapi.yaml#/components/schemas/ClientVersionV1'
25+
examples:
26+
StatefulELValidator:
27+
value:
28+
data:
29+
beacon_node:
30+
code: "LH"
31+
name: "Lighthouse"
32+
version: "v8.0.1"
33+
commit: "ced49dd2"
34+
execution_payload_validator:
35+
code: "NM"
36+
name: "Nethermind"
37+
version: "v1.35.8"
38+
commit: "c066aee2"
39+
StatelessELValidator:
40+
value:
41+
data:
42+
beacon_node:
43+
code: "LS"
44+
name: "Lodestar"
45+
version: "v1.38.0"
46+
commit: "dbd94781"
47+
execution_payload_validator:
48+
code: "ZK"
49+
name: "ZK Proof Verifier"
50+
version: "v0.0.1"
51+
commit: "c066aee2"
52+
53+
"500":
54+
$ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'

apis/node/version.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ get:
33
tags:
44
- Node
55
summary: "Get version string of the running beacon node."
6+
deprecated: true
67
description: "Requests that the beacon node identify information about its implementation in a format similar to a [HTTP User-Agent](https://tools.ietf.org/html/rfc7231#section-5.5.3) field."
78
responses:
89
"200":

beacon-node-oapi.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,8 @@ paths:
162162
$ref: "./apis/node/peer_count.yaml"
163163
/eth/v1/node/version:
164164
$ref: "./apis/node/version.yaml"
165+
/eth/v2/node/version:
166+
$ref: "./apis/node/version.v2.yaml"
165167
/eth/v1/node/syncing:
166168
$ref: "./apis/node/syncing.yaml"
167169
/eth/v1/node/health:
@@ -255,6 +257,8 @@ components:
255257
$ref: './types/primitive.yaml#/GenesisTime'
256258
Version:
257259
$ref: './types/primitive.yaml#/Version'
260+
ClientVersionV1:
261+
$ref: './types/node.yaml#/ClientVersionV1'
258262
ForkVersion:
259263
$ref: './types/primitive.yaml#/ForkVersion'
260264
DependentRoot:

types/node.yaml

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
ClientVersionV1:
2+
type: object
3+
description: "A structure which uniquely identifies a client implementation and its version; similar to [HTTP User-Agent](https://tools.ietf.org/html/rfc7231#section-5.5.3)."
4+
required: [name, version, commit]
5+
properties:
6+
code:
7+
type: string
8+
example: "LS"
9+
name:
10+
type: string
11+
example: "Lodestar"
12+
version:
13+
type: string
14+
example: "v1.23.4"
15+
commit:
16+
type: string
17+
example: "fa4ff922"

0 commit comments

Comments
 (0)