interlay / Btc Parachain

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
  • Built With
• Roadmap
• Getting Started
  • Prerequisites
  • Installation
• Contributing
• License
• Contact
• Acknowledgements

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:

• Rust

• Substrate

  

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.

• Discord
• Telegram
• Riot

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: [email protected]

Acknowledgements

This project is supported by a Web3 Foundation grant.

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

• Parity Technologies