Skip to content
This repository was archived by the owner on Jan 9, 2026. It is now read-only.

Commit e4e0935

Browse files
committed
Add config endpoint
1 parent 4867a03 commit e4e0935

File tree

1 file changed

+129
-0
lines changed

1 file changed

+129
-0
lines changed

chainweb.openapi.yaml

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,9 @@ tags:
182182
* `application/octet-stream`, when supported by the endpoint, returns block
183183
headers as binary.
184184
185+
- name: config
186+
x-displayName: Config Endpoint
187+
185188
- name: misc
186189
x-displayName: Miscellaneous Endpoints
187190

@@ -460,6 +463,7 @@ x-tagGroups:
460463
- payload
461464
- mempool
462465
- peer
466+
- config
463467

464468
- name: chainweb_service
465469
x-displayName: Chainweb Service API
@@ -977,6 +981,15 @@ components:
977981
]
978982
}
979983

984+
nodeConfig:
985+
title: Node Configuration
986+
description: |
987+
The configuration of a node. Private information regarding certificates
988+
and local networks are removed. The schema is subject to change and not
989+
part of the stable API.
990+
example:
991+
$ref: '#/components/examples/nodeConfig'
992+
980993
# ########################################################################## #
981994
responses:
982995

@@ -1475,6 +1488,98 @@ components:
14751488
}
14761489
]
14771490

1491+
nodeConfig:
1492+
{
1493+
"allowReadsInLocal": false,
1494+
"rosetta": true,
1495+
"throttling": {
1496+
"local": 1,
1497+
"mining": 2,
1498+
"global": 200,
1499+
"putPeer": 21
1500+
},
1501+
"serviceApi": {
1502+
"interface": "invalid",
1503+
"port": 0
1504+
},
1505+
"validateHashesOnReplay": false,
1506+
"chainwebVersion": "mainnet01",
1507+
"pactQueueSize": 2000,
1508+
"mining": {
1509+
"coordination": {
1510+
"enabled": false,
1511+
"updateStreamTimeout": 240,
1512+
"limit": 1200,
1513+
"updateStreamLimit": 2000,
1514+
"miners": []
1515+
},
1516+
"nodeMining": {
1517+
"miner": {
1518+
"account": "",
1519+
"predicate": "keys-all",
1520+
"public-keys": []
1521+
},
1522+
"enabled": false
1523+
}
1524+
},
1525+
"p2p": {
1526+
"peer": {
1527+
"certificateChainFile": null,
1528+
"key": null,
1529+
"interface": "*",
1530+
"certificateChain": null,
1531+
"hostaddress": {
1532+
"hostname": "34.70.108.163",
1533+
"port": 1789
1534+
},
1535+
"keyFile": null
1536+
},
1537+
"maxPeerCount": 100,
1538+
"private": false,
1539+
"ignoreBootstrapNodes": false,
1540+
"maxSessionCount": 8,
1541+
"bootstrapReachability": 0.5,
1542+
"sessionTimeout": 300,
1543+
"peers": [
1544+
{
1545+
"address": {
1546+
"hostname": "us-e1.chainweb.com",
1547+
"port": 443
1548+
},
1549+
"id": null
1550+
},
1551+
{
1552+
"address": {
1553+
"hostname": "us-w1.chainweb.com",
1554+
"port": 443
1555+
},
1556+
"id": null
1557+
}
1558+
]
1559+
},
1560+
"transactionIndex": {
1561+
"enabled": true,
1562+
"configuration": {}
1563+
},
1564+
"gasLimitOfBlock": 150000,
1565+
"reorgLimit": 480,
1566+
"headerStream": true,
1567+
"mempoolP2p": {
1568+
"enabled": true,
1569+
"configuration": {
1570+
"pollInterval": 30,
1571+
"maxSessionCount": 6,
1572+
"sessionTimeout": 240
1573+
}
1574+
},
1575+
"reintroTxs": true,
1576+
"cuts": {
1577+
"pruneChainDatabase": "none",
1578+
"fetchTimeout": 3000000,
1579+
"initialCutHeightLimit": null
1580+
}
1581+
}
1582+
14781583
# ############################################################################ #
14791584
# Paths
14801585
# ############################################################################ #
@@ -2570,6 +2675,30 @@ paths:
25702675
# ########################################################################## #
25712676
# Misc
25722677

2678+
/config:
2679+
get:
2680+
tags: [ config ]
2681+
summary: Configuration of Chainweb Node
2682+
description: |
2683+
Returns the configuration of chainweb-node as a JSON structure.
2684+
Sensitive information is removed from the result. The JSON schema depends
2685+
on the chainweb node version and is not part of the stable chainweb-node
2686+
API.
2687+
responses:
2688+
"200":
2689+
headers:
2690+
x-peer-addr:
2691+
$ref: '#/components/headers/x-peer-addr'
2692+
x-server-timestamp:
2693+
$ref: '#/components/headers/x-server-timestamp'
2694+
x-chainweb-node-version:
2695+
$ref: '#/components/headers/x-chainweb-node-version'
2696+
content:
2697+
application/json:
2698+
summary: Configuration of the chainweb node
2699+
example:
2700+
$ref: "#/components/examples/nodeConfig"
2701+
25732702
/health-check:
25742703
servers:
25752704
- url: "https://api.chainweb.com/"

0 commit comments

Comments
 (0)