Bitsquare depends on specific versions of BitcoinJ and TomP2P that have not previously been published to any maven repository--until now. Based on the 'published' branch of the bitcoinj [1] and tomp2p [2] forks under the bitsquare organization, snapshots have been published to a temporary repository [3] that has been made available to us by JFrog. To be as explicit as possible, these custom-published snapshots have had their version numbers qualified with the short hash of the commit they were built from. So for bitcoinj, the dependency is no longer 0.12-SNAPSHOT, but 0.12.308de4e-SNAPSHOT. For TomP2P, the version has gone from 5.0-Alpha24-SNAPSHOT to 5.0-Alpha24.805623c-SNAPSHOT. Accordingly, these qualified versions are now reflected in the dependency declarations in build.gradle. This means that it is no longer necessary to build bitcoinj and tomp2p locally in order to get up and running with Bitsquare development, and the README has been updated accordingly. And it also means we can now set up a Travis CI build with ease (which shall be done with #86). Resolves #97 [1]: https://github.com/bitsquare/bitcoinj/tree/published [2]: https://github.com/bitsquare/tomp2p/tree/published [3]: http://partnerdemo.artifactoryonline.com/partnerdemo/libs-snapshots-local/ |
||
---|---|---|
.idea | ||
doc | ||
gradle/wrapper | ||
src | ||
.gitignore | ||
build.gradle | ||
gradlew | ||
gradlew.bat | ||
LICENSE | ||
README.md |
About
Bitsquare is a P2P Fiat-BTC Exchange.
It allows to trade fiat money (USD, EURO, ...) for Bitcoins without relying on a centralized exchange like Coinbase or BitStamp.
Instead, all participants form a peer to peer market.
Dependencies
Development setup
git clone https://github.com/bitsquare/bitsquare.git
./gradlew build
Regtest mode for local testing
For local testing it is best to use the regtest mode from the Bitcoin QT client.
You need to edit (or first create inside the bitcoin data directory) the bitcoin.config file and set regtest=1.
Here are the typical locations for the data directory:
Windows:
%APPDATA%\Bitcoin\
(XP) C:\Documents and Settings\username\Application Data\Bitcoin\bitcoin.conf
(Vista, 7) C:\Users\username\AppData\Roaming\Bitcoin\bitcoin.conf
Linux:
$HOME/.bitcoin/
/home/username/.bitcoin/bitcoin.conf
Mac OSX:
$HOME/Library/Application Support/Bitcoin/
/Users/username/Library/Application Support/Bitcoin/bitcoin.conf
Take care if you have real bitcoins in your Bitcoin QT wallet (backup and copy first your data directory)!
More information about bitcoin.conf can be found here.
You can generate coins on demand with the Bitcoin QT client with the following command in the console (under the help menu you find the console window):
setgenerate true 101
101 is used only for the first start because of the coin maturity of 100 blocks. Later for mining of a single block you can use 1 as number of blocks to be created.
More information about the regtest mode can be found here or here.
The network mode is defined in the guice module (BitSquareModule) and is default set to regtest.
Testnet should also work, but was not tested for a while as for developing regtest is much more convenient.
Please don't use main net with real money, as the software is under heavy development and you can easily lose your funds!