Here you have the steps to compile and run an RSK node on Windows.
This page is organized in this way:
After opening IDEA, we need to load the RSKj project, this can be done by using the Import project option in IDEA.
To do that follow the next steps:
rskj\build.gradle
and select it.We need to create a new configuration profile to run the node from IDEA. That can be done by clicking on Run -> Edit Configurations or as shown in the following picture:
Then set the options as shown below:
co.rsk.Start
/path/to/code/rskJ
rskj-core_main
Default (1.8 - SDK of 'rsk-core_main' module)
Note:
rskj/rskj-core/build.gradle
and sync it from Gradle
tab.We are ready to run the node using IDEA, just press the Start button at the right of the configuration we’ve just created.
If everything is OK, you should see the debug information like that:
And yes! Congratulations! Now you’re running a local RSK node :)
You’re joined to Mainnet by default.
If you want to switch the network, add:
--testnet
--regtest
Inside the field Program Arguments
in your run configuration.
In order to setup JDK configuration, we use .vscode/settings.json
. Here we can setup the latest JDK for Extension Pack for Java, then use the recommended version for RSKj, for instance:
.vscode/settings.json
{
"java.jdt.ls.java.home": "C:\\jdk-17",
"java.configuration.runtimes": [
{
"name": "JavaSE-1.8",
"path": "C:\\jdk-1.8",
"default": true
},
{
"name": "JavaSE-17",
"path": "C:\\jdk-17",
},
]
}
In this example, we have setup Java 17
for Extension Pack for Java to work as expected and the default java compiler is Java 1.8
. These paths should point to your java home.
Be aware that the path may vary depending on how you installed it.
In order to build, run or debug RSKj, we use .vscode/launch.json
. Here we can setup the commands that will be used to run our application, for instance:
.vscode/launch.json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Run RSK Start",
"request": "launch",
"mainClass": "co.rsk.Start",
"args" : "--testnet -Xkeyvalue.datasource=leveldb"
}
]
}
In this example we are going to run the application with the following arguments: --testnet -Xkeyvalue.datasource=leveldb
.
We are ready to run the node using Visual Studio Code, select your configuration from launch.json
within Run and Debug
.
Click on start (green play icon at the left of your configuration name)
.
A debug tools menu shows up at the top of the IDE window, were you could run the node step by step!
In order to build the project using Gradle
, we can simply go to the respective tab. On tab, we should be able to see all available Gradle
configurations from the application. Select the project to be built and double-click the desired Gradle Task
.
In order to run tests, we can simply go to the Testing
tab where you can see all the tests. We can also go directly to the test file and right-click the icon at the left of a declaration of a test and then decide to either run or debug the test.
Check out the troubleshooting section, hope it helps!
Go to top