tracoor

README

Tracoor

TODO

---

Live Versions

Mainnet

Goerli

---

Contents

• Features

• Usage
  • Configuration
  • Getting Started
    • Download a release
    • Docker
      • Images
    • Kubernetes via Helm
    • Building yourself

• Contributing
  • Running locally
    • Backend
    • Frontend
• Contact

---

Features

• Web interface for viewing beacon states, execution block traces and invalid gossiped blocks
• Configurable retention period
• Prometheus metrics

Capturing

• Ethereum Beacon Node
• Ethereum Execution Node

Storing

• Memory
• Filesystem
• S3

Indexing

• Sqlite
• Postgres

Usage

Tracoor requires a config file. An example file can be found here.

tracoor - fetches and serves Ethereum fork choice data

Usage:
  tracoor [flags]

Flags:
      --config string   config file (default is config.yaml) (default "config.yaml")
  -h, --help            help for tracoor

Getting Started

Download a release

Download the latest release from the Releases page. Extract and run with:

./tracoor --config your-config.yaml

Docker

Available as a docker image at ethpandaops/tracoor

Images

• latest - distroless, multiarch
• latest-debian - debian, multiarch
• $version - distroless, multiarch, pinned to a release (i.e. 0.1.0)
• $version-debian - debian, multiarch, pinned to a release (i.e. 0.1.0-debian)

Quick start

docker run -d  --name tracoor -v $HOST_DIR_CHANGE_ME/config.yaml:/opt/tracoor/config.yaml -p 9090:9090 -p 5555:5555 -it ethpandaops/tracoor:latest --config /opt/tracoor/config.yaml;
docker logs -f tracoor;

Kubernetes via Helm

Read more

helm repo add ethereum-helm-charts https://ethpandaops.github.io/ethereum-helm-charts

helm install tracoor ethereum-helm-charts/tracoor -f your_values.yaml

Building yourself

1. Clone the repo

   go get github.com/ethpandaops/tracoor
   

2. Change directories

   cd ./tracoor
   

3. Build the binary

    go build -o tracoor .
   

4. Run the service

    ./tracoor
   

Contributing

Contributions are greatly appreciated! Pull requests will be reviewed and merged promptly if you're interested in improving the tracoor!

1. Fork the project
2. Create your feature branch:
   • git checkout -b feat/new-feature
3. Commit your changes:
   • git commit -m 'feat(profit): new feature
4. Push to the branch: -git push origin feat/new-feature
5. Open a pull request

Running locally

Backend

go run main.go --config your_config.yaml

Frontend

A frontend is provided in this project in ./web directory which needs to be built before it can be served by the server, eg. http://localhost:5555.

The frontend can be built with the following command;

# install node modules and build
make build-web

Building frontend requires npm and NodeJS to be installed.

Contact

Sam - @samcmau

Andrew - @savid