BlockAuth RAW

BlockAuth - Self Managed Ethereum Identities


The BlockAuth.org protocol provides a super simple way for you to manage your own digital identities.

We provide the following useful wrapper functions through our wallet endpoint:

  • getUserByAddress - returns a registered user object by their address
  • getUserByUsername - returns a registered user object by their username
  • getUserById - returns a registered user object by their id

The chain parameter is optional and used to select a valid network.

The contractAddress options listed below can also be replaced by specific reserved keywords such as blockauth - which will then help to use our internal records to find the most up-to-date contract address associated with that particular keyword.

This allows for more memorable options - &method=getUserByUsername&params=blockauth|msmalley - as an example.

Required options should be set via GET params and piped if using URLs - for example - ?params=option_one|option_two

More information on each of the available methods can be seen below:


getUserByAddress ( contractAddress, userAddress )


Both a valid Ethereum contractAddress and userAddress are required.


An example URL request:

http://bloq.press/api/cortex/v1/blockauth?method=getUserByAddress&key=your-api-key&chain=bce&params=0xc4Acc3EfDaA0Ff0820022418c3DfAf1471494E29|0xf88d2b4319c10197499f3f9b35f6008f0631dac6

Data returned should look similar to this:

"results":
{
    "address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
    "username": "marksmalley",
    "id": "UKPP123",
    "name": "Mark Smalley",
    "url": "http://smalley.my",
    "blocked": false
}

getUserByUsername ( contractAddress, username )


Both a valid Ethereum contractAddress and username are required.


An example URL request:

http://bloq.press/api/cortex/v1/blockauth?method=getUserByUsername&key=your-api-key&chain=bce&params=blockauth|marksmalley

Notice the example above uses the blockauth keyword instead of a contract address...

Data returned should look similar to this:

"results":
{
    "address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
    "username": "marksmalley",
    "id": "UKPP123",
    "name": "Mark Smalley",
    "url": "http://smalley.my",
    "blocked": false
}

getUserById ( contractAddress, id )


Both a valid Ethereum contractAddress and id are required.


An example URL request:

http://bloq.press/api/cortex/v1/blockauth?method=getUserById&key=your-api-key&chain=bce&params=0xc4Acc3EfDaA0Ff0820022418c3DfAf1471494E29|UKPP123

Data returned should look similar to this:

"results":
{
    "address": "0xfcdb15204daa58575c477df7b46df4ffa431f61b",
    "username": "marksmalley",
    "id": "UKPP123",
    "name": "Mark Smalley",
    "url": "http://smalley.my",
    "blocked": false
}

Table of Contents