/btc-parachain

BTC-Parachain: Trustless Bitcoin on Polkadot

Primary LanguageRustApache License 2.0Apache-2.0

BTC-Parachain

A trust-minimized bridge from Bitcoin to Polkadot.
Explore the specification »

Report Bug · Request Feature

This repository is hosted on GitLab: https://gitlab.com/interlay/btc-parachain with a mirror on GitHub.

This project is currently under active development.

Table of Contents

About the Project

This is a proof of concept implementation of a BTC Parachain to bring Bitcoin into the Polkadot universe. It allows the creation of PolkaBTC, a fungible token that represents Bitcoin in the Polkadot ecosystem. PolkaBTC is backed by Bitcoin 1:1 and allows redeeming of the equivalent amount of Bitcoins by relying on a collateralized third-party.

The project uses the concept of Cryptocurrency-backed Assets to lock Bitcoin on the Bitcoin blockchain and issue BTC-backed tokens on the BTC Parachain. The implementation is based on the BTC Parachain specification.

Built with

The BTC-Parachain is built with:

Roadmap

  • Alpha - November 2020
  • Beta - February 2021
  • Rococo - Feburary 2021
  • Kusama - TBD
  • Polkadot - TBD

Development Progess

The Substrate runtime makes use of various custom pallets that are found in the crates folder.

  • bitcoin: [Beta] Library for Bitcoin type, parsing and verification functions.
  • btc-relay: [Beta] Stateful SPV client for Bitcoin. Stores Bitcoin main chain, tracks forks, verifies Merkle proofs and validates specific transaction formats.
  • collateral [Beta] Handles locking, releasing and slashing of collateral (e.g. DOT).
  • exchange-rate-oracle: [Beta] Exchange rate oracle. Integration with external provider pending.
  • fee: [Beta] Participant reward calculation and distribution.
  • issue: [Beta] Handles issuing of PolkaBTC.
  • redeem [Beta] Handles redeeming of PolkaBTC for BTC on Bitcoin.
  • refund [Beta] Handles refunds for when a vault receives more BTC than it can cover.
  • replace [Beta] Handles replacing vaults.
  • security: [Beta] Handles BTC Parachain status and error changes.
  • sla: [Beta] Participant scoring for reward & slashing calculations.
  • staked-relayers: [Beta] Handles registration and stake of Staked Relayers, as well as voting on Parachain status changes.
  • treasury: [Beta] Exposes functions related to handling of the PolkaBTC currency (mint, lock, burn)
  • vault-registry: [Beta] Handles registration, collateral and liquidation of vaults.

Getting started

Prerequisites

curl https://sh.rustup.rs -sSf | sh

Installation

Building requires nightly. Run the following commands to set it up:

rustup toolchain install nightly-2021-01-25
rustup default nightly-2021-01-25
rustup component add rustfmt
rustup component add rls
rustup toolchain install nightly
rustup target add wasm32-unknown-unknown --toolchain nightly-2021-01-25

To build, run:

cargo build

For more detailed development instructions see here.

Testing

cargo test

To run with coverage, using cargo-cov:

cargo install cargo-cov

# clean up previous coverage result
cargo cov clean

# test the code
cargo cov test

# open the coverage report
cargo cov report --open

Running

To run a local development node, use the dev chain spec.

cargo run --release -- --dev

Clear the database using the purge-chain command.

cargo run --release -- purge-chain --dev

To disable all btc-relay block inclusion checks, use the special dev-no-btc chain spec. This is useful for testing without the overhead of running a block relayer.

cargo run --release -- --alice --chain dev-no-btc --rpc-cors all --validator --force-authoring --tmp

Additional CLI usage options are available and may be shown by running cargo run -- --help.

Rococo

By default, the btc-parachain builds in standalone mode with the aura-grandpa feature.

To build with "parachain" support use the cumulus-polkadot feature:

cargo build --manifest-path parachain/Cargo.toml --release --no-default-features --features cumulus-polkadot

To connect with a local relay-chain follow these instructions.

Test Coverage

Test coverage reports available under docs/testcoverage.html

Substrate Chain Configuration

The Substrate runtime configuration is in the parachain folder.

Javascript / Typescript

When interacting via polkadot{.js} you will need to use our custom types. Please also checkout polkabtc-js for a more complete (strongly-typed) library with bitcoinjs-lib integration.

Contributing

If you would like to contribute, please file an issue on GitLab or reach out to us.

We are hiring!

License

(C) Copyright 2020 Interlay Ltd

BTC-Parachain is currently licensed under the terms of the Apache License (Version 2.0). See LICENSE

Contact

Website: Interlay.io

Twitter: @interlayHQ

Email: contact@interlay.io

Acknowledgements

This project is supported by a Web3 Foundation grant.

We would also like to thank the following teams for their continuous support: