polygon-etl 0.5.0

Description:

polygonetl 0.5.0

Polygon ETL CLI
Polygon ETL lets you convert blockchain data into convenient formats like CSVs and relational databases.
Full documentation available here.
Quickstart
Install Polygon ETL CLI:
pip3 install polygon-etl

Export blocks, actions and logs (Schema, Reference):
> polygonetl export_blocks_and_transactions --start-block 0 --end-block 500000 \
--provider-uri grpcs://api.mainnet.polygon.one:443 \
--blocks-output blocks.csv --transactions-output transactions.csv


Stream blocks, actions and logs to console (Reference):
> pip3 install polygon-etl[streaming]
> polygonetl stream --start-block 500000 -e block,action,log --log-file log.txt \
--provider-uri grpcs://api.mainnet.polygon.one:443

Find other commands here.
For the latest version, check out the repo and call
> pip3 install -e .
> python3 polygonetl.py

Useful Links

Schema
Command Reference
Documentation

Running Tests
> pip3 install -r ../requirements_test.txt -e .[streaming]
> export POLYGONETL_RUN_SLOW_TESTS=true
> export POLYGONETL_PROVIDER_URI=grpcs://api.mainnet.polygon.one:443
> pytest -vv

Running Tox Tests
> pip3 install -r ../requirements_test.txt
> export POLYGONETL_RUN_SLOW_TESTS=true
> export POLYGONETL_PROVIDER_URI=grpcs://api.mainnet.polygon.one:443
> tox

Running in Docker


Install Docker https://docs.docker.com/install/


Build a docker image
> docker build -t polygon-etl:latest .
> docker image ls



Run a container out of the image
> docker run -v $HOME/output:/polygon-etl/output polygon-etl:latest export_blocks -s 1 -e 5499999 -b 1000 -o out



Run streaming to console or Pub/Sub
> docker build -t polygon-etl:latest -f Dockerfile .
> echo "Stream to console"
> docker run polygon-etl:latest stream --start-block 500000 --log-file log.txt
> echo "Stream to Pub/Sub"
> docker run -v /path_to_credentials_file/:/polygon-etl/ --env GOOGLE_APPLICATION_CREDENTIALS=/polygon-etl/credentials_file.json polygon-etl:latest stream --start-block 500000 --output projects/<your-project>/topics/mainnet