ape-risk 0.1.0a4

Description:

aperisk 0.1.0a4

Quick Start
Tools for analyzing risk in DeFi.
Dependencies

python3 version 3.8 or greater, python3-dev

Installation
via pip
You can install the latest release via pip:
pip install ape-risk

via setuptools
You can clone the repository and use setuptools for the most up-to-date version:
git clone https://github.com/ApeWorX/ape-risk.git
cd ape-risk
python3 setup.py install

Quick Usage
Provides hypothesis strategies to use in fuzz tests.
e.g. Mock prices generated by Geometric Brownian motion:
import numpy as np
from ape_risk import strategies


@given(strategies.gbms(initial_value=1.0, num_points=100000, params=[0, 0.005]))
def test_gbms_param_fuzz(p):
# strat gives a numpy.ndarray of simulated prices for each hypothesis run
assert p.shape == (100000, 1)
assert isinstance(p, np.ndarray)


C = np.asarray([[1, 0.5, 0.8], [0.5, 1, 0.4], [0.8, 0.4, 1]])
scale = np.linalg.cholesky(C).tolist()


@given(strategies.multi_gbms(initial_values=[1.0, 0.9, 0.8], num_points=100000, num_rvs=3, params=[0, 0.005], scale=scale, shift=[0, 0, 0]))
def test_multi_gbms_param_fuzz(p):
# strat gives a numpy.ndarray of multiple simulated prices for each hypothesis run
assert p.shape == (100000, 1, 3)
assert isinstance(p, np.ndarray)


Development
This project is in development and should be considered an alpha.
Things might not be in their final state and breaking changes may occur.
Comments, questions, criticisms and pull requests are welcomed.