Skip to main content
Common issues and solutions:

​
Rules not loading

# Validate rules syntax
./blocklight validate --rules rules/

# Check core logs
docker-compose logs blocklight-core | grep -i "error\|warn"

​
No detections appearing

  • Verify rules are enabled: true
  • Test with ./blocklight dry-run --tx 0x...
  • Check blockchain connection in logs
  • Ensure WebSocket URL is accessible

​
Alerts not being sent

# Check alert configuration
./blocklight config check

# Test webhook manually
curl -X POST YOUR_SLACK_WEBHOOK \
  -H 'Content-Type: application/json' \
  -d '{"text":"Test alert"}'

​
High memory/CPU usage

  • Increase cache TTL for contracts
  • Reduce number of enabled rules
  • Check for infinite loops in rule conditions
  • Simplify complex rule conditions

​
Docker build failures

# Sync Go dependencies
cd api && go mod tidy
cd ../core && go mod tidy

# Rebuild images
docker-compose build --no-cache
Need more help? Check GitHub Issues or the Getting Started guide.