Skip to main content

AuthServiceProxy is an improved version of python-jsonrpc.

It includes the following generic improvements:

  • HTTP connections persist for the life of the AuthServiceProxy object

  • sends protocol ‘version’, per JSON-RPC 1.1

  • sends proper, incrementing ‘id’

  • uses standard Python json lib

  • can optionally log all RPC calls and results

  • JSON-2.0 batch support

It also includes the following bitcoin-specific details:

  • sends Basic HTTP authentication headers

  • parses all JSON numbers that look like floats as Decimal, and serializes Decimal values to JSON-RPC connections.

Installation

  1. change the first line of setup.py to point to the directory of your installation of python 2.*

  2. run setup.py

Note: This will only install taorpc. If you also want to install jsonrpc to preserve backwards compatibility, you have to replace ‘taorpc’ with ‘jsonrpc’ in setup.py and run it again.

Or simply install the library using pip:

pip install python-taorpc

Example

from taorpc.authproxy import AuthServiceProxy, JSONRPCException

# rpc_user and rpc_password are set in the bitcoin.conf file
rpc_connection = AuthServiceProxy("http://%s:%s@127.0.0.1:8332"%(rpc_user, rpc_password))
best_block_hash = rpc_connection.getbestblockhash()
print(rpc_connection.getblock(best_block_hash))

# batch support : print timestamps of blocks 0 to 99 in 2 RPC round-trips:
commands = [ [ "getblockhash", height] for height in range(100) ]
block_hashes = rpc_connection.batch_(commands)
blocks = rpc_connection.batch_([ [ "getblock", h ] for h in block_hashes ])
block_times = [ block["time"] for block in blocks ]
print(block_times)

Logging all RPC calls to stderr

from taorpc.authproxy import AuthServiceProxy, JSONRPCException
import logging

logging.basicConfig()
logging.getLogger("TaoRPC").setLevel(logging.DEBUG)

rpc_connection = AuthServiceProxy("http://%s:%s@127.0.0.1:8332"%(rpc_user, rpc_password))
print(rpc_connection.getinfo())

Produces output on stderr like

DEBUG:TaoRPC:-1-> getinfo [] DEBUG:TaoRPC:<-1- {“connections”: 8, …etc }

Release files for python-taorpc 1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-taorpc 1.0
File Size Uploaded
python-taorpc-1.0.tar.gz 13.5 kB Details

Release files / python-taorpc-1.0.tar.gz

Download URL python-taorpc-1.0.tar.gz
Size 13.5 kB
Tags Source
SHA-256 checksum
How to use checksums
2a55268bfb0c1f53e73f8e10bad1ec93ebd135c4713bf7d473c60fc89ffca155
BLAKE2b-256 checksum
How to use checksums
46b3bb396c4cd8beca719edba213b2ae1a89ca8c74d5eb80516e844b4a067d1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/38.5.2 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.4

Release history Release notifications | RSS feed

This release

1.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page