Home

Guide to using ethgraph and Gephi

Tutorial

The following tutorial takes you step by step through running ethgraph and using the resulting graphml in Gephi, a free, open-source and cross-platform graph analysis tool.

Preparation

1. Install Gephi
2. Install ethgraph.
3. If you don't already have Infura access, get yourself setup with Ethereum mainnet access there, it is free.
4. Execute ethgraph for a single Ethereum mainnet block like this:

$ ./ethgraph byblock  "https://mainnet.infura.io/v3/<your Infura API key>"  -f 16_740_360 -t 16_740_360

The output of the above is a graphml file called ethereum.graphml. You can follow along these tutorial sections using that file.

Layout a Graph

Initially, when a graphml file is first opened, the nodes are randomly positioned. We apply a layout to tidy them up.

Resize and Recolor Nodes

Initially, all nodes are the default color and size. We can apply rules to size and color nodes according to what they represent.

Add Labels

Initially, all nodes have no text appearing on screen. We can add labels to provide information.

Copy Address from a Node

Gephi allows us to manually move nodes around, and also to edit nodes so we can see the full transaction hash and address details, and copy them to the clipboard.

Use Data Laboratory

Gephi offers a Data Laboratory to view, select, edit and search for movements, addresses and transactions.

Add Timeline

Gephi offers animated views of graphs according to a time dimension. Here you learn how to add that feature to your graph analysis.