docs(rpc): add get_network_pubkey; correct availability, ports; mark start_dkg/reset_network as not exposed

Author: hoffmabc

src/rpc/http-methods/get-network-pubkey.md

@@ -0,0 +1,37 @@
+# `get_network_pubkey`
+
+**Description:** Returns the current network verifying key as a hex string.
+
+- In `validator`, this is the FROST group verifying key managed by the node's key manager.
+- In `local_validator`, this returns the local validator's x-only public key used for development.
+
+**Method:** `POST`
+
+**Parameters:** None.
+
+**Returns:** Hex-encoded verifying key string.
+
+**Request:**
+```bash
+curl -vL POST -H 'Content-Type: application/json' -d '
+{
+  "jsonrpc":"2.0",
+  "id":1,
+  "method":"get_network_pubkey",
+  "params":[]
+}' \
+http://localhost:9002/
+```
+
+**Response:**
+```json
+{
+  "jsonrpc": "2.0",
+  "result": "c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00c0ffee00",
+  "id": "1"
+}
+```
+
+**Notes:**
+- Available in both `validator` and `local_validator`.
+- No parameters are required.

src/rpc/http-methods/reset-network.md

@@ -1,36 +1,3 @@
-# `resetNetwork`
-
-> ⚠️ Note: 
->
-> _This method is only callable by the Leader node, which for the time being will be Arch. This method is used for internal debugging purposes as we get the Testnet operational._ 
-> 
-> This endpoint is also not available for local validators.
-
-**Description:** Resets the network state. 
-
-**Parameters:**
-    None.
-
-**Returns:** A success message if the network reset is successful.
-
-**Request:**
-```bash
-curl -vL POST -H 'Content-Type: application/json' -d '
-{
-  "jsonrpc":"2.0",
-  "id":1,
-  "method":"reset_network",
-  "params":[]
-}' \
-http://localhost:9002/
-```
-
-**Response:**
-```json
-{
-  "jsonrpc": "2.0",
-  "result": "Success!",
-  "id": "1"
-}
-```
+# `reset_network` (not currently exposed)
 
+This endpoint is not currently exposed by the validator's RPC server. It may appear in older docs but is unavailable in the running node.

src/rpc/http-methods/start-dkg.md

@@ -1,34 +1,5 @@
-# `startDkg`
+# `start_dkg` (not currently exposed)
 
-> ️️⚠️ Note: This endpoint is not available for local validators.
-
-**Description:** Initiates the Distributed Key Generation (DKG) process.
-
-**Method:** `POST`
-
-**Parameters:**
-    None.
-
-**Returns:** A success message if the DKG process is initiated.
-
-**Request:**
-```bash
-curl -vL POST -H 'Content-Type: application/json' -d '
-{
-    "jsonrpc":"2.0",
-    "id":1,
-    "method":"start_dkg",
-    "params":[]
-}' \
-http://localhost:9002/
-```
-
-**Response:**
-```json
-{
-  "jsonrpc": "2.0",
-  "result": "DKG process initiated",
-  "id": "1"
-}
-```
+This endpoint is not currently exposed by the validator's RPC server. It may appear in older docs or client stubs but is unavailable in the running node.
 
+Use `get_network_pubkey` to retrieve the network verifying key. No replacement RPC exists for starting DKG via public API.

src/rpc/rpc-method-availability.md

@@ -28,10 +28,7 @@ The following RPC methods are available in both `validator` and `local_validator
 - `get_transactions_by_block` - Single BlockTransactionsParams object
 - `get_transactions_by_ids` - Single TransactionsByIdsParams object
 - `get_version` - No parameters
-- `get_arch_txid_from_btc_txid` - Single string parameter (Bitcoin transaction ID)
-- `get_transaction_report` - Single string parameter (transaction ID)
-- `get_latest_tx_using_account` - Single string parameter (account public key)
-- `get_all_accounts` - No parameters
+- `get_network_pubkey` - No parameters
 
 ### Available Only in Validator Crate
 
@@ -40,6 +37,22 @@ The following RPC methods are **only available** in the `validator` crate:
 - `get_peers` - No parameters
 - `get_current_state` - No parameters
 
+### Available Only in Local Validator Crate
+
+The following RPC methods are available only in the `local_validator` crate (development/debug helpers):
+
+- `get_arch_txid_from_btc_txid` - Single string parameter (Bitcoin transaction ID)
+- `get_transaction_report` - Single string parameter (transaction ID)
+- `get_latest_tx_using_account` - Single string parameter (account public key)
+- `get_all_accounts` - No parameters
+
+### Deprecated or Not Exposed
+
+The following legacy methods are not currently exposed via RPC in the validator:
+
+- `start_dkg`
+- `reset_network`
+
 ## Parameter Format Patterns
 
 ### Single Parameter Methods

src/rpc/rpc.md

@@ -13,7 +13,7 @@ The Arch Network provides a comprehensive JSON-RPC API for interacting with vali
 ## API Endpoints
 
 ### Default Configuration
-- **Default Port**: `9002` for validator nodes, `9001` for local validators
+- **Default Port**: `9001` for validator nodes, `9002` for local validators
 - **Endpoint URL**: `http://localhost:9002` (or your node's IP address)
 - **Protocol**: HTTP POST with JSON-RPC 2.0
 
@@ -70,8 +70,7 @@ All RPC requests must be sent as HTTP `POST` requests with:
 - [`is_node_ready`](#is_node_ready) - Check node readiness
 - [`get_peers`](#get_peers) - Get connected network peers
 - [`get_current_state`](#get_current_state) - Get current validator node state
-- [`start_dkg`](#start_dkg) - Initiate Distributed Key Generation (leader only)
-- [`reset_network`](#reset_network) - Reset network state (leader only)
+- [`get_network_pubkey`](#get_network_pubkey) - Get the network verifying key
 
 ### System Operations
 - [`get_version`](#get_version) - Get node version information
@@ -659,44 +658,21 @@ curl -X POST -H 'Content-Type: application/json' -d '
 }' http://localhost:9002/
 ```
 
-### start_dkg
+### get_network_pubkey
 
-Initiates the Distributed Key Generation (DKG) process.
+Returns the current network verifying key as a hex string.
 
 **Parameters:** None
 
-**Returns:** Success message if the DKG process is initiated
-
-**Note:** Not available for local validators.
-
-**Example:**
-```bash
-curl -X POST -H 'Content-Type: application/json' -d '
-{
-    "jsonrpc":"2.0",
-    "id":1,
-    "method":"start_dkg",
-    "params":[]
-}' http://localhost:9002/
-```
-
-### reset_network
-
-Resets the network state.
-
-**Parameters:** None
-
-**Returns:** Success message if the network reset is successful
-
-**Note:** Only callable by the Leader node. Not available for local validators.
+**Returns:** Hex-encoded verifying key string
 
 **Example:**
 ```bash
 curl -X POST -H 'Content-Type: application/json' -d '
 {
     "jsonrpc":"2.0",
     "id":1,
-    "method":"reset_network",
+    "method":"get_network_pubkey",
     "params":[]
 }' http://localhost:9002/
 ```