To get started building on Quai Network, visit and follow the README instructions.

Debugging Information

Debugging go-quai is useful when there are specific events occurring within the codebase that need to be checked.

Steps to start debugging

  • Open VSCode and navigate to the debug panel on the left-hand side.
  • Click on the highlighted text to create launch.json file.
  • Copy and paste the below launch.json to run a Zone node.

Example launch.json

"version": "0.2.0",
"configurations": [
"name": "Launch Prime",
"type": "go",
"request": "launch",
"mode": "exec",
"program": "${workspaceRoot}/build/bin/quai",
"env": {},
"args": [
"showLog": true,
  • Run make debug within the go-quai folder to create an executable that contains the proper compiler flags -gcflags=all="-N -l"
  • Navigate back to the VSCode debug panel which should look similar to this.
  • Click on the green arrow in the top left of the debug panel to launch the build executable and start your debugging session. You can set breakpoints and specify variables throughout the codebase.
For more information on debugging via VSCode visit the VSCode documentation.