Stand alone desktop app for Win/Osx/Linux that allows connecting to a local or remote Corda node. Examine transactions, run flows and view node and network properties in a few simple clicks.
If you're looking to download the node explorer and get started using it; download the latest packaged release on this repo's releases page.
There are install packages for Linux, OSX and Windows.
To login to your Corda node, you will need to provide the:
- Hostname (domain, IP, or localhost)
- Rpc Port
- Username
- Password
Notes: You can find the Rpc port in your node config under rpcSettings->address or as displayed in a CraSH shell instance. If you have not explicitly set a username/password project defaults are user1 and test.
Full instructions for using the Node-Explorer application at the documentation
Note: This repository uses sub-modules. If cloning use git clone --recursive to automatically initialize and update the submodules.
Requirements: NodeJS and Npm package manager.
git clone --recursive <this repo> <optional: target dir>cd node-explorer (or target directory)npm install
Note this project uses the node-server submodule available at https://github.com/corda/node-server this must be initialised either by passing the --recursive option when running git clone OR executing the following commands.
git submodule initgit submodule update*
*this command must also be run after any pull request which includes updates to the submodule. An alternative is to do pull requests with the following option:
git pull --recurse-submodules
Other submodule commands:
-
Fetch and merge the latest node-server submodule code
git submodule update --remote
-
Doing work on the submodule i.e. changing files in ./server
- submodules default to a detached head, so change to server directory and checkout a branch
cd ./servergit checkout master- Add or commit your changes as usual.
-
To PULL submodule updates from server side, if there are changes on your local branch either merge or rebase with the pull
- From MAIN project directory
git submodule update --remote --mergeORgit submodule update --remote --rebase
-
To PUSH submodule updates to server side
- From MAIN project directory
git push --recurse-submodules=on-demand
To test your changes or run the node explorer without packaging you must:
1 Build and run the server jar first
cd server./gradlew assemblejava -jar ./server/build/libs/explorer-server-<version>.jar .
2 Then run the front end from the main project directory
npm start
3 The application can then be used through your browser at http://localhost:3000
Note: You must have a compiled server jar in the directory root
cd ./server && ./gradlew bootJar, move compiled jar in./server/build/libsto the root.
Then run: npm run electron-pack
You can build docker images using the provided DockerFile(s). You will need to build two images, one for the Node Explorer front end ./DockerFile and another for the backend Node Server ./server/DockerFile (the Node Server DockerFile utilizes layers so you will need to extract the jar - see A Better Dockerfile)
If you DO NOT want to build your own images you can simply run Node Explorer using the docker-compose.yml and with contributed images. Follow the steps below:
#####1. Set cordapps path
export CORDAPPS_PATH=Your cordapps path here
example
export CORDAPPS_PATH=/home/karthik/github/samples-java/Basic/yo-cordapp/build/nodes/PartyA/cordapps
#####2. Run docker-compose file
docker-compose up -d
#####3. Browse to Node explorer UI
explorer runs at port 3000
http://localhost:3000/
#####4. Set cordapps directory in settings
Provide cordapps path as /cordapps in settings tab.
/cordapps
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent