Debugging a CorDapp

There are several ways to debug your CorDapp.

Using a MockNetwork

You can attach the IntelliJ IDEA debugger to a MockNetwork to debug your CorDapp:

  • Define your flow tests as per API: Testing .

    • In your MockNetwork, ensure that threadPerNode is set to false.
  • Set your breakpoints.

  • Run the flow tests using the debugger. When the tests hit a breakpoint, execution will pause.

Using the node driver

You can also attach the IntelliJ IDEA debugger to nodes running via the node driver to debug your CorDapp.

With the nodes in-process

  • Define a network using the node driver as described in Conducting integration Testing .

  • In your DriverParameters, ensure that startNodesInProcess is set to true.

  • Run the driver using the debugger.

  • Set your breakpoints.

  • Interact with your nodes. When execution hits a breakpoint, execution will pause.

With remote debugging

  • Define a network using the node driver as described in Conducting integration Testing .

  • In your DriverParameters, ensure that startNodesInProcess is set to false and isDebug is set to true.

  • Run the driver. The remote debug ports for each node will be automatically generated and printed to the terminal.

    For example:

[INFO ] 11:39:55,471 [driver-pool-thread-0] (DriverDSLImpl.kt:814) internal.DriverDSLImpl.startOutOfProcessNode -
    Starting out-of-process Node PartyA, debug port is 5008, jolokia monitoring port is not enabled {}
  • Attach the debugger to the node of interest on its debug port:

    • In IntelliJ IDEA, create a new run/debug configuration of type Remote.
    • Set the run/debug configuration’s Port to the debug port.
    • Start the run/debug configuration in debug mode.
  • Set your breakpoints.

  • Interact with your node. When execution hits a breakpoint, execution will pause.

By enabling remote debugging on a node

See Enabling remote debugging .

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.