🔍 Troubleshooting

Common Issues

"VB image not found": Ensure IPFS is running and the CID is correct

ipfs cat $IMAGE_CID > /dev/null  # Should not error

"Proof verification failed": Usually indicates a bug in the VB runtime or input data

# Check logs for detailed error messages
podman logs validator 2>&1 | grep -i error

"Worker not responding": Ensure worker is registered and running

zenithd query workers show-worker worker-1 --node http://localhost:26657

Nix and Non Nix

If you are not using Nix, it may be annoying to constantly see error message about flake failed to load. As a hack, it is possible to just hide the logs of direnv completely. Put this into your direnv.toml (typically it is in $XDG_CONFIG_HOME/direnv/ or $HOME/.config/direnv):

[global]
log_filter="^$"

Debug Mode

For development, use debug mode for faster proving:

export RISC0_DEV_MODE=1
export RUST_LOG=debug