61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
|
# celo-indexer
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
A lightweight Postgres chain indexer designed to couple with [celo-tracker](https://github.com/grassrootseconomics/celo-tracker) to index all relevant GE related blockchain data on the Celo blockchain.
|
||
|
|
|
||
|
|
## Getting Started
|
||
|
|
|
||
|
|
### Prerequisites
|
||
|
|
|
||
|
|
* Git
|
||
|
|
* Docker
|
||
|
|
* Postgres server
|
||
|
|
* Access to a `celo-tracker` instance
|
||
|
|
|
||
|
|
See [docker-compose.yaml](dev/docker-compose.yaml) for an example on how to run and deploy a single instance.
|
||
|
|
|
||
|
|
### 1. Build the Docker image
|
||
|
|
|
||
|
|
We provide pre-built images for `linux/amd64`. See the packages tab on Github.
|
||
|
|
|
||
|
|
If you are on any other platform:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git clone https://github.com/grassrootseconomics/celo-indexer.git
|
||
|
|
cd celo-indexer
|
||
|
|
docker buildx build --build-arg BUILD=$(git rev-parse --short HEAD) --tag celo-indexer:$(git rev-parse --short HEAD) --tag celo-indexer:latest .
|
||
|
|
docker images
|
||
|
|
```
|
||
|
|
|
||
|
|
### 2. Run Postgres
|
||
|
|
|
||
|
|
For an example, see `dev/docker-compose.postgres.yaml`.
|
||
|
|
|
||
|
|
### 3. Update config values
|
||
|
|
|
||
|
|
See `.env.example` on how to override default values defined in `config.toml` using env variables. Alternatively, mount your own config.toml either during build time or Docker runtime.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Override only specific config values
|
||
|
|
nano .env.example
|
||
|
|
mv .env.example .env
|
||
|
|
```
|
||
|
|
|
||
|
|
Special env variables:
|
||
|
|
|
||
|
|
* DEV=*
|
||
|
|
|
||
|
|
Refer to [`config.toml`](config.toml) to understand different config value settings.
|
||
|
|
|
||
|
|
|
||
|
|
### 4. Run the indexer
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd dev
|
||
|
|
docker compose up
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
[AGPL-3.0](LICENSE).
|