Metadata-Version: 2.1
Name: UniswapPy
Version: 1.1.1
Summary: Uniswap for Python
Home-page: http://github.com/icmoore/uniswappy
Author: icmoore
Author-email: utiliwire@gmail.org
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: scipy>=1.7.3

# UniswapPy
This package is a python re-factor of the original [Uniswap V2 pairing code](https://github.com/Uniswap/v2-core/blob/master/contracts/UniswapV2Pair.sol) and can be 
utilized for the purpose of analysing and modelling its behavior for DeFi

To install package:
```
> git clone https://github.com/icmoore/uniswappy
> pip install .
```
or
```
> pip install UniswapPy
```

# Basic Usage

* See [test notebook](https://github.com/icmoore/uniswappy/blob/main/notebooks/tutorials/pairingcode.ipynb) for basic usage

```
from uniswappy.erc import ERC20
from uniswappy.cpt.factory import UniswapFactory

user_nm = 'user_intro'
eth_amount = 1000
dai_amount = 1000000

dai = ERC20("DAI", "0x111")
eth = ERC20("ETH", "0x09")
factory = UniswapFactory("ETH pool factory", "0x2")
lp = factory.create_exchange(eth, dai, symbol="LP", address="0x011")
lp.add_liquidity(user_nm, eth_amount, dai_amount, eth_amount, dai_amount)
lp.info()
```

#### OUTPUT:
Exchange ETH/DAI (LP) <br/>
Coins: ETH/DAI <br/>
Reserves: ETH = 1000 | DAI = 1000000 <br/>
Liquidity: 31622.776601683792 <br/><br/>

```
from uniswappy.process.swap import Swap

out = Swap().apply(lp, dai, user_nm, 1000)
lp.info()
```

#### OUTPUT:
Exchange ETH/DAI (LP) <br/>
Coins: ETH/DAI <br/>
Reserves: ETH = 999.00399301896 | DAI = 1001000 <br/>
Liquidity: 31622.776601683792 <br/><br/>


# Special Features
 * **Abstracted Actions**: Obfuscation is removed from standard Uniswap action events to help streamline analysis and lower line count; see article [How to Handle Uniswap Withdrawals like an OG](https://medium.com/coinmonks/handle-uniswap-withdrawals-like-an-og-389fe74be18c), and [Setup your Uniswap Deposits like a Baller](https://medium.com/coinmonks/setup-your-uniswap-deposits-like-a-baller-b99340ea302f)
 * **Indexing**: Can calculate settlment LP token amounts given token amounts and vice versa; see article [The Uniswap Indexing Problem](https://medium.com/datadriveninvestor/the-uniswap-indexing-problem-8078b8b110fc)
 * **Simulation**: Can simulate trading using Geometric Brownian Motion (GBM) process, or feed in actual raw price data to analyze behavior; see article [How to Simulate a Liquidity Pool for Decentralized Finance](https://medium.com/@icmoore/simulating-a-liquidity-pool-for-decentralized-finance-6f357ec8564b)
 * **Randomized Events**: Token amount and time delta models to simulate possible trading behavior
 * **Analytical Tools**: Basic yeild calculators and risk tools to assist in analyzing outcomes
 
 
