rpc-nodes/bor/bor.md

# Bor node

## Requirements for Polygon network
* memory: 64Gb (minimum)
* disk: 3Tb SSD (require periodically prune state) - you can use less if you prune more often, but you still need at least 2TB.

## Installation
Set in the `.env` file:
* `DOMAIN=` - the domain name to be used in traefik;
* `HEIMDALL_ETH_RPC_URL=` - your Ethereum RPC.

You can also set a list of allowed IP addresses there and addresses to treat as local. Rename `example.env` to `.env`:
```
mv example.env .env
```

Start node (If you do not use traefik, specify the compose file with the `-f docker-compose.no-proxy.yml`):
```bash
docker-compose build
docker-compose up -d rabbitmq heimdalld heimdallr bor
```

To see the sync status run:
`curl -X POST --data '{"jsonrpc": "2.0", "id": 1, "method": "eth_syncing"}' -H 'Content-Type: application/json' -s https://${DOMAIN}/bor-http/`
* `currentBlock` - your node current height;
* `highestBlock` - network height.

## Upgrade
Periodically check for new versions. if there is a release, then you need to update the tag (`BOR_TAG`) in the environment file. 
```bash
docker-compose build
docker-compose pull
docker-compose up -d rabbitmq heimdalld heimdallr bor
```

## Pruning 
Use it if the size is approaching 1.7Tb. At least 150 GB must be free for successful pruning.
```bash
docker-compose stop bor
docker-compose up prune-bor
docker-compose rm prune-bor 
docker-compose up -d bor
```