a client to btcwallet, written in Scala and built on akka
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



bitcoin-akka demonstrates the processing of bitcoin transactions using the Actor model. It is written in Scala, and is based on the akka library, btcd, and btcwallet.

Usually, it's inconvenient to use websocket or json APIs directly. bitcoin-akka is an abstraction to btcwallet's websocket API. You can talk to bitcoin-akka using Actor messages and receive Futures in return. Those messages are then forwarded to btcwallet using its websocket API. When a response is available the Future is completed.

The project contains an example in which transactions are processed by sending the bitcoins back to the sender address. The outputs of the incoming transactions are used as inputs for the corresponding outgoing transactions. Therefore, there is no need to wait for confirmations.


  • Install btcd, btcwallet, and btcgui.
  • Configure btcd and btcwallet to use testnet and enable rpc support.
  • Initialize a wallet and set the wallet passphrase using btcgui.
  • Clone the Java-WebSocket repository: git clone https://github.com/TooTallNate/Java-WebSocket.git. Install the development snapshot to your local maven repository: mvn install.
  • Clone this repository: git clone https://github.com/goldmar/bitcoin-akka.git.
  • Configure your passwords in src/main/resources/application.conf.
  • Import your btcwallet certificate to keystore.jks: keytool -keystore keystore.jks -import -file ~/.btcwallet/rpc.cert -alias btcwallet.cert.
  • Run the project: sbt run.
  • Send some testnet coins to one of your addresses, and watch how they are automatically returned to the sender address.


This project is licensed under the terms of the Apache License, Version 2.0.