corda/tools/explorer/README.md

# Node Explorer

The node explorer provides views of the node's vault and transaction data using Corda's RPC framework.
The user can execute cash transaction commands to issue and move cash to other parties on the network or exit cash using the user interface.

## Running the UI

**Windows:**

    gradlew.bat tools:explorer:run

**Other:**

    ./gradlew tools:explorer:run
    

## Running Demo Nodes

A demonstration Corda network topology is configured with 5 nodes playing the following roles:
1. Notary
2. Issuer nodes (representing two fictional central banks - UK Bank Plc issuer of GBP and USA Bank Corp issuer of USD)
3. Participant nodes (representing two users - Alice and Bob)

The Issuer nodes have the ability to issue, move and exit cash amounts.
The Participant nodes are only able to spend cash (eg. move cash).

**Windows:**

    gradlew.bat tools:explorer:runDemoNodes

**Other:**

    ./gradlew tools:explorer:runDemoNodes

**These Corda nodes will be created on the following port on localhost.**

   * Notary -> 20003            (Does not accept logins)
   * Alice -> 20006
   * Bob -> 20009
   * UK Bank Plc -> 20012       (*Issuer node*)
   * USA Bank Corp -> 20015     (*Issuer node*)

Explorer login credentials to the Issuer nodes are defaulted to ``manager`` and ``test``.
Explorer login credentials to the Participants nodes are defaulted to ``user1`` and ``test``.
Please note you are not allowed to login to the notary.

## Business Network reference implementation

It is now possible to see "IOU" panel on the Dashboard.
I Owe YoU (IOU) CorDapp created specifically to demonstrate use of Business Networks reference implementation.

Whenever IOU transaction is entered, membership checks are performed to ensure that participants are included into the same
Business Network.
Upon startup both "Alice" and "Bob" are included into Business Network and therefore can transact with each other. 
"Transactions" GUI been also extended to be able to display details of the IOU transactions.

In order to exclude "Alice" or "Bob" from Business Network file: 
`samples\business-network-demo\build\resources\main\net\corda\sample\businessnetwork\membership\internal\AliceBobMembershipList.csv`
could be modified (no restart necessary) and then IOU transaction will no longer be possible between "Alice" and "Bob".

Please note Business Networks functionality only affects IOU CorDapp, Cash payments CorDapp will allow transactions between
"Alice" and "Bob" at all times.

## TODOs:
- Shows more useful information in the dashboard.
- Improve Network View, display other nodes in the world map and show transactions between them.
- Add a new view showing node's state machines.
- Link transaction input to its originated transaction to make it easier to trace back.
- Shows Node information (Configuration, properties etc.) in Settings view. 
- Support other contract types.


More information can be found in the [Project website](https://corda.net) and [Documentation](https://docs.corda.net).