Useful Commands

Pathfinder and attestation operations for Starknet Mainnet.

Mainnet · pathfinder-mainnet

Service operations

Container status

Show the node container.

sudo docker ps -a --filter name=pathfinder-mainnet

Logs

Follow node logs.

sudo docker logs --tail 100 -f pathfinder-mainnet

Restart

Restart the same container and configuration.

sudo docker restart pathfinder-mainnet

Stop

Stop the node cleanly.

sudo docker stop -t 120 pathfinder-mainnet

Start

Start an existing stopped container.

sudo docker start pathfinder-mainnet

Resource usage

Inspect CPU and memory use.

sudo docker stats --no-stream pathfinder-mainnet

JSON-RPC checks

Network

Query the local versioned endpoint.

curl -fsS http://127.0.0.1:9545/rpc/v0_10 -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"starknet_chainId","params":[],"id":1}' | jq

Sync status

Query the local versioned endpoint.

curl -fsS http://127.0.0.1:9545/rpc/v0_10 -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"starknet_syncing","params":[],"id":1}' | jq

Block height

Query the local versioned endpoint.

curl -fsS http://127.0.0.1:9545/rpc/v0_10 -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"starknet_blockNumber","params":[],"id":1}' | jq

RPC specification

Query the local versioned endpoint.

curl -fsS http://127.0.0.1:9545/rpc/v0_10 -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"starknet_specVersion","params":[],"id":1}' | jq

Attestation operations

Attestation logs

Check confirmed attestations and funding errors.

sudo docker logs --tail 100 -f attest-mainnet

Restart attestations

Restart the existing service.

sudo docker restart attest-mainnet

Metrics

Read local Prometheus metrics.

curl -fsS http://127.0.0.1:9090/metrics

Storage

Database size

Measure the mounted database.

du -sh "$HOME/pathfinder-mainnet/data"

Free space

Check available filesystem space.

df -h "$HOME/pathfinder-mainnet/data"