# Diagnosing Common Issues

Whilst we endeavour to ship reliable, bug-free software, it is inevitable that some bugs do creep in. When this arises, please notify the team via the **#report-bugs** channel in [Discord](https://discord.io/pact).

To assist the team in diagnosing the issue, please provide as much detail of the issue as possible:

* **Describe the issue and outline the steps that caused the issue.**
  * Please provide any [useful references](#providing-useful-bug-reports) that may be useful. This can include:
    * Capturing [screenshots or screen recordings](#capture-screenshots-or-screen-recordings) of the issue.
    * Screenshots or screen recordings of the browser console for [user interface issues](#diagnosing-user-interface-issues).
    * Transaction ID in AlgoExplorer and wallet addresses for [financial issues](#detailing-transaction-related-issues).
  * Please provide what your [expected behaviour](#detailing-expected-behaviour) is.
* **Can the issue be reproduced easily?**&#x20;
  * If so, outline the key steps.&#x20;
  * If not, the issue is likely to be intermittent or difficult to reproduce so will need further time to investigate and detail the steps.
* **What platform and/or software version was used?**&#x20;
  * Web browser (e.g. Chrome, Safari, etc)&#x20;
  * Wallet (e.g. Pera Wallet, MyAlgoWallet, etc)&#x20;
  * Desktop, Tablet or Mobile device&#x20;

### Diagnosing User Interface Issues

For issues in relation to the user interface such as blank or unresponsive screen, our recommendation will be to take a screenshot of your [Browser’s Developer Console](https://balsamiq.com/support/faqs/browserconsole/). It takes a bit of effort, but this will greatly assist us in identifying the error.

In Chrome, this can be done using `Shift + Ctrl + J` (Windows) or `Option + ⌘ + J` (Mac OS) or by going to `More Tools > Developer Tools` from the menu.

Please take a screenshot of the Console tab upon the error and notify the team and assist them to identify what the issue is. For example:

![Example Google Chrome Console Screenshot](https://lh4.googleusercontent.com/t3vlH3IE_qju3pTttPudoomOqR1UuJoPAmFb27iAPEUmZwyz2ombIzZ7of9YC2-vpAfZsRWB3zHeVmP-b1dV_HfSn7guJPFkC5JULzIs2ujeDlnnn1Bxr6jwuPoOvxBAu3k-tlla)

### Capture Screenshots or Screen Recordings

We recommend that you also provide screenshots or better yet, screen recordings to help the team better understand the issue. These days, it's *very easy* to do and can  be done using tools such as:

* **Windows:** Use the [Snipping Tool](https://support.microsoft.com/en-us/windows/use-snipping-tool-to-capture-screenshots-00246869-1843-655f-f220-97299b865f6b) to capture screenshots&#x20;
* **Mac:** Take screenshots or screen recordings using [Screenshot or keyboard shortcuts](https://support.apple.com/en-au/guide/mac-help/mh26782/mac)
* **Google Chrome:** Use browser extensions such as [Awesome Screenshot](https://chrome.google.com/webstore/detail/awesome-screenshot-and-sc/nlipoenfbbikpbjkfpfillcgkoblgpmj)

### Detailing Expected Behaviour

It is important bug reports contain the **expected behaviour** to help the team better understand the issue. Given the vast nature of use cases and the complexity of the product, this information is very helpful for the team.&#x20;

For example: if your balance is not showing up correctly, please also elaborate on what you expect your balance to be.

### Diagnosing Financial Issues&#x20;

If the issue is related to potential financial issues such as transactions or balances, please also provide:

* **Transaction ID in AlgoExplorer:** All transactions in the Algorand blockchain are recorded and can be viewed in the [AlgoExplorer](https://algoexplorer.io/) block explorer. The transaction details will help us diagnose the issue.&#x20;
* **Wallet Address:** Please also provide your wallet address where applicable. This will be useful for issues with regards specific to user balances and/or rewards that may not have an executed transaction.&#x20;