Release/2.0.0

[todofixthis]

PyOTA v2.0.0

⚠️ This release contains several changes that are not backwards compatible with the previous version. Please review the Backwards-Incompatible Changes before upgrading! ⚠️

Backwards-Incompatible Changes

• PyOTA now requires pip v9 or later.
  • If you are unable to install the latest version of PyOTA, run pip install --upgrade pip first.
• [Need minimum version number for requests library #39] PyOTA now requires requests 2.4.1 or later.
  • If you install PyOTA using pip, you do not need to do anything special; dependencies will be updated automatically when you run pip install --upgrade pyota.
  • If you install PyOTA by cloning the GitHub repo, you must re-run pip install . to install missing dependencies.
• [Kerl Integration #61] PyOTA now uses the new Kerl and Curl-P-81 algorithms.
  • This change introduces a dependency on the pysha3 library. See previous bullet point for installation instructions.
  • These changes are coordinated with the Tangle snapshot created on 21 August, 2017.
  • If your application maintains a local database of keys/addresses, you may need to regenerate them.
  • More information:
    • https://forum.iota.org/t/snapshot-public-validation-22-09-2017/4256
  • Thanks @alon-e for assistance with PyKerl implementation!
• [BaseAddressCache._gen_cache_key is too fast #51] Removed address caches for security reasons.
• Reversed the behavior of the head_to_tail parameter in Bundle.as_tryte_strings.
  • Previously, setting head_to_tail=True would return transactions in reverse order (and mutatis mutandis), which is incorrect. Now it returns the transactions in the correct order.
• Digest now requires that its length be a multiple of 81 trytes.
• Removed iota symlink at the top level of the package structure, renamed src to iota.
  • This only impacts developers who have cloned the repository; if you install PyOTA via pip, this will not affect you.

New Features

• [Add Multisig Support #10] Implemented multisig support.
• [Add support for configurable address security level #28] Added support for address security levels.
• [Attachment Timestamps #67] Added support for attachment timestamps (thanks @normpad!).
• [Reduce default min_weight_magnitude #53] Reduced default min_weight_magnitude (thanks @johngrantuk!):
  • New mainnet value: 14
  • New testnet value: 9
• [Add unit converter for transaction values #18] Added convert_value_to_standard_unit (thanks @vynes!).
• Installing via pip now automatically installs iota-cli app into env path.
  • This replaces examples/repl.py.
• Added support for PyOTA-CCurl extension.
  This is an optional C extension that improves the performance of Curl-P-81 significantly (speedups of 60x are common).
  • Thanks @elk for making the extension compatible with Python 2!

Enhancements and Bugfixes

• TryteString (and subclasses) now support creating new instances from unicode values. It is no longer necessary to convert values into byte strings first.
• [Seed.random should not generate seeds longer than 81 trytes #44] Seed.random now generates 81-tryte seeds by default.
  • Previously, it was generating 82-tryte seeds.
• [Add hash argument to Transaction.from_tryte_string #42] Transaction.from_tryte_string now accepts optional hash argument (thanks @alon-e for reporting!).
• [Exception when invoking help(iota) in examples/shell.py #41] Fixed error when invoking help(api) in the REPL script.
• Address.with_valid_checksum now also copies balance, key_index and security_level.
• [Masked Authenticated Messaging (MAM) Support #47] Added example script showing proof-of-concept for integrating with JS MAM library.
  • A Python implementation of MAM is coming; for now it is necessary to use the JS library.
• [Conflict with names when importing library.  #63] Fixed conflict when importing PyOTA in a Django project (thanks @labovich!).
• Improved PyCurl performance by ~7%.
• Split out the transactions module into its own package.
  • Existing imports should still work; please file an issue on the PyOTA Issue Tracker if you notice any broken imports.
• Made JSON representations of certain objects more comprehensive.
• Added IPython repr integrations.
• Improved documentation, fixed a few minor issues.
• Fixed incorrect behavior of examples/address_generator.py (thanks @ivoscc!).
• Fixed node URI in examples/sandbox.py.
• [Example script for routing PoW to local node #34] Added example script demonstrating how to route PoW to local node (thanks @johngrantuk)!.
• [Example script for creating transactions #31] Added example script demonstrating how to send IOTAs to an address (thanks @johngrantuk!).
• PyOTA now ships universal wheels.
• Travis CI now only deploys tagged releases to PyPI.
  • After v2.0.0, master will only contain the latest production release of PyOTA.
• Added contributor guide.
• Removed unnecessary dependencies from Python 3 installs. If you use Python 3, you may uninstall the following libraries:
  • mock
  • typing

Huge thanks to @normpad and @alon-e for helping test the v2.0.0 beta and making sure it is stable for production release!

Additional thanks to the following individuals for contributing code and identifying issues during the development of PyOTA v2:

• @alon-e
• @curVV
• @cychotic
• @elk
• @ivoscc
• @johngrantuk
• @labovich
• @normpad
• @th0br0
• @vynes