CATV User Guide
Welcome to the Crypto Analysis Tracking Visualization (CATV) Tool User Guide. This tool helps to enable users to visualize the cryptocurrency transactions linked to the input wallet address by creating a graph. The results can be further customized based on the users’ specified requirements.
This goal of this user guide is to cover how to use the CATV tool effectively and elaborate on how users can further interact with their returned results, in order to yield more meaningful and customizable data.
Starting with the CATV: The input fields
The CATV tool requires users to input data into multiple fields before you could start tracking the transactions linked to a wallet address. What you should enter in these fields will be elaborated below.
Wallet Address: The wallet address of a valid Ethereum wallet. As of now, the CATV only supports Ethereum wallet addresses.
Distribution Depth: This specifies how far would you like to trace the funds sent out by the wallet address. For example, a distribution depth of three will cause the graph to display the outgoing transactions, starting with the input wallet address, up to three hops away.
Source Depth: The source depth is nearly identical to the distribution depth, except that it is for incoming transactions instead of outgoing ones.
For example, if you are to search the input address “0x9b14dd” with a distribution and source depth of one, you would get the graph as seen above.
However, if you are to tweak the distribution and source depth to two, you would see this graph instead.
Transaction Limit: This specifies the maximum number of transactions in a wallet could have before the tracing is halted. For example, let’s say you set the transaction limit to 100 and the distribution depth to 4 before tracing. If one of the paths is to lead to a wallet with 400 transactions one hop away from your input wallet address, the graph will not show the addresses nor the paths beyond it.
Date Range: This filters the transactions only in the first hop for both distribution and source . Hence, the initial outgoing and incoming hops will only display transactions made during the specified time period in the graph.
Force Lookup: This checkbox forces the tool to not return any cached results. Instead, it makes an API call and pulls the most updated results in exchange for longer load times for them to be displayed.
Starting with the CATV: Additional tips
In order to obtain the ideal results, these tips are advisable before you click the “Start Tracking” button:
- Please try to keep your depths to 5 and below if possible, for better speed and a graph output that is readable.
- If you are unsure about what to do with the transaction limit, you can leave it at 2000.
- For wallet addresses that are highly active, use the Date Range filter to narrow the search down to only the day(s) of interest.
- If you are experiencing slow loading time, you can consider doing source and depth search separately by setting either to zero. This might be caused by the type of wallet. For example, splitter wallets would have a few incoming transactions and many outgoing transactions.
Once you’re done with setting the fields to your desired values and ready to start tracking, simply click on the ‘Start Tracking’ button to have the tool begin generating the graph.
The graph: Colour codes
Once the graph is generated, you may notice that some of the wallets shown in your graph appear to be colour-coded. The legend to the colour-coding will be explained below.
Interacting with the graph
There are two ways to interact with graph - either directly by clicking on the nodes, or indirectly by using the buttons on the top right corner of the graph.
You can interact with the graph by clicking on the nodes and the lines in between the nodes, which are termed ‘edges ’. By clicking on them, you would be able to see information relevant to the node or edge which you have clicked.
If you click on an edge, the Tx Hashes, sending and receiving wallet addresses, Tx Time and amount of ETH involved pertaining to the transaction will be shown.
Clicking on a node will display the category of the said node, the wallet address, their type and annotation in our Threat Reputation Database.
You can further customize the graph by clicking and dragging the nodes to move them around.
Additionally, you can expand and collapse nodes by double-clicking on them, allowing you to hide and show edges and nodes related to any particular node as you wish. Please do take note that this is still limited by the source and distribution depth you have set earlier.
You can move the nodes around in any direction as you want to.
Zooming in and out is also possible with the mouse wheel.
There is a set of dropdown lists, a field textbox and buttons at the top right of the graph. These also allow you to interact with the data displayed by the graph, albeit indirectly.
Dropdown lists: The first one belongs to the source depth , hence the negative numbers, while the second one refers to the distribution depth . These dropdown lists enable you to modify both depths and thus edit the data shown to your liking without having to make the CATV tool run again.
However, like the double-clicking of nodes, the options shown in these dropdown lists are capped at the depths you have initially specified before you started tracing.
The field and ‘Hide HVN’ button: HVN is an abbreviation of “High Volume Node”. The field on the left of the said button allows users to define the threshold of ‘high volume’. The default value is eight. Hence, when the ‘Hide HVN’ button is clicked, any node with more than eight outgoing or incoming transactions will have its edges and corresponding nodes hidden. As mentioned earlier, users are able to define ‘high volume’ as they wish, which they can do so by altering the value in the field on the left of the ‘Hide HVN’ button.
Fit Graph: Fits the graph back to the centre of the frame. This is ideally used after users zoom in or out too much or moved around the graph.
Save Img: Allows users to save an image of the graph in JPEG form on their own device.
Search Result: Transaction List
Upon the creation of the graph, all of the transactions used in the graph will be compiled into a list as well. This list can be found below the graph.
The transaction list also shows the Tx Hash, sending and receiving wallet addresses, annotation of sender and receiver wallets, the volume of Ethereum in the transaction and the date and time when the transaction had taken place as well.
This list also allows for a small degree of customization. Users are able to sort the transaction list by clicking on the column headers.
The transaction list after sorting by ‘Sender Annotation’.
Exporting the Transaction List
At the top right of the Transactions List, there are two buttons: “Export Dist CSV” and “Export Source CSV”. These two buttons allow users to download the distribution and source transactions respectively in a CSV file, which can be opened using Microsoft Excel.
This is the end of the CATV Tool user guide. If your questions are still unanswered, please feel free to ask us in this forum thread. Thank you!