Metadata-Version: 2.1
Name: iroha
Version: 1.6.0.1
Summary: Python library for Hyperledger Iroha
Home-page: https://github.com/hyperledger/iroha-python
Author: Soramitsu Co Ltd
Author-email: admin@soramitsu.co.jp
License: Apache-2.0
Project-URL: Jenkins, https://jenkins.soramitsu.co.jp/
Project-URL: Nexus, https://nexus.iroha.tech/
Project-URL: Documentation, https://iroha.readthedocs.io/en/latest/
Project-URL: Doxygen, https://docs.iroha.tech/
Project-URL: Source Code, https://github.com/hyperledger/iroha-python
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: protobuf>=3.8.0
Requires-Dist: protobuf<=3.20.1
Requires-Dist: grpcio-tools>=1.12.1
Requires-Dist: pysha3; python_version < "3.6"
Requires-Dist: pynacl>=1.4.0

# Python library for Hyperledger Iroha

This is a source repository for HL Iroha Python library.

Currently, latest [HL Iroha release 1.6](https://github.
com/hyperledger/iroha/releases) is supported. It can be used with one of official docker images:
- `hyperledger/iroha:latest`
- `hyperledger/iroha-burrow:latest` with Hyperledger-Burrow support (smart contracts).

The library works in Python 3 environment (Python 2 is not supported).

### Installation

```bash
pip install iroha
```

### Usage Example

```python
from iroha import Iroha, IrohaCrypto, IrohaGrpc

iroha = Iroha('alice@test')
net = IrohaGrpc('127.0.0.1:50051')

alice_key = IrohaCrypto.private_key()
alice_tx = iroha.transaction(
    [iroha.command(
        'TransferAsset', 
        src_account_id='alice@test', 
        dest_account_id='bob@test', 
        asset_id='bitcoin#test',
        description='test',
        amount='1'
    )]
)
IrohaCrypto.sign_transaction(alice_tx, alice_key)
net.send_tx(alice_tx)

for status in net.tx_status_stream(alice_tx):
    print(status)
```

Please explore [examples](examples) directory for more usage examples.

All the library methods have docstrings in its source [iroha.py](iroha/iroha.py).

*The links above are broken outside the [hyperledger/iroha-python](https://github.com/hyperledger/iroha-python) GitHub repository.*

If you are interested in different HL Iroha client libraries you can check our [Wiki](https://wiki.hyperledger.org/display/iroha/Hyperledger+Iroha).
