web3j-scala
is an idiomatic Scala wrapper around Web3J for Ethereum.
Web3J is a lightweight, reactive, somewhat type safe Java and Android library for integrating with nodes on Ethereum blockchains.
Web3J features RxJava extensions, and web3j-scala
wraps that syntax in Scala goodness.
For example, the web3j-scala
observable methods
provide simple and efficient application code.
Scala's value classes are used to provide much stronger type safety than Web3J, without incurring a runtime penalty.
Add this to your SBT project's build.sbt
:
resolvers += "micronautics/scala on bintray" at "http://dl.bintray.com/micronautics/scala"
libraryDependencies += "com.micronautics" %% "web3j-scala" % "0.3.2" withSources()
Only Scala 2.12 with JDK 8 is supported at present; this is a limitation of the Scala ecosystem as of November 7, 2017.
The demo program performs the following:
- Follows the outline of the Web3J Getting Started documentation, adapted for Web3J-Scala, including synchronous and asynchronous versions of the available methods.
- Compiles an example Solidity program that defines a smart contract.
- Creates a JVM wrapper from an example smart contract.
To run the demo:
- Start up an Ethereum client if you don’t already have one running, such as
geth
. Thebin/runGeth
script invokesgeth
with the following options, which are convenient for development but not secure enough for production:- The Ethereum data directory is set to
~/.ethereum
, or a subdirectory that depends on the network chosen; the directory will be created if required. - HTTP-RPC server at
localhost:8545
is enabled, and all APIs are allowed. - Ethereum's experimental Whisper message facility is enabled.
- Inter-process communication will be via a virtual file called
geth.ipc
, located at~/.ethereum
or a subdirectory. - WS-RPC server at
localhost:8546
is enabled, and all APIs are allowed. - Info verbosity is specified.
- A log file for the
geth
output will be written, or overwritten, inlogs/geth.log
; thelog/
directory will be created if it does not already exist.
You will see the message$ mkdir logs/ $ geth \ #--datadir .ethereum/devnet --dev \ # boots quickly but has no deployed contracts from others --datadir .ethereum/rinkeby --rinkeby \ # takes about 15 minutes to boot, but has contracts --ipcpath geth.ipc \ --metrics \ --rpc \ --rpcapi eth,net,web3,clique,debug,eth,miner,personal,rpc,ssh,txpool \ --shh \ --ws \ --wsapi eth,net,web3,clique,debug,eth,miner,personal,rpc,ssh,txpool \ --verbosity 2
No etherbase set and no accounts found as default
. Etherbase is the index intopersonal.listAccounts
which determines the account to send Ether too. You can specify this value with the option--etherbase 0
. - The Ethereum data directory is set to
- The shell that you just used will continuously scroll output so long as
geth
continues to run, so type the following into another shell:The demo has two major components:$ bin/demo
- Creates a JVM wrapper for the sample smart contract.
- The second portion of the demo consists of the following:
- Examples of using
web3j-scala
's synchrounous and asynchronous APIs - Examples of working with RxJava's Observables from Scala
- Examples of working with JVM wrappers around Ethereum smart contracts.
- Examples of using transactions with Ethereum wallet files and the Ethereum client.
- Examples of using
- The
bin/web3j
script runs the Web3J command-line console. The script builds a fat jar the first time it is run, so the command runs quickly on subsequent invocations. - More scripts are provided in the
bin/
directory, including:- bin/attachHttp - Attach to a running geth instance via HTTP and open a JavaScript console
- bin/attachIpc -
Attach to a running geth instance via IPC and open a JavaScript console.
This script might need to be edited if a network other than
devnet
is used. - bin/getApis -
Reports the available APIs exposed by this
geth
instance. - bin/isGethListening -
Verifies that
geth
is listening on HTTP port 8545
-
This library's Scaladoc is here and the gitter channel is here.
-
The Web3J JavaDoc is here, and here is the Web3J gitter channel.
- Update the version string in
build.sbt
and in thisREADME.md
before attempting to publish to Bintray. - Commit changes with a descriptive comment:
$ git add -a && git commit -m "Comment here"
- Publish a new version of this library, including committing changes and updating the Scaladoc with this command:
$ sbt publishAndTag
-
Use the Scaladoc project; first do a preflight check of the Scaladoc output:
sbt "; project web3j-scala; doc; project demo; doc"
-
Now edit the multi-scaladoc settings
export SCALADOC_SUB_PROJECT_NAMES="web3j-scala,demo"
-
Run multi-scaladoc:
../scaladoc/bin/run
This task rebuilds the docs, commits the git repository, and publishes the updated Scaladoc without publishing a new version:
$ sbt commitAndDoc
This project is sponsored by Micronautics Research Corporation, the company that delivers online Scala training via ScalaCourses.com. You can learn Scala by taking the Introduction to Scala, and Intermediate Scala courses.
Micronautics Research also offers Ethereum and Scala consulting. Please contact us to discuss your organization’s needs.
This software is published under the Apache 2.0 License.