Skip to main content

Bitcoin SV made easier.

Project description

BitSV: Bitcoin SV made easy.

NOTE about cashaddresses

Bitcoin SV will be slowly reinstating legacy address format as the default standard. Cashaddress is a great tool for conversions if need be. https://github.com/oskyk/cashaddress/

https://img.shields.io/pypi/v/bitcash.svg?style=flat-square https://img.shields.io/travis/sporestack/bitcash.svg?branch=master&style=flat-square https://img.shields.io/codecov/c/github/sporestack/bitcash.svg?style=flat-square https://img.shields.io/pypi/pyversions/bitcash.svg?style=flat-square https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square

Forked from Ofek’s awesome Bit library: https://github.com/ofek/bit

Try to ignore the out of date bits on the README which refer to Bitcoin Cash and not Bitcoin SV.

What needs fixing

  • This README.

  • The test cases…

  • Testnet

  • Networking for broadcasting 100 kilobyte OP_RETURNS to miners

  • Rates (so ‘usd’, ‘jpy’, etc work as they do in bit)

BitSV is so easy to use:

For normal transactions:

>>> import bitsv
>>> from bitsv import Key
>>> my_key = Key('YourPrivateKeyGoesHere')
>>> my_key.get_balance()
9000000  # satoshis
>>> # Can include a long list of tuples as outputs
>>> outputs = [
>>>     # Donate to Wikileaks
>>>     ('1HB5XMLmzFVj8ALj6mfBsbifRoD4miY36v', 0.0035)  # 0.0035 bsv
>>> ]
>>> my_key.send(outputs)
'9f59f5c6757ec46fdc7440acbeb3920e614c8d1d247ac174eb6781b832710c1c'

Here is the transaction https://blockchain.info/tx/9f59f5c6757ec46fdc7440acbeb3920e614c8d1d247ac174eb6781b832710c1c.

For op_return (recent addition Jan 27th 2019):

>>> import bitsv
>>> from bitsv import Key
>>> my_key = Key('YourPrivateKeyGoesHere')
>>> # input a list of tuples with (data, encoding) pairs where encoding is "utf-8" or "hex"
>>> # each tuple represents separate pushdata. If you want one really big push then just use one tuple.
>>> lst_of_pushdata = [('6d01', 'hex'), ('new_name', 'utf-8')]
>>> # This sets memo.cash name to "new_name" as per https://memo.cash/protocol as an example usecase of op-return metadata
>>> my_key.send_op_return(lst_of_pushdata)

Three lines of code!

Features

  • Python’s fastest available implementation (100x faster than closest library)

  • Seamless integration with existing server setups

  • Supports keys in cold storage

  • Fully supports 25 different currencies

  • First class support for storing data in the blockchain

  • Deterministic signatures via RFC 6979

  • Access to the blockchain (and testnet chain) through multiple APIs for redundancy

  • Exchange rate API, with optional caching

  • Optimal transaction fee API, with optional caching

  • Compressed public keys by default

  • Multiple representations of private keys; WIF, PEM, DER, etc.

  • Standard P2PKH transactions

If you are intrigued, continue reading. If not, continue all the same!

Installation

BitSV is distributed on PyPI as a universal wheel and is available on Linux/macOS and Windows and supports Python 3.5+ and PyPy3.5-v5.7.1+. pip >= 8.1.2 is required.

$ pip install bitsv  # pip3 if pip is Python 2 on your system.

Documentation

Docs are hosted by Github Pages and are automatically built and published by Travis after every successful commit to BitSV’s master branch.

Credits

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bitsv-0.5.4.tar.gz (33.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page