---
updatedAt: 2025-06-11T20:38:20.000Z
agentTools:
  projectIndex: https://docs.allthatnode.com/llms.txt
---

# Dial Seeds (Unsafe)

Dial a peer, this route in under unsafe, and has to manually enabled to use

  **Example:** curl 'localhost:26657/dial_seeds?seeds=\["f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656","0491d373a8e0fcf1023aaf18c51d6a1d0d4f31bd@5.6.7.8:26656"\]'

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "CometBFT RPC",
    "contact": {
      "name": "CometBFT",
      "url": "https://cometbft.com/"
    },
    "description": "CometBFT supports the following RPC protocols:\n\n* URI over HTTP\n* JSONRPC over HTTP\n* JSONRPC over websockets\n\n## Configuration\n\nRPC can be configured by tuning parameters under `[rpc]` table in the\n`$CMTHOME/config/config.toml` file or by using the `--rpc.X` command-line\nflags.\n\nThe default RPC listen address is `tcp://127.0.0.1:26657`.\nTo set another address, set the `laddr` config parameter to desired value.\nCORS (Cross-Origin Resource Sharing) can be enabled by setting\n`cors_allowed_origins`, `cors_allowed_methods`, `cors_allowed_headers`\nconfig parameters.\n\nIf testing using a local RPC node, under the `[rpc]`\nsection change the `cors_allowed_origins` property, please add the URL of\nthe site where this OpenAPI document is running, for example:\n\n  `cors_allowed_origins = [\"http://localhost:8088\"]`\n\nor if testing from the official documentation site:\n\n  `cors_allowed_origins = [\"https://docs.cometbft.com\"]`\n\n## Arguments\n\nArguments which expect strings or byte arrays may be passed as quoted\nstrings, like `\"abc\"` or as `0x`-prefixed strings, like `0x616263`.\n\n## URI/HTTP\n\nA REST like interface.\n\n    curl localhost:26657/block?height=5\n\n## JSONRPC/HTTP\n\nJSONRPC requests can be POST'd to the root RPC endpoint via HTTP.\n\n    curl --header \"Content-Type: application/json\" --request POST --data '{\"method\": \"block\", \"params\": [\"5\"], \"id\": 1}' localhost:26657\n\n## JSONRPC/websockets\n\nJSONRPC requests can be also made via websocket.\nThe websocket endpoint is at `/websocket`, e.g. `localhost:26657/websocket`.\nAsynchronous RPC functions like event `subscribe` and `unsubscribe` are\nonly available via websockets.\n\nFor example using the [websocat](https://github.com/vi/websocat) tool, you can subscribe for 'NewBlock` events\nwith the following command:\n\n    echo '{ \"jsonrpc\": \"2.0\",\"method\": \"subscribe\",\"id\": 0,\"params\": {\"query\": \"tm.event='\"'NewBlock'\"'\"} }' | websocat -n -t ws://127.0.0.1:26657/websocket\n",
    "version": "v0.38.x",
    "license": {
      "name": "Apache 2.0",
      "url": "https://github.com/cometbft/cometbft/blob/v0.38.x/LICENSE"
    }
  },
  "servers": [
    {
      "url": "https://rpc.cosmos.directory/cosmoshub",
      "description": "Interact with the CometBFT RPC from a public node in the Cosmos registry"
    },
    {
      "url": "http://localhost:26657",
      "description": "Interact with CometBFT RPC node running locally"
    }
  ],
  "tags": [
    {
      "name": "Unsafe",
      "description": "Unsafe APIs"
    }
  ],
  "paths": {
    "/dial_seeds": {
      "get": {
        "summary": "Dial Seeds (Unsafe)",
        "operationId": "dial_seeds",
        "tags": [
          "Unsafe"
        ],
        "description": "Dial a peer, this route in under unsafe, and has to manually enabled to use\n\n  **Example:** curl 'localhost:26657/dial_seeds?seeds=\\[\"f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656\",\"0491d373a8e0fcf1023aaf18c51d6a1d0d4f31bd@5.6.7.8:26656\"\\]'\n",
        "parameters": [
          {
            "in": "query",
            "name": "peers",
            "description": "list of seed nodes to dial",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "example": "f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dialing seeds in progress. See /net_info for details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/dialResp"
                }
              }
            }
          },
          "500": {
            "description": "empty error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "JSONRPC": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 0
          },
          "jsonrpc": {
            "type": "string",
            "example": "2.0"
          }
        }
      },
      "ErrorResponse": {
        "description": "Error Response",
        "allOf": [
          {
            "$ref": "#/components/schemas/JSONRPC"
          },
          {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "example": "Description of failure"
              }
            }
          }
        ]
      },
      "dialResp": {
        "type": "object",
        "properties": {
          "Log": {
            "type": "string",
            "example": "Dialing seeds in progress. See /net_info for details"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```