Metadata-Version: 2.1
Name: balpy
Version: 0.0.0a13
Summary: Balancer V2 Python API
Home-page: https://balancer.fi
Author: Langer
Author-email: langer@balancer.fi
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/gerrrg/balpy/issues
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

# balpy
Python tools for interacting with Balancer Protocol V2 in Python. 

DISCLAIMER: While balpy is intended to be a useful tool to simplify interacting with Balancer V2 Smart Contracts, this package is an ALPHA-build and should be considered as such. Use at your own risk! This package is capable of sending Ethereum tokens controlled by whatever private key you provide. User assumes all liability for using this software. Users are STRONGLY encouraged to experiment with this package on testnets before using it on mainnet with valuable assets.

## Usage
balpy has been tested on:
- MacOS using Python 3.9.0
- Linux using Python 3.9-dev
- Windows using Python 3.9.5

### Install
I recommend using a virtual environment:

python3 -m venv ./venv

source ./venv/bin/activate

python3 -m pip install balpy

See release on PyPI: https://pypi.org/project/balpy/

### Build from source
git clone https://github.com/gerrrg/balpy.git

cd balpy

python3 -m build

python3 -m pip install dist/<your_build>.whl

### Environment Variables
You must set these two environment variables in order to use the balpy module
- KEY_API_ETHERSCAN: 	API key for Etherscan for gas prices
- KEY_PRIVATE: 			Plain text private key for signing transactions

You also must set AT LEAST one of these environment variables to connect to the network
- KEY_API_INFURA: 		API key for Infura for sending transactions
- BALPY_CUSTOM_RPC:   Custom RPC URL (like localhost or Polygon RPC)


## Samples
See README.md in samples/ for more information.


