Web3.py
Project description
# Web3.py
[![Join the chat at https://gitter.im/pipermerriam/web3.py](https://badges.gitter.im/pipermerriam/web3.py.svg)](https://gitter.im/pipermerriam/web3.py?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/pipermerriam/web3.py.png)](https://travis-ci.org/pipermerriam/web3.py)
[![Documentation Status](https://readthedocs.org/projects/web3.py/badge/?version=latest)](https://readthedocs.org/projects/web3.py/?badge=latest)
[![PyPi version](https://pypip.in/v/web3.py/badge.png)](https://pypi-hypernode.com/pypi/web3.py)
[![PyPi downloads](https://pypip.in/d/web3.py/badge.png)](https://pypi-hypernode.com/pypi/web3.py)
A python implementation of [web3.js](https://github.com/ethereum/web3.js)
## Goals
* Python 2.7, 3.4, 3.5 support
* Provide a feature-for-feature python implementation of Web3.js
# API
## `web3`
### `web3.sha3`
```python
>>> web3.sha3(b'some text')
'46ba1b442d3606a3437800ee7ae5a0249756405e676739b46aa8f6e85b13fe2b'
>>> web3.sha3('0x80', encoding='hex')
'56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421'
```
## `web3.eth`
### `web3.eth.iban`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK")
<web3.eth.iban.Iban at 0x107301dd8>
```
#### `web3.eth.iban.fromAddress`
```python
>>> web3.eth.iban.fromAddress('0x00c5496aee77c1ba1f0854206a26dda82a81d6d8').toString()
'XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'
```
#### `web3.eth.iban.fromBban`
```python
>>> web3.eth.iban.fromBban('ETHXREGGAVOFYORK').toString()
'XE81ETHXREGGAVOFYORK'
```
#### `web3.eth.iban.createIndirect`
```python
>>> web3.eth.iban.createIndirect({
... 'institution': "XREG",
... 'identifier': "GAVOFYORK"
... }).toString()
'XE81ETHXREGGAVOFYORK'
```
#### `web3.eth.iban.isValid`
```python
>>> web3.eth.iban.isValid("XE81ETHXREGGAVOFYORK")
True
>>> web3.eth.iban.isValid("XE82ETHXREGGAVOFYORK")
False # false, cause checksum is incorrect
web3.eth.iban("XE81ETHXREGGAVOFYORK").isValid()
True
```
#### `web3.eth.iban.isDirect`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").isDirect()
False
```
#### `web3.eth.iban.isIndirect`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").isIndirect()
True
```
#### `web3.eth.iban.checksum`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").checksum()
'81'
```
#### `web3.eth.iban.institution`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").institution()
'XREG'
```
#### `web3.eth.iban.client`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").client()
'GAVOFYORK'
```
#### `web3.eth.iban.address`
```python
>>> web3.eth.iban('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS').address()
'00c5496aee77c1ba1f0854206a26dda82a81d6d8'
```
#### `web3.eth.iban.toString`
```python
>>> web3.eth.iban('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS').toString()
'XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'
```
[![Join the chat at https://gitter.im/pipermerriam/web3.py](https://badges.gitter.im/pipermerriam/web3.py.svg)](https://gitter.im/pipermerriam/web3.py?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/pipermerriam/web3.py.png)](https://travis-ci.org/pipermerriam/web3.py)
[![Documentation Status](https://readthedocs.org/projects/web3.py/badge/?version=latest)](https://readthedocs.org/projects/web3.py/?badge=latest)
[![PyPi version](https://pypip.in/v/web3.py/badge.png)](https://pypi-hypernode.com/pypi/web3.py)
[![PyPi downloads](https://pypip.in/d/web3.py/badge.png)](https://pypi-hypernode.com/pypi/web3.py)
A python implementation of [web3.js](https://github.com/ethereum/web3.js)
## Goals
* Python 2.7, 3.4, 3.5 support
* Provide a feature-for-feature python implementation of Web3.js
# API
## `web3`
### `web3.sha3`
```python
>>> web3.sha3(b'some text')
'46ba1b442d3606a3437800ee7ae5a0249756405e676739b46aa8f6e85b13fe2b'
>>> web3.sha3('0x80', encoding='hex')
'56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421'
```
## `web3.eth`
### `web3.eth.iban`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK")
<web3.eth.iban.Iban at 0x107301dd8>
```
#### `web3.eth.iban.fromAddress`
```python
>>> web3.eth.iban.fromAddress('0x00c5496aee77c1ba1f0854206a26dda82a81d6d8').toString()
'XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'
```
#### `web3.eth.iban.fromBban`
```python
>>> web3.eth.iban.fromBban('ETHXREGGAVOFYORK').toString()
'XE81ETHXREGGAVOFYORK'
```
#### `web3.eth.iban.createIndirect`
```python
>>> web3.eth.iban.createIndirect({
... 'institution': "XREG",
... 'identifier': "GAVOFYORK"
... }).toString()
'XE81ETHXREGGAVOFYORK'
```
#### `web3.eth.iban.isValid`
```python
>>> web3.eth.iban.isValid("XE81ETHXREGGAVOFYORK")
True
>>> web3.eth.iban.isValid("XE82ETHXREGGAVOFYORK")
False # false, cause checksum is incorrect
web3.eth.iban("XE81ETHXREGGAVOFYORK").isValid()
True
```
#### `web3.eth.iban.isDirect`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").isDirect()
False
```
#### `web3.eth.iban.isIndirect`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").isIndirect()
True
```
#### `web3.eth.iban.checksum`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").checksum()
'81'
```
#### `web3.eth.iban.institution`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").institution()
'XREG'
```
#### `web3.eth.iban.client`
```python
>>> web3.eth.iban("XE81ETHXREGGAVOFYORK").client()
'GAVOFYORK'
```
#### `web3.eth.iban.address`
```python
>>> web3.eth.iban('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS').address()
'00c5496aee77c1ba1f0854206a26dda82a81d6d8'
```
#### `web3.eth.iban.toString`
```python
>>> web3.eth.iban('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS').toString()
'XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'
```