# Tronvent

> Self-hosted TRON chain monitor. Watch wallet addresses and TRC-20 contracts, filter every block for relevant activity, and deliver signed webhooks to your application — without running your own node.

Tronvent polls TronGrid on your behalf, persists cursors in PostgreSQL, and retries webhook delivery until your backend acknowledges each event.

## What it monitors

- TRX transfers (`TransferContract`) where a watched address is sender or receiver
- TRC-20 `Transfer` events on watched token contracts (USDT is seeded by default)

## Quick start

1. Deploy with Docker or Helm
2. Set `DATABASE_URL`, `TRONGRID_API_KEY_SCANNER`, `ADMIN_API_TOKEN`, `WEBHOOK_URL`, and `WEBHOOK_SIGNING_SECRET`
3. Register addresses and contracts via the admin API or dashboard
4. Verify signed webhook payloads in your application

## Documentation

- Getting started: /docs/start
- Docker: /docs/docker
- Kubernetes / Helm: /docs/kubernetes
- Configuration: /docs/configure
- Dashboard & API: /docs/dashboard
- Watch activity: /docs/watch
- Webhooks: /docs/webhooks

## Source & license

- Repository: https://github.com/degoke/tronvent
- License: Elastic License 2.0
- Container image: ghcr.io/degoke/tronvent
- Helm chart: oci://ghcr.io/degoke/charts/tronvent