Skip to content
/ tbtc Public
forked from keep-network/tbtc

Trustlessly tokenized Bitcoin on Ethereum ;)

License

Notifications You must be signed in to change notification settings

mkjp81/tbtc

 
 

Repository files navigation

tBTC

CircleCI Build Status Docs Chat with us on Discord

tBTC is a trustlessly Bitcoin-backed ERC-20 token.

The goal of the project is to provide a stronger 2-way peg than federated sidechains like Liquid, expanding use cases possible via today’s Bitcoin network, while bringing superior money to other chains.

This repo contains the Solidity smart contracts and specification.

Getting started

Installation

tBTC contracts are currently published in the GitHub Package Registry.

  1. Add a file .npmrc to the same directory as your project’s package.json.

  2. Paste the following to configure the GitHub Package Registry for tBTC:

    @keep-network:registry=https://npm.pkg.github.com/keep-network
  3. Install the package:

    $ npm install @keep-network/tbtc

Usage

NOTE: tBTC contracts require solc v0.5.10 or higher. You may have to configure solc in your truffle-config.js.

Once installed, you can use the contracts in the library by importing them:

pragma solidity ^0.5.0;

import "@keep-network/tbtc/contracts/deposit/Deposit.sol";

contract MySystem {
    function checkTerm(address _depositAddress) external {
        uint256 remainingTerm = Deposit(_depositAddress).remainingTerm();
    }
}

Security

tBTC is currently under audit.

Please report any security issues you find to [email protected].

Contributing

All contributions are welcome. To report bugs, please create an issue on this repository. To start a discussion, prefer Discord over GitHub issues.

Setup environment

You should have installed:

Build

Clone and install dependencies:

git clone https://github.com/keep-network/tbtc
cd tbtc/solidity
npm install

Deploy contracts:

truffle migrate --reset

Test

Tests are written in JS using Mocha.

To run the test suite, execute truffle test.

To run specific tests, add .only to the contract block:

contract.only('TBTCToken', function(accounts) {

Lint

We use ESLint and Ethlint for linting code. To run:

npm run sol:lint:fix
npm run js:lint:fix

Documentation

The documentation includes a project overview and rationale, as well as the on-chain specification. Docs should always be updated before or in tandem with code.

Prerequisites

Docs are written in AsciiDoctor, diagrams in a LaTeX package called Tikz.

macOS

  1. Install TeX Live manually, and other dependencies using CLI:

    gem install asciidoctor-pdf --pre
    brew install poppler
  2. Install the TikZ package to your local LaTeX environment:

    sudo cp docs/latex/tikz-uml.sty /usr/local/texlive/texmf-local/
    
    # Update TeX package tree
    sudo texhash

Build

cd docs

# Generate diagrams
make pngs
# Generate index.pdf
asciidoctor-pdf index.adoc

License

tBTC is released under the MIT License.

About

Trustlessly tokenized Bitcoin on Ethereum ;)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 50.8%
  • Solidity 48.0%
  • Shell 1.2%