awesomebitcoin.cash/README.md

<br/>
<div align="center">
  <img width="250px" src="./awesome-bitcoin-cash.png">
</div>
<br/>
<div align="center">
A curated list of Bitcoin Cash software developer resources <br>
<a href="https://awesome.re">
  <img src="https://awesome.re/badge.svg" alt="awesome" style="height:12px;border:10;">
</a>
<br />
<br />
Bitcoin Cash (BCH) chain-forked from BTC in 2017 to scale on-chain as an electronic peer-to-peer system for the world. 🚀
</div>
<br/>

This project is **not a fork** of the canonical [awesome-bitcoin-cash](https://github.com/dsmurrell/awesome-bitcoin-cash).

📤 [a mobile friendly version](https://2qx.github.io/awesome-bitcoin-cash/) of this [project](https://github.com/2qx/awesome-bitcoin-cash) is formatted [from markdown](https://github.com/2qx/awesome-bitcoin-cash/blob/master/README.md) by github pages.

Pull requests are welcome, please see [the contribution guidelines](CONTRIBUTING.md).

# Contents
- [Contents](#contents)
- [Whitepaper](#whitepaper)
- [Roadmaps](#roadmaps)
- [Developer resources](#developer-resources)
  - [Base Protocol](#base-protocol)
    - [Secondary protocols](#secondary-protocols)
  - [Bitcoin Script](#bitcoin-script)
  - [Full Nodes](#full-nodes)
  - [Open Source Wallets](#open-source-wallets)
    - [Desktop](#desktop)
    - [Mobile](#mobile)
    - [Cli](#cli)
    - [Browser](#browser)
    - [Paper/Offline Generator](#paperoffline-generator)
  - [Libraries & SDKs](#libraries--sdks)
    - [Javascript](#javascript)
    - [Typescript](#typescript)
    - [Python](#python)
    - [Java](#java)
    - [PHP](#php)
  - [SLP Token Specific Tools](#slp-token-specific-tools)
- [Adoption](#adoption)
  - [eCommerce](#ecommerce)
    - [Plugins and Resources](#plugins-and-resources)
    - [Payment Processor Status](#payment-processor-status)
  - [List of Project Lists](#list-of-project-lists)
  - [Apps](#apps)
    - [Shipyard](#shipyard)
    - [Shipped](#shipped)
    - [Launchpad](#launchpad)
    - [In the Boneyard](#in-the-boneyard)
    - [A Short List](#a-short-list)
    - [Merchants near you or where you're headed](#merchants-near-you-or-where-youre-headed)
    - [Listing directories across the broader internet](#listing-directories-across-the-broader-internet)
  - [Charities and Foundations](#charities-and-foundations)

# Whitepaper

"Bitcoin: A Peer-to-Peer Electronic Cash System" by Satoshi Nakamoto.

- [Archived copy](https://web.archive.org/web/20100704213649if_/http://www.bitcoin.org:80/bitcoin.pdf) of the bitcoin whitepaper from bitcoin.org
- [bitcoin whitepaper](https://gateway.ipfs.io/ipfs/QmRA3NWM82ZGynMbYzAgYTSXCVM14Wx1RZ8fKP42G6gjgj) via ipfs
- [Websites hosting the bitcoin whitepaper](https://blockchair.com/bitcoin/whitepaper), with sha256 hashes calculated hourly.
- [Instructions and code](https://bitcoin.stackexchange.com/questions/35959/how-is-the-whitepaper-decoded-from-the-blockchain-tx-with-1000x-m-of-n-multisi) for building the original paper encoded on the blockchain on 2013-04-06.


# Roadmaps

- [Bitcoin Cash Roadmap](https://www.bitcoincash.org/roadmap.html) - official.
- [Detailed Specs of Proposed Improvements](https://www.bitcoincash.org/specs/) - an ongoing list.
- [Coin Dance list](https://cash.coin.dance/development) - with broader developments and proposals in various states from many groups


# Developer resources

- [Full-Stack how-to](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer) - Chris Troutner's introduction to developing on Bitcoin Cash
- [*Mastering Bitcoin Cash*](https://developer.bitcoin.com/mastering-bitcoin-cash/) - Fork of Andreas M. Antonopoulos' book under Creative Commons
- [developers.cash](https://developers.cash/) - many useful resources and [tools](https://developers.cash/tools/)
- [bitcoincash.org dev docs](https://www.bitcoincash.org/developers.html) - libraries for interacting with Bitcoin Cash
- [Bitcoin.com Developer Resources](https://developer.bitcoin.com/) - Tooling and documentation developed by bitcoin.com
- [tutorial.cash](https://www.tutorial.cash/) - video tutorials

## Base Protocol

- [Base Protocol Reference](https://reference.cash/) - maintained by Bitcoin Unlimited

### Secondary protocols

A site dedicated to collecting [Bitcoin Cash Standards](https://bitcoincashstandards.org)
  
- [Payment Requests Specification (BIP-0070)](https://github.com/bitcoin/bips/blob/master/bip-0070.mediawiki) - For dealing with invoice style payments at specific amounts.
- [Cash Accounts](https://gitlab.com/cash-accounts/specification/blob/master/SPECIFICATION.md) - attach a human readable name to Bitcoin Cash addresses
- [Memo Protocol](https://memo.cash/protocol) - for the on-chain tweet style social media app
- [Memo with Member extensions](https://github.com/memberapp/protocol) - for creating a reddit/hn style app
- [Simple Ledger Protocol (SLP)](https://simpleledger.cash/) [[specs]](https://slp.dev) - for handling ERC-20 style tokens
- [CashShuffle](https://cashshuffle.com/) [[spec]](https://github.com/cashshuffle/spec/blob/master/SPECIFICATION.md) - a privacy protocol for combining transactions with others, splitting to the lowest common amount.
- [CashFusion](https://cashfusion.org/) [[spec]](https://github.com/cashshuffle/spec/blob/master/CASHFUSION.md) - a privacy protocol for privately and trustlessly joining coin amounts.
- [CashID](https://gitlab.com/cashid/protocol-specification) - Specification using Bitcoin Cash for secure authentication.
- [snowglobe](https://github.com/tyler-smith/snowglobe/blob/master/spec/snowglobe.md) [[draft implementation (golang)]](https://github.com/gcash/bchd/tree/snowglobe/)- 🐉 Active local-state reconciliation using Avalanche 🐉 

## Bitcoin Script

- [meep](https://github.com/gcash/meep) - a command line Bitcoin Cash script debugger.
- [bitauth ide](https://ide.bitauth.com/) [[src]](https://github.com/bitauth/bitauth-ide) - an integrated development environment for bitcoin authentication.
- [spedn](https://spedn.readthedocs.io/en/latest/) [[src]](https://bitbucket.org/o-studio/spedn/src/develop/) - a high level smart contract language that compiles to Bitcoin Cash Script.
- [Cashscript](https://cashscript.org/docs/basics/about/) - a solidity-style language that compiles to Bitcoin Cash Script.
- [Cashscript alt-docs](https://developer.bitcoin.com/cashscript/docs/language) - documentation for Cashscript hosted at bitcoin.com.

## Full Nodes

- [BitcoinABC](https://www.bitcoinabc.org/) [[mirror]](https://github.com/Bitcoin-ABC/bitcoin-abc) - a full node implementation of the Bitcoin Cash protocol. The dominant mining implementation, C/C++.
- [BitcoinUnlimited](https://www.bitcoinunlimited.info/) [[src]](https://github.com/BitcoinUnlimited/BitcoinUnlimited) - a full node implentation focused on supporting user needs, C/C++.
- [BCHN](https://bitcoincashnode.org/) [[src]](https://gitlab.com/bitcoin-cash-node/bitcoin-cash-node) - a descendant of the Bitcoin Core and Bitcoin ABC software projects with independant development team. C/C++.
- [bchd](https://bchd.cash/) [[src]](https://github.com/gcash/bchd) - alternative implementation written in Go (golang)
- [Bitcoin Verde](https://bitcoinverde.org/) [[src]](https://github.com/softwareverde/bitcoin-verde)[[docs]](https://bitcoinverde.org/documentation/) - java implementation with the goal of being interoperable with mining nodes
- [Flowee the Hub](https://flowee.org/) [[src]](https://gitlab.com/FloweeTheHub) - a node supporting a suite of software focused on payment integration. C++
- [Knuth](https://kth.cash/) [[src]](https://github.com/k-nuth/kth)- a high performance implementation of the Bitcoin protocol focused on applications needing extra capacity and resilience.

## Open Source Wallets

### Desktop
- [Electron-Cash](https://electroncash.org) [[src]](https://github.com/Electron-Cash/Electron-Cash) - the awesome SPV wallet for Bitcoin Cash
- [crescent.cash](https://crescent.cash) [[src]](https://gitlab.com/pokkst/crescentcash) - a Bitcoin Cash wallet in java.
  
#### Electron-Cash Plugins
- [Flipstarter Plugin](https://gitlab.com/flipstarter/flipstarter-electron-cash) - plugin for crowdfunding
- [Mecenas Plugin](https://github.com/KarolTrzeszczkowski/Mecenas-recurring-payment-EC-plugin/releases) - recurring payments
- [Last Will](https://github.com/KarolTrzeszczkowski/Electron-Cash-Last-Will-Plugin) - dead man smart contract creation
- [More Comprehensive List](https://blog.imaginary.cash/index.php/electron-cash-plugins/) - hosted by im_uname

### Mobile
- [Electron-Cash](https://electroncash.org) - Android and iOS version available with limited functionality
- [crescent.cash](https://crescent.cash) [[src]](https://gitlab.com/pokkst/crescentcash) - Android wallet with SLP, BIP70 and sms features.
- [neutrino](https://github.com/gcash/android-neutrino) - Android wallet with advanced privacy features.


### Cli
- [bchwallet](https://github.com/gcash/bchwallet) - a secure Bitcoin Cash wallet daemon written in Go (golang)
- [openbazaar wallet](https://github.com/OpenBazaar/spvwallet) - an SPV wallet in Go (golang) used by openbazaar2

### Browser

- [blockparty](https://blockparty.sh/) [[docs]](https://github.com/blockparty-sh/wallet/blob/master/README.md) - A simple in-browser web wallet using bitox.earth
- [mint](https://github.com/Bitcoin-com/mint) - Non-custodial web-based tool to manage your SLP tokens. 
  
### Paper/Offline Generator
- [Cash Address Generator](https://cashaddress.org/) - reputable javascript random address generator suitable for offline use.
- [BCH Gifts](https://gifts.bitcoin.com/) - generate reclaimable preloaded paper private keys as gifts.
- [SLP wallet generator](https://wallet.bitchslap.tech/) - generator for Simple Ledger addresses

## Libraries & SDKs

### Javascript
- [Bitcoin Cash JavaScript Library based on BITBOX](https://fullstack.cash) [[docs]](https://bchjs.cash/bch-js/index.html) - Chris Troutner's Bitcoin Cash stack.
- [libcash-js](https://developers.cash/resource/libcash-js/default) - javascript library using the flowee api.
- [bitcore-lib-cash](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-lib-cash) - javaScript library, maintained by bitpay.
- [bchd grpc web-client](https://github.com/simpleledgerinc/grpc-bchrpc-web) - protobuf based javascript client for interacting with bchd full nodes.

### Typescript
- [Bitbox SDK](https://developer.bitcoin.com/bitbox/) [[docs]](https://developer.bitcoin.com/bitbox/docs/getting-started) - library for interacting with BCH via rest.bitcoin.com.
- [Badger SDK](https://developer.bitcoin.com/badger/docs/getting-started) - browser extension wallet supporting BCH and SLP on webpages.
- [bitcoin-ts](https://github.com/bitauth/bitcoin-ts) - a zero-dependency, typescript bitcoin library, including WASM crypto functions, BTC, but BCH friendly.

### Python
- [bitcash](https://sporestack.github.io/bitcash/) [[src]](https://github.com/sporestack/bitcash) - python3 library.
- [bchd python bindings](https://github.com/gcash/bchd/tree/master/bchrpc/pb-py) - sample protobuf based python client for bchd.

### Java
- [bitcoincashj](https://github.com/pokkst/bitcoincashj) - Bitcoin Cash library for Java 

### PHP
- [cashp](https://github.com/Ekliptor/cashp) - Library for BCH and SLP tokens

## SLP Token Specific Tools

- [Electron-Cash SLP Edition](https://simpleledger.cash/project/electron-cash-slp-edition/)
- [slpjs](https://github.com/simpleledger/slpjs) - library for interacting with SLP tokens, dependent on bitbox.
- [SLPDB](https://github.com/simpleledger/SLPDB) - simpleledger indexer 
- [SLP Indexer](https://github.com/Bitcoin-com/slp-indexer) - bitcoin.com indexer
- [SLP SDKs](https://simpleledger.cash/project/slp-sdk/) - for android and iOS.


# Adoption

## eCommerce

### Plugins and Resources

#### Bitcoin Cash Open-Source plugins
- [CryptoWoo for WooCommerce](https://github.com/WeProgramIT/cryptowoo-bitcoin-cash-addon) - Woocommerce with integrated wallet

#### BCH-to-Fiat Payment Processors
- [BitPay developer Integrations](https://bitpay.com/integrations/) [[api docs]]((https://bitpay.com/docs))
- [Coinpayments Tools](https://www.coinpayments.net/merchant-tools) [[plugins]](https://www.coinpayments.net/merchant-tools-plugins) - Integrations for coinpayments
- [GoCoin](https://gocoin.com/docs) - GoCoin integrations, libraries & API docs.
- [Coinbase](https://commerce.coinbase.com/integrate) - Merchant integrations for coinbase

### Payment Processor Status

- [status.coinbase.com](https://status.coinbase.com/#) - Dashboard with subscriptions endpoints and post-mortems
- [status.bitPay.com](https://status.bitpay.com/) - Current status with recent incidents 

## List of Project Lists

There have been many projects built on Bitcoin Cash. This list doesn't attempt to be comprehensive, but more projects are listed by these sources:

- [Canonical awesome-bitcoin-cash](https://github.com/dsmurrell/awesome-bitcoin-cash) - the original.
- [Bitcoin Cash Projects](https://www.bitcoin.com/bitcoin-cash-projects/) - maintained by bitcoin.com.
- [BCH Developments](https://keepbitcoinfree.org/bch-dev/) - list maintained by KeepBitcoinFree.

## Apps

### Shipyard

These are up and coming projects in beta:

- [causes.cash](https://causes.cash/) [[src]](https://gitlab.com/bchplease/causes.cash) - a site for creating your own fundraising campaign
- Electron-Cash 4.1.* (CashFusion Alpha) [[src]](https://github.com/Electron-Cash/Electron-Cash/tree/cashfusion) [[bin]](https://c3-soft.com/downloads/BitcoinCash/Electron-Cash/Fusion/)
### Shipped

#### Network

- [doublespend.cash](https://doublespend.cash) - view Bitcoin Cash double spend attempts.
- [tx street](https://txstreet.com/beta) - transaction visualizer, updated with popular protocols.
- [privacy stats](https://stats.cash/#/) - recent list and totals of shuffles & fusions.

#### Social
- [read.cash](https://read.cash) - a conventionally hosted long-format blogging platform, with BCH tipping for content.
- [flipstarter](https://flipstarter.cash/) [Introduction](https://read.cash/@flipstarter/introducing-flipstarter-695d4d50) - a crowd funding app using anyone can pay multisig transactions.
- [memo.cash](https://memo.cash) - short message social media site with decentralized SLP token exchange.
- [member.cash](https://member.cash) - longer format social media platform with voting, tipping, moderation and filtering.

#### Marketplace
- [OpenBazaar](https://openbazaar.org/download/) -  desktop (daemon w/ electron app) p2p marketplace using multisig transactions.
- [Havenapp](https://gethaven.app/) - mobile implementation of openbazaar.

#### Entertainment
- [blockchain.poker](https://blockchain.poker) - Texas Hold'em using zero-conf for BCH deposits, BTC and BSV supported.
- [Satoshi dice](https://www.satoshidice.com/) -  a provably fair dice game.

#### Web

- [Pay Button](https://paybutton.org/docs/) [[src]](https://github.com/PayButton/paybutton) - a simple snippet to accept Bitcoin Cash on your website.

#### Utilities

- [CashAccount](https://www.cashaccount.info/) - Online utility for cashaccounts (address handles).
- [Bitcoin.com Tools](https://tools.bitcoin.com/) - A mix of Bitcoin utilities.

#### Bots

- [chaintip](https://www.chaintip.org) - An on-chain non-custodial tipping bot for reddit/twitter & github.
- [tipbitcoin.cash](https://tipbitcoin.cash) - Live tipping bot for video streamers.
- [bitcash](https://gitcash.io/start) - A custodial tipping bot for github. 
- [Chaintip Bounties](https://github.com/chaintip/bounties/blob/master/README.md#available-bounties) - BCH bot for github bounties.


### Launchpad

Awesome projects which appear to be dormant due to lack of use.

- [lazyfox](https://lazyfox.io) - a Bitcoin Cash powered question and answer / tasking platform.
- [stack exchange](https://read.cash/@nyusternie/stackexchange-provides-shelter-for-homeless-bch-developers-87223764) - an unsuccessful initiative to create a Bitcoin Cash stack exchange.
- [Satoshi Wall](https://satoshiwall.cash/) - a non-custodial payment wall service.
- [Chaintip Bounties](https://github.com/chaintip/bounties/blob/master/README.md#available-bounties) - bounties for github commits.


### In the Boneyard

These ships are apparently in long term storage

- [Learn Bitcoin dot Cash](https://learnbitcoin.cash/) - Letsencrypt expired Monday, April 27, 2020 at 2:24:48 PM
- [BCH Pizza](https://www.bchpizza.org) - Connection Refused
- [SLPDEX](https://slpdex.cash/) [[src]](https://github.com/slpdex/slpdex) - Decentralized token exchange, errors on slp/list


### A Short List

This list is meant to highlight really awesome sites accepting Bitcoin Cash. They have accepted Bitcoin Cash for years and are committed (or sympathetic) toward the idea of electronic cash payments.

- [Namecheap](https://namecheap.com) - dns, ssl and some packaged hosting.
- [CheapAir](https://www.cheapair.com) - for your travel needs.
- [items sold by Newegg](https://kb.newegg.com/knowledge-base/using-bitcoin-on-newegg/) - good for a great headset.
- [Lanieri](https://www.lanieri.com) - makes a good suit.
- [partsoven](https://www.partsoven.com/) - for that 3rd dimension of building.
- [AdaFruit](https://www.adafruit.com/bitcoin/) - hardware dodads via bitpay 

### Merchants near you or where you're headed
- [member map](https://memberapp.github.io/#map) - permanent on-chain geographic tags utilizing extensions to the memo protocol.
- [Bitcoin.com map](https://map.bitcoin.com/) - website and mobile app for discovering merchants, formerly marco coino.
- [Greenpages map](https://greenpages.cash/pages/map.php) - merchant finder with advanced filtering.

### Listing directories across the broader internet
- [The Accept Bitcoin Cash Initiative](https://acceptbitcoin.cash) - list of merchants and stores.
- [Bitpay Directory](https://bitpay.com/directory) - partial and outdated list of websites using bitpay as a payment processor.
- [Openbazaar Listings](https://openbazaar.com) - web preview for distributed multicoin marketplace with integrated wallet.
- [Purse.io](https://purse.io/) - service to privately purchase goods on Amazon.com (US) at a discount.

## Charities and Foundations
- [Save the Children](https://files.savethechildren.org/cryptocurrency-donation/)
- [Electronic Freedom Foundation](https://supporters.eff.org/donate/join-4)
- [Tails](https://tails.boum.org/donate/index.en.html)