> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Common commands

> Reference for common Bor and Heimdall commands used by Polygon Chain node operators.

## Frequently used commands for Bor & Heimdall

### Bor

IPC command syntax: `bor attach .bor/data/bor.ipc <command>`

| IPC Command | RPC Command | Description |
| - | - | - |
| `admin.peers.length` | `curl -H "Content-Type: application/json" --data '{"jsonrpc": "2.0", "method": "net_peerCount", "params": [], "id": 74}' localhost:8545` | Retrieves the number of peers connected to the node. |
| `admin.nodeInfo` | | Provides detailed information about the node. |
| `eth.syncing` | `curl -H "Content-Type: application/json" -d '{"id":1, "jsonrpc":"2.0", "method": "eth_syncing","params": []}' localhost:8545` | Indicates whether the node is syncing (`true`) or not (`false`). |
| `eth.syncing.highestBlock - eth.syncing.currentBlock` | | Compares the current block of your node to the highest block. |
| `eth.blockNumber` | `curl -H "Content-Type: application/json" -d '{"id":1, "jsonrpc":"2.0", "method": "eth_blockNumber","params": []}' localhost:8545` | Returns the latest block number processed by the node. |
| `debug.setHead("0x"+((eth.getBlock('latest').number) - 1000).toString(16))` | | Rewinds the blockchain to 1000 blocks prior. |
| `admin.nodeInfo.enode` | | Retrieves the public enode URL of the node. |
| `eth.syncing.currentBlock * 100 / eth.syncing.highestBlock` | | Calculates the remaining percentage for block synchronization. |
| `eth.getBlock("latest").number` | `curl http://YourIP:8545 -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0", "id":1, "method":"bor_getSigners", "params":["0x98b3ea"]}'` | Queries the height of the latest Bor block. |
| | `curl http://YourIP:8545 -X POST -H "Content-Type: application/json" --data '{"method":"eth_chainId","params":[],"id":1,"jsonrpc":"2.0"}'` | Retrieves the `chainID`. |

### Heimdall

| Command | Description | | |
| - | - | - | - |
| `curl localhost:26657/net_info?jq .result.n_peers` | Returns the number of connected peers. | | |
| \`curl -s localhost:26657/status | jq .result.sync\_info.latest\_block\_height\` | Retrieves Heimdall's current block height. | |
| \`curl localhost:26657/net\_info | grep moniker\` | Queries the node using its moniker. | |
| \`curl -s localhost:26657/status | jq .result.sync\_info.catching\_up\` | Checks if Heimdall is in sync. | |
| \`curl -s localhost:26657/status | jq .result | jq .sync\_info\` | Verifies Heimdall's sync status. |
| `heimdalld unsafe-reset-all` | Resets the database in case of issues. | | |
| `curl localhost:26657/status` | Provides comprehensive information about Heimdall. | | |

## Node management commands

| Description | Command |
| - | - |
| Locate Heimdall genesis file | `$CONFIGPATH/heimdall/config/genesis.json` |
| Locate app.toml | `/etc/heimdall/config/app.toml` |
| Locate config.toml | `/etc/heimdall/config/config.toml` |
| Locate client.toml | `/etc/heimdall/config/client.toml` |
| Start Heimdall | `$ sudo service heimdalld start` |
| Locate Bor genesis file | `$CONFIGPATH/bor/genesis.json` |
| Start Bor | `sudo service bor start` |
| Retrieve Heimdall logs | `/var/log/matic-logs/` |
| Check Heimdall logs | `journalctl -fu heimdalld.service` |
| Check Bor logs | `journalctl -fu bor.service` |
| Remove Heimdall directories | `sudo rm -rf /var/lib/heimdalld/` |
| Remove Bor directories | `sudo rm -rf /var/lib/bor` |