To get started with corda, the team have given a number of cordapp examples in here. In this blog, we are running the most common cordapps among them cordapp-example. So let's get started.
- Install the Java 8 JDK. Corda requires at least version 8u171, but do not currently support Java 9 or higher for this version of Corda.
- Install the IntelliJ IDEA Community Edition. Corda supports IntelliJ IDEA versions 2017.x, 2018.x, 2019.x, and 2020.x ; and Kotlin plugin version 1.2.71.
- Install Git in local machine.
- If you’d prefer to install Gradle manually, install Gradle version 5.6.4. Corda requires a Gradle version between 5.1 and 5.6.4, and does not support Gradle 6.x.
Download the cordapp-example folder from the github repo. using terminal get into the folder.
cd samples-java/Basic/cordapp-example
start IntelliJ IDEA and open the cordapp-example folder. Let it download all the files and dependencies needed for building the cordapp. If you see a message saying the build completed successfully, go to the terminal and run
Unix/Mac OSX : ./gradlew deployNodes
Windows : gradlew.bat deployNodes
Check whether all the nodes deployed successfully. For reference, a folder structure of the node folder is given below.
if it's successful and all nodes deployed successfully we can now run those nodes. To run the node we have two methods,
we can do it simply by executing the runnodes as shown below
Unix/Mac OSX : ./build/nodes/runnodes
Windows : .\build\nodes\runnodes.bat
Start a Spring Boot server for each node by opening a terminal/command prompt for each node and entering the following command, replacing X with A, B and C:
Unix/Mac OSX : ./gradlew runPartyXServer
Windows : gradlew.bat runPartyXServer
Without using runnodes we can run the nodes individually, to do that open terminals for each node and follow the below-given steps,
cd build/nodes/{nodename}
java -jar corda.jar
Output will be like this
______ __
/ ____/ _________/ /___ _
/ / __ / ___/ __ / __ `/ Top tip: never say "oops", instead
/ /___ /_/ / / / /_/ / /_/ / always say "Ah, Interesting!"
\____/ /_/ \__,_/\__,_/
--- Corda Open Source corda-4.4 (4157c25) -----------------------------------------------
Logs can be found in : /Users/cordauser/Desktop/cordapp-example/workflows-java/build/nodes/PartyA/logs
Database connection url is : jdbc:h2:tcp://localhost:59472/node
Incoming connection address : localhost:10005
Listening on port : 10005
Loaded CorDapps : corda-finance-corda-4.4, cordapp-example-0.1, corda-core-corda-4.4
Node for "PartyA" started up and registered in 38.59 sec
Welcome to the Corda interactive shell.
Useful commands include 'help' to see what is available, and 'bye' to shut down the node.
Fri Mar 02 17:34:02 GMT 2018>>>
If all done well now we can interact with the cordapps using the server. Try yourself and enjoy.