Creating your first reputation graph

This is a getting started guide that lets you create a set of rankings (trust graph) for a sample dataset provided

NOTE: OpenRank protocol is currently in private testnet phase. In order to be allowlisted, please contact Karma3 Labs team for more details at [email protected].

Initialize the workspace

`openrank` provides a special command that can help you get started with setting up your workspace:

openrank init ./my-workspace

This will initialize your first workspace folder that has the following structure:

/my-workspace
    /trust
        degen.csv
        jamfrens.csv
        openrank.csv
        small.csv
    /seed
        degen.csv
        jamfrens.csv
        openrank.csv
        small.csv
    .env

As you can see, the workspace consists of 2 folders and the .env file.

The file names in the /trust and /seed folder have to be identical in order for `openrank` to pair them and request compute for them.

The format of local trust files is in i,j,v . This can be inspected by:

head -n 5 trust/degen.csv

Which should show this output:

i,j,v
481656,419388,30
2211,253127,50
469501,355836,10
16565,461286,110

These rows represent a local trust values between two peers, specifically FID to FID (Farcaster ID). These scores are derived by Karma3 Labs team specifically for demo purposes.

The format for seed trust files is in i,v . This can be inspected by:

head -n 5 seed/degen.csv

Whic should show this output:

i,v
15357,0.7950587070543446
277952,0.199664017398543
309242,0.003994120331468955
248216,0.00027744247206043824

These rows represent a seed trust values for a given peer i . These scores are derived from well known reputable users in Farcaster ecosystem.

Setting up the mnemonic phrase

Before requesting compute jobs, we need to set up our mnemonic phrase, from which the `openrank` will create a wallet in order to make TXs. Edit the following variable in .env:

MNEMONIC="add your mnemonic here"

NOTE: Before requesting compute jobs, make sure you address corresponding with this mnemonic is allowlisted, by contacting Karma3 Labs team ([email protected]).

Requesting compute jobs

To request a compute job, simply run:

openrank compute-request ./trust ./seed

And your request will be submitted into OpenRankManager smart contract ready to be processed by the compute nodes. After the request is successfully submitted, you will se a compute id logged into the console.

You can also get the compute metadata using the following command:

openrank compute-watch [compute-id]

This command will return compute request and compute results TX hash on L1 Sepolia testnet.

For downloading and verifying computed scores:

Download Rankings with OpenRank SDK