A command line utility to send split BTC from your BCC
Switch branches/tags
Nothing to show
Clone or download
Latest commit 4a8030e Aug 14, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
BCCSpliter Fix scanning bug Aug 10, 2017
NBitcoin @ f4f9249 Can split coins Jul 30, 2017
.gitignore Initial commit Jul 29, 2017
.gitmodules Can split coins Jul 30, 2017
BCCSpliter.sln Can split coins Jul 30, 2017
LICENSE Initial commit Jul 29, 2017
README.md Update README.md Aug 14, 2017

README.md

BCCSpliter

A command line utility for splitting your BTC from your BCC.

Motivation

The 1st august 2017, a minority of the community is creating an altcoin named BCC (Bitcoin Cash) whose initial distribution is holding of BTC at the time of the hard fork.

This tool allows you to connect to your Bitcoin Core wallet, select coins you want to split, create a transaction only valid on BCC and broadcast it.

BCC includes an opt-in replay protection: a new flag for signature SIGHASH_FORKID has been created in BCC. The signature scheme for this SIGHASH, is similar to segwit signature scheme.

This mean that a valid SIGHASH_FORKID signature on BCC will not be valid on BTC chain. Making it easy to split your UTXO.

Privacy disclaimer

If you are dumping coins from your bitcoin core, no external resources than your node is used. For other use case (dumpprivkey and dumphd), a block explorer is used and leak your addresses. (QBitNinja)

Requirements

As a user, you will need:

  1. NET Core SDK 1.0.4 (see below)
  2. At least Bitcoin Core 0.13.1 fully sync, rpc enabled.

First add the repository for the SDK by following these instructions

Afterwards you can install the runtime by running

sudo apt-get install dotnet-dev-1.0.4

You can known more about install on your system on this link. Using Bitcoin Core with later version should work as well.

As a developer, you need additionally one of those:

  1. Visual studio 2017 (Windows only)
  2. Visual studio code with C# Extension (Cross plateform)

How to build?

sudo apt-get install git

Given the requirements are installed in your system and BitcoinD is running:

Setup your repository:

git clone https://github.com/NicolasDorier/BCCSpliter
cd BCCSpliter
git submodule init
git submodule update
dotnet restore

How to run?

For running, from inside the repository folder:

cd BCCSpliter
dotnet run

Be sure you are in the project folder inside the repository (BCCSpliter/BCCSpliter) when running dotnet run.

If you want to run on other network (regtest or testnet):

dotnet run -testnet
dotnet run -regtest

How to dump

From my Bitcoin Core Wallet?

The process is the following:

  1. Select the UTXOs your want to spend.
  2. Use the command dump <BitcoinAddress on BCC> (This will create and broadcast a valid on BCC only, and lock the UTXOs you used in Bitcoin Core wallet)

Typical flow:

list
# Find interesting UTXO you want to dump
select 72c5ddde9377d5332cd4a29412326272c2678c4020520508328bba7a351d7263-0
select 489dc8f0925a99fe772f0d5cd5f05cda77bf29449ec3ee266575add6312d6e04-2
# Check the status what the next dump will be
list
# Then dump
dump mpxsXnCn1ScUVZmgEDgkjMZMV3NAAVzSdN

The selected UTXO are now safe to be spent on BTC chain.

From my paper wallet key?

Use dumprivkey BASE58PRIVKEY DESTINATION

Example:

dumpprivkey cRkaHCt5FuD7x4SR5hAP5yWA5JnfhAYrVREfgUG2YdQ9bSnBjdgb miUraop8F4R4kVDczUfucF3itB4t6wtB5q 

A BlockExplorer (QBitNinja) is used for scanning your funds.

From my HD key?

Use dumphd HDKEY DESTINATION

Example:

dumphd xpriv..... miUraop8F4R4kVDczUfucF3itB4t6wtB5q 

A BlockExplorer (QBitNinja) is used for scanning your funds.

If it does not find your coin, please open an issue. There is several way of deriving addresses from HD, and I lazily support them.

Supported derivation scheme are:

  • BIP45/P2SH/1-1 (old copay)
  • BIP44 Account 0 (you can change the account to dump by changing this line)
  • Direct (Breadwallet)
  • Bitcoin Core

Let me know if your wallet derivation strategy is not supported. (In which case you would see 0 coins to dump, contrary to what you expect)

Note for copay

Note that some copay wallet may have this bug, in which case, even if your wallet is using a supported derivation scheme, this tool will not find your coins.

If your wallet is using BIP44 (m/44'/0'/account'/change/i), then get the HD private key of path (m/44'/0'/account') by using the tools described in these instructions, and use that instead with the dumphd command.

How to configure?

If you are not using standard install for bitcoind, you will have to change the configuration file: In Windows it is located on

C:\Users\<user>\AppData\Roaming\BCCSpliter\<network>\spliter.config

On linux or mac:

~/.bccspliter/<network>/spliter.config

The configuration file allows to configure the connection to your Bitcoin RPC, and to choose a specific Bitcoin Cash node for broadcasting your transaciton. By default, the configuration file is using cookie authentication in default bitcoin core path, and connect to a random Bitcoin Cash node. So if you run bitcoin core with default settings, things will just work.

The default config file is shows you all options, if you need to change, remove the sharp sign (#) and customize your settings:

####Common Commands####
#Connection to the bitcoin core wallet. BCCspliter will try to autoconfig based on default settings of Bitcoin Core.
#rpc.url=http://localhost:8332/
#rpc.user=bitcoinuser
#rpc.password=bitcoinpassword
rpc.cookiefile=D:\Bitcoin\.cookie

My transaction does not pass

Please, wait for the split to happen before using this tool on Mainnet.

If that is the case, the problem is that your Bitcoin Core has no idea which coin can be splitted, and it is possible you splitted an UTXO which does not exist on the BCC chain.

If that is the case, then your transaction will be rejected, and your machine banned by BCC nodes.

There is sadly no block explorer for BCC to check which UTXO can be splitted at this time, so this is a trial and error process.

License

This program is under MIT License, use at your own risk.

If you are unsure about what this program is doing, then do not use it. This program is meant for people understanding the situation with BCC and BTC.