This is a description of how to get started with Signet. This document assumes you are capable of using git, and that you are able to compile Bitcoin. (If you have not yet done so, you should begin by doing that now.)
Fetch and compile signet
$ git clone https://github.com/kallewoof/bitcoin.git signet $ cd signet $ git checkout signet-0.18 $ ./autogen.sh $ ./configure $ make -j5
Create bitcoin.conf file and start up the daemon
cd src mkdir signet echo "signet=1 daemon=1" > signet/bitcoin.conf ./bitcoind -datadir=signet
Verify that you're connected
./bitcoin-cli -datadir=signet getconnectioncount ***SHOULD BE MORE THAN ZERO*** ./bitcoin-cli -datadir=signet getblockcount ***SHOULD BE MORE THAN ZERO***
Get some coins
There is a command line tool you can use to get coins directly to your instance of Signet, assuming you are on the default network. You can also use the faucet online with an address of yours.
Using online faucet
You first need an address
./bitcoin-cli -datadir=signet getnewaddress
Then go to a faucet, e.g. https://signet.bc-2.jp and enter your address.
You can also just DM @kallewoof on Twitter or on IRC with "Signet coins plz: PASTEADDRESSHERE" and I'll try to send you some asap. (It's manual tho so may take awhile if I'm not near a computer.)
Using the command line tool
The tool is in
contrib/signet and is called
getcoins.sh. It takes the path to
bitcoin-cli and an optional
--faucet=[url] followed by any number of arguments to
cd ../contrib/signet ./getcoins.sh ../../src/bitcoin-cli -datadir=../../src/signet Payment of 10.00000000 BTC sent with txid c0bfa...
Check that you received the coins
Check your faucet transaction confirming at e.g. https://explorer.bc-2.jp and then send coins around to people and/or use signet for testing your wallet/etc.
You can immediately see the amount using
cd ../../src # if you were in contrib/signet ./bitcoin-cli -datadir=signet getunconfirmedbalance
You can also see info about the transaction that the faucet gave you.
./bitcoin-cli -datadir=signet gettransaction THETXID
Once it has confirmed, you should see it in
./bitcoin-cli -datadir=signet getbalance