Skip to content
Dragonchain blockchain platform - simplified integration of advanced blockchain features
Python Other
  1. Python 99.1%
  2. Other 0.9%
Branch: master
Clone or download
Wingman4l7 and cheeseandcereal Bnb fixes 2 (#245)
* key fix (support base64)
Latest commit b4ee791 Nov 14, 2019

README.md

Dragonchain Logo

Dragonchain

Build Status Test Coverage Code Style Black License Banana Index

The Dragonchain platform simplifies the integration of real business applications onto a blockchain. Providing features such as easy integration, protection of business data, fixed 5 second blocks, currency agnosticism, and public blockchain interoperability, Dragonchain shines a new and interesting light on blockchain technology.

No blockchain expertise required!

🔗 Quick Links

📝 Documentation

Please read the docs for further details and documentation.

The documentation is intended for developers wishing to learn about and contribute to the Dragonchain core platform itself.

For interaction with the Dragonchain, we recommend signing up for a Dragonchain Console account and testing with our managed service, as it will be easier for getting started with developing on top of dragonchain (rather than developing the actual Dragonchain core platform).

For interaction and using the Dragonchain, check out the SDKs (or CLI) and their relevant documentation instead:

🖥️ Development

Dragonchain is implemented in Python 3, packaged into container images with Docker, and intended to be run on Kubernetes (at the moment).

The tools.sh script is used to assist in various development functions such as installing dependencies, automatically formatting/linting code, running tests, etc. Simply run ./tools.sh with no parameters to view what it can do.

In order to develop locally you should be able to run ./tools.sh full-test and have all checks pass. For this, a few requirements should be met:

  1. Ensure that you have python 3.8 installed locally
  2. Install OS dependencies for building various python package dependencies:
    • On an arch linux system (with pacman): ./tools.sh arch-install
    • On a debian-based linux system (with apt): ./tools.sh deb-install (Note on newer Ubuntu installations you may need to install libsecp256k1-dev if the secp256k1 python package fails to build)
    • On a Mac (with brew): ./tools.sh mac-install
  3. Install the python requirements: ./tools.sh pip-install (Note this will install the python packages to the current user's site-packages. For a python venv, follow the steps below)
  4. Helm is required to be installed for linting the helm chart.
  5. yq is required to be installed for building the docs, as it parses the helm chart's version to update the docs dynamically.

Using a Python Virtual Environment

It is highly recommended to use a python virtual environment rather than simply installing the python package requirements to your global environment. This allows the required packages for this project to be separated from the rest of the (potentially conflicting) packages from the rest of the system.

In order to do this, instead of step 3 above, perform the following steps:

  1. Ensure you have python venv installed, and run python3.8 -m venv .venv
  2. Activate the virtual environment in your shell by running source .venv/bin/activate
  3. Upgrade the setup dependencies for the virtual environment: pip install -U pip setuptools
  4. Install the core dependencies: pip install -r requirements.txt
  5. Install the dev dependencies: pip install -U -r dev_requirements.txt

Other Information

For more information, including a deeper dive on the architecture/code structure, please read the docs.

🚀 Contributing

Want to make some money for helping the project? We have project, bug, and security bounty programs which we invite anyone to participate in. Details for these programs can be found here:

For more info on contributing, please read the contributing document.

✔️ Support

You can’t perform that action at this time.