Skip to content
Various shell scripts, mainly to be used together with Bitcoin Core (bitcoind or bitcoin-qt) wallet. Fake coinjoin, ricochet.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests
README.md
estimatesmartfee.sh
fake-coinjoin.sh
inc.common.sh
randbtc.sh
ricochet-send-from.sh
ricochet-send.sh
timetoblocks.sh

README.md

bitcoin-scripts

Various shell scripts, mainly to be used together with Bitcoin Core (bitcoind or bitcoin-qt) wallet.

Dependencies: bash, bitcoin-cli (v0.15 or newer), awk, bc, jq, sed.

Scripts use Bitcoin JSON-RPC API, so it must be enabled in bitcoin.conf (server=1, rpcuser= and rpcpassword= settings).

Running each script without arguments will display usage. Most of the scripts will pass any options starting with dashes at the beginning of argument list directly to bitcoin-cli (like -testnet or -rpcuser).

None of scripts do wallet unlocking by itself, so you must call bitcoin-cli walletpassphrase before and bitcoin-cli walletlock afterwards manually when using scripts that sends out transactions (fake-coinjoin.sh, ricochet-send.sh), if your wallet is locked (it should be on mainnet).

Script Description
estimatesmartfee.sh Calls bitcoin-cli estimatesmartfee.
fake-coinjoin.sh Creates transaction that looks like a CoinJoin transaction but all the inputs come and change outputs actually go to your own wallet. Could be useful if you want to send identical amount of funds to more than one recipient.
randbtc.sh Outputs random BTC amount in between two amounts provided as arguments. Round number amounts can decrease your privacy.
ricochet-send.sh Implements Ricochet Send, which adds extra hops between the input(s) from your wallet and destination.
ricochet-send-from.sh Alternative implementation of Ricochet Send where instead of specifying amount to send you specify source address and all coins from that address is sent.
timetoblocks.sh Converts human readable time interval string to expected number of Bitcoin blocks.

Examples

Send random amount between 0.001 and 0.002 BTC donations using fake coinjoin. Will require enough P2PKH inputs with 5 or more confirmations in a wallet. Transaction will have two or more inputs from your wallet and two additional change outputs going back to your wallet (in addition to recipients).

$ ./fake-coinjoin.sh $(./randbtc.sh 0.001 0.002) 1andreas3batLhQa2FawWjeyjCqyBzypd 3N6qaU3bnF43u4YTFKQf8usd3UqvyShovS

Send 0.001 BTC donation using ricochet send with 5 hops and 24 hour confirmation target.

$ ./ricochet-send.sh 0.001 1andreas3batLhQa2FawWjeyjCqyBzypd 5 $(./estimatesmartfee.sh $(./timetoblocks.sh "24 hours"))

Support

tippin.me

If you find these scripts useful, you can support development by sending some Bitcoin to 39jtjVwpWwEypqCt7be5byswPGnfWK6yfN. Or use tippin.me link above for tips via Lightning Network.

You can’t perform that action at this time.