Welcome to pyetheroll’s documentation!¶

Readme¶

pyetheroll¶

Python library to Etheroll smart contract

Usage¶

Simply set bet size, chances and wallet settings before rolling:

from pyetheroll.etheroll import Etheroll

etheroll = Etheroll()
bet_size_ether = 0.1
chances = 50
wallet_path = 'wallet.json'
wallet_password = 'password'

transaction = etheroll.player_roll_dice(
    bet_size_ether, chances, wallet_path, wallet_password)

It’s also possible to set different contract address and chain ID:

from pyetheroll.constants import ChainID
from pyetheroll.etheroll import Etheroll

chain_id = ChainID.ROPSTEN
contract_address = '0xe12c6dEb59f37011d2D9FdeC77A6f1A8f3B8B1e8'
etheroll = Etheroll(chain_id, contract_address)

Find out more in docs/Examples.md.

Install¶

Latest stable release:

pip install pyetheroll

Development branch:

pip install --process-dependency-links \
https://github.com/AndreMiras/pyetheroll/archive/develop.zip

Examples¶

Here is a list of common things the library can help with.

Get address last rolls¶

Basically what you need is the Etheroll.get_last_bets_transactions() method. See example rolls2csv.py for a detailed example.

How to release¶

This is documenting the release process.

Git flow & CHANGELOG.md¶

Make sure the CHANGELOG.md is up to date and follows the http://keepachangelog.com guidelines. Start the release with git flow:

git flow release start YYYYMMDD

Now update the CHANGELOG.md [Unreleased] section to match the new release version. Also update the version string in the setup.py file. Then commit and finish release.

git commit -a -m "YYYYMMDD"
git flow release finish

Push everything, make sure tags are also pushed:

git push
git push origin master:master
git push --tags

Publish to PyPI¶

Build it:

python setup.py sdist bdist_wheel

Check archive content:

tar -tvf dist/pyetheroll-*.tar.gz

Twine check and upload:

twine check dist/*
twine upload dist/*

GitHub¶

Got to GitHub Release/Tags, click “Add release notes” for the tag just created. Add the tag name in the “Release title” field and the relevant CHANGELOG.md section in the “Describe this release” textarea field. Finally, attach the generated APK release file and click “Publish release”.