Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


SwapBill is an 'embedded' cryptocurrency protocol and cryptocurrency, currently at the preview stage, and supporting embedding in bitcoin testnet and litecoin testnet.

This project is a (pure python) reference client for the SwapBill protocol.


In addition to standard cryptocurrency features, SwapBill notably also provides trustless cross-chain exchange functionality (based on a built-in 'pay on reveal secret' transaction type).


To run the SwapBill reference client you'll need:

  • Python version 2.7, 3.2, 3.3 or 3.4
  • The third party Python 'ecdsa' and 'requests' modules
  • The bitcoin reference client ('Bitcoin Core') set up and running as an RPC server, and/or
  • The litecoin reference client ('LitecoinQT') set up and running as an RPC server

The code has been tested on Linux and Windows, but should work on any platform with support for the litecoin reference client and the required Python dependencies.


The SwapBill documentation can be found here:

The original bitcointalk announcement thread can be found here

The SwapBill source code lives here:

Twitter: @swapbill Official Subreddit:

Quick start

Download the source code.

Install the required third party python dependencies, e.g.:

  • by installing the python-requests and python-ecdsa packages (in Ubuntu or similar, use python3-requests and python3-ecdsa for python3), or
  • through pip or easy_install, e.g. 'sudo pip install requests', 'sudo pip install ecdsa' (or without sudo, in a virtualenv)

Set up Bitcoin Core to run as an RPC server, on testnet. (More details about this in the documentation here.)

Run the client, from the top directory of the source code, with 'python get_balance'. You should see something like:

~/git/swapbill $ python get_balance
Failed to load from cache, full index generation required (no cache file found)
State update starting from block 305846
Committed state updated to start of block 305886
In memory state updated to end of block 305906
Operation successful
balance : 0

For more details, troubleshooting, and to find out how to exchange between swapbill and host coin (or across blockchains), refer to the documentation.


No description, website, or topics provided.






No packages published