Starknet

Starknet Pathfinder

This guide covers how to run a Starknet full node (Pathfinder) and set up validator attestation using Docker.

✅ Run Pathfinder with Docker


```bash
mkdir -p $HOME/pathfinder

docker run \
  --name pathfinder \
  --restart unless-stopped \
  --detach \
  -p 9545:9545 \
  --user "$(id -u):$(id -g)" \
  -e RUST_LOG=info \
  -e PATHFINDER_ETHEREUM_API_URL="wss://mainnet.infura.io/ws/v3/<your_project_id>" \
  -v $HOME/pathfinder:/usr/share/pathfinder/data \
  eqlabs/pathfinder:latest

🔍 View logs

docker logs -f pathfinder

🛑 Stop container

docker stop pathfinder

✅ Run Validator Attestation

Requirements:

Pathfinder running at http://localhost:9545/rpc/v0_8
Operational private key (must hold STRK for gas)

docker run -it --rm --network host \
  -e VALIDATOR_ATTESTATION_OPERATIONAL_PRIVATE_KEY="0xYOUR_PRIVATE_KEY" \
  ghcr.io/eqlabs/starknet-validator-attestation \
  --staker-operational-address 0xYOUR_ADDRESS \
  --node-url http://localhost:9545/rpc/v0_8 \
  --local-signer

✅ Quick RPC Check

curl -X POST http://localhost:9545/rpc/v0_8 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"starknet_blockNumber","params":[],"id":1}'