Skip to main content

Substrate utility library providing functionality for multi-signature trading.

Project description

substrate-utils

Substrate utility library providing functionality for exchange management and multi-signature trading, originally built for LocalCoinSwap

Python package PyPI pyversions PyPI version shields.io

The focus of this library is on functionality needed to provide an exchange service, including:

  • Account generation
  • Balance checking
  • Making transfers
  • Creating N/M (2/3) escrow addresses
  • Non-custodial trades
  • Cancellation of trades
  • Administration of trade disputes
  • Verification of transactions
  • Diagnostics for common problems
  • Associated cryptography

For complete examples please review the documentation. If there's any exchange functionality you need which we haven't provided, feel free to raise an issue in Github.


Installation

pip install substrate-utils

Quick start

from substrateutils import Kusama, Polkadot, Kulupu
kusama = Kusama()
polkadot = Polkadot()
kulupu = Kulupu()

Documentation

https://localcoinswap.github.io/substrate-utils/

Local development

Pre-requisites

  • Python 3.8.1 (preferred)

We suggest using pyenv to easily manage python versions. Some of the following commands use pyenv. Use pyenv-installer for easy installation. Then add pyenv-virtualenv plugin to it.

Configure local development setup

  • Install and activate python 3.8.1 in the root directory

    • pyenv install 3.8.1
    • pyenv virtualenv 3.8.1 substrateutils
    • pyenv local substrateutils
  • Install project requirements

    • pip install -r requirements.txt
  • Install precommit hook

    • pre-commit install

You're all set to hack!

Before making changes, let's ensure tests run successfully on local.

Running Tests

  • Run all tests with coverage
    • coverage run -m pytest -v
  • Show report in terminal
    • coverage report -m

Notes

Trade storage calls for 2/3 trades cost:

Polkadot - 40.3040 DOT  
Kusama   - 6.71733331304 KSM  

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

substrate-utils-1.0.24.tar.gz (24.6 kB view hashes)

Uploaded Source

Built Distribution

substrate_utils-1.0.24-py2.py3-none-any.whl (25.0 kB view hashes)

Uploaded Python 2 Python 3

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