Skip to main content

Full Node FAQ

How do I check whether my node is accessible from another machine?

nc -vz {EXTERNAL_IP} 26656

How do I view my node status?

sudo systemctl status cosmovisor.service

How do I view my node logs?

sudo journalctl -u cosmovisor.service -f

How do I stop my node?

sudo systemctl stop cosmovisor.service

How do I start my node?

sudo systemctl start cosmovisor.service

How do I restart my node?

sudo systemctl restart cosmovisor.service

How do I query the latest block (i.e. check the node height)?

Using pocketd:

pocketd query block --type=height --network=local

Or, using curl:

curl -X GET http://localhost:26657/block | jq

How do I access my CometBFT endpoint externally?

The default CometBFT port is at 26657.

To make it accessible externally, you'll need to port all the instructions from port 26656 on this page to port 26657. Specifically:

# Update your firewall
sudo ufw allow 26657/tcp

# Alternatively, if ufw is not available, update your iptables
sudo iptables -A INPUT -p tcp --dport 26657 -j ACCEPT

# Update your Cosmovisor config
sed -i 's|laddr = "tcp://127.0.0.1:26657"|laddr = "tcp://0.0.0.0:26657"|' $HOME/.pocket/config/config.toml
sed -i 's|cors_allowed_origins = \[\]|cors_allowed_origins = ["*"]|' $HOME/.pocket/config/config.toml

# Restart the service
sudo systemctl restart cosmovisor.service

# Test the connection
nc -vz {EXTERNAL_IP} 26657

Learn more here.

warning

Be careful about making this public as adversarial actors may try to DDoS your node.

How do I check the node version?

pocketd version

How do I check the Cosmosvisor directory structure?

ls -la /home/pocket/.pocket/cosmovisor/

How do I check if an upgrade is available?

ls -la /home/pocket/.pocket/cosmovisor/upgrades/

How do I view node configuration?

cat /home/pocket/.pocket/config/config.toml

How do I check the version of a Full Node?

curl -s ${POCKET_RPC_ENDPONT}/abci_info | jq '.result.response.version'

For example, for Beta TestNet, we got the RPC endpoint from here and ran:

curl -s https://shannon-testnet-grove-rpc.beta.poktroll.com/abci_info | jq '.result.response.version'

How do I check for applied upgrades?

You can query on-chain upgrades using:

pocketd query upgrade applied v0.1.1

This will return the height of the upgrade v0.1.1.

How do I find information about protocol upgrades and releases?

Protocol upgrades are tracked at dev.poktroll.com/develop/upgrades/upgrade_list.

The source of truth for releases is the GitHub releases page.

Should I use Grove's public RPC endpoint?

While the beta RPC endpoint is available, it's recommended to set up your own RPC endpoint.

This is especially true if you're running a Supplier or Indexer, as there's no guarantee the public endpoints can handle all community traffic.

What should I know about early Beta TestNet blocks?

  • Early blocks on Beta TestNet may experience non-scalable validation times (e.g., 5 hours to validate) due to load tests
  • This issue will be addressed in a future state shift
  • Recommended workaround: Use a snapshot or wait for validation to complete

Where can I find deployment solutions?