aioethereum 0.2.2

Ethereum RPC client library for Python asyncio (PEP 3156)

aioethereum

Ethereum RPC client library for the PEP 3156 Python event loop.

Features

ujson support	Yes
uvloop support	Yes
High-level APIs	Yes
HTTP support	Yes
Unix domain socket (IPC) support	Yes
SSL/TLS support	Yes
Tested CPython versions	3.4, 3.5, 3.6
Tested Geth versions	1.7.0
Implemented RPC apis	admin, db, debug, eth, miner, net, personal, shh, txpool, web3

Documentation

http://aioethereum.readthedocs.io/

Usage examples

Simple high-level interface (through HTTP):

import asyncio
import aioethereum

loop = asyncio.get_event_loop()

async def go():
    client = await aioethereum.create_ethereum_client(
        'http://localhost:8545', loop=loop)
    val = await client.web3_clientVersion()
    print(val)

loop.run_until_complete(go())
# will print like 'Geth/v1.7.0-stable-6c6c7b2a/darwin-amd64/go1.9'

or via IPC

import asyncio
import aioethereum

loop = asyncio.get_event_loop()

async def go():
    client = await aioethereum.create_ethereum_client(
        'ipc://<path_to_unix_socket>', loop=loop)
    val = await client.web3_clientVersion()
    print(val)

loop.run_until_complete(go())
# will print like 'Geth/v1.7.0-stable-6c6c7b2a/darwin-amd64/go1.9'

Requirements

• Python 3.3+

• asyncio or Python 3.4+

• ujson

• aiohttp

Note

ujson is preferred requirement. Pure C JSON encoder and decoder is implemented as well and can be used automatically when installed.

License

The aioethereum is offered under MIT license.

0.2.2 (2018-04-10)

• Fix bug, related to https://www.python.org/dev/peps/pep-0492/#new-syntax;

• Fix port detection for client when only domain;

0.2.1 (2017-10-08)

• Add admin and debug management apis;

• Add new tests;

• Add uvloop support (python 3.5+ required);

0.2.0 (2017-10-05)

• Add more docstrings to the code;

• Add tests for all rpc methods;

• Add admin and debug;

• Fix error for unixsocket retring;

• Fix unixsocket invalid loop for Python 3.4;

• BaseAsyncIOClient._rpc marked as deprecated and will be removed in 0.3.0;

0.1.1 (2017-10-01)

• Add sphinx docs;

0.1.0 (2017-09-30)

• Initial release;

• Ethereum client implemented;

• WIP on RPC management.